@antadesign/anta 0.2.2 → 0.3.0

package/dist/elements/a-input.js

@@ -0,0 +1,511 @@
+import { HTMLElementBase } from "../anta_helpers";
+import "./a-input.css";
+const FORWARDED = [
+  "placeholder",
+  "type",
+  "name",
+  "autocomplete",
+  "inputmode",
+  "maxlength",
+  "minlength",
+  "pattern",
+  "spellcheck",
+  "readonly",
+  "required",
+  "min",
+  "max",
+  "step"
+];
+const BOOL_FORWARDED = /* @__PURE__ */ new Set(["readonly", "required"]);
+const CLEAR_TRIGGER = "clearrequest";
+const CLEAR_CLICK_EVENT = "clearclick";
+const CLEAR_INPUT_EVENT = "clearinput";
+const SUPPORTS_FIELD_SIZING = typeof CSS !== "undefined" && !!CSS.supports?.("field-sizing", "content");
+const SHADOW_STYLE = `
+  :host {
+    --_fs: 15px;
+    --_lh: 20px;
+
+    display: grid;
+    grid-template-columns: minmax(0, 1fr);
+    row-gap: 4px;
+    outline: none;
+  }
+
+  .label {
+    display: none;
+    color: var(--input-label);
+    font-family: var(--sans-serif);
+    font-size: var(--_fs);
+    line-height: var(--_lh);
+    font-weight: 500;
+  }
+  .label.has-label { display: block; }
+
+  .field {
+    --_bc: var(--input-border);
+    --_bw: 0.5px;
+
+    display: flex;
+    align-items: center;
+    box-sizing: border-box;
+    min-height: 28px;
+    background: var(--input-bg);
+    border-radius: 4px;
+    box-shadow: inset 0 0 0 var(--_bw) var(--_bc);
+    transition: box-shadow 120ms ease;
+  }
+  :host([multiline]) .field { align-items: stretch; }
+  :host([status]) .field { --_bw: 1px; }
+  :host([size="small"]) { --_fs: 13px; --_lh: 16px; }
+  :host([size="large"]) { --_fs: 17px; --_lh: 24px; }
+  :host([size="small"]) .field { min-height: 24px; }
+  :host([size="large"]) .field { min-height: 32px; }
+
+  @media (hover: hover) and (pointer: fine) {
+    :host(:not(:disabled)) .field:hover { --_bc: var(--input-border-hover); }
+  }
+  .field:has(input:focus, textarea:focus) {
+    --_bc: var(--input-border-hover);
+    outline: 1px solid var(--focus-ring);
+    outline-offset: 1px;
+  }
+
+  input, textarea {
+    flex: 1 1 auto;
+    min-width: 0;
+    width: 100%;
+    box-sizing: border-box;
+    border: 0;
+    margin: 0;
+    padding-block: 0;
+    padding-inline: 7px;
+    background: transparent;
+    outline: none;
+    color: var(--input-text);
+    font-family: var(--sans-serif);
+    font-feature-settings: 'ss02', 'ss05';
+    font-size: var(--_fs);
+    line-height: var(--_lh);
+    font-weight: 400;
+    -webkit-appearance: none;
+            appearance: none;
+  }
+  textarea {
+    --_pad-block: 4px;
+
+    resize: none;
+    padding-block: var(--_pad-block);
+    overflow-y: auto;
+  }
+  :host([maxrows]:not([rows])) textarea {
+    max-height: calc(var(--_lh) * var(--_maxrows) + var(--_pad-block) * 2);
+  }
+  input::placeholder, textarea::placeholder { color: var(--input-placeholder); opacity: 1; }
+  input:disabled, textarea:disabled { cursor: not-allowed; }
+  input::-webkit-search-cancel-button,
+  input::-webkit-search-decoration,
+  input::-webkit-search-results-button,
+  input::-webkit-search-results-decoration,
+  input::-webkit-inner-spin-button,
+  input::-webkit-outer-spin-button { -webkit-appearance: none; appearance: none; display: none; }
+  input::-ms-clear, input::-ms-reveal { display: none; }
+
+  slot[name="leading"], slot[name="trailing"] { display: none; color: var(--input-adornment); }
+  .field.has-leading slot[name="leading"],
+  .field.has-trailing slot[name="trailing"] {
+    display: flex;
+    align-items: center;
+    flex-shrink: 0;
+  }
+  .field.has-trailing slot[name="trailing"] { gap: 2px; }
+
+  :host([dim-actions]) slot[name="leading"],
+  :host([dim-actions]) slot[name="trailing"],
+  :host([dim-actions]) slot[name="clear"] {
+    opacity: 0.6;
+    transition: opacity 120ms ease;
+  }
+  :host([dim-actions]:not(:disabled)) .field:hover slot[name="leading"],
+  :host([dim-actions]:not(:disabled)) .field:hover slot[name="trailing"],
+  :host([dim-actions]:not(:disabled)) .field:hover slot[name="clear"],
+  :host([dim-actions]:not(:disabled)) .field:focus-within slot[name="leading"],
+  :host([dim-actions]:not(:disabled)) .field:focus-within slot[name="trailing"],
+  :host([dim-actions]:not(:disabled)) .field:focus-within slot[name="clear"] {
+    opacity: 1;
+  }
+
+  :host(:disabled) slot[name="leading"],
+  :host(:disabled) slot[name="trailing"] { opacity: 0.5; pointer-events: none; }
+
+  slot[name="clear"] { display: none; flex-shrink: 0; }
+  .field.is-filled slot[name="clear"] { display: flex; align-items: center; }
+  :host(:disabled) slot[name="clear"],
+  :host([readonly]) slot[name="clear"] { display: none; }
+  :host([multiline]) slot[name="clear"] { align-self: flex-start; }
+
+  .field.has-leading slot[name="leading"] { margin-inline-start: 7px; }
+  .field.has-leading input,
+  .field.has-leading textarea { padding-inline-start: 5px; }
+  :host([multiline]) .field.has-leading slot[name="leading"],
+  :host([multiline]) .field.has-trailing slot[name="trailing"] {
+    align-items: flex-start;
+    padding-top: 2px;
+  }
+
+  .hint {
+    display: none;
+    gap: 4px;
+    align-items: flex-start;
+    padding-inline-start: 1px;
+    color: var(--input-hint);
+    font-family: var(--sans-serif);
+    font-size: calc(var(--_fs) - 1px);
+    line-height: calc(var(--_lh) - 2px);
+  }
+  .hint.has-hint { display: flex; }
+`;
+class AInputElement extends HTMLElementBase {
+  static formAssociated = true;
+  static observedAttributes = [
+    ...FORWARDED,
+    "value",
+    "defaultvalue",
+    "multiline",
+    "rows",
+    "maxrows",
+    "status",
+    "disabled"
+  ];
+  internals;
+  field;
+  labelBox;
+  hintBox;
+  labelSlot;
+  hintSlot;
+  leadingSlot;
+  trailingSlot;
+  control;
+  // The intended value, captured even before the control exists (a framework
+  // may set the `value` property before the element connects), so the initial
+  // value isn't lost when the control is built.
+  pendingValue;
+  // True between connect and the first control build, so attribute changes for
+  // forwarded props don't try to touch a control that doesn't exist yet.
+  ready = false;
+  // Set by formDisabledCallback when an ancestor <fieldset disabled> / disabled
+  // form turns the field off (the host can't carry a [disabled] attribute itself).
+  formDisabled = false;
+  constructor() {
+    super();
+    try {
+      this.internals = this.attachInternals?.();
+    } catch (err) {
+      console.warn("a-input: ElementInternals unavailable \u2014 form association disabled.", err);
+    }
+    const shadow = this.attachShadow({ mode: "open", delegatesFocus: true });
+    const style = document.createElement("style");
+    style.textContent = SHADOW_STYLE;
+    this.labelBox = document.createElement("div");
+    this.labelBox.className = "label";
+    this.labelBox.setAttribute("part", "label");
+    this.labelSlot = document.createElement("slot");
+    this.labelSlot.name = "label";
+    this.labelBox.append(this.labelSlot);
+    this.labelSlot.addEventListener("click", () => this.control?.focus());
+    this.labelSlot.addEventListener("slotchange", this.onLabelSlotChange);
+    this.field = document.createElement("div");
+    this.field.className = "field";
+    this.field.setAttribute("part", "field");
+    this.leadingSlot = document.createElement("slot");
+    this.leadingSlot.name = "leading";
+    this.leadingSlot.setAttribute("part", "leading");
+    this.trailingSlot = document.createElement("slot");
+    this.trailingSlot.name = "trailing";
+    this.trailingSlot.setAttribute("part", "trailing");
+    this.leadingSlot.addEventListener("slotchange", () => this.field.classList.toggle("has-leading", this.leadingSlot.assignedNodes().length > 0));
+    this.trailingSlot.addEventListener("slotchange", () => this.field.classList.toggle("has-trailing", this.trailingSlot.assignedNodes().length > 0));
+    const clearSlot = document.createElement("slot");
+    clearSlot.name = "clear";
+    clearSlot.setAttribute("part", "clear");
+    this.field.append(this.leadingSlot, clearSlot, this.trailingSlot);
+    this.addEventListener(CLEAR_TRIGGER, () => {
+      const proceed = this.dispatchEvent(
+        new CustomEvent(CLEAR_CLICK_EVENT, { bubbles: true, cancelable: true })
+      );
+      if (proceed) this.clear();
+    });
+    this.hintBox = document.createElement("div");
+    this.hintBox.className = "hint";
+    this.hintBox.setAttribute("part", "hint");
+    this.hintSlot = document.createElement("slot");
+    this.hintSlot.name = "hint";
+    this.hintSlot.addEventListener("slotchange", this.onHintSlotChange);
+    this.hintBox.append(this.hintSlot);
+    const extrasSlot = document.createElement("slot");
+    shadow.append(style, this.labelBox, this.field, extrasSlot, this.hintBox);
+  }
+  connectedCallback() {
+    if (Object.prototype.hasOwnProperty.call(this, "value")) {
+      const v = this.value;
+      delete this.value;
+      this.value = v;
+    }
+    if (!this.control) this.buildControl();
+    this.ready = true;
+  }
+  attributeChangedCallback(name, _old, value) {
+    if (!this.ready && name !== "value" && name !== "defaultvalue") return;
+    if (name === "multiline" || name === "rows" || name === "maxrows") {
+      if (!this.control) return;
+      const needTextarea = this.hasAttribute("multiline") || this.hasAttribute("rows");
+      const isTextarea = this.control instanceof HTMLTextAreaElement;
+      if (needTextarea !== isTextarea) this.buildControl(this.value);
+      else if (this.control instanceof HTMLTextAreaElement) this.configureTextarea(this.control);
+      return;
+    }
+    if (name === "status") {
+      this.syncStatus();
+      this.updateValidity();
+      return;
+    }
+    if (name === "disabled") {
+      this.syncDisabled();
+      return;
+    }
+    if (name === "value") {
+      if (value !== null) this.value = value;
+      return;
+    }
+    if (name === "defaultvalue") return;
+    if (this.control) {
+      this.forward(name, value);
+      this.updateValidity();
+    }
+  }
+  /** (Re)build the shadow control from the current attributes. */
+  buildControl(initial) {
+    const prev = this.control;
+    const refocus = prev != null && this.shadowRoot?.activeElement === prev;
+    let selStart = null;
+    let selEnd = null;
+    if (prev) try {
+      selStart = prev.selectionStart;
+      selEnd = prev.selectionEnd;
+    } catch {
+    }
+    const multiline = this.hasAttribute("multiline") || this.hasAttribute("rows");
+    const next = document.createElement(multiline ? "textarea" : "input");
+    next.setAttribute("part", "input");
+    if (this.control) this.control.replaceWith(next);
+    else this.leadingSlot.after(next);
+    this.control = next;
+    for (const attr of FORWARDED) {
+      if (next instanceof HTMLTextAreaElement && attr === "type") continue;
+      this.forward(attr, this.getAttribute(attr));
+    }
+    this.syncDisabled();
+    this.syncStatus();
+    this.applyLabelAria();
+    this.applyDescriptionAria();
+    if (multiline) this.configureTextarea(next);
+    const value = initial ?? this.pendingValue ?? this.getAttribute("value") ?? this.getAttribute("defaultvalue") ?? "";
+    next.value = value;
+    next.addEventListener("input", this.onInput);
+    next.addEventListener("change", this.onChange);
+    if (refocus) {
+      next.focus();
+      if (selStart != null) try {
+        next.setSelectionRange(selStart, selEnd ?? selStart);
+      } catch {
+      }
+    }
+    this.internals?.setFormValue(value);
+    this.updateValidity();
+    this.updateFilled();
+    this.syncAutoHeight();
+  }
+  /** Autogrow (no `rows`) via `field-sizing: content` — or the JS fallback where
+   *  that's unsupported — capped by `maxrows`; a fixed `rows` count switches it
+   *  off for a constant-height box. */
+  configureTextarea(ta) {
+    const rows = this.getAttribute("rows");
+    const maxrows = this.getAttribute("maxrows");
+    if (rows != null) {
+      ta.rows = Math.max(1, parseInt(rows, 10) || 1);
+      ta.style.setProperty("field-sizing", "fixed");
+      ta.style.removeProperty("--_maxrows");
+      ta.style.removeProperty("height");
+    } else {
+      ta.rows = 1;
+      if (SUPPORTS_FIELD_SIZING) ta.style.setProperty("field-sizing", "content");
+      else ta.style.removeProperty("field-sizing");
+      if (maxrows != null) ta.style.setProperty("--_maxrows", String(parseInt(maxrows, 10) || 1));
+      else ta.style.removeProperty("--_maxrows");
+      this.syncAutoHeight();
+    }
+  }
+  /** Autogrow fallback for browsers without `field-sizing: content` (Firefox,
+   *  Safari < 26.2). Grows the shadow textarea to fit its content; the CSS
+   *  `max-height` cap (when `maxrows` is set) still clamps it and scrolls past.
+   *  A no-op where `field-sizing` is supported, or when the field isn't
+   *  autogrowing (fixed `rows`, or not a textarea) — those size via CSS. */
+  syncAutoHeight = () => {
+    if (SUPPORTS_FIELD_SIZING) return;
+    const ta = this.control;
+    if (!(ta instanceof HTMLTextAreaElement) || this.getAttribute("rows") != null) return;
+    ta.style.height = "auto";
+    ta.style.height = `${ta.scrollHeight}px`;
+  };
+  forward(name, value) {
+    const c = this.control;
+    if (!c) return;
+    if (c instanceof HTMLTextAreaElement && name === "type") return;
+    if (BOOL_FORWARDED.has(name)) c.toggleAttribute(name, value != null);
+    else if (value == null) c.removeAttribute(name);
+    else c.setAttribute(name, value);
+  }
+  syncDisabled() {
+    if (this.control) this.control.disabled = this.hasAttribute("disabled") || this.formDisabled;
+  }
+  /** Reflect `status` into the control's `aria-invalid` and the `:state(invalid)`
+   *  custom state. Called on `status` change AND from buildControl — so a field
+   *  that mounts already `status="critical"` gets `:state(invalid)` on the FIRST
+   *  paint (the status attributeChangedCallback fires before connect, while
+   *  `ready` is false and the early-return skips it). */
+  syncStatus() {
+    const critical = this.getAttribute("status") === "critical";
+    this.control?.setAttribute("aria-invalid", critical ? "true" : "false");
+    try {
+      critical ? this.internals?.states.add("invalid") : this.internals?.states.delete("invalid");
+    } catch {
+    }
+  }
+  onInput = () => {
+    const v = this.control?.value ?? "";
+    this.internals?.setFormValue(v);
+    this.updateValidity();
+    this.updateFilled();
+    this.syncAutoHeight();
+  };
+  // `change` is not composed; re-emit one on the host so it escapes the shadow.
+  onChange = () => {
+    this.dispatchEvent(new Event("change", { bubbles: true }));
+  };
+  onLabelSlotChange = () => {
+    this.labelBox.classList.toggle("has-label", this.labelSlot.assignedNodes().length > 0);
+    this.applyLabelAria();
+  };
+  applyLabelAria() {
+    const c = this.control;
+    if (!c) return;
+    if (this.hasAttribute("aria-label") || this.hasAttribute("aria-labelledby")) return;
+    const text = this.labelSlot.assignedNodes().map((n) => n.textContent ?? "").join(" ").trim();
+    if (text) c.setAttribute("aria-label", text);
+    else c.removeAttribute("aria-label");
+  }
+  onHintSlotChange = () => {
+    this.hintBox.classList.toggle("has-hint", this.hintSlot.assignedNodes().length > 0);
+    this.applyDescriptionAria();
+  };
+  applyDescriptionAria() {
+    const c = this.control;
+    if (!c) return;
+    if (this.hasAttribute("aria-description") || this.hasAttribute("aria-describedby")) return;
+    const text = this.hintSlot.assignedNodes().map((n) => n.textContent ?? "").join(" ").trim();
+    if (text) c.setAttribute("aria-description", text);
+    else c.removeAttribute("aria-description");
+  }
+  updateFilled() {
+    const filled = !!this.value;
+    this.field.classList.toggle("is-filled", filled);
+    try {
+      if (filled) this.internals?.states.add("filled");
+      else this.internals?.states.delete("filled");
+    } catch {
+    }
+  }
+  updateValidity() {
+    const c = this.control;
+    if (!this.internals || !c) return;
+    if (this.getAttribute("status") === "critical" && c.validity.valid) {
+      this.internals.setValidity({ customError: true }, "Invalid value.", c);
+    } else {
+      this.internals.setValidity(c.validity, c.validationMessage, c);
+    }
+  }
+  /** The current text value. Reading prefers the live control; before it's
+   *  built, the pending/attribute value. */
+  get value() {
+    if (this.control) return this.control.value;
+    return this.pendingValue ?? this.getAttribute("value") ?? this.getAttribute("defaultvalue") ?? "";
+  }
+  set value(v) {
+    this.pendingValue = v;
+    if (this.control && this.control.value !== v) this.control.value = v;
+    this.internals?.setFormValue(v);
+    this.updateValidity();
+    this.updateFilled();
+    this.syncAutoHeight();
+  }
+  /** Clear the field and refocus it — fired by the wrapper's clear button.
+   *  Dispatches `input` + `change` on the host so controlled consumers update. */
+  clear() {
+    if (!this.control) return;
+    this.control.value = "";
+    this.internals?.setFormValue("");
+    this.updateValidity();
+    this.updateFilled();
+    this.syncAutoHeight();
+    this.dispatchEvent(new Event("input", { bubbles: true }));
+    this.dispatchEvent(new Event("change", { bubbles: true }));
+    this.dispatchEvent(new CustomEvent(CLEAR_INPUT_EVENT, { bubbles: true }));
+    this.control.focus();
+  }
+  // --- Constraint-validation API, proxied from ElementInternals so the host
+  //     behaves like a native form control (`el.checkValidity()`, `el.validity`). ---
+  get validity() {
+    return this.internals?.validity;
+  }
+  get validationMessage() {
+    return this.internals?.validationMessage ?? "";
+  }
+  get willValidate() {
+    return this.internals?.willValidate ?? false;
+  }
+  checkValidity() {
+    return this.internals?.checkValidity() ?? true;
+  }
+  reportValidity() {
+    return this.internals?.reportValidity() ?? true;
+  }
+  /** Form field name — mirrors the `name` attribute, like native `<input>.name`,
+   *  so `el.name` works (e.g. keying validation messages by field in a form loop). */
+  get name() {
+    return this.getAttribute("name") ?? "";
+  }
+  // --- Form-associated callbacks ---
+  formResetCallback() {
+    this.value = this.getAttribute("defaultvalue") ?? "";
+    this.dispatchEvent(new Event("input", { bubbles: true }));
+    this.dispatchEvent(new Event("change", { bubbles: true }));
+  }
+  formDisabledCallback(disabled) {
+    this.formDisabled = disabled;
+    this.syncDisabled();
+  }
+  formStateRestoreCallback(state) {
+    this.value = state ?? "";
+  }
+}
+function register_a_input() {
+  if (typeof customElements === "undefined") return;
+  if (!customElements.get("a-input")) {
+    customElements.define("a-input", AInputElement);
+  }
+}
+register_a_input();
+export {
+  AInputElement,
+  register_a_input
+};

