@vastare/fundatio 0.1.0

package/dist/esm/chunks/index106.js

@@ -0,0 +1,29 @@
+import { c as r } from "./dom.js";
+const a = "footer", l = "footer";
+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, e) {
+  return r(a, i(e), t);
+}
+function c(t = document) {
+}
+const b = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  FOOTER_SELECTOR: l,
+  FOOTER_TAG: a,
+  createFooter: s,
+  enhanceFooters: c
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  l as F,
+  a,
+  s as c,
+  c as e,
+  b as i
+};
+//# sourceMappingURL=index106.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index106.js","sources":["../../../src/elements/layout/footer/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Footer element helpers.\n *\n * @remarks\n * The footer element (`<footer>`) represents a footer for its nearest ancestor\n * sectioning content or sectioning root. It can be used as a page footer or as\n * a footer within an `<article>`, `<section>`, etc.\n *\n * Best-practice guidance:\n * - Use `<footer>` for information about the section it belongs to (author info,\n *   related links, legal text, etc.).\n * - Do not use `<footer>` purely for visual positioning. Layout is CSS; meaning\n *   is HTML.\n * - Prefer native semantics. Only add ARIA roles when needed.\n *\n * Fundatio notes:\n * - This module is framework-agnostic and has no side effects.\n * - Global attributes are applied via Fundatio's shared DOM helper, which blocks:\n *   - inline event handler attributes (e.g. `onclick`)\n *   - raw `style` attribute injection (use the `style` object instead)\n * - Text passed to factories is assigned via `textContent` (never `innerHTML`).\n *\n * References:\n * - MDN: `<footer>` 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.\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 footer.\n *\n * @category Constants\n */\nexport const FOOTER_TAG = 'footer' as const;\n\n/**\n * A CSS selector targeting footer elements.\n *\n * @category Constants\n */\nexport const FOOTER_SELECTOR = 'footer';\n\n/**\n * Attribute bag for footer creation/enhancement.\n *\n * @remarks\n * Footer 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 FooterAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link FooterAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The footer attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: FooterAttrs): 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 footer 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 footer.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<footer>` element.\n *\n * @example\n * ```ts\n * import { createFooter } from \"@Vastare/Fundatio/elements/layout/footer\";\n *\n * const f = createFooter(\"© 2026\", { className: \"site-footer\" });\n * ```\n *\n * @category DOM\n */\nexport function createFooter(text?: string, attrs?: FooterAttrs): ElementOf<typeof FOOTER_TAG> {\n  return createElement(FOOTER_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance footer elements within a given root.\n *\n * @remarks\n * This is intentionally a no-op in `1.0.0`.\n *\n * Why does it exist?\n * - It establishes a stable integration pattern for frameworks (Vue/React/etc.)\n * - It allows future progressive enhancements without changing consumer code\n *\n * @param root - The node to search within. Defaults to `document`.\n *\n * @category Enhancement\n */\nexport function enhanceFooters(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for footer.\n  void root;\n}\n"],"names":["FOOTER_TAG","FOOTER_SELECTOR","toGlobalAttrs","attrs","aria","rest","mappedAria","createFooter","text","createElement","enhanceFooters","root"],"mappings":";AAgEO,MAAMA,IAAa,UAObC,IAAkB;AA4B/B,SAASC,EAAcC,GAA8C;AACnE,MAAI,CAACA,EAAO;AAEZ,QAAM,EAAE,MAAAC,GAAM,GAAGC,EAAA,IAASF;AAE1B,MAAI,CAACC,EAAM,QAAOC;AAElB,QAAMC,IAA+C,CAAA;AAErD,SAAI,OAAOF,EAAK,SAAU,aAAUE,EAAW,QAAQF,EAAK,QACxD,OAAOA,EAAK,cAAe,aAAUE,EAAW,aAAaF,EAAK,aAClE,OAAOA,EAAK,UAAW,cAAWE,EAAW,SAASF,EAAK,SAE7C,OAAO,KAAKE,CAAU,EAAE,SAAS,IAEhC,EAAE,GAAGD,GAAM,MAAMC,MAAeD;AACrD;AAwBO,SAASE,EAAaC,GAAeL,GAAmD;AAC7F,SAAOM,EAAcT,GAAYE,EAAcC,CAAK,GAAGK,CAAI;AAC7D;AAgBO,SAASE,EAAeC,IAAmB,UAAgB;AAGlE;;;;;;;;"}

