@vastare/fundatio 0.1.0

package/dist/esm/chunks/index30.js

@@ -0,0 +1,37 @@
+import { a as c } from "./dom.js";
+const l = "col", f = "col";
+function b(t) {
+  if (!t) return;
+  const { aria: e, span: r, attrs: i, ...s } = t, a = { ...s };
+  if (e) {
+    const o = {};
+    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 && (a.aria = o);
+  }
+  const n = { ...i ?? {} };
+  if (typeof r == "number" && !Object.prototype.hasOwnProperty.call(n, "span")) {
+    if (!Number.isInteger(r) || r <= 0)
+      throw new Error('Invalid "span" for <col>: expected a positive integer greater than zero.');
+    n.span = r;
+  }
+  return Object.keys(n).length > 0 && (a.attrs = n), a;
+}
+function d(t) {
+  return c(l, b(t));
+}
+function p(t = document) {
+}
+const y = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  COL_SELECTOR: f,
+  COL_TAG: l,
+  createCol: d,
+  enhanceCols: p
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  f as C,
+  l as a,
+  d as c,
+  p as e,
+  y as i
+};
+//# sourceMappingURL=index30.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index30.js","sources":["../../../src/elements/table/col/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Col element helpers.\n *\n * @remarks\n * The col element (`<col>`) represents one or more columns in a table, and is\n * used to apply presentation (typically CSS) to columns as a group.\n *\n * Best-practice guidance:\n * - Use `<col>` only inside a `<colgroup>`.\n * - Use `<col>` for column-level styling (widths, background, etc.), not layout hacks.\n * - Don't rely on `<col>` for semantics or accessibility. Use proper table\n *   structure (`<caption>`, `<th>`, `scope`/`headers`) for accessible data tables.\n * - Avoid obsolete presentational attributes; prefer CSS.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create `<col>` 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 * References:\n * - MDN: `<col>`: https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/col\n * - WHATWG HTML: Tables: https://html.spec.whatwg.org/multipage/tables.html\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 * @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 table column definitions.\n *\n * @category Constants\n */\nexport const COL_TAG = 'col' as const;\n\n/**\n * A CSS selector targeting col elements.\n *\n * @category Constants\n */\nexport const COL_SELECTOR = 'col';\n\n/**\n * Attribute bag for col creation/enhancement.\n *\n * @remarks\n * `<col>` supports standard HTML global attributes and one primary element\n * attribute: `span`.\n *\n * `span` specifies how many consecutive columns this `<col>` applies to.\n * If omitted, browsers treat it as `1`.\n *\n * Fundatio supports a structured ARIA input for common ARIA fields, mapped into\n * {@link GlobalAttrs.aria}.\n *\n * @category Attributes\n */\nexport type ColAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n\n  /**\n   * Number of consecutive columns this `<col>` element applies to.\n   *\n   * @remarks\n   * Must be a positive integer greater than zero. If omitted, the browser default\n   * is `1`.\n   */\n  span?: number;\n};\n\n/**\n * Normalize {@link ColAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The col attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: ColAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, span, attrs: rawAttrs, ...rest } = attrs;\n\n  const out: GlobalAttrs = { ...rest };\n\n  // Map structured ARIA, only if something is actually defined.\n  if (aria) {\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    if (Object.keys(mappedAria).length > 0) out.aria = mappedAria;\n  }\n\n  // Preserve caller escape hatch, but allow Fundatio-typed fields to fill gaps.\n  const mergedAttrs: NonNullable<GlobalAttrs['attrs']> = { ...(rawAttrs ?? {}) };\n\n  // Only set `span` if provided AND caller didn't already set it via raw attrs.\n  if (typeof span === 'number' && !Object.prototype.hasOwnProperty.call(mergedAttrs, 'span')) {\n    // Spec constraint: positive integer > 0.\n    if (!Number.isInteger(span) || span <= 0) {\n      throw new Error('Invalid \"span\" for <col>: expected a positive integer greater than zero.');\n    }\n    mergedAttrs.span = span;\n  }\n\n  if (Object.keys(mergedAttrs).length > 0) out.attrs = mergedAttrs;\n\n  return out;\n}\n\n/**\n * Create a col element (`<col>`) and apply global attributes.\n *\n * @remarks\n * `<col>` is a void element. It does not accept text content or children.\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 `<col>` element.\n *\n * @example\n * Create a `<col>` that spans 2 columns:\n * ```ts\n * import { createCol } from \"@Vastare/Fundatio/elements/table/col\";\n *\n * const col = createCol({ span: 2, className: \"numeric\" });\n * ```\n *\n * @category DOM\n */\nexport function createCol(attrs?: ColAttrs): ElementOf<typeof COL_TAG> {\n  return createVoidElement(COL_TAG, toGlobalAttrs(attrs));\n}\n\n/**\n * Enhance col 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 enhanceCols(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for col.\n  void root;\n}\n"],"names":["COL_TAG","COL_SELECTOR","toGlobalAttrs","attrs","aria","span","rawAttrs","rest","out","mappedAria","mergedAttrs","createCol","createVoidElement","enhanceCols","root"],"mappings":";AAiEO,MAAMA,IAAU,OAOVC,IAAe;AAyC5B,SAASC,EAAcC,GAA2C;AAChE,MAAI,CAACA,EAAO;AAEZ,QAAM,EAAE,MAAAC,GAAM,MAAAC,GAAM,OAAOC,GAAU,GAAGC,MAASJ,GAE3CK,IAAmB,EAAE,GAAGD,EAAA;AAG9B,MAAIH,GAAM;AACR,UAAMK,IAA+C,CAAA;AAErD,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,QAAO,OAAOA;AAAA,EACrD;AAGA,QAAMC,IAAiD,EAAE,GAAIJ,KAAY,GAAC;AAG1E,MAAI,OAAOD,KAAS,YAAY,CAAC,OAAO,UAAU,eAAe,KAAKK,GAAa,MAAM,GAAG;AAE1F,QAAI,CAAC,OAAO,UAAUL,CAAI,KAAKA,KAAQ;AACrC,YAAM,IAAI,MAAM,0EAA0E;AAE5F,IAAAK,EAAY,OAAOL;AAAA,EACrB;AAEA,SAAI,OAAO,KAAKK,CAAW,EAAE,SAAS,QAAO,QAAQA,IAE9CF;AACT;AAyBO,SAASG,EAAUR,GAA6C;AACrE,SAAOS,EAAkBZ,GAASE,EAAcC,CAAK,CAAC;AACxD;AAYO,SAASU,EAAYC,IAAmB,UAAgB;AAG/D;;;;;;;;"}

package/dist/esm/chunks/index31.js

