@aihu/primitives 0.0.12 → 0.1.0

package/dist/input.js

@@ -0,0 +1,42 @@
+import { n as TEXT_CONTROL_OBSERVED, t as AihuTextControlBase } from "./text-control-BBX7s8Oe.js";
+//#region src/input/index.ts
+/**
+* `<aihu-input>` — headless single-line text control. Wraps (or creates) a
+* real light-DOM `<input>` and delegates editing/focus/form participation to
+* it (the native-handoff principle — see `text-control.ts`). Ships zero CSS:
+* the host reflects `data-state="disabled" | "readonly" | "idle"` and emits
+* `value-change` CustomEvents for the consumer.
+*/
+const INPUT_FORWARDED = [
+	"type",
+	"name",
+	"placeholder",
+	"autocomplete",
+	"inputmode",
+	"pattern",
+	"min",
+	"max",
+	"step",
+	"minlength",
+	"maxlength",
+	"readonly"
+];
+var AihuInput = class extends AihuTextControlBase {
+	static observedAttributes = [...TEXT_CONTROL_OBSERVED, ...INPUT_FORWARDED];
+	static FORWARDED = INPUT_FORWARDED;
+	nativeTag = "input";
+};
+let _defined = false;
+/** Register `<aihu-input>` (idempotent). */
+function defineInput(tag = "aihu-input") {
+	if (_defined || customElements.get(tag)) {
+		_defined = true;
+		return;
+	}
+	customElements.define(tag, AihuInput);
+	_defined = true;
+}
+//#endregion
+export { AihuInput, AihuTextControlBase, defineInput };
+
+//# sourceMappingURL=input.js.map

package/dist/input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.js","names":[],"sources":["../src/input/index.ts"],"sourcesContent":["/**\n * `<aihu-input>` — headless single-line text control. Wraps (or creates) a\n * real light-DOM `<input>` and delegates editing/focus/form participation to\n * it (the native-handoff principle — see `text-control.ts`). Ships zero CSS:\n * the host reflects `data-state=\"disabled\" | \"readonly\" | \"idle\"` and emits\n * `value-change` CustomEvents for the consumer.\n */\n\nimport { AihuTextControlBase, TEXT_CONTROL_OBSERVED } from './text-control.ts'\n\nconst INPUT_FORWARDED: readonly string[] = [\n  'type',\n  'name',\n  'placeholder',\n  'autocomplete',\n  'inputmode',\n  'pattern',\n  'min',\n  'max',\n  'step',\n  'minlength',\n  'maxlength',\n  'readonly',\n]\n\nexport class AihuInput extends AihuTextControlBase {\n  static readonly observedAttributes = [...TEXT_CONTROL_OBSERVED, ...INPUT_FORWARDED]\n  protected static override readonly FORWARDED = INPUT_FORWARDED\n\n  protected override readonly nativeTag = 'input' as const\n}\n\nlet _defined = false\n/** Register `<aihu-input>` (idempotent). */\nexport function defineInput(tag = 'aihu-input'): void {\n  if (_defined || customElements.get(tag)) {\n    _defined = true\n    return\n  }\n  customElements.define(tag, AihuInput)\n  _defined = true\n}\n\nexport { AihuTextControlBase } from './text-control.ts'\n"],"mappings":";;;;;;;;;AAUA,MAAM,kBAAqC;CACzC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;AAED,IAAa,YAAb,cAA+B,oBAAoB;CACjD,OAAgB,qBAAqB,CAAC,GAAG,uBAAuB,GAAG,gBAAgB;CACnF,OAAmC,YAAY;CAE/C,YAAwC;;AAG1C,IAAI,WAAW;;AAEf,SAAgB,YAAY,MAAM,cAAoB;CACpD,IAAI,YAAY,eAAe,IAAI,IAAI,EAAE;EACvC,WAAW;EACX;;CAEF,eAAe,OAAO,KAAK,UAAU;CACrC,WAAW"}

package/dist/label.d.ts

@@ -0,0 +1,24 @@
+import { Read } from "@aihu/signals";
+
+//#region src/label/index.d.ts
+declare class AihuLabel extends HTMLElement {
+  static readonly observedAttributes: string[];
+  private readonly _for;
+  private _fc;
+  private _disposers;
+  /** The explicit target id (`for` attribute) as a signal; null when unset. */
+  get forId(): Read<string | null>;
+  private get _isNativeLabel();
+  connectedCallback(): void;
+  disconnectedCallback(): void;
+  attributeChangedCallback(name: string, _old: string | null, value: string | null): void;
+  /** Resolve the labelled target NOW (per interaction — never cached). */
+  private _resolveTarget;
+  private readonly _onMousedown;
+  private readonly _onClick;
+}
+/** Register `<aihu-label>` (idempotent). */
+declare function defineLabel(tag?: string): void;
+//#endregion
+export { AihuLabel, defineLabel };
+//# sourceMappingURL=label.d.ts.map

