@vastare/fundatio 0.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"index77.js","sources":["../../../src/elements/list/li/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Li element helpers.\n *\n * @remarks\n * The list item element (`<li>`) represents an item in a list.\n *\n * Best-practice guidance:\n * - Use `<li>` only as a direct child of a list container (`<ul>`, `<ol>`, `<menu>`).\n * - Prefer semantic list structure over styling hacks.\n * - For ordered lists, use the `value` attribute/property to control numbering when needed\n *   (e.g. continuing a sequence after inserted items).\n * - Avoid the legacy `type` attribute where possible; prefer list-level semantics and CSS.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create `<li>` elements in vanilla JS/TS without templates\n * - apply consistent global attributes safely\n * - supply typed element-specific fields like `value`\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 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 * Legacy marker type options for list items.\n *\n * @remarks\n * The `type` attribute on `<li>` is legacy and should be avoided when possible.\n * It is retained here for compatibility scenarios.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/li\n *\n * @category Attributes\n */\nexport type LiMarkerType = '1' | 'a' | 'A' | 'i' | 'I';\n\n/**\n * The semantic tag name for list items.\n *\n * @category Constants\n */\nexport const LI_TAG = 'li' as const;\n\n/**\n * A CSS selector targeting list item elements.\n *\n * @category Constants\n */\nexport const LI_SELECTOR = 'li';\n\n/**\n * Attribute bag for li creation/enhancement.\n *\n * @remarks\n * In addition to global attributes, `<li>` supports:\n * - `value` (primarily for `<ol>` numbering control)\n * - legacy `type` marker hint (deprecated)\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/li\n *\n * @category Attributes\n */\nexport type LiAttrs = Omit<GlobalAttrs, 'aria' | 'attrs'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n\n  /**\n   * Ordinal value for ordered lists.\n   *\n   * @remarks\n   * When used within an `<ol>`, this sets the list item's numbering value.\n   * This is modeled as a number and applied via the `HTMLLIElement.value` property.\n   */\n  value?: number;\n\n  /**\n   * Legacy marker type hint (deprecated).\n   *\n   * @remarks\n   * Prefer list semantics and CSS. Retained for compatibility.\n   */\n  type?: LiMarkerType;\n\n  /**\n   * Additional attributes not modeled above.\n   *\n   * @remarks\n   * This exists as an escape hatch while still allowing Fundatio to apply its\n   * attribute safety rules via `dom.ts`.\n   */\n  attrs?: GlobalAttrs['attrs'];\n};\n\n/**\n * Normalize {@link LiAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The li attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: LiAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, type, attrs: extraAttrs, value: _value, ...rest } = attrs;\n\n  const mapped: GlobalAttrs = { ...rest };\n\n  // Map structured aria.\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) mapped.aria = mappedAria;\n  }\n\n  // Merge extra attrs and map legacy `type` through the hardened attrs path.\n  const mergedAttrs: NonNullable<GlobalAttrs['attrs']> = { ...(extraAttrs ?? {}) };\n  if (typeof type === 'string' && type.length > 0) mergedAttrs.type = type;\n\n  if (Object.keys(mergedAttrs).length > 0) mapped.attrs = mergedAttrs;\n\n  return mapped;\n}\n\n/**\n * Create a list item 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 * - The `value` field is applied via the `HTMLLIElement.value` property for correct behavior.\n *\n * @param text - Optional text content for the list item.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<li>` element.\n *\n * @example\n * ```ts\n * import { createLi } from \"@Vastare/Fundatio/elements/list/li\";\n *\n * const li = createLi(\"Item 3\", { value: 3 });\n * ```\n *\n * @category DOM\n */\nexport function createLi(text?: string, attrs?: LiAttrs): ElementOf<typeof LI_TAG> {\n  const el = createElement(LI_TAG, toGlobalAttrs(attrs), text);\n\n  // Apply ordered-list numbering via the DOM property.\n  if (attrs && typeof attrs.value === 'number' && Number.isFinite(attrs.value)) {\n    (el as unknown as HTMLLIElement).value = attrs.value;\n  }\n\n  return el;\n}\n\n/**\n * Enhance list item 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 enhanceLis(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for li.\n  void root;\n}\n"],"names":["LI_TAG","LI_SELECTOR","toGlobalAttrs","attrs","aria","type","extraAttrs","_value","rest","mapped","mappedAria","mergedAttrs","createLi","text","el","createElement","enhanceLis","root"],"mappings":";AAyEO,MAAMA,IAAS,MAOTC,IAAc;AAuD3B,SAASC,EAAcC,GAA0C;AAC/D,MAAI,CAACA,EAAO;AAEZ,QAAM,EAAE,MAAAC,GAAM,MAAAC,GAAM,OAAOC,GAAY,OAAOC,GAAQ,GAAGC,EAAA,IAASL,GAE5DM,IAAsB,EAAE,GAAGD,EAAA;AAGjC,MAAIJ,GAAM;AACR,UAAMM,IAA+C,CAAA;AACrD,IAAI,OAAON,EAAK,SAAU,aAAUM,EAAW,QAAQN,EAAK,QACxD,OAAOA,EAAK,cAAe,aAAUM,EAAW,aAAaN,EAAK,aAClE,OAAOA,EAAK,UAAW,cAAWM,EAAW,SAASN,EAAK,SAE3D,OAAO,KAAKM,CAAU,EAAE,SAAS,QAAU,OAAOA;AAAA,EACxD;AAGA,QAAMC,IAAiD,EAAE,GAAIL,KAAc,GAAC;AAC5E,SAAI,OAAOD,KAAS,YAAYA,EAAK,SAAS,QAAe,OAAOA,IAEhE,OAAO,KAAKM,CAAW,EAAE,SAAS,QAAU,QAAQA,IAEjDF;AACT;AAyBO,SAASG,EAASC,GAAeV,GAA2C;AACjF,QAAMW,IAAKC,EAAcf,GAAQE,EAAcC,CAAK,GAAGU,CAAI;AAG3D,SAAIV,KAAS,OAAOA,EAAM,SAAU,YAAY,OAAO,SAASA,EAAM,KAAK,MACxEW,EAAgC,QAAQX,EAAM,QAG1CW;AACT;AAgBO,SAASE,EAAWC,IAAmB,UAAgB;AAG9D;;;;;;;;"}

package/dist/esm/chunks/index78.js