@@ -0,0 +1,29 @@
+import { c as l } from "./dom.js";
+const o = "thead", r = "thead";
+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 d(t) {
+  return l(o, i(t));
+}
+function s(t = document) {
+}
+const f = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  THEAD_SELECTOR: r,
+  THEAD_TAG: o,
+  createThead: d,
+  enhanceTheads: s
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  r as T,
+  o as a,
+  d as c,
+  s as e,
+  f as i
+};
+//# sourceMappingURL=index31.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index31.js","sources":["../../../src/elements/table/thead/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Thead element helpers.\n *\n * @remarks\n * The thead element (`<thead>`) represents the block of rows that form the\n * column headers (and related header-area rows) for a table.\n *\n * Best-practice guidance:\n * - Use `<thead>` to group header rows, typically using `<th>` cells for headers.\n * - Keep the table structure logical: `<caption>` (optional), then `<colgroup>`\n *   (optional), then `<thead>`, then `<tbody>`/`<tfoot>` as needed.\n * - Avoid deprecated presentational attributes (e.g. `align`) and use CSS instead.\n * - Prefer native table semantics; only use ARIA when you cannot express the\n *   intended structure using proper table markup.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create `<thead>` 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 (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 thead elements.\n *\n * @category Constants\n */\nexport const THEAD_TAG = 'thead' as const;\n\n/**\n * A CSS selector targeting thead elements.\n *\n * @category Constants\n */\nexport const THEAD_SELECTOR = 'thead';\n\n/**\n * Attribute bag for thead creation/enhancement.\n *\n * @remarks\n * Thead 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 * Security notes:\n * - Inline event handler attributes (e.g. `onclick`) are blocked by `dom.ts`.\n * - The raw `style` attribute is blocked; use {@link GlobalAttrs.style} instead.\n *\n * @category Attributes\n */\nexport type TheadAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link TheadAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The thead attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: TheadAttrs): 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 thead element with global attributes.\n *\n * @remarks\n * - `<thead>` is a structural table element. Fundatio does not accept a text argument\n *   for this factory. Populate it with `<tr>` and header cells (`<th>`) as needed.\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 attrs - Optional attributes to apply.\n * @returns The created `<thead>` element.\n *\n * @example\n * Create and append a thead:\n * ```ts\n * import { createThead } from \"@Vastare/Fundatio/elements/table/thead\";\n *\n * const thead = createThead({ className: \"table-head\" });\n * table.appendChild(thead);\n * ```\n *\n * @category DOM\n */\nexport function createThead(attrs?: TheadAttrs): ElementOf<typeof THEAD_TAG> {\n  return createElement(THEAD_TAG, toGlobalAttrs(attrs));\n}\n\n/**\n * Enhance thead 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 enhanceTheads(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for thead.\n  void root;\n}\n"],"names":["THEAD_TAG","THEAD_SELECTOR","toGlobalAttrs","attrs","aria","rest","mappedAria","createThead","createElement","enhanceTheads","root"],"mappings":";AA8DO,MAAMA,IAAY,SAOZC,IAAiB;AAgC9B,SAASC,EAAcC,GAA6C;AAClE,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,EAAYJ,GAAiD;AAC3E,SAAOK,EAAcR,GAAWE,EAAcC,CAAK,CAAC;AACtD;AAoBO,SAASM,EAAcC,IAAmB,UAAgB;AAGjE;;;;;;;;"}

package/dist/esm/chunks/index32.js

@@ -0,0 +1,29 @@
+import { c as l } from "./dom.js";
+const a = "tbody", r = "tbody";
+function i(t) {
+  if (!t) return;
+  const { aria: e, ...n } = t;
+  if (!e) return n;
+  const o = {};
+  return 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 ? { ...n, aria: o } : n;
+}
+function d(t, e) {
+  return l(a, i(e), t);
+}
+function b(t = document) {
+}
+const f = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  TBODY_SELECTOR: r,
+  TBODY_TAG: a,
+  createTbody: d,
+  enhanceTbodies: b
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  r as T,
+  a,
+  d as c,
+  b as e,
+  f as i
+};
+//# sourceMappingURL=index32.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index32.js","sources":["../../../src/elements/table/tbody/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Tbody element helpers.\n *\n * @remarks\n * The tbody element (`<tbody>`) represents a block of rows that make up the main\n * body of a table's data.\n *\n * Best-practice guidance:\n * - Use tables for data, not layout.\n * - Group rows meaningfully with `<thead>`, `<tbody>`, and `<tfoot>`.\n * - Prefer semantic headers via `<th>` (with appropriate `scope`/`headers`)\n *   and provide a `<caption>` for accessible tables.\n * - Avoid obsolete presentational attributes (e.g. `align`, `valign`, `char`,\n *   `charoff`). Use CSS instead.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create `<tbody>` 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 * References:\n * - MDN: `<tbody>`: https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/tbody\n * - WHATWG HTML: Tables: https://html.spec.whatwg.org/multipage/tables.html\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 table body sections.\n *\n * @category Constants\n */\nexport const TBODY_TAG = 'tbody' as const;\n\n/**\n * A CSS selector targeting tbody elements.\n *\n * @category Constants\n */\nexport const TBODY_SELECTOR = 'tbody';\n\n/**\n * Attribute bag for tbody creation/enhancement.\n *\n * @remarks\n * `<tbody>` accepts 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 * Note: some legacy presentational attributes existed historically for table\n * sections, but are obsolete. Consumers can still use {@link GlobalAttrs.attrs}\n * as an escape hatch where necessary, subject to Fundatio's security rules in\n * `dom.ts` (blocks inline event handlers and raw `style` attribute strings).\n *\n * @category Attributes\n */\nexport type TbodyAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link TbodyAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The tbody attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: TbodyAttrs): 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 tbody element with optional text content and global attributes.\n *\n * @remarks\n * - In real usage, `<tbody>` should contain `<tr>` rows (not text).\n * - Optional 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 tbody (generally discouraged).\n * @param attrs - Optional attributes to apply.\n * @returns The created `<tbody>` element.\n *\n * @example\n * ```ts\n * import { createTbody } from \"@Vastare/Fundatio/elements/table/tbody\";\n *\n * const tbody = createTbody(undefined, { className: \"data-body\" });\n * ```\n *\n * @category DOM\n */\nexport function createTbody(text?: string, attrs?: TbodyAttrs): ElementOf<typeof TBODY_TAG> {\n  return createElement(TBODY_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance tbody 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 enhanceTbodies(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for tbody.\n  void root;\n}\n"],"names":["TBODY_TAG","TBODY_SELECTOR","toGlobalAttrs","attrs","aria","rest","mappedAria","createTbody","text","createElement","enhanceTbodies","root"],"mappings":";AAkEO,MAAMA,IAAY,SAOZC,IAAiB;AAiC9B,SAASC,EAAcC,GAA6C;AAClE,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;AAyBO,SAASE,EAAYC,GAAeL,GAAiD;AAC1F,SAAOM,EAAcT,GAAWE,EAAcC,CAAK,GAAGK,CAAI;AAC5D;AAoBO,SAASE,EAAeC,IAAmB,UAAgB;AAGlE;;;;;;;;"}