package/dist/esm/chunks/index107.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index107.js","sources":["../../../src/elements/layout/header/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Header (`header`) element helpers.\n *\n * @remarks\n * The header element (`<header>`) represents introductory content for its nearest\n * ancestor sectioning root or sectioning content element. It commonly contains a\n * heading (`<h1>`-`<h6>`), branding, navigation aids, or other introductory UI.\n *\n * Best-practice guidance:\n * - Use `<header>` to group introductory content for a page or section.\n * - Prefer meaningful structure (headings, landmarks) over generic containers.\n * - Avoid using `<header>` purely for styling. Use CSS classes for styling and\n *   keep semantics intentional.\n * - A top-level `<header>` (scoped to `<body>` and not inside sectioning content)\n *   may be exposed as a landmark; nested headers typically are not.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create header 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/header\n * @see https://html.spec.whatwg.org/multipage/sections.html#the-header-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 header elements.\n *\n * @category Constants\n */\nexport const HEADER_TAG = 'header' as const;\n\n/**\n * A CSS selector targeting header elements.\n *\n * @category Constants\n */\nexport const HEADER_SELECTOR = 'header';\n\n/**\n * Attribute bag for header creation/enhancement.\n *\n * @remarks\n * `<header>` 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 HeaderAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link HeaderAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The header attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: HeaderAttrs): 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 header 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 header.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<header>` element.\n *\n * @example\n * Create and append a header:\n * ```ts\n * import { createHeader } from \"@Vastare/Fundatio/elements/layout/header\";\n *\n * document.body.prepend(\n *   createHeader(undefined, { className: \"site-header\" })\n * );\n * ```\n *\n * @category DOM\n */\nexport function createHeader(text?: string, attrs?: HeaderAttrs): ElementOf<typeof HEADER_TAG> {\n  return createElement(HEADER_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance header 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 enhanceHeaders(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for header.\n  void root;\n}\n"],"names":["HEADER_TAG","HEADER_SELECTOR","toGlobalAttrs","attrs","aria","rest","mappedAria","createHeader","text","createElement","enhanceHeaders","root"],"mappings":";AAkEO,MAAMA,IAAa,UAObC,IAAkB;AA4B/B,SAASC,EAAcC,GAA8C;AACnE,MAAI,CAACA,EAAO;AAEZ,QAAM,EAAE,MAAAC,GAAM,GAAGC,EAAA,IAASF;AAE1B,MAAI,CAACC,EAAM,QAAOC;AAElB,QAAMC,IAA+C,CAAA;AAErD,SAAI,OAAOF,EAAK,SAAU,aAAUE,EAAW,QAAQF,EAAK,QACxD,OAAOA,EAAK,cAAe,aAAUE,EAAW,aAAaF,EAAK,aAClE,OAAOA,EAAK,UAAW,cAAWE,EAAW,SAASF,EAAK,SAG7C,OAAO,KAAKE,CAAU,EAAE,SAAS,IAEhC,EAAE,GAAGD,GAAM,MAAMC,MAAeD;AACrD;AA2BO,SAASE,EAAaC,GAAeL,GAAmD;AAC7F,SAAOM,EAAcT,GAAYE,EAAcC,CAAK,GAAGK,CAAI;AAC7D;AAoBO,SAASE,EAAeC,IAAmB,UAAgB;AAGlE;;;;;;;;"}

