@aihu/primitives 0.0.1

package/dist/dialog-y7MHc6vf.js

@@ -0,0 +1,253 @@
+import { createDomContext, injectValue, provideContext } from "./dom-context.js";
+import { effect, signal } from "@aihu/signals";
+//#region src/dialog/focus-trap.ts
+/**
+* `createFocusTrap` — a tiny native-DOM focus trap (no library). Queries the
+* focusable descendants of a container, wraps Tab at the edges, moves focus to
+* the first focusable (or the container) on activate, and restores focus to the
+* previously-active element on deactivate. Used by `dialog-content`.
+*/
+const FOCUSABLE = "a[href], area[href], button:not([disabled]), input:not([disabled]):not([type=\"hidden\"]), select:not([disabled]), textarea:not([disabled]), [tabindex]:not([tabindex=\"-1\"]), [contenteditable=\"true\"], audio[controls], video[controls], details>summary:first-of-type";
+function focusables(container) {
+	return Array.from(container.querySelectorAll(FOCUSABLE)).filter((el) => el.offsetParent !== null || el === document.activeElement || isInJsdom(el));
+}
+/** jsdom does not lay out, so `offsetParent` is always null — treat all as visible there. */
+function isInJsdom(_el) {
+	return typeof navigator !== "undefined" && navigator.userAgent.includes("jsdom");
+}
+function createFocusTrap(container) {
+	let previouslyFocused = null;
+	let active = false;
+	const onKeydown = (ev) => {
+		if (!active || ev.key !== "Tab") return;
+		const items = focusables(container);
+		const first = items[0];
+		const last = items[items.length - 1];
+		if (!first || !last) {
+			ev.preventDefault();
+			return;
+		}
+		const current = container.getRootNode().activeElement;
+		if (ev.shiftKey && (current === first || !container.contains(current))) {
+			ev.preventDefault();
+			last.focus();
+		} else if (!ev.shiftKey && (current === last || !container.contains(current))) {
+			ev.preventDefault();
+			first.focus();
+		}
+	};
+	return {
+		activate() {
+			if (active) return;
+			active = true;
+			previouslyFocused = document.activeElement;
+			const items = focusables(container);
+			const target = items[0] ?? container;
+			if (!items.length && !container.hasAttribute("tabindex")) container.setAttribute("tabindex", "-1");
+			target.focus();
+			document.addEventListener("keydown", onKeydown, true);
+		},
+		deactivate() {
+			if (!active) return;
+			active = false;
+			document.removeEventListener("keydown", onKeydown, true);
+			previouslyFocused?.focus?.();
+			previouslyFocused = null;
+		}
+	};
+}
+//#endregion
+//#region src/dialog/index.ts
+/**
+* Headless dialog — `<aihu-dialog-root>` (state owner) + pieces
+* `<aihu-dialog-trigger>`, `<aihu-dialog-content>`, `<aihu-dialog-backdrop>`,
+* `<aihu-dialog-close>`, `<aihu-dialog-title>`, `<aihu-dialog-description>`.
+* Implements the WAI-ARIA APG **Dialog (Modal)** pattern: focus-trap +
+* return-focus, Escape-to-close, `role=dialog` / `aria-modal` /
+* `aria-labelledby` / `aria-describedby`, trigger `aria-haspopup` /
+* `aria-expanded` / `aria-controls`. Emits NO CSS — every piece reflects
+* `data-state="open"|"closed"` for the consumer to style.
+*/
+const dialogContext = createDomContext("dialog");
+let _idSeq = 0;
+const uid = (p) => `aihu-${p}-${_idSeq += 1}`;
+var AihuDialogRoot = class extends HTMLElement {
+	static observedAttributes = ["open", "modal"];
+	_open = signal(false);
+	_modal = signal(true);
+	_contentId = signal(uid("dialog"));
+	_titleId = signal(null);
+	_descriptionId = signal(null);
+	_disposers = [];
+	_ctx;
+	constructor() {
+		super();
+		this._ctx = {
+			open: this._open[0],
+			modal: this._modal[0],
+			contentId: this._contentId[0],
+			titleId: this._titleId[0],
+			descriptionId: this._descriptionId[0],
+			setTitleId: (id) => this._titleId[1](id),
+			setDescriptionId: (id) => this._descriptionId[1](id),
+			setOpen: (next) => this.setOpen(next),
+			close: () => this.setOpen(false),
+			toggle: () => this.setOpen(!this._open[0]())
+		};
+		provideContext(this, dialogContext, this._ctx);
+	}
+	get open() {
+		return this._open[0];
+	}
+	setOpen(next) {
+		if (next === this._open[0]()) return;
+		this._open[1](next);
+		if (next) this.setAttribute("open", "");
+		else this.removeAttribute("open");
+	}
+	connectedCallback() {
+		if (this.hasAttribute("modal")) this._modal[1](this.getAttribute("modal") !== "false");
+		this._open[1](this.hasAttribute("open"));
+		this._disposers.push(effect(() => {
+			this.setAttribute("data-state", this._open[0]() ? "open" : "closed");
+		}));
+	}
+	disconnectedCallback() {
+		for (const d of this._disposers) d();
+		this._disposers = [];
+	}
+	attributeChangedCallback(name, _old, value) {
+		if (name === "open") this._open[1](value !== null);
+		if (name === "modal") this._modal[1](value !== "false");
+	}
+};
+/** Base for pieces that inject the dialog context lazily on connect. */
+var DialogPiece = class extends HTMLElement {
+	ctx;
+	disposers = [];
+	connectedCallback() {
+		this.ctx = injectValue(this, dialogContext);
+		this.onConnect();
+	}
+	disconnectedCallback() {
+		for (const d of this.disposers) d();
+		this.disposers = [];
+	}
+	reflectState() {
+		this.disposers.push(effect(() => {
+			this.setAttribute("data-state", this.ctx.open() ? "open" : "closed");
+		}));
+	}
+};
+var AihuDialogTrigger = class extends DialogPiece {
+	onConnect() {
+		if (this.tagName !== "BUTTON") {
+			if (!this.hasAttribute("role")) this.setAttribute("role", "button");
+			if (!this.hasAttribute("tabindex")) this.setAttribute("tabindex", "0");
+		}
+		this.setAttribute("aria-haspopup", "dialog");
+		this.addEventListener("click", this._onClick);
+		this.disposers.push(effect(() => {
+			const open = this.ctx.open();
+			this.setAttribute("aria-expanded", String(open));
+			this.setAttribute("aria-controls", this.ctx.contentId());
+		}));
+		this.reflectState();
+	}
+	_onClick = () => {
+		this.ctx.toggle();
+	};
+};
+var AihuDialogContent = class extends DialogPiece {
+	_trap = null;
+	onConnect() {
+		this.setAttribute("role", this.getAttribute("role") ?? "dialog");
+		this.addEventListener("keydown", this._onKeydown);
+		this.disposers.push(effect(() => {
+			const open = this.ctx.open();
+			this.id = this.ctx.contentId();
+			if (this.ctx.modal()) this.setAttribute("aria-modal", "true");
+			const titleId = this.ctx.titleId();
+			if (titleId) this.setAttribute("aria-labelledby", titleId);
+			const descId = this.ctx.descriptionId();
+			if (descId) this.setAttribute("aria-describedby", descId);
+			this.setAttribute("data-state", open ? "open" : "closed");
+			if (open) this._activateTrap();
+			else this._deactivateTrap();
+		}));
+	}
+	disconnectedCallback() {
+		this._deactivateTrap();
+		this.removeEventListener("keydown", this._onKeydown);
+		super.disconnectedCallback();
+	}
+	_activateTrap() {
+		if (this._trap) return;
+		this._trap = createFocusTrap(this);
+		this._trap.activate();
+	}
+	_deactivateTrap() {
+		this._trap?.deactivate();
+		this._trap = null;
+	}
+	_onKeydown = (ev) => {
+		if (ev.key === "Escape" && this.getAttribute("data-dismissable-escape") !== "false") {
+			ev.stopPropagation();
+			this.ctx.close();
+		}
+	};
+};
+var AihuDialogBackdrop = class extends DialogPiece {
+	onConnect() {
+		this.addEventListener("click", this._onClick);
+		this.reflectState();
+	}
+	_onClick = () => {
+		if (this.ctx.modal() && this.getAttribute("data-dismissable-outside") !== "false") this.ctx.close();
+	};
+};
+var AihuDialogClose = class extends DialogPiece {
+	onConnect() {
+		if (this.tagName !== "BUTTON") {
+			if (!this.hasAttribute("role")) this.setAttribute("role", "button");
+			if (!this.hasAttribute("tabindex")) this.setAttribute("tabindex", "0");
+		}
+		this.addEventListener("click", this._onClick);
+		this.reflectState();
+	}
+	_onClick = () => {
+		this.ctx.close();
+	};
+};
+var AihuDialogTitle = class extends DialogPiece {
+	onConnect() {
+		if (!this.id) this.id = uid("dialog-title");
+		this.ctx.setTitleId(this.id);
+	}
+};
+var AihuDialogDescription = class extends DialogPiece {
+	onConnect() {
+		if (!this.id) this.id = uid("dialog-desc");
+		this.ctx.setDescriptionId(this.id);
+	}
+};
+const REGISTRY = [
+	["aihu-dialog-root", AihuDialogRoot],
+	["aihu-dialog-trigger", AihuDialogTrigger],
+	["aihu-dialog-content", AihuDialogContent],
+	["aihu-dialog-backdrop", AihuDialogBackdrop],
+	["aihu-dialog-close", AihuDialogClose],
+	["aihu-dialog-title", AihuDialogTitle],
+	["aihu-dialog-description", AihuDialogDescription]
+];
+let _defined = false;
+/** Register all dialog custom elements (idempotent). */
+function defineDialog() {
+	if (_defined) return;
+	for (const [tag, ctor] of REGISTRY) if (!customElements.get(tag)) customElements.define(tag, ctor);
+	_defined = true;
+}
+//#endregion
+export { AihuDialogRoot as a, defineDialog as c, AihuDialogDescription as i, dialogContext as l, AihuDialogClose as n, AihuDialogTitle as o, AihuDialogContent as r, AihuDialogTrigger as s, AihuDialogBackdrop as t, createFocusTrap as u };
+
+//# sourceMappingURL=dialog-y7MHc6vf.js.map