package/dist/label.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"label.d.ts","names":[],"sources":["../src/label/index.ts"],"mappings":";;;cA2Ca,SAAA,SAAkB,WAAA;EAAA,gBACb,kBAAA;EAAA,iBAEC,IAAA;EAAA,QACT,GAAA;EAAA,QACA,UAAA;;MAGJ,KAAA,CAAA,GAAS,IAAA;EAAA,YAID,cAAA,CAAA;EAIZ,iBAAA,CAAA;EA4CA,oBAAA,CAAA;EAOA,wBAAA,CAAyB,IAAA,UAAc,IAAA,iBAAqB,KAAA;;UAKpD,cAAA;EAAA,iBAWS,YAAA;EAAA,iBAKA,QAAA;AAAA;;iBAwCH,WAAA,CAAY,GAAA"}

package/dist/label.js

@@ -0,0 +1,136 @@
+import { injectValue } from "./dom-context.js";
+import { r as formControlContext, t as AihuFormControl } from "./form-control-B_BO9j7_.js";
+import { effect, signal } from "@aihu/signals";
+//#region src/label/index.ts
+/**
+* `<aihu-label>` — headless label (the Radix Label parity primitive). Wires
+* the label↔control association and forwards interactions the way a native
+* `<label>` does, for targets that native labels cannot reference (custom
+* hosts, role=checkbox/switch/radio elements). Ships NO CSS.
+*
+* Behavior:
+* - On connect: ensures a stable `id`, stamps `data-fc-label` on itself so an
+*   ancestor `<aihu-form-control>` discovers it, and (when inside one) asks
+*   that ancestor to re-wire so the control gains
+*   `aria-labelledby="<labelId>"`.
+* - Target resolution (re-resolved per interaction, never cached): the `for`
+*   attribute is looked up via `getElementById` in the label's root; with no
+*   `for`, a `formControlContext` ancestor's `controlId` is used.
+* - Standalone (no form-control ancestor): sets `aria-labelledby` = own id on
+*   the resolved target reactively. Skipped when the target lives in a
+*   different root — ARIA IDREFs cannot cross shadow boundaries (see
+*   accessibility.md; use `aria-label` on the target for cross-root cases).
+* - Click forwarding (non-native hosts only): double-click `mousedown` is
+*   prevented (no accidental text selection); `click` focuses native text
+*   controls, forwards `click()` to native checkbox/radio or custom
+*   checkbox/switch/radio hosts, and does nothing for disabled targets or
+*   clicks originating on nested interactive children.
+* - If the host IS a native `<label>` (tagName `LABEL`), click forwarding is
+*   native — only the context wiring above applies.
+*
+* Reflected attributes: `for` (optional explicit target id).
+*/
+let _idCounter = 0;
+function nextId() {
+	_idCounter += 1;
+	return `aihu-label-${_idCounter}`;
+}
+var AihuLabel = class extends HTMLElement {
+	static observedAttributes = ["for"];
+	_for = signal(null);
+	_fc = null;
+	_disposers = [];
+	/** The explicit target id (`for` attribute) as a signal; null when unset. */
+	get forId() {
+		return this._for[0];
+	}
+	get _isNativeLabel() {
+		return this.tagName === "LABEL";
+	}
+	connectedCallback() {
+		this._for[1](this.getAttribute("for"));
+		if (!this.id) this.id = nextId();
+		this.setAttribute("data-fc-label", "");
+		try {
+			this._fc = injectValue(this, formControlContext);
+		} catch {
+			this._fc = null;
+		}
+		if (this._fc) {
+			let node = this.parentElement;
+			while (node) {
+				if (node instanceof AihuFormControl) {
+					node.recomputeDescribedBy();
+					break;
+				}
+				node = node.parentElement;
+			}
+		} else if (!this._isNativeLabel) this._disposers.push(effect(() => {
+			this._for[0]();
+			const target = this._resolveTarget();
+			if (target && target.getRootNode() === this.getRootNode()) target.setAttribute("aria-labelledby", this.id);
+		}));
+		if (!this._isNativeLabel) {
+			this.addEventListener("mousedown", this._onMousedown);
+			this.addEventListener("click", this._onClick);
+		}
+	}
+	disconnectedCallback() {
+		this.removeEventListener("mousedown", this._onMousedown);
+		this.removeEventListener("click", this._onClick);
+		for (const d of this._disposers) d();
+		this._disposers = [];
+	}
+	attributeChangedCallback(name, _old, value) {
+		if (name === "for") this._for[1](value);
+	}
+	/** Resolve the labelled target NOW (per interaction — never cached). */
+	_resolveTarget() {
+		const root = this.getRootNode();
+		const forId = this._for[0]();
+		if (forId) return root.getElementById(forId) ?? null;
+		if (this._fc) {
+			const id = this._fc.controlId();
+			if (id) return root.getElementById(id) ?? null;
+		}
+		return null;
+	}
+	_onMousedown = (ev) => {
+		if (ev.detail > 1) ev.preventDefault();
+	};
+	_onClick = (ev) => {
+		const target = this._resolveTarget();
+		if (!target) return;
+		const origin = ev.target instanceof Element ? ev.target : null;
+		const interactive = origin?.closest("button,input,select,textarea,a") ?? null;
+		if (interactive !== null && interactive !== target) return;
+		if (origin !== null && (origin === target || target.contains(origin))) return;
+		if (target.getAttribute("aria-disabled") === "true" || target.disabled === true) return;
+		const tag = target.tagName;
+		const inputType = tag === "INPUT" ? target.type : null;
+		if (inputType === "checkbox" || inputType === "radio") {
+			target.click();
+			return;
+		}
+		if (tag === "INPUT" || tag === "TEXTAREA" || tag === "SELECT") {
+			target.focus();
+			return;
+		}
+		const role = target.getAttribute("role");
+		if (role === "checkbox" || role === "switch" || role === "radio") target.click();
+	};
+};
+let _defined = false;
+/** Register `<aihu-label>` (idempotent). */
+function defineLabel(tag = "aihu-label") {
+	if (_defined || customElements.get(tag)) {
+		_defined = true;
+		return;
+	}
+	customElements.define(tag, AihuLabel);
+	_defined = true;
+}
+//#endregion
+export { AihuLabel, defineLabel };
+
+//# sourceMappingURL=label.js.map