package/dist/esm/chunks/index108.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index108.js","sources":["../../../src/elements/layout/main/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Main element helpers.\n *\n * @remarks\n * The main element (`<main>`) represents the dominant content of the document.\n * It is a landmark element that helps assistive technologies and other tooling\n * identify the primary content area.\n *\n * Best-practice guidance:\n * - Use **only one** `<main>` per document.\n * - The content of `<main>` should be unique to the document (avoid repeated UI\n *   like nav, site chrome, copyright, etc.).\n * - Do not place `<main>` as a descendant of `<article>`, `<aside>`, `<footer>`,\n *   `<header>`, or `<nav>`.\n *\n * Attributes:\n * - `<main>` supports **global attributes only**.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create main landmarks 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: Main element (`<main>`)\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 main landmarks.\n *\n * @category Constants\n */\nexport const MAIN_TAG = 'main' as const;\n\n/**\n * A CSS selector targeting main elements.\n *\n * @category Constants\n */\nexport const MAIN_SELECTOR = 'main';\n\n/**\n * Attribute bag for main creation/enhancement.\n *\n * @remarks\n * Main 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 MainAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link MainAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The main attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: MainAttrs): 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 main 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 * This helper does not enforce document-level semantics (e.g. \"only one `<main>`\")\n * at runtime. That is a document-authoring responsibility.\n *\n * @param text - Optional text content for the main element.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<main>` element.\n *\n * @example\n * ```ts\n * import { createMain } from \"@Vastare/Fundatio/elements/layout/main\";\n *\n * document.body.appendChild(\n *   createMain(undefined, { id: \"content\", className: \"page-main\" })\n * );\n * ```\n *\n * @category DOM\n */\nexport function createMain(text?: string, attrs?: MainAttrs): ElementOf<typeof MAIN_TAG> {\n  return createElement(MAIN_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance main 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 enhanceMains(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for main.\n  void root;\n}\n"],"names":["MAIN_TAG","MAIN_SELECTOR","toGlobalAttrs","attrs","aria","rest","mappedAria","createMain","text","createElement","enhanceMains","root"],"mappings":";AAoEO,MAAMA,IAAW,QAOXC,IAAgB;AA4B7B,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;AA6BO,SAASE,EAAWC,GAAeL,GAA+C;AACvF,SAAOM,EAAcT,GAAUE,EAAcC,CAAK,GAAGK,CAAI;AAC3D;AAoBO,SAASE,EAAaC,IAAmB,UAAgB;AAGhE;;;;;;;;"}

package/dist/esm/chunks/index109.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index109.js","sources":["../../../src/elements/layout/nav/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Nav element helpers.\n *\n * @remarks\n * The nav element (`<nav>`) represents a section of a page whose purpose is to\n * provide navigation links.\n *\n * Best-practice guidance:\n * - Use `<nav>` for major navigation blocks (site navigation, table of contents).\n * - If a page has multiple navigation regions, provide an accessible name via\n *   `aria-label` or `aria-labelledby` so assistive tech can distinguish them.\n * - Avoid nesting `<nav>` elements.\n * - Prefer semantic grouping of links (e.g. lists) inside the nav.\n *\n * Fundatio provides small, framework-agnostic helpers so consumers can:\n * - create navigation regions 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/nav\n * @see https://html.spec.whatwg.org/multipage/sections.html#the-nav-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 * `<nav>` is a landmark with an implicit `navigation` role.\n *\n * Fundatio intentionally encourages naming navigation regions when multiple navs\n * exist on the same page (e.g. primary vs footer vs breadcrumb navigation).\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 nav.\n *\n * @category Constants\n */\nexport const NAV_TAG = 'nav' as const;\n\n/**\n * A CSS selector targeting nav elements.\n *\n * @category Constants\n */\nexport const NAV_SELECTOR = 'nav';\n\n/**\n * Attribute bag for nav creation/enhancement.\n *\n * @remarks\n * Nav elements accept standard HTML global attributes.\n *\n * Accessibility note:\n * - `<nav>` has an implicit landmark role.\n * - The ARIA-in-HTML mapping indicates no explicit `role` is permitted for\n *   `<nav>` in normal usage. Fundatio therefore omits `role` from {@link NavAttrs}.\n *   Name navs via `aria-label` / `aria-labelledby` instead.\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 NavAttrs = Omit<GlobalAttrs, 'aria' | 'role'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link NavAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The nav attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: NavAttrs): 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 nav 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 nav.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<nav>` element.\n *\n * @example\n * Create a labelled primary navigation region:\n * ```ts\n * import { createNav } from \"@Vastare/Fundatio/elements/layout/nav\";\n *\n * const nav = createNav(undefined, { aria: { label: \"Primary\" }, className: \"site-nav\" });\n * document.body.appendChild(nav);\n * ```\n *\n * @category DOM\n */\nexport function createNav(text?: string, attrs?: NavAttrs): ElementOf<typeof NAV_TAG> {\n  return createElement(NAV_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance nav 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 enhanceNavs(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for nav.\n  void root;\n}\n"],"names":["NAV_TAG","NAV_SELECTOR","toGlobalAttrs","attrs","aria","rest","mappedAria","createNav","text","createElement","enhanceNavs","root"],"mappings":";AAkEO,MAAMA,IAAU,OAOVC,IAAe;AAkC5B,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;AA0BO,SAASE,EAAUC,GAAeL,GAA6C;AACpF,SAAOM,EAAcT,GAASE,EAAcC,CAAK,GAAGK,CAAI;AAC1D;AAoBO,SAASE,EAAYC,IAAmB,UAAgB;AAG/D;;;;;;;;"}

package/dist/esm/chunks/index11.js

@@ -0,0 +1,35 @@
+import { i } from "./index82.js";
+import { i as o } from "./index83.js";
+import { i as r } from "./index84.js";
+import { i as e } from "./index85.js";
+import { i as t } from "./index86.js";
+import { i as m } from "./index87.js";
+import { i as a } from "./index88.js";
+import { i as n } from "./index89.js";
+import { i as p } from "./index90.js";
+import { i as d } from "./index91.js";
+import { i as s } from "./index92.js";
+import { i as f } from "./index93.js";
+import { i as x } from "./index94.js";
+import { i as $ } from "./index95.js";
+const T = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  button: i,
+  datalist: o,
+  fieldset: r,
+  form: e,
+  input: t,
+  label: m,
+  legend: a,
+  meter: n,
+  optgroup: p,
+  option: d,
+  output: s,
+  progress: f,
+  select: x,
+  textarea: $
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  T as i
+};
+//# sourceMappingURL=index11.js.map

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

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

package/dist/esm/chunks/index110.js

@@ -0,0 +1,29 @@
+import { c as i } from "./dom.js";
+const a = "section", l = "section";
+function r(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 i(a, r(e), t);
+}
+function s(t = document) {
+}
+const f = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  SECTION_SELECTOR: l,
+  SECTION_TAG: a,
+  createSection: c,
+  enhanceSections: s
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  l as S,
+  a,
+  c,
+  s as e,
+  f as i
+};
+//# sourceMappingURL=index110.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index110.js","sources":["../../../src/elements/layout/section/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Section element helpers.\n *\n * @remarks\n * The section element (`<section>`) represents a standalone thematic grouping of\n * content, typically with a heading.\n *\n * Best-practice guidance:\n * - Do not treat `<section>` as a \"semantic `<div>`\". Use it when the content is a\n *   distinct theme that belongs in the document outline.\n * - Prefer including a heading (`<h1>`-`<h6>`) that describes the section's purpose.\n * - If you just need a generic container with no semantic meaning, use `<div>`.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create sections 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/section\n * - HTML Standard: https://html.spec.whatwg.org/multipage/sections.html#the-section-element\n * - WHATWG blog (context): https://blog.whatwg.org/is-not-just-a-semantic\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 section elements.\n *\n * @category Constants\n */\nexport const SECTION_TAG = 'section' as const;\n\n/**\n * A CSS selector targeting section elements.\n *\n * @category Constants\n */\nexport const SECTION_SELECTOR = 'section';\n\n/**\n * Attribute bag for section creation/enhancement.\n *\n * @remarks\n * Section 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 SectionAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link SectionAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The section attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: SectionAttrs): 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 section 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 section.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<section>` element.\n *\n * @example\n * ```ts\n * import { createSection } from \"@Vastare/Fundatio/elements/layout/section\";\n *\n * const s = createSection(undefined, { id: \"features\" });\n * document.body.appendChild(s);\n * ```\n *\n * @category DOM\n */\nexport function createSection(text?: string, attrs?: SectionAttrs): ElementOf<typeof SECTION_TAG> {\n  return createElement(SECTION_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance section 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 enhanceSections(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for section.\n  void root;\n}\n"],"names":["SECTION_TAG","SECTION_SELECTOR","toGlobalAttrs","attrs","aria","rest","mappedAria","createSection","text","createElement","enhanceSections","root"],"mappings":";AAiEO,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;AAyBO,SAASE,EAAcC,GAAeL,GAAqD;AAChG,SAAOM,EAAcT,GAAaE,EAAcC,CAAK,GAAGK,CAAI;AAC9D;AAoBO,SAASE,EAAgBC,IAAmB,UAAgB;AAGnE;;;;;;;;"}

