@vastare/fundatio 0.1.0

package/dist/esm/chunks/index41.js

@@ -0,0 +1,29 @@
+import { c as l } from "./dom.js";
+const a = "h4", r = "h4";
+function i(t) {
+  if (!t) return;
+  const { aria: e, ...o } = t;
+  if (!e) return o;
+  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 ? { ...o, aria: n } : o;
+}
+function c(t, e) {
+  return l(a, i(e), t);
+}
+function s(t = document) {
+}
+const d = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  H4_SELECTOR: r,
+  H4_TAG: a,
+  createH4: c,
+  enhanceH4s: s
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  r as H,
+  a,
+  c,
+  s as e,
+  d as i
+};
+//# sourceMappingURL=index41.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index41.js","sources":["../../../src/elements/heading/h4/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: H4 element helpers.\n *\n * @remarks\n * The `<h4>` element represents a level 4 section heading.\n *\n * Best-practice guidance:\n * - Use headings to communicate structure, not visual styling.\n * - Avoid skipping heading levels in a way that breaks hierarchy (e.g. `h2` → `h4`).\n * - Keep headings descriptive and concise for accessibility.\n * - Prefer CSS for appearance; headings are about semantics.\n *\n * This module:\n * - Creates `<h4>` elements via Fundatio's hardened DOM helpers (no direct DOM calls).\n * - Applies a curated subset of global attributes safely.\n * - Supports a small, typed structured ARIA input mapped into `aria-*`.\n * - Exposes a stable enhancement hook (currently a no-op) for API consistency.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/Heading_Elements\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 a small, typed subset intended to prevent typo-driven ARIA bugs and\n * keep the API practical. Values are 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 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 `<h4>`.\n *\n * @category Constants\n */\nexport const H4_TAG = 'h4' as const;\n\n/**\n * A CSS selector targeting `<h4>` elements.\n *\n * @category Constants\n */\nexport const H4_SELECTOR = 'h4';\n\n/**\n * Attribute bag for `<h4>` creation/enhancement.\n *\n * @remarks\n * `<h4>` supports HTML global attributes only.\n *\n * Fundatio additionally supports a typed, structured ARIA input that is mapped into\n * {@link GlobalAttrs.aria} without modifying the shared DOM helpers.\n *\n * @category Attributes\n */\nexport type H4Attrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link H4Attrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The `<h4>` attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: H4Attrs): 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  return Object.keys(mappedAria).length > 0 ? { ...rest, aria: mappedAria } : rest;\n}\n\n/**\n * Create an `<h4>` element with optional text content and global attributes.\n *\n * @remarks\n * - Text is assigned via `textContent` (never `innerHTML`).\n * - Global attributes are applied via Fundatio's shared DOM helper, which enforces:\n *   - No inline event handler attributes (e.g. `onclick`)\n *   - No raw `style` attribute injection (use the `style` object field)\n *   - No empty attribute names\n *\n * @param text - Optional text content for the heading.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<h4>` element.\n *\n * @example\n * ```ts\n * import { createH4 } from \"@Vastare/Fundatio/elements/heading/h4\";\n *\n * const h = createH4(\"Details\", { id: \"details-heading\" });\n * ```\n *\n * @category DOM\n */\nexport function createH4(text?: string, attrs?: H4Attrs): ElementOf<typeof H4_TAG> {\n  return createElement(H4_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance `<h4>` elements within a given root.\n *\n * @remarks\n * Intentionally a no-op in `1.0.0`. This exists to provide a stable, consistent\n * integration hook across element modules.\n *\n * @param root - The node to search within. Defaults to `document`.\n *\n * @category Enhancement\n */\nexport function enhanceH4s(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for h4.\n  void root;\n}\n"],"names":["H4_TAG","H4_SELECTOR","toGlobalAttrs","attrs","aria","rest","mappedAria","createH4","text","createElement","enhanceH4s","root"],"mappings":";AAyDO,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,SAExD,OAAO,KAAKE,CAAU,EAAE,SAAS,IAAI,EAAE,GAAGD,GAAM,MAAMC,EAAA,IAAeD;AAC9E;AAyBO,SAASE,EAASC,GAAeL,GAA2C;AACjF,SAAOM,EAAcT,GAAQE,EAAcC,CAAK,GAAGK,CAAI;AACzD;AAaO,SAASE,EAAWC,IAAmB,UAAgB;AAG9D;;;;;;;;"}

package/dist/esm/chunks/index42.js

@@ -0,0 +1,29 @@
+import { c as l } from "./dom.js";
+const o = "h5", r = "h5";
+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,
+  H5_SELECTOR: r,
+  H5_TAG: o,
+  createH5: s,
+  enhanceH5s: c
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  r as H,
+  o as a,
+  s as c,
+  c as e,
+  f as i
+};
+//# sourceMappingURL=index42.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index42.js","sources":["../../../src/elements/heading/h5/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: H5 element helpers.\n *\n * @remarks\n * The h5 element (`<h5>`) represents a fifth-rank section heading.\n *\n * Best-practice guidance:\n * - Use headings to communicate document structure, not visual styling.\n * - Keep heading levels ordered (don't jump from `<h2>` to `<h5>` because you\n *   like the font size). Use CSS for presentation.\n * - Ensure headings accurately describe the section content that follows.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create `<h5>` 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 fifth-level headings.\n *\n * @category Constants\n */\nexport const H5_TAG = 'h5' as const;\n\n/**\n * A CSS selector targeting h5 elements.\n *\n * @category Constants\n */\nexport const H5_SELECTOR = 'h5';\n\n/**\n * Attribute bag for h5 creation/enhancement.\n *\n * @remarks\n * H5 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 H5Attrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link H5Attrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The h5 attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: H5Attrs): 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 h5 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 `<h5>` element.\n *\n * @example\n * ```ts\n * import { createH5 } from \"@Vastare/Fundatio/elements/heading/h5\";\n *\n * const h = createH5(\"Subsection heading\");\n * ```\n *\n * @category DOM\n */\nexport function createH5(text?: string, attrs?: H5Attrs): ElementOf<typeof H5_TAG> {\n  return createElement(H5_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance h5 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 enhanceH5s(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for h5.\n  void root;\n}\n"],"names":["H5_TAG","H5_SELECTOR","toGlobalAttrs","attrs","aria","rest","mappedAria","createH5","text","createElement","enhanceH5s","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;;;;;;;;"}