package/dist/label.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"label.js","names":[],"sources":["../src/label/index.ts"],"sourcesContent":["/**\n * `<aihu-label>` — headless label (the Radix Label parity primitive). Wires\n * the label↔control association and forwards interactions the way a native\n * `<label>` does, for targets that native labels cannot reference (custom\n * hosts, role=checkbox/switch/radio elements). Ships NO CSS.\n *\n * Behavior:\n * - On connect: ensures a stable `id`, stamps `data-fc-label` on itself so an\n *   ancestor `<aihu-form-control>` discovers it, and (when inside one) asks\n *   that ancestor to re-wire so the control gains\n *   `aria-labelledby=\"<labelId>\"`.\n * - Target resolution (re-resolved per interaction, never cached): the `for`\n *   attribute is looked up via `getElementById` in the label's root; with no\n *   `for`, a `formControlContext` ancestor's `controlId` is used.\n * - Standalone (no form-control ancestor): sets `aria-labelledby` = own id on\n *   the resolved target reactively. Skipped when the target lives in a\n *   different root — ARIA IDREFs cannot cross shadow boundaries (see\n *   accessibility.md; use `aria-label` on the target for cross-root cases).\n * - Click forwarding (non-native hosts only): double-click `mousedown` is\n *   prevented (no accidental text selection); `click` focuses native text\n *   controls, forwards `click()` to native checkbox/radio or custom\n *   checkbox/switch/radio hosts, and does nothing for disabled targets or\n *   clicks originating on nested interactive children.\n * - If the host IS a native `<label>` (tagName `LABEL`), click forwarding is\n *   native — only the context wiring above applies.\n *\n * Reflected attributes: `for` (optional explicit target id).\n */\n\nimport { effect, type Read, signal } from '@aihu/signals'\nimport { injectValue } from '../dom-context.ts'\nimport {\n  AihuFormControl,\n  type FormControlContextValue,\n  formControlContext,\n} from '../form-control/index.ts'\n\nlet _idCounter = 0\nfunction nextId(): string {\n  _idCounter += 1\n  return `aihu-label-${_idCounter}`\n}\n\nexport class AihuLabel extends HTMLElement {\n  static readonly observedAttributes = ['for']\n\n  private readonly _for = signal<string | null>(null)\n  private _fc: FormControlContextValue | null = null\n  private _disposers: Array<() => void> = []\n\n  /** The explicit target id (`for` attribute) as a signal; null when unset. */\n  get forId(): Read<string | null> {\n    return this._for[0]\n  }\n\n  private get _isNativeLabel(): boolean {\n    return this.tagName === 'LABEL'\n  }\n\n  connectedCallback(): void {\n    this._for[1](this.getAttribute('for'))\n    if (!this.id) this.id = nextId()\n    // Make this label discoverable by an ancestor <aihu-form-control>.\n    this.setAttribute('data-fc-label', '')\n\n    try {\n      this._fc = injectValue(this, formControlContext)\n    } catch {\n      this._fc = null\n    }\n\n    if (this._fc) {\n      // The form-control connected (and wired) before this label existed in\n      // its eyes — ask it to re-derive associations so the control gains\n      // aria-labelledby pointing at this label.\n      let node: Element | null = this.parentElement\n      while (node) {\n        if (node instanceof AihuFormControl) {\n          node.recomputeDescribedBy()\n          break\n        }\n        node = node.parentElement\n      }\n    } else if (!this._isNativeLabel) {\n      // Standalone: stamp aria-labelledby on the resolved target reactively.\n      // Skip cross-root targets — IDREFs cannot cross shadow boundaries.\n      this._disposers.push(\n        effect(() => {\n          this._for[0]() // track `for` changes\n          const target = this._resolveTarget()\n          if (target && target.getRootNode() === this.getRootNode()) {\n            target.setAttribute('aria-labelledby', this.id)\n          }\n        }),\n      )\n    }\n\n    if (!this._isNativeLabel) {\n      this.addEventListener('mousedown', this._onMousedown)\n      this.addEventListener('click', this._onClick)\n    }\n  }\n\n  disconnectedCallback(): void {\n    this.removeEventListener('mousedown', this._onMousedown)\n    this.removeEventListener('click', this._onClick)\n    for (const d of this._disposers) d()\n    this._disposers = []\n  }\n\n  attributeChangedCallback(name: string, _old: string | null, value: string | null): void {\n    if (name === 'for') this._for[1](value)\n  }\n\n  /** Resolve the labelled target NOW (per interaction — never cached). */\n  private _resolveTarget(): HTMLElement | null {\n    const root = this.getRootNode() as Document | ShadowRoot\n    const forId = this._for[0]()\n    if (forId) return (root.getElementById(forId) as HTMLElement | null) ?? null\n    if (this._fc) {\n      const id = this._fc.controlId()\n      if (id) return (root.getElementById(id) as HTMLElement | null) ?? null\n    }\n    return null\n  }\n\n  private readonly _onMousedown = (ev: MouseEvent): void => {\n    // Prevent text selection on double-click (native label parity).\n    if (ev.detail > 1) ev.preventDefault()\n  }\n\n  private readonly _onClick = (ev: MouseEvent): void => {\n    const target = this._resolveTarget()\n    if (!target) return\n\n    const origin = ev.target instanceof Element ? ev.target : null\n    // Clicks originating on a nested interactive child (that is not the\n    // labelled target) are the child's business — don't forward.\n    const interactive = origin?.closest('button,input,select,textarea,a') ?? null\n    if (interactive !== null && interactive !== target) return\n    // Clicks already on/inside the target need no forwarding (and forwarding\n    // a click back to the target would recurse).\n    if (origin !== null && (origin === target || target.contains(origin))) return\n\n    // Disabled targets don't get forwarded interactions.\n    if (\n      target.getAttribute('aria-disabled') === 'true' ||\n      (target as HTMLInputElement).disabled === true\n    ) {\n      return\n    }\n\n    const tag = target.tagName\n    const inputType = tag === 'INPUT' ? (target as HTMLInputElement).type : null\n    if (inputType === 'checkbox' || inputType === 'radio') {\n      target.click()\n      return\n    }\n    if (tag === 'INPUT' || tag === 'TEXTAREA' || tag === 'SELECT') {\n      target.focus()\n      return\n    }\n    const role = target.getAttribute('role')\n    if (role === 'checkbox' || role === 'switch' || role === 'radio') {\n      target.click()\n    }\n  }\n}\n\nlet _defined = false\n/** Register `<aihu-label>` (idempotent). */\nexport function defineLabel(tag = 'aihu-label'): void {\n  if (_defined || customElements.get(tag)) {\n    _defined = true\n    return\n  }\n  customElements.define(tag, AihuLabel)\n  _defined = true\n}\n"],"mappings":"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"}