@@ -0,0 +1,30 @@
+import { c as i } from "./dom.js";
+const l = "ol", r = "ol";
+function a(e) {
+  if (!e) return;
+  const { aria: o, ...n } = e;
+  if (!o) return n;
+  const t = {};
+  return typeof o.label == "string" && (t.label = o.label), typeof o.labelledby == "string" && (t.labelledby = o.labelledby), typeof o.hidden == "boolean" && (t.hidden = o.hidden), Object.keys(t).length > 0 ? { ...n, aria: t } : n;
+}
+function s(e) {
+  const o = i(l, a(e)), n = o;
+  return e && (typeof e.reversed == "boolean" && (n.reversed = e.reversed), typeof e.start == "number" && Number.isFinite(e.start) && (n.start = e.start), typeof e.type == "string" && (n.type = e.type)), o;
+}
+function f(e = document) {
+}
+const p = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  OL_SELECTOR: r,
+  OL_TAG: l,
+  createOl: s,
+  enhanceOls: f
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  r as O,
+  l as a,
+  s as c,
+  f as e,
+  p as i
+};
+//# sourceMappingURL=index78.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index78.js","sources":["../../../src/elements/list/ol/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Ordered list element helpers.\n *\n * @remarks\n * The ordered list element (`<ol>`) represents an ordered list of items.\n *\n * Best-practice guidance:\n * - Prefer `<ol>` when the order of items matters (steps, rankings, sequences).\n * - List items should be `<li>` elements (direct children).\n * - Avoid presentational attributes when possible; prefer CSS for styling.\n * - Use `start`/`reversed` only when semantics require non-default numbering.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create ordered lists in vanilla JS/TS without templates\n * - apply consistent global attributes safely\n * - use a stable \"enhancement\" hook if Fundatio ever needs runtime behavior\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 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 ordered lists.\n *\n * @category Constants\n */\nexport const OL_TAG = 'ol' as const;\n\n/**\n * A CSS selector targeting ordered list elements.\n *\n * @category Constants\n */\nexport const OL_SELECTOR = 'ol';\n\n/**\n * Allowed values for the `<ol>` `type` attribute.\n *\n * @remarks\n * While `type` is still supported by browsers, it is presentational and CSS is\n * often preferable.\n *\n * - `1`  Decimal numbers (default)\n * - `a`  Lowercase letters\n * - `A`  Uppercase letters\n * - `i`  Lowercase Roman numerals\n * - `I`  Uppercase Roman numerals\n *\n * @category Attributes\n */\nexport type OlType = '1' | 'a' | 'A' | 'i' | 'I';\n\n/**\n * Attribute bag for ordered list creation/enhancement.\n *\n * @remarks\n * Ordered lists accept HTML global attributes and a small set of specific\n * attributes:\n * - `reversed` for descending numbering\n * - `start` to set the initial counter value\n * - `type` to choose the marker style (often better via CSS)\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 OlAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Whether numbering should be descending.\n   */\n  reversed?: boolean;\n\n  /**\n   * Starting value for the list counter.\n   */\n  start?: number;\n\n  /**\n   * Marker type for list items.\n   */\n  type?: OlType;\n\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link OlAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The ordered list attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: OlAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, ...rest } = attrs;\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  return hasMapped ? { ...rest, aria: mappedAria } : rest;\n}\n\n/**\n * Create an ordered list element with global and list-specific attributes.\n *\n * @remarks\n * This helper intentionally does not accept raw HTML. Consumers should append\n * `<li>` children using DOM APIs.\n *\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 `<ol>` element.\n *\n * @example\n * ```ts\n * import { createOl } from \"@Vastare/Fundatio/elements/list/ol\";\n *\n * const ol = createOl({ start: 3, reversed: true, className: \"steps\" });\n * document.body.appendChild(ol);\n * ```\n *\n * @category DOM\n */\nexport function createOl(attrs?: OlAttrs): ElementOf<typeof OL_TAG> {\n  const el = createElement(OL_TAG, toGlobalAttrs(attrs));\n  const ol = el as unknown as HTMLOListElement;\n\n  if (attrs) {\n    if (typeof attrs.reversed === 'boolean') ol.reversed = attrs.reversed;\n    if (typeof attrs.start === 'number' && Number.isFinite(attrs.start)) ol.start = attrs.start;\n    if (typeof attrs.type === 'string') ol.type = attrs.type;\n  }\n\n  return el;\n}\n\n/**\n * Enhance ordered list 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 enhanceOls(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for ol.\n  void root;\n}\n"],"names":["OL_TAG","OL_SELECTOR","toGlobalAttrs","attrs","aria","rest","mappedAria","createOl","el","createElement","ol","enhanceOls","root"],"mappings":";AA2DO,MAAMA,IAAS,MAOTC,IAAc;AAgE3B,SAASC,EAAcC,GAA0C;AAC/D,MAAI,CAACA,EAAO;AAEZ,QAAM,EAAE,MAAAC,GAAM,GAAGC,EAAA,IAASF;AAC1B,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,IAChC,EAAE,GAAGD,GAAM,MAAMC,MAAeD;AACrD;AA0BO,SAASE,EAASJ,GAA2C;AAClE,QAAMK,IAAKC,EAAcT,GAAQE,EAAcC,CAAK,CAAC,GAC/CO,IAAKF;AAEX,SAAIL,MACE,OAAOA,EAAM,YAAa,cAAWO,EAAG,WAAWP,EAAM,WACzD,OAAOA,EAAM,SAAU,YAAY,OAAO,SAASA,EAAM,KAAK,MAAGO,EAAG,QAAQP,EAAM,QAClF,OAAOA,EAAM,QAAS,aAAUO,EAAG,OAAOP,EAAM,QAG/CK;AACT;AAoBO,SAASG,EAAWC,IAAmB,UAAgB;AAG9D;;;;;;;;"}

package/dist/esm/chunks/index79.js

@@ -0,0 +1,32 @@
+import { c } from "./dom.js";
+const a = "ul", f = "ul";
+function d(t) {
+  if (!t) return;
+  const { aria: e, type: l, attrs: i, ...s } = t, o = { ...s };
+  if (e) {
+    const n = {};
+    typeof e.label == "string" && (n.label = e.label), typeof e.labelledby == "string" && (n.labelledby = e.labelledby), typeof e.hidden == "boolean" && (n.hidden = e.hidden), Object.keys(n).length > 0 && (o.aria = n);
+  }
+  const r = { ...i ?? {} };
+  return typeof l == "string" && l.length > 0 && (r.type = l), Object.keys(r).length > 0 && (o.attrs = r), o;
+}
+function b(t, e) {
+  return c(a, d(e), t);
+}
+function p(t = document) {
+}
+const u = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  UL_SELECTOR: f,
+  UL_TAG: a,
+  createUl: b,
+  enhanceUls: p
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  f as U,
+  a,
+  b as c,
+  p as e,
+  u as i
+};
+//# sourceMappingURL=index79.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index79.js","sources":["../../../src/elements/list/ul/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Unordered list (ul) element helpers.\n *\n * @remarks\n * The unordered list element (`<ul>`) represents a list of items where the\n * order does not change the meaning.\n *\n * Best-practice guidance:\n * - Use `<ul>` for lists where sequence is not meaningful (use `<ol>` when it is).\n * - Ensure list children are `<li>` elements.\n * - Do not use `<ul>` purely for indentation or spacing; use CSS for layout.\n * - The legacy `type` attribute is obsolete; prefer `list-style-type` in CSS.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create `<ul>` elements in vanilla JS/TS without templates\n * - apply consistent global attributes safely\n * - optionally set legacy presentation attributes in a controlled way\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 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 unordered lists.\n *\n * @category Constants\n */\nexport const UL_TAG = 'ul' as const;\n\n/**\n * A CSS selector targeting unordered list elements.\n *\n * @category Constants\n */\nexport const UL_SELECTOR = 'ul';\n\n/**\n * Legacy marker style values for `<ul type=\"...\">`.\n *\n * @remarks\n * The `type` attribute is obsolete in HTML5. Prefer CSS `list-style-type`.\n * This is included as a pragmatic escape hatch for legacy markup needs.\n *\n * @category Attributes\n */\nexport type UlLegacyType = 'disc' | 'circle' | 'square';\n\n/**\n * Attribute bag for ul creation/enhancement.\n *\n * @remarks\n * `<ul>` primarily accepts standard HTML global attributes.\n *\n * Fundatio also supports:\n * - structured ARIA input mapped into `aria-*`\n * - optional legacy `type` mapping to the `type` attribute (obsolete)\n * - an `attrs` escape hatch, still guarded by Fundatio's attribute safety rules\n *\n * @category Attributes\n */\nexport type UlAttrs = Omit<GlobalAttrs, 'aria' | 'attrs'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n\n  /**\n   * Legacy bullet style hint mapped to the `type` attribute (obsolete).\n   *\n   * @remarks\n   * Prefer CSS `list-style-type` instead.\n   */\n  type?: UlLegacyType;\n\n  /**\n   * Additional attributes not modeled above.\n   *\n   * @remarks\n   * This exists as an escape hatch while still allowing Fundatio to apply its\n   * attribute safety rules via `dom.ts`.\n   */\n  attrs?: GlobalAttrs['attrs'];\n};\n\n/**\n * Normalize {@link UlAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The ul attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: UlAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, type, attrs: extraAttrs, ...rest } = attrs;\n\n  const mapped: GlobalAttrs = { ...rest };\n\n  // Map structured aria.\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) mapped.aria = mappedAria;\n  }\n\n  // Merge escape-hatch attrs and add legacy `type` if provided.\n  const mergedAttrs: NonNullable<GlobalAttrs['attrs']> = { ...(extraAttrs ?? {}) };\n  if (typeof type === 'string' && type.length > 0) mergedAttrs.type = type;\n\n  if (Object.keys(mergedAttrs).length > 0) mapped.attrs = mergedAttrs;\n\n  return mapped;\n}\n\n/**\n * Create an unordered list (`<ul>`) with optional text content and attributes.\n *\n * @remarks\n * - Text content is assigned via `textContent` (never `innerHTML`).\n * - In real documents, `<ul>` should contain `<li>` children, not raw text.\n *   The optional `text` parameter exists for consistency with Fundatio factories and\n *   testing convenience.\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 ul.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<ul>` element.\n *\n * @example\n * ```ts\n * import { createUl } from \"@Vastare/Fundatio/elements/list/ul\";\n *\n * const ul = createUl(undefined, { id: \"features\" });\n * document.body.appendChild(ul);\n * ```\n *\n * @category DOM\n */\nexport function createUl(text?: string, attrs?: UlAttrs): ElementOf<typeof UL_TAG> {\n  return createElement(UL_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance unordered list 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 enhanceUls(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for ul.\n  void root;\n}\n"],"names":["UL_TAG","UL_SELECTOR","toGlobalAttrs","attrs","aria","type","extraAttrs","rest","mapped","mappedAria","mergedAttrs","createUl","text","createElement","enhanceUls","root"],"mappings":";AA4DO,MAAMA,IAAS,MAOTC,IAAc;AA0D3B,SAASC,EAAcC,GAA0C;AAC/D,MAAI,CAACA,EAAO;AAEZ,QAAM,EAAE,MAAAC,GAAM,MAAAC,GAAM,OAAOC,GAAY,GAAGC,MAASJ,GAE7CK,IAAsB,EAAE,GAAGD,EAAA;AAGjC,MAAIH,GAAM;AACR,UAAMK,IAA+C,CAAA;AACrD,IAAI,OAAOL,EAAK,SAAU,aAAUK,EAAW,QAAQL,EAAK,QACxD,OAAOA,EAAK,cAAe,aAAUK,EAAW,aAAaL,EAAK,aAClE,OAAOA,EAAK,UAAW,cAAWK,EAAW,SAASL,EAAK,SAE3D,OAAO,KAAKK,CAAU,EAAE,SAAS,QAAU,OAAOA;AAAA,EACxD;AAGA,QAAMC,IAAiD,EAAE,GAAIJ,KAAc,GAAC;AAC5E,SAAI,OAAOD,KAAS,YAAYA,EAAK,SAAS,QAAe,OAAOA,IAEhE,OAAO,KAAKK,CAAW,EAAE,SAAS,QAAU,QAAQA,IAEjDF;AACT;AA4BO,SAASG,EAASC,GAAeT,GAA2C;AACjF,SAAOU,EAAcb,GAAQE,EAAcC,CAAK,GAAGS,CAAI;AACzD;AAYO,SAASE,EAAWC,IAAmB,UAAgB;AAG9D;;;;;;;;"}