package/dist/esm/chunks/index33.js

@@ -0,0 +1,29 @@
+import { c as l } from "./dom.js";
+const a = "tfoot", r = "tfoot";
+function i(t) {
+  if (!t) return;
+  const { aria: e, ...n } = t;
+  if (!e) return n;
+  const o = {};
+  return 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 ? { ...n, aria: o } : n;
+}
+function s(t) {
+  return l(a, i(t));
+}
+function c(t = document) {
+}
+const b = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  TFOOT_SELECTOR: r,
+  TFOOT_TAG: a,
+  createTfoot: s,
+  enhanceTfoots: c
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  r as T,
+  a,
+  s as c,
+  c as e,
+  b as i
+};
+//# sourceMappingURL=index33.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index33.js","sources":["../../../src/elements/table/tfoot/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Tfoot element helpers.\n *\n * @remarks\n * The tfoot element (`<tfoot>`) encapsulates a set of table rows (`<tr>`) that\n * comprise the footer of a table, typically containing column summaries such as\n * totals or other aggregate values. :contentReference[oaicite:1]{index=1}\n *\n * Best-practice guidance:\n * - Use `<tfoot>` for footer rows (summaries/totals), and keep the table's\n *   structure logical with `<thead>` for headers and `<tbody>` for body rows.\n * - Many guides recommend placing `<tfoot>` after `<tbody>` for readability. :contentReference[oaicite:2]{index=2}\n * - Avoid deprecated presentational attributes and use CSS instead.\n * - Prefer native table semantics; only use ARIA when you cannot express the\n *   intended structure using proper table markup.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create `<tfoot>` 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 (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 tfoot elements.\n *\n * @category Constants\n */\nexport const TFOOT_TAG = 'tfoot' as const;\n\n/**\n * A CSS selector targeting tfoot elements.\n *\n * @category Constants\n */\nexport const TFOOT_SELECTOR = 'tfoot';\n\n/**\n * Attribute bag for tfoot creation/enhancement.\n *\n * @remarks\n * Tfoot 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 * Security notes:\n * - Inline event handler attributes (e.g. `onclick`) are blocked by `dom.ts`.\n * - The raw `style` attribute is blocked; use {@link GlobalAttrs.style} instead.\n *\n * @category Attributes\n */\nexport type TfootAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link TfootAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The tfoot attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: TfootAttrs): 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 tfoot element with global attributes.\n *\n * @remarks\n * - `<tfoot>` is a structural table element. Fundatio does not accept a text argument\n *   for this factory. Populate it with `<tr>` (and cells) as needed.\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 attrs - Optional attributes to apply.\n * @returns The created `<tfoot>` element.\n *\n * @example\n * Create and append a tfoot:\n * ```ts\n * import { createTfoot } from \"@Vastare/Fundatio/elements/table/tfoot\";\n *\n * const tfoot = createTfoot({ className: \"table-foot\" });\n * table.appendChild(tfoot);\n * ```\n *\n * @category DOM\n */\nexport function createTfoot(attrs?: TfootAttrs): ElementOf<typeof TFOOT_TAG> {\n  return createElement(TFOOT_TAG, toGlobalAttrs(attrs));\n}\n\n/**\n * Enhance tfoot 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 enhanceTfoots(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for tfoot.\n  void root;\n}\n"],"names":["TFOOT_TAG","TFOOT_SELECTOR","toGlobalAttrs","attrs","aria","rest","mappedAria","createTfoot","createElement","enhanceTfoots","root"],"mappings":";AA+DO,MAAMA,IAAY,SAOZC,IAAiB;AAgC9B,SAASC,EAAcC,GAA6C;AAClE,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,EAAYJ,GAAiD;AAC3E,SAAOK,EAAcR,GAAWE,EAAcC,CAAK,CAAC;AACtD;AAoBO,SAASM,EAAcC,IAAmB,UAAgB;AAGjE;;;;;;;;"}

package/dist/esm/chunks/index34.js

@@ -0,0 +1,29 @@
+import { c as r } from "./dom.js";
+const o = "tr", l = "tr";
+function i(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, i(e), t);
+}
+function c(t = document) {
+}
+const f = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  TR_SELECTOR: l,
+  TR_TAG: o,
+  createTr: s,
+  enhanceTrs: c
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  l as T,
+  o as a,
+  s as c,
+  c as e,
+  f as i
+};
+//# sourceMappingURL=index34.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index34.js","sources":["../../../src/elements/table/tr/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Tr element helpers.\n *\n * @remarks\n * The tr element (`<tr>`) represents a row of cells within a table section.\n * A row typically contains `<td>` and/or `<th>` elements.\n *\n * Best-practice guidance:\n * - Use tables for data, not layout.\n * - Group rows with `<thead>`, `<tbody>`, and `<tfoot>` for clearer structure.\n * - Use `<th>` for header cells (and `scope`/`headers` where appropriate) for\n *   accessible tables.\n * - Avoid obsolete presentational attributes on table elements (e.g. `align`,\n *   `bgcolor`, `valign`). Use CSS instead.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create `<tr>` 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 * References:\n * - MDN: `<tr>`: https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/tr\n * - WHATWG HTML: Tables: https://html.spec.whatwg.org/multipage/tables.html\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 table rows.\n *\n * @category Constants\n */\nexport const TR_TAG = 'tr' as const;\n\n/**\n * A CSS selector targeting tr elements.\n *\n * @category Constants\n */\nexport const TR_SELECTOR = 'tr';\n\n/**\n * Attribute bag for tr creation/enhancement.\n *\n * @remarks\n * `<tr>` accepts 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 * Note: legacy presentational attributes historically existed for table rows,\n * but are obsolete. Consumers can still use {@link GlobalAttrs.attrs} as an\n * escape hatch where necessary, subject to Fundatio's security rules in `dom.ts`\n * (blocks inline event handlers and raw `style` attribute strings).\n *\n * @category Attributes\n */\nexport type TrAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link TrAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The tr attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: TrAttrs): 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 tr element with optional text content and global attributes.\n *\n * @remarks\n * - In real usage, `<tr>` should contain `<td>` and/or `<th>` cells (not text).\n * - Optional 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 row (generally discouraged).\n * @param attrs - Optional attributes to apply.\n * @returns The created `<tr>` element.\n *\n * @example\n * ```ts\n * import { createTr } from \"@Vastare/Fundatio/elements/table/tr\";\n *\n * const row = createTr(undefined, { className: \"row\" });\n * ```\n *\n * @category DOM\n */\nexport function createTr(text?: string, attrs?: TrAttrs): ElementOf<typeof TR_TAG> {\n  return createElement(TR_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance tr 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 enhanceTrs(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for tr.\n  void root;\n}\n"],"names":["TR_TAG","TR_SELECTOR","toGlobalAttrs","attrs","aria","rest","mappedAria","createTr","text","createElement","enhanceTrs","root"],"mappings":";AAkEO,MAAMA,IAAS,MAOTC,IAAc;AAiC3B,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;AAyBO,SAASE,EAASC,GAAeL,GAA2C;AACjF,SAAOM,EAAcT,GAAQE,EAAcC,CAAK,GAAGK,CAAI;AACzD;AAoBO,SAASE,EAAWC,IAAmB,UAAgB;AAG9D;;;;;;;;"}