package/dist/elements/a-menu-group.css

@@ -0,0 +1 @@
+@layer anta{a-menu-group:not(:defined){display:none}a-menu-group{display:block}a-menu-group-label{display:block;padding:6px 8px 2px;color:var(--text-5);font-size:.75em;font-weight:600;letter-spacing:.06em;text-transform:uppercase;user-select:none}}

package/dist/elements/a-menu-group.d.ts

@@ -0,0 +1,13 @@
+import { HTMLElementBase } from '../anta_helpers';
+import './a-menu-group.css';
+/**
+ * `<a-menu-group>` — a titled section grouping related menu items.
+ * No JS / no shadow DOM; styled by `a-menu-group.css`. The group's heading
+ * is a non-focusable `<a-menu-group-label>` child rendered by the
+ * `MenuGroup` JSX wrapper; `role="group"` + `aria-label` are added there too.
+ * Keyboard navigation in `<a-menu>` flattens items across group boundaries,
+ * skipping the heading.
+ */
+export declare class AMenuGroupElement extends HTMLElementBase {
+}
+export declare function register_a_menu_group(): void;

package/dist/elements/a-menu-group.js

@@ -0,0 +1,15 @@
+import { HTMLElementBase } from "../anta_helpers";
+import "./a-menu-group.css";
+class AMenuGroupElement extends HTMLElementBase {
+}
+function register_a_menu_group() {
+  if (typeof customElements === "undefined") return;
+  if (!customElements.get("a-menu-group")) {
+    customElements.define("a-menu-group", AMenuGroupElement);
+  }
+}
+register_a_menu_group();
+export {
+  AMenuGroupElement,
+  register_a_menu_group
+};