package/dist/esm/chunks/index12.js

@@ -0,0 +1,13 @@
+import { i as e } from "./index96.js";
+import { i } from "./index97.js";
+import { i as o } from "./index98.js";
+const m = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  details: e,
+  dialog: i,
+  summary: o
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  m as i
+};
+//# sourceMappingURL=index12.js.map

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

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

package/dist/esm/chunks/index13.js

@@ -0,0 +1,17 @@
+import { i as e } from "./index99.js";
+import { i } from "./index100.js";
+import { i as r } from "./index101.js";
+import { i as o } from "./index102.js";
+import { i as t } from "./index103.js";
+const s = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  area: e,
+  map: i,
+  picture: r,
+  source: o,
+  track: t
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  s as i
+};
+//# sourceMappingURL=index13.js.map

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

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

package/dist/esm/chunks/index14.js

@@ -0,0 +1,21 @@
+import { i } from "./index104.js";
+import { i as e } from "./index105.js";
+import { i as o } from "./index106.js";
+import { i as r } from "./index107.js";
+import { i as t } from "./index108.js";
+import { i as m } from "./index109.js";
+import { i as a } from "./index110.js";
+const l = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  article: i,
+  aside: e,
+  footer: o,
+  header: r,
+  main: t,
+  nav: m,
+  section: a
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  l as i
+};
+//# sourceMappingURL=index14.js.map

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

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