package/dist/radio-group.d.ts

@@ -0,0 +1,82 @@
+import { DomContext } from "./dom-context.js";
+import { AihuRovingFocus } from "./roving-focus.js";
+import { Read } from "@aihu/signals";
+
+//#region src/radio-group/index.d.ts
+interface RadioGroupContextValue {
+  /** Currently selected item value; null when nothing is selected. */
+  readonly value: Read<string | null>;
+  /** Group-effective disabled (own attribute ∥ inherited form-control). */
+  readonly disabled: Read<boolean>;
+  readonly required: Read<boolean>;
+  /** Programmatic write: signal + reflected `value` attribute. NO event. */
+  setValue(next: string | null): void;
+  /** USER-driven selection of `item` (click path): moves the tab stop to the
+   * item WITHOUT stealing focus, selects its value, emits `value-change`. */
+  selectItem(item: Element): void;
+}
+declare const radioGroupContext: DomContext<RadioGroupContextValue>;
+/** Per-item context so `<aihu-radio-group-indicator>` mirrors its OWN item
+ * (nearest-provider-wins walk lands on the enclosing item, not the root). */
+interface RadioGroupItemContextValue {
+  readonly checked: Read<boolean>;
+  readonly disabled: Read<boolean>;
+}
+declare const radioGroupItemContext: DomContext<RadioGroupItemContextValue>;
+declare class AihuRadioGroupRoot extends AihuRovingFocus {
+  static readonly observedAttributes: string[];
+  private readonly _value;
+  private readonly _name;
+  private readonly _groupDisabled;
+  private readonly _required;
+  private _fc;
+  private _rgDisposers;
+  private _defaultSeeded;
+  constructor();
+  get value(): Read<string | null>;
+  /** Programmatic write: signal + reflected `value` attribute (two-way,
+   * dialog open-attr pattern). Does NOT emit `value-change`. */
+  setValue(next: string | null): void;
+  /** Move the roving current index. With `focus = true` (the base keyboard
+   * path — arrows/Home/End) this ALSO selects the landed item's value (APG:
+   * moving focus in a radio group selects). `focus = false` moves the tab
+   * stop silently and never selects. */
+  setCurrent(index: number, focus?: boolean): void;
+  connectedCallback(): void;
+  disconnectedCallback(): void;
+  attributeChangedCallback(name: string, old: string | null, value: string | null): void;
+  private _effectiveDisabled;
+  private _effectiveRequired;
+  private _syncOwnAttrs;
+  private _selectItem;
+  private _userSelect;
+}
+declare class AihuRadioGroupItem extends HTMLElement {
+  static readonly observedAttributes: string[];
+  private readonly _itemValue;
+  private readonly _disabled;
+  private _ctx;
+  private _collection;
+  private _unregister;
+  private _disposers;
+  constructor();
+  connectedCallback(): void;
+  disconnectedCallback(): void;
+  attributeChangedCallback(name: string, _old: string | null, value: string | null): void;
+  private _checked;
+  private _effectiveDisabled;
+  private readonly _onKeydown;
+  private readonly _onClickCapture;
+}
+/** Presentational styling hook: mirrors its enclosing ITEM's state (nearest
+ * `radioGroupItemContext` provider), hidden from AT. */
+declare class AihuRadioGroupIndicator extends HTMLElement {
+  private _disposers;
+  connectedCallback(): void;
+  disconnectedCallback(): void;
+}
+/** Register all radio-group custom elements (idempotent). */
+declare function defineRadioGroup(): void;
+//#endregion
+export { AihuRadioGroupIndicator, AihuRadioGroupItem, AihuRadioGroupRoot, RadioGroupContextValue, RadioGroupItemContextValue, defineRadioGroup, radioGroupContext, radioGroupItemContext };
+//# sourceMappingURL=radio-group.d.ts.map