package/dist/esm/chunks/index8.js

@@ -0,0 +1,79 @@
+import { i as n } from "./index49.js";
+import { i as a } from "./index50.js";
+import { i as m } from "./index51.js";
+import { i as d } from "./index52.js";
+import { i as p } from "./index53.js";
+import { i as s } from "./index54.js";
+import { i as f } from "./index55.js";
+import { i as l } from "./index56.js";
+import { i as x } from "./index57.js";
+import { i as b } from "./index58.js";
+import { i as c } from "./index59.js";
+import { i as $ } from "./index60.js";
+import { i as u } from "./index61.js";
+import { i as y } from "./index62.js";
+import { i as _ } from "./index63.js";
+import { c as g } from "./dom.js";
+import { i as h } from "./index64.js";
+import { i as j } from "./index65.js";
+import { i as O } from "./index66.js";
+import { i as R } from "./index67.js";
+import { i as S } from "./index68.js";
+import { i as k } from "./index69.js";
+import { i as v } from "./index70.js";
+import { i as M } from "./index71.js";
+import { i as P } from "./index72.js";
+import { i as T } from "./index73.js";
+const t = "rp", A = "rp";
+function E(r) {
+  if (!r) return;
+  const { aria: i, ...e } = r;
+  if (!i) return e;
+  const o = {};
+  return typeof i.label == "string" && (o.label = i.label), typeof i.labelledby == "string" && (o.labelledby = i.labelledby), typeof i.hidden == "boolean" && (o.hidden = i.hidden), Object.keys(o).length > 0 ? { ...e, aria: o } : e;
+}
+function q(r, i) {
+  return g(t, E(i), r);
+}
+function z(r = document) {
+}
+const G = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  RP_SELECTOR: A,
+  RP_TAG: t,
+  createRp: q,
+  enhanceRps: z
+}, Symbol.toStringTag, { value: "Module" })), pi = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  abbr: a,
+  anchor: n,
+  b: m,
+  cite: s,
+  code: f,
+  data: l,
+  dfn: x,
+  em: b,
+  italic: c,
+  kbd: $,
+  mark: u,
+  q: y,
+  rb: _,
+  rp: G,
+  rt: h,
+  rtc: j,
+  ruby: O,
+  s: R,
+  samp: S,
+  small: d,
+  strong: p,
+  sub: k,
+  sup: v,
+  time: M,
+  u: P,
+  var: T
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  G as a,
+  pi as i
+};
+//# sourceMappingURL=index8.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index8.js","sources":["../../../src/elements/inline/rp/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Rp element helpers.\n *\n * @remarks\n * The rp element (`<rp>`) provides fallback parentheses (or other markers) for\n * ruby annotations when ruby rendering is not supported.\n *\n * Best-practice guidance:\n * - Use `<rp>` only inside `<ruby>` as a fallback wrapper around `<rt>` content.\n * - Keep `<rp>` content short (commonly \"(\" and \")\").\n * - Do not use `<rp>` for general punctuation or layout. Use normal text instead.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create rp elements in vanilla JS/TS without templates\n * - apply consistent global attributes safely\n * - use a stable \"enhancement\" hook if Fundatio ever needs runtime behavior\n *\n * References:\n * - MDN: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/rp\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 rp elements.\n *\n * @category Constants\n */\nexport const RP_TAG = 'rp' as const;\n\n/**\n * A CSS selector targeting rp elements.\n *\n * @category Constants\n */\nexport const RP_SELECTOR = 'rp';\n\n/**\n * Attribute bag for rp creation/enhancement.\n *\n * @remarks\n * Rp elements accept 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 RpAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link RpAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The rp attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: RpAttrs): 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  // Only attach `aria` if something was actually defined.\n  const hasMapped = Object.keys(mappedAria).length > 0;\n\n  return hasMapped ? { ...rest, aria: mappedAria } : rest;\n}\n\n/**\n * Create an rp 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 rp element (commonly \"(\" or \")\").\n * @param attrs - Optional attributes to apply.\n * @returns The created `<rp>` element.\n *\n * @example\n * Create a ruby fallback wrapper:\n * ```ts\n * import { createRp } from \"@Vastare/Fundatio/elements/inline/rp\";\n *\n * const open = createRp(\"(\");\n * const close = createRp(\")\");\n * ```\n *\n * @category DOM\n */\nexport function createRp(text?: string, attrs?: RpAttrs): ElementOf<typeof RP_TAG> {\n  return createElement(RP_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance rp 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 enhanceRps(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for rp.\n  void root;\n}\n"],"names":["RP_TAG","RP_SELECTOR","toGlobalAttrs","attrs","aria","rest","mappedAria","createRp","text","createElement","enhanceRps","root"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AA2DO,MAAMA,IAAS,MAOTC,IAAc;AA4B3B,SAASC,EAAcC,GAA0C;AAC/D,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,SAG7C,OAAO,KAAKE,CAAU,EAAE,SAAS,IAEhC,EAAE,GAAGD,GAAM,MAAMC,MAAeD;AACrD;AA0BO,SAASE,EAASC,GAAeL,GAA2C;AACjF,SAAOM,EAAcT,GAAQE,EAAcC,CAAK,GAAGK,CAAI;AACzD;AAoBO,SAASE,EAAWC,IAAmB,UAAgB;AAG9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/esm/chunks/index80.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index80.js","sources":["../../../src/elements/figure/figcaption/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Figcaption element helpers.\n *\n * @remarks\n * The figcaption element (`<figcaption>`) represents a caption or legend for\n * the rest of the contents of its parent `<figure>` element.\n *\n * Best-practice guidance (summary):\n * - Use `<figcaption>` as the caption for a `<figure>`.\n * - Place it as the first or last child of the `<figure>` where possible.\n * - Keep the visible caption text human-friendly and meaningful.\n * - Do not use `<figcaption>` purely for styling. Use CSS instead.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create `<figcaption>` elements in vanilla JS/TS without templates\n * - apply consistent global attributes safely\n * - use a stable \"enhancement\" hook if Fundatio ever needs runtime behavior\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 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 figcaption.\n *\n * @category Constants\n */\nexport const FIGCAPTION_TAG = 'figcaption' as const;\n\n/**\n * A CSS selector targeting figcaption elements.\n *\n * @category Constants\n */\nexport const FIGCAPTION_SELECTOR = 'figcaption';\n\n/**\n * Attribute bag for figcaption creation/enhancement.\n *\n * @remarks\n * `<figcaption>` 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 FigcaptionAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link FigcaptionAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The figcaption attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: FigcaptionAttrs): 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 figcaption 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 figcaption element.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<figcaption>` element.\n *\n * @example\n * ```ts\n * import { createFigcaption } from \"@Vastare/Fundatio/elements/figure/figcaption\";\n *\n * const c = createFigcaption(\"Kitchen layout, 2026\", { className: \"caption\" });\n * document.body.appendChild(c);\n * ```\n *\n * @category DOM\n */\nexport function createFigcaption(\n  text?: string,\n  attrs?: FigcaptionAttrs,\n): ElementOf<typeof FIGCAPTION_TAG> {\n  return createElement(FIGCAPTION_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance figcaption 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 enhanceFigcaptions(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for figcaption.\n  void root;\n}\n"],"names":["FIGCAPTION_TAG","FIGCAPTION_SELECTOR","toGlobalAttrs","attrs","aria","rest","mappedAria","createFigcaption","text","createElement","enhanceFigcaptions","root"],"mappings":";AA4DO,MAAMA,IAAiB,cAOjBC,IAAsB;AA4BnC,SAASC,EAAcC,GAAkD;AACvE,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;AAyBO,SAASE,EACdC,GACAL,GACkC;AAClC,SAAOM,EAAcT,GAAgBE,EAAcC,CAAK,GAAGK,CAAI;AACjE;AAYO,SAASE,EAAmBC,IAAmB,UAAgB;AAGtE;;;;;;;;"}