package/dist/elements/a-menu-item.css

@@ -0,0 +1 @@
+@layer anta{a-menu-item:not(:defined){display:none}a-menu-item{--menu-item-color: var(--text-2);--menu-item-icon-color: var(--text-3);--menu-item-hover: 5%;--menu-item-active: 9%;--menu-item-timing-in: 60ms ease-in-out;--menu-item-timing-out: .28s ease-out;--menu-item-padding-x: 8px;--menu-item-padding-y: 6px;display:flex;flex-shrink:0;align-items:center;gap:.6ch;box-sizing:border-box;width:100%;min-height:28px;padding-block:var(--menu-item-padding-y);padding-inline:var(--menu-item-padding-x);border-radius:var(--radius-sm, 4px);color:var(--menu-item-color);background:transparent;transition:background-color var(--menu-item-timing-out);font:inherit;font-size:14px;line-height:16px;text-align:left;white-space:nowrap;cursor:pointer;user-select:none;outline:none}a-menu-item:hover,a-menu-item:focus-visible{background:color-mix(in oklch,currentColor var(--menu-item-hover),transparent);transition:background-color var(--menu-item-timing-in)}a-menu-item:active{background:color-mix(in oklch,currentColor var(--menu-item-active),transparent);transition:none}a-menu-item:focus-visible{outline:1px solid var(--focus-ring);outline-offset:1px}a-menu-item>a-menu-item-label{flex:1 1 auto;min-width:0;overflow:hidden;text-overflow:ellipsis}a-menu-item>a-icon{flex:none;--icon-size: 16px;color:var(--menu-item-icon-color)}a-menu-item:has(>a-icon:first-child:not(:only-child)){padding-inline-start:max(0px,var(--menu-item-padding-x) - 2px)}a-menu-item:has(>a-icon:last-child:not(:only-child)){padding-inline-end:max(0px,var(--menu-item-padding-x) - 2px)}a-menu-item>kbd{flex:none;margin-left:auto;padding-left:12px;color:var(--text-5);font:inherit;font-size:1em;letter-spacing:.1ch;white-space:nowrap}a-menu-item[submenu]>a-icon:last-of-type{margin-left:auto}a-menu-item[submenu]>a-icon:last-of-type,a-menu-item>a-icon:last-child:not(:only-child){position:relative;inset-inline-end:-2px}a-menu-item[tone=brand],a-menu-item[tone=info],a-menu-item[tone=success],a-menu-item[tone=warning],a-menu-item[tone=critical]{--menu-item-icon-color: var(--menu-item-color)}a-menu-item[tone=brand]{--menu-item-color: var(--text-2-brand)}a-menu-item[tone=info]{--menu-item-color: var(--text-2-info)}a-menu-item[tone=success]{--menu-item-color: var(--text-2-success)}a-menu-item[tone=warning]{--menu-item-color: var(--text-2-warning)}a-menu-item[tone=critical]{--menu-item-color: var(--text-2-critical)}a-menu-item[disabled]{--menu-item-color: var(--text-5);--menu-item-icon-color: var(--text-5);cursor:default;pointer-events:none}.dark a-menu-item{--menu-item-hover: 10%;--menu-item-active: 15%}}

