@antadesign/anta 0.3.33 → 0.3.35

package/dist/elements/index.js

@@ -1,5 +1,5 @@
 import { AAvatarElement, register_a_avatar } from "./a-avatar";
-import { AProgressElement, register_a_progress } from "./a-progress";
+import "./a-progress.css";
 import { ALoaderElement, register_a_loader } from "./a-loader";
 import { ATextElement, register_a_text } from "./a-text";
 import { ABoxElement, register_a_box } from "./a-box";
@@ -26,12 +26,16 @@ import { ATabElement, register_a_tab } from "./a-tab";
 import { ATabsElement, register_a_tabs } from "./a-tabs";
 import { ATabPanelElement, register_a_tabpanel } from "./a-tabpanel";
 import { ADialogElement, register_a_dialog } from "./a-dialog";
-import { ACardElement, register_a_card } from "./a-card";
+import "./a-card.css";
 import { ABannerElement, register_a_banner } from "./a-banner";
 import { AToasterElement, register_a_toaster } from "./a-toaster";
 import { AToastElement, register_a_toast } from "./a-toast";
 import "./a-title.css";
 import "./a-tag.css";
+import "../components/Breadcrumbs.css";
+import "../components/InputDate.css";
+import "../components/Select.css";
+import "../components/Steps.css";
 export {
   AAvatarElement,
   ABannerElement,
@@ -39,7 +43,6 @@ export {
   AButtonElement,
   ACalendarElement,
   ACaptureElement,
-  ACardElement,
   ACheckboxElement,
   ACopyElement,
   ADialogElement,
@@ -53,7 +56,6 @@ export {
   AMenuItemElement,
   AMenuSeparatorElement,
   APanelElement,
-  AProgressElement,
   ARadioElement,
   ARadioGroupElement,
   ASliderElement,
@@ -71,7 +73,6 @@ export {
   register_a_button,
   register_a_calendar,
   register_a_capture,
-  register_a_card,
   register_a_checkbox,
   register_a_copy,
   register_a_dialog,
@@ -85,7 +86,6 @@ export {
   register_a_menu_item,
   register_a_menu_separator,
   register_a_panel,
-  register_a_progress,
   register_a_radio,
   register_a_radio_group,
   register_a_slider,

package/dist/elements/input-focus-modality.d.ts

@@ -0,0 +1,15 @@
+export declare const MODALITY: unique symbol;
+type Modality = {
+    keyboard: boolean;
+    readers: Set<() => void>;
+    active?: () => void;
+    key: () => void;
+    pointer: () => void;
+    refresh: () => void;
+    frame?: number;
+};
+export type InputDocument = Document & {
+    [MODALITY]?: Modality;
+};
+export declare function trackFocusModality(doc: InputDocument, reader: () => void): () => void;
+export {};

package/dist/elements/input-focus-modality.js

@@ -0,0 +1,44 @@
+const MODALITY = /* @__PURE__ */ Symbol.for("anta.input-focus-modality");
+function trackFocusModality(doc, reader) {
+  let state = doc[MODALITY];
+  if (!state) {
+    const readers = /* @__PURE__ */ new Set();
+    state = { keyboard: false, readers, key: () => {
+    }, pointer: () => {
+    }, refresh: () => {
+    } };
+    const current = state;
+    current.refresh = () => {
+      if (!current.active || current.frame !== void 0) return;
+      current.frame = doc.defaultView?.requestAnimationFrame(() => {
+        current.frame = void 0;
+        current.active?.();
+      });
+    };
+    current.key = () => {
+      current.keyboard = true;
+      current.refresh();
+    };
+    current.pointer = () => {
+      current.keyboard = false;
+      current.refresh();
+    };
+    doc[MODALITY] = current;
+    doc.addEventListener("keydown", current.key, true);
+    doc.addEventListener("pointerdown", current.pointer, true);
+  }
+  state.readers.add(reader);
+  return () => {
+    state.readers.delete(reader);
+    if (state.active === reader) state.active = void 0;
+    if (state.readers.size) return;
+    if (state.frame !== void 0) doc.defaultView?.cancelAnimationFrame(state.frame);
+    doc.removeEventListener("keydown", state.key, true);
+    doc.removeEventListener("pointerdown", state.pointer, true);
+    delete doc[MODALITY];
+  };
+}
+export {
+  MODALITY,
+  trackFocusModality
+};

package/dist/elements/input-trailing-actions.d.ts

@@ -0,0 +1,5 @@
+/** Track the assigned actions without observing their labels or descendants. */
+export declare function inputTrailingActions(host: HTMLElement, slot: HTMLSlotElement, groupTag: string, apply: (actions: boolean) => void): {
+    sync: () => void;
+    disconnect(): void;
+};

package/dist/elements/input-trailing-actions.js

@@ -0,0 +1,38 @@
+function inputTrailingActions(host, slot, groupTag, apply) {
+  let observer;
+  const sync = () => {
+    if (!host.isConnected) return;
+    observer?.disconnect();
+    let hasAction = false;
+    const onlyActions = (nodes) => {
+      for (const node of nodes) {
+        if (node.nodeType === 3 && node.textContent?.trim()) return false;
+        if (node.nodeType !== 1) continue;
+        const element = node;
+        if (element.localName === groupTag) {
+          const view = host.ownerDocument.defaultView ?? window;
+          observer ??= new view.MutationObserver(sync);
+          observer.observe(element, { childList: true });
+          for (const child of element.childNodes) {
+            if (child.nodeType === 3) observer.observe(child, { characterData: true });
+          }
+          if (!onlyActions(element.childNodes)) return false;
+        } else if (element.localName === "a-button" || element.localName === "button" || element.matches('a[role="button"][data-anta]')) {
+          hasAction = true;
+        } else return false;
+      }
+      return true;
+    };
+    apply(onlyActions(slot.assignedNodes()) && hasAction);
+  };
+  return {
+    sync,
+    disconnect() {
+      observer?.disconnect();
+      observer = void 0;
+    }
+  };
+}
+export {
+  inputTrailingActions
+};

package/dist/elements/shadow-aria.d.ts

@@ -5,6 +5,8 @@ export declare const SHADOW_ARIA_ATTRIBUTES: readonly ['role', 'aria-activedesce
 export type ShadowAriaAttribute = (typeof SHADOW_ARIA_ATTRIBUTES)[number];
 export declare const SHADOW_ARIA_ATTRIBUTE_SET: Set<string>;
 export declare function ariaAttributeProperty(name: ShadowAriaAttribute): string;
+/** @internal Resolve authored ID references in the host tree. */
+export declare function referencedElements(host: Element, value: string): Element[];
 /** Apply one consumed host attribute to a shadow control. ID-reference ARIA
  * uses element reflection so a shadow control can reference the host's tree. */
 export declare function applyShadowAria(host: Element, target: Element, name: ShadowAriaAttribute, value: string | null): void;

package/dist/elements/shadow-aria.js

@@ -151,5 +151,6 @@ export {
   SHADOW_ARIA_ATTRIBUTES,
   SHADOW_ARIA_ATTRIBUTE_SET,
   applyShadowAria,
-  ariaAttributeProperty
+  ariaAttributeProperty,
+  referencedElements
 };

package/dist/elements/value-input.d.ts

@@ -0,0 +1,3 @@
+/** @internal Replay consumer inputs during custom-element construction, including detached upgrades.
+ * Deleting the own property exposes the element's reflecting setter. */
+export declare function upgradeValueProperties(element: HTMLElement): void;

package/dist/elements/value-input.js

@@ -0,0 +1,12 @@
+function upgradeValueProperties(element) {
+  const inputs = element;
+  for (const name of ["value", "defaultValue"]) {
+    if (!Object.prototype.hasOwnProperty.call(inputs, name)) continue;
+    const value = inputs[name];
+    delete inputs[name];
+    inputs[name] = value;
+  }
+}
+export {
+  upgradeValueProperties
+};

package/dist/general_types.d.ts

@@ -17,7 +17,7 @@ export interface BaseProps {
     /** HTML `title` attribute — native browser tooltip on hover. */
     title?: string;
     /** Assigns the element to a named `<slot>` of a parent web component (e.g.
-     *  `slot="header"` inside a `<Card>`, `slot="footer"` inside a `<Dialog>`). */
+     *  `slot="header"` inside a `<Dialog>`, `slot="footer"` inside a `<Dialog>`). */
     slot?: string;
     /** Tab order. Set to `-1` to skip the element when tabbing. */
     tabIndex?: number;
@@ -157,15 +157,18 @@ export interface BaseAttributes extends DOMEventHandlers {
     role?: string;
 }
 /**
- * Attributes for the `<a-progress>` custom element.
+ * Attributes for the CSS-only `<a-progress>` container.
  *
- * These are the low-level web component attributes. For the JSX wrapper with
- * typed props and computed labels, use `Progress` from `@antadesign/anta`.
+ * CSS paints the indicator. Raw authors supply matching ARIA and optional labels.
+ * For typed props and computed labels, use the `Progress` JSX wrapper.
  */
 export interface AProgressAttributes extends BaseAttributes {
-    /** Current progress value. Omit this attribute for indeterminate progress. */
+    /** Current progress value. CSS uses `--progress-value` when supplied, then
+     *  this attribute where numeric `attr()` is supported. Omit for loading. */
     value?: number | string | false;
-    /** Maximum value. Defaults to 100. */
+    /** Upper bound. CSS uses `--progress-max` when supplied, then this attribute
+     *  where numeric `attr()` is supported.
+     *  @defaultValue 100 */
     max?: number | string;
     /** Color variant, or any literal CSS color for a custom tone (derived in
      *  oklch). Named tones track light/dark automatically. */
@@ -240,12 +243,18 @@ export interface ALoaderAttributes extends BaseAttributes {
     /** ARIA value-max. */
     'aria-valuemax'?: number | string;
 }
-/**
- * Attributes for the `<a-text>` custom element.
- *
- * Low-level web component attributes; for the JSX wrapper use `Text`
- * from `@antadesign/anta`.
- */
+/** Measured Text presentation, reported without changing authored DOM. */
+export interface TextPresentation {
+    /** Whether the reader has expanded the content. */
+    expanded: boolean;
+    /** Whether the folded preview overflows. Retained while expanded. */
+    overflowing: boolean;
+}
+/** Attributes on Text's authored content region. */
+export interface ATextContentAttributes extends BaseAttributes {
+    inert?: boolean;
+}
+/** Attributes for `<a-text>`. For JSX, use `Text` from `@antadesign/anta`. */
 export interface ATextAttributes extends BaseAttributes {
     /** Visual priority. Maps to text-1..text-4. */
     priority?: 'primary' | 'secondary' | 'tertiary' | 'quaternary';
@@ -259,18 +268,25 @@ export interface ATextAttributes extends BaseAttributes {
     inline?: boolean | '';
     /** Truncate to N lines with a trailing ellipsis. The attribute value
      *  carries the line count (e.g. `"1"`, `"3"`); the count is also
-     *  available via the `--line-clamp` CSS custom property set inline. */
+     *  available via `--line-clamp`. Multi-line JSX values set it inline;
+     *  raw authors set it in an allowed stylesheet. */
     truncate?: boolean | string | number;
-    /** Marks the host as expandable when paired with `truncate`. Adds
-     *  the fade-out mask and the expand/collapse chevron button; the element
-     *  owns the click/keyboard expansion logic. Without `collapsible`,
-     *  expanding is one-way (the control is removed once expanded). */
+    /** Enables expansion with `truncate`. Supply a direct `a-button` control with
+     *  `role="button"` and `tabindex="0"` before the `a-text-content` region. The
+     *  elements own expansion and accessibility defaults off-DOM. Without
+     *  `collapsible`, expansion is one-way and the control becomes hidden. */
     expandable?: boolean | '';
     /** Paired with `expandable`: the chevron becomes a two-way "Show more" /
      *  "Show less" toggle that stays visible while expanded. Omit for one-way. */
     collapsible?: boolean | '';
-    /** ARIA disclosure state, mirrors the JSX wrapper's `expanded` flag. */
-    'aria-expanded'?: boolean | 'true' | 'false';
+    /** Cover the folded, overflowing preview with the expand control. Raw authors
+     *  manage `inert` on `a-text-content` using `textpresentationchange`. */
+    'expandable-inert'?: boolean | '';
+    /** Non-bubbling notification after measurement or expansion, including a
+     *  current snapshot when a listener attaches after upgrade. */
+    ontextpresentationchange?: (event: CustomEvent<TextPresentation> | {
+        nativeEvent: CustomEvent<TextPresentation>;
+    }) => void;
 }
 /** Panel presentation state. Normal panels remain visible in their parent layout. */
 export type PanelState = 'normal' | 'maximized';
@@ -388,6 +404,8 @@ export interface ATitleAttributes extends BaseAttributes {
      *  tone applies the matching `--text-{N}-{tone}` palette; any literal CSS color
      *  is a custom tone (hue kept, lightness/chroma pinned per priority in oklch). */
     tone?: 'neutral' | 'brand' | 'info' | 'success' | 'warning' | 'critical' | (string & {});
+    /** Typeface. Omit it to let the theme choose by level. */
+    font?: 'serif' | 'sans-serif' | 'monospace';
     /** Truncate to N lines with a trailing ellipsis. The attribute value carries
      *  the line count; set the same count on `--line-clamp` when using the styled
      *  tag directly. */
@@ -421,21 +439,12 @@ export interface ATagAttributes extends BaseAttributes {
     allcaps?: boolean | '';
 }
 /**
- * Attributes for the `<a-expander>` collapsible disclosure.
- *
- * The element builds its own shadow DOM (no native `<details>`): a
- * `<button>` summary carrying `aria-expanded` plus an animated content
- * region. The title is projected via `slot="title"`; header actions
- * (rendered next to the trigger, outside it) via `slot="actions"`; the
- * body is the default slot. Low-level attributes; for the JSX wrapper
- * use `Expander` from `@antadesign/anta`.
+ * Attributes for the `<a-expander>` disclosure. Authors supply direct
+ * `a-expander-summary` (or `a-expander-title`), `a-expander-actions`,
+ * `a-expander-indicator`, and `a-expander-details` regions. The element owns
+ * its native shadow button and collapsed body; styles load externally.
  */
 export interface AExpanderAttributes extends BaseAttributes {
-    /** Built-in disclosure mark. Custom visuals use `slot="indicator"`.
-     *  Defaults to `chevron`. */
-    indicator?: 'chevron' | 'triangle' | 'plus';
-    /** Logical side for the disclosure mark. Defaults to `start`. */
-    'indicator-placement'?: 'start' | 'end';
     /** Controlled open state (`'open'` / `'closed'`). Present → controlled: the
      *  attribute is the source of truth, clicks only dispatch the cancelable
      *  `statechange` event, and the consumer answers by updating it. Absent →
@@ -454,19 +463,14 @@ export interface AExpanderAttributes extends BaseAttributes {
     /** Disables the header: not clickable or focusable, hover affordance
      *  off, text dimmed. The open state freezes as-is. Presence-based. */
     disabled?: boolean | '';
-    /** Round corners sized to half the folded (header) height — a pill when folded,
-     *  the same radius when expanded (the element measures the header and publishes
-     *  `--_expander-round-radius`). A length value (`round="12px"`) is a fixed radius
-     *  that overrides the measurement. Presence-based for the boolean form. */
+    /** Use a `1rem` corner radius in both disclosure states. A length value
+     *  (`round="12px"`) overrides it. Presence-based for the boolean form. */
     round?: boolean | number | string;
     /** Semantic tone, or any literal CSS color for a one-off custom tone.
      *  Named tones re-point the text + filled surface palette; a custom
      *  color keeps its hue with lightness/chroma pinned. `'neutral'` is the
      *  default (same as omitting it). */
     tone?: 'neutral' | 'brand' | 'info' | 'success' | 'warning' | 'critical' | (string & {});
-    /** Heading type scale for the summary, `'1'`–`'6'` (mirrors `<a-title>`
-     *  levels). Default (omitted) ≈ level 5. */
-    level?: '1' | '2' | '3' | '4' | '5' | '6';
     /** Fires before the open state changes — the element dispatches a
      *  `cancelable` `statechange` `CustomEvent` whose `detail` is
      *  `{ next, prev }` in the `'open'|'closed'` vocabulary. Uncontrolled,
@@ -479,6 +483,21 @@ export interface AExpanderAttributes extends BaseAttributes {
         prev: 'open' | 'closed';
     }>) => void;
 }
+/** Decorative Expander artwork. Place before the title or after the actions. */
+export interface AExpanderIndicatorAttributes extends BaseAttributes {
+    /** Built-in artwork. Omit for custom children or an empty indicator. */
+    shape?: 'chevron' | 'triangle' | 'plus';
+    /** Keep custom artwork out of focus navigation. */
+    inert?: boolean;
+    /** Select artwork for one disclosure state. */
+    'data-when'?: 'open' | 'closed';
+}
+/** Typography for the built-in Expander title. */
+export interface AExpanderSummaryAttributes extends BaseAttributes {
+    /** Visual title scale; custom heading nodes own their own scale.
+     * @defaultValue '5' */
+    level?: '1' | '2' | '3' | '4' | '5' | '6';
+}
 /**
  * Attributes for the `<a-dialog>` custom element — a modal dialog / edge drawer
  * built on a native `<dialog>` in shadow DOM (top layer, focus trap, backdrop,
@@ -682,8 +701,14 @@ export interface ASwitchAttributes extends BaseAttributes {
  * field whose real `<input>` / `<textarea>` lives in shadow DOM. For the
  * typed JSX wrapper use `Input` from `@antadesign/anta`.
  *
- * Slots (light-DOM children): `label`, `leading`, `trailing`, `hint`.
- * The element exposes `::part(field | input | label | leading | trailing | hint)`
+ * Slots (light-DOM children): `label`, `leading`, `clear`, `trailing`, `hint`.
+ * Direct trailing buttons and buttons-only `<a-input-trailing slot="trailing">`
+ * groups use compact spacing. Other wrappers keep the text inset. Override
+ * either inset with the `--input-trailing-inset` CSS property. Anta buttons
+ * fit the field height and keep their padding. Mark a raw icon-only action with
+ * `data-anta-icon-only` for a square box; unmarked content keeps its natural width.
+ * Other controls keep their own sizing.
+ * The element exposes `::part(field | input | label | leading | clear | trailing | hint)`
  * for styling, and `:state(filled)` / `:state(invalid)` as CSS hooks.
  */
 export interface AInputAttributes extends BaseAttributes {
@@ -765,9 +790,9 @@ export interface AInputAttributes extends BaseAttributes {
 /** Attributes for the `<a-slider>` custom element. For the typed JSX wrapper,
  * display formatting, and marker layout use `Slider` from `@antadesign/anta`. */
 export interface ASliderAttributes extends BaseAttributes {
-    /** Controlled value. Range attributes use two space-separated numbers. */
+    /** Controlled numeric input. A range uses two space-separated numbers. */
     value?: number | string;
-    /** Initial uncontrolled value and form-reset baseline. Range attributes use two space-separated numbers. */
+    /** Uncontrolled initial value and reset baseline. */
     defaultvalue?: number | string;
     /** Lowest permitted value. Defaults to 0. */
     min?: number | string;
@@ -845,6 +870,8 @@ export interface AInputTimeAttributes extends BaseAttributes {
     tone?: string;
     /** Disabled state. Presence-based. */
     disabled?: boolean | '';
+    /** Prevent editing while retaining focus and selection. Presence-based. */
+    readonly?: boolean | '';
     /** Required — drives native validity. Presence-based. */
     required?: boolean | '';
     /** Dim the trailing adornments at rest (0.6); brighten on hover / focus. */
@@ -860,6 +887,8 @@ export interface AInputTimeAttributes extends BaseAttributes {
     oninput?: (e: any) => void;
     /** Fires on commit (blur). */
     onchange?: (e: any) => void;
+    /** Cancelable request before clearing. */
+    onclearclick?: (e: any) => void;
     /** Fires after the built-in clear button empties the field (`clearinput`). */
     onclearinput?: (e: any) => void;
     'aria-invalid'?: 'true' | 'false' | boolean;
@@ -876,7 +905,7 @@ export interface AInputTimeAttributes extends BaseAttributes {
  * it (the `Calendar` JSX wrapper, or a vanilla consumer using the exported
  * `buildMonth` engine) fills it with day cells and *re-renders on its events* —
  * the `<a-radio-group>` model. Controlled by the presence of `value` (a pick only
- * *requests* a change); uncontrolled with `defaultvalue` (a pick self-applies).
+ * requests a change); uncontrolled with `defaultvalue` (a pick self-applies).
  * For the typed, batteries-included wrapper use `Calendar` from `@antadesign/anta`.
  *
  * `:state(filled)` is the styling hook for "has a selection".
@@ -895,7 +924,7 @@ export interface ACalendarAttributes extends BaseAttributes {
      *  day cell whose `data-date` matches `<iso>` (set by the renderer after a
      *  month-changing keyboard move). */
     'data-focus'?: string;
-    /** Cancelable, bubbling `statechange` fired BEFORE a pick applies. `detail` is
+    /** Cancelable `statechange` fired BEFORE a pick applies. `detail` is
      *  `{ next, prev, reason }` — ISO strings (or `null`); `reason` ∈
      *  `'user' | 'reset' | 'restore'`. `preventDefault()` vetoes a `'user'` pick in
      *  uncontrolled mode. */
@@ -904,8 +933,8 @@ export interface ACalendarAttributes extends BaseAttributes {
         prev: string | null;
         reason: 'user' | 'reset' | 'restore';
     }>) => void;
-    /** Native `change`, fired AFTER a selection applies (uncontrolled) and on
-     *  reset/restore. */
+    /** Native `change`, fired AFTER a selection applies, including controlled
+     *  attribute updates and accepted reset/restore. */
     onchange?: (e: Event) => void;
     /** Keyboard navigation request — the element handles arrow / Home / End /
      *  PageUp / PageDown, focuses the target cell when it's rendered, and emits this
@@ -939,9 +968,10 @@ export interface AMenuAttributes extends BaseAttributes {
      *  default; this opts out, making the submenu click-only. Presence-based
      *  (`''` on, omit off). */
     nohover?: boolean | '';
-    /** Round: container softens to a 20px radius and its items go fully round. A
-     *  length value (`round="12px"`) tunes the container radius only (items stay
-     *  pills). Presence-based for the boolean form. */
+    /** Round the container to a 20px radius, or use a length such as `round="12px"`
+     *  for a custom radius. Items use the container radius minus the menu's inset,
+     *  clamped to zero. Submenus inherit the radius unless they set their own
+     *  `round` value. Presence-based for the boolean form. */
     round?: boolean | number | string;
     /** Gap in pixels between the trigger and the menu. Defaults to 4. */
     offset?: number | string;
@@ -1150,8 +1180,7 @@ export interface ARadioAttributes extends BaseAttributes {
  * optional `<a-radio-hint>`. All plain light-DOM children, laid out by
  * `a-radio-group.css`, so the arrangement is restylable with ordinary CSS
  * (`a-radio-group a-radio-list { … }`). The group
- * coordinates **off-DOM only** — it never writes the DOM: selection via each
- * radio's `selected` property, focus via `internals.ariaActiveDescendantElement`,
+ * coordinates selection off-DOM through each radio's `selected` property, focus via `internals.ariaActiveDescendantElement`,
  * the form value via `setFormValue`. Roving `tabindex` (the JSX path) is rendered
  * by the `RadioGroup` wrapper, not the element. The `RadioGroup` wrapper composes
  * the label/list/hint from `label` / `hint`; hand-authors write them directly.
@@ -1159,8 +1188,8 @@ export interface ARadioAttributes extends BaseAttributes {
  */
 export interface ARadioGroupAttributes extends BaseAttributes {
     /** Controlled selected value (the chosen radio's `value`). Present → controlled:
-     *  the element reflects changes to this attribute and a pick only dispatches
-     *  `statechange`. Absent → uncontrolled (seed with `default-state`). */
+     *  a pick only requests a change through `statechange`. Absent → uncontrolled
+     *  (seed with `default-state`). */
     state?: string;
     /** Uncontrolled initial selected value — read once on connect / form-reset. */
     'default-state'?: string;
@@ -1252,8 +1281,8 @@ export interface ATabAttributes extends BaseAttributes {
  * `a-tabs.css`, so the strip is restylable with ordinary CSS and usable hand-assembled.
  * Unlike `<a-radio-group>` it is NOT form-associated (a tablist submits nothing), and
  * the panels live outside it (siblings the `Tabs` wrapper shows/hides). The element
- * coordinates **off-DOM only** — selection via each tab's `selected` property, focus via
- * `internals.ariaActiveDescendantElement`, scroll via `scrollIntoView`. Roving
+ * coordinates selection **off-DOM** — selection via each tab's `selected` property, focus via
+ * `internals.ariaActiveDescendantElement`, scroll within the strip's own scrollport. Roving
  * `tabindex` (the JSX path) is rendered by the `Tabs` wrapper, not the element. For the
  * typed JSX wrapper use `Tabs` from `@antadesign/anta`.
  */
@@ -1334,16 +1363,11 @@ export interface ATabpanelAttributes extends BaseAttributes {
      *  `internals.ariaLabelledByElements`. */
     role?: 'tabpanel';
 }
-/**
- * Attributes for the `<a-card>` custom element — a surface container that lays out
- * an optional `media` region plus a `header` / body / `footer` stack, and becomes a
- * link when given `href`. Slots (light-DOM children): `media`, `icon`, `header`,
- * `footer`, and the default slot for the body. The element exposes
- * `::part(container | media | content | icon | header | body | footer)`. In link
- * mode it names the shadow anchor from `aria-label` → header text → body text →
- * `href`. Low-level attributes; for the typed JSX wrapper use `Card` from
- * `@antadesign/anta`.
- */
+/** Surface attributes for the CSS-only `<a-card>` tag. Its `a-card-*` children
+ * define the layout. Put navigation attributes and link ARIA on a native `<a>`
+ * directly under `a-card`, marked with `data-anta-card-link`. Its
+ * `a-card-layout` child groups media and content. The JSX `Card` wrapper emits
+ * this structure. */
 export interface ACardAttributes extends BaseAttributes {
     /** Semantic tone, or any literal CSS color for a one-off custom tone. Named tones
      *  re-point the surface + text; a custom color keeps its hue with lightness/chroma
@@ -1354,40 +1378,22 @@ export interface ACardAttributes extends BaseAttributes {
     priority?: 'primary' | 'secondary' | 'tertiary';
     /** Size variant — scales the padding. `medium` is the default. */
     size?: 'small' | 'medium' | 'large';
-    /** Which edge the full-bleed `media` slot sits on. `top` is the default. */
+    /** Which edge the full-bleed `a-card-media` region sits on. `top` is the default. */
     'media-position'?: 'top' | 'bottom' | 'left' | 'right';
     /** Selected / chosen state — an inset ring in the tone color. Presence-based
      *  (`''` on, omit off). */
     selected?: boolean | '';
-    /** Loading state — skeleton pulse, `aria-busy`, and (in link mode) navigation is
-     *  blocked (the anchor drops its `href`). Presence-based (`''` on, omit off). */
+    /** Visual loading state. Raw authors also set `aria-busy` on the semantic node
+     *  and remove the native anchor's `href` to block keyboard navigation. */
     loading?: boolean | '';
     /** Fully-round corners (`border-radius: 999px`), or a custom radius via a length
      *  value (`round="16px"`). Presence-based for the boolean form. */
     round?: boolean | number | string;
-    /** Turn the whole card into a link — the shadow container becomes a focusable
-     *  anchor with this URL. */
-    href?: string;
-    /** Anchor target (only with `href`). */
-    target?: string;
-    /** Anchor rel (only with `href`). */
-    rel?: string;
-    /** Space-separated URLs pinged on navigation (only with `href`). */
-    ping?: string;
-    /** Explicit accessible name for the link — overrides the header → body → href
-     *  chain the element derives in link mode. */
-    'aria-label'?: string;
 }
-/**
- * Attributes for the `<a-banner>` custom element — a full-width, dismissible
- * message strip (borderless by default; opt into a rule via `border-bottom-width` /
- * `border-width`, the Progress pattern). Slots (light-DOM children): `message`
- * (leading), the default slot (middle content), `actions` (trailing), and `close`
- * (the ✕ button). The element exposes `::part(message | content | actions | close)`,
- * and `:state(open)` / `:state(closed)` as visibility hooks (the external
- * sheet collapses the host on `:state(closed)`). Low-level attributes; for the
- * typed JSX wrapper use `Banner` from `@antadesign/anta`.
- */
+/** Light-DOM Banner attributes. Authors supply `a-banner-message`, optional
+ * boxless `a-banner-content`, one `a-banner-actions` region, and `a-banner-close`
+ * containing an accessible Button. `statechange` requests dismissal;
+ * ElementInternals holds uncontrolled visibility without rewriting authored DOM. */
 export interface ABannerAttributes extends BaseAttributes {
     /** Controlled visibility (`'open'` / `'closed'`). Present → controlled: the
      *  attribute is the source of truth, the ✕ dismiss only dispatches the cancelable
@@ -1424,7 +1430,7 @@ export interface ABannerAttributes extends BaseAttributes {
  * Attributes for the `<a-toaster>` custom element — a viewport-anchored
  * notification region. One instance hosts all six placement zones; each
  * `<a-toast>` routes to a corner/edge by its `slot` attribute. Keep one mounted
- * (the `<Toaster>` wrapper, or by hand). Exposes `::part(region)`. Low-level
+ * (the `<Toaster>` wrapper, or by hand). Exposes `::part(region)`, `::part(zone)`, and a part for each placement. Low-level
  * attributes; for the typed JSX wrapper use `Toaster` from `@antadesign/anta`.
  */
 export interface AToasterAttributes extends BaseAttributes {
@@ -1450,10 +1456,11 @@ export interface AToastAttributes extends BaseAttributes {
     leaving?: boolean | '';
     /** Bumped on an in-place update so the element restarts its auto-dismiss timer. */
     rev?: number | string;
-    /** A live DOM node to show as the content (the wrapper's DOM-node branch);
-     *  set as a property, not a string attribute. String / JSX content is slotted
-     *  as children instead. */
-    content?: Node;
+    /** Transfer insertion ownership of a live node to Toast. Set as a property;
+     * never supply a node still owned by another reconciler. Identity and listeners
+     * are retained. Replacing or clearing removes only the supplied node or a
+     * fragment's inserted children. String/JSX content remains authored children. */
+    content?: Node | null;
     /** Fires after the exit animation, when the toast has dismissed — a bubbling
      *  `CustomEvent`. The owner removes the node in response. All-lowercase so both
      *  renderers bind it (React 19 keeps the case after `on`; Preact lowercases). */

package/dist/index.d.ts

@@ -103,7 +103,7 @@ export { Toaster, createToaster } from './components/Toaster';
 export type { ToasterProps, ToasterManager, ToastOptions, ToastPlacement, ToastContent, ToastRender, } from './components/Toaster';
 export type { BaseProps, BaseAttributes, ToneScope } from './general_types';
 export { configure } from './jsx-runtime';
-export type { AntaIntrinsicElements } from './jsx-runtime';
+export type { AntaIntrinsicElements, RendererHooks, RendererOptions } from './jsx-runtime';
 /**
  * Seed interface for the icon shape registry. The generated
  * `a-icon.shapes.d.ts` augments this interface with one key per

package/dist/input-events.d.ts

@@ -0,0 +1,4 @@
+export declare const CLEAR_TRIGGER = "clearrequest";
+export declare const CLEAR_CLICK_EVENT = "clearclick";
+export declare const CLEAR_INPUT_EVENT = "clearinput";
+export declare function ownsInputClearRequest(host: Element, event: Event): boolean;

package/dist/input-events.js

@@ -0,0 +1,15 @@
+const CLEAR_TRIGGER = "clearrequest";
+const CLEAR_CLICK_EVENT = "clearclick";
+const CLEAR_INPUT_EVENT = "clearinput";
+function ownsInputClearRequest(host, event) {
+  return event.composedPath().find((node) => {
+    const name = node?.localName;
+    return name === "a-input" || name === "a-input-time";
+  }) === host;
+}
+export {
+  CLEAR_CLICK_EVENT,
+  CLEAR_INPUT_EVENT,
+  CLEAR_TRIGGER,
+  ownsInputClearRequest
+};