package/dist/esm/chunks/index43.js

@@ -0,0 +1,29 @@
+import { c as l } from "./dom.js";
+const o = "h6", r = "h6";
+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,
+  H6_SELECTOR: r,
+  H6_TAG: o,
+  createH6: s,
+  enhanceH6s: c
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  r as H,
+  o as a,
+  s as c,
+  c as e,
+  f as i
+};
+//# sourceMappingURL=index43.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index43.js","sources":["../../../src/elements/heading/h6/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: H6 element helpers.\n *\n * @remarks\n * The h6 element (`<h6>`) represents the lowest-ranked section heading.\n *\n * Best-practice guidance:\n * - Use headings to convey document structure, not visual styling.\n * - Do not choose heading levels based on appearance; use CSS for styling.\n * - Avoid skipping heading levels (e.g. jumping from `<h2>` to `<h6>`), unless the\n *   document structure genuinely calls for it.\n * - Keep headings short and descriptive to support accessibility navigation.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create heading 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/Reference/Elements/Heading_Elements\n * @see 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.\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 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 h6 headings.\n *\n * @category Constants\n */\nexport const H6_TAG = 'h6' as const;\n\n/**\n * A CSS selector targeting h6 elements.\n *\n * @category Constants\n */\nexport const H6_SELECTOR = 'h6';\n\n/**\n * Attribute bag for h6 creation/enhancement.\n *\n * @remarks\n * `<h6>` 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 * @category Attributes\n */\nexport type H6Attrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link H6Attrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The h6 attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: H6Attrs): 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 an h6 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 `<h6>` element.\n *\n * @example\n * ```ts\n * import { createH6 } from \"@Vastare/Fundatio/elements/heading/h6\";\n *\n * const heading = createH6(\"Minor heading\", { id: \"minor\" });\n * ```\n *\n * @category DOM\n */\nexport function createH6(text?: string, attrs?: H6Attrs): ElementOf<typeof H6_TAG> {\n  return createElement(H6_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance h6 elements within a given root.\n *\n * @remarks\n * This is intentionally a no-op in `1.0.0`.\n *\n * It exists to establish a stable enhancement pattern across all elements.\n *\n * @param root - The node to search within. Defaults to `document`.\n *\n * @category Enhancement\n */\nexport function enhanceH6s(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for h6.\n  void root;\n}\n"],"names":["H6_TAG","H6_SELECTOR","toGlobalAttrs","attrs","aria","rest","mappedAria","createH6","text","createElement","enhanceH6s","root"],"mappings":";AA+DO,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,SAE7C,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;AAcO,SAASE,EAAWC,IAAmB,UAAgB;AAG9D;;;;;;;;"}

package/dist/esm/chunks/index44.js

@@ -0,0 +1,29 @@
+import { c as l } from "./dom.js";
+const o = "p", r = "p";
+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 p = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  P_SELECTOR: r,
+  P_TAG: o,
+  createP: s,
+  enhancePs: c
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  r as P,
+  o as a,
+  s as c,
+  c as e,
+  p as i
+};
+//# sourceMappingURL=index44.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index44.js","sources":["../../../src/elements/text/paragraph/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Paragraph (`p`) element helpers.\n *\n * @remarks\n * The paragraph element (`<p>`) represents a paragraph: a structural grouping of\n * related phrasing content. It is a block-level element in HTML rendering\n * contexts, but its meaning is semantic, not visual.\n *\n * Best-practice guidance:\n * - Use `<p>` for paragraphs of text (phrasing content).\n * - Do not use `<p>` as a generic layout container. Prefer semantic grouping\n *   elements (e.g. `<section>`, `<article>`) or non-semantic `<div>` only when\n *   semantics do not apply.\n * - Avoid nesting block-level content inside `<p>`. In HTML parsing, a `<p>`\n *   element will auto-close when certain elements are encountered.\n * - Avoid obsolete attributes like `align`; use CSS instead.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create paragraphs 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: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/p\n * - WHATWG: https://html.spec.whatwg.org/multipage/grouping-content.html#the-p-element\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   * @remarks\n   * Prefer `labelledby` when a visible labeling element exists.\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   * @remarks\n   * Generally avoid hiding meaningful text from assistive technology.\n   */\n  hidden?: boolean;\n};\n\n/**\n * The semantic tag name for paragraphs.\n *\n * @category Constants\n */\nexport const P_TAG = 'p' as const;\n\n/**\n * A CSS selector targeting paragraph elements.\n *\n * @category Constants\n */\nexport const P_SELECTOR = 'p';\n\n/**\n * Attribute bag for paragraph creation/enhancement.\n *\n * @remarks\n * Paragraph 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 PAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link PAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The paragraph attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: PAttrs): 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 paragraph 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 paragraph.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<p>` element.\n *\n * @example\n * Create and append a paragraph:\n * ```ts\n * import { createP } from \"@Vastare/Fundatio/elements/text/p\";\n *\n * document.body.appendChild(\n *   createP(\"Hello.\", { className: \"lead\", id: \"intro\" })\n * );\n * ```\n *\n * @category DOM\n */\nexport function createP(text?: string, attrs?: PAttrs): ElementOf<typeof P_TAG> {\n  return createElement(P_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance paragraph 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 enhancePs(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for paragraphs.\n  void root;\n}\n"],"names":["P_TAG","P_SELECTOR","toGlobalAttrs","attrs","aria","rest","mappedAria","createP","text","createElement","enhancePs","root"],"mappings":";AA0EO,MAAMA,IAAQ,KAORC,IAAa;AA4B1B,SAASC,EAAcC,GAAyC;AAC9D,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;AA2BO,SAASE,EAAQC,GAAeL,GAAyC;AAC9E,SAAOM,EAAcT,GAAOE,EAAcC,CAAK,GAAGK,CAAI;AACxD;AAoBO,SAASE,EAAUC,IAAmB,UAAgB;AAG7D;;;;;;;;"}