package/dist/esm/chunks/index81.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index81.js","sources":["../../../src/elements/figure/figure/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Figure element helpers.\n *\n * @remarks\n * The figure element (`<figure>`) represents self-contained content, optionally\n * with a caption provided by a nested `<figcaption>`.\n *\n * Best-practice guidance:\n * - Use `<figure>` for content referenced from the main flow but which could be\n *   moved elsewhere without affecting the document's meaning.\n * - If a caption is present, use `<figcaption>` as the first or last child.\n * - Avoid using `<figure>` purely as a styling hook.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create `<figure>` elements in vanilla JS/TS without templates\n * - apply consistent global attributes safely\n * - use a stable \"enhancement\" hook if Fundatio ever needs runtime behavior\n *\n * This module has no side effects and does not mutate the DOM unless you call\n * its functions.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/figure\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 figure.\n *\n * @category Constants\n */\nexport const FIGURE_TAG = 'figure' as const;\n\n/**\n * A CSS selector targeting figure elements.\n *\n * @category Constants\n */\nexport const FIGURE_SELECTOR = 'figure';\n\n/**\n * Attribute bag for figure creation/enhancement.\n *\n * @remarks\n * `<figure>` supports standard HTML global attributes only.\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 FigureAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link FigureAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The figure attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: FigureAttrs): 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  // Only attach `aria` if something was actually defined.\n  const hasMapped = Object.keys(mappedAria).length > 0;\n\n  return hasMapped ? { ...rest, aria: mappedAria } : rest;\n}\n\n/**\n * Create a figure 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 * Note: `<figure>` typically contains richer flow content (images, code blocks,\n * quotes, etc.). This helper supports optional text for parity with other Fundatio\n * element factories; consumers can append child nodes as needed.\n *\n * @param text - Optional text content for the figure.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<figure>` element.\n *\n * @example\n * Create a figure and append custom content:\n * ```ts\n * import { createFigure } from \"@Vastare/Fundatio/elements/figure/figure\";\n * import { createFigcaption } from \"@Vastare/Fundatio/elements/figure/figcaption\";\n *\n * const fig = createFigure(undefined, { className: \"media\" });\n * fig.appendChild(document.createElement(\"img\"));\n * fig.appendChild(createFigcaption(\"Caption\"));\n * ```\n *\n * @category DOM\n */\nexport function createFigure(text?: string, attrs?: FigureAttrs): ElementOf<typeof FIGURE_TAG> {\n  return createElement(FIGURE_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance figure 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 enhanceFigures(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for figure.\n  void root;\n}\n"],"names":["FIGURE_TAG","FIGURE_SELECTOR","toGlobalAttrs","attrs","aria","rest","mappedAria","createFigure","text","createElement","enhanceFigures","root"],"mappings":";AA8DO,MAAMA,IAAa,UAObC,IAAkB;AA4B/B,SAASC,EAAcC,GAA8C;AACnE,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,SAG7C,OAAO,KAAKE,CAAU,EAAE,SAAS,IAEhC,EAAE,GAAGD,GAAM,MAAMC,MAAeD;AACrD;AAgCO,SAASE,EAAaC,GAAeL,GAAmD;AAC7F,SAAOM,EAAcT,GAAYE,EAAcC,CAAK,GAAGK,CAAI;AAC7D;AAYO,SAASE,EAAeC,IAAmB,UAAgB;AAGlE;;;;;;;;"}

package/dist/esm/chunks/index82.js

