@vastare/fundatio 0.1.0

package/dist/esm/chunks/index95.js

@@ -0,0 +1,53 @@
+import { c as w } from "./dom.js";
+const g = "textarea", N = "textarea";
+function O(r) {
+  if (!r) return;
+  const {
+    aria: t,
+    name: u,
+    form: d,
+    disabled: h,
+    required: x,
+    readOnly: T,
+    cols: o,
+    rows: f,
+    minLength: s,
+    maxLength: l,
+    placeholder: p,
+    autoComplete: c,
+    autoFocus: A,
+    autoCapitalize: m,
+    dirName: b,
+    wrap: n,
+    ...E
+  } = r, i = { ...E }, e = { ...i.attrs ?? {} };
+  if (typeof u == "string" && (e.name = u), typeof d == "string" && (e.form = d), h === !0 && (e.disabled = !0), x === !0 && (e.required = !0), T === !0 && (e.readonly = !0), typeof o == "number" && Number.isFinite(o) && (e.cols = o), typeof f == "number" && Number.isFinite(f) && (e.rows = f), typeof s == "number" && Number.isFinite(s) && (e.minlength = s), typeof l == "number" && Number.isFinite(l) && (e.maxlength = l), typeof p == "string" && (e.placeholder = p), typeof c == "string" && (e.autocomplete = c), A === !0 && (e.autofocus = !0), typeof m == "string" && (e.autocapitalize = m), typeof b == "string") {
+    const y = b.trim();
+    if (y.length === 0)
+      throw new Error("textarea dirName must not be an empty string.");
+    e.dirname = y;
+  }
+  if ((n === "soft" || n === "hard") && (e.wrap = n, n === "hard" && typeof e.cols > "u" && (e.cols = 20)), Object.keys(e).length > 0 && (i.attrs = e), !t) return i;
+  const a = {};
+  return typeof t.label == "string" && (a.label = t.label), typeof t.labelledby == "string" && (a.labelledby = t.labelledby), typeof t.hidden == "boolean" && (a.hidden = t.hidden), Object.keys(a).length > 0 ? { ...i, aria: a } : i;
+}
+function _(r, t) {
+  return w(g, O(t), r);
+}
+function F(r = document) {
+}
+const C = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  TEXTAREA_SELECTOR: N,
+  TEXTAREA_TAG: g,
+  createTextarea: _,
+  enhanceTextareas: F
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  N as T,
+  g as a,
+  _ as c,
+  F as e,
+  C as i
+};
+//# sourceMappingURL=index95.js.map