package/dist/esm/chunks/index45.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index45.js","sources":["../../../src/elements/text/hr/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Hr element helpers.\n *\n * @remarks\n * The hr element (`<hr>`) represents a thematic break between paragraph-level\n * elements (e.g. a shift of topic or scene).\n *\n * Best-practice guidance:\n * - Use `<hr>` for semantic separation of content, not for visual decoration.\n * - Avoid obsolete presentational attributes (e.g. `align`, `size`, `width`, `noshade`);\n *   use CSS instead.\n * - Prefer native semantics. Only set `role` when you have a specific, justified reason.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create thematic breaks 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 * MDN: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/hr\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 thematic breaks.\n *\n * @category Constants\n */\nexport const HR_TAG = 'hr' as const;\n\n/**\n * A CSS selector targeting hr elements.\n *\n * @category Constants\n */\nexport const HR_SELECTOR = 'hr';\n\n/**\n * Attribute bag for hr creation/enhancement.\n *\n * @remarks\n * Hr 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 HrAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link HrAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The hr attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: HrAttrs): 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 hr element with optional global attributes.\n *\n * @remarks\n * - `<hr>` is a void element and must not carry text content.\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 `<hr>` element.\n *\n * @example\n * Create and append a thematic break:\n * ```ts\n * import { createHr } from \"@Vastare/Fundatio/elements/text/hr\";\n *\n * document.body.appendChild(createHr({ className: \"divider\" }));\n * ```\n *\n * @category DOM\n */\nexport function createHr(attrs?: HrAttrs): ElementOf<typeof HR_TAG> {\n  return createVoidElement(HR_TAG, toGlobalAttrs(attrs));\n}\n\n/**\n * Enhance hr 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 enhanceHrs(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for hr.\n  void root;\n}\n"],"names":["HR_TAG","HR_SELECTOR","toGlobalAttrs","attrs","aria","rest","mappedAria","createHr","createVoidElement","enhanceHrs","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;AAwBO,SAASE,EAASJ,GAA2C;AAClE,SAAOK,EAAkBR,GAAQE,EAAcC,CAAK,CAAC;AACvD;AAoBO,SAASM,EAAWC,IAAmB,UAAgB;AAG9D;;;;;;;;"}

package/dist/esm/chunks/index46.js

@@ -0,0 +1,29 @@
+import { c as r } from "./dom.js";
+const o = "pre", l = "pre";
+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 p = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  PRE_SELECTOR: l,
+  PRE_TAG: o,
+  createPre: s,
+  enhancePres: c
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  l as P,
+  o as a,
+  s as c,
+  c as e,
+  p as i
+};
+//# sourceMappingURL=index46.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index46.js","sources":["../../../src/elements/text/pre/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Pre element helpers.\n *\n * @remarks\n * The pre element (`<pre>`) represents preformatted text which is intended to be\n * presented \"as written\", preserving whitespace and line breaks.\n *\n * Best-practice guidance:\n * - Use `<pre>` for text where whitespace is meaningful (e.g. code blocks, ASCII art,\n *   logs, configuration snippets). :contentReference[oaicite:3]{index=3}\n * - For code examples, prefer `<pre><code>...</code></pre>` to provide clearer\n *   semantics for assistive tech and tooling.\n * - Avoid obsolete/non-standard attributes historically associated with `<pre>`\n *   such as `width`, `cols`, or `wrap`; control layout with CSS instead\n *   (e.g. `white-space: pre-wrap` or overflow rules). :contentReference[oaicite:4]{index=4}\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create preformatted blocks 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 preformatted text blocks.\n *\n * @category Constants\n */\nexport const PRE_TAG = 'pre' as const;\n\n/**\n * A CSS selector targeting pre elements.\n *\n * @category Constants\n */\nexport const PRE_SELECTOR = 'pre';\n\n/**\n * Attribute bag for pre creation/enhancement.\n *\n * @remarks\n * The `<pre>` element uses 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 PreAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link PreAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The pre attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: PreAttrs): 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 pre 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:\n * - `<pre>` preserves whitespace by default in browser rendering, but wrapping\n *   behavior is typically controlled with CSS (e.g. `white-space: pre-wrap`). :contentReference[oaicite:5]{index=5}\n *\n * @param text - Optional text content for the pre element.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<pre>` element.\n *\n * @example\n * Create a code block:\n * ```ts\n * import { createPre } from \"@Vastare/Fundatio/elements/text/pre\";\n *\n * const pre = createPre(\"npm run build\\nnpm run test\", {\n *   className: \"code-block\",\n *   aria: { label: \"Command output\" }\n * });\n *\n * document.body.appendChild(pre);\n * ```\n *\n * @category DOM\n */\nexport function createPre(text?: string, attrs?: PreAttrs): ElementOf<typeof PRE_TAG> {\n  return createElement(PRE_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance pre 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 enhancePres(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for pre.\n  void root;\n}\n"],"names":["PRE_TAG","PRE_SELECTOR","toGlobalAttrs","attrs","aria","rest","mappedAria","createPre","text","createElement","enhancePres","root"],"mappings":";AA+DO,MAAMA,IAAU,OAOVC,IAAe;AA4B5B,SAASC,EAAcC,GAA2C;AAChE,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;AAkCO,SAASE,EAAUC,GAAeL,GAA6C;AACpF,SAAOM,EAAcT,GAASE,EAAcC,CAAK,GAAGK,CAAI;AAC1D;AAoBO,SAASE,EAAYC,IAAmB,UAAgB;AAG/D;;;;;;;;"}

package/dist/esm/chunks/index47.js

@@ -0,0 +1,29 @@
+import { c as i } from "./dom.js";
+const r = "blockquote", c = "blockquote";
+function s(t) {
+  if (!t) return;
+  const { aria: e, cite: a, ...l } = t, n = { ...l };
+  if (typeof a == "string" && a.length > 0 && (n.attrs = { ...l.attrs ?? {}, cite: a }), !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 i(r, s(e), t);
+}
+function b(t = document) {
+}
+const u = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  BLOCKQUOTE_SELECTOR: c,
+  BLOCKQUOTE_TAG: r,
+  createBlockquote: d,
+  enhanceBlockquotes: b
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  c as B,
+  r as a,
+  d as c,
+  b as e,
+  u as i
+};
+//# sourceMappingURL=index47.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index47.js","sources":["../../../src/elements/text/blockquote/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Blockquote element helpers.\n *\n * @remarks\n * The blockquote element (`<blockquote>`) represents a section that is quoted\n * from another source.\n *\n * Best-practice guidance:\n * - Use `<blockquote>` for longer, block-level quotations.\n * - Use `<q>` for short, inline quotations.\n * - If you provide a citation URL, set the `cite` attribute, but also consider\n *   providing a visible citation in content (e.g. a link or a `<cite>` element),\n *   since many user agents do not surface `cite` automatically.\n * - Avoid presentational attributes. Use CSS for styling.\n *\n * Element-specific attributes:\n * - `cite`: A URL for the source of the quotation (when available).\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create block quotes 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/blockquote\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 block quotes.\n *\n * @category Constants\n */\nexport const BLOCKQUOTE_TAG = 'blockquote' as const;\n\n/**\n * A CSS selector targeting blockquote elements.\n *\n * @category Constants\n */\nexport const BLOCKQUOTE_SELECTOR = 'blockquote';\n\n/**\n * Attribute bag for blockquote creation/enhancement.\n *\n * @remarks\n * Blockquote accepts standard HTML global attributes and one element-specific\n * attribute:\n * - `cite`: A URL pointing to the quoted source (when available).\n *\n * Fundatio also supports a structured ARIA input for common ARIA fields, which is\n * mapped into {@link GlobalAttrs.aria}.\n *\n * Security note:\n * - Inline event handler attributes (e.g. `onclick`) are blocked by `dom.ts`.\n * - The raw `style` attribute is blocked; use {@link GlobalAttrs.style}.\n *\n * @category Attributes\n */\nexport type BlockquoteAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Citation URL for the source of the quote.\n   *\n   * @remarks\n   * This maps to the `cite` attribute. When present, it should be a valid URL.\n   * Consider also including a visible citation in the document content.\n   */\n  cite?: string;\n\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link BlockquoteAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The blockquote attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: BlockquoteAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, cite, ...rest } = attrs;\n\n  const mapped: GlobalAttrs = { ...rest };\n\n  // Map element-specific attribute(s) into the escape hatch.\n  if (typeof cite === 'string' && cite.length > 0) {\n    mapped.attrs = { ...(rest.attrs ?? {}), cite };\n  }\n\n  if (!aria) return mapped;\n\n  const mappedAria: NonNullable<GlobalAttrs['aria']> = {};\n\n  if (typeof aria.label === 'string') mappedAria.label = aria.label;\n  if (typeof aria.labelledby === 'string') mappedAria.labelledby = aria.labelledby;\n  if (typeof aria.hidden === 'boolean') mappedAria.hidden = aria.hidden;\n\n  const hasMapped = Object.keys(mappedAria).length > 0;\n\n  return hasMapped ? { ...mapped, aria: mappedAria } : mapped;\n}\n\n/**\n * Create a blockquote 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 * Note: `<blockquote>` typically contains flow content (e.g. paragraphs). This\n * helper supports a simple `text` convenience for cases where plain text is\n * sufficient; consumers can still append richer child nodes afterwards.\n *\n * @param text - Optional text content for the blockquote.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<blockquote>` element.\n *\n * @example\n * ```ts\n * import { createBlockquote } from \"@Vastare/Fundatio/elements/text/blockquote\";\n *\n * const q = createBlockquote(\"To be, or not to be...\", {\n *   cite: \"https://example.com/source\",\n *   className: \"quote\",\n *   aria: { label: \"Quotation\" }\n * });\n *\n * document.body.appendChild(q);\n * ```\n *\n * @category DOM\n */\nexport function createBlockquote(\n  text?: string,\n  attrs?: BlockquoteAttrs,\n): ElementOf<typeof BLOCKQUOTE_TAG> {\n  return createElement(BLOCKQUOTE_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance blockquote 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 enhanceBlockquotes(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for blockquote.\n  void root;\n}\n"],"names":["BLOCKQUOTE_TAG","BLOCKQUOTE_SELECTOR","toGlobalAttrs","attrs","aria","cite","rest","mapped","mappedAria","createBlockquote","text","createElement","enhanceBlockquotes","root"],"mappings":";AAmEO,MAAMA,IAAiB,cAOjBC,IAAsB;AA2CnC,SAASC,EAAcC,GAAkD;AACvE,MAAI,CAACA,EAAO;AAEZ,QAAM,EAAE,MAAAC,GAAM,MAAAC,GAAM,GAAGC,MAASH,GAE1BI,IAAsB,EAAE,GAAGD,EAAA;AAOjC,MAJI,OAAOD,KAAS,YAAYA,EAAK,SAAS,MAC5CE,EAAO,QAAQ,EAAE,GAAID,EAAK,SAAS,CAAA,GAAK,MAAAD,EAAA,IAGtC,CAACD,EAAM,QAAOG;AAElB,QAAMC,IAA+C,CAAA;AAErD,SAAI,OAAOJ,EAAK,SAAU,aAAUI,EAAW,QAAQJ,EAAK,QACxD,OAAOA,EAAK,cAAe,aAAUI,EAAW,aAAaJ,EAAK,aAClE,OAAOA,EAAK,UAAW,cAAWI,EAAW,SAASJ,EAAK,SAE7C,OAAO,KAAKI,CAAU,EAAE,SAAS,IAEhC,EAAE,GAAGD,GAAQ,MAAMC,MAAeD;AACvD;AAkCO,SAASE,EACdC,GACAP,GACkC;AAClC,SAAOQ,EAAcX,GAAgBE,EAAcC,CAAK,GAAGO,CAAI;AACjE;AAoBO,SAASE,EAAmBC,IAAmB,UAAgB;AAGtE;;;;;;;;"}

package/dist/esm/chunks/index48.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index48.js","sources":["../../../src/elements/text/address/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Address (`address`) element helpers.\n *\n * @remarks\n * The address element (`<address>`) represents contact information for a person,\n * people, or an organization.\n *\n * Best-practice guidance:\n * - Use `<address>` for contact information associated with the nearest\n *   `<article>` or `<body>` ancestor.\n * - Do not use `<address>` for arbitrary postal addresses. It is about contact\n *   information for the author/owner/organization associated with the content.\n * - Avoid using `<address>` purely for styling (e.g. italics/indentation).\n *   Presentation is the job of CSS.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create address blocks 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: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/address\n * - WHATWG: https://html.spec.whatwg.org/multipage/sections.html#the-address-element\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   * @remarks\n   * Prefer `labelledby` when a visible labeling element exists.\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 address blocks.\n *\n * @category Constants\n */\nexport const ADDRESS_TAG = 'address' as const;\n\n/**\n * A CSS selector targeting address elements.\n *\n * @category Constants\n */\nexport const ADDRESS_SELECTOR = 'address';\n\n/**\n * Attribute bag for address creation/enhancement.\n *\n * @remarks\n * Address 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 AddressAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link AddressAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The address attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: AddressAttrs): 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 address 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 address.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<address>` element.\n *\n * @example\n * ```ts\n * import { createAddress } from \"@Vastare/Fundatio/elements/text/address\";\n *\n * document.body.appendChild(\n *   createAddress(\"Contact: hello@example.com\", { className: \"contact\" })\n * );\n * ```\n *\n * @category DOM\n */\nexport function createAddress(text?: string, attrs?: AddressAttrs): ElementOf<typeof ADDRESS_TAG> {\n  return createElement(ADDRESS_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance address 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 enhanceAddresses(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for address.\n  void root;\n}\n"],"names":["ADDRESS_TAG","ADDRESS_SELECTOR","toGlobalAttrs","attrs","aria","rest","mappedAria","createAddress","text","createElement","enhanceAddresses","root"],"mappings":";AAqEO,MAAMA,IAAc,WAOdC,IAAmB;AA4BhC,SAASC,EAAcC,GAA+C;AACpE,MAAI,CAACA,EAAO;AAEZ,QAAM,EAAE,MAAAC,GAAM,GAAGC,EAAA,IAASF;AAE1B,MAAI,CAACC,EAAM,QAAOC;AAElB,QAAMC,IAA+C,CAAA;AAErD,SAAI,OAAOF,EAAK,SAAU,aAAUE,EAAW,QAAQF,EAAK,QACxD,OAAOA,EAAK,cAAe,aAAUE,EAAW,aAAaF,EAAK,aAClE,OAAOA,EAAK,UAAW,cAAWE,EAAW,SAASF,EAAK,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,EAAiBC,IAAmB,UAAgB;AAGpE;;;;;;;;"}

package/dist/esm/chunks/index49.js

@@ -0,0 +1,31 @@
+import { c as h } from "./dom.js";
+const d = "a", u = "a";
+function A(r) {
+  if (!r) return;
+  const { aria: t, href: f, target: a, rel: s, download: l, hreflang: p, ping: i, referrerPolicy: y, type: c, ...g } = r, n = g, e = { ...n.attrs ?? {} };
+  typeof f == "string" && (e.href = f), typeof a == "string" && (e.target = a), typeof p == "string" && (e.hreflang = p), typeof y == "string" && (e.referrerpolicy = y), typeof c == "string" && (e.type = c), typeof i == "string" && (e.ping = i), Array.isArray(i) && (e.ping = i.join(" ")), typeof l == "string" && (e.download = l), l === !0 && (e.download = "");
+  const b = typeof e.rel == "string" && e.rel.trim().length > 0 ? e.rel : void 0;
+  if (typeof s == "string" ? e.rel = s : a === "_blank" && !b && (e.rel = "noopener noreferrer"), Object.keys(e).length > 0 && (n.attrs = e), !t) return n;
+  const o = {};
+  return typeof t.label == "string" && (o.label = t.label), typeof t.labelledby == "string" && (o.labelledby = t.labelledby), typeof t.hidden == "boolean" && (o.hidden = t.hidden), Object.keys(o).length > 0 ? { ...n, aria: o } : n;
+}
+function m(r, t) {
+  return h(d, A(t), r);
+}
+function _(r = document) {
+}
+const w = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  A_SELECTOR: u,
+  A_TAG: d,
+  createA: m,
+  enhanceAs: _
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  u as A,
+  d as a,
+  m as c,
+  _ as e,
+  w as i
+};
+//# sourceMappingURL=index49.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index49.js","sources":["../../../src/elements/inline/a/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Anchor (`a`) element helpers.\n *\n * @remarks\n * The anchor element (`<a>`) creates a hyperlink when the `href` attribute is\n * present. It can link to web pages, files, email addresses, locations within\n * the same page, or any URL-addressable resource.\n *\n * Best-practice guidance:\n * - Prefer clear, descriptive link text. Avoid \"click here\".\n * - If using `target=\"_blank\"`, strongly consider `rel=\"noopener noreferrer\"`\n *   to prevent opener-based attacks (reverse tabnabbing).\n * - Do not use `<a>` as a button. Use `<button>` for actions and controls.\n * - Validate/sanitize untrusted URLs before assigning them to `href`.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create anchors 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: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a\n * - WHATWG: https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-a-element\n * - MDN rel=noopener: https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/rel/noopener\n * - MDN rel=noreferrer: https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/rel/noreferrer\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   * @remarks\n   * Prefer `labelledby` when a visible labeling element exists.\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 * Common targets for anchor navigation.\n *\n * @remarks\n * Browsers also accept custom named targets (e.g. `myWindow`).\n *\n * @category Attributes\n */\nexport type AnchorTarget = '_self' | '_blank' | '_parent' | '_top' | (string & {});\n\n/**\n * Allowed values for the `referrerpolicy` attribute.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/referrerpolicy\n *\n * @category Attributes\n */\nexport type ReferrerPolicy =\n  | 'no-referrer'\n  | 'no-referrer-when-downgrade'\n  | 'origin'\n  | 'origin-when-cross-origin'\n  | 'same-origin'\n  | 'strict-origin'\n  | 'strict-origin-when-cross-origin'\n  | 'unsafe-url';\n\n/**\n * The semantic tag name for anchors.\n *\n * @category Constants\n */\nexport const A_TAG = 'a' as const;\n\n/**\n * A CSS selector targeting anchor elements.\n *\n * @category Constants\n */\nexport const A_SELECTOR = 'a';\n\n/**\n * Attribute bag for anchor creation/enhancement.\n *\n * @remarks\n * Anchor elements accept standard HTML global attributes, plus link-related\n * attributes such as `href`, `target`, and `rel`.\n *\n * Security notes:\n * - Fundatio blocks unsafe attribute *names* (e.g. `onclick`, raw `style`).\n * - Fundatio does not sanitize attribute *values*. Callers must validate untrusted\n *   URLs before passing them as `href`.\n * - When `target=\"_blank\"` is used and `rel` is not provided, Fundatio applies a\n *   conservative default: `rel=\"noopener noreferrer\"`.\n *\n * @category Attributes\n */\nexport type AnchorAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Destination URL for the hyperlink.\n   *\n   * @remarks\n   * If omitted, the anchor is not a hyperlink.\n   */\n  href?: string;\n\n  /**\n   * Where to display the linked URL.\n   */\n  target?: AnchorTarget;\n\n  /**\n   * Relationship between the current document and the linked resource.\n   *\n   * @remarks\n   * If `target=\"_blank\"` is used and `rel` is not provided, Fundatio applies\n   * `noopener noreferrer` by default.\n   */\n  rel?: string;\n\n  /**\n   * Indicates the linked resource should be downloaded.\n   *\n   * @remarks\n   * - `true` sets a bare `download` attribute.\n   * - A string sets the suggested filename.\n   */\n  download?: boolean | string;\n\n  /**\n   * Language of the linked resource.\n   */\n  hreflang?: string;\n\n  /**\n   * Space-separated list of URLs to notify (POST \"ping\") when the link is followed.\n   *\n   * @remarks\n   * Limited browser support; use with care.\n   */\n  ping?: string | string[];\n\n  /**\n   * Referrer policy for the request initiated by following the hyperlink.\n   */\n  referrerPolicy?: ReferrerPolicy;\n\n  /**\n   * MIME type hint for the linked resource.\n   */\n  type?: string;\n\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link AnchorAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - Anchor attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: AnchorAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, href, target, rel, download, hreflang, ping, referrerPolicy, type, ...rest } =\n    attrs;\n\n  const out: GlobalAttrs = rest;\n\n  // Start with any escape-hatch attrs the caller provided.\n  const rawAttrs: NonNullable<GlobalAttrs['attrs']> = { ...(out.attrs ?? {}) };\n\n  if (typeof href === 'string') rawAttrs.href = href;\n  if (typeof target === 'string') rawAttrs.target = target;\n  if (typeof hreflang === 'string') rawAttrs.hreflang = hreflang;\n  if (typeof referrerPolicy === 'string') rawAttrs.referrerpolicy = referrerPolicy;\n  if (typeof type === 'string') rawAttrs.type = type;\n\n  if (typeof ping === 'string') rawAttrs.ping = ping;\n  if (Array.isArray(ping)) rawAttrs.ping = ping.join(' ');\n\n  if (typeof download === 'string') rawAttrs.download = download;\n  if (download === true) rawAttrs.download = '';\n\n  // Apply rel (explicit wins). Otherwise provide a conservative default for target=_blank.\n  const existingRel =\n    typeof rawAttrs.rel === 'string' && rawAttrs.rel.trim().length > 0 ? rawAttrs.rel : undefined;\n\n  if (typeof rel === 'string') {\n    rawAttrs.rel = rel;\n  } else if (target === '_blank' && !existingRel) {\n    rawAttrs.rel = 'noopener noreferrer';\n  }\n\n  // Only attach `attrs` if something was actually defined.\n  if (Object.keys(rawAttrs).length > 0) out.attrs = rawAttrs;\n\n  if (!aria) return out;\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 ? { ...out, aria: mappedAria } : out;\n}\n\n/**\n * Create an anchor 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 anchor.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<a>` element.\n *\n * @example\n * ```ts\n * import { createA } from \"@Vastare/Fundatio/elements/inline/a\";\n *\n * document.body.appendChild(\n *   createA(\"Read more\", { href: \"/docs\", className: \"link\" })\n * );\n * ```\n *\n * @category DOM\n */\nexport function createA(text?: string, attrs?: AnchorAttrs): ElementOf<typeof A_TAG> {\n  return createElement(A_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance anchor 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 enhanceAs(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for anchors.\n  void root;\n}\n"],"names":["A_TAG","A_SELECTOR","toGlobalAttrs","attrs","aria","href","target","rel","download","hreflang","ping","referrerPolicy","type","rest","out","rawAttrs","existingRel","mappedAria","createA","text","createElement","enhanceAs","root"],"mappings":";AAkGO,MAAMA,IAAQ,KAORC,IAAa;AAuF1B,SAASC,EAAcC,GAA8C;AACnE,MAAI,CAACA,EAAO;AAEZ,QAAM,EAAE,MAAAC,GAAM,MAAAC,GAAM,QAAAC,GAAQ,KAAAC,GAAK,UAAAC,GAAU,UAAAC,GAAU,MAAAC,GAAM,gBAAAC,GAAgB,MAAAC,GAAM,GAAGC,EAAA,IAClFV,GAEIW,IAAmBD,GAGnBE,IAA8C,EAAE,GAAID,EAAI,SAAS,CAAA,EAAC;AAExE,EAAI,OAAOT,KAAS,aAAUU,EAAS,OAAOV,IAC1C,OAAOC,KAAW,aAAUS,EAAS,SAAST,IAC9C,OAAOG,KAAa,aAAUM,EAAS,WAAWN,IAClD,OAAOE,KAAmB,aAAUI,EAAS,iBAAiBJ,IAC9D,OAAOC,KAAS,aAAUG,EAAS,OAAOH,IAE1C,OAAOF,KAAS,aAAUK,EAAS,OAAOL,IAC1C,MAAM,QAAQA,CAAI,QAAY,OAAOA,EAAK,KAAK,GAAG,IAElD,OAAOF,KAAa,aAAUO,EAAS,WAAWP,IAClDA,MAAa,OAAMO,EAAS,WAAW;AAG3C,QAAMC,IACJ,OAAOD,EAAS,OAAQ,YAAYA,EAAS,IAAI,KAAA,EAAO,SAAS,IAAIA,EAAS,MAAM;AAWtF,MATI,OAAOR,KAAQ,WACjBQ,EAAS,MAAMR,IACND,MAAW,YAAY,CAACU,MACjCD,EAAS,MAAM,wBAIb,OAAO,KAAKA,CAAQ,EAAE,SAAS,QAAO,QAAQA,IAE9C,CAACX,EAAM,QAAOU;AAElB,QAAMG,IAA+C,CAAA;AAErD,SAAI,OAAOb,EAAK,SAAU,aAAUa,EAAW,QAAQb,EAAK,QACxD,OAAOA,EAAK,cAAe,aAAUa,EAAW,aAAab,EAAK,aAClE,OAAOA,EAAK,UAAW,cAAWa,EAAW,SAASb,EAAK,SAE7C,OAAO,KAAKa,CAAU,EAAE,SAAS,IAEhC,EAAE,GAAGH,GAAK,MAAMG,MAAeH;AACpD;AA0BO,SAASI,EAAQC,GAAehB,GAA8C;AACnF,SAAOiB,EAAcpB,GAAOE,EAAcC,CAAK,GAAGgB,CAAI;AACxD;AAoBO,SAASE,EAAUC,IAAmB,UAAgB;AAG7D;;;;;;;;"}

package/dist/esm/chunks/index5.js

@@ -0,0 +1,27 @@
+import { i } from "./index28.js";
+import { i as o } from "./index29.js";
+import { i as r } from "./index30.js";
+import { i as t } from "./index31.js";
+import { i as e } from "./index32.js";
+import { i as m } from "./index33.js";
+import { i as a } from "./index34.js";
+import { i as d } from "./index35.js";
+import { i as n } from "./index36.js";
+import { i as p } from "./index37.js";
+const y = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  caption: p,
+  col: r,
+  colgroup: o,
+  table: i,
+  tbody: e,
+  td: n,
+  tfoot: m,
+  th: d,
+  thead: t,
+  tr: a
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  y as i
+};
+//# sourceMappingURL=index5.js.map

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

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