package/dist/esm/chunks/index35.js

@@ -0,0 +1,39 @@
+import { c as d } from "./dom.js";
+const p = "th", h = "th";
+function s(t, e, r) {
+  Object.prototype.hasOwnProperty.call(t, e) || (t[e] = r);
+}
+function y(t) {
+  if (!t) return;
+  const { aria: e, abbr: r, colspan: i, rowspan: a, headers: l, scope: c, ...f } = t, b = e ? (() => {
+    const o = {};
+    return 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 ? o : void 0;
+  })() : void 0, n = { ...f.attrs ?? {} };
+  typeof r == "string" && r.length > 0 && s(n, "abbr", r), typeof l == "string" && l.length > 0 && s(n, "headers", l), typeof c == "string" && c.length > 0 && s(n, "scope", c), typeof i == "number" && Number.isFinite(i) && i > 0 && s(n, "colspan", Math.trunc(i)), typeof a == "number" && Number.isFinite(a) && a > 0 && s(n, "rowspan", Math.trunc(a));
+  const u = Object.keys(n).length > 0;
+  return {
+    ...f,
+    ...b ? { aria: b } : null,
+    ...u ? { attrs: n } : null
+  };
+}
+function g(t, e) {
+  return d(p, y(e), t);
+}
+function m(t = document) {
+}
+const O = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  TH_SELECTOR: h,
+  TH_TAG: p,
+  createTh: g,
+  enhanceThs: m
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  h as T,
+  p as a,
+  g as c,
+  m as e,
+  O as i
+};
+//# sourceMappingURL=index35.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index35.js","sources":["../../../src/elements/table/th/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Th element helpers.\n *\n * @remarks\n * The th element (`<th>`) represents a header cell in a table row (`<tr>`).\n * It is used to label a group of related cells, typically via:\n * - `scope` for simple row/column headers\n * - `headers` for complex tables with multi-level or irregular headings\n *\n * Best-practice guidance:\n * - Prefer native table semantics (use `<th>` for headers, not `role=\"columnheader\"`).\n * - Use `scope` for simple tables (`row`, `col`, `rowgroup`, `colgroup`).\n * - For complex tables, use `id` on `<th>` cells and reference them with\n *   `headers` from the related data cells (and sometimes header cells).\n * - Avoid deprecated presentational attributes and use CSS instead.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create `<th>` cells 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 (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 th elements.\n *\n * @category Constants\n */\nexport const TH_TAG = 'th' as const;\n\n/**\n * A CSS selector targeting th elements.\n *\n * @category Constants\n */\nexport const TH_SELECTOR = 'th';\n\n/**\n * Allowed `scope` values for `<th>`.\n *\n * @remarks\n * The HTML spec defines explicit keywords plus an automatic/default state.\n * Fundatio exposes the common keyword values and allows an explicit `\"auto\"` value\n * to match the spec's conceptual default state. Consumers control structure;\n * Fundatio does not attempt to enforce table-model anchoring constraints.\n *\n * @category Attributes\n */\nexport type ThScope = 'row' | 'col' | 'rowgroup' | 'colgroup' | 'auto';\n\n/**\n * Attribute bag for th creation/enhancement.\n *\n * @remarks\n * Th elements accept standard HTML global attributes, plus:\n * - `abbr`: an alternative label for the header cell (often abbreviated)\n * - `colspan`: number of columns the cell spans\n * - `rowspan`: number of rows the cell spans\n * - `headers`: space-separated IDs of `<th>` elements that apply to this cell\n * - `scope`: indicates the set of cells this header applies to (`row`, `col`, 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 * Security notes:\n * - Inline event handler attributes (e.g. `onclick`) are blocked by `dom.ts`.\n * - The raw `style` attribute is blocked; use {@link GlobalAttrs.style} instead.\n *\n * @category Attributes\n */\nexport type ThAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n\n  /**\n   * Alternative label for the header cell.\n   *\n   * @remarks\n   * Useful when the visible header text is long but needs a shorter label in\n   * other contexts (e.g. when referenced as a header).\n   */\n  abbr?: string;\n\n  /**\n   * Number of columns the cell spans.\n   *\n   * @remarks\n   * Must be a positive integer to be meaningful. Fundatio sets the attribute only\n   * when you provide a finite value greater than 0.\n   */\n  colspan?: number;\n\n  /**\n   * Number of rows the cell spans.\n   *\n   * @remarks\n   * Must be a positive integer to be meaningful. Fundatio sets the attribute only\n   * when you provide a finite value greater than 0.\n   */\n  rowspan?: number;\n\n  /**\n   * Space-separated IDs of `<th>` elements that apply to this cell.\n   *\n   * @remarks\n   * This is primarily used for complex tables where `scope` is insufficient.\n   * Fundatio does not validate ID existence; consumers control their DOM trees.\n   */\n  headers?: string;\n\n  /**\n   * Indicates which cells the header cell applies to.\n   *\n   * @remarks\n   * Use for simple row/column headers. For complex tables, prefer `headers`.\n   */\n  scope?: ThScope;\n};\n\n/**\n * Set an attribute only if it is not already present on the attribute bag.\n *\n * @remarks\n * This supports the Fundatio convention where explicit raw attributes provided via\n * {@link GlobalAttrs.attrs} are treated as the caller's final intent.\n *\n * @param attrs - The destination attributes object.\n * @param name - Attribute name.\n * @param value - Attribute value.\n *\n * @category Internal\n */\nfunction setIfUnset(\n  attrs: NonNullable<GlobalAttrs['attrs']>,\n  name: string,\n  value: string | number | boolean,\n): void {\n  if (Object.prototype.hasOwnProperty.call(attrs, name)) return;\n  attrs[name] = value;\n}\n\n/**\n * Normalize {@link ThAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The th attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: ThAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, abbr, colspan, rowspan, headers, scope, ...rest } = attrs;\n\n  const mappedAria: NonNullable<GlobalAttrs['aria']> | undefined = aria\n    ? (() => {\n        const out: NonNullable<GlobalAttrs['aria']> = {};\n        if (typeof aria.label === 'string') out.label = aria.label;\n        if (typeof aria.labelledby === 'string') out.labelledby = aria.labelledby;\n        if (typeof aria.hidden === 'boolean') out.hidden = aria.hidden;\n\n        return Object.keys(out).length > 0 ? out : undefined;\n      })()\n    : undefined;\n\n  const mergedAttrs: NonNullable<GlobalAttrs['attrs']> = { ...(rest.attrs ?? {}) };\n\n  if (typeof abbr === 'string' && abbr.length > 0) setIfUnset(mergedAttrs, 'abbr', abbr);\n  if (typeof headers === 'string' && headers.length > 0)\n    setIfUnset(mergedAttrs, 'headers', headers);\n\n  if (typeof scope === 'string' && scope.length > 0) setIfUnset(mergedAttrs, 'scope', scope);\n\n  if (typeof colspan === 'number' && Number.isFinite(colspan) && colspan > 0) {\n    setIfUnset(mergedAttrs, 'colspan', Math.trunc(colspan));\n  }\n\n  if (typeof rowspan === 'number' && Number.isFinite(rowspan) && rowspan > 0) {\n    setIfUnset(mergedAttrs, 'rowspan', Math.trunc(rowspan));\n  }\n\n  const hasMergedAttrs = Object.keys(mergedAttrs).length > 0;\n\n  return {\n    ...rest,\n    ...(mappedAria ? { aria: mappedAria } : null),\n    ...(hasMergedAttrs ? { attrs: mergedAttrs } : null),\n  };\n}\n\n/**\n * Create a th 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 header cell.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<th>` element.\n *\n * @example\n * Create a column header cell:\n * ```ts\n * import { createTh } from \"@Vastare/Fundatio/elements/table/th\";\n *\n * const th = createTh(\"Price\", { scope: \"col\" });\n * row.appendChild(th);\n * ```\n *\n * @category DOM\n */\nexport function createTh(text?: string, attrs?: ThAttrs): ElementOf<typeof TH_TAG> {\n  return createElement(TH_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance th 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 enhanceThs(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for th.\n  void root;\n}\n"],"names":["TH_TAG","TH_SELECTOR","setIfUnset","attrs","name","value","toGlobalAttrs","aria","abbr","colspan","rowspan","headers","scope","rest","mappedAria","out","mergedAttrs","hasMergedAttrs","createTh","text","createElement","enhanceThs","root"],"mappings":";AA+DO,MAAMA,IAAS,MAOTC,IAAc;AAmG3B,SAASC,EACPC,GACAC,GACAC,GACM;AACN,EAAI,OAAO,UAAU,eAAe,KAAKF,GAAOC,CAAI,MACpDD,EAAMC,CAAI,IAAIC;AAChB;AAUA,SAASC,EAAcH,GAA0C;AAC/D,MAAI,CAACA,EAAO;AAEZ,QAAM,EAAE,MAAAI,GAAM,MAAAC,GAAM,SAAAC,GAAS,SAAAC,GAAS,SAAAC,GAAS,OAAAC,GAAO,GAAGC,EAAA,IAASV,GAE5DW,IAA2DP,KAC5D,MAAM;AACL,UAAMQ,IAAwC,CAAA;AAC9C,WAAI,OAAOR,EAAK,SAAU,aAAUQ,EAAI,QAAQR,EAAK,QACjD,OAAOA,EAAK,cAAe,aAAUQ,EAAI,aAAaR,EAAK,aAC3D,OAAOA,EAAK,UAAW,cAAWQ,EAAI,SAASR,EAAK,SAEjD,OAAO,KAAKQ,CAAG,EAAE,SAAS,IAAIA,IAAM;AAAA,EAC7C,OACA,QAEEC,IAAiD,EAAE,GAAIH,EAAK,SAAS,CAAA,EAAC;AAE5E,EAAI,OAAOL,KAAS,YAAYA,EAAK,SAAS,KAAGN,EAAWc,GAAa,QAAQR,CAAI,GACjF,OAAOG,KAAY,YAAYA,EAAQ,SAAS,KAClDT,EAAWc,GAAa,WAAWL,CAAO,GAExC,OAAOC,KAAU,YAAYA,EAAM,SAAS,KAAGV,EAAWc,GAAa,SAASJ,CAAK,GAErF,OAAOH,KAAY,YAAY,OAAO,SAASA,CAAO,KAAKA,IAAU,KACvEP,EAAWc,GAAa,WAAW,KAAK,MAAMP,CAAO,CAAC,GAGpD,OAAOC,KAAY,YAAY,OAAO,SAASA,CAAO,KAAKA,IAAU,KACvER,EAAWc,GAAa,WAAW,KAAK,MAAMN,CAAO,CAAC;AAGxD,QAAMO,IAAiB,OAAO,KAAKD,CAAW,EAAE,SAAS;AAEzD,SAAO;AAAA,IACL,GAAGH;AAAA,IACH,GAAIC,IAAa,EAAE,MAAMA,MAAe;AAAA,IACxC,GAAIG,IAAiB,EAAE,OAAOD,MAAgB;AAAA,EAAA;AAElD;AA0BO,SAASE,EAASC,GAAehB,GAA2C;AACjF,SAAOiB,EAAcpB,GAAQM,EAAcH,CAAK,GAAGgB,CAAI;AACzD;AAoBO,SAASE,EAAWC,IAAmB,UAAgB;AAG9D;;;;;;;;"}