package/dist/dialog-y7MHc6vf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialog-y7MHc6vf.js","names":[],"sources":["../src/dialog/focus-trap.ts","../src/dialog/index.ts"],"sourcesContent":["/**\n * `createFocusTrap` — a tiny native-DOM focus trap (no library). Queries the\n * focusable descendants of a container, wraps Tab at the edges, moves focus to\n * the first focusable (or the container) on activate, and restores focus to the\n * previously-active element on deactivate. Used by `dialog-content`.\n */\n\nconst FOCUSABLE =\n  'a[href], area[href], button:not([disabled]), input:not([disabled]):not([type=\"hidden\"]), ' +\n  'select:not([disabled]), textarea:not([disabled]), [tabindex]:not([tabindex=\"-1\"]), ' +\n  '[contenteditable=\"true\"], audio[controls], video[controls], details>summary:first-of-type'\n\nexport interface FocusTrap {\n  activate(): void\n  deactivate(): void\n}\n\nfunction focusables(container: Element): HTMLElement[] {\n  return Array.from(container.querySelectorAll<HTMLElement>(FOCUSABLE)).filter(\n    (el) => el.offsetParent !== null || el === document.activeElement || isInJsdom(el),\n  )\n}\n\n/** jsdom does not lay out, so `offsetParent` is always null — treat all as visible there. */\nfunction isInJsdom(_el: HTMLElement): boolean {\n  return typeof navigator !== 'undefined' && navigator.userAgent.includes('jsdom')\n}\n\nexport function createFocusTrap(container: Element): FocusTrap {\n  let previouslyFocused: HTMLElement | null = null\n  let active = false\n\n  const onKeydown = (ev: KeyboardEvent): void => {\n    if (!active || ev.key !== 'Tab') return\n    const items = focusables(container)\n    const first = items[0]\n    const last = items[items.length - 1]\n    if (!first || !last) {\n      ev.preventDefault()\n      return\n    }\n    const current = (container.getRootNode() as Document | ShadowRoot).activeElement as HTMLElement\n\n    if (ev.shiftKey && (current === first || !container.contains(current))) {\n      ev.preventDefault()\n      last.focus()\n    } else if (!ev.shiftKey && (current === last || !container.contains(current))) {\n      ev.preventDefault()\n      first.focus()\n    }\n  }\n\n  return {\n    activate(): void {\n      if (active) return\n      active = true\n      previouslyFocused = document.activeElement as HTMLElement | null\n      const items = focusables(container)\n      const target = items[0] ?? (container as HTMLElement)\n      // Ensure the container itself is focusable as a fallback.\n      if (!items.length && !(container as HTMLElement).hasAttribute('tabindex')) {\n        ;(container as HTMLElement).setAttribute('tabindex', '-1')\n      }\n      target.focus()\n      document.addEventListener('keydown', onKeydown, true)\n    },\n    deactivate(): void {\n      if (!active) return\n      active = false\n      document.removeEventListener('keydown', onKeydown, true)\n      // Return focus to whatever opened the trap.\n      previouslyFocused?.focus?.()\n      previouslyFocused = null\n    },\n  }\n}\n","/**\n * Headless dialog — `<aihu-dialog-root>` (state owner) + pieces\n * `<aihu-dialog-trigger>`, `<aihu-dialog-content>`, `<aihu-dialog-backdrop>`,\n * `<aihu-dialog-close>`, `<aihu-dialog-title>`, `<aihu-dialog-description>`.\n * Implements the WAI-ARIA APG **Dialog (Modal)** pattern: focus-trap +\n * return-focus, Escape-to-close, `role=dialog` / `aria-modal` /\n * `aria-labelledby` / `aria-describedby`, trigger `aria-haspopup` /\n * `aria-expanded` / `aria-controls`. Emits NO CSS — every piece reflects\n * `data-state=\"open\"|\"closed\"` for the consumer to style.\n */\n\nimport { effect, type Read, signal } from '@aihu/signals'\nimport { createDomContext, injectValue, provideContext } from '../dom-context.ts'\nimport { createFocusTrap, type FocusTrap } from './focus-trap.ts'\n\nexport interface DialogContextValue {\n  readonly open: Read<boolean>\n  readonly modal: Read<boolean>\n  readonly contentId: Read<string>\n  readonly titleId: Read<string | null>\n  readonly descriptionId: Read<string | null>\n  setTitleId(id: string): void\n  setDescriptionId(id: string): void\n  setOpen(next: boolean): void\n  close(): void\n  toggle(): void\n}\n\nexport const dialogContext = createDomContext<DialogContextValue>('dialog')\n\nlet _idSeq = 0\nconst uid = (p: string): string => `aihu-${p}-${(_idSeq += 1)}`\n\nexport class AihuDialogRoot extends HTMLElement {\n  static readonly observedAttributes = ['open', 'modal']\n\n  private readonly _open = signal(false)\n  private readonly _modal = signal(true)\n  private readonly _contentId = signal(uid('dialog'))\n  private readonly _titleId = signal<string | null>(null)\n  private readonly _descriptionId = signal<string | null>(null)\n  private _disposers: Array<() => void> = []\n  private _ctx: DialogContextValue\n\n  constructor() {\n    super()\n    this._ctx = {\n      open: this._open[0],\n      modal: this._modal[0],\n      contentId: this._contentId[0],\n      titleId: this._titleId[0],\n      descriptionId: this._descriptionId[0],\n      setTitleId: (id) => this._titleId[1](id),\n      setDescriptionId: (id) => this._descriptionId[1](id),\n      setOpen: (next) => this.setOpen(next),\n      close: () => this.setOpen(false),\n      toggle: () => this.setOpen(!this._open[0]()),\n    }\n    provideContext(this, dialogContext, this._ctx)\n  }\n\n  get open(): Read<boolean> {\n    return this._open[0]\n  }\n\n  setOpen(next: boolean): void {\n    if (next === this._open[0]()) return\n    this._open[1](next)\n    if (next) this.setAttribute('open', '')\n    else this.removeAttribute('open')\n  }\n\n  connectedCallback(): void {\n    if (this.hasAttribute('modal')) this._modal[1](this.getAttribute('modal') !== 'false')\n    this._open[1](this.hasAttribute('open'))\n    this._disposers.push(\n      effect(() => {\n        this.setAttribute('data-state', this._open[0]() ? 'open' : 'closed')\n      }),\n    )\n  }\n\n  disconnectedCallback(): void {\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 === 'open') this._open[1](value !== null)\n    if (name === 'modal') this._modal[1](value !== 'false')\n  }\n}\n\n/** Base for pieces that inject the dialog context lazily on connect. */\nabstract class DialogPiece extends HTMLElement {\n  protected ctx!: DialogContextValue\n  protected disposers: Array<() => void> = []\n\n  connectedCallback(): void {\n    this.ctx = injectValue(this, dialogContext)\n    this.onConnect()\n  }\n\n  disconnectedCallback(): void {\n    for (const d of this.disposers) d()\n    this.disposers = []\n  }\n\n  protected reflectState(): void {\n    this.disposers.push(\n      effect(() => {\n        this.setAttribute('data-state', this.ctx.open() ? 'open' : 'closed')\n      }),\n    )\n  }\n\n  protected abstract onConnect(): void\n}\n\nexport class AihuDialogTrigger extends DialogPiece {\n  protected onConnect(): void {\n    if (this.tagName !== 'BUTTON') {\n      if (!this.hasAttribute('role')) this.setAttribute('role', 'button')\n      if (!this.hasAttribute('tabindex')) this.setAttribute('tabindex', '0')\n    }\n    this.setAttribute('aria-haspopup', 'dialog')\n    this.addEventListener('click', this._onClick)\n    this.disposers.push(\n      effect(() => {\n        const open = this.ctx.open()\n        this.setAttribute('aria-expanded', String(open))\n        this.setAttribute('aria-controls', this.ctx.contentId())\n      }),\n    )\n    this.reflectState()\n  }\n\n  private readonly _onClick = (): void => {\n    this.ctx.toggle()\n  }\n}\n\nexport class AihuDialogContent extends DialogPiece {\n  private _trap: FocusTrap | null = null\n\n  protected onConnect(): void {\n    this.setAttribute('role', this.getAttribute('role') ?? 'dialog')\n    this.addEventListener('keydown', this._onKeydown)\n    this.disposers.push(\n      effect(() => {\n        const open = this.ctx.open()\n        this.id = this.ctx.contentId()\n        if (this.ctx.modal()) this.setAttribute('aria-modal', 'true')\n        const titleId = this.ctx.titleId()\n        if (titleId) this.setAttribute('aria-labelledby', titleId)\n        const descId = this.ctx.descriptionId()\n        if (descId) this.setAttribute('aria-describedby', descId)\n        this.setAttribute('data-state', open ? 'open' : 'closed')\n        if (open) this._activateTrap()\n        else this._deactivateTrap()\n      }),\n    )\n  }\n\n  override disconnectedCallback(): void {\n    this._deactivateTrap()\n    this.removeEventListener('keydown', this._onKeydown)\n    super.disconnectedCallback()\n  }\n\n  private _activateTrap(): void {\n    if (this._trap) return\n    this._trap = createFocusTrap(this)\n    this._trap.activate()\n  }\n\n  private _deactivateTrap(): void {\n    this._trap?.deactivate()\n    this._trap = null\n  }\n\n  private readonly _onKeydown = (ev: KeyboardEvent): void => {\n    if (ev.key === 'Escape' && this.getAttribute('data-dismissable-escape') !== 'false') {\n      ev.stopPropagation()\n      this.ctx.close()\n    }\n  }\n}\n\nexport class AihuDialogBackdrop extends DialogPiece {\n  protected onConnect(): void {\n    this.addEventListener('click', this._onClick)\n    this.reflectState()\n  }\n\n  private readonly _onClick = (): void => {\n    if (this.ctx.modal() && this.getAttribute('data-dismissable-outside') !== 'false') {\n      this.ctx.close()\n    }\n  }\n}\n\nexport class AihuDialogClose extends DialogPiece {\n  protected onConnect(): void {\n    if (this.tagName !== 'BUTTON') {\n      if (!this.hasAttribute('role')) this.setAttribute('role', 'button')\n      if (!this.hasAttribute('tabindex')) this.setAttribute('tabindex', '0')\n    }\n    this.addEventListener('click', this._onClick)\n    this.reflectState()\n  }\n\n  private readonly _onClick = (): void => {\n    this.ctx.close()\n  }\n}\n\nexport class AihuDialogTitle extends DialogPiece {\n  protected onConnect(): void {\n    if (!this.id) this.id = uid('dialog-title')\n    this.ctx.setTitleId(this.id)\n  }\n}\n\nexport class AihuDialogDescription extends DialogPiece {\n  protected onConnect(): void {\n    if (!this.id) this.id = uid('dialog-desc')\n    this.ctx.setDescriptionId(this.id)\n  }\n}\n\nconst REGISTRY: Array<[string, CustomElementConstructor]> = [\n  ['aihu-dialog-root', AihuDialogRoot],\n  ['aihu-dialog-trigger', AihuDialogTrigger],\n  ['aihu-dialog-content', AihuDialogContent],\n  ['aihu-dialog-backdrop', AihuDialogBackdrop],\n  ['aihu-dialog-close', AihuDialogClose],\n  ['aihu-dialog-title', AihuDialogTitle],\n  ['aihu-dialog-description', AihuDialogDescription],\n]\n\nlet _defined = false\n/** Register all dialog custom elements (idempotent). */\nexport function defineDialog(): void {\n  if (_defined) return\n  for (const [tag, ctor] of REGISTRY) {\n    if (!customElements.get(tag)) customElements.define(tag, ctor)\n  }\n  _defined = true\n}\n\nexport { createFocusTrap, type FocusTrap } from './focus-trap.ts'\n"],"mappings":"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"}

package/dist/dialog.d.ts

@@ -0,0 +1,2 @@
+import { a as AihuDialogRoot, c as DialogContextValue, d as FocusTrap, f as createFocusTrap, i as AihuDialogDescription, l as defineDialog, n as AihuDialogClose, o as AihuDialogTitle, r as AihuDialogContent, s as AihuDialogTrigger, t as AihuDialogBackdrop, u as dialogContext } from "./index-D9kf9rVU.js";
+export { AihuDialogBackdrop, AihuDialogClose, AihuDialogContent, AihuDialogDescription, AihuDialogRoot, AihuDialogTitle, AihuDialogTrigger, DialogContextValue, FocusTrap, createFocusTrap, defineDialog, dialogContext };

package/dist/dialog.js

@@ -0,0 +1,2 @@
+import { a as AihuDialogRoot, c as defineDialog, i as AihuDialogDescription, l as dialogContext, n as AihuDialogClose, o as AihuDialogTitle, r as AihuDialogContent, s as AihuDialogTrigger, t as AihuDialogBackdrop, u as createFocusTrap } from "./dialog-y7MHc6vf.js";
+export { AihuDialogBackdrop, AihuDialogClose, AihuDialogContent, AihuDialogDescription, AihuDialogRoot, AihuDialogTitle, AihuDialogTrigger, createFocusTrap, defineDialog, dialogContext };

package/dist/dom-context.d.ts

@@ -0,0 +1,40 @@
+import { Read } from "@aihu/signals";
+
+//#region src/dom-context.d.ts
+/**
+ * Opaque token identifying a context slot. `_key` is the Symbol used in the
+ * per-host registry; `_name` aids debugging + the throw-on-missing message.
+ */
+interface DomContext<T> {
+  readonly _key: symbol;
+  readonly _name: string;
+  readonly _default: T | undefined;
+}
+/** Thrown by `injectContext` when no provider is found and the token has no default. */
+declare class MissingContextError extends Error {
+  constructor(name: string);
+}
+/** Create a context token. Optionally carry a default for `injectContext`. */
+declare function createDomContext<T>(name: string, defaultValue?: T): DomContext<T>;
+/**
+ * Provide `value` for `ctx` on `host`. Idempotent per `(host, ctx._key)` —
+ * re-providing overwrites. `value` may be a raw `T` or a signal `Read<T>`.
+ */
+declare function provideContext<T>(host: Element, ctx: DomContext<T>, value: T | Read<T>): void;
+/**
+ * Resolve `ctx` for `from` by walking UP the DOM from `from.parentNode`,
+ * crossing `ShadowRoot` boundaries (`ShadowRoot → .host`), nearest-wins.
+ * Returns the first match; falls back to `ctx._default`; throws
+ * `MissingContextError` if neither is present.
+ */
+declare function injectContext<T>(from: Element, ctx: DomContext<T>): T | Read<T>;
+/**
+ * Like `injectContext`, but for the common case where a context carries a raw
+ * (non-signal) value — typically an object whose fields are themselves signals.
+ * Narrows the `T | Read<T>` union to `T` so call sites read fields directly.
+ * Use `injectContext` when a provider may store a bare `Read<T>` signal.
+ */
+declare function injectValue<T>(from: Element, ctx: DomContext<T>): T;
+//#endregion
+export { DomContext, MissingContextError, createDomContext, injectContext, injectValue, provideContext };
+//# sourceMappingURL=dom-context.d.ts.map

package/dist/dom-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom-context.d.ts","names":[],"sources":["../src/dom-context.ts"],"mappings":";;;;AAoDA;;;UAxBiB,UAAA;EAAA,SACN,IAAA;EAAA,SACA,KAAA;EAAA,SACA,QAAA,EAAU,CAAA;AAAA;;cAIR,mBAAA,SAA4B,KAAA;cAC3B,IAAA;AAAA;;iBAgBE,gBAAA,GAAA,CAAoB,IAAA,UAAc,YAAA,GAAe,CAAA,GAAI,UAAA,CAAW,CAAA;;;AAQhF;;iBAAgB,cAAA,GAAA,CAAkB,IAAA,EAAM,OAAA,EAAS,GAAA,EAAK,UAAA,CAAW,CAAA,GAAI,KAAA,EAAO,CAAA,GAAI,IAAA,CAAK,CAAA;;;;;;;iBAerE,aAAA,GAAA,CAAiB,IAAA,EAAM,OAAA,EAAS,GAAA,EAAK,UAAA,CAAW,CAAA,IAAK,CAAA,GAAI,IAAA,CAAK,CAAA;;;;;;;iBA2B9D,WAAA,GAAA,CAAe,IAAA,EAAM,OAAA,EAAS,GAAA,EAAK,UAAA,CAAW,CAAA,IAAK,CAAA"}

package/dist/dom-context.js

@@ -0,0 +1,64 @@
+//#region src/dom-context.ts
+/** Thrown by `injectContext` when no provider is found and the token has no default. */
+var MissingContextError = class extends Error {
+	constructor(name) {
+		super(`[@aihu/primitives] no provider found for context "${name}" (and it has no default value)`);
+		this.name = "MissingContextError";
+	}
+};
+/**
+* Module-level registry mapping a host element to its provided context values.
+* A `WeakMap` so entries auto-release when the host element is GC'd — no manual
+* teardown, and values can be non-serializable (e.g. signals).
+*/
+const REGISTRY = /* @__PURE__ */ new WeakMap();
+/** Create a context token. Optionally carry a default for `injectContext`. */
+function createDomContext(name, defaultValue) {
+	return {
+		_key: Symbol(name),
+		_name: name,
+		_default: defaultValue
+	};
+}
+/**
+* Provide `value` for `ctx` on `host`. Idempotent per `(host, ctx._key)` —
+* re-providing overwrites. `value` may be a raw `T` or a signal `Read<T>`.
+*/
+function provideContext(host, ctx, value) {
+	let slots = REGISTRY.get(host);
+	if (slots === void 0) {
+		slots = /* @__PURE__ */ new Map();
+		REGISTRY.set(host, slots);
+	}
+	slots.set(ctx._key, value);
+}
+/**
+* Resolve `ctx` for `from` by walking UP the DOM from `from.parentNode`,
+* crossing `ShadowRoot` boundaries (`ShadowRoot → .host`), nearest-wins.
+* Returns the first match; falls back to `ctx._default`; throws
+* `MissingContextError` if neither is present.
+*/
+function injectContext(from, ctx) {
+	let node = from.parentNode;
+	while (node !== null) if (node instanceof Element) {
+		const slots = REGISTRY.get(node);
+		if (slots?.has(ctx._key)) return slots.get(ctx._key);
+		node = node.parentNode;
+	} else if (node instanceof ShadowRoot) node = node.host;
+	else node = node.parentNode;
+	if (ctx._default !== void 0) return ctx._default;
+	throw new MissingContextError(ctx._name);
+}
+/**
+* Like `injectContext`, but for the common case where a context carries a raw
+* (non-signal) value — typically an object whose fields are themselves signals.
+* Narrows the `T | Read<T>` union to `T` so call sites read fields directly.
+* Use `injectContext` when a provider may store a bare `Read<T>` signal.
+*/
+function injectValue(from, ctx) {
+	return injectContext(from, ctx);
+}
+//#endregion
+export { MissingContextError, createDomContext, injectContext, injectValue, provideContext };
+
+//# sourceMappingURL=dom-context.js.map

package/dist/dom-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom-context.js","names":[],"sources":["../src/dom-context.ts"],"sourcesContent":["/**\n * `@aihu/primitives/context` — self-contained DOM-walk context (Option C).\n *\n * A live ancestor-traversal context: a provider stamps a value onto a host\n * element; an injecting descendant resolves it by walking UP the real DOM tree\n * (crossing `ShadowRoot` boundaries), nearest-provider-wins. This is the\n * Radix/Ark root↔piece coordination mechanism — fundamentally different from\n * `@aihu/context`'s DOM-free, SSR-oriented module-level Map.\n *\n * Deliberately distinct vocabulary (`createDomContext` / `provideContext` /\n * `injectContext`, NOT `createContext`) so there is no colliding symbol with\n * `@aihu/context`. **This module does NOT import `@aihu/context`.**\n *\n * Signal composition: the stored value may be a raw `T` or a signal `Read<T>`.\n * The convention is \"provide a `Read<T>` when you want descendants to react\" —\n * a consuming primitive reads the injected `Read<T>` inside an `effect(...)`\n * so it re-runs when the provider updates (e.g. `config-provider` propagating\n * `colorScheme` to every descendant). The util itself is signal-agnostic: it\n * stores whatever is passed and only imports the `Read<T>` *type* — keeping\n * `dom-context.js` under its 1 KB row.\n */\n\nimport type { Read } from '@aihu/signals'\n\n/**\n * Opaque token identifying a context slot. `_key` is the Symbol used in the\n * per-host registry; `_name` aids debugging + the throw-on-missing message.\n */\nexport interface DomContext<T> {\n  readonly _key: symbol\n  readonly _name: string\n  readonly _default: T | undefined\n}\n\n/** Thrown by `injectContext` when no provider is found and the token has no default. */\nexport class MissingContextError extends Error {\n  constructor(name: string) {\n    super(\n      `[@aihu/primitives] no provider found for context \"${name}\" (and it has no default value)`,\n    )\n    this.name = 'MissingContextError'\n  }\n}\n\n/**\n * Module-level registry mapping a host element to its provided context values.\n * A `WeakMap` so entries auto-release when the host element is GC'd — no manual\n * teardown, and values can be non-serializable (e.g. signals).\n */\nconst REGISTRY: WeakMap<Element, Map<symbol, unknown>> = new WeakMap()\n\n/** Create a context token. Optionally carry a default for `injectContext`. */\nexport function createDomContext<T>(name: string, defaultValue?: T): DomContext<T> {\n  return { _key: Symbol(name), _name: name, _default: defaultValue }\n}\n\n/**\n * Provide `value` for `ctx` on `host`. Idempotent per `(host, ctx._key)` —\n * re-providing overwrites. `value` may be a raw `T` or a signal `Read<T>`.\n */\nexport function provideContext<T>(host: Element, ctx: DomContext<T>, value: T | Read<T>): void {\n  let slots = REGISTRY.get(host)\n  if (slots === undefined) {\n    slots = new Map<symbol, unknown>()\n    REGISTRY.set(host, slots)\n  }\n  slots.set(ctx._key, value)\n}\n\n/**\n * Resolve `ctx` for `from` by walking UP the DOM from `from.parentNode`,\n * crossing `ShadowRoot` boundaries (`ShadowRoot → .host`), nearest-wins.\n * Returns the first match; falls back to `ctx._default`; throws\n * `MissingContextError` if neither is present.\n */\nexport function injectContext<T>(from: Element, ctx: DomContext<T>): T | Read<T> {\n  let node: Node | null = from.parentNode\n  while (node !== null) {\n    if (node instanceof Element) {\n      const slots = REGISTRY.get(node)\n      if (slots?.has(ctx._key)) {\n        return slots.get(ctx._key) as T | Read<T>\n      }\n      node = node.parentNode\n    } else if (node instanceof ShadowRoot) {\n      // Step out of the shadow tree to the host element, then continue up.\n      node = node.host\n    } else {\n      // Document / DocumentFragment (non-shadow) — keep walking up.\n      node = node.parentNode\n    }\n  }\n  if (ctx._default !== undefined) return ctx._default\n  throw new MissingContextError(ctx._name)\n}\n\n/**\n * Like `injectContext`, but for the common case where a context carries a raw\n * (non-signal) value — typically an object whose fields are themselves signals.\n * Narrows the `T | Read<T>` union to `T` so call sites read fields directly.\n * Use `injectContext` when a provider may store a bare `Read<T>` signal.\n */\nexport function injectValue<T>(from: Element, ctx: DomContext<T>): T {\n  return injectContext(from, ctx) as T\n}\n"],"mappings":";;AAmCA,IAAa,sBAAb,cAAyC,MAAM;CAC7C,YAAY,MAAc;EACxB,MACE,qDAAqD,KAAK,iCAC3D;EACD,KAAK,OAAO;;;;;;;;AAShB,MAAM,2BAAmD,IAAI,SAAS;;AAGtE,SAAgB,iBAAoB,MAAc,cAAiC;CACjF,OAAO;EAAE,MAAM,OAAO,KAAK;EAAE,OAAO;EAAM,UAAU;EAAc;;;;;;AAOpE,SAAgB,eAAkB,MAAe,KAAoB,OAA0B;CAC7F,IAAI,QAAQ,SAAS,IAAI,KAAK;CAC9B,IAAI,UAAU,KAAA,GAAW;EACvB,wBAAQ,IAAI,KAAsB;EAClC,SAAS,IAAI,MAAM,MAAM;;CAE3B,MAAM,IAAI,IAAI,MAAM,MAAM;;;;;;;;AAS5B,SAAgB,cAAiB,MAAe,KAAiC;CAC/E,IAAI,OAAoB,KAAK;CAC7B,OAAO,SAAS,MACd,IAAI,gBAAgB,SAAS;EAC3B,MAAM,QAAQ,SAAS,IAAI,KAAK;EAChC,IAAI,OAAO,IAAI,IAAI,KAAK,EACtB,OAAO,MAAM,IAAI,IAAI,KAAK;EAE5B,OAAO,KAAK;QACP,IAAI,gBAAgB,YAEzB,OAAO,KAAK;MAGZ,OAAO,KAAK;CAGhB,IAAI,IAAI,aAAa,KAAA,GAAW,OAAO,IAAI;CAC3C,MAAM,IAAI,oBAAoB,IAAI,MAAM;;;;;;;;AAS1C,SAAgB,YAAe,MAAe,KAAuB;CACnE,OAAO,cAAc,MAAM,IAAI"}

package/dist/form-control.d.ts

@@ -0,0 +1,41 @@
+import { DomContext } from "./dom-context.js";
+import { Read } from "@aihu/signals";
+
+//#region src/form-control/index.d.ts
+interface FormControlContextValue {
+  readonly disabled: Read<boolean>;
+  readonly required: Read<boolean>;
+  readonly invalid: Read<boolean>;
+  readonly controlId: Read<string>;
+  readonly describedById: Read<string | null>;
+}
+declare const formControlContext: DomContext<FormControlContextValue>;
+declare class AihuFormControl extends HTMLElement {
+  static readonly observedAttributes: string[];
+  private readonly _disabled;
+  private readonly _required;
+  private readonly _invalid;
+  private readonly _controlId;
+  private readonly _describedById;
+  private _disposers;
+  get disabled(): Read<boolean>;
+  get required(): Read<boolean>;
+  get invalid(): Read<boolean>;
+  get controlId(): Read<string>;
+  constructor();
+  connectedCallback(): void;
+  disconnectedCallback(): void;
+  attributeChangedCallback(name: string, _old: string | null, value: string | null): void;
+  /** Re-derive `aria-describedby` from the slotted description/error pieces.
+   * Call after a piece mounts/unmounts. */
+  recomputeDescribedBy(): void;
+  private _syncBooleans;
+  /** The slotted control element (input/select/textarea/[data-fc-control]). */
+  private _control;
+  private _wireAssociations;
+}
+/** Register `<aihu-form-control>` (idempotent). */
+declare function defineFormControl(tag?: string): void;
+//#endregion
+export { AihuFormControl, FormControlContextValue, defineFormControl, formControlContext };
+//# sourceMappingURL=form-control.d.ts.map

package/dist/form-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-control.d.ts","names":[],"sources":["../src/form-control/index.ts"],"mappings":";;;;UAqBiB,uBAAA;EAAA,SACN,QAAA,EAAU,IAAA;EAAA,SACV,QAAA,EAAU,IAAA;EAAA,SACV,OAAA,EAAS,IAAA;EAAA,SACT,SAAA,EAAW,IAAA;EAAA,SACX,aAAA,EAAe,IAAA;AAAA;AAAA,cAGb,kBAAA,EAAkB,UAAA,CAAA,uBAAA;AAAA,cAQlB,eAAA,SAAwB,WAAA;EAAA,gBACnB,kBAAA;EAAA,iBAEC,SAAA;EAAA,iBACA,SAAA;EAAA,iBACA,QAAA;EAAA,iBACA,UAAA;EAAA,iBACA,cAAA;EAAA,QAET,UAAA;EAAA,IAEJ,QAAA,CAAA,GAAY,IAAA;EAAA,IAGZ,QAAA,CAAA,GAAY,IAAA;EAAA,IAGZ,OAAA,CAAA,GAAW,IAAA;EAAA,IAGX,SAAA,CAAA,GAAa,IAAA;;EAejB,iBAAA,CAAA;EAuBA,oBAAA,CAAA;EAKA,wBAAA,CAAyB,IAAA,UAAc,IAAA,iBAAqB,KAAA;EA9D5C;;EAiFhB,oBAAA,CAAA;EAAA,QAIQ,aAAA;EAhFS;EAAA,QAuFT,QAAA;EAAA,QAMA,iBAAA;AAAA;;iBA+BM,iBAAA,CAAkB,GAAA"}

package/dist/form-control.js

@@ -0,0 +1,145 @@
+import { createDomContext, provideContext } from "./dom-context.js";
+import { effect, signal } from "@aihu/signals";
+//#region src/form-control/index.ts
+/**
+* `<aihu-form-control>` — headless form-field coordinator. Owns the
+* disabled/required/invalid state for a field and wires the ARIA association
+* between a slotted control, its label, and its error/description text. Emits
+* NO CSS.
+*
+* Reflected attributes: `disabled`, `required`, `invalid` (boolean); `name`,
+* `control-id` (string).
+* Owned signals: `disabled`, `required`, `invalid`.
+* ARIA emitted onto the slotted control: `aria-required`, `aria-invalid`,
+* `aria-disabled`, `aria-describedby` (wired to a slotted `[data-fc-description]`
+* / `[data-fc-error]` element's id); a slotted `<label>` is associated via
+* `for`/`id`.
+* Context: provides `formControlContext` carrying
+* `{ disabled, required, invalid, controlId, describedById }` signals so
+* descendant pieces consume the shared state without prop-drilling.
+*/
+const formControlContext = createDomContext("form-control");
+let _idCounter = 0;
+function nextId() {
+	_idCounter += 1;
+	return `aihu-fc-${_idCounter}`;
+}
+var AihuFormControl = class extends HTMLElement {
+	static observedAttributes = [
+		"disabled",
+		"required",
+		"invalid",
+		"name",
+		"control-id"
+	];
+	_disabled = signal(false);
+	_required = signal(false);
+	_invalid = signal(false);
+	_controlId = signal("");
+	_describedById = signal(null);
+	_disposers = [];
+	get disabled() {
+		return this._disabled[0];
+	}
+	get required() {
+		return this._required[0];
+	}
+	get invalid() {
+		return this._invalid[0];
+	}
+	get controlId() {
+		return this._controlId[0];
+	}
+	constructor() {
+		super();
+		provideContext(this, formControlContext, {
+			disabled: this._disabled[0],
+			required: this._required[0],
+			invalid: this._invalid[0],
+			controlId: this._controlId[0],
+			describedById: this._describedById[0]
+		});
+	}
+	connectedCallback() {
+		const supplied = this.getAttribute("control-id");
+		this._controlId[1](supplied ?? nextId());
+		this._syncBooleans();
+		this._wireAssociations();
+		this._disposers.push(effect(() => {
+			const control = this._control();
+			if (!control) return;
+			reflectAria(control, "aria-disabled", this._disabled[0]());
+			reflectAria(control, "aria-required", this._required[0]());
+			reflectAria(control, "aria-invalid", this._invalid[0]());
+			const describedBy = this._describedById[0]();
+			if (describedBy) control.setAttribute("aria-describedby", describedBy);
+			else control.removeAttribute("aria-describedby");
+		}));
+	}
+	disconnectedCallback() {
+		for (const d of this._disposers) d();
+		this._disposers = [];
+	}
+	attributeChangedCallback(name, _old, value) {
+		switch (name) {
+			case "disabled":
+				this._disabled[1](value !== null);
+				break;
+			case "required":
+				this._required[1](value !== null);
+				break;
+			case "invalid":
+				this._invalid[1](value !== null);
+				break;
+			case "control-id":
+				if (value) this._controlId[1](value);
+				break;
+		}
+	}
+	/** Re-derive `aria-describedby` from the slotted description/error pieces.
+	* Call after a piece mounts/unmounts. */
+	recomputeDescribedBy() {
+		this._wireAssociations();
+	}
+	_syncBooleans() {
+		this._disabled[1](this.hasAttribute("disabled"));
+		this._required[1](this.hasAttribute("required"));
+		this._invalid[1](this.hasAttribute("invalid"));
+	}
+	/** The slotted control element (input/select/textarea/[data-fc-control]). */
+	_control() {
+		return this.querySelector("[data-fc-control], input, select, textarea, [role=\"textbox\"]");
+	}
+	_wireAssociations() {
+		const control = this._control();
+		if (control) if (!control.id) control.id = this._controlId[0]();
+		else this._controlId[1](control.id);
+		const label = this.querySelector("label, [data-fc-label]");
+		if (label && control) if (label instanceof HTMLLabelElement) label.htmlFor = control.id;
+		else label.setAttribute("for", control.id);
+		const described = [];
+		for (const el of this.querySelectorAll("[data-fc-description], [data-fc-error]")) {
+			if (!el.id) el.id = nextId();
+			described.push(el.id);
+		}
+		this._describedById[1](described.length ? described.join(" ") : null);
+	}
+};
+function reflectAria(el, attr, on) {
+	if (on) el.setAttribute(attr, "true");
+	else el.removeAttribute(attr);
+}
+let _defined = false;
+/** Register `<aihu-form-control>` (idempotent). */
+function defineFormControl(tag = "aihu-form-control") {
+	if (_defined || customElements.get(tag)) {
+		_defined = true;
+		return;
+	}
+	customElements.define(tag, AihuFormControl);
+	_defined = true;
+}
+//#endregion
+export { AihuFormControl, defineFormControl, formControlContext };
+
+//# sourceMappingURL=form-control.js.map

package/dist/form-control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-control.js","names":[],"sources":["../src/form-control/index.ts"],"sourcesContent":["/**\n * `<aihu-form-control>` — headless form-field coordinator. Owns the\n * disabled/required/invalid state for a field and wires the ARIA association\n * between a slotted control, its label, and its error/description text. Emits\n * NO CSS.\n *\n * Reflected attributes: `disabled`, `required`, `invalid` (boolean); `name`,\n * `control-id` (string).\n * Owned signals: `disabled`, `required`, `invalid`.\n * ARIA emitted onto the slotted control: `aria-required`, `aria-invalid`,\n * `aria-disabled`, `aria-describedby` (wired to a slotted `[data-fc-description]`\n * / `[data-fc-error]` element's id); a slotted `<label>` is associated via\n * `for`/`id`.\n * Context: provides `formControlContext` carrying\n * `{ disabled, required, invalid, controlId, describedById }` signals so\n * descendant pieces consume the shared state without prop-drilling.\n */\n\nimport { effect, type Read, signal } from '@aihu/signals'\nimport { createDomContext, provideContext } from '../dom-context.ts'\n\nexport interface FormControlContextValue {\n  readonly disabled: Read<boolean>\n  readonly required: Read<boolean>\n  readonly invalid: Read<boolean>\n  readonly controlId: Read<string>\n  readonly describedById: Read<string | null>\n}\n\nexport const formControlContext = createDomContext<FormControlContextValue>('form-control')\n\nlet _idCounter = 0\nfunction nextId(): string {\n  _idCounter += 1\n  return `aihu-fc-${_idCounter}`\n}\n\nexport class AihuFormControl extends HTMLElement {\n  static readonly observedAttributes = ['disabled', 'required', 'invalid', 'name', 'control-id']\n\n  private readonly _disabled = signal(false)\n  private readonly _required = signal(false)\n  private readonly _invalid = signal(false)\n  private readonly _controlId = signal('')\n  private readonly _describedById = signal<string | null>(null)\n\n  private _disposers: Array<() => void> = []\n\n  get disabled(): Read<boolean> {\n    return this._disabled[0]\n  }\n  get required(): Read<boolean> {\n    return this._required[0]\n  }\n  get invalid(): Read<boolean> {\n    return this._invalid[0]\n  }\n  get controlId(): Read<string> {\n    return this._controlId[0]\n  }\n\n  constructor() {\n    super()\n    provideContext(this, formControlContext, {\n      disabled: this._disabled[0],\n      required: this._required[0],\n      invalid: this._invalid[0],\n      controlId: this._controlId[0],\n      describedById: this._describedById[0],\n    })\n  }\n\n  connectedCallback(): void {\n    // Stable control id (generated if not supplied).\n    const supplied = this.getAttribute('control-id')\n    this._controlId[1](supplied ?? nextId())\n\n    this._syncBooleans()\n    this._wireAssociations()\n\n    // Reflect ARIA onto the slotted control reactively.\n    this._disposers.push(\n      effect(() => {\n        const control = this._control()\n        if (!control) return\n        reflectAria(control, 'aria-disabled', this._disabled[0]())\n        reflectAria(control, 'aria-required', this._required[0]())\n        reflectAria(control, 'aria-invalid', this._invalid[0]())\n        const describedBy = this._describedById[0]()\n        if (describedBy) control.setAttribute('aria-describedby', describedBy)\n        else control.removeAttribute('aria-describedby')\n      }),\n    )\n  }\n\n  disconnectedCallback(): void {\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    switch (name) {\n      case 'disabled':\n        this._disabled[1](value !== null)\n        break\n      case 'required':\n        this._required[1](value !== null)\n        break\n      case 'invalid':\n        this._invalid[1](value !== null)\n        break\n      case 'control-id':\n        if (value) this._controlId[1](value)\n        break\n    }\n  }\n\n  /** Re-derive `aria-describedby` from the slotted description/error pieces.\n   * Call after a piece mounts/unmounts. */\n  recomputeDescribedBy(): void {\n    this._wireAssociations()\n  }\n\n  private _syncBooleans(): void {\n    this._disabled[1](this.hasAttribute('disabled'))\n    this._required[1](this.hasAttribute('required'))\n    this._invalid[1](this.hasAttribute('invalid'))\n  }\n\n  /** The slotted control element (input/select/textarea/[data-fc-control]). */\n  private _control(): HTMLElement | null {\n    return this.querySelector<HTMLElement>(\n      '[data-fc-control], input, select, textarea, [role=\"textbox\"]',\n    )\n  }\n\n  private _wireAssociations(): void {\n    const control = this._control()\n    if (control) {\n      if (!control.id) control.id = this._controlId[0]()\n      else this._controlId[1](control.id)\n    }\n\n    // Associate a slotted label.\n    const label = this.querySelector<HTMLElement>('label, [data-fc-label]')\n    if (label && control) {\n      if (label instanceof HTMLLabelElement) label.htmlFor = control.id\n      else label.setAttribute('for', control.id)\n    }\n\n    // Collect description + error ids into aria-describedby.\n    const described: string[] = []\n    for (const el of this.querySelectorAll<HTMLElement>('[data-fc-description], [data-fc-error]')) {\n      if (!el.id) el.id = nextId()\n      described.push(el.id)\n    }\n    this._describedById[1](described.length ? described.join(' ') : null)\n  }\n}\n\nfunction reflectAria(el: HTMLElement, attr: string, on: boolean): void {\n  if (on) el.setAttribute(attr, 'true')\n  else el.removeAttribute(attr)\n}\n\nlet _defined = false\n/** Register `<aihu-form-control>` (idempotent). */\nexport function defineFormControl(tag = 'aihu-form-control'): void {\n  if (_defined || customElements.get(tag)) {\n    _defined = true\n    return\n  }\n  customElements.define(tag, AihuFormControl)\n  _defined = true\n}\n"],"mappings":"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"}