package/dist/esm/chunks/index50.js

@@ -0,0 +1,29 @@
+import { c as r } from "./dom.js";
+const o = "abbr", l = "abbr";
+function b(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 i(t, e) {
+  return r(o, b(e), t);
+}
+function s(t = document) {
+}
+const f = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  ABBR_SELECTOR: l,
+  ABBR_TAG: o,
+  createAbbr: i,
+  enhanceAbbrs: s
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  l as A,
+  o as a,
+  i as c,
+  s as e,
+  f as i
+};
+//# sourceMappingURL=index50.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index50.js","sources":["../../../src/elements/inline/abbr/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Abbreviation (`abbr`) element helpers.\n *\n * @remarks\n * The abbreviation element (`<abbr>`) represents an abbreviation or acronym.\n *\n * Best-practice guidance:\n * - Provide the expanded form in plain text on first use where possible.\n * - Optionally provide an expansion via the `title` attribute.\n *   Spec guidance: if `title` is used on `<abbr>`, it should contain the expansion\n *   of the abbreviation and nothing else.\n * - Do not rely solely on `title` tooltips for accessibility; tooltip exposure\n *   varies across browsers and assistive technologies.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create abbr 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: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/abbr\n * - WHATWG: https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-abbr-element\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 abbreviations.\n *\n * @category Constants\n */\nexport const ABBR_TAG = 'abbr' as const;\n\n/**\n * A CSS selector targeting abbr elements.\n *\n * @category Constants\n */\nexport const ABBR_SELECTOR = 'abbr';\n\n/**\n * Attribute bag for abbr creation/enhancement.\n *\n * @remarks\n * Abbr elements accept standard HTML global attributes.\n *\n * For expansions, prefer:\n * - expanding the term in plain text on first use, and/or\n * - using {@link GlobalAttrs.title} to provide an expansion (advisory text).\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 AbbrAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link AbbrAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The abbr attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: AbbrAttrs): 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 abbr 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 abbreviation (e.g. \"NASA\").\n * @param attrs - Optional attributes to apply (e.g. `title` for expansion).\n * @returns The created `<abbr>` element.\n *\n * @example\n * ```ts\n * import { createAbbr } from \"@Vastare/Fundatio/elements/inline/abbr\";\n *\n * const el = createAbbr(\"NASA\", { title: \"National Aeronautics and Space Administration\" });\n * document.body.appendChild(el);\n * ```\n *\n * @category DOM\n */\nexport function createAbbr(text?: string, attrs?: AbbrAttrs): ElementOf<typeof ABBR_TAG> {\n  return createElement(ABBR_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance abbr 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 enhanceAbbrs(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for abbr.\n  void root;\n}\n"],"names":["ABBR_TAG","ABBR_SELECTOR","toGlobalAttrs","attrs","aria","rest","mappedAria","createAbbr","text","createElement","enhanceAbbrs","root"],"mappings":";AAiEO,MAAMA,IAAW,QAOXC,IAAgB;AAgC7B,SAASC,EAAcC,GAA4C;AACjE,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,EAAWC,GAAeL,GAA+C;AACvF,SAAOM,EAAcT,GAAUE,EAAcC,CAAK,GAAGK,CAAI;AAC3D;AAoBO,SAASE,EAAaC,IAAmB,UAAgB;AAGhE;;;;;;;;"}