@@ -0,0 +1,52 @@
+import { c as B } from "./dom.js";
+const s = "button", E = "button";
+function N(r) {
+  const {
+    aria: e,
+    type: l,
+    name: m,
+    value: d,
+    disabled: u,
+    autofocus: p,
+    form: b,
+    formAction: y,
+    formEnctype: g,
+    formMethod: h,
+    formNoValidate: T,
+    formTarget: O,
+    popoverTarget: v,
+    popoverTargetAction: A,
+    command: _,
+    commandFor: j,
+    ...f
+  } = r ?? {}, n = { ...f.attrs ?? {} }, t = (c, a) => {
+    a !== void 0 && (Object.prototype.hasOwnProperty.call(n, c) || (n[c] = a));
+  };
+  t("type", l ?? "button"), t("name", m), t("value", d), t("form", b), t("formaction", y), t("formenctype", g), t("formmethod", h), t("formtarget", O), t("popovertarget", v), t("popovertargetaction", A), t("command", _), t("commandfor", j), u === !0 && t("disabled", ""), p === !0 && t("autofocus", ""), T === !0 && t("formnovalidate", "");
+  const i = { ...f, attrs: n }, o = {};
+  if (e && (typeof e.label == "string" && (o.label = e.label), typeof e.labelledby == "string" && (o.labelledby = e.labelledby), typeof e.hidden == "boolean" && (o.hidden = e.hidden)), Object.keys(o).length > 0 && (i.aria = o), Object.keys(n).length === 0) {
+    const { attrs: c, ...a } = i;
+    return a;
+  }
+  return i;
+}
+function S(r, e) {
+  return B(s, N(e), r);
+}
+function U(r = document) {
+}
+const x = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  BUTTON_SELECTOR: E,
+  BUTTON_TAG: s,
+  createButton: S,
+  enhanceButtons: U
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  E as B,
+  s as a,
+  S as c,
+  U as e,
+  x as i
+};
+//# sourceMappingURL=index82.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index82.js","sources":["../../../src/elements/form/button/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Button element helpers.\n *\n * @remarks\n * The button element (`<button>`) is an interactive control that users can\n * activate via mouse, keyboard, touch, or assistive technology. :contentReference[oaicite:5]{index=5}\n *\n * Best-practice guidance:\n * - Prefer native `<button>` semantics over non-semantic elements with `role=\"button\"`.\n * - Provide an accessible name via visible text or ARIA labelling.\n * - Avoid placing interactive content inside a button (nested links/inputs/etc.).\n * - In forms, explicitly set a button `type` to avoid accidental submissions.\n *   In HTML, the default `type` is effectively `\"submit\"` in many form contexts. :contentReference[oaicite:6]{index=6}\n *\n * Fundatio-specific conventions:\n * - Defaults `type` to `\"button\"` unless the caller explicitly sets `type`\n *   (via the typed `type` field or via the raw `attrs` escape hatch).\n * - Applies global attributes via Fundatio's hardened DOM helpers (`dom.ts`),\n *   which block inline event handler attributes (e.g. `onclick`) and the raw\n *   `style` 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 * Allowed `type` values for `<button>`.\n *\n * @remarks\n * HTML supports `submit`, `reset`, and `button`. :contentReference[oaicite:7]{index=7}\n *\n * @category Attributes\n */\nexport type ButtonType = 'submit' | 'reset' | 'button';\n\n/**\n * Allowed `formenctype` values for submit buttons.\n *\n * @category Attributes\n */\nexport type ButtonFormEnctype =\n  | 'application/x-www-form-urlencoded'\n  | 'multipart/form-data'\n  | 'text/plain';\n\n/**\n * Allowed `formmethod` values for submit buttons.\n *\n * @remarks\n * `dialog` is supported for form submission to a dialog in HTML. :contentReference[oaicite:8]{index=8}\n *\n * @category Attributes\n */\nexport type ButtonFormMethod = 'get' | 'post' | 'dialog';\n\n/**\n * Allowed `popovertargetaction` values for popover trigger buttons.\n *\n * @remarks\n * Mirrors the `popovertargetaction` attribute. :contentReference[oaicite:9]{index=9}\n *\n * @category Attributes\n */\nexport type PopoverTargetAction = 'toggle' | 'show' | 'hide';\n\n/**\n * The semantic tag name for buttons.\n *\n * @category Constants\n */\nexport const BUTTON_TAG = 'button' as const;\n\n/**\n * A CSS selector targeting button elements.\n *\n * @category Constants\n */\nexport const BUTTON_SELECTOR = 'button';\n\n/**\n * Attribute bag for button creation/enhancement.\n *\n * @remarks\n * `<button>` supports global attributes plus button/form-associated attributes.\n * This type models the most commonly used attributes in a typed way, while still\n * providing {@link GlobalAttrs.attrs} as an escape hatch (validated by `dom.ts`).\n *\n * Notes:\n * - `type` defaults to `\"button\"` in Fundatio to avoid accidental form submission.\n * - Boolean attributes are applied by presence (empty string) when `true`.\n * - `command` and `commandfor` are part of the HTML Invoker Commands model. :contentReference[oaicite:10]{index=10}\n *\n * @category Attributes\n */\nexport type ButtonAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n\n  /**\n   * The button type. Fundatio defaults to `\"button\"` when not provided.\n   */\n  type?: ButtonType;\n\n  /**\n   * The button name (used during form submission).\n   */\n  name?: string;\n\n  /**\n   * The button value (used during form submission).\n   */\n  value?: string;\n\n  /**\n   * Disables the button when true.\n   */\n  disabled?: boolean;\n\n  /**\n   * Autofocus hint.\n   */\n  autofocus?: boolean;\n\n  /**\n   * Associates the button with a form element by ID.\n   */\n  form?: string;\n\n  /**\n   * Overrides the form `action` for submit buttons.\n   */\n  formAction?: string;\n\n  /**\n   * Overrides the form encoding type for submit buttons.\n   */\n  formEnctype?: ButtonFormEnctype;\n\n  /**\n   * Overrides the form HTTP method for submit buttons.\n   */\n  formMethod?: ButtonFormMethod;\n\n  /**\n   * When true, prevents constraint validation on submission.\n   */\n  formNoValidate?: boolean;\n\n  /**\n   * Overrides the form target for submission.\n   *\n   * @remarks\n   * Can be a special keyword like `_blank` or a named browsing context.\n   */\n  formTarget?: string;\n\n  /**\n   * ID of the popover element this button targets.\n   */\n  popoverTarget?: string;\n\n  /**\n   * Action to perform on the targeted popover.\n   */\n  popoverTargetAction?: PopoverTargetAction;\n\n  /**\n   * Invoker Commands: the command name.\n   */\n  command?: string;\n\n  /**\n   * Invoker Commands: the element ID to invoke/control.\n   */\n  commandFor?: string;\n};\n\n/**\n * Normalize {@link ButtonAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @remarks\n * This follows the same pattern used by other attribute-rich modules (e.g. iframe):\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?: ButtonAttrs): GlobalAttrs {\n  const {\n    aria,\n    type,\n    name,\n    value,\n    disabled,\n    autofocus,\n    form,\n    formAction,\n    formEnctype,\n    formMethod,\n    formNoValidate,\n    formTarget,\n    popoverTarget,\n    popoverTargetAction,\n    command,\n    commandFor,\n    ...rest\n  } = attrs ?? {};\n\n  // Start with any caller-provided attrs escape hatch (still validated by dom.ts).\n  const mergedAttrs: Record<string, AttrValue> = { ...(rest.attrs ?? {}) };\n\n  // Helper: only set if caller didn't already set the raw attribute explicitly.\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  // Fundatio safety: default to type=\"button\" unless caller explicitly overrides it.\n  setIfUnset('type', type ?? 'button');\n\n  setIfUnset('name', name);\n  setIfUnset('value', value);\n  setIfUnset('form', form);\n  setIfUnset('formaction', formAction);\n  setIfUnset('formenctype', formEnctype);\n  setIfUnset('formmethod', formMethod);\n  setIfUnset('formtarget', formTarget);\n  setIfUnset('popovertarget', popoverTarget);\n  setIfUnset('popovertargetaction', popoverTargetAction);\n  setIfUnset('command', command);\n  setIfUnset('commandfor', commandFor);\n\n  // Boolean attributes are represented by presence. We set empty-string when true.\n  if (disabled === true) setIfUnset('disabled', '');\n  if (autofocus === true) setIfUnset('autofocus', '');\n  if (formNoValidate === true) setIfUnset('formnovalidate', '');\n\n  const mapped: GlobalAttrs = { ...rest, attrs: mergedAttrs };\n\n  const mappedAria: NonNullable<GlobalAttrs['aria']> = {};\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  // If mergedAttrs ended up empty, avoid attaching it.\n  if (Object.keys(mergedAttrs).length === 0) {\n    const { attrs: _unused, ...withoutAttrs } = mapped;\n    return withoutAttrs;\n  }\n\n  return mapped;\n}\n\n/**\n * Create a button element with optional text content and attributes.\n *\n * @remarks\n * - Text content is assigned via `textContent` (never `innerHTML`).\n * - Fundatio defaults `type` to `\"button\"` to reduce accidental form submissions. :contentReference[oaicite:11]{index=11}\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 text - Optional text content for the button.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<button>` element.\n *\n * @example\n * ```ts\n * import { createButton } from \"@Vastare/Fundatio/elements/form/button\";\n *\n * document.body.appendChild(createButton(\"Save\", { className: \"btn\" }));\n * ```\n *\n * @category DOM\n */\nexport function createButton(text?: string, attrs?: ButtonAttrs): ElementOf<typeof BUTTON_TAG> {\n  return createElement(BUTTON_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance button 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 enhanceButtons(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for button.\n  void root;\n}\n"],"names":["BUTTON_TAG","BUTTON_SELECTOR","toGlobalAttrs","attrs","aria","type","name","value","disabled","autofocus","form","formAction","formEnctype","formMethod","formNoValidate","formTarget","popoverTarget","popoverTargetAction","command","commandFor","rest","mergedAttrs","setIfUnset","key","v","mapped","mappedAria","_unused","withoutAttrs","createButton","text","createElement","enhanceButtons","root"],"mappings":";AAqGO,MAAMA,IAAa,UAObC,IAAkB;AAiH/B,SAASC,EAAcC,GAAkC;AACvD,QAAM;AAAA,IACJ,MAAAC;AAAA,IACA,MAAAC;AAAA,IACA,MAAAC;AAAA,IACA,OAAAC;AAAA,IACA,UAAAC;AAAA,IACA,WAAAC;AAAA,IACA,MAAAC;AAAA,IACA,YAAAC;AAAA,IACA,aAAAC;AAAA,IACA,YAAAC;AAAA,IACA,gBAAAC;AAAA,IACA,YAAAC;AAAA,IACA,eAAAC;AAAA,IACA,qBAAAC;AAAA,IACA,SAAAC;AAAA,IACA,YAAAC;AAAA,IACA,GAAGC;AAAA,EAAA,IACDjB,KAAS,CAAA,GAGPkB,IAAyC,EAAE,GAAID,EAAK,SAAS,CAAA,EAAC,GAG9DE,IAAa,CAACC,GAAaC,MAAmC;AAClE,IAAIA,MAAM,WACN,OAAO,UAAU,eAAe,KAAKH,GAAaE,CAAG,MACzDF,EAAYE,CAAG,IAAIC;AAAA,EACrB;AAGA,EAAAF,EAAW,QAAQjB,KAAQ,QAAQ,GAEnCiB,EAAW,QAAQhB,CAAI,GACvBgB,EAAW,SAASf,CAAK,GACzBe,EAAW,QAAQZ,CAAI,GACvBY,EAAW,cAAcX,CAAU,GACnCW,EAAW,eAAeV,CAAW,GACrCU,EAAW,cAAcT,CAAU,GACnCS,EAAW,cAAcP,CAAU,GACnCO,EAAW,iBAAiBN,CAAa,GACzCM,EAAW,uBAAuBL,CAAmB,GACrDK,EAAW,WAAWJ,CAAO,GAC7BI,EAAW,cAAcH,CAAU,GAG/BX,MAAa,MAAMc,EAAW,YAAY,EAAE,GAC5Cb,MAAc,MAAMa,EAAW,aAAa,EAAE,GAC9CR,MAAmB,MAAMQ,EAAW,kBAAkB,EAAE;AAE5D,QAAMG,IAAsB,EAAE,GAAGL,GAAM,OAAOC,EAAA,GAExCK,IAA+C,CAAA;AAYrD,MAXItB,MACE,OAAOA,EAAK,SAAU,aAAUsB,EAAW,QAAQtB,EAAK,QACxD,OAAOA,EAAK,cAAe,aAAUsB,EAAW,aAAatB,EAAK,aAClE,OAAOA,EAAK,UAAW,cAAWsB,EAAW,SAAStB,EAAK,UAG7D,OAAO,KAAKsB,CAAU,EAAE,SAAS,MACnCD,EAAO,OAAOC,IAIZ,OAAO,KAAKL,CAAW,EAAE,WAAW,GAAG;AACzC,UAAM,EAAE,OAAOM,GAAS,GAAGC,MAAiBH;AAC5C,WAAOG;AAAA,EACT;AAEA,SAAOH;AACT;AAyBO,SAASI,EAAaC,GAAe3B,GAAmD;AAC7F,SAAO4B,EAAc/B,GAAYE,EAAcC,CAAK,GAAG2B,CAAI;AAC7D;AAYO,SAASE,EAAeC,IAAmB,UAAgB;AAGlE;;;;;;;;"}