package/dist/elements/a-menu-item.d.ts

@@ -0,0 +1,47 @@
+import { HTMLElementBase } from '../anta_helpers';
+import './a-menu-item.css';
+declare global {
+    interface Document {
+        hasKeyListenerForAMenuItem?: boolean;
+    }
+}
+/**
+ * `<a-menu-item>` — a single row inside an `<a-menu>`.
+ *
+ * No shadow DOM: its content (leading icon, label, trailing `kbd` /
+ * chevron) is slotted light DOM, styled entirely from `a-menu-item.css`.
+ * The element carries almost no logic — the parent `<a-menu>` owns
+ * click delegation, keyboard navigation, and the close contract. This
+ * class exists so the menu can identify items via `instanceof` and so
+ * Enter / Space on a focused item synthesizes a click (the single
+ * activation path that flows through the menu's click delegation).
+ *
+ * Static ARIA (`role="menuitem"`, `tabindex`, `aria-haspopup` and the
+ * `aria-expanded="false"` baseline on submenu parents) is added by the
+ * `MenuItem` JSX wrapper, never here — the element must stay re-renderable
+ * from any reactive engine without churning host attributes. The one dynamic
+ * bit, live `aria-expanded` on a submenu parent, is reflected by the nested
+ * `a-menu` element, which owns that state (see `reflectExpanded` there).
+ *
+ * Styling notes (`a-menu-item.css` ships comment-free):
+ * - `a-menu-item:not(:defined)` is hidden against the pre-upgrade flash
+ *   (items would render inline in the page before registration).
+ * - The `--menu-item-*` custom properties are INTERNAL plumbing for the
+ *   tone × dark matrix, not a public theming API: `--menu-item-color` is the
+ *   text color and the hover/active tint mixes from `currentColor` at the
+ *   `--menu-item-hover` / `--menu-item-active` percentages, so it tracks the
+ *   tone for free (and toned rows don't read heavier than gray ones). Dark
+ *   mode just raises the percentages.
+ * - Focus ring mirrors a-button: 1px outline at +1px offset, sitting in the
+ *   surface's 4px padding; pairs with the hover background so keyboard focus
+ *   reads as tint + ring.
+ * - Optical side padding (same idea as a-button): a non-only icon at an edge
+ *   is trimmed ~2px on that side. Submenu items keep symmetric padding —
+ *   the nested `<a-menu>` is the actual last child, so the trim rule doesn't
+ *   fire — and the chevron / a trailing icon is instead nudged toward the
+ *   edge with relative positioning (visual only, no reflow).
+ */
+export declare class AMenuItemElement extends HTMLElementBase {
+    connectedCallback(): void;
+}
+export declare function register_a_menu_item(): void;