package/dist/esm/chunks/index15.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index15.js","sources":["../../../src/elements/container/div/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Div element helpers.\n *\n * @remarks\n * The div element (`<div>`) is a non-semantic, generic container.\n *\n * Best-practice guidance:\n * - Prefer semantic elements when available (e.g. `<section>`, `<nav>`, `<article>`).\n * - Use `<div>` as a last resort when no semantic element fits.\n * - Avoid obsolete attributes like `align`; use CSS instead.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create div containers 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 div containers.\n *\n * @category Constants\n */\nexport const DIV_TAG = 'div' as const;\n\n/**\n * A CSS selector targeting div elements.\n *\n * @category Constants\n */\nexport const DIV_SELECTOR = 'div';\n\n/**\n * Attribute bag for div creation/enhancement.\n *\n * @remarks\n * Div 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 DivAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link DivAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The div attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: DivAttrs): 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 div 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 div.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<div>` element.\n *\n * @example\n * Create and append a div:\n * ```ts\n * import { createDiv } from \"@Vastare/Fundatio/elements/container/div\";\n *\n * document.body.appendChild(\n *   createDiv(\"Hello.\", { className: \"box\", id: \"root\" })\n * );\n * ```\n *\n * @category DOM\n */\nexport function createDiv(text?: string, attrs?: DivAttrs): ElementOf<typeof DIV_TAG> {\n  return createElement(DIV_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance div 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 enhanceDivs(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for div.\n  void root;\n}\n"],"names":["DIV_TAG","DIV_SELECTOR","toGlobalAttrs","attrs","aria","rest","mappedAria","createDiv","text","createElement","enhanceDivs","root"],"mappings":";AA0DO,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;AA2BO,SAASE,EAAUC,GAAeL,GAA6C;AACpF,SAAOM,EAAcT,GAASE,EAAcC,CAAK,GAAGK,CAAI;AAC1D;AAoBO,SAASE,EAAYC,IAAmB,UAAgB;AAG/D;;;;;;;;"}

package/dist/esm/chunks/index16.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index16.js","sources":["../../../src/elements/container/span/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Span element helpers.\n *\n * @remarks\n * The `<span>` element is a generic inline container for phrasing content.\n * It has no inherent semantics and should be used only when no more suitable\n * semantic element exists.\n *\n * This module:\n * - Creates `<span>` elements via Fundatio's DOM helpers (no direct DOM calls).\n * - Applies a curated subset of global attributes safely.\n * - Exposes an enhancement hook (currently a no-op) for consistency and\n *   potential future progressive enhancements.\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 span.\n *\n * @category Constants\n */\nexport const SPAN_TAG = 'span' as const;\n\n/**\n * A CSS selector targeting span elements.\n *\n * @category Constants\n */\nexport const SPAN_SELECTOR = 'span';\n\n/**\n * Attribute bag for span creation/enhancement.\n *\n * @remarks\n * `<span>` 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 SpanAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link SpanAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The span attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: SpanAttrs): 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 a span 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 span.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<span>` element.\n *\n * @category DOM\n */\nexport function createSpan(text?: string, attrs?: SpanAttrs): ElementOf<typeof SPAN_TAG> {\n  return createElement(SPAN_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance span 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 enhanceSpans(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for span.\n  void root;\n}\n"],"names":["SPAN_TAG","SPAN_SELECTOR","toGlobalAttrs","attrs","aria","rest","mappedAria","createSpan","text","createElement","enhanceSpans","root"],"mappings":";AAmDO,MAAMA,IAAW,QAOXC,IAAgB;AA4B7B,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,SAExD,OAAO,KAAKE,CAAU,EAAE,SAAS,IAAI,EAAE,GAAGD,GAAM,MAAMC,EAAA,IAAeD;AAC9E;AAkBO,SAASE,EAAWC,GAAeL,GAA+C;AACvF,SAAOM,EAAcT,GAAUE,EAAcC,CAAK,GAAGK,CAAI;AAC3D;AAaO,SAASE,EAAaC,IAAmB,UAAgB;AAGhE;;;;;;;;"}

package/dist/esm/chunks/index17.js

@@ -0,0 +1,29 @@
+import { a as r } from "./dom.js";
+const o = "br", l = "br";
+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,
+  BR_SELECTOR: l,
+  BR_TAG: o,
+  createBr: s,
+  enhanceBrs: d
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  l as B,
+  o as a,
+  s as c,
+  d as e,
+  f as i
+};
+//# sourceMappingURL=index17.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index17.js","sources":["../../../src/elements/break/br/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Br element helpers.\n *\n * @remarks\n * The br element (`<br>`) represents a line break within phrasing content.\n *\n * Best-practice guidance:\n * - Use `<br>` only for line breaks within text (e.g. poems, addresses).\n * - Do not use `<br>` for layout or spacing. Use CSS instead.\n * - `<br>` is a void element and must not contain text content.\n *\n * This module provides a small, framework-agnostic helper so consumers can:\n * - create line breaks safely in vanilla JS/TS\n * - apply consistent global attributes via Fundatio's hardened DOM helpers\n * - rely on a stable enhancement hook for future evolution\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 { 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.\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 line break elements.\n *\n * @category Constants\n */\nexport const BR_TAG = 'br' as const;\n\n/**\n * A CSS selector targeting br elements.\n *\n * @category Constants\n */\nexport const BR_SELECTOR = 'br';\n\n/**\n * Attribute bag for br creation/enhancement.\n *\n * @remarks\n * `<br>` accepts only global HTML attributes.\n * It does not accept text content and has no element-specific attributes.\n *\n * @category Attributes\n */\nexport type BrAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link BrAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The br attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: BrAttrs): 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 br element with optional global attributes.\n *\n * @remarks\n * - `<br>` is a void element and does not accept 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 `<br>` element.\n *\n * @example\n * ```ts\n * import { createBr } from \"@Vastare/Fundatio/elements/break/br\";\n *\n * paragraph.appendChild(createBr());\n * ```\n *\n * @category DOM\n */\nexport function createBr(attrs?: BrAttrs): ElementOf<typeof BR_TAG> {\n  return createVoidElement(BR_TAG, toGlobalAttrs(attrs));\n}\n\n/**\n * Enhance br 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 enhanceBrs(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for br.\n  void root;\n}\n"],"names":["BR_TAG","BR_SELECTOR","toGlobalAttrs","attrs","aria","rest","mappedAria","createBr","createVoidElement","enhanceBrs","root"],"mappings":";AA0DO,MAAMA,IAAS,MAOTC,IAAc;AA0B3B,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;AAuBO,SAASE,EAASJ,GAA2C;AAClE,SAAOK,EAAkBR,GAAQE,EAAcC,CAAK,CAAC;AACvD;AAcO,SAASM,EAAWC,IAAmB,UAAgB;AAG9D;;;;;;;;"}

package/dist/esm/chunks/index18.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index18.js","sources":["../../../src/elements/break/wbr/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Wbr element helpers.\n *\n * @remarks\n * The wbr element (`<wbr>`) represents a word break opportunity.\n *\n * Best-practice guidance:\n * - Use `<wbr>` to suggest optional break points within long words or URLs.\n * - It does not force a line break; the browser decides if a break is needed.\n * - Do not use `<wbr>` for layout or spacing. Use CSS instead.\n * - `<wbr>` is a void element and must not contain text content.\n *\n * This module provides a small, framework-agnostic helper so consumers can:\n * - create word break opportunities safely in vanilla JS/TS\n * - apply consistent global attributes via Fundatio's hardened DOM helpers\n * - rely on a stable enhancement hook for future evolution\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 { 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.\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 word break opportunity elements.\n *\n * @category Constants\n */\nexport const WBR_TAG = 'wbr' as const;\n\n/**\n * A CSS selector targeting wbr elements.\n *\n * @category Constants\n */\nexport const WBR_SELECTOR = 'wbr';\n\n/**\n * Attribute bag for wbr creation/enhancement.\n *\n * @remarks\n * `<wbr>` accepts only global HTML attributes.\n * It does not accept text content and has no element-specific attributes.\n *\n * @category Attributes\n */\nexport type WbrAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link WbrAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The wbr attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: WbrAttrs): 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 wbr element with optional global attributes.\n *\n * @remarks\n * - `<wbr>` is a void element and does not accept 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 `<wbr>` element.\n *\n * @example\n * ```ts\n * import { createWbr } from \"@Vastare/Fundatio/elements/break/wbr\";\n *\n * paragraph.appendChild(createWbr());\n * ```\n *\n * @category DOM\n */\nexport function createWbr(attrs?: WbrAttrs): ElementOf<typeof WBR_TAG> {\n  return createVoidElement(WBR_TAG, toGlobalAttrs(attrs));\n}\n\n/**\n * Enhance wbr 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 enhanceWbrs(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for wbr.\n  void root;\n}\n"],"names":["WBR_TAG","WBR_SELECTOR","toGlobalAttrs","attrs","aria","rest","mappedAria","createWbr","createVoidElement","enhanceWbrs","root"],"mappings":";AA2DO,MAAMA,IAAU,OAOVC,IAAe;AA0B5B,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,SAE7C,OAAO,KAAKE,CAAU,EAAE,SAAS,IAEhC,EAAE,GAAGD,GAAM,MAAMC,MAAeD;AACrD;AAuBO,SAASE,EAAUJ,GAA6C;AACrE,SAAOK,EAAkBR,GAASE,EAAcC,CAAK,CAAC;AACxD;AAcO,SAASM,EAAYC,IAAmB,UAAgB;AAG/D;;;;;;;;"}

package/dist/esm/chunks/index19.js

@@ -0,0 +1,43 @@
+import { a as m } from "./dom.js";
+const y = "img", u = "img";
+function _(i) {
+  const {
+    aria: e,
+    alt: n,
+    src: s,
+    srcset: a,
+    sizes: o,
+    width: l,
+    height: c,
+    loading: f,
+    decoding: d,
+    referrerPolicy: g,
+    ...h
+  } = i ?? {}, t = { ...h }, r = {};
+  e && (typeof e.label == "string" && (r.label = e.label), typeof e.labelledby == "string" && (r.labelledby = e.labelledby), typeof e.hidden == "boolean" && (r.hidden = e.hidden)), Object.keys(r).length > 0 && (t.aria = r), t.attrs = {
+    ...t.attrs ?? {},
+    alt: typeof n == "string" ? n : ""
+  };
+  const b = typeof s == "string" && s.length > 0, p = typeof a == "string" && a.length > 0;
+  return b && (t.attrs.src = s), p && (t.attrs.srcset = a), o && (t.attrs.sizes = o), typeof l == "number" && (t.attrs.width = l), typeof c == "number" && (t.attrs.height = c), f && (t.attrs.loading = f), d && (t.attrs.decoding = d), g && (t.attrs.referrerpolicy = g), !b && !p && (t.attrs.src = "data:,"), t;
+}
+function I(i) {
+  return m(y, _(i));
+}
+function S(i = document) {
+}
+const O = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  IMG_SELECTOR: u,
+  IMG_TAG: y,
+  createImg: I,
+  enhanceImgs: S
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  u as I,
+  y as a,
+  I as c,
+  S as e,
+  O as i
+};
+//# sourceMappingURL=index19.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index19.js","sources":["../../../src/elements/media/img/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Img element helpers.\n *\n * @remarks\n * The img element (`<img>`) embeds an image into the document.\n *\n * Best-practice guidance:\n * - The `alt` attribute must always be present.\n * - Use `alt=\"\"` for purely decorative images.\n * - Provide meaningful alternative text for informative images.\n * - Do not rely on images alone to convey critical information.\n *\n * This module enforces:\n * - `alt` always exists (defaults to empty string if not provided)\n * - If neither `src` nor `srcset` is provided, a safe fallback\n *   `src=\"data:,\"` is applied to avoid broken network requests\n * - All global attributes are applied via Fundatio's hardened DOM helpers\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 { createVoidElement, type ElementOf, type GlobalAttrs } from '../../../ts/dom';\n\n/**\n * Structured ARIA input supported by Fundatio element factories.\n *\n * @category Attributes\n */\nexport type StructuredAria = {\n  label?: string;\n  labelledby?: string;\n  hidden?: boolean;\n};\n\n/**\n * The semantic tag name for images.\n *\n * @category Constants\n */\nexport const IMG_TAG = 'img' as const;\n\n/**\n * A CSS selector targeting img elements.\n *\n * @category Constants\n */\nexport const IMG_SELECTOR = 'img';\n\n/**\n * Img-specific attributes.\n *\n * @remarks\n * `alt` is mandatory per HTML specification.\n *\n * @category Attributes\n */\nexport type ImgAttrs = Omit<GlobalAttrs, 'aria'> & {\n  alt?: string;\n  src?: string;\n  srcset?: string;\n  sizes?: string;\n  width?: number;\n  height?: number;\n  loading?: 'lazy' | 'eager';\n  decoding?: 'sync' | 'async' | 'auto';\n  referrerPolicy?: string;\n  aria?: StructuredAria;\n};\n\nfunction toGlobalAttrs(attrs?: ImgAttrs): GlobalAttrs {\n  const {\n    aria,\n    alt,\n    src,\n    srcset,\n    sizes,\n    width,\n    height,\n    loading,\n    decoding,\n    referrerPolicy,\n    ...rest\n  } = attrs ?? {};\n\n  const mapped: GlobalAttrs = { ...rest };\n\n  const mappedAria: NonNullable<GlobalAttrs['aria']> = {};\n\n  if (aria) {\n    if (typeof aria.label === 'string') mappedAria.label = aria.label;\n    if (typeof aria.labelledby === 'string') mappedAria.labelledby = aria.labelledby;\n    if (typeof aria.hidden === 'boolean') mappedAria.hidden = aria.hidden;\n  }\n\n  if (Object.keys(mappedAria).length > 0) {\n    mapped.aria = mappedAria;\n  }\n\n  mapped.attrs = {\n    ...(mapped.attrs ?? {}),\n    alt: typeof alt === 'string' ? alt : '',\n  };\n\n  const hasSrc = typeof src === 'string' && src.length > 0;\n  const hasSrcset = typeof srcset === 'string' && srcset.length > 0;\n\n  if (hasSrc) mapped.attrs.src = src;\n  if (hasSrcset) mapped.attrs.srcset = srcset;\n  if (sizes) mapped.attrs.sizes = sizes;\n  if (typeof width === 'number') mapped.attrs.width = width;\n  if (typeof height === 'number') mapped.attrs.height = height;\n  if (loading) mapped.attrs.loading = loading;\n  if (decoding) mapped.attrs.decoding = decoding;\n  if (referrerPolicy) mapped.attrs.referrerpolicy = referrerPolicy;\n\n  if (!hasSrc && !hasSrcset) {\n    mapped.attrs.src = 'data:,';\n  }\n\n  return mapped;\n}\n\n/**\n * Create an img element with enforced accessibility safeguards.\n *\n * @category DOM\n */\nexport function createImg(attrs?: ImgAttrs): ElementOf<typeof IMG_TAG> {\n  return createVoidElement(IMG_TAG, toGlobalAttrs(attrs));\n}\n\n/**\n * Enhance img elements within a given root.\n *\n * @remarks\n * No runtime behaviour in v1.0.0.\n *\n * @category Enhancement\n */\nexport function enhanceImgs(root: ParentNode = document): void {\n  void root;\n}\n"],"names":["IMG_TAG","IMG_SELECTOR","toGlobalAttrs","attrs","aria","alt","src","srcset","sizes","width","height","loading","decoding","referrerPolicy","rest","mapped","mappedAria","hasSrc","hasSrcset","createImg","createVoidElement","enhanceImgs","root"],"mappings":";AA2CO,MAAMA,IAAU,OAOVC,IAAe;AAuB5B,SAASC,EAAcC,GAA+B;AACpD,QAAM;AAAA,IACJ,MAAAC;AAAA,IACA,KAAAC;AAAA,IACA,KAAAC;AAAA,IACA,QAAAC;AAAA,IACA,OAAAC;AAAA,IACA,OAAAC;AAAA,IACA,QAAAC;AAAA,IACA,SAAAC;AAAA,IACA,UAAAC;AAAA,IACA,gBAAAC;AAAA,IACA,GAAGC;AAAA,EAAA,IACDX,KAAS,CAAA,GAEPY,IAAsB,EAAE,GAAGD,EAAA,GAE3BE,IAA+C,CAAA;AAErD,EAAIZ,MACE,OAAOA,EAAK,SAAU,aAAUY,EAAW,QAAQZ,EAAK,QACxD,OAAOA,EAAK,cAAe,aAAUY,EAAW,aAAaZ,EAAK,aAClE,OAAOA,EAAK,UAAW,cAAWY,EAAW,SAASZ,EAAK,UAG7D,OAAO,KAAKY,CAAU,EAAE,SAAS,MACnCD,EAAO,OAAOC,IAGhBD,EAAO,QAAQ;AAAA,IACb,GAAIA,EAAO,SAAS,CAAA;AAAA,IACpB,KAAK,OAAOV,KAAQ,WAAWA,IAAM;AAAA,EAAA;AAGvC,QAAMY,IAAS,OAAOX,KAAQ,YAAYA,EAAI,SAAS,GACjDY,IAAY,OAAOX,KAAW,YAAYA,EAAO,SAAS;AAEhE,SAAIU,MAAQF,EAAO,MAAM,MAAMT,IAC3BY,MAAWH,EAAO,MAAM,SAASR,IACjCC,MAAOO,EAAO,MAAM,QAAQP,IAC5B,OAAOC,KAAU,aAAUM,EAAO,MAAM,QAAQN,IAChD,OAAOC,KAAW,aAAUK,EAAO,MAAM,SAASL,IAClDC,MAASI,EAAO,MAAM,UAAUJ,IAChCC,MAAUG,EAAO,MAAM,WAAWH,IAClCC,MAAgBE,EAAO,MAAM,iBAAiBF,IAE9C,CAACI,KAAU,CAACC,MACdH,EAAO,MAAM,MAAM,WAGdA;AACT;AAOO,SAASI,EAAUhB,GAA6C;AACrE,SAAOiB,EAAkBpB,GAASE,EAAcC,CAAK,CAAC;AACxD;AAUO,SAASkB,EAAYC,IAAmB,UAAgB;AAE/D;;;;;;;;"}