package/dist/esm/chunks/index83.js

@@ -0,0 +1,29 @@
+import { c as o } from "./dom.js";
+const l = "datalist", i = "datalist";
+function r(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 o(l, r(e), t);
+}
+function d(t = document) {
+}
+const f = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  DATALIST_SELECTOR: i,
+  DATALIST_TAG: l,
+  createDatalist: s,
+  enhanceDatalists: d
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  i as D,
+  l as a,
+  s as c,
+  d as e,
+  f as i
+};
+//# sourceMappingURL=index83.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index83.js","sources":["../../../src/elements/form/datalist/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Datalist element helpers.\n *\n * @remarks\n * The datalist element (`<datalist>`) contains a set of `<option>` elements that\n * represent permissible or recommended values for an associated form control\n * (most commonly an `<input>`), connected via the input's `list` attribute.\n *\n * Best-practice guidance:\n * - Pair a `<datalist>` with an `<input>` using a stable, unique `id` on the\n *   datalist and a matching `list` attribute on the input.\n * - Use `<datalist>` for suggestions, not strict validation. If users must pick\n *   from a fixed set, prefer `<select>`.\n * - Populate suggestions using descendant `<option>` elements, typically with\n *   `value` attributes.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create `<datalist>` elements in vanilla JS/TS without templates\n * - apply consistent global attributes safely\n * - use a stable \"enhancement\" hook if Fundatio ever needs runtime behavior\n *\n * This module has no side effects and does not mutate the DOM unless you call\n * its functions.\n *\n * Attributes:\n * - `<datalist>` supports global attributes only (no element-specific content\n *   attributes).\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/datalist\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 datalist.\n *\n * @category Constants\n */\nexport const DATALIST_TAG = 'datalist' as const;\n\n/**\n * A CSS selector targeting datalist elements.\n *\n * @category Constants\n */\nexport const DATALIST_SELECTOR = 'datalist';\n\n/**\n * Attribute bag for datalist creation/enhancement.\n *\n * @remarks\n * Datalist elements accept 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 DatalistAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link DatalistAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The datalist attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: DatalistAttrs): 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  // Only attach `aria` if something was actually defined.\n  const hasMapped = Object.keys(mappedAria).length > 0;\n\n  return hasMapped ? { ...rest, aria: mappedAria } : rest;\n}\n\n/**\n * Create a datalist element with optional text content and global attributes.\n *\n * @remarks\n * While `<datalist>` is typically populated with `<option>` children, this helper\n * follows Fundatio's consistent \"optional text\" factory signature for non-void elements.\n *\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 datalist (rare, but supported).\n * @param attrs - Optional attributes to apply.\n * @returns The created `<datalist>` element.\n *\n * @example\n * ```ts\n * import { createDatalist } from \"@Vastare/Fundatio/elements/form/datalist\";\n *\n * const dl = createDatalist(undefined, { id: \"city-list\" });\n * document.body.appendChild(dl);\n * ```\n *\n * @category DOM\n */\nexport function createDatalist(\n  text?: string,\n  attrs?: DatalistAttrs,\n): ElementOf<typeof DATALIST_TAG> {\n  return createElement(DATALIST_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance datalist 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 enhanceDatalists(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for datalist.\n  void root;\n}\n"],"names":["DATALIST_TAG","DATALIST_SELECTOR","toGlobalAttrs","attrs","aria","rest","mappedAria","createDatalist","text","createElement","enhanceDatalists","root"],"mappings":";AA0EO,MAAMA,IAAe,YAOfC,IAAoB;AA4BjC,SAASC,EAAcC,GAAgD;AACrE,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,SAG7C,OAAO,KAAKE,CAAU,EAAE,SAAS,IAEhC,EAAE,GAAGD,GAAM,MAAMC,MAAeD;AACrD;AA4BO,SAASE,EACdC,GACAL,GACgC;AAChC,SAAOM,EAAcT,GAAcE,EAAcC,CAAK,GAAGK,CAAI;AAC/D;AAoBO,SAASE,EAAiBC,IAAmB,UAAgB;AAGpE;;;;;;;;"}

package/dist/esm/chunks/index84.js