package/dist/esm/chunks/index36.js

@@ -0,0 +1,48 @@
+import { c as f } from "./dom.js";
+const d = "td", b = "td";
+function h(n) {
+  if (!n) return;
+  const { aria: t, colspan: o, rowspan: a, headers: l, attrs: c, ...p } = n, i = { ...p };
+  if (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 && (i.aria = e);
+  }
+  const r = { ...c ?? {} }, s = (e) => Object.prototype.hasOwnProperty.call(r, e);
+  if (typeof o == "number" && !s("colspan")) {
+    if (!Number.isInteger(o) || o <= 0)
+      throw new Error('Invalid "colspan" for <td>: expected a positive integer greater than zero.');
+    r.colspan = o;
+  }
+  if (typeof a == "number" && !s("rowspan")) {
+    if (!Number.isInteger(a) || a <= 0)
+      throw new Error('Invalid "rowspan" for <td>: expected a positive integer greater than zero.');
+    r.rowspan = a;
+  }
+  if (typeof l == "string" && !s("headers")) {
+    const e = l.trim();
+    if (e.length === 0)
+      throw new Error('Invalid "headers" for <td>: expected a non-empty string.');
+    r.headers = e;
+  }
+  return Object.keys(r).length > 0 && (i.attrs = r), i;
+}
+function g(n, t) {
+  return f(d, h(t), n);
+}
+function y(n = document) {
+}
+const u = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  TD_SELECTOR: b,
+  TD_TAG: d,
+  createTd: g,
+  enhanceTds: y
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  b as T,
+  d as a,
+  g as c,
+  y as e,
+  u as i
+};
+//# sourceMappingURL=index36.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index36.js","sources":["../../../src/elements/table/td/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Td element helpers.\n *\n * @remarks\n * The td element (`<td>`) represents a data cell in a table row (`<tr>`).\n *\n * Best-practice guidance:\n * - Use `<td>` for data cells and `<th>` for header cells.\n * - Provide a `<caption>` and properly marked header cells for accessible tables.\n * - Prefer simple tables. For complex tables with multi-level headers, use\n *   the `headers` attribute to associate a `<td>` with one or more `<th>` IDs.\n * - Avoid obsolete presentational attributes (e.g. `align`, `bgcolor`, `valign`).\n *   Use CSS instead.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create `<td>` 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 * References:\n * - MDN: `<td>`: https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/td\n * - WHATWG HTML: Tables: https://html.spec.whatwg.org/multipage/tables.html\n * - W3C WAI: Tables (headers/id technique): https://www.w3.org/WAI/tutorials/tables/multi-level/\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 table data cells.\n *\n * @category Constants\n */\nexport const TD_TAG = 'td' as const;\n\n/**\n * A CSS selector targeting td elements.\n *\n * @category Constants\n */\nexport const TD_SELECTOR = 'td';\n\n/**\n * Attribute bag for td creation/enhancement.\n *\n * @remarks\n * In addition to global attributes, `<td>` participates in the table model via:\n * - `colspan`: number of columns spanned (positive integer)\n * - `rowspan`: number of rows spanned (positive integer)\n * - `headers`: space-separated list of `<th id=\"...\">` references for complex tables\n *\n * Fundatio supports a structured ARIA input for common ARIA fields, mapped into\n * {@link GlobalAttrs.aria}.\n *\n * @category Attributes\n */\nexport type TdAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n\n  /**\n   * Number of columns this cell spans.\n   *\n   * @remarks\n   * Must be a positive integer greater than zero.\n   */\n  colspan?: number;\n\n  /**\n   * Number of rows this cell spans.\n   *\n   * @remarks\n   * Must be a positive integer greater than zero.\n   */\n  rowspan?: number;\n\n  /**\n   * Space-separated list of header cell IDs (`<th id=\"...\">`) that apply to this cell.\n   *\n   * @remarks\n   * This is typically only necessary for complex tables.\n   */\n  headers?: string;\n};\n\n/**\n * Normalize {@link TdAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The td attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: TdAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, colspan, rowspan, headers, attrs: rawAttrs, ...rest } = attrs;\n\n  const out: GlobalAttrs = { ...rest };\n\n  // Map structured ARIA, only if something is actually defined.\n  if (aria) {\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    if (Object.keys(mappedAria).length > 0) out.aria = mappedAria;\n  }\n\n  // Preserve caller escape hatch, but allow Fundatio-typed fields to fill gaps.\n  const mergedAttrs: NonNullable<GlobalAttrs['attrs']> = { ...(rawAttrs ?? {}) };\n\n  const hasOwn = (k: string) => Object.prototype.hasOwnProperty.call(mergedAttrs, k);\n\n  if (typeof colspan === 'number' && !hasOwn('colspan')) {\n    if (!Number.isInteger(colspan) || colspan <= 0) {\n      throw new Error('Invalid \"colspan\" for <td>: expected a positive integer greater than zero.');\n    }\n    mergedAttrs.colspan = colspan;\n  }\n\n  if (typeof rowspan === 'number' && !hasOwn('rowspan')) {\n    if (!Number.isInteger(rowspan) || rowspan <= 0) {\n      throw new Error('Invalid \"rowspan\" for <td>: expected a positive integer greater than zero.');\n    }\n    mergedAttrs.rowspan = rowspan;\n  }\n\n  if (typeof headers === 'string' && !hasOwn('headers')) {\n    const trimmed = headers.trim();\n    if (trimmed.length === 0) {\n      throw new Error('Invalid \"headers\" for <td>: expected a non-empty string.');\n    }\n    mergedAttrs.headers = trimmed;\n  }\n\n  if (Object.keys(mergedAttrs).length > 0) out.attrs = mergedAttrs;\n\n  return out;\n}\n\n/**\n * Create a td element with optional text content and global attributes.\n *\n * @remarks\n * - In real usage, `<td>` contains text and/or phrasing content, but should never\n *   be built via `innerHTML` from untrusted data.\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 td.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<td>` element.\n *\n * @example\n * ```ts\n * import { createTd } from \"@Vastare/Fundatio/elements/table/td\";\n *\n * const cell = createTd(\"42\", { colspan: 2 });\n * ```\n *\n * @category DOM\n */\nexport function createTd(text?: string, attrs?: TdAttrs): ElementOf<typeof TD_TAG> {\n  return createElement(TD_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance td 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 enhanceTds(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for td.\n  void root;\n}\n"],"names":["TD_TAG","TD_SELECTOR","toGlobalAttrs","attrs","aria","colspan","rowspan","headers","rawAttrs","rest","out","mappedAria","mergedAttrs","hasOwn","k","trimmed","createTd","text","createElement","enhanceTds","root"],"mappings":";AAkEO,MAAMA,IAAS,MAOTC,IAAc;AAuD3B,SAASC,EAAcC,GAA0C;AAC/D,MAAI,CAACA,EAAO;AAEZ,QAAM,EAAE,MAAAC,GAAM,SAAAC,GAAS,SAAAC,GAAS,SAAAC,GAAS,OAAOC,GAAU,GAAGC,EAAA,IAASN,GAEhEO,IAAmB,EAAE,GAAGD,EAAA;AAG9B,MAAIL,GAAM;AACR,UAAMO,IAA+C,CAAA;AAErD,IAAI,OAAOP,EAAK,SAAU,aAAUO,EAAW,QAAQP,EAAK,QACxD,OAAOA,EAAK,cAAe,aAAUO,EAAW,aAAaP,EAAK,aAClE,OAAOA,EAAK,UAAW,cAAWO,EAAW,SAASP,EAAK,SAE3D,OAAO,KAAKO,CAAU,EAAE,SAAS,QAAO,OAAOA;AAAA,EACrD;AAGA,QAAMC,IAAiD,EAAE,GAAIJ,KAAY,GAAC,GAEpEK,IAAS,CAACC,MAAc,OAAO,UAAU,eAAe,KAAKF,GAAaE,CAAC;AAEjF,MAAI,OAAOT,KAAY,YAAY,CAACQ,EAAO,SAAS,GAAG;AACrD,QAAI,CAAC,OAAO,UAAUR,CAAO,KAAKA,KAAW;AAC3C,YAAM,IAAI,MAAM,4EAA4E;AAE9F,IAAAO,EAAY,UAAUP;AAAA,EACxB;AAEA,MAAI,OAAOC,KAAY,YAAY,CAACO,EAAO,SAAS,GAAG;AACrD,QAAI,CAAC,OAAO,UAAUP,CAAO,KAAKA,KAAW;AAC3C,YAAM,IAAI,MAAM,4EAA4E;AAE9F,IAAAM,EAAY,UAAUN;AAAA,EACxB;AAEA,MAAI,OAAOC,KAAY,YAAY,CAACM,EAAO,SAAS,GAAG;AACrD,UAAME,IAAUR,EAAQ,KAAA;AACxB,QAAIQ,EAAQ,WAAW;AACrB,YAAM,IAAI,MAAM,0DAA0D;AAE5E,IAAAH,EAAY,UAAUG;AAAA,EACxB;AAEA,SAAI,OAAO,KAAKH,CAAW,EAAE,SAAS,QAAO,QAAQA,IAE9CF;AACT;AA0BO,SAASM,EAASC,GAAed,GAA2C;AACjF,SAAOe,EAAclB,GAAQE,EAAcC,CAAK,GAAGc,CAAI;AACzD;AAYO,SAASE,EAAWC,IAAmB,UAAgB;AAG9D;;;;;;;;"}