package/dist/radio-group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"radio-group.d.ts","names":[],"sources":["../src/radio-group/index.ts"],"mappings":";;;;;UAgCiB,sBAAA;EAUJ;EAAA,SARF,KAAA,EAAO,IAAA;EAQQ;EAAA,SANf,QAAA,EAAU,IAAA;EAAA,SACV,QAAA,EAAU,IAAA;;EAEnB,QAAA,CAAS,IAAA;EAMmB;AAI9B;EAPE,UAAA,CAAW,IAAA,EAAM,OAAA;AAAA;AAAA,cAGN,iBAAA,EAAiB,UAAA,CAAA,sBAAA;;;UAIb,0BAAA;EAAA,SACN,OAAA,EAAS,IAAA;EAAA,SACT,QAAA,EAAU,IAAA;AAAA;AAAA,cAGR,qBAAA,EAAqB,UAAA,CAAA,0BAAA;AAAA,cAGrB,kBAAA,SAA2B,eAAA;EAAA,gBACb,kBAAA;EAAA,iBASR,MAAA;EAAA,iBACA,KAAA;EAAA,iBACA,cAAA;EAAA,iBACA,SAAA;EAAA,QACT,GAAA;EAAA,QACA,YAAA;EAAA,QACA,cAAA;;MAaJ,KAAA,CAAA,GAAS,IAAA;EAlBI;;EAwBjB,QAAA,CAAS,IAAA;EArBD;;;;EAgCC,UAAA,CAAW,KAAA,UAAe,KAAA;EAS1B,iBAAA,CAAA;EA0EA,oBAAA,CAAA;EAMA,wBAAA,CAAyB,IAAA,UAAc,GAAA,iBAAoB,KAAA;EAAA,QAuB5D,kBAAA;EAAA,QAKA,kBAAA;EAAA,QAKA,aAAA;EAAA,QAMA,WAAA;EAAA,QASA,WAAA;AAAA;AAAA,cAcG,kBAAA,SAA2B,WAAA;EAAA,gBACtB,kBAAA;EAAA,iBAEC,UAAA;EAAA,iBACA,SAAA;EAAA,QACT,IAAA;EAAA,QACA,WAAA;EAAA,QACA,WAAA;EAAA,QACA,UAAA;;EAUR,iBAAA,CAAA;EAkDA,oBAAA,CAAA;EASA,wBAAA,CAAyB,IAAA,UAAc,IAAA,iBAAqB,KAAA;EAAA,QAKpD,QAAA;EAAA,QAKA,kBAAA;EAAA,iBAKS,UAAA;EAAA,iBAcA,eAAA;AAAA;;;cAYN,uBAAA,SAAgC,WAAA;EAAA,QACnC,UAAA;EAER,iBAAA,CAAA;EAYA,oBAAA,CAAA;AAAA;;iBAcc,gBAAA,CAAA"}