@@ -0,0 +1,33 @@
+import { c as m } from "./dom.js";
+const d = "fieldset", y = "fieldset";
+function h(t) {
+  if (!t) return;
+  const { aria: e, disabled: c, form: f, name: b, ...a } = t, r = { ...a.attrs ?? {} }, o = (i, l) => {
+    l !== void 0 && (Object.prototype.hasOwnProperty.call(r, i) || (r[i] = l));
+  };
+  o("form", f), o("name", b), c === !0 && o("disabled", "");
+  const n = {};
+  e && (typeof e.label == "string" && (n.label = e.label), typeof e.labelledby == "string" && (n.labelledby = e.labelledby), typeof e.hidden == "boolean" && (n.hidden = e.hidden));
+  const p = Object.keys(n).length > 0, u = Object.keys(r).length > 0, s = { ...a };
+  return u && (s.attrs = r), p && (s.aria = n), s;
+}
+function g(t, e) {
+  return m(d, h(e), t);
+}
+function E(t = document) {
+}
+const A = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  FIELDSET_SELECTOR: y,
+  FIELDSET_TAG: d,
+  createFieldset: g,
+  enhanceFieldsets: E
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  y as F,
+  d as a,
+  g as c,
+  E as e,
+  A as i
+};
+//# sourceMappingURL=index84.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index84.js","sources":["../../../src/elements/form/fieldset/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Fieldset element helpers.\n *\n * @remarks\n * The fieldset element (`<fieldset>`) groups related form controls, typically\n * with a `<legend>` that provides an accessible label for the group.\n *\n * Best-practice guidance:\n * - Use `<fieldset>` to group related controls (e.g. radio button sets).\n * - Prefer a meaningful `<legend>` as the first child to label the group.\n * - Do not use `<fieldset>` purely for layout; use CSS for visual grouping.\n *\n * Attribute behavior notes:\n * - When `disabled` is set on a `<fieldset>`, user agents disable descendant\n *   form controls, except those that are descendants of the fieldset's first\n *   `<legend>` child (if any). This is native platform behavior.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create fieldsets in vanilla JS/TS without templates\n * - apply consistent global attributes safely\n * - use a stable \"enhancement\" hook if Fundatio ever needs runtime behavior\n *\n * This module has no side effects and does not mutate the DOM unless you call\n * its functions.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/fieldset\n * @see https://www.w3.org/WAI/tutorials/forms/grouping/\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 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 fieldset groups.\n *\n * @category Constants\n */\nexport const FIELDSET_TAG = 'fieldset' as const;\n\n/**\n * A CSS selector targeting fieldset elements.\n *\n * @category Constants\n */\nexport const FIELDSET_SELECTOR = 'fieldset';\n\n/**\n * Attribute bag for fieldset creation/enhancement.\n *\n * @remarks\n * Fieldset accepts standard HTML global attributes plus fieldset-specific\n * attributes (`disabled`, `form`, `name`).\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 FieldsetAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n\n  /**\n   * Disables descendant form controls (native platform behavior).\n   *\n   * @remarks\n   * When set, controls inside the first `<legend>` (if present) are typically\n   * excluded from disabling per spec/user agent behavior.\n   */\n  disabled?: boolean;\n\n  /**\n   * Associates the fieldset with a form element by ID, even if not a descendant.\n   */\n  form?: string;\n\n  /**\n   * Name of the fieldset (submitted/associated in form processing contexts).\n   */\n  name?: string;\n};\n\n/**\n * Normalize {@link FieldsetAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The fieldset attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: FieldsetAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, disabled, form, name, ...rest } = attrs;\n\n  // Start with any caller-provided attrs escape hatch (still validated by dom.ts).\n  const mergedAttrs: Record<string, AttrValue> = { ...(rest.attrs ?? {}) };\n\n  const setIfUnset = (key: string, value: AttrValue | undefined): void => {\n    if (value === undefined) return;\n    if (Object.prototype.hasOwnProperty.call(mergedAttrs, key)) return;\n    mergedAttrs[key] = value;\n  };\n\n  setIfUnset('form', form);\n  setIfUnset('name', name);\n\n  // Boolean attributes are represented by presence. We set empty-string when true.\n  if (disabled === true) setIfUnset('disabled', '');\n\n  const mappedAria: NonNullable<GlobalAttrs['aria']> = {};\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  const hasMappedAria = Object.keys(mappedAria).length > 0;\n  const hasMergedAttrs = Object.keys(mergedAttrs).length > 0;\n\n  const next: GlobalAttrs = { ...rest };\n  if (hasMergedAttrs) next.attrs = mergedAttrs;\n  if (hasMappedAria) next.aria = mappedAria;\n\n  return next;\n}\n\n/**\n * Create a fieldset 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 fieldset (rare; most fieldsets contain child nodes).\n * @param attrs - Optional attributes to apply.\n * @returns The created `<fieldset>` element.\n *\n * @example\n * ```ts\n * import { createFieldset } from \"@Vastare/Fundatio/elements/form/fieldset\";\n *\n * const fs = createFieldset(undefined, { disabled: false });\n * // fs.appendChild(createLegend(\"Shipping address\"));\n * ```\n *\n * @category DOM\n */\nexport function createFieldset(\n  text?: string,\n  attrs?: FieldsetAttrs,\n): ElementOf<typeof FIELDSET_TAG> {\n  return createElement(FIELDSET_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance fieldset 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 enhanceFieldsets(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for fieldset.\n  void root;\n}\n"],"names":["FIELDSET_TAG","FIELDSET_SELECTOR","toGlobalAttrs","attrs","aria","disabled","form","name","rest","mergedAttrs","setIfUnset","key","value","mappedAria","hasMappedAria","hasMergedAttrs","next","createFieldset","text","createElement","enhanceFieldsets","root"],"mappings":";AAmEO,MAAMA,IAAe,YAOfC,IAAoB;AAgDjC,SAASC,EAAcC,GAAgD;AACrE,MAAI,CAACA,EAAO;AAEZ,QAAM,EAAE,MAAAC,GAAM,UAAAC,GAAU,MAAAC,GAAM,MAAAC,GAAM,GAAGC,MAASL,GAG1CM,IAAyC,EAAE,GAAID,EAAK,SAAS,CAAA,EAAC,GAE9DE,IAAa,CAACC,GAAaC,MAAuC;AACtE,IAAIA,MAAU,WACV,OAAO,UAAU,eAAe,KAAKH,GAAaE,CAAG,MACzDF,EAAYE,CAAG,IAAIC;AAAA,EACrB;AAEA,EAAAF,EAAW,QAAQJ,CAAI,GACvBI,EAAW,QAAQH,CAAI,GAGnBF,MAAa,MAAMK,EAAW,YAAY,EAAE;AAEhD,QAAMG,IAA+C,CAAA;AACrD,EAAIT,MACE,OAAOA,EAAK,SAAU,aAAUS,EAAW,QAAQT,EAAK,QACxD,OAAOA,EAAK,cAAe,aAAUS,EAAW,aAAaT,EAAK,aAClE,OAAOA,EAAK,UAAW,cAAWS,EAAW,SAAST,EAAK;AAGjE,QAAMU,IAAgB,OAAO,KAAKD,CAAU,EAAE,SAAS,GACjDE,IAAiB,OAAO,KAAKN,CAAW,EAAE,SAAS,GAEnDO,IAAoB,EAAE,GAAGR,EAAA;AAC/B,SAAIO,QAAqB,QAAQN,IAC7BK,QAAoB,OAAOD,IAExBG;AACT;AAyBO,SAASC,EACdC,GACAf,GACgC;AAChC,SAAOgB,EAAcnB,GAAcE,EAAcC,CAAK,GAAGe,CAAI;AAC/D;AAoBO,SAASE,EAAiBC,IAAmB,UAAgB;AAGpE;;;;;;;;"}

package/dist/esm/chunks/index85.js