package/dist/elements/a-menu-item.js

@@ -0,0 +1,30 @@
+import { HTMLElementBase } from "../anta_helpers";
+import "./a-menu-item.css";
+class AMenuItemElement extends HTMLElementBase {
+  connectedCallback() {
+    const doc = this.doc;
+    if (!doc.hasKeyListenerForAMenuItem) {
+      doc.addEventListener("keydown", handleKeyDown, true);
+      doc.hasKeyListenerForAMenuItem = true;
+    }
+  }
+}
+function handleKeyDown(e) {
+  if (e.key !== "Enter" && e.key !== " ") return;
+  const el = e.target?.closest?.("a-menu-item");
+  if (!el) return;
+  e.preventDefault();
+  if (el.hasAttribute("disabled")) return;
+  el.click();
+}
+function register_a_menu_item() {
+  if (typeof customElements === "undefined") return;
+  if (!customElements.get("a-menu-item")) {
+    customElements.define("a-menu-item", AMenuItemElement);
+  }
+}
+register_a_menu_item();
+export {
+  AMenuItemElement,
+  register_a_menu_item
+};

package/dist/elements/a-menu-separator.css

@@ -0,0 +1 @@
+@layer anta{a-menu-separator:not(:defined){display:none}a-menu-separator{display:block;flex-shrink:0;height:1px;margin:2px 4px;background:var(--border-5)}}