package/dist/esm/chunks/index2.js

@@ -0,0 +1,11 @@
+import { i as e } from "./index15.js";
+import { i as o } from "./index16.js";
+const t = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  div: e,
+  span: o
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  t as i
+};
+//# sourceMappingURL=index2.js.map

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

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

package/dist/esm/chunks/index20.js

@@ -0,0 +1,35 @@
+import { b as y } from "./dom.js";
+const u = "svg", m = "svg";
+function v(l) {
+  const { aria: e, viewBox: o, width: r, height: d, role: a, tabIndex: c, attrs: p, ...h } = l ?? {}, t = { ...h };
+  a && (t.role = a);
+  const n = {}, f = typeof (e == null ? void 0 : e.label) == "string", b = typeof (e == null ? void 0 : e.labelledby) == "string", g = typeof (e == null ? void 0 : e.hidden) == "boolean";
+  f && (n.label = e.label), b && (n.labelledby = e.labelledby), g && (n.hidden = e.hidden);
+  const s = !f && !b;
+  s && !g && (n.hidden = !0), Object.keys(n).length > 0 && (t.aria = n), !s && !a && (t.role = "img"), typeof c == "number" ? t.tabIndex = c : s && (t.tabIndex = -1);
+  const i = {
+    ...p ?? {}
+  };
+  return s && (i.focusable = "false"), o && (i.viewBox = o), r !== void 0 && (i.width = r), d !== void 0 && (i.height = d), Object.keys(i).length > 0 && (t.attrs = i), t;
+}
+function x(l, e) {
+  const o = document.createElement("svg");
+  return y(o, v(e)), typeof l == "string" && (o.textContent = l), o;
+}
+function S(l = document) {
+}
+const _ = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  SVG_SELECTOR: m,
+  SVG_TAG: u,
+  createSvg: x,
+  enhanceSvgs: S
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  m as S,
+  u as a,
+  x as c,
+  S as e,
+  _ as i
+};
+//# sourceMappingURL=index20.js.map