@@ -0,0 +1,45 @@
+import { c as _ } from "./dom.js";
+const s = "form", j = "form";
+function F(o) {
+  if (!o) return;
+  const {
+    aria: e,
+    action: d,
+    method: f,
+    enctype: p,
+    acceptCharset: b,
+    autocomplete: m,
+    name: u,
+    noValidate: h,
+    target: y,
+    rel: g,
+    ...c
+  } = o, n = { ...c.attrs ?? {} }, t = (i, l) => {
+    l !== void 0 && (Object.prototype.hasOwnProperty.call(n, i) || (n[i] = l));
+  };
+  t("action", d), t("method", f), t("enctype", p), t("accept-charset", b), t("autocomplete", m), t("name", u), t("target", y), t("rel", g), h === !0 && t("novalidate", "");
+  const a = {};
+  e && (typeof e.label == "string" && (a.label = e.label), typeof e.labelledby == "string" && (a.labelledby = e.labelledby), typeof e.hidden == "boolean" && (a.hidden = e.hidden));
+  const O = Object.keys(a).length > 0, A = Object.keys(n).length > 0, r = { ...c };
+  return A && (r.attrs = n), O && (r.aria = a), r;
+}
+function M(o, e) {
+  return _(s, F(e), o);
+}
+function v(o = document) {
+}
+const E = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  FORM_SELECTOR: j,
+  FORM_TAG: s,
+  createForm: M,
+  enhanceForms: v
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  j as F,
+  s as a,
+  M as c,
+  v as e,
+  E as i
+};
+//# sourceMappingURL=index85.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index85.js","sources":["../../../src/elements/form/form/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Form element helpers.\n *\n * @remarks\n * The form element (`<form>`) groups interactive controls for submitting data.\n *\n * Best-practice guidance:\n * - Prefer HTTPS endpoints for `action` to protect user data in transit.\n * - Use `method=\"post\"` for submissions that change server state or include sensitive data.\n * - Use `enctype=\"multipart/form-data\"` when uploading files.\n * - Provide explicit labels for controls and ensure accessible naming.\n * - Consider `rel=\"noopener\"` when using `target=\"_blank\"` to avoid `window.opener` exposure.\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: `<form>` element :contentReference[oaicite:3]{index=3}\n * - WHATWG HTML: Forms & submission attributes :contentReference[oaicite:4]{index=4}\n * - MDN: `rel` on `<form>` / `noopener` :contentReference[oaicite:5]{index=5}\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 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 forms.\n *\n * @category Constants\n */\nexport const FORM_TAG = 'form' as const;\n\n/**\n * A CSS selector targeting form elements.\n *\n * @category Constants\n */\nexport const FORM_SELECTOR = 'form';\n\n/**\n * Allowed values for the form `method` attribute.\n *\n * @remarks\n * HTML supports `get`, `post`, and `dialog` (for dialog-associated forms).\n *\n * @category Types\n */\nexport type FormMethod = 'get' | 'post' | 'dialog';\n\n/**\n * Allowed values for the form `enctype` attribute.\n *\n * @category Types\n */\nexport type FormEnctype =\n  | 'application/x-www-form-urlencoded'\n  | 'multipart/form-data'\n  | 'text/plain';\n\n/**\n * Allowed values for the form `autocomplete` attribute.\n *\n * @category Types\n */\nexport type FormAutocomplete = 'on' | 'off';\n\n/**\n * Attribute bag for form creation/enhancement.\n *\n * @remarks\n * `<form>` supports standard HTML global attributes plus submission-related\n * attributes (action, method, enctype, target, etc.).\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 FormAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * URL that processes the form submission.\n   *\n   * @remarks\n   * If omitted, the user agent submits to the current document URL.\n   */\n  action?: string;\n\n  /**\n   * HTTP method used to submit the form.\n   *\n   * @remarks\n   * Valid values are `get`, `post`, and `dialog`.\n   */\n  method?: FormMethod;\n\n  /**\n   * Encoding type for the form submission.\n   *\n   * @remarks\n   * Use `multipart/form-data` when uploading files.\n   */\n  enctype?: FormEnctype;\n\n  /**\n   * Character encodings that are acceptable for server processing.\n   *\n   * @remarks\n   * Maps to the `accept-charset` attribute.\n   */\n  acceptCharset?: string;\n\n  /**\n   * Whether the browser may autofill this form.\n   */\n  autocomplete?: FormAutocomplete;\n\n  /**\n   * Name of the form, used for referencing the form in scripts and documents.\n   */\n  name?: string;\n\n  /**\n   * Disable constraint validation when submitting the form.\n   *\n   * @remarks\n   * Maps to the boolean `novalidate` attribute (represented by attribute presence).\n   */\n  noValidate?: boolean;\n\n  /**\n   * Where to display the response after submitting the form.\n   *\n   * @remarks\n   * Common values: `_self`, `_blank`, `_parent`, `_top`, or a named browsing context.\n   */\n  target?: '_self' | '_blank' | '_parent' | '_top' | (string & {});\n\n  /**\n   * Relationship (link types) for the form submission when `target` creates a new context.\n   *\n   * @remarks\n   * This is a space-separated list of tokens (e.g. `noopener noreferrer`).\n   */\n  rel?: string;\n\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link FormAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @remarks\n * - Preserves caller-provided `attrs` escape hatch (still validated by `dom.ts`).\n * - Element-specific attributes are merged into `attrs` without overwriting keys\n *   explicitly provided by the caller.\n * - Boolean attributes are represented by presence; we set empty-string when true.\n *\n * @param attrs - The form attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: FormAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const {\n    aria,\n    action,\n    method,\n    enctype,\n    acceptCharset,\n    autocomplete,\n    name,\n    noValidate,\n    target,\n    rel,\n    ...rest\n  } = attrs;\n\n  // Start with any caller-provided attrs escape hatch (it is still validated by dom.ts).\n  const mergedAttrs: Record<string, AttrValue> = { ...(rest.attrs ?? {}) };\n\n  // Helper: only set if caller didn't already set the raw attribute explicitly.\n  const setIfUnset = (key: string, value: AttrValue | undefined): void => {\n    if (value === undefined) return;\n    if (Object.prototype.hasOwnProperty.call(mergedAttrs, key)) return;\n    mergedAttrs[key] = value;\n  };\n\n  setIfUnset('action', action);\n  setIfUnset('method', method);\n  setIfUnset('enctype', enctype);\n  setIfUnset('accept-charset', acceptCharset);\n  setIfUnset('autocomplete', autocomplete);\n  setIfUnset('name', name);\n  setIfUnset('target', target);\n  setIfUnset('rel', rel);\n\n  // Boolean attributes are represented by presence. We set empty-string when true.\n  if (noValidate === true) setIfUnset('novalidate', '');\n\n  const mappedAria: NonNullable<GlobalAttrs['aria']> = {};\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  const hasMappedAria = Object.keys(mappedAria).length > 0;\n  const hasMergedAttrs = Object.keys(mergedAttrs).length > 0;\n\n  const next: GlobalAttrs = { ...rest };\n  if (hasMergedAttrs) next.attrs = mergedAttrs;\n  if (hasMappedAria) next.aria = mappedAria;\n\n  return next;\n}\n\n/**\n * Create a form element with optional fallback text and attributes.\n *\n * @remarks\n * - Fallback text 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 form (rare, but supported for parity).\n * @param attrs - Optional attributes to apply.\n * @returns The created `<form>` element.\n *\n * @example\n * ```ts\n * import { createForm } from \"@Vastare/Fundatio/elements/form/form\";\n *\n * const form = createForm(undefined, {\n *   action: \"/submit\",\n *   method: \"post\",\n *   enctype: \"application/x-www-form-urlencoded\",\n * });\n * document.body.appendChild(form);\n * ```\n *\n * @category DOM\n */\nexport function createForm(text?: string, attrs?: FormAttrs): ElementOf<typeof FORM_TAG> {\n  return createElement(FORM_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance form 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 enhanceForms(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for form.\n  void root;\n}\n"],"names":["FORM_TAG","FORM_SELECTOR","toGlobalAttrs","attrs","aria","action","method","enctype","acceptCharset","autocomplete","name","noValidate","target","rel","rest","mergedAttrs","setIfUnset","key","value","mappedAria","hasMappedAria","hasMergedAttrs","next","createForm","text","createElement","enhanceForms","root"],"mappings":";AAgEO,MAAMA,IAAW,QAOXC,IAAgB;AAgI7B,SAASC,EAAcC,GAA4C;AACjE,MAAI,CAACA,EAAO;AAEZ,QAAM;AAAA,IACJ,MAAAC;AAAA,IACA,QAAAC;AAAA,IACA,QAAAC;AAAA,IACA,SAAAC;AAAA,IACA,eAAAC;AAAA,IACA,cAAAC;AAAA,IACA,MAAAC;AAAA,IACA,YAAAC;AAAA,IACA,QAAAC;AAAA,IACA,KAAAC;AAAA,IACA,GAAGC;AAAA,EAAA,IACDX,GAGEY,IAAyC,EAAE,GAAID,EAAK,SAAS,CAAA,EAAC,GAG9DE,IAAa,CAACC,GAAaC,MAAuC;AACtE,IAAIA,MAAU,WACV,OAAO,UAAU,eAAe,KAAKH,GAAaE,CAAG,MACzDF,EAAYE,CAAG,IAAIC;AAAA,EACrB;AAEA,EAAAF,EAAW,UAAUX,CAAM,GAC3BW,EAAW,UAAUV,CAAM,GAC3BU,EAAW,WAAWT,CAAO,GAC7BS,EAAW,kBAAkBR,CAAa,GAC1CQ,EAAW,gBAAgBP,CAAY,GACvCO,EAAW,QAAQN,CAAI,GACvBM,EAAW,UAAUJ,CAAM,GAC3BI,EAAW,OAAOH,CAAG,GAGjBF,MAAe,MAAMK,EAAW,cAAc,EAAE;AAEpD,QAAMG,IAA+C,CAAA;AACrD,EAAIf,MACE,OAAOA,EAAK,SAAU,aAAUe,EAAW,QAAQf,EAAK,QACxD,OAAOA,EAAK,cAAe,aAAUe,EAAW,aAAaf,EAAK,aAClE,OAAOA,EAAK,UAAW,cAAWe,EAAW,SAASf,EAAK;AAGjE,QAAMgB,IAAgB,OAAO,KAAKD,CAAU,EAAE,SAAS,GACjDE,IAAiB,OAAO,KAAKN,CAAW,EAAE,SAAS,GAEnDO,IAAoB,EAAE,GAAGR,EAAA;AAC/B,SAAIO,QAAqB,QAAQN,IAC7BK,QAAoB,OAAOD,IAExBG;AACT;AA6BO,SAASC,EAAWC,GAAerB,GAA+C;AACvF,SAAOsB,EAAczB,GAAUE,EAAcC,CAAK,GAAGqB,CAAI;AAC3D;AAoBO,SAASE,EAAaC,IAAmB,UAAgB;AAGhE;;;;;;;;"}