package/dist/esm/chunks/index51.js

@@ -0,0 +1,29 @@
+import { c as l } from "./dom.js";
+const o = "b", r = "b";
+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,
+  B_SELECTOR: r,
+  B_TAG: o,
+  createB: s,
+  enhanceBs: c
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  r as B,
+  o as a,
+  s as c,
+  c as e,
+  f as i
+};
+//# sourceMappingURL=index51.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index51.js","sources":["../../../src/elements/inline/b/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: B element helpers.\n *\n * @remarks\n * The b element (`<b>`) represents a span of text to which attention is being\n * drawn for utilitarian purposes, without conveying extra importance.\n *\n * Best-practice guidance:\n * - Use `<b>` to draw attention without implying importance.\n * - Use `<strong>` for strong importance and `<em>` for stress emphasis.\n * - Do not use `<b>` purely for styling. Prefer CSS (e.g. `font-weight`) when the\n *   goal is visual bolding rather than semantics.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create inline attention spans 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 * MDN: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/b\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 \"bring attention to\" spans.\n *\n * @category Constants\n */\nexport const B_TAG = 'b' as const;\n\n/**\n * A CSS selector targeting b elements.\n *\n * @category Constants\n */\nexport const B_SELECTOR = 'b';\n\n/**\n * Attribute bag for b creation/enhancement.\n *\n * @remarks\n * B 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 BAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link BAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The b attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: BAttrs): 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 b 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 b element.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<b>` element.\n *\n * @example\n * ```ts\n * import { createB } from \"@Vastare/Fundatio/elements/inline/b\";\n *\n * document.body.appendChild(createB(\"Keyword\", { className: \"keyword\" }));\n * ```\n *\n * @category DOM\n */\nexport function createB(text?: string, attrs?: BAttrs): ElementOf<typeof B_TAG> {\n  return createElement(B_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance b 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 enhanceBs(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for b.\n  void root;\n}\n"],"names":["B_TAG","B_SELECTOR","toGlobalAttrs","attrs","aria","rest","mappedAria","createB","text","createElement","enhanceBs","root"],"mappings":";AA2DO,MAAMA,IAAQ,KAORC,IAAa;AA4B1B,SAASC,EAAcC,GAAyC;AAC9D,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,EAAQC,GAAeL,GAAyC;AAC9E,SAAOM,EAAcT,GAAOE,EAAcC,CAAK,GAAGK,CAAI;AACxD;AAoBO,SAASE,EAAUC,IAAmB,UAAgB;AAG7D;;;;;;;;"}