package/dist/esm/chunks/index37.js

@@ -0,0 +1,29 @@
+import { c as i } from "./dom.js";
+const o = "caption", l = "caption";
+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 b = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  CAPTION_SELECTOR: l,
+  CAPTION_TAG: o,
+  createCaption: c,
+  enhanceCaptions: s
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  l as C,
+  o as a,
+  c,
+  s as e,
+  b as i
+};
+//# sourceMappingURL=index37.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index37.js","sources":["../../../src/elements/table/caption/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Caption element helpers.\n *\n * @remarks\n * The caption element (`<caption>`) provides a title (caption) for its parent\n * `<table>`. It is an important accessibility feature because it gives the table\n * an accessible name or description when authored appropriately. :contentReference[oaicite:1]{index=1}\n *\n * Best-practice guidance:\n * - Use `<caption>` to describe the purpose of the table and help users decide\n *   whether to read it. :contentReference[oaicite:2]{index=2}\n * - Place `<caption>` as the first child of the `<table>` in source order. :contentReference[oaicite:3]{index=3}\n * - Keep the caption concise but meaningful. For complex tables, captions can be\n *   supplemented with additional explanatory text near the table (outside the\n *   caption) when necessary. :contentReference[oaicite:4]{index=4}\n * - Avoid deprecated presentational attributes (e.g. legacy `align`) and use CSS instead. :contentReference[oaicite:5]{index=5}\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create `<caption>` 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 (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 caption elements.\n *\n * @category Constants\n */\nexport const CAPTION_TAG = 'caption' as const;\n\n/**\n * A CSS selector targeting caption elements.\n *\n * @category Constants\n */\nexport const CAPTION_SELECTOR = 'caption';\n\n/**\n * Attribute bag for caption creation/enhancement.\n *\n * @remarks\n * Caption 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 * Security notes:\n * - Inline event handler attributes (e.g. `onclick`) are blocked by `dom.ts`.\n * - The raw `style` attribute is blocked; use {@link GlobalAttrs.style} instead.\n *\n * @category Attributes\n */\nexport type CaptionAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link CaptionAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The caption attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: CaptionAttrs): 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 caption 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 caption.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<caption>` element.\n *\n * @example\n * Create and prepend a caption to a table:\n * ```ts\n * import { createCaption } from \"@Vastare/Fundatio/elements/table/caption\";\n *\n * const table = document.createElement(\"table\");\n * table.prepend(createCaption(\"Quarterly results\"));\n * ```\n *\n * @category DOM\n */\nexport function createCaption(text?: string, attrs?: CaptionAttrs): ElementOf<typeof CAPTION_TAG> {\n  return createElement(CAPTION_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance caption 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 enhanceCaptions(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for caption.\n  void root;\n}\n"],"names":["CAPTION_TAG","CAPTION_SELECTOR","toGlobalAttrs","attrs","aria","rest","mappedAria","createCaption","text","createElement","enhanceCaptions","root"],"mappings":";AAgEO,MAAMA,IAAc,WAOdC,IAAmB;AAgChC,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,SAG7C,OAAO,KAAKE,CAAU,EAAE,SAAS,IAEhC,EAAE,GAAGD,GAAM,MAAMC,MAAeD;AACrD;AA0BO,SAASE,EAAcC,GAAeL,GAAqD;AAChG,SAAOM,EAAcT,GAAaE,EAAcC,CAAK,GAAGK,CAAI;AAC9D;AAoBO,SAASE,EAAgBC,IAAmB,UAAgB;AAGnE;;;;;;;;"}