package/dist/radio-group.js

@@ -0,0 +1,298 @@
+import { createDomContext, injectValue, provideContext } from "./dom-context.js";
+import { i as attachHiddenInput, r as formControlContext } from "./form-control-B_BO9j7_.js";
+import { collectionContext } from "./collection.js";
+import { AihuRovingFocus } from "./roving-focus.js";
+import { effect, signal, untrack } from "@aihu/signals";
+//#region src/radio-group/index.ts
+/**
+* Headless radio group — `<aihu-radio-group-root>` (state owner, EXTENDS
+* `AihuRovingFocus`) + `<aihu-radio-group-item>` (role="radio") +
+* presentational `<aihu-radio-group-indicator>`. Implements the WAI-ARIA APG
+* **Radio Group** pattern: `role="radiogroup"` on the root, roving tabindex
+* across the items (exactly one `tabindex="0"`), arrow keys move focus AND
+* select (orientation defaults to `"both"`, loop defaults ON for the APG
+* wrap), Space selects an unchecked item, Enter does NOT activate. Emits NO
+* CSS — each piece reflects `data-state="checked" | "unchecked"`
+* (+ `data-disabled` presence) for the consumer to style.
+*
+* Form participation rides `attachHiddenInput` (ONE root-owned
+* visually-hidden native radio in the root's light DOM): submits
+* `name → value` only when a selection exists — no selection submits nothing
+* (native parity).
+*
+* `value-change` (detail `{ value: string }`, bubbles, composed) is dispatched
+* on USER-driven selection only (clicks/keys via the roving `setCurrent`
+* path) — programmatic `setValue()` / attribute writes do not emit (checkbox
+* precedent).
+*/
+const radioGroupContext = createDomContext("radio-group");
+const radioGroupItemContext = createDomContext("radio-group-item");
+var AihuRadioGroupRoot = class extends AihuRovingFocus {
+	static observedAttributes = [
+		...AihuRovingFocus.observedAttributes,
+		"value",
+		"default-value",
+		"name",
+		"disabled",
+		"required"
+	];
+	_value = signal(null);
+	_name = signal(null);
+	_groupDisabled = signal(false);
+	_required = signal(false);
+	_fc = null;
+	_rgDisposers = [];
+	_defaultSeeded = false;
+	constructor() {
+		super();
+		provideContext(this, radioGroupContext, {
+			value: this._value[0],
+			disabled: () => this._effectiveDisabled(),
+			required: () => this._effectiveRequired(),
+			setValue: (next) => this.setValue(next),
+			selectItem: (item) => this._selectItem(item)
+		});
+	}
+	get value() {
+		return this._value[0];
+	}
+	/** Programmatic write: signal + reflected `value` attribute (two-way,
+	* dialog open-attr pattern). Does NOT emit `value-change`. */
+	setValue(next) {
+		if (next === this._value[0]()) return;
+		this._value[1](next);
+		if (next === null) this.removeAttribute("value");
+		else this.setAttribute("value", next);
+	}
+	/** Move the roving current index. With `focus = true` (the base keyboard
+	* path — arrows/Home/End) this ALSO selects the landed item's value (APG:
+	* moving focus in a radio group selects). `focus = false` moves the tab
+	* stop silently and never selects. */
+	setCurrent(index, focus = true) {
+		super.setCurrent(index, focus);
+		if (!focus) return;
+		const v = this.items()[this.currentIndex()]?.getAttribute("value") ?? null;
+		if (v === null) return;
+		this._userSelect(v);
+	}
+	connectedCallback() {
+		if (!this.hasAttribute("orientation")) this.setAttribute("orientation", "both");
+		if (!this.hasAttribute("loop")) this.setAttribute("loop", "");
+		if (this.hasAttribute("value")) this._value[1](this.getAttribute("value"));
+		else if (!this._defaultSeeded && this.hasAttribute("default-value")) this._value[1](this.getAttribute("default-value"));
+		this._defaultSeeded = true;
+		this._syncOwnAttrs();
+		if (!this.hasAttribute("role")) this.setAttribute("role", "radiogroup");
+		this.setAttribute("data-fc-control", "");
+		try {
+			this._fc = injectValue(this, formControlContext);
+		} catch {
+			this._fc = null;
+		}
+		super.connectedCallback();
+		this._rgDisposers.push(effect(() => {
+			if (this._effectiveRequired()) this.setAttribute("aria-required", "true");
+			else this.removeAttribute("aria-required");
+			if (this._effectiveDisabled()) {
+				this.setAttribute("aria-disabled", "true");
+				this.setAttribute("data-disabled", "");
+			} else {
+				this.removeAttribute("aria-disabled");
+				this.removeAttribute("data-disabled");
+			}
+		}), effect(() => {
+			const items = this.items();
+			const v = this._value[0]();
+			if (v === null) return;
+			const idx = items.findIndex((el) => el.getAttribute("value") === v);
+			if (idx < 0) return;
+			untrack(() => {
+				if (idx !== this.currentIndex()) this.setCurrent(idx, false);
+			});
+		}), attachHiddenInput(this, {
+			type: "radio",
+			name: this._name[0],
+			value: () => this._value[0]() ?? "",
+			checked: () => this._value[0]() !== null,
+			required: () => this._effectiveRequired(),
+			disabled: () => this._effectiveDisabled()
+		}));
+	}
+	disconnectedCallback() {
+		super.disconnectedCallback();
+		for (const d of this._rgDisposers) d();
+		this._rgDisposers = [];
+	}
+	attributeChangedCallback(name, old, value) {
+		switch (name) {
+			case "value":
+				this._value[1](value);
+				break;
+			case "name":
+				this._name[1](value);
+				break;
+			case "disabled":
+				this._groupDisabled[1](value !== null);
+				break;
+			case "required":
+				this._required[1](value !== null);
+				break;
+			case "default-value": break;
+			default: super.attributeChangedCallback(name, old, value);
+		}
+	}
+	_effectiveDisabled() {
+		if (this._groupDisabled[0]()) return true;
+		return this._fc ? this._fc.disabled() : false;
+	}
+	_effectiveRequired() {
+		if (this._required[0]()) return true;
+		return this._fc ? this._fc.required() : false;
+	}
+	_syncOwnAttrs() {
+		this._groupDisabled[1](this.hasAttribute("disabled"));
+		this._required[1](this.hasAttribute("required"));
+		this._name[1](this.getAttribute("name"));
+	}
+	_selectItem(item) {
+		if (this._effectiveDisabled()) return;
+		const idx = this.items().indexOf(item);
+		if (idx >= 0) this.setCurrent(idx, false);
+		const v = item.getAttribute("value");
+		if (v !== null) this._userSelect(v);
+	}
+	_userSelect(v) {
+		if (this._effectiveDisabled()) return;
+		if (v === this._value[0]()) return;
+		this.setValue(v);
+		this.dispatchEvent(new CustomEvent("value-change", {
+			detail: { value: v },
+			bubbles: true,
+			composed: true
+		}));
+	}
+};
+var AihuRadioGroupItem = class extends HTMLElement {
+	static observedAttributes = ["value", "disabled"];
+	_itemValue = signal(null);
+	_disabled = signal(false);
+	_ctx = null;
+	_collection = null;
+	_unregister = null;
+	_disposers = [];
+	constructor() {
+		super();
+		provideContext(this, radioGroupItemContext, {
+			checked: () => this._checked(),
+			disabled: () => this._effectiveDisabled()
+		});
+	}
+	connectedCallback() {
+		this._itemValue[1](this.getAttribute("value"));
+		this._disabled[1](this.hasAttribute("disabled"));
+		if (!this.hasAttribute("role")) this.setAttribute("role", "radio");
+		try {
+			this._ctx = injectValue(this, radioGroupContext);
+		} catch {
+			this._ctx = null;
+		}
+		try {
+			this._collection = injectValue(this, collectionContext);
+		} catch {
+			this._collection = null;
+		}
+		this.addEventListener("keydown", this._onKeydown);
+		this.addEventListener("click", this._onClickCapture, true);
+		this._disposers.push(effect(() => {
+			const checked = this._checked();
+			this.setAttribute("aria-checked", checked ? "true" : "false");
+			this.setAttribute("data-state", checked ? "checked" : "unchecked");
+			if (this._effectiveDisabled()) {
+				this.setAttribute("aria-disabled", "true");
+				this.setAttribute("data-disabled", "");
+			} else {
+				this.removeAttribute("aria-disabled");
+				this.removeAttribute("data-disabled");
+			}
+		}), effect(() => {
+			if (this._effectiveDisabled()) {
+				this._unregister?.();
+				this._unregister = null;
+				this.setAttribute("tabindex", "-1");
+			} else if (this._unregister === null && this._collection !== null) this._unregister = this._collection.register(this);
+		}));
+	}
+	disconnectedCallback() {
+		this.removeEventListener("keydown", this._onKeydown);
+		this.removeEventListener("click", this._onClickCapture, true);
+		this._unregister?.();
+		this._unregister = null;
+		for (const d of this._disposers) d();
+		this._disposers = [];
+	}
+	attributeChangedCallback(name, _old, value) {
+		if (name === "value") this._itemValue[1](value);
+		if (name === "disabled") this._disabled[1](value !== null);
+	}
+	_checked() {
+		const v = this._itemValue[0]();
+		return v !== null && this._ctx !== null && this._ctx.value() === v;
+	}
+	_effectiveDisabled() {
+		if (this._disabled[0]()) return true;
+		return this._ctx ? this._ctx.disabled() : false;
+	}
+	_onKeydown = (ev) => {
+		if (ev.key === "Enter") {
+			ev.preventDefault();
+			return;
+		}
+		if (ev.key === " " || ev.key === "Spacebar") {
+			ev.preventDefault();
+			if (this._effectiveDisabled()) return;
+			if (!this._checked()) this.click();
+		}
+	};
+	_onClickCapture = (ev) => {
+		if (this._effectiveDisabled()) {
+			ev.preventDefault();
+			ev.stopImmediatePropagation();
+			return;
+		}
+		this._ctx?.selectItem(this);
+	};
+};
+/** Presentational styling hook: mirrors its enclosing ITEM's state (nearest
+* `radioGroupItemContext` provider), hidden from AT. */
+var AihuRadioGroupIndicator = class extends HTMLElement {
+	_disposers = [];
+	connectedCallback() {
+		const ctx = injectValue(this, radioGroupItemContext);
+		this.setAttribute("aria-hidden", "true");
+		this._disposers.push(effect(() => {
+			this.setAttribute("data-state", ctx.checked() ? "checked" : "unchecked");
+			if (ctx.disabled()) this.setAttribute("data-disabled", "");
+			else this.removeAttribute("data-disabled");
+		}));
+	}
+	disconnectedCallback() {
+		for (const d of this._disposers) d();
+		this._disposers = [];
+	}
+};
+const REGISTRY = [
+	["aihu-radio-group-root", AihuRadioGroupRoot],
+	["aihu-radio-group-item", AihuRadioGroupItem],
+	["aihu-radio-group-indicator", AihuRadioGroupIndicator]
+];
+let _defined = false;
+/** Register all radio-group custom elements (idempotent). */
+function defineRadioGroup() {
+	if (_defined) return;
+	for (const [tag, ctor] of REGISTRY) if (!customElements.get(tag)) customElements.define(tag, ctor);
+	_defined = true;
+}
+//#endregion
+export { AihuRadioGroupIndicator, AihuRadioGroupItem, AihuRadioGroupRoot, defineRadioGroup, radioGroupContext, radioGroupItemContext };
+
+//# sourceMappingURL=radio-group.js.map