package/dist/esm/chunks/index52.js

@@ -0,0 +1,29 @@
+import { c as o } from "./dom.js";
+const n = "small", r = "small";
+function i(t) {
+  if (!t) return;
+  const { aria: e, ...l } = t;
+  if (!e) return l;
+  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 ? { ...l, aria: a } : l;
+}
+function s(t, e) {
+  return o(n, i(e), t);
+}
+function c(t = document) {
+}
+const f = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  SMALL_SELECTOR: r,
+  SMALL_TAG: n,
+  createSmall: s,
+  enhanceSmalls: c
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  r as S,
+  n as a,
+  s as c,
+  c as e,
+  f as i
+};
+//# sourceMappingURL=index52.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index52.js","sources":["../../../src/elements/inline/small/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Small element helpers.\n *\n * @remarks\n * The small element (`<small>`) represents side comments and small print.\n *\n * Best-practice guidance:\n * - Use `<small>` for side notes, disclaimers, legal restrictions, copyright,\n *   attribution, or licensing text.\n * - Do not use `<small>` purely to make text visually smaller. Use CSS when the\n *   intent is presentational rather than semantic.\n * - Keep accessible meaning intact: if the content is important, it should be\n *   readable and not \"hidden\" behind styling choices.\n *\n * Attributes:\n * - `<small>` has no element-specific attributes in HTML. It accepts global\n *   attributes only.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create `<small>` 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/small\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 the small element.\n *\n * @category Constants\n */\nexport const SMALL_TAG = 'small' as const;\n\n/**\n * A CSS selector targeting small elements.\n *\n * @category Constants\n */\nexport const SMALL_SELECTOR = 'small';\n\n/**\n * Attribute bag for small creation/enhancement.\n *\n * @remarks\n * `<small>` 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 * Security note:\n * - Inline event handler attributes (e.g. `onclick`) are blocked by `dom.ts`.\n * - The raw `style` attribute is blocked; use {@link GlobalAttrs.style}.\n *\n * @category Attributes\n */\nexport type SmallAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link SmallAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The small attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: SmallAttrs): 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 small 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 * Note: `<small>` is phrasing content. This helper supports a simple `text`\n * convenience for cases where plain text is sufficient; consumers can still\n * append richer child nodes afterwards.\n *\n * @param text - Optional text content for the small element.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<small>` element.\n *\n * @example\n * ```ts\n * import { createSmall } from \"@Vastare/Fundatio/elements/inline/small\";\n *\n * const legal = createSmall(\"Terms apply.\", { className: \"legal\" });\n * document.body.appendChild(legal);\n * ```\n *\n * @category DOM\n */\nexport function createSmall(text?: string, attrs?: SmallAttrs): ElementOf<typeof SMALL_TAG> {\n  return createElement(SMALL_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance small 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 enhanceSmalls(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for small.\n  void root;\n}\n"],"names":["SMALL_TAG","SMALL_SELECTOR","toGlobalAttrs","attrs","aria","rest","mappedAria","createSmall","text","createElement","enhanceSmalls","root"],"mappings":";AAmEO,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,SAE7C,OAAO,KAAKE,CAAU,EAAE,SAAS,IAEhC,EAAE,GAAGD,GAAM,MAAMC,MAAeD;AACrD;AA6BO,SAASE,EAAYC,GAAeL,GAAiD;AAC1F,SAAOM,EAAcT,GAAWE,EAAcC,CAAK,GAAGK,CAAI;AAC5D;AAoBO,SAASE,EAAcC,IAAmB,UAAgB;AAGjE;;;;;;;;"}