package/dist/esm/chunks/index38.js

@@ -0,0 +1,29 @@
+import { c as l } from "./dom.js";
+const o = "h1", r = "h1";
+function i(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 l(o, i(e), t);
+}
+function c(t = document) {
+}
+const f = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  H1_SELECTOR: r,
+  H1_TAG: o,
+  createH1: s,
+  enhanceH1s: c
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  r as H,
+  o as a,
+  s as c,
+  c as e,
+  f as i
+};
+//# sourceMappingURL=index38.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index38.js","sources":["../../../src/elements/heading/h1/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: H1 element helpers.\n *\n * @remarks\n * The h1 element (`<h1>`) represents the highest-rank section heading.\n *\n * Best-practice guidance:\n * - Use headings to convey document structure, not for visual styling.\n * - Keep heading levels ordered (don't jump from `<h1>` to `<h3>` because you\n *   like the font size). Use CSS for presentation.\n * - Prefer clear, succinct headings that describe the section that follows.\n * - Many accessibility guides recommend a single `<h1>` as the page/document's\n *   primary heading. HTML allows multiple headings, but consistency matters.\n * - Don't rely on default browser heading styles; user-agent styles can change.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create `<h1>` 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 * References:\n * - MDN: Heading elements: https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/Heading_Elements\n * - MDN: Headings and paragraphs: https://developer.mozilla.org/en-US/docs/Learn_web_development/Core/Structuring_content/Headings_and_paragraphs\n * - W3C WAI: Headings: https://www.w3.org/WAI/tutorials/page-structure/headings/\n * - WHATWG HTML: Sections / heading content: https://html.spec.whatwg.org/multipage/sections.html\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 the primary heading element.\n *\n * @category Constants\n */\nexport const H1_TAG = 'h1' as const;\n\n/**\n * A CSS selector targeting h1 elements.\n *\n * @category Constants\n */\nexport const H1_SELECTOR = 'h1';\n\n/**\n * Attribute bag for h1 creation/enhancement.\n *\n * @remarks\n * H1 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 H1Attrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link H1Attrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The h1 attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: H1Attrs): 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 h1 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 heading.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<h1>` element.\n *\n * @example\n * ```ts\n * import { createH1 } from \"@Vastare/Fundatio/elements/heading/h1\";\n *\n * document.body.prepend(createH1(\"Page title\", { id: \"title\" }));\n * ```\n *\n * @category DOM\n */\nexport function createH1(text?: string, attrs?: H1Attrs): ElementOf<typeof H1_TAG> {\n  return createElement(H1_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance h1 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 enhanceH1s(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for h1.\n  void root;\n}\n"],"names":["H1_TAG","H1_SELECTOR","toGlobalAttrs","attrs","aria","rest","mappedAria","createH1","text","createElement","enhanceH1s","root"],"mappings":";AAoEO,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;AAwBO,SAASE,EAASC,GAAeL,GAA2C;AACjF,SAAOM,EAAcT,GAAQE,EAAcC,CAAK,GAAGK,CAAI;AACzD;AAoBO,SAASE,EAAWC,IAAmB,UAAgB;AAG9D;;;;;;;;"}