package/dist/esm/chunks/index95.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index95.js","sources":["../../../src/elements/form/textarea/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Textarea element helpers.\n *\n * @remarks\n * The textarea element (`<textarea>`) is a multi-line plain-text form control.\n *\n * Best-practice guidance:\n * - Always provide an accessible name (typically via a `<label>`).\n * - Prefer `placeholder` as a hint, not as a substitute for a label.\n * - Use `rows`/`cols` to set a sensible baseline size, then use CSS for layout.\n * - Use `minLength`/`maxLength` for client-side constraints, but validate on the server.\n * - Use `wrap=\"hard\"` only when you intentionally want line breaks inserted for\n *   form submission, and ensure `cols` is set.\n * - Use `dirname` only when you actually want directionality included in submission.\n *\n * Attributes (element-specific):\n * - `name`, `form`, `disabled`, `required`, `readOnly`\n * - `cols`, `rows`\n * - `minLength`, `maxLength`\n * - `placeholder`\n * - `autoComplete`, `autoFocus`, `autoCapitalize`\n * - `dirName`\n * - `wrap`\n *\n * Security:\n * - Global attribute escape hatches are guarded by Fundatio's `dom.ts` helpers which\n *   block inline event handler attributes (e.g. `onclick`) and raw `style`\n *   attribute injection (use the `style` object field instead).\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/textarea\n *\n * @module\n * @category Elements\n */\n\nimport { createElement, type ElementOf, type GlobalAttrs } from '../../../ts/dom';\n\n/**\n * Structured ARIA input supported by Fundatio element factories.\n *\n * @remarks\n * This is intentionally a small, typed subset that covers common cases and\n * prevents typo-based ARIA bugs (e.g. `lable`).\n *\n * It is mapped into {@link GlobalAttrs.aria} for application by `dom.ts`.\n *\n * @category Attributes\n */\nexport type StructuredAria = {\n  /**\n   * Accessible label, mapped to `aria-label`.\n   */\n  label?: string;\n\n  /**\n   * ID reference to the labelling element(s), mapped to `aria-labelledby`.\n   */\n  labelledby?: string;\n\n  /**\n   * Decorative/hidden hint, mapped to `aria-hidden`.\n   */\n  hidden?: boolean;\n};\n\n/**\n * The semantic tag name for textarea.\n *\n * @category Constants\n */\nexport const TEXTAREA_TAG = 'textarea' as const;\n\n/**\n * A CSS selector targeting textarea elements.\n *\n * @category Constants\n */\nexport const TEXTAREA_SELECTOR = 'textarea';\n\n/**\n * Textarea wrap modes.\n *\n * @remarks\n * - `soft` (default): the submitted value is not forcibly wrapped.\n * - `hard`: line breaks are inserted for submission based on `cols`.\n *\n * @category Types\n */\nexport type TextareaWrap = 'soft' | 'hard';\n\n/**\n * Autocapitalize values accepted by browsers for form controls.\n *\n * @remarks\n * This is a content attribute commonly supported on form controls.\n *\n * @category Types\n */\nexport type AutoCapitalize = 'off' | 'none' | 'on' | 'sentences' | 'words' | 'characters';\n\n/**\n * Attribute bag for textarea creation/enhancement.\n *\n * @remarks\n * Textareas accept standard HTML global attributes plus textarea-specific content\n * attributes.\n *\n * Fundatio also supports a structured ARIA input for common ARIA fields, which is\n * mapped into {@link GlobalAttrs.aria} without changing Fundatio's core DOM helpers.\n *\n * @category Attributes\n */\nexport type TextareaAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n\n  /**\n   * Name used during form submission.\n   */\n  name?: string;\n\n  /**\n   * Associate the control with a form by ID.\n   */\n  form?: string;\n\n  /**\n   * Whether the textarea is disabled.\n   */\n  disabled?: boolean;\n\n  /**\n   * Whether the textarea is required.\n   */\n  required?: boolean;\n\n  /**\n   * Whether the textarea is read-only.\n   *\n   * @remarks\n   * Maps to the `readonly` content attribute.\n   */\n  readOnly?: boolean;\n\n  /**\n   * The number of visible text columns.\n   */\n  cols?: number;\n\n  /**\n   * The number of visible text rows.\n   */\n  rows?: number;\n\n  /**\n   * Minimum input length.\n   *\n   * @remarks\n   * Maps to the `minlength` content attribute.\n   */\n  minLength?: number;\n\n  /**\n   * Maximum input length.\n   *\n   * @remarks\n   * Maps to the `maxlength` content attribute.\n   */\n  maxLength?: number;\n\n  /**\n   * Placeholder hint text.\n   */\n  placeholder?: string;\n\n  /**\n   * Autofill hint.\n   */\n  autoComplete?: string;\n\n  /**\n   * Whether the control should be focused on page load.\n   */\n  autoFocus?: boolean;\n\n  /**\n   * Autocapitalization behavior.\n   */\n  autoCapitalize?: AutoCapitalize;\n\n  /**\n   * Submission directionality field name.\n   *\n   * @remarks\n   * When set, the value must not be empty.\n   * Maps to the `dirname` content attribute.\n   */\n  dirName?: string;\n\n  /**\n   * Wrapping mode for form submission.\n   */\n  wrap?: TextareaWrap;\n};\n\n/**\n * Normalize {@link TextareaAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The textarea attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @throws Error if `dirName` is provided but empty/whitespace.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: TextareaAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const {\n    aria,\n    name,\n    form,\n    disabled,\n    required,\n    readOnly,\n    cols,\n    rows,\n    minLength,\n    maxLength,\n    placeholder,\n    autoComplete,\n    autoFocus,\n    autoCapitalize,\n    dirName,\n    wrap,\n    ...rest\n  } = attrs;\n\n  const mapped: GlobalAttrs = { ...rest };\n\n  const extra: NonNullable<GlobalAttrs['attrs']> = { ...(mapped.attrs ?? {}) };\n\n  if (typeof name === 'string') extra.name = name;\n  if (typeof form === 'string') extra.form = form;\n\n  if (disabled === true) extra.disabled = true;\n  if (required === true) extra.required = true;\n  if (readOnly === true) extra.readonly = true;\n\n  if (typeof cols === 'number' && Number.isFinite(cols)) extra.cols = cols;\n  if (typeof rows === 'number' && Number.isFinite(rows)) extra.rows = rows;\n\n  if (typeof minLength === 'number' && Number.isFinite(minLength)) extra.minlength = minLength;\n  if (typeof maxLength === 'number' && Number.isFinite(maxLength)) extra.maxlength = maxLength;\n\n  if (typeof placeholder === 'string') extra.placeholder = placeholder;\n\n  if (typeof autoComplete === 'string') extra.autocomplete = autoComplete;\n  if (autoFocus === true) extra.autofocus = true;\n  if (typeof autoCapitalize === 'string') extra.autocapitalize = autoCapitalize;\n\n  if (typeof dirName === 'string') {\n    const dn = dirName.trim();\n    if (dn.length === 0) {\n      throw new Error('textarea dirName must not be an empty string.');\n    }\n    extra.dirname = dn;\n  }\n\n  if (wrap === 'soft' || wrap === 'hard') {\n    extra.wrap = wrap;\n\n    // \"hard\" wrap only has an effect when cols is set, so we enforce a safe default.\n    if (wrap === 'hard' && typeof extra.cols === 'undefined') {\n      extra.cols = 20;\n    }\n  }\n\n  if (Object.keys(extra).length > 0) {\n    mapped.attrs = extra;\n  }\n\n  if (!aria) return mapped;\n\n  const mappedAria: NonNullable<GlobalAttrs['aria']> = {};\n\n  if (typeof aria.label === 'string') mappedAria.label = aria.label;\n  if (typeof aria.labelledby === 'string') mappedAria.labelledby = aria.labelledby;\n  if (typeof aria.hidden === 'boolean') mappedAria.hidden = aria.hidden;\n\n  const hasMappedAria = Object.keys(mappedAria).length > 0;\n\n  return hasMappedAria ? { ...mapped, aria: mappedAria } : mapped;\n}\n\n/**\n * Create a textarea element with optional initial value and attributes.\n *\n * @remarks\n * For `<textarea>`, the initial value is represented by its text content in HTML.\n * Fundatio assigns the provided `text` via `textContent` (never `innerHTML`).\n *\n * - Text content is assigned via `textContent` (never `innerHTML`).\n * - Global attributes and escape-hatch attributes are applied via Fundatio's shared\n *   DOM helper, including security guards that block inline event handler\n *   attributes (e.g. `onclick`) and raw `style` attribute strings.\n *\n * @param text - Optional initial value (assigned as `textContent`).\n * @param attrs - Optional attributes to apply.\n * @returns The created `<textarea>` element.\n *\n * @example\n * ```ts\n * import { createTextarea } from \"@Vastare/Fundatio/elements/form/textarea\";\n *\n * const t = createTextarea(\"Hello\", { rows: 4, cols: 40, name: \"message\" });\n * ```\n *\n * @category DOM\n */\nexport function createTextarea(\n  text?: string,\n  attrs?: TextareaAttrs,\n): ElementOf<typeof TEXTAREA_TAG> {\n  return createElement(TEXTAREA_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance textarea elements within a given root.\n *\n * @remarks\n * This is intentionally a no-op in `1.0.0`.\n *\n * Why does it exist?\n * - It establishes a stable integration pattern for frameworks (Vue/React/etc.)\n * - It allows future progressive enhancements without changing consumer code\n *\n * What it will never do:\n * - It will not inject styles (CSS remains the source of truth)\n * - It will not introduce framework-specific behavior\n *\n * @param root - The node to search within. Defaults to `document`.\n *\n * @category Enhancement\n */\nexport function enhanceTextareas(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for textarea.\n  void root;\n}\n"],"names":["TEXTAREA_TAG","TEXTAREA_SELECTOR","toGlobalAttrs","attrs","aria","name","form","disabled","required","readOnly","cols","rows","minLength","maxLength","placeholder","autoComplete","autoFocus","autoCapitalize","dirName","wrap","rest","mapped","extra","dn","mappedAria","createTextarea","text","createElement","enhanceTextareas","root"],"mappings":";AAsEO,MAAMA,IAAe,YAOfC,IAAoB;AA4IjC,SAASC,EAAcC,GAAgD;AACrE,MAAI,CAACA,EAAO;AAEZ,QAAM;AAAA,IACJ,MAAAC;AAAA,IACA,MAAAC;AAAA,IACA,MAAAC;AAAA,IACA,UAAAC;AAAA,IACA,UAAAC;AAAA,IACA,UAAAC;AAAA,IACA,MAAAC;AAAA,IACA,MAAAC;AAAA,IACA,WAAAC;AAAA,IACA,WAAAC;AAAA,IACA,aAAAC;AAAA,IACA,cAAAC;AAAA,IACA,WAAAC;AAAA,IACA,gBAAAC;AAAA,IACA,SAAAC;AAAA,IACA,MAAAC;AAAA,IACA,GAAGC;AAAA,EAAA,IACDjB,GAEEkB,IAAsB,EAAE,GAAGD,EAAA,GAE3BE,IAA2C,EAAE,GAAID,EAAO,SAAS,CAAA,EAAC;AAqBxE,MAnBI,OAAOhB,KAAS,aAAUiB,EAAM,OAAOjB,IACvC,OAAOC,KAAS,aAAUgB,EAAM,OAAOhB,IAEvCC,MAAa,OAAMe,EAAM,WAAW,KACpCd,MAAa,OAAMc,EAAM,WAAW,KACpCb,MAAa,OAAMa,EAAM,WAAW,KAEpC,OAAOZ,KAAS,YAAY,OAAO,SAASA,CAAI,QAAS,OAAOA,IAChE,OAAOC,KAAS,YAAY,OAAO,SAASA,CAAI,QAAS,OAAOA,IAEhE,OAAOC,KAAc,YAAY,OAAO,SAASA,CAAS,QAAS,YAAYA,IAC/E,OAAOC,KAAc,YAAY,OAAO,SAASA,CAAS,QAAS,YAAYA,IAE/E,OAAOC,KAAgB,aAAUQ,EAAM,cAAcR,IAErD,OAAOC,KAAiB,aAAUO,EAAM,eAAeP,IACvDC,MAAc,OAAMM,EAAM,YAAY,KACtC,OAAOL,KAAmB,aAAUK,EAAM,iBAAiBL,IAE3D,OAAOC,KAAY,UAAU;AAC/B,UAAMK,IAAKL,EAAQ,KAAA;AACnB,QAAIK,EAAG,WAAW;AAChB,YAAM,IAAI,MAAM,+CAA+C;AAEjE,IAAAD,EAAM,UAAUC;AAAA,EAClB;AAeA,OAbIJ,MAAS,UAAUA,MAAS,YAC9BG,EAAM,OAAOH,GAGTA,MAAS,UAAU,OAAOG,EAAM,OAAS,QAC3CA,EAAM,OAAO,MAIb,OAAO,KAAKA,CAAK,EAAE,SAAS,MAC9BD,EAAO,QAAQC,IAGb,CAAClB,EAAM,QAAOiB;AAElB,QAAMG,IAA+C,CAAA;AAErD,SAAI,OAAOpB,EAAK,SAAU,aAAUoB,EAAW,QAAQpB,EAAK,QACxD,OAAOA,EAAK,cAAe,aAAUoB,EAAW,aAAapB,EAAK,aAClE,OAAOA,EAAK,UAAW,cAAWoB,EAAW,SAASpB,EAAK,SAEzC,OAAO,KAAKoB,CAAU,EAAE,SAAS,IAEhC,EAAE,GAAGH,GAAQ,MAAMG,MAAeH;AAC3D;AA2BO,SAASI,EACdC,GACAvB,GACgC;AAChC,SAAOwB,EAAc3B,GAAcE,EAAcC,CAAK,GAAGuB,CAAI;AAC/D;AAoBO,SAASE,EAAiBC,IAAmB,UAAgB;AAGpE;;;;;;;;"}

package/dist/esm/chunks/index96.js

@@ -0,0 +1,35 @@
+import { c as f } from "./dom.js";
+const s = "details", b = "details";
+function p(n) {
+  if (!n) return;
+  const { aria: t, open: c, name: d, ...r } = n, o = { ...r.attrs ?? {} }, i = (e, l) => {
+    l !== void 0 && (Object.prototype.hasOwnProperty.call(o, e) || (o[e] = l));
+  };
+  i("name", d), c === !0 && i("open", "");
+  const a = { ...r };
+  if (Object.keys(o).length > 0 && (a.attrs = o), t) {
+    const e = {};
+    typeof t.label == "string" && (e.label = t.label), typeof t.labelledby == "string" && (e.labelledby = t.labelledby), typeof t.hidden == "boolean" && (e.hidden = t.hidden), Object.keys(e).length > 0 && (a.aria = e);
+  }
+  return a;
+}
+function u(n) {
+  return f(s, p(n));
+}
+function y(n = document) {
+}
+const g = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  DETAILS_SELECTOR: b,
+  DETAILS_TAG: s,
+  createDetails: u,
+  enhanceDetails: y
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  b as D,
+  s as a,
+  u as c,
+  y as e,
+  g as i
+};
+//# sourceMappingURL=index96.js.map

package/dist/esm/chunks/index96.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index96.js","sources":["../../../src/elements/interactive/details/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Details element helpers.\n *\n * @remarks\n * The details element (`<details>`) creates a disclosure widget where content is\n * shown/hidden by toggling the element open/closed. (MDN) :contentReference[oaicite:3]{index=3}\n *\n * Best-practice guidance:\n * - Provide a visible label using a child `<summary>` element; it acts as the\n *   interactive control for toggling the parent `<details>`. (MDN) :contentReference[oaicite:4]{index=4}\n * - Use the `open` attribute to render expanded by default. (MDN) :contentReference[oaicite:5]{index=5}\n * - If using the `name` attribute to create a mutually-exclusive group, authors\n *   must avoid markup where more than one element in the same name group has\n *   `open` present. User agents may enforce exclusivity by changing `open`.\n *   (WHATWG) :contentReference[oaicite:6]{index=6}\n *\n * Fundatio-specific conventions:\n * - Applies global attributes via Fundatio's hardened DOM helpers (`dom.ts`), which\n *   block inline event handler attributes (e.g. `onclick`) and the raw `style`\n *   attribute string.\n * - Supports a small structured ARIA input to reduce typo-based ARIA bugs.\n *\n * This module has no side effects and does not mutate the DOM unless you call\n * its functions.\n *\n * @module\n * @category Elements\n */\n\nimport { createElement, type AttrValue, type ElementOf, type GlobalAttrs } from '../../../ts/dom';\n\n/**\n * Structured ARIA input supported by Fundatio element factories.\n *\n * @remarks\n * This is intentionally a small, typed subset mapped into {@link GlobalAttrs.aria}.\n *\n * @category Attributes\n */\nexport type StructuredAria = {\n  /**\n   * Accessible label, mapped to `aria-label`.\n   */\n  label?: string;\n\n  /**\n   * ID reference(s) to labelling element(s), mapped to `aria-labelledby`.\n   */\n  labelledby?: string;\n\n  /**\n   * Decorative/hidden hint, mapped to `aria-hidden`.\n   */\n  hidden?: boolean;\n};\n\n/**\n * The semantic tag name for details disclosure widgets.\n *\n * @category Constants\n */\nexport const DETAILS_TAG = 'details' as const;\n\n/**\n * A CSS selector targeting details elements.\n *\n * @category Constants\n */\nexport const DETAILS_SELECTOR = 'details';\n\n/**\n * Attribute bag for details creation/enhancement.\n *\n * @remarks\n * `<details>` accepts global attributes plus:\n * - `open` (boolean attribute)\n * - `name` (creates a mutually-exclusive details name group, per spec)\n *\n * `name` grouping behavior is specified by HTML; Fundatio does not enforce group\n * constraints at runtime. (WHATWG) :contentReference[oaicite:7]{index=7}\n *\n * Fundatio also supports a structured ARIA input for common ARIA fields, mapped into\n * {@link GlobalAttrs.aria}.\n *\n * @category Attributes\n */\nexport type DetailsAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n\n  /**\n   * Whether the details is open (expanded) by default.\n   *\n   * @remarks\n   * This maps to the boolean `open` attribute. (MDN) :contentReference[oaicite:8]{index=8}\n   */\n  open?: boolean;\n\n  /**\n   * Name of a mutually-exclusive details group.\n   *\n   * @remarks\n   * Details with the same `name` may form an exclusive group where at most one\n   * is open at a time. (WHATWG) :contentReference[oaicite:9]{index=9}\n   */\n  name?: string;\n};\n\n/**\n * Normalize {@link DetailsAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @remarks\n * Pattern:\n * - Start with any caller-provided raw attrs escape hatch.\n * - Apply typed attributes without overriding explicit raw attributes.\n * - Map structured ARIA into {@link GlobalAttrs.aria}.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: DetailsAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, open, name, ...rest } = attrs;\n\n  const mergedAttrs: Record<string, AttrValue> = { ...(rest.attrs ?? {}) };\n\n  const setIfUnset = (key: string, v: AttrValue | undefined): void => {\n    if (v === undefined) return;\n    if (Object.prototype.hasOwnProperty.call(mergedAttrs, key)) return;\n    mergedAttrs[key] = v;\n  };\n\n  setIfUnset('name', name);\n\n  // Boolean attribute by presence when true.\n  if (open === true) setIfUnset('open', '');\n\n  const mapped: GlobalAttrs = { ...rest };\n\n  if (Object.keys(mergedAttrs).length > 0) {\n    mapped.attrs = mergedAttrs;\n  }\n\n  if (aria) {\n    const mappedAria: NonNullable<GlobalAttrs['aria']> = {};\n    if (typeof aria.label === 'string') mappedAria.label = aria.label;\n    if (typeof aria.labelledby === 'string') mappedAria.labelledby = aria.labelledby;\n    if (typeof aria.hidden === 'boolean') mappedAria.hidden = aria.hidden;\n\n    if (Object.keys(mappedAria).length > 0) {\n      mapped.aria = mappedAria;\n    }\n  }\n\n  return mapped;\n}\n\n/**\n * Create a details element with optional attributes.\n *\n * @remarks\n * - Provide a child `<summary>` for the visible label/toggle control. (MDN) :contentReference[oaicite:10]{index=10}\n * - Global attributes are applied via Fundatio's shared DOM helper, including security\n *   guards that block inline event handler attributes (e.g. `onclick`) and raw\n *   `style` attribute strings.\n *\n * @param attrs - Optional attributes to apply.\n * @returns The created `<details>` element.\n *\n * @example\n * ```ts\n * import { createDetails } from \"@Vastare/Fundatio/elements/interactive/details\";\n *\n * const d = createDetails({ open: true });\n * ```\n *\n * @category DOM\n */\nexport function createDetails(attrs?: DetailsAttrs): ElementOf<typeof DETAILS_TAG> {\n  return createElement(DETAILS_TAG, toGlobalAttrs(attrs));\n}\n\n/**\n * Enhance details elements within a given root.\n *\n * @remarks\n * This is intentionally a no-op in `1.0.0`.\n *\n * @param root - The node to search within. Defaults to `document`.\n *\n * @category Enhancement\n */\nexport function enhanceDetails(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for details.\n  void root;\n}\n"],"names":["DETAILS_TAG","DETAILS_SELECTOR","toGlobalAttrs","attrs","aria","open","name","rest","mergedAttrs","setIfUnset","key","v","mapped","mappedAria","createDetails","createElement","enhanceDetails","root"],"mappings":";AA6DO,MAAMA,IAAc,WAOdC,IAAmB;AAqDhC,SAASC,EAAcC,GAA+C;AACpE,MAAI,CAACA,EAAO;AAEZ,QAAM,EAAE,MAAAC,GAAM,MAAAC,GAAM,MAAAC,GAAM,GAAGC,MAASJ,GAEhCK,IAAyC,EAAE,GAAID,EAAK,SAAS,CAAA,EAAC,GAE9DE,IAAa,CAACC,GAAaC,MAAmC;AAClE,IAAIA,MAAM,WACN,OAAO,UAAU,eAAe,KAAKH,GAAaE,CAAG,MACzDF,EAAYE,CAAG,IAAIC;AAAA,EACrB;AAEA,EAAAF,EAAW,QAAQH,CAAI,GAGnBD,MAAS,MAAMI,EAAW,QAAQ,EAAE;AAExC,QAAMG,IAAsB,EAAE,GAAGL,EAAA;AAMjC,MAJI,OAAO,KAAKC,CAAW,EAAE,SAAS,MACpCI,EAAO,QAAQJ,IAGbJ,GAAM;AACR,UAAMS,IAA+C,CAAA;AACrD,IAAI,OAAOT,EAAK,SAAU,aAAUS,EAAW,QAAQT,EAAK,QACxD,OAAOA,EAAK,cAAe,aAAUS,EAAW,aAAaT,EAAK,aAClE,OAAOA,EAAK,UAAW,cAAWS,EAAW,SAAST,EAAK,SAE3D,OAAO,KAAKS,CAAU,EAAE,SAAS,MACnCD,EAAO,OAAOC;AAAA,EAElB;AAEA,SAAOD;AACT;AAuBO,SAASE,EAAcX,GAAqD;AACjF,SAAOY,EAAcf,GAAaE,EAAcC,CAAK,CAAC;AACxD;AAYO,SAASa,EAAeC,IAAmB,UAAgB;AAGlE;;;;;;;;"}

package/dist/esm/chunks/index97.js

@@ -0,0 +1,29 @@
+import { c } from "./dom.js";
+const r = "dialog", d = "dialog";
+function b(t) {
+  if (!t) return;
+  const { aria: e, open: i, closedBy: n, ...s } = t, o = { ...s }, l = { ...o.attrs ?? {} };
+  if (i === !0 && (l.open = !0), (n === "any" || n === "closerequest" || n === "none") && (l.closedby = n), Object.keys(l).length > 0 && (o.attrs = l), !e) return o;
+  const a = {};
+  return typeof e.label == "string" && (a.label = e.label), typeof e.labelledby == "string" && (a.labelledby = e.labelledby), typeof e.hidden == "boolean" && (a.hidden = e.hidden), Object.keys(a).length > 0 ? { ...o, aria: a } : o;
+}
+function f(t, e) {
+  return c(r, b(e), t);
+}
+function p(t = document) {
+}
+const g = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  DIALOG_SELECTOR: d,
+  DIALOG_TAG: r,
+  createDialog: f,
+  enhanceDialogs: p
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  d as D,
+  r as a,
+  f as c,
+  p as e,
+  g as i
+};
+//# sourceMappingURL=index97.js.map