package/dist/elements/a-menu-separator.d.ts

@@ -0,0 +1,13 @@
+import { HTMLElementBase } from '../anta_helpers';
+import './a-menu-separator.css';
+/**
+ * `<a-menu-separator>` — a thin divider between groups of menu items.
+ * No JS / no shadow DOM; styled entirely by `a-menu-separator.css`. The
+ * trivial class exists only so importing this module registers the tag and
+ * pulls its CSS along the granular entry point. `role="separator"` is added
+ * by the `MenuSeparator` JSX wrapper. The hairline uses `--border-5` — the
+ * most subtle border token, already mode-adaptive, so no `.dark` override.
+ */
+export declare class AMenuSeparatorElement extends HTMLElementBase {
+}
+export declare function register_a_menu_separator(): void;

package/dist/elements/a-menu-separator.js

@@ -0,0 +1,15 @@
+import { HTMLElementBase } from "../anta_helpers";
+import "./a-menu-separator.css";
+class AMenuSeparatorElement extends HTMLElementBase {
+}
+function register_a_menu_separator() {
+  if (typeof customElements === "undefined") return;
+  if (!customElements.get("a-menu-separator")) {
+    customElements.define("a-menu-separator", AMenuSeparatorElement);
+  }
+}
+register_a_menu_separator();
+export {
+  AMenuSeparatorElement,
+  register_a_menu_separator
+};

package/dist/elements/a-menu.css

@@ -0,0 +1 @@
+@layer anta{a-menu:not(:defined){display:none}a-menu{--menu-bg: color-mix(in oklch, var(--bg-1) 90%, transparent);--menu-radius: var(--radius-md, 8px);--menu-border: 1px solid var(--border-3);--menu-shadow: 0 2px 6px color-mix(in oklch, var(--text-1) 8%, transparent), 0 8px 24px color-mix(in oklch, var(--text-1) 10%, transparent);--menu-padding: 4px;--menu-min-width: 88px;--menu-backdrop-filter: blur(20px)}.dark a-menu{--menu-bg: color-mix(in oklch, var(--bg-1) 78%, transparent);--menu-shadow: 0 2px 8px color-mix(in oklch, black 50%, transparent), 0 12px 32px color-mix(in oklch, black 40%, transparent), inset 0 0 0 1px color-mix(in oklch, white 8%, transparent)}}