package/dist/esm/chunks/index39.js

@@ -0,0 +1,29 @@
+import { c as l } from "./dom.js";
+const o = "h2", r = "h2";
+function i(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 l(o, i(e), t);
+}
+function c(t = document) {
+}
+const f = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  H2_SELECTOR: r,
+  H2_TAG: o,
+  createH2: s,
+  enhanceH2s: c
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  r as H,
+  o as a,
+  s as c,
+  c as e,
+  f as i
+};
+//# sourceMappingURL=index39.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index39.js","sources":["../../../src/elements/heading/h2/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: H2 element helpers.\n *\n * @remarks\n * The h2 element (`<h2>`) represents a second-level heading. Headings define the\n * hierarchical structure of a document and provide navigational landmarks for\n * assistive technologies. :contentReference[oaicite:1]{index=1}\n *\n * Best-practice guidance:\n * - Use headings to represent structure, not visual styling.\n * - Prefer a logical hierarchy (e.g. `<h1>` then `<h2>`, then `<h3>`), and avoid\n *   skipping levels purely for appearance. :contentReference[oaicite:2]{index=2}\n * - Keep headings concise and descriptive to support scanning and accessibility. :contentReference[oaicite:3]{index=3}\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create `<h2>` 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 (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 h2 headings.\n *\n * @category Constants\n */\nexport const H2_TAG = 'h2' as const;\n\n/**\n * A CSS selector targeting h2 elements.\n *\n * @category Constants\n */\nexport const H2_SELECTOR = 'h2';\n\n/**\n * Attribute bag for h2 creation/enhancement.\n *\n * @remarks\n * H2 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 * Security notes:\n * - Inline event handler attributes (e.g. `onclick`) are blocked by `dom.ts`.\n * - The raw `style` attribute is blocked; use {@link GlobalAttrs.style} instead.\n *\n * @category Attributes\n */\nexport type H2Attrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link H2Attrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The h2 attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: H2Attrs): 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 h2 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 h2.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<h2>` element.\n *\n * @example\n * Create and append a heading:\n * ```ts\n * import { createH2 } from \"@Vastare/Fundatio/elements/heading/h2\";\n *\n * document.body.appendChild(createH2(\"Section title\", { className: \"section-title\" }));\n * ```\n *\n * @category DOM\n */\nexport function createH2(text?: string, attrs?: H2Attrs): ElementOf<typeof H2_TAG> {\n  return createElement(H2_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance h2 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 enhanceH2s(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for h2.\n  void root;\n}\n"],"names":["H2_TAG","H2_SELECTOR","toGlobalAttrs","attrs","aria","rest","mappedAria","createH2","text","createElement","enhanceH2s","root"],"mappings":";AA6DO,MAAMA,IAAS,MAOTC,IAAc;AAgC3B,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;AAyBO,SAASE,EAASC,GAAeL,GAA2C;AACjF,SAAOM,EAAcT,GAAQE,EAAcC,CAAK,GAAGK,CAAI;AACzD;AAoBO,SAASE,EAAWC,IAAmB,UAAgB;AAG9D;;;;;;;;"}

package/dist/esm/chunks/index4.js

@@ -0,0 +1,25 @@
+import { i } from "./index19.js";
+import { i as o } from "./index20.js";
+import { i as e } from "./index21.js";
+import { i as r } from "./index22.js";
+import { i as m } from "./index23.js";
+import { i as t } from "./index24.js";
+import { i as a } from "./index25.js";
+import { i as d } from "./index26.js";
+import { i as n } from "./index27.js";
+const u = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  audio: n,
+  canvas: r,
+  embed: t,
+  iframe: m,
+  img: i,
+  math: e,
+  object: a,
+  svg: o,
+  video: d
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  u as i
+};
+//# sourceMappingURL=index4.js.map

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

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

package/dist/esm/chunks/index40.js

@@ -0,0 +1,29 @@
+import { c as l } from "./dom.js";
+const o = "h3", r = "h3";
+function i(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 l(o, i(e), t);
+}
+function c(t = document) {
+}
+const f = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  H3_SELECTOR: r,
+  H3_TAG: o,
+  createH3: s,
+  enhanceH3s: c
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  r as H,
+  o as a,
+  s as c,
+  c as e,
+  f as i
+};
+//# sourceMappingURL=index40.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index40.js","sources":["../../../src/elements/heading/h3/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: H3 element helpers.\n *\n * @remarks\n * The h3 element (`<h3>`) represents a third-rank section heading.\n *\n * Best-practice guidance:\n * - Use headings to convey document structure, not for visual styling.\n * - Keep heading levels ordered (don't jump from `<h2>` to `<h4>` because you\n *   like the font size). Use CSS for presentation.\n * - Ensure headings describe the section content that follows.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create `<h3>` 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 * References:\n * - MDN: Heading elements: https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/Heading_Elements\n * - W3C WAI: Headings: https://www.w3.org/WAI/tutorials/page-structure/headings/\n * - WHATWG HTML: Sections / heading content: https://html.spec.whatwg.org/multipage/sections.html\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 third-level headings.\n *\n * @category Constants\n */\nexport const H3_TAG = 'h3' as const;\n\n/**\n * A CSS selector targeting h3 elements.\n *\n * @category Constants\n */\nexport const H3_SELECTOR = 'h3';\n\n/**\n * Attribute bag for h3 creation/enhancement.\n *\n * @remarks\n * H3 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 H3Attrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link H3Attrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The h3 attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: H3Attrs): 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 h3 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 heading.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<h3>` element.\n *\n * @example\n * ```ts\n * import { createH3 } from \"@Vastare/Fundatio/elements/heading/h3\";\n *\n * const h = createH3(\"Section heading\", { id: \"section\" });\n * ```\n *\n * @category DOM\n */\nexport function createH3(text?: string, attrs?: H3Attrs): ElementOf<typeof H3_TAG> {\n  return createElement(H3_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance h3 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 enhanceH3s(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for h3.\n  void root;\n}\n"],"names":["H3_TAG","H3_SELECTOR","toGlobalAttrs","attrs","aria","rest","mappedAria","createH3","text","createElement","enhanceH3s","root"],"mappings":";AAgEO,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;AAwBO,SAASE,EAASC,GAAeL,GAA2C;AACjF,SAAOM,EAAcT,GAAQE,EAAcC,CAAK,GAAGK,CAAI;AACzD;AAoBO,SAASE,EAAWC,IAAmB,UAAgB;AAG9D;;;;;;;;"}