package/dist/esm/chunks/index97.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index97.js","sources":["../../../src/elements/interactive/dialog/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Dialog element helpers.\n *\n * @remarks\n * The dialog element (`<dialog>`) represents a modal or non-modal dialog box\n * (e.g. a confirm prompt, inspector, or subwindow).\n *\n * Best-practice guidance:\n * - Prefer using the platform APIs:\n *   - `dialog.showModal()` for modal dialogs\n *   - `dialog.show()` for non-modal dialogs\n *   - `dialog.close()` to close, optionally supplying a return value\n * - Provide an accessible name for the dialog content (e.g. heading + `aria-labelledby`\n *   or `aria-label` when appropriate).\n * - Ensure the dialog contains an obvious close mechanism.\n * - Avoid relying solely on adding/removing `open`; prefer the element's methods\n *   for correct focus and modal behavior.\n *\n * Attributes (element-specific):\n * - `open` (boolean): when present, the dialog is active and available for interaction.\n * - `closedBy` (enumerated): maps to the `closedby` content attribute (spec-defined).\n *\n * Security:\n * - Global attribute escape hatches are guarded by Fundatio's `dom.ts` helpers which\n *   block inline event handler attributes (e.g. `onclick`) and raw `style`\n *   attribute injection (use the `style` object field instead).\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/dialog\n *\n * @module\n * @category Elements\n */\n\nimport { createElement, type ElementOf, type GlobalAttrs } from '../../../ts/dom';\n\n/**\n * Structured ARIA input supported by Fundatio element factories.\n *\n * @remarks\n * This is intentionally a small, typed subset that covers common cases and\n * prevents typo-based ARIA bugs (e.g. `lable`).\n *\n * It is mapped into {@link GlobalAttrs.aria} for application by `dom.ts`.\n *\n * @category Attributes\n */\nexport type StructuredAria = {\n  /**\n   * Accessible label, mapped to `aria-label`.\n   */\n  label?: string;\n\n  /**\n   * ID reference to the labelling element(s), mapped to `aria-labelledby`.\n   */\n  labelledby?: string;\n\n  /**\n   * Decorative/hidden hint, mapped to `aria-hidden`.\n   */\n  hidden?: boolean;\n};\n\n/**\n * The semantic tag name for dialog.\n *\n * @category Constants\n */\nexport const DIALOG_TAG = 'dialog' as const;\n\n/**\n * A CSS selector targeting dialog elements.\n *\n * @category Constants\n */\nexport const DIALOG_SELECTOR = 'dialog';\n\n/**\n * Values supported by the `closedby` content attribute.\n *\n * @remarks\n * This is a newer platform feature that specifies which user actions can close\n * the dialog automatically.\n *\n * - `any`: close requests or clicks outside close the dialog.\n * - `closerequest`: close requests close the dialog.\n * - `none`: no user actions automatically close the dialog.\n *\n * @category Types\n */\nexport type DialogClosedBy = 'any' | 'closerequest' | 'none';\n\n/**\n * Attribute bag for dialog creation/enhancement.\n *\n * @remarks\n * Dialog elements accept standard HTML global attributes plus a small set of\n * dialog-specific content attributes.\n *\n * Fundatio also supports a structured ARIA input for common ARIA fields, which is\n * mapped into {@link GlobalAttrs.aria} without changing Fundatio's core DOM helpers.\n *\n * @category Attributes\n */\nexport type DialogAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n\n  /**\n   * Whether the dialog is open (active).\n   *\n   * @remarks\n   * Maps to the `open` boolean attribute.\n   *\n   * Prefer controlling visibility via the native methods (`showModal`, `show`,\n   * `close`) when possible.\n   */\n  open?: boolean;\n\n  /**\n   * Control user actions that can close the dialog.\n   *\n   * @remarks\n   * Maps to the `closedby` content attribute.\n   */\n  closedBy?: DialogClosedBy;\n};\n\n/**\n * Normalize {@link DialogAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The dialog attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: DialogAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, open, closedBy, ...rest } = attrs;\n\n  const mapped: GlobalAttrs = { ...rest };\n\n  const extra: NonNullable<GlobalAttrs['attrs']> = { ...(mapped.attrs ?? {}) };\n\n  if (open === true) extra.open = true;\n\n  if (closedBy === 'any' || closedBy === 'closerequest' || closedBy === 'none') {\n    extra.closedby = closedBy;\n  }\n\n  if (Object.keys(extra).length > 0) {\n    mapped.attrs = extra;\n  }\n\n  if (!aria) return mapped;\n\n  const mappedAria: NonNullable<GlobalAttrs['aria']> = {};\n\n  if (typeof aria.label === 'string') mappedAria.label = aria.label;\n  if (typeof aria.labelledby === 'string') mappedAria.labelledby = aria.labelledby;\n  if (typeof aria.hidden === 'boolean') mappedAria.hidden = aria.hidden;\n\n  // Only attach `aria` if something was actually defined.\n  const hasMappedAria = Object.keys(mappedAria).length > 0;\n\n  return hasMappedAria ? { ...mapped, aria: mappedAria } : mapped;\n}\n\n/**\n * Create a dialog element with optional text content and attributes.\n *\n * @remarks\n * - Text content is assigned via `textContent` (never `innerHTML`).\n * - Global attributes are applied via Fundatio's shared DOM helper,\n *   including security guards that block inline event handler attributes\n *   (e.g. `onclick`) and raw `style` attribute strings.\n *\n * @param text - Optional text content for the dialog.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<dialog>` element.\n *\n * @example\n * ```ts\n * import { createDialog } from \"@Vastare/Fundatio/elements/interactive/dialog\";\n *\n * const d = createDialog(\"Hello\", { open: true });\n * ```\n *\n * @category DOM\n */\nexport function createDialog(text?: string, attrs?: DialogAttrs): ElementOf<typeof DIALOG_TAG> {\n  return createElement(DIALOG_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance dialog elements within a given root.\n *\n * @remarks\n * This is intentionally a no-op in `1.0.0`.\n *\n * Why does it exist?\n * - It establishes a stable integration pattern for frameworks (Vue/React/etc.)\n * - It allows future progressive enhancements without changing consumer code\n *\n * What it will never do:\n * - It will not inject styles (CSS remains the source of truth)\n * - It will not introduce framework-specific behavior\n *\n * @param root - The node to search within. Defaults to `document`.\n *\n * @category Enhancement\n */\nexport function enhanceDialogs(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for dialog.\n  void root;\n}\n"],"names":["DIALOG_TAG","DIALOG_SELECTOR","toGlobalAttrs","attrs","aria","open","closedBy","rest","mapped","extra","mappedAria","createDialog","text","createElement","enhanceDialogs","root"],"mappings":";AAoEO,MAAMA,IAAa,UAObC,IAAkB;AA+D/B,SAASC,EAAcC,GAA8C;AACnE,MAAI,CAACA,EAAO;AAEZ,QAAM,EAAE,MAAAC,GAAM,MAAAC,GAAM,UAAAC,GAAU,GAAGC,MAASJ,GAEpCK,IAAsB,EAAE,GAAGD,EAAA,GAE3BE,IAA2C,EAAE,GAAID,EAAO,SAAS,CAAA,EAAC;AAYxE,MAVIH,MAAS,OAAMI,EAAM,OAAO,MAE5BH,MAAa,SAASA,MAAa,kBAAkBA,MAAa,YACpEG,EAAM,WAAWH,IAGf,OAAO,KAAKG,CAAK,EAAE,SAAS,MAC9BD,EAAO,QAAQC,IAGb,CAACL,EAAM,QAAOI;AAElB,QAAME,IAA+C,CAAA;AAErD,SAAI,OAAON,EAAK,SAAU,aAAUM,EAAW,QAAQN,EAAK,QACxD,OAAOA,EAAK,cAAe,aAAUM,EAAW,aAAaN,EAAK,aAClE,OAAOA,EAAK,UAAW,cAAWM,EAAW,SAASN,EAAK,SAGzC,OAAO,KAAKM,CAAU,EAAE,SAAS,IAEhC,EAAE,GAAGF,GAAQ,MAAME,MAAeF;AAC3D;AAwBO,SAASG,EAAaC,GAAeT,GAAmD;AAC7F,SAAOU,EAAcb,GAAYE,EAAcC,CAAK,GAAGS,CAAI;AAC7D;AAoBO,SAASE,EAAeC,IAAmB,UAAgB;AAGlE;;;;;;;;"}

package/dist/esm/chunks/index98.js

@@ -0,0 +1,29 @@
+import { c as r } from "./dom.js";
+const o = "summary", l = "summary";
+function i(t) {
+  if (!t) return;
+  const { aria: e, ...n } = t;
+  if (!e) return n;
+  const a = {};
+  return typeof e.label == "string" && (a.label = e.label), typeof e.labelledby == "string" && (a.labelledby = e.labelledby), typeof e.hidden == "boolean" && (a.hidden = e.hidden), Object.keys(a).length > 0 ? { ...n, aria: a } : n;
+}
+function s(t, e) {
+  return r(o, i(e), t);
+}
+function c(t = document) {
+}
+const u = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  SUMMARY_SELECTOR: l,
+  SUMMARY_TAG: o,
+  createSummary: s,
+  enhanceSummaries: c
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  l as S,
+  o as a,
+  s as c,
+  c as e,
+  u as i
+};
+//# sourceMappingURL=index98.js.map

package/dist/esm/chunks/index98.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index98.js","sources":["../../../src/elements/interactive/summary/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Summary element helpers.\n *\n * @remarks\n * The summary element (`<summary>`) provides the visible label for a parent\n * `<details>` disclosure widget. Activating (clicking / pressing Enter) on the\n * `<summary>` toggles the open state of the parent `<details>` element.\n *\n * Best-practice guidance:\n * - Use `<summary>` only as the first child of a `<details>` element.\n * - Use clear, concise text so the disclosure purpose is obvious.\n * - Prefer semantic content inside `<summary>`; avoid overly complex interactive\n *   children inside the summary label.\n *\n * Fundatio notes:\n * - This module is framework-agnostic and has no side effects.\n * - Global attributes are applied via Fundatio's shared DOM helper, which blocks:\n *   - inline event handler attributes (e.g. `onclick`)\n *   - raw `style` attribute injection (use the `style` object instead)\n * - Text passed to factories is assigned via `textContent` (never `innerHTML`).\n *\n * References:\n * - MDN: `<summary>` element\n * - WHATWG HTML: `<details>` content model and summary semantics\n *\n * @module\n * @category Elements\n */\n\nimport { createElement, type ElementOf, type GlobalAttrs } from '../../../ts/dom';\n\n/**\n * Structured ARIA input supported by Fundatio element factories.\n *\n * @remarks\n * This is intentionally a small, typed subset that covers common cases and\n * prevents typo-based ARIA bugs.\n *\n * It is mapped into {@link GlobalAttrs.aria} for application by `dom.ts`.\n *\n * @category Attributes\n */\nexport type StructuredAria = {\n  /**\n   * Accessible label, mapped to `aria-label`.\n   */\n  label?: string;\n\n  /**\n   * ID reference to the labelling element(s), mapped to `aria-labelledby`.\n   */\n  labelledby?: string;\n\n  /**\n   * Decorative/hidden hint, mapped to `aria-hidden`.\n   */\n  hidden?: boolean;\n};\n\n/**\n * The semantic tag name for summary.\n *\n * @category Constants\n */\nexport const SUMMARY_TAG = 'summary' as const;\n\n/**\n * A CSS selector targeting summary elements.\n *\n * @category Constants\n */\nexport const SUMMARY_SELECTOR = 'summary';\n\n/**\n * Attribute bag for summary creation/enhancement.\n *\n * @remarks\n * `<summary>` supports standard HTML global attributes.\n *\n * Fundatio also supports a structured ARIA input for common ARIA fields, which is\n * mapped into {@link GlobalAttrs.aria} without changing Fundatio's core DOM helpers.\n *\n * @category Attributes\n */\nexport type SummaryAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link SummaryAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The summary attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: SummaryAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, ...rest } = attrs;\n\n  if (!aria) return rest;\n\n  const mappedAria: NonNullable<GlobalAttrs['aria']> = {};\n\n  if (typeof aria.label === 'string') mappedAria.label = aria.label;\n  if (typeof aria.labelledby === 'string') mappedAria.labelledby = aria.labelledby;\n  if (typeof aria.hidden === 'boolean') mappedAria.hidden = aria.hidden;\n\n  const hasMapped = Object.keys(mappedAria).length > 0;\n\n  return hasMapped ? { ...rest, aria: mappedAria } : rest;\n}\n\n/**\n * Create a summary element with optional text content and global attributes.\n *\n * @remarks\n * - Text content is assigned via `textContent` (never `innerHTML`).\n * - Global attributes are applied via Fundatio's shared DOM helper,\n *   including security guards that block inline event handler attributes\n *   (e.g. `onclick`) and raw `style` attribute strings.\n *\n * @param text - Optional text content for the summary.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<summary>` element.\n *\n * @example\n * ```ts\n * import { createSummary } from \"@Vastare/Fundatio/elements/interactive/summary\";\n *\n * const s = createSummary(\"More details\");\n * ```\n *\n * @category DOM\n */\nexport function createSummary(text?: string, attrs?: SummaryAttrs): ElementOf<typeof SUMMARY_TAG> {\n  return createElement(SUMMARY_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance summary elements within a given root.\n *\n * @remarks\n * This is intentionally a no-op in `1.0.0`.\n *\n * Why does it exist?\n * - It establishes a stable integration pattern for frameworks (Vue/React/etc.)\n * - It allows future progressive enhancements without changing consumer code\n *\n * @param root - The node to search within. Defaults to `document`.\n *\n * @category Enhancement\n */\nexport function enhanceSummaries(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for summary.\n  void root;\n}\n"],"names":["SUMMARY_TAG","SUMMARY_SELECTOR","toGlobalAttrs","attrs","aria","rest","mappedAria","createSummary","text","createElement","enhanceSummaries","root"],"mappings":";AAgEO,MAAMA,IAAc,WAOdC,IAAmB;AA4BhC,SAASC,EAAcC,GAA+C;AACpE,MAAI,CAACA,EAAO;AAEZ,QAAM,EAAE,MAAAC,GAAM,GAAGC,EAAA,IAASF;AAE1B,MAAI,CAACC,EAAM,QAAOC;AAElB,QAAMC,IAA+C,CAAA;AAErD,SAAI,OAAOF,EAAK,SAAU,aAAUE,EAAW,QAAQF,EAAK,QACxD,OAAOA,EAAK,cAAe,aAAUE,EAAW,aAAaF,EAAK,aAClE,OAAOA,EAAK,UAAW,cAAWE,EAAW,SAASF,EAAK,SAE7C,OAAO,KAAKE,CAAU,EAAE,SAAS,IAEhC,EAAE,GAAGD,GAAM,MAAMC,MAAeD;AACrD;AAwBO,SAASE,EAAcC,GAAeL,GAAqD;AAChG,SAAOM,EAAcT,GAAaE,EAAcC,CAAK,GAAGK,CAAI;AAC9D;AAgBO,SAASE,EAAiBC,IAAmB,UAAgB;AAGpE;;;;;;;;"}

package/dist/esm/chunks/index99.js

@@ -0,0 +1,40 @@
+import { a as A } from "./dom.js";
+const g = "area", u = "area";
+function m(a) {
+  const {
+    aria: e,
+    alt: s,
+    href: n,
+    shape: i,
+    coords: l,
+    target: f,
+    download: o,
+    ping: d,
+    rel: c,
+    referrerPolicy: p,
+    hreflang: y,
+    type: b,
+    ...h
+  } = a ?? {}, t = { ...h }, r = {};
+  return e && (typeof e.label == "string" && (r.label = e.label), typeof e.labelledby == "string" && (r.labelledby = e.labelledby), typeof e.hidden == "boolean" && (r.hidden = e.hidden)), Object.keys(r).length > 0 && (t.aria = r), t.attrs = { ...t.attrs ?? {} }, typeof n == "string" && n.length > 0 && (t.attrs.href = n, t.attrs.alt = typeof s == "string" ? s : ""), i && (t.attrs.shape = i), l && (t.attrs.coords = l), f && (t.attrs.target = f), typeof o == "boolean" && (t.attrs.download = o), typeof o == "string" && (t.attrs.download = o), d && (t.attrs.ping = d), c && (t.attrs.rel = c), p && (t.attrs.referrerpolicy = p), y && (t.attrs.hreflang = y), b && (t.attrs.type = b), t;
+}
+function _(a) {
+  return A(g, m(a));
+}
+function E(a = document) {
+}
+const w = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  AREA_SELECTOR: u,
+  AREA_TAG: g,
+  createArea: _,
+  enhanceAreas: E
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  u as A,
+  g as a,
+  _ as c,
+  E as e,
+  w as i
+};
+//# sourceMappingURL=index99.js.map

package/dist/esm/chunks/index99.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index99.js","sources":["../../../src/elements/responsive/area/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Area element helpers.\n *\n * @remarks\n * The area element (`<area>`) defines a hyperlink or dead region within an image map.\n * It is used inside a `<map>` element to define clickable (or non-clickable) areas.\n *\n * Best-practice guidance:\n * - Use `<area>` only within `<map>` and pair with an `<img usemap=\"...\">`.\n * - Prefer meaningful alternative text for clickable regions (screen readers rely on it).\n * - Keep shapes and coordinates accurate; imprecise maps are a usability disaster.\n *\n * Spec-aware Fundatio behavior:\n * - If `href` is provided: `alt` is required, and Fundatio will ensure an `alt` attribute\n *   exists (defaults to empty string if not provided).\n * - If `href` is not provided: `alt` must be omitted, and Fundatio will omit it.\n *\n * Global attributes are applied via Fundatio's hardened DOM helpers (`dom.ts`), which block:\n * - inline event handler attributes (e.g. `onclick`)\n * - the raw `style` attribute string (use `style` object instead)\n *\n * This module has no side effects and does not mutate the DOM unless you call its functions.\n *\n * @module\n * @category Elements\n */\n\nimport { createVoidElement, type ElementOf, type GlobalAttrs } from '../../../ts/dom';\n\n/**\n * Structured ARIA input supported by Fundatio element factories.\n *\n * @category Attributes\n */\nexport type StructuredAria = {\n  /**\n   * Accessible label, mapped to `aria-label`.\n   */\n  label?: string;\n\n  /**\n   * ID reference(s) to labelling element(s), mapped to `aria-labelledby`.\n   */\n  labelledby?: string;\n\n  /**\n   * Decorative/hidden hint, mapped to `aria-hidden`.\n   */\n  hidden?: boolean;\n};\n\n/**\n * The semantic tag name for area elements.\n *\n * @category Constants\n */\nexport const AREA_TAG = 'area' as const;\n\n/**\n * A CSS selector targeting area elements.\n *\n * @category Constants\n */\nexport const AREA_SELECTOR = 'area';\n\n/**\n * Enumerated shape values for `<area>`.\n *\n * @remarks\n * The default (when omitted) is effectively `rect` in HTML's image map processing model,\n * but Fundatio does not force a default; it passes through what you provide.\n *\n * @category Types\n */\nexport type AreaShape = 'rect' | 'circle' | 'poly' | 'default';\n\n/**\n * Area-specific attributes.\n *\n * @remarks\n * `<area>` largely mirrors hyperlink-related attributes when `href` is present.\n * Fundatio enforces the spec rule around `alt`:\n * - `href` present => `alt` must be present (Fundatio ensures it exists)\n * - `href` absent  => `alt` must be omitted (Fundatio omits it)\n *\n * @category Attributes\n */\nexport type AreaAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Alternative text for the area.\n   *\n   * @remarks\n   * Only applied when `href` is present. If `href` is present and `alt` is not\n   * provided, Fundatio defaults it to `\"\"`. If `href` is absent, Fundatio omits `alt`\n   * entirely.\n   */\n  alt?: string;\n\n  /**\n   * Link target URL. When present, the area represents a hyperlink.\n   */\n  href?: string;\n\n  /**\n   * The shape of the area. Common values: `rect`, `circle`, `poly`, `default`.\n   */\n  shape?: AreaShape;\n\n  /**\n   * Coordinates defining the area geometry. Interpretation depends on `shape`.\n   */\n  coords?: string;\n\n  /**\n   * Where to display the linked URL (e.g. `_blank`).\n   */\n  target?: string;\n\n  /**\n   * Whether to download the linked resource instead of navigating.\n   *\n   * @remarks\n   * May be a boolean (attribute presence) or a suggested filename.\n   */\n  download?: boolean | string;\n\n  /**\n   * A space-separated list of URLs to ping when the link is followed.\n   */\n  ping?: string;\n\n  /**\n   * Relationship of the target object to the linking object.\n   */\n  rel?: string;\n\n  /**\n   * Referrer policy for the link.\n   */\n  referrerPolicy?: string;\n\n  /**\n   * Language of the linked resource (BCP 47 tag).\n   */\n  hreflang?: string;\n\n  /**\n   * MIME type of the linked resource (advisory).\n   */\n  type?: string;\n\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\nfunction toGlobalAttrs(attrs?: AreaAttrs): GlobalAttrs {\n  const {\n    aria,\n    alt,\n    href,\n    shape,\n    coords,\n    target,\n    download,\n    ping,\n    rel,\n    referrerPolicy,\n    hreflang,\n    type,\n    ...rest\n  } = attrs ?? {};\n\n  const mapped: GlobalAttrs = { ...rest };\n\n  const mappedAria: NonNullable<GlobalAttrs['aria']> = {};\n\n  if (aria) {\n    if (typeof aria.label === 'string') mappedAria.label = aria.label;\n    if (typeof aria.labelledby === 'string') mappedAria.labelledby = aria.labelledby;\n    if (typeof aria.hidden === 'boolean') mappedAria.hidden = aria.hidden;\n  }\n\n  if (Object.keys(mappedAria).length > 0) {\n    mapped.aria = mappedAria;\n  }\n\n  // Apply element-specific attributes via the safe attrs escape hatch.\n  mapped.attrs = { ...(mapped.attrs ?? {}) };\n\n  const hasHref = typeof href === 'string' && href.length > 0;\n\n  if (hasHref) {\n    mapped.attrs.href = href;\n\n    // Spec: if href is present, alt must be present.\n    mapped.attrs.alt = typeof alt === 'string' ? alt : '';\n  } else {\n    // Spec: if href is absent, alt must be omitted.\n    // We intentionally do not set `alt` here even if provided.\n  }\n\n  if (shape) mapped.attrs.shape = shape;\n  if (coords) mapped.attrs.coords = coords;\n  if (target) mapped.attrs.target = target;\n\n  if (typeof download === 'boolean') mapped.attrs.download = download;\n  if (typeof download === 'string') mapped.attrs.download = download;\n\n  if (ping) mapped.attrs.ping = ping;\n  if (rel) mapped.attrs.rel = rel;\n  if (referrerPolicy) mapped.attrs.referrerpolicy = referrerPolicy;\n  if (hreflang) mapped.attrs.hreflang = hreflang;\n  if (type) mapped.attrs.type = type;\n\n  return mapped;\n}\n\n/**\n * Create an area element with spec-aware `alt` handling.\n *\n * @remarks\n * - `<area>` is a void element (no text content).\n * - If `href` is present, Fundatio ensures `alt` is present (defaults to `\"\"`).\n * - If `href` is absent, Fundatio omits `alt`.\n *\n * @category DOM\n */\nexport function createArea(attrs?: AreaAttrs): ElementOf<typeof AREA_TAG> {\n  return createVoidElement(AREA_TAG, toGlobalAttrs(attrs));\n}\n\n/**\n * Enhance area elements within a given root.\n *\n * @remarks\n * No runtime behaviour in v1.0.0.\n *\n * @category Enhancement\n */\nexport function enhanceAreas(root: ParentNode = document): void {\n  void root;\n}\n"],"names":["AREA_TAG","AREA_SELECTOR","toGlobalAttrs","attrs","aria","alt","href","shape","coords","target","download","ping","rel","referrerPolicy","hreflang","type","rest","mapped","mappedAria","createArea","createVoidElement","enhanceAreas","root"],"mappings":";AAwDO,MAAMA,IAAW,QAOXC,IAAgB;AA8F7B,SAASC,EAAcC,GAAgC;AACrD,QAAM;AAAA,IACJ,MAAAC;AAAA,IACA,KAAAC;AAAA,IACA,MAAAC;AAAA,IACA,OAAAC;AAAA,IACA,QAAAC;AAAA,IACA,QAAAC;AAAA,IACA,UAAAC;AAAA,IACA,MAAAC;AAAA,IACA,KAAAC;AAAA,IACA,gBAAAC;AAAA,IACA,UAAAC;AAAA,IACA,MAAAC;AAAA,IACA,GAAGC;AAAA,EAAA,IACDb,KAAS,CAAA,GAEPc,IAAsB,EAAE,GAAGD,EAAA,GAE3BE,IAA+C,CAAA;AAErD,SAAId,MACE,OAAOA,EAAK,SAAU,aAAUc,EAAW,QAAQd,EAAK,QACxD,OAAOA,EAAK,cAAe,aAAUc,EAAW,aAAad,EAAK,aAClE,OAAOA,EAAK,UAAW,cAAWc,EAAW,SAASd,EAAK,UAG7D,OAAO,KAAKc,CAAU,EAAE,SAAS,MACnCD,EAAO,OAAOC,IAIhBD,EAAO,QAAQ,EAAE,GAAIA,EAAO,SAAS,CAAA,EAAC,GAEtB,OAAOX,KAAS,YAAYA,EAAK,SAAS,MAGxDW,EAAO,MAAM,OAAOX,GAGpBW,EAAO,MAAM,MAAM,OAAOZ,KAAQ,WAAWA,IAAM,KAMjDE,MAAOU,EAAO,MAAM,QAAQV,IAC5BC,MAAQS,EAAO,MAAM,SAAST,IAC9BC,MAAQQ,EAAO,MAAM,SAASR,IAE9B,OAAOC,KAAa,cAAWO,EAAO,MAAM,WAAWP,IACvD,OAAOA,KAAa,aAAUO,EAAO,MAAM,WAAWP,IAEtDC,MAAMM,EAAO,MAAM,OAAON,IAC1BC,MAAKK,EAAO,MAAM,MAAML,IACxBC,MAAgBI,EAAO,MAAM,iBAAiBJ,IAC9CC,MAAUG,EAAO,MAAM,WAAWH,IAClCC,MAAME,EAAO,MAAM,OAAOF,IAEvBE;AACT;AAYO,SAASE,EAAWhB,GAA+C;AACxE,SAAOiB,EAAkBpB,GAAUE,EAAcC,CAAK,CAAC;AACzD;AAUO,SAASkB,EAAaC,IAAmB,UAAgB;AAEhE;;;;;;;;"}

package/dist/esm/elements/break/br/br.js

@@ -0,0 +1,9 @@
+import "../../../chunks/dom.js";
+import { B as s, a as B, c, e as o } from "../../../chunks/index17.js";
+export {
+  s as BR_SELECTOR,
+  B as BR_TAG,
+  c as createBr,
+  o as enhanceBrs
+};
+//# sourceMappingURL=br.js.map

package/dist/esm/elements/break/br/br.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"br.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/esm/elements/break/break.js

@@ -0,0 +1,7 @@
+import { i as a } from "../../chunks/index17.js";
+import { i as e } from "../../chunks/index18.js";
+export {
+  a as br,
+  e as wbr
+};
+//# sourceMappingURL=break.js.map

package/dist/esm/elements/break/break.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"break.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/esm/elements/break/wbr/wbr.js

@@ -0,0 +1,9 @@
+import "../../../chunks/dom.js";
+import { W as s, a as W, c, e as o } from "../../../chunks/index18.js";
+export {
+  s as WBR_SELECTOR,
+  W as WBR_TAG,
+  c as createWbr,
+  o as enhanceWbrs
+};
+//# sourceMappingURL=wbr.js.map

package/dist/esm/elements/break/wbr/wbr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wbr.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/esm/elements/container/container.js

@@ -0,0 +1,7 @@
+import { i as a } from "../../chunks/index15.js";
+import { i as p } from "../../chunks/index16.js";
+export {
+  a as div,
+  p as span
+};
+//# sourceMappingURL=container.js.map

package/dist/esm/elements/container/container.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/esm/elements/container/div/div.js

@@ -0,0 +1,9 @@
+import "../../../chunks/dom.js";
+import { D, a as r, c, e as i } from "../../../chunks/index15.js";
+export {
+  D as DIV_SELECTOR,
+  r as DIV_TAG,
+  c as createDiv,
+  i as enhanceDivs
+};
+//# sourceMappingURL=div.js.map

package/dist/esm/elements/container/div/div.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"div.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/esm/elements/container/span/span.js

@@ -0,0 +1,9 @@
+import "../../../chunks/dom.js";
+import { S as s, a as n, c as p, e as r } from "../../../chunks/index16.js";
+export {
+  s as SPAN_SELECTOR,
+  n as SPAN_TAG,
+  p as createSpan,
+  r as enhanceSpans
+};
+//# sourceMappingURL=span.js.map

package/dist/esm/elements/container/span/span.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"span.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/esm/elements/figure/figcaption/figcaption.js

@@ -0,0 +1,9 @@
+import "../../../chunks/dom.js";
+import { F as i, a as o, c as s, e as t } from "../../../chunks/index80.js";
+export {
+  i as FIGCAPTION_SELECTOR,
+  o as FIGCAPTION_TAG,
+  s as createFigcaption,
+  t as enhanceFigcaptions
+};
+//# sourceMappingURL=figcaption.js.map

package/dist/esm/elements/figure/figcaption/figcaption.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"figcaption.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/esm/elements/figure/figure/figure.js

@@ -0,0 +1,9 @@
+import "../../../chunks/dom.js";
+import { F as s, a as F, c as E, e as c } from "../../../chunks/index81.js";
+export {
+  s as FIGURE_SELECTOR,
+  F as FIGURE_TAG,
+  E as createFigure,
+  c as enhanceFigures
+};
+//# sourceMappingURL=figure.js.map

package/dist/esm/elements/figure/figure/figure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"figure.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/esm/elements/figure/figure.js

@@ -0,0 +1,7 @@
+import { i as r } from "../../chunks/index80.js";
+import { i as a } from "../../chunks/index81.js";
+export {
+  r as figcaption,
+  a as figure
+};
+//# sourceMappingURL=figure.js.map

package/dist/esm/elements/figure/figure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"figure.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/esm/elements/form/button/button.js

@@ -0,0 +1,9 @@
+import "../../../chunks/dom.js";
+import { B as T, a as o, c as s, e as B } from "../../../chunks/index82.js";
+export {
+  T as BUTTON_SELECTOR,
+  o as BUTTON_TAG,
+  s as createButton,
+  B as enhanceButtons
+};
+//# sourceMappingURL=button.js.map

package/dist/esm/elements/form/button/button.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"button.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/esm/elements/form/datalist/datalist.js

@@ -0,0 +1,9 @@
+import "../../../chunks/dom.js";
+import { D as e, a as T, c as A, e as D } from "../../../chunks/index83.js";
+export {
+  e as DATALIST_SELECTOR,
+  T as DATALIST_TAG,
+  A as createDatalist,
+  D as enhanceDatalists
+};
+//# sourceMappingURL=datalist.js.map

package/dist/esm/elements/form/datalist/datalist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"datalist.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/esm/elements/form/fieldset/fieldset.js

@@ -0,0 +1,9 @@
+import "../../../chunks/dom.js";
+import { F as E, a as t, c as F, e as r } from "../../../chunks/index84.js";
+export {
+  E as FIELDSET_SELECTOR,
+  t as FIELDSET_TAG,
+  F as createFieldset,
+  r as enhanceFieldsets
+};
+//# sourceMappingURL=fieldset.js.map

package/dist/esm/elements/form/fieldset/fieldset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldset.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/esm/elements/form/form/form.js

@@ -0,0 +1,9 @@
+import "../../../chunks/dom.js";
+import { F as o, a as s, c as F, e as m } from "../../../chunks/index85.js";
+export {
+  o as FORM_SELECTOR,
+  s as FORM_TAG,
+  F as createForm,
+  m as enhanceForms
+};
+//# sourceMappingURL=form.js.map

package/dist/esm/elements/form/form/form.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/esm/elements/form/form.js

@@ -0,0 +1,31 @@
+import { i as t } from "../../chunks/index82.js";
+import { i as p } from "../../chunks/index83.js";
+import { i as s } from "../../chunks/index84.js";
+import { i as f } from "../../chunks/index85.js";
+import { i as x } from "../../chunks/index86.js";
+import { i as u } from "../../chunks/index87.js";
+import { i as d } from "../../chunks/index88.js";
+import { i as b } from "../../chunks/index89.js";
+import { i as h } from "../../chunks/index90.js";
+import { i as k } from "../../chunks/index91.js";
+import { i as v } from "../../chunks/index92.js";
+import { i as y } from "../../chunks/index93.js";
+import { i as A } from "../../chunks/index94.js";
+import { i as C } from "../../chunks/index95.js";
+export {
+  t as button,
+  p as datalist,
+  s as fieldset,
+  f as form,
+  x as input,
+  u as label,
+  d as legend,
+  b as meter,
+  h as optgroup,
+  k as option,
+  v as output,
+  y as progress,
+  A as select,
+  C as textarea
+};
+//# sourceMappingURL=form.js.map

package/dist/esm/elements/form/form.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;"}

package/dist/esm/elements/form/input/input.js

@@ -0,0 +1,9 @@
+import "../../../chunks/dom.js";
+import { I as t, a as I, c as n, e as p } from "../../../chunks/index86.js";
+export {
+  t as INPUT_SELECTOR,
+  I as INPUT_TAG,
+  n as createInput,
+  p as enhanceInputs
+};
+//# sourceMappingURL=input.js.map

package/dist/esm/elements/form/input/input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/esm/elements/form/label/label.js

@@ -0,0 +1,9 @@
+import "../../../chunks/dom.js";
+import { L as s, a as r, c as E, e as c } from "../../../chunks/index87.js";
+export {
+  s as LABEL_SELECTOR,
+  r as LABEL_TAG,
+  E as createLabel,
+  c as enhanceLabels
+};
+//# sourceMappingURL=label.js.map

package/dist/esm/elements/form/label/label.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"label.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/esm/elements/form/legend/legend.js

@@ -0,0 +1,9 @@
+import "../../../chunks/dom.js";
+import { L, a as s, c as n, e as r } from "../../../chunks/index88.js";
+export {
+  L as LEGEND_SELECTOR,
+  s as LEGEND_TAG,
+  n as createLegend,
+  r as enhanceLegends
+};
+//# sourceMappingURL=legend.js.map

package/dist/esm/elements/form/legend/legend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legend.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/esm/elements/form/meter/meter.js

@@ -0,0 +1,9 @@
+import "../../../chunks/dom.js";
+import { M as E, a as s, c as t, e as M } from "../../../chunks/index89.js";
+export {
+  E as METER_SELECTOR,
+  s as METER_TAG,
+  t as createMeter,
+  M as enhanceMeters
+};
+//# sourceMappingURL=meter.js.map

package/dist/esm/elements/form/meter/meter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meter.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/esm/elements/form/optgroup/optgroup.js

@@ -0,0 +1,9 @@
+import "../../../chunks/dom.js";
+import { O as p, a as r, c as o, e as s } from "../../../chunks/index90.js";
+export {
+  p as OPTGROUP_SELECTOR,
+  r as OPTGROUP_TAG,
+  o as createOptgroup,
+  s as enhanceOptgroups
+};
+//# sourceMappingURL=optgroup.js.map

package/dist/esm/elements/form/optgroup/optgroup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"optgroup.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/esm/elements/form/option/option.js

@@ -0,0 +1,9 @@
+import "../../../chunks/dom.js";
+import { O as o, a as s, c as t, e as n } from "../../../chunks/index91.js";
+export {
+  o as OPTION_SELECTOR,
+  s as OPTION_TAG,
+  t as createOption,
+  n as enhanceOptions
+};
+//# sourceMappingURL=option.js.map

package/dist/esm/elements/form/option/option.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"option.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/esm/elements/form/output/output.js

@@ -0,0 +1,9 @@
+import "../../../chunks/dom.js";
+import { O, a as T, c as s, e as p } from "../../../chunks/index92.js";
+export {
+  O as OUTPUT_SELECTOR,
+  T as OUTPUT_TAG,
+  s as createOutput,
+  p as enhanceOutputs
+};
+//# sourceMappingURL=output.js.map

package/dist/esm/elements/form/output/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}