@vastare/fundatio 0.1.0

package/dist/esm/chunks/index86.js

@@ -0,0 +1,72 @@
+import { a as D } from "./dom.js";
+const h = "input", F = "input";
+function J(o) {
+  const {
+    aria: t,
+    type: b,
+    name: y,
+    value: g,
+    placeholder: v,
+    disabled: O,
+    readOnly: T,
+    required: x,
+    multiple: A,
+    checked: _,
+    min: I,
+    max: j,
+    step: k,
+    minLength: u,
+    maxLength: c,
+    pattern: w,
+    size: f,
+    autoComplete: E,
+    autofocus: P,
+    list: z,
+    form: L,
+    formAction: M,
+    formEnctype: N,
+    formMethod: S,
+    formNoValidate: U,
+    formTarget: q,
+    src: C,
+    alt: G,
+    width: s,
+    height: d,
+    accept: V,
+    capture: a,
+    inputMode: H,
+    enterKeyHint: K,
+    popoverTarget: R,
+    popoverTargetAction: B,
+    ...m
+  } = o ?? {}, n = { ...m.attrs ?? {} }, e = (l, i) => {
+    i !== void 0 && (Object.prototype.hasOwnProperty.call(n, l) || (n[l] = i));
+  };
+  e("type", b ?? "text"), e("name", y), e("value", g), e("placeholder", v), e("min", I), e("max", j), e("step", k), e("minlength", typeof u == "number" ? u : void 0), e("maxlength", typeof c == "number" ? c : void 0), e("pattern", w), e("size", typeof f == "number" ? f : void 0), e("autocomplete", E), e("list", z), e("form", L), e("formaction", M), e("formenctype", N), e("formmethod", S), e("formtarget", q), e("src", C), e("alt", G), e("width", typeof s == "number" ? s : void 0), e("height", typeof d == "number" ? d : void 0), e("accept", V), e("inputmode", H), e("enterkeyhint", K), e("popovertarget", R), e("popovertargetaction", B), O === !0 && e("disabled", ""), T === !0 && e("readonly", ""), x === !0 && e("required", ""), A === !0 && e("multiple", ""), _ === !0 && e("checked", ""), P === !0 && e("autofocus", ""), U === !0 && e("formnovalidate", ""), a === !0 && e("capture", ""), a === "user" && e("capture", "user"), a === "environment" && e("capture", "environment");
+  const p = { ...m, attrs: n }, r = {};
+  if (t && (typeof t.label == "string" && (r.label = t.label), typeof t.labelledby == "string" && (r.labelledby = t.labelledby), typeof t.hidden == "boolean" && (r.hidden = t.hidden)), Object.keys(r).length > 0 && (p.aria = r), Object.keys(n).length === 0) {
+    const { attrs: l, ...i } = p;
+    return i;
+  }
+  return p;
+}
+function Q(o) {
+  return D(h, J(o));
+}
+function W(o = document) {
+}
+const Y = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  INPUT_SELECTOR: F,
+  INPUT_TAG: h,
+  createInput: Q,
+  enhanceInputs: W
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  F as I,
+  h as a,
+  Q as c,
+  W as e,
+  Y as i
+};
+//# sourceMappingURL=index86.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index86.js","sources":["../../../src/elements/form/input/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Input element helpers.\n *\n * @remarks\n * The input element (`<input>`) represents a typed data field whose behavior is\n * primarily controlled by its `type` attribute. :contentReference[oaicite:5]{index=5}\n *\n * Best-practice guidance:\n * - Prefer the most specific `type` possible (e.g. `email`, `tel`, `number`)\n *   to improve UX and validation behavior.\n * - Always provide an accessible name (visible label, `aria-label`, or\n *   `aria-labelledby`).\n * - Treat `autocomplete`, `inputmode`, and `enterkeyhint` as UX hints, not\n *   security controls. :contentReference[oaicite:6]{index=6}\n * - For `<input type=\"image\">`, include meaningful `alt` text; while it may be\n *   technically optional, it should be provided for usability/accessibility. :contentReference[oaicite:7]{index=7}\n *\n * Fundatio-specific conventions:\n * - Defaults `type` to `\"text\"` unless explicitly overridden (typed field or raw\n *   attrs escape hatch), matching HTML's default behavior. :contentReference[oaicite:8]{index=8}\n * - Applies global attributes via Fundatio's hardened DOM helpers (`dom.ts`),\n *   which block inline event handler attributes (e.g. `onclick`) and the raw\n *   `style` attribute string.\n * - Supports a small structured ARIA input to reduce typo-based ARIA bugs.\n *\n * This module has no side effects and does not mutate the DOM unless you call\n * its functions.\n *\n * @module\n * @category Elements\n */\n\nimport {\n  createVoidElement,\n  type AttrValue,\n  type ElementOf,\n  type GlobalAttrs,\n} from '../../../ts/dom';\n\n/**\n * Structured ARIA input supported by Fundatio element factories.\n *\n * @remarks\n * This is intentionally a small, typed subset mapped into {@link GlobalAttrs.aria}.\n *\n * @category Attributes\n */\nexport type StructuredAria = {\n  /**\n   * Accessible label, mapped to `aria-label`.\n   */\n  label?: string;\n\n  /**\n   * ID reference(s) to labelling element(s), mapped to `aria-labelledby`.\n   */\n  labelledby?: string;\n\n  /**\n   * Decorative/hidden hint, mapped to `aria-hidden`.\n   */\n  hidden?: boolean;\n};\n\n/**\n * Common input `type` values.\n *\n * @remarks\n * The `type` attribute controls which control is rendered and how values are\n * processed. :contentReference[oaicite:9]{index=9}\n *\n * Fundatio models the widely used types while still allowing the raw `attrs` escape\n * hatch for unusual/experimental values.\n *\n * @category Attributes\n */\nexport type InputType =\n  | 'text'\n  | 'password'\n  | 'email'\n  | 'number'\n  | 'search'\n  | 'tel'\n  | 'url'\n  | 'date'\n  | 'datetime-local'\n  | 'month'\n  | 'week'\n  | 'time'\n  | 'color'\n  | 'checkbox'\n  | 'radio'\n  | 'file'\n  | 'hidden'\n  | 'image'\n  | 'range'\n  | 'reset'\n  | 'submit'\n  | 'button';\n\n/**\n * Values for the `inputmode` hint.\n *\n * @remarks\n * `inputmode` is a hint to user agents about what kind of virtual keyboard to\n * show. :contentReference[oaicite:10]{index=10}\n *\n * @category Attributes\n */\nexport type InputMode =\n  | 'none'\n  | 'text'\n  | 'tel'\n  | 'url'\n  | 'email'\n  | 'numeric'\n  | 'decimal'\n  | 'search';\n\n/**\n * Values for the `enterkeyhint` hint.\n *\n * @remarks\n * Defines what action label/icon to present for the enter key on virtual\n * keyboards. :contentReference[oaicite:11]{index=11}\n *\n * @category Attributes\n */\nexport type EnterKeyHint = 'enter' | 'done' | 'go' | 'next' | 'previous' | 'search' | 'send';\n\n/**\n * Values for the `popovertargetaction` attribute when the input is used as a\n * popover invoker button.\n *\n * @category Attributes\n */\nexport type PopoverTargetAction = 'toggle' | 'show' | 'hide';\n\n/**\n * The semantic tag name for inputs.\n *\n * @category Constants\n */\nexport const INPUT_TAG = 'input' as const;\n\n/**\n * A CSS selector targeting input elements.\n *\n * @category Constants\n */\nexport const INPUT_SELECTOR = 'input';\n\n/**\n * Attribute bag for input creation/enhancement.\n *\n * @remarks\n * `<input>` supports a large surface area of attributes, many of which are\n * type-dependent. Fundatio models common attributes explicitly and provides\n * {@link GlobalAttrs.attrs} as an escape hatch (validated by `dom.ts`).\n *\n * Notes:\n * - Fundatio defaults `type` to `\"text\"` unless explicitly overridden. :contentReference[oaicite:12]{index=12}\n * - Boolean attributes are applied by presence (empty string) when `true`.\n * - For `type=\"image\"`, `alt` should be provided for accessibility. :contentReference[oaicite:13]{index=13}\n *\n * @category Attributes\n */\nexport type InputAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n\n  /**\n   * The input type. Defaults to `\"text\"` in Fundatio.\n   */\n  type?: InputType;\n\n  /**\n   * Form field name (used during submission).\n   */\n  name?: string;\n\n  /**\n   * Initial/current value (type-dependent semantics).\n   */\n  value?: string;\n\n  /**\n   * Placeholder hint (text-like types).\n   */\n  placeholder?: string;\n\n  /**\n   * Disables the control when true.\n   */\n  disabled?: boolean;\n\n  /**\n   * Marks the control read-only when true (where applicable).\n   */\n  readOnly?: boolean;\n\n  /**\n   * Marks the control required for form submission.\n   */\n  required?: boolean;\n\n  /**\n   * Enables multiple values (e.g. file inputs).\n   */\n  multiple?: boolean;\n\n  /**\n   * Marks a checkbox or radio as checked.\n   */\n  checked?: boolean;\n\n  /**\n   * Minimum value (number/date/time/range-like types).\n   */\n  min?: string | number;\n\n  /**\n   * Maximum value (number/date/time/range-like types).\n   */\n  max?: string | number;\n\n  /**\n   * Step interval (number/date/time/range-like types).\n   */\n  step?: string | number;\n\n  /**\n   * Minimum length (text-like types).\n   */\n  minLength?: number;\n\n  /**\n   * Maximum length (text-like types).\n   */\n  maxLength?: number;\n\n  /**\n   * Validation pattern (text-like types).\n   */\n  pattern?: string;\n\n  /**\n   * Size hint (visible character width, where applicable).\n   */\n  size?: number;\n\n  /**\n   * Autocomplete hint.\n   */\n  autoComplete?: string;\n\n  /**\n   * Autofocus hint.\n   */\n  autofocus?: boolean;\n\n  /**\n   * Associates the control with a datalist element by ID.\n   */\n  list?: string;\n\n  /**\n   * Associates the control with a form element by ID.\n   */\n  form?: string;\n\n  /**\n   * Overrides form submission target for submit/image inputs.\n   */\n  formAction?: string;\n\n  /**\n   * Overrides form submission encoding for submit/image inputs.\n   */\n  formEnctype?: 'application/x-www-form-urlencoded' | 'multipart/form-data' | 'text/plain';\n\n  /**\n   * Overrides form submission method for submit/image inputs.\n   */\n  formMethod?: 'get' | 'post' | 'dialog';\n\n  /**\n   * Prevents constraint validation on submission.\n   */\n  formNoValidate?: boolean;\n\n  /**\n   * Overrides form submission browsing context target.\n   */\n  formTarget?: string;\n\n  /**\n   * Source URL for `type=\"image\"`.\n   */\n  src?: string;\n\n  /**\n   * Alternate text for `type=\"image\"`.\n   *\n   * @remarks\n   * This is only meaningful for image inputs and should be provided. :contentReference[oaicite:14]{index=14}\n   */\n  alt?: string;\n\n  /**\n   * Width for `type=\"image\"`.\n   */\n  width?: number;\n\n  /**\n   * Height for `type=\"image\"`.\n   */\n  height?: number;\n\n  /**\n   * Accepted file types (for `type=\"file\"`).\n   */\n  accept?: string;\n\n  /**\n   * Media capture hint (primarily file inputs on mobile).\n   *\n   * @remarks\n   * If set to `true`, the boolean attribute is applied by presence.\n   */\n  capture?: 'user' | 'environment' | true;\n\n  /**\n   * Hint for the virtual keyboard shown on touch devices.\n   */\n  inputMode?: InputMode;\n\n  /**\n   * Hint for the virtual keyboard enter key label/icon.\n   */\n  enterKeyHint?: EnterKeyHint;\n\n  /**\n   * ID of the popover element this input controls (typically `type=\"button\"`).\n   */\n  popoverTarget?: string;\n\n  /**\n   * Action to perform on the targeted popover.\n   */\n  popoverTargetAction?: PopoverTargetAction;\n};\n\n/**\n * Normalize {@link InputAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @remarks\n * Pattern:\n * - Start with any caller-provided raw attrs escape hatch.\n * - Apply typed attributes without overriding explicit raw attributes.\n * - Map structured ARIA into {@link GlobalAttrs.aria}.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: InputAttrs): GlobalAttrs {\n  const {\n    aria,\n    type,\n    name,\n    value,\n    placeholder,\n    disabled,\n    readOnly,\n    required,\n    multiple,\n    checked,\n    min,\n    max,\n    step,\n    minLength,\n    maxLength,\n    pattern,\n    size,\n    autoComplete,\n    autofocus,\n    list,\n    form,\n    formAction,\n    formEnctype,\n    formMethod,\n    formNoValidate,\n    formTarget,\n    src,\n    alt,\n    width,\n    height,\n    accept,\n    capture,\n    inputMode,\n    enterKeyHint,\n    popoverTarget,\n    popoverTargetAction,\n    ...rest\n  } = attrs ?? {};\n\n  const mergedAttrs: Record<string, AttrValue> = { ...(rest.attrs ?? {}) };\n\n  const setIfUnset = (key: string, v: AttrValue | undefined): void => {\n    if (v === undefined) return;\n    if (Object.prototype.hasOwnProperty.call(mergedAttrs, key)) return;\n    mergedAttrs[key] = v;\n  };\n\n  // Default type to \"text\" unless explicitly overridden.\n  setIfUnset('type', type ?? 'text');\n\n  setIfUnset('name', name);\n  setIfUnset('value', value);\n  setIfUnset('placeholder', placeholder);\n  setIfUnset('min', min);\n  setIfUnset('max', max);\n  setIfUnset('step', step);\n  setIfUnset('minlength', typeof minLength === 'number' ? minLength : undefined);\n  setIfUnset('maxlength', typeof maxLength === 'number' ? maxLength : undefined);\n  setIfUnset('pattern', pattern);\n  setIfUnset('size', typeof size === 'number' ? size : undefined);\n  setIfUnset('autocomplete', autoComplete);\n  setIfUnset('list', list);\n  setIfUnset('form', form);\n\n  setIfUnset('formaction', formAction);\n  setIfUnset('formenctype', formEnctype);\n  setIfUnset('formmethod', formMethod);\n  setIfUnset('formtarget', formTarget);\n\n  setIfUnset('src', src);\n  setIfUnset('alt', alt);\n  setIfUnset('width', typeof width === 'number' ? width : undefined);\n  setIfUnset('height', typeof height === 'number' ? height : undefined);\n\n  setIfUnset('accept', accept);\n  setIfUnset('inputmode', inputMode);\n  setIfUnset('enterkeyhint', enterKeyHint);\n\n  setIfUnset('popovertarget', popoverTarget);\n  setIfUnset('popovertargetaction', popoverTargetAction);\n\n  // Boolean attributes: presence (empty string) when true.\n  if (disabled === true) setIfUnset('disabled', '');\n  if (readOnly === true) setIfUnset('readonly', '');\n  if (required === true) setIfUnset('required', '');\n  if (multiple === true) setIfUnset('multiple', '');\n  if (checked === true) setIfUnset('checked', '');\n  if (autofocus === true) setIfUnset('autofocus', '');\n  if (formNoValidate === true) setIfUnset('formnovalidate', '');\n\n  if (capture === true) setIfUnset('capture', '');\n  if (capture === 'user') setIfUnset('capture', 'user');\n  if (capture === 'environment') setIfUnset('capture', 'environment');\n\n  const mapped: GlobalAttrs = { ...rest, attrs: mergedAttrs };\n\n  const mappedAria: NonNullable<GlobalAttrs['aria']> = {};\n  if (aria) {\n    if (typeof aria.label === 'string') mappedAria.label = aria.label;\n    if (typeof aria.labelledby === 'string') mappedAria.labelledby = aria.labelledby;\n    if (typeof aria.hidden === 'boolean') mappedAria.hidden = aria.hidden;\n  }\n\n  if (Object.keys(mappedAria).length > 0) {\n    mapped.aria = mappedAria;\n  }\n\n  if (Object.keys(mergedAttrs).length === 0) {\n    const { attrs: _unused, ...withoutAttrs } = mapped;\n    return withoutAttrs;\n  }\n\n  return mapped;\n}\n\n/**\n * Create an input element with attributes.\n *\n * @remarks\n * - `<input>` is a void element; it never receives text content. :contentReference[oaicite:15]{index=15}\n * - Fundatio defaults `type` to `\"text\"` unless overridden. :contentReference[oaicite:16]{index=16}\n * - Global attributes are applied via Fundatio's shared DOM helper, including security\n *   guards that block inline event handler attributes (e.g. `onclick`) and raw\n *   `style` attribute strings.\n *\n * @param attrs - Optional attributes to apply.\n * @returns The created `<input>` element.\n *\n * @example\n * ```ts\n * import { createInput } from \"@Vastare/Fundatio/elements/form/input\";\n *\n * const email = createInput({\n *   type: \"email\",\n *   name: \"email\",\n *   autoComplete: \"email\",\n *   inputMode: \"email\",\n * });\n * ```\n *\n * @category DOM\n */\nexport function createInput(attrs?: InputAttrs): ElementOf<typeof INPUT_TAG> {\n  return createVoidElement(INPUT_TAG, toGlobalAttrs(attrs));\n}\n\n/**\n * Enhance input elements within a given root.\n *\n * @remarks\n * This is intentionally a no-op in `1.0.0`.\n *\n * @param root - The node to search within. Defaults to `document`.\n *\n * @category Enhancement\n */\nexport function enhanceInputs(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for input.\n  void root;\n}\n"],"names":["INPUT_TAG","INPUT_SELECTOR","toGlobalAttrs","attrs","aria","type","name","value","placeholder","disabled","readOnly","required","multiple","checked","min","max","step","minLength","maxLength","pattern","size","autoComplete","autofocus","list","form","formAction","formEnctype","formMethod","formNoValidate","formTarget","src","alt","width","height","accept","capture","inputMode","enterKeyHint","popoverTarget","popoverTargetAction","rest","mergedAttrs","setIfUnset","key","v","mapped","mappedAria","_unused","withoutAttrs","createInput","createVoidElement","enhanceInputs","root"],"mappings":";AA+IO,MAAMA,IAAY,SAOZC,IAAiB;AAwN9B,SAASC,EAAcC,GAAiC;AACtD,QAAM;AAAA,IACJ,MAAAC;AAAA,IACA,MAAAC;AAAA,IACA,MAAAC;AAAA,IACA,OAAAC;AAAA,IACA,aAAAC;AAAA,IACA,UAAAC;AAAA,IACA,UAAAC;AAAA,IACA,UAAAC;AAAA,IACA,UAAAC;AAAA,IACA,SAAAC;AAAA,IACA,KAAAC;AAAA,IACA,KAAAC;AAAA,IACA,MAAAC;AAAA,IACA,WAAAC;AAAA,IACA,WAAAC;AAAA,IACA,SAAAC;AAAA,IACA,MAAAC;AAAA,IACA,cAAAC;AAAA,IACA,WAAAC;AAAA,IACA,MAAAC;AAAA,IACA,MAAAC;AAAA,IACA,YAAAC;AAAA,IACA,aAAAC;AAAA,IACA,YAAAC;AAAA,IACA,gBAAAC;AAAA,IACA,YAAAC;AAAA,IACA,KAAAC;AAAA,IACA,KAAAC;AAAA,IACA,OAAAC;AAAA,IACA,QAAAC;AAAA,IACA,QAAAC;AAAA,IACA,SAAAC;AAAA,IACA,WAAAC;AAAA,IACA,cAAAC;AAAA,IACA,eAAAC;AAAA,IACA,qBAAAC;AAAA,IACA,GAAGC;AAAA,EAAA,IACDrC,KAAS,CAAA,GAEPsC,IAAyC,EAAE,GAAID,EAAK,SAAS,CAAA,EAAC,GAE9DE,IAAa,CAACC,GAAaC,MAAmC;AAClE,IAAIA,MAAM,WACN,OAAO,UAAU,eAAe,KAAKH,GAAaE,CAAG,MACzDF,EAAYE,CAAG,IAAIC;AAAA,EACrB;AAGA,EAAAF,EAAW,QAAQrC,KAAQ,MAAM,GAEjCqC,EAAW,QAAQpC,CAAI,GACvBoC,EAAW,SAASnC,CAAK,GACzBmC,EAAW,eAAelC,CAAW,GACrCkC,EAAW,OAAO5B,CAAG,GACrB4B,EAAW,OAAO3B,CAAG,GACrB2B,EAAW,QAAQ1B,CAAI,GACvB0B,EAAW,aAAa,OAAOzB,KAAc,WAAWA,IAAY,MAAS,GAC7EyB,EAAW,aAAa,OAAOxB,KAAc,WAAWA,IAAY,MAAS,GAC7EwB,EAAW,WAAWvB,CAAO,GAC7BuB,EAAW,QAAQ,OAAOtB,KAAS,WAAWA,IAAO,MAAS,GAC9DsB,EAAW,gBAAgBrB,CAAY,GACvCqB,EAAW,QAAQnB,CAAI,GACvBmB,EAAW,QAAQlB,CAAI,GAEvBkB,EAAW,cAAcjB,CAAU,GACnCiB,EAAW,eAAehB,CAAW,GACrCgB,EAAW,cAAcf,CAAU,GACnCe,EAAW,cAAcb,CAAU,GAEnCa,EAAW,OAAOZ,CAAG,GACrBY,EAAW,OAAOX,CAAG,GACrBW,EAAW,SAAS,OAAOV,KAAU,WAAWA,IAAQ,MAAS,GACjEU,EAAW,UAAU,OAAOT,KAAW,WAAWA,IAAS,MAAS,GAEpES,EAAW,UAAUR,CAAM,GAC3BQ,EAAW,aAAaN,CAAS,GACjCM,EAAW,gBAAgBL,CAAY,GAEvCK,EAAW,iBAAiBJ,CAAa,GACzCI,EAAW,uBAAuBH,CAAmB,GAGjD9B,MAAa,MAAMiC,EAAW,YAAY,EAAE,GAC5ChC,MAAa,MAAMgC,EAAW,YAAY,EAAE,GAC5C/B,MAAa,MAAM+B,EAAW,YAAY,EAAE,GAC5C9B,MAAa,MAAM8B,EAAW,YAAY,EAAE,GAC5C7B,MAAY,MAAM6B,EAAW,WAAW,EAAE,GAC1CpB,MAAc,MAAMoB,EAAW,aAAa,EAAE,GAC9Cd,MAAmB,MAAMc,EAAW,kBAAkB,EAAE,GAExDP,MAAY,MAAMO,EAAW,WAAW,EAAE,GAC1CP,MAAY,UAAQO,EAAW,WAAW,MAAM,GAChDP,MAAY,iBAAeO,EAAW,WAAW,aAAa;AAElE,QAAMG,IAAsB,EAAE,GAAGL,GAAM,OAAOC,EAAA,GAExCK,IAA+C,CAAA;AAWrD,MAVI1C,MACE,OAAOA,EAAK,SAAU,aAAU0C,EAAW,QAAQ1C,EAAK,QACxD,OAAOA,EAAK,cAAe,aAAU0C,EAAW,aAAa1C,EAAK,aAClE,OAAOA,EAAK,UAAW,cAAW0C,EAAW,SAAS1C,EAAK,UAG7D,OAAO,KAAK0C,CAAU,EAAE,SAAS,MACnCD,EAAO,OAAOC,IAGZ,OAAO,KAAKL,CAAW,EAAE,WAAW,GAAG;AACzC,UAAM,EAAE,OAAOM,GAAS,GAAGC,MAAiBH;AAC5C,WAAOG;AAAA,EACT;AAEA,SAAOH;AACT;AA6BO,SAASI,EAAY9C,GAAiD;AAC3E,SAAO+C,EAAkBlD,GAAWE,EAAcC,CAAK,CAAC;AAC1D;AAYO,SAASgD,EAAcC,IAAmB,UAAgB;AAGjE;;;;;;;;"}

package/dist/esm/chunks/index87.js

@@ -0,0 +1,32 @@
+import { c as i } from "./dom.js";
+const o = "label", s = "label";
+function b(t) {
+  if (!t) return;
+  const { aria: e, htmlFor: l, ...r } = t, a = { ...r };
+  if (typeof l == "string" && l.length > 0 && (a.attrs = {
+    ...a.attrs ?? {},
+    for: l
+  }), !e) return a;
+  const n = {};
+  return typeof e.label == "string" && (n.label = e.label), typeof e.labelledby == "string" && (n.labelledby = e.labelledby), typeof e.hidden == "boolean" && (n.hidden = e.hidden), Object.keys(n).length > 0 ? { ...a, aria: n } : a;
+}
+function c(t, e) {
+  return i(o, b(e), t);
+}
+function d(t = document) {
+}
+const u = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  LABEL_SELECTOR: s,
+  LABEL_TAG: o,
+  createLabel: c,
+  enhanceLabels: d
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  s as L,
+  o as a,
+  c,
+  d as e,
+  u as i
+};
+//# sourceMappingURL=index87.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index87.js","sources":["../../../src/elements/form/label/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Label element helpers.\n *\n * @remarks\n * The label element (`<label>`) represents a caption in a user interface and is\n * primarily used to provide an accessible name for a form control.\n *\n * Best-practice guidance:\n * - Always associate labels with their control:\n *   - Prefer an explicit association using `for` (Fundatio: {@link LabelAttrs.htmlFor})\n *     that matches the control's `id`.\n *   - Alternatively, wrap the control inside the `<label>` element.\n * - Do not rely on placeholder text as a replacement for a visible label.\n * - Keep label text concise and descriptive.\n *\n * Attributes:\n * - `<label>` supports global attributes.\n * - The only relevant label-specific content attribute is `for`, reflected in\n *   JavaScript as `htmlFor`. (The `label` element does not have a `form` content\n *   attribute; it has a `form` *IDL attribute* derived from the associated control.)\n *\n * Security:\n * - Global attribute escape hatches are guarded by Fundatio's `dom.ts` helpers which\n *   block inline event handler attributes (e.g. `onclick`) and raw `style`\n *   attribute injection (use the `style` object field instead).\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/label\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Attributes/for\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 label.\n *\n * @category Constants\n */\nexport const LABEL_TAG = 'label' as const;\n\n/**\n * A CSS selector targeting label elements.\n *\n * @category Constants\n */\nexport const LABEL_SELECTOR = 'label';\n\n/**\n * Attribute bag for label creation/enhancement.\n *\n * @remarks\n * Labels accept standard HTML global attributes.\n *\n * Label-specific:\n * - {@link LabelAttrs.htmlFor} maps to the `for` attribute, associating the label\n *   with the control whose `id` matches.\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 LabelAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n\n  /**\n   * Associate the label with a labelable form control by ID.\n   *\n   * @remarks\n   * This maps to the `for` content attribute.\n   *\n   * The value should match the `id` of a labelable element in the same document\n   * tree (e.g. `<input id=\"email\">` pairs with `<label for=\"email\">`).\n   */\n  htmlFor?: string;\n};\n\n/**\n * Normalize {@link LabelAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The label attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: LabelAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, htmlFor, ...rest } = attrs;\n\n  const mapped: GlobalAttrs = { ...rest };\n\n  if (typeof htmlFor === 'string' && htmlFor.length > 0) {\n    mapped.attrs = {\n      ...(mapped.attrs ?? {}),\n      for: htmlFor,\n    };\n  }\n\n  if (!aria) return mapped;\n\n  const mappedAria: NonNullable<GlobalAttrs['aria']> = {};\n\n  if (typeof aria.label === 'string') mappedAria.label = aria.label;\n  if (typeof aria.labelledby === 'string') mappedAria.labelledby = aria.labelledby;\n  if (typeof aria.hidden === 'boolean') mappedAria.hidden = aria.hidden;\n\n  // Only attach `aria` if something was actually defined.\n  const hasMappedAria = Object.keys(mappedAria).length > 0;\n\n  return hasMappedAria ? { ...mapped, aria: mappedAria } : mapped;\n}\n\n/**\n * Create a label 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 label.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<label>` element.\n *\n * @example\n * ```ts\n * import { createLabel } from \"@Vastare/Fundatio/elements/form/label\";\n *\n * const label = createLabel(\"Email address\", { htmlFor: \"email\" });\n * ```\n *\n * @category DOM\n */\nexport function createLabel(text?: string, attrs?: LabelAttrs): ElementOf<typeof LABEL_TAG> {\n  return createElement(LABEL_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance label 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 enhanceLabels(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for label.\n  void root;\n}\n"],"names":["LABEL_TAG","LABEL_SELECTOR","toGlobalAttrs","attrs","aria","htmlFor","rest","mapped","mappedAria","createLabel","text","createElement","enhanceLabels","root"],"mappings":";AAoEO,MAAMA,IAAY,SAOZC,IAAiB;AA2C9B,SAASC,EAAcC,GAA6C;AAClE,MAAI,CAACA,EAAO;AAEZ,QAAM,EAAE,MAAAC,GAAM,SAAAC,GAAS,GAAGC,MAASH,GAE7BI,IAAsB,EAAE,GAAGD,EAAA;AASjC,MAPI,OAAOD,KAAY,YAAYA,EAAQ,SAAS,MAClDE,EAAO,QAAQ;AAAA,IACb,GAAIA,EAAO,SAAS,CAAA;AAAA,IACpB,KAAKF;AAAA,EAAA,IAIL,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,SAGzC,OAAO,KAAKI,CAAU,EAAE,SAAS,IAEhC,EAAE,GAAGD,GAAQ,MAAMC,MAAeD;AAC3D;AAwBO,SAASE,EAAYC,GAAeP,GAAiD;AAC1F,SAAOQ,EAAcX,GAAWE,EAAcC,CAAK,GAAGO,CAAI;AAC5D;AAoBO,SAASE,EAAcC,IAAmB,UAAgB;AAGjE;;;;;;;;"}

package/dist/esm/chunks/index88.js

@@ -0,0 +1,29 @@
+import { c as l } from "./dom.js";
+const o = "legend", r = "legend";
+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 d(n, e) {
+  return l(o, i(e), n);
+}
+function s(n = document) {
+}
+const f = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  LEGEND_SELECTOR: r,
+  LEGEND_TAG: o,
+  createLegend: d,
+  enhanceLegends: s
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  r as L,
+  o as a,
+  d as c,
+  s as e,
+  f as i
+};
+//# sourceMappingURL=index88.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index88.js","sources":["../../../src/elements/form/legend/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Legend element helpers.\n *\n * @remarks\n * The legend element (`<legend>`) represents a caption for the content of its\n * parent `<fieldset>`. It is commonly used to label groups of related form\n * controls (e.g. radio-button groups), improving clarity and accessibility.\n *\n * Best-practice guidance:\n * - Use `<legend>` as the first child of a `<fieldset>` to label the group.\n * - Keep legend text concise and meaningful (it is typically announced with\n *   grouped controls by assistive technologies).\n * - Avoid using `<legend>` purely for layout; use CSS for styling/spacing.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create `<legend>` 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/legend\n * @see https://www.w3.org/WAI/tutorials/forms/grouping/\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 legend.\n *\n * @category Constants\n */\nexport const LEGEND_TAG = 'legend' as const;\n\n/**\n * A CSS selector targeting legend elements.\n *\n * @category Constants\n */\nexport const LEGEND_SELECTOR = 'legend';\n\n/**\n * Attribute bag for legend creation/enhancement.\n *\n * @remarks\n * Legend 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 LegendAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link LegendAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The legend attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: LegendAttrs): 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 legend 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 legend.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<legend>` element.\n *\n * @example\n * ```ts\n * import { createLegend } from \"@Vastare/Fundatio/elements/form/legend\";\n *\n * const legend = createLegend(\"Delivery address\");\n * ```\n *\n * @category DOM\n */\nexport function createLegend(text?: string, attrs?: LegendAttrs): ElementOf<typeof LEGEND_TAG> {\n  return createElement(LEGEND_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance legend 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 enhanceLegends(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for legend.\n  void root;\n}\n"],"names":["LEGEND_TAG","LEGEND_SELECTOR","toGlobalAttrs","attrs","aria","rest","mappedAria","createLegend","text","createElement","enhanceLegends","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,SAG7C,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;AAoBO,SAASE,EAAeC,IAAmB,UAAgB;AAGlE;;;;;;;;"}

package/dist/esm/chunks/index89.js

@@ -0,0 +1,32 @@
+import { c as g } from "./dom.js";
+const h = "meter", v = "meter";
+function E(n) {
+  const r = n ?? {}, { aria: e, value: i, min: l, max: s, low: f, high: m, optimum: c, form: b, ...p } = r, a = { ...p.attrs ?? {} }, t = (d, y) => {
+    y !== void 0 && (Object.prototype.hasOwnProperty.call(a, d) || (a[d] = y));
+  };
+  t("min", typeof l == "number" ? l : 0), t("max", typeof s == "number" ? s : 1), t("value", typeof i == "number" ? i : 0), t("low", typeof f == "number" ? f : void 0), t("high", typeof m == "number" ? m : void 0), t("optimum", typeof c == "number" ? c : void 0), t("form", typeof b == "string" ? b : void 0);
+  const o = {};
+  e && (typeof e.label == "string" && (o.label = e.label), typeof e.labelledby == "string" && (o.labelledby = e.labelledby), typeof e.hidden == "boolean" && (o.hidden = e.hidden));
+  const u = { ...p, attrs: a };
+  return Object.keys(o).length > 0 && (u.aria = o), u;
+}
+function M(n, r) {
+  return g(h, E(r), n);
+}
+function O(n = document) {
+}
+const x = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  METER_SELECTOR: v,
+  METER_TAG: h,
+  createMeter: M,
+  enhanceMeters: O
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  v as M,
+  h as a,
+  M as c,
+  O as e,
+  x as i
+};
+//# sourceMappingURL=index89.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index89.js","sources":["../../../src/elements/form/meter/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Meter element helpers.\n *\n * @remarks\n * The meter element (`<meter>`) represents a scalar measurement within a known range,\n * or a fractional value.\n *\n * Best-practice guidance:\n * - Use `<meter>` for a known-range measurement (e.g. disk usage, score, relevance).\n * - Do NOT use `<meter>` for task progress. Use `<progress>` for progress indication.\n * - Provide fallback text content for user agents that don't render `<meter>`.\n * - Define `min`/`max` if your `value` is not in the default 0..1 range.\n * - Use `low`/`high`/`optimum` only when you actually want \"good/bad\" semantics.\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: `<meter>` element\n * - WHATWG HTML: meter attributes and behavior\n *\n * @module\n * @category Elements\n */\n\nimport { createElement, type AttrValue, type ElementOf, type GlobalAttrs } from '../../../ts/dom';\n\n/**\n * Structured ARIA input supported by Fundatio element factories.\n *\n * @remarks\n * This is intentionally a small, typed subset that covers common cases and\n * prevents typo-based ARIA bugs.\n *\n * It is mapped into {@link GlobalAttrs.aria} for application by `dom.ts`.\n *\n * @category Attributes\n */\nexport type StructuredAria = {\n  /**\n   * Accessible label, mapped to `aria-label`.\n   */\n  label?: string;\n\n  /**\n   * ID reference to the labelling element(s), mapped to `aria-labelledby`.\n   */\n  labelledby?: string;\n\n  /**\n   * Decorative/hidden hint, mapped to `aria-hidden`.\n   */\n  hidden?: boolean;\n};\n\n/**\n * The semantic tag name for meter.\n *\n * @category Constants\n */\nexport const METER_TAG = 'meter' as const;\n\n/**\n * A CSS selector targeting meter elements.\n *\n * @category Constants\n */\nexport const METER_SELECTOR = 'meter';\n\n/**\n * Attribute bag for meter creation/enhancement.\n *\n * @remarks\n * Supported element-specific attributes:\n * - `value`, `min`, `max`, `low`, `high`, `optimum`\n * - `form` (associates the meter with a form owner by ID)\n *\n * Defaults (documented platform behavior):\n * - `min` defaults to `0` when omitted\n * - `max` defaults to `1` when omitted\n * - `value` defaults to `0` when omitted or malformed\n *\n * Fundatio applies these defaults as explicit attributes to keep output predictable\n * and testable even in node-based DOM shims.\n *\n * @category Attributes\n */\nexport type MeterAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Current numeric value.\n   *\n   * @remarks\n   * Should be within `[min, max]` when those are defined.\n   */\n  value?: number;\n\n  /**\n   * Lower numeric bound of the range. Defaults to `0`.\n   */\n  min?: number;\n\n  /**\n   * Upper numeric bound of the range. Defaults to `1`.\n   */\n  max?: number;\n\n  /**\n   * Upper numeric bound of the low end of the range.\n   */\n  low?: number;\n\n  /**\n   * Lower numeric bound of the high end of the range.\n   */\n  high?: number;\n\n  /**\n   * The optimal value within the range.\n   */\n  optimum?: number;\n\n  /**\n   * Associates the meter with a form element by ID.\n   *\n   * @remarks\n   * Mirrors the HTML `form` attribute used by form-associated elements.\n   */\n  form?: string;\n\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link MeterAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @remarks\n * - Preserves caller-provided `attrs` escape hatch (still validated by `dom.ts`).\n * - Element-specific attributes are merged into `attrs` without overwriting keys\n *   explicitly provided by the caller.\n * - Applies predictable defaults for `min`, `max`, and `value` even if callers\n *   omit the `attrs` bag entirely.\n *\n * @param attrs - The meter attributes.\n * @returns A {@link GlobalAttrs} object.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: MeterAttrs): GlobalAttrs {\n  const a: MeterAttrs = attrs ?? {};\n\n  const { aria, value, min, max, low, high, optimum, form, ...rest } = a;\n\n  // Start with any caller-provided attrs escape hatch (it is still validated by dom.ts).\n  const mergedAttrs: Record<string, AttrValue> = { ...(rest.attrs ?? {}) };\n\n  // Helper: only set if caller didn't already set the raw attribute explicitly.\n  const setIfUnset = (key: string, v: AttrValue | undefined): void => {\n    if (v === undefined) return;\n    if (Object.prototype.hasOwnProperty.call(mergedAttrs, key)) return;\n    mergedAttrs[key] = v;\n  };\n\n  // Defaults: make output deterministic even when attrs is omitted.\n  setIfUnset('min', typeof min === 'number' ? min : 0);\n  setIfUnset('max', typeof max === 'number' ? max : 1);\n  setIfUnset('value', typeof value === 'number' ? value : 0);\n\n  // Optional meter semantics.\n  setIfUnset('low', typeof low === 'number' ? low : undefined);\n  setIfUnset('high', typeof high === 'number' ? high : undefined);\n  setIfUnset('optimum', typeof optimum === 'number' ? optimum : undefined);\n\n  // Form association.\n  setIfUnset('form', typeof form === 'string' ? form : undefined);\n\n  const mappedAria: NonNullable<GlobalAttrs['aria']> = {};\n  if (aria) {\n    if (typeof aria.label === 'string') mappedAria.label = aria.label;\n    if (typeof aria.labelledby === 'string') mappedAria.labelledby = aria.labelledby;\n    if (typeof aria.hidden === 'boolean') mappedAria.hidden = aria.hidden;\n  }\n\n  const next: GlobalAttrs = { ...rest, attrs: mergedAttrs };\n\n  if (Object.keys(mappedAria).length > 0) {\n    next.aria = mappedAria;\n  }\n\n  return next;\n}\n\n/**\n * Create a meter element with optional fallback text and attributes.\n *\n * @remarks\n * - Fallback text is assigned via `textContent` (never `innerHTML`).\n * - Global attributes are applied via Fundatio's shared DOM helper,\n *   including security guards that block inline event handler attributes\n *   (e.g. `onclick`) and raw `style` attribute strings.\n *\n * @param text - Optional fallback text for user agents that don't render `<meter>`.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<meter>` element.\n *\n * @category DOM\n */\nexport function createMeter(text?: string, attrs?: MeterAttrs): ElementOf<typeof METER_TAG> {\n  return createElement(METER_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance meter elements within a given root.\n *\n * @remarks\n * This is intentionally a no-op in `1.0.0`.\n *\n * @param root - The node to search within. Defaults to `document`.\n *\n * @category Enhancement\n */\nexport function enhanceMeters(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for meter.\n  void root;\n}\n"],"names":["METER_TAG","METER_SELECTOR","toGlobalAttrs","attrs","a","aria","value","min","max","low","high","optimum","form","rest","mergedAttrs","setIfUnset","key","v","mappedAria","next","createMeter","text","createElement","enhanceMeters","root"],"mappings":";AAgEO,MAAMA,IAAY,SAOZC,IAAiB;AAmF9B,SAASC,EAAcC,GAAiC;AACtD,QAAMC,IAAgBD,KAAS,CAAA,GAEzB,EAAE,MAAAE,GAAM,OAAAC,GAAO,KAAAC,GAAK,KAAAC,GAAK,KAAAC,GAAK,MAAAC,GAAM,SAAAC,GAAS,MAAAC,GAAM,GAAGC,EAAA,IAAST,GAG/DU,IAAyC,EAAE,GAAID,EAAK,SAAS,CAAA,EAAC,GAG9DE,IAAa,CAACC,GAAaC,MAAmC;AAClE,IAAIA,MAAM,WACN,OAAO,UAAU,eAAe,KAAKH,GAAaE,CAAG,MACzDF,EAAYE,CAAG,IAAIC;AAAA,EACrB;AAGA,EAAAF,EAAW,OAAO,OAAOR,KAAQ,WAAWA,IAAM,CAAC,GACnDQ,EAAW,OAAO,OAAOP,KAAQ,WAAWA,IAAM,CAAC,GACnDO,EAAW,SAAS,OAAOT,KAAU,WAAWA,IAAQ,CAAC,GAGzDS,EAAW,OAAO,OAAON,KAAQ,WAAWA,IAAM,MAAS,GAC3DM,EAAW,QAAQ,OAAOL,KAAS,WAAWA,IAAO,MAAS,GAC9DK,EAAW,WAAW,OAAOJ,KAAY,WAAWA,IAAU,MAAS,GAGvEI,EAAW,QAAQ,OAAOH,KAAS,WAAWA,IAAO,MAAS;AAE9D,QAAMM,IAA+C,CAAA;AACrD,EAAIb,MACE,OAAOA,EAAK,SAAU,aAAUa,EAAW,QAAQb,EAAK,QACxD,OAAOA,EAAK,cAAe,aAAUa,EAAW,aAAab,EAAK,aAClE,OAAOA,EAAK,UAAW,cAAWa,EAAW,SAASb,EAAK;AAGjE,QAAMc,IAAoB,EAAE,GAAGN,GAAM,OAAOC,EAAA;AAE5C,SAAI,OAAO,KAAKI,CAAU,EAAE,SAAS,MACnCC,EAAK,OAAOD,IAGPC;AACT;AAiBO,SAASC,EAAYC,GAAelB,GAAiD;AAC1F,SAAOmB,EAActB,GAAWE,EAAcC,CAAK,GAAGkB,CAAI;AAC5D;AAYO,SAASE,EAAcC,IAAmB,UAAgB;AAGjE;;;;;;;;"}

package/dist/esm/chunks/index9.js

@@ -0,0 +1,19 @@
+import { i } from "./index74.js";
+import { i as o } from "./index75.js";
+import { i as e } from "./index76.js";
+import { i as r } from "./index77.js";
+import { i as t } from "./index78.js";
+import { i as d } from "./index79.js";
+const s = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  dd: i,
+  dl: o,
+  dt: e,
+  li: r,
+  ol: t,
+  ul: d
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  s as i
+};
+//# sourceMappingURL=index9.js.map

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

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

package/dist/esm/chunks/index90.js

@@ -0,0 +1,30 @@
+import { c as p } from "./dom.js";
+const s = "optgroup", c = "optgroup";
+function b(a, l) {
+  const { aria: e, disabled: i, ...n } = l ?? {}, o = {};
+  e && (typeof e.label == "string" && (o.label = e.label), typeof e.labelledby == "string" && (o.labelledby = e.labelledby), typeof e.hidden == "boolean" && (o.hidden = e.hidden));
+  const t = { ...n.attrs ?? {} };
+  Object.prototype.hasOwnProperty.call(t, "label") || (t.label = a), i === !0 && !Object.prototype.hasOwnProperty.call(t, "disabled") && (t.disabled = "");
+  const r = { ...n };
+  return Object.keys(t).length > 0 && (r.attrs = t), Object.keys(o).length > 0 && (r.aria = o), r;
+}
+function d(a, l) {
+  return p(s, b(a, l));
+}
+function f(a = document) {
+}
+const u = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  OPTGROUP_SELECTOR: c,
+  OPTGROUP_TAG: s,
+  createOptgroup: d,
+  enhanceOptgroups: f
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  c as O,
+  s as a,
+  d as c,
+  f as e,
+  u as i
+};
+//# sourceMappingURL=index90.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index90.js","sources":["../../../src/elements/form/optgroup/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Optgroup element helpers.\n *\n * @remarks\n * The optgroup element (`<optgroup>`) groups related `<option>` elements within\n * a `<select>`, allowing user agents to present grouped choices with a label.\n * :contentReference[oaicite:3]{index=3}\n *\n * Best-practice guidance:\n * - Always provide a meaningful `label`. MDN notes this attribute is mandatory\n *   when the element is used. Fundatio enforces this by requiring `label` when\n *   creating an optgroup. :contentReference[oaicite:4]{index=4}\n * - Use `disabled` to disable all options within the group when appropriate.\n * :contentReference[oaicite:5]{index=5}\n * - Prefer native semantics; avoid ARIA where native semantics already apply.\n *\n * Fundatio-specific conventions:\n * - Requires `label` at creation time to avoid invalid/anonymous optgroups.\n * - Applies global attributes via Fundatio's hardened DOM helpers (`dom.ts`), which\n *   block inline event handler attributes (e.g. `onclick`) and the raw `style`\n *   attribute string.\n * - Supports a small structured ARIA input to reduce typo-based ARIA bugs.\n *\n * This module has no side effects and does not mutate the DOM unless you call\n * its functions.\n *\n * @module\n * @category Elements\n */\n\nimport { createElement, type ElementOf, type GlobalAttrs } from '../../../ts/dom';\n\n/**\n * Structured ARIA input supported by Fundatio element factories.\n *\n * @remarks\n * This is intentionally a small, typed subset mapped into {@link GlobalAttrs.aria}.\n *\n * @category Attributes\n */\nexport type StructuredAria = {\n  /**\n   * Accessible label, mapped to `aria-label`.\n   */\n  label?: string;\n\n  /**\n   * ID reference(s) to labelling element(s), mapped to `aria-labelledby`.\n   */\n  labelledby?: string;\n\n  /**\n   * Decorative/hidden hint, mapped to `aria-hidden`.\n   */\n  hidden?: boolean;\n};\n\n/**\n * The semantic tag name for option groups.\n *\n * @category Constants\n */\nexport const OPTGROUP_TAG = 'optgroup' as const;\n\n/**\n * A CSS selector targeting optgroup elements.\n *\n * @category Constants\n */\nexport const OPTGROUP_SELECTOR = 'optgroup';\n\n/**\n * Attribute bag for optgroup creation/enhancement.\n *\n * @remarks\n * `<optgroup>` accepts global attributes plus:\n * - `disabled` (boolean attribute)\n *\n * The `label` attribute is mandatory for meaningful use. Fundatio requires the label\n * as a separate argument in {@link createOptgroup}. :contentReference[oaicite:6]{index=6}\n *\n * Fundatio also supports a structured ARIA input for common ARIA fields, mapped into\n * {@link GlobalAttrs.aria}.\n *\n * @category Attributes\n */\nexport type OptgroupAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n\n  /**\n   * Disables the option group when true.\n   *\n   * @remarks\n   * When disabled, none of the options in the group are selectable. :contentReference[oaicite:7]{index=7}\n   */\n  disabled?: boolean;\n};\n\n/**\n * Normalize {@link OptgroupAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param label - The required optgroup label, mapped to the `label` attribute.\n * @param attrs - The optgroup attributes.\n * @returns A {@link GlobalAttrs} object containing mapped attributes.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(label: string, attrs?: OptgroupAttrs): GlobalAttrs {\n  const { aria, disabled, ...rest } = attrs ?? {};\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  const mergedAttrs: NonNullable<GlobalAttrs['attrs']> = { ...(rest.attrs ?? {}) };\n\n  // Always set the mandatory label attribute unless explicitly overridden via raw attrs.\n  if (!Object.prototype.hasOwnProperty.call(mergedAttrs, 'label')) {\n    mergedAttrs.label = label;\n  }\n\n  // Boolean attribute by presence when true.\n  if (disabled === true && !Object.prototype.hasOwnProperty.call(mergedAttrs, 'disabled')) {\n    mergedAttrs.disabled = '';\n  }\n\n  const mapped: GlobalAttrs = { ...rest };\n\n  if (Object.keys(mergedAttrs).length > 0) mapped.attrs = mergedAttrs;\n\n  if (Object.keys(mappedAria).length > 0) {\n    mapped.aria = mappedAria;\n  }\n\n  return mapped;\n}\n\n/**\n * Create an optgroup element with a required label and optional attributes.\n *\n * @remarks\n * - The label is mapped to the `label` attribute (required for meaningful use). :contentReference[oaicite:8]{index=8}\n * - Global attributes are applied via Fundatio's shared DOM helper, including security\n *   guards that block inline event handler attributes (e.g. `onclick`) and raw\n *   `style` attribute strings.\n *\n * @param label - The optgroup label shown by the user agent.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<optgroup>` element.\n *\n * @example\n * ```ts\n * import { createOptgroup } from \"@Vastare/Fundatio/elements/form/optgroup\";\n *\n * const g = createOptgroup(\"Fruits\", { disabled: false });\n * ```\n *\n * @category DOM\n */\nexport function createOptgroup(\n  label: string,\n  attrs?: OptgroupAttrs,\n): ElementOf<typeof OPTGROUP_TAG> {\n  return createElement(OPTGROUP_TAG, toGlobalAttrs(label, attrs));\n}\n\n/**\n * Enhance optgroup elements within a given root.\n *\n * @remarks\n * This is intentionally a no-op in `1.0.0`.\n *\n * @param root - The node to search within. Defaults to `document`.\n *\n * @category Enhancement\n */\nexport function enhanceOptgroups(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for optgroup.\n  void root;\n}\n"],"names":["OPTGROUP_TAG","OPTGROUP_SELECTOR","toGlobalAttrs","label","attrs","aria","disabled","rest","mappedAria","mergedAttrs","mapped","createOptgroup","createElement","enhanceOptgroups","root"],"mappings":";AA8DO,MAAMA,IAAe,YAOfC,IAAoB;AAyCjC,SAASC,EAAcC,GAAeC,GAAoC;AACxE,QAAM,EAAE,MAAAC,GAAM,UAAAC,GAAU,GAAGC,EAAA,IAASH,KAAS,CAAA,GAEvCI,IAA+C,CAAA;AAErD,EAAIH,MACE,OAAOA,EAAK,SAAU,aAAUG,EAAW,QAAQH,EAAK,QACxD,OAAOA,EAAK,cAAe,aAAUG,EAAW,aAAaH,EAAK,aAClE,OAAOA,EAAK,UAAW,cAAWG,EAAW,SAASH,EAAK;AAGjE,QAAMI,IAAiD,EAAE,GAAIF,EAAK,SAAS,CAAA,EAAC;AAG5E,EAAK,OAAO,UAAU,eAAe,KAAKE,GAAa,OAAO,MAC5DA,EAAY,QAAQN,IAIlBG,MAAa,MAAQ,CAAC,OAAO,UAAU,eAAe,KAAKG,GAAa,UAAU,MACpFA,EAAY,WAAW;AAGzB,QAAMC,IAAsB,EAAE,GAAGH,EAAA;AAEjC,SAAI,OAAO,KAAKE,CAAW,EAAE,SAAS,QAAU,QAAQA,IAEpD,OAAO,KAAKD,CAAU,EAAE,SAAS,MACnCE,EAAO,OAAOF,IAGTE;AACT;AAwBO,SAASC,EACdR,GACAC,GACgC;AAChC,SAAOQ,EAAcZ,GAAcE,EAAcC,GAAOC,CAAK,CAAC;AAChE;AAYO,SAASS,EAAiBC,IAAmB,UAAgB;AAGpE;;;;;;;;"}

package/dist/esm/chunks/index91.js

@@ -0,0 +1,29 @@
+import { c as f } from "./dom.js";
+const r = "option", p = "option";
+function b(a) {
+  if (!a) return;
+  const { aria: e, value: i, label: l, disabled: s, selected: d, ...c } = a, n = { ...c }, t = { ...n.attrs ?? {} };
+  if (typeof i == "string" && (t.value = i), typeof l == "string" && (t.label = l), s === !0 && (t.disabled = !0), d === !0 && (t.selected = !0), Object.keys(t).length > 0 && (n.attrs = t), !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 u(a, e) {
+  return f(r, b(e), a);
+}
+function y(a = document) {
+}
+const h = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  OPTION_SELECTOR: p,
+  OPTION_TAG: r,
+  createOption: u,
+  enhanceOptions: y
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  p as O,
+  r as a,
+  u as c,
+  y as e,
+  h as i
+};
+//# sourceMappingURL=index91.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index91.js","sources":["../../../src/elements/form/option/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Option element helpers.\n *\n * @remarks\n * The option element (`<option>`) defines an item within a `<select>`, `<optgroup>`,\n * or `<datalist>` element.\n *\n * Best-practice guidance:\n * - Prefer providing a `value` for form submission semantics. If `value` is omitted,\n *   the option's value typically falls back to its text content.\n * - Use `label` when you need a shorter label for UI display or accessibility hints,\n *   but keep the option text clear and readable.\n * - Use `disabled` to prevent selection of an option (or to mark placeholders as\n *   unavailable).\n * - Use `selected` to mark the default selection in a `<select>` (usually one\n *   option should be selected by default).\n *\n * Attributes:\n * - `value` (string): the value submitted/used when selected.\n * - `label` (string): a label for the option.\n * - `disabled` (boolean): whether the option is unavailable.\n * - `selected` (boolean): whether the option is selected by default.\n *\n * Security:\n * - Global attribute escape hatches are guarded by Fundatio's `dom.ts` helpers which\n *   block inline event handler attributes (e.g. `onclick`) and raw `style`\n *   attribute injection (use the `style` object field instead).\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/option\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 option.\n *\n * @category Constants\n */\nexport const OPTION_TAG = 'option' as const;\n\n/**\n * A CSS selector targeting option elements.\n *\n * @category Constants\n */\nexport const OPTION_SELECTOR = 'option';\n\n/**\n * Attribute bag for option creation/enhancement.\n *\n * @remarks\n * Options accept standard HTML global attributes plus a small set of option-specific\n * content attributes.\n *\n * Fundatio also supports a structured ARIA input for common ARIA fields, which is\n * mapped into {@link GlobalAttrs.aria} without changing Fundatio's core DOM helpers.\n *\n * @category Attributes\n */\nexport type OptionAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n\n  /**\n   * The option value.\n   *\n   * @remarks\n   * If omitted, user agents commonly derive a value from the option's text.\n   */\n  value?: string;\n\n  /**\n   * A label for the option.\n   *\n   * @remarks\n   * When present, this may be used by user agents as the option's label instead\n   * of the text content in certain contexts.\n   */\n  label?: string;\n\n  /**\n   * Whether the option is disabled.\n   */\n  disabled?: boolean;\n\n  /**\n   * Whether the option is selected by default.\n   *\n   * @remarks\n   * For `<select>`, `selected` commonly indicates the default selected option on\n   * initial load. If multiple options are marked selected, browser behavior varies;\n   * prefer a single default selection unless using a multi-select.\n   */\n  selected?: boolean;\n};\n\n/**\n * Normalize {@link OptionAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The option attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: OptionAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, value, label, disabled, selected, ...rest } = attrs;\n\n  const mapped: GlobalAttrs = { ...rest };\n\n  const extra: NonNullable<GlobalAttrs['attrs']> = { ...(mapped.attrs ?? {}) };\n\n  if (typeof value === 'string') extra.value = value;\n  if (typeof label === 'string') extra.label = label;\n\n  if (disabled === true) extra.disabled = true;\n  if (selected === true) extra.selected = true;\n\n  // Only attach `attrs` if something was actually defined/added.\n  if (Object.keys(extra).length > 0) {\n    mapped.attrs = extra;\n  }\n\n  if (!aria) return mapped;\n\n  const mappedAria: NonNullable<GlobalAttrs['aria']> = {};\n\n  if (typeof aria.label === 'string') mappedAria.label = aria.label;\n  if (typeof aria.labelledby === 'string') mappedAria.labelledby = aria.labelledby;\n  if (typeof aria.hidden === 'boolean') mappedAria.hidden = aria.hidden;\n\n  const hasMappedAria = Object.keys(mappedAria).length > 0;\n\n  return hasMappedAria ? { ...mapped, aria: mappedAria } : mapped;\n}\n\n/**\n * Create an option element with optional text content and attributes.\n *\n * @remarks\n * - Text content is assigned via `textContent` (never `innerHTML`).\n * - Global attributes and escape-hatch attributes are applied via Fundatio's shared\n *   DOM helper, including security guards that block inline event handler\n *   attributes (e.g. `onclick`) and raw `style` attribute strings.\n *\n * @param text - Optional text content for the option.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<option>` element.\n *\n * @example\n * ```ts\n * import { createOption } from \"@Vastare/Fundatio/elements/form/option\";\n *\n * const opt = createOption(\"United Kingdom\", { value: \"UK\" });\n * ```\n *\n * @category DOM\n */\nexport function createOption(text?: string, attrs?: OptionAttrs): ElementOf<typeof OPTION_TAG> {\n  return createElement(OPTION_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance option 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 enhanceOptions(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for option.\n  void root;\n}\n"],"names":["OPTION_TAG","OPTION_SELECTOR","toGlobalAttrs","attrs","aria","value","label","disabled","selected","rest","mapped","extra","mappedAria","createOption","text","createElement","enhanceOptions","root"],"mappings":";AAqEO,MAAMA,IAAa,UAObC,IAAkB;AA6D/B,SAASC,EAAcC,GAA8C;AACnE,MAAI,CAACA,EAAO;AAEZ,QAAM,EAAE,MAAAC,GAAM,OAAAC,GAAO,OAAAC,GAAO,UAAAC,GAAU,UAAAC,GAAU,GAAGC,MAASN,GAEtDO,IAAsB,EAAE,GAAGD,EAAA,GAE3BE,IAA2C,EAAE,GAAID,EAAO,SAAS,CAAA,EAAC;AAaxE,MAXI,OAAOL,KAAU,aAAUM,EAAM,QAAQN,IACzC,OAAOC,KAAU,aAAUK,EAAM,QAAQL,IAEzCC,MAAa,OAAMI,EAAM,WAAW,KACpCH,MAAa,OAAMG,EAAM,WAAW,KAGpC,OAAO,KAAKA,CAAK,EAAE,SAAS,MAC9BD,EAAO,QAAQC,IAGb,CAACP,EAAM,QAAOM;AAElB,QAAME,IAA+C,CAAA;AAErD,SAAI,OAAOR,EAAK,SAAU,aAAUQ,EAAW,QAAQR,EAAK,QACxD,OAAOA,EAAK,cAAe,aAAUQ,EAAW,aAAaR,EAAK,aAClE,OAAOA,EAAK,UAAW,cAAWQ,EAAW,SAASR,EAAK,SAEzC,OAAO,KAAKQ,CAAU,EAAE,SAAS,IAEhC,EAAE,GAAGF,GAAQ,MAAME,MAAeF;AAC3D;AAwBO,SAASG,EAAaC,GAAeX,GAAmD;AAC7F,SAAOY,EAAcf,GAAYE,EAAcC,CAAK,GAAGW,CAAI;AAC7D;AAoBO,SAASE,EAAeC,IAAmB,UAAgB;AAGlE;;;;;;;;"}

package/dist/esm/chunks/index92.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index92.js","sources":["../../../src/elements/form/output/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Output element helpers.\n *\n * @remarks\n * The output element (`<output>`) represents the result of a calculation or a\n * user action, commonly used in forms to display derived values without\n * requiring focus changes.\n *\n * Best-practice guidance:\n * - Use `<output>` for computed results derived from form controls.\n * - Use the `for` attribute to associate the output with the control(s) whose\n *   values it reflects (space-separated list of element IDs).\n * - Prefer semantic HTML and native behavior over ARIA. Many browsers treat\n *   `<output>` as an ARIA live region, so updating its text may be announced by\n *   assistive technologies without moving focus.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create outputs 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/output\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Attributes/for\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Attributes/form\n *\n * @module\n * @category Elements\n */\n\nimport { createElement, type AttrValue, type ElementOf, type GlobalAttrs } from '../../../ts/dom';\n\n/**\n * Structured ARIA input supported by Fundatio element factories.\n *\n * @remarks\n * This is intentionally a small, typed subset that covers common cases and\n * prevents typo-based ARIA bugs.\n *\n * It is mapped into {@link GlobalAttrs.aria} for application by `dom.ts`.\n *\n * @category Attributes\n */\nexport type StructuredAria = {\n  /**\n   * Accessible label, mapped to `aria-label`.\n   */\n  label?: string;\n\n  /**\n   * ID reference to the labelling element(s), mapped to `aria-labelledby`.\n   */\n  labelledby?: string;\n\n  /**\n   * Decorative/hidden hint, mapped to `aria-hidden`.\n   */\n  hidden?: boolean;\n};\n\n/**\n * The semantic tag name for output.\n *\n * @category Constants\n */\nexport const OUTPUT_TAG = 'output' as const;\n\n/**\n * A CSS selector targeting output elements.\n *\n * @category Constants\n */\nexport const OUTPUT_SELECTOR = 'output';\n\n/**\n * Attribute bag for output creation/enhancement.\n *\n * @remarks\n * Output accepts standard HTML global attributes plus output-specific\n * attributes (`for`, `form`, `name`).\n *\n * Fundatio also supports a structured ARIA input for common ARIA fields, which is\n * mapped into {@link GlobalAttrs.aria} without changing Fundatio's core DOM helpers.\n *\n * @category Attributes\n */\nexport type OutputAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n\n  /**\n   * Space-separated list of element IDs whose values contributed to the output.\n   *\n   * @remarks\n   * This maps to the `for` attribute (yes, the HTML attribute is literally\n   * called `for`).\n   */\n  for?: string;\n\n  /**\n   * Associates the output with a form element by ID, even if not a descendant.\n   */\n  form?: string;\n\n  /**\n   * Name of the output (useful in form-associated contexts).\n   */\n  name?: string;\n};\n\n/**\n * Normalize {@link OutputAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The output attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: OutputAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, for: htmlFor, form, name, ...rest } = attrs;\n\n  // Start with any caller-provided attrs escape hatch (still validated by dom.ts).\n  const mergedAttrs: Record<string, AttrValue> = { ...(rest.attrs ?? {}) };\n\n  const setIfUnset = (key: string, value: AttrValue | undefined): void => {\n    if (value === undefined) return;\n    if (Object.prototype.hasOwnProperty.call(mergedAttrs, key)) return;\n    mergedAttrs[key] = value;\n  };\n\n  setIfUnset('for', htmlFor);\n  setIfUnset('form', form);\n  setIfUnset('name', name);\n\n  const mappedAria: NonNullable<GlobalAttrs['aria']> = {};\n  if (aria) {\n    if (typeof aria.label === 'string') mappedAria.label = aria.label;\n    if (typeof aria.labelledby === 'string') mappedAria.labelledby = aria.labelledby;\n    if (typeof aria.hidden === 'boolean') mappedAria.hidden = aria.hidden;\n  }\n\n  const hasMergedAttrs = Object.keys(mergedAttrs).length > 0;\n  const hasMappedAria = Object.keys(mappedAria).length > 0;\n\n  const next: GlobalAttrs = { ...rest };\n  if (hasMergedAttrs) next.attrs = mergedAttrs;\n  if (hasMappedAria) next.aria = mappedAria;\n\n  return next;\n}\n\n/**\n * Create an output 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 output.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<output>` element.\n *\n * @example\n * ```ts\n * import { createOutput } from \"@Vastare/Fundatio/elements/form/output\";\n *\n * const out = createOutput(\"0\", { name: \"result\", for: \"a b\" });\n * ```\n *\n * @category DOM\n */\nexport function createOutput(text?: string, attrs?: OutputAttrs): ElementOf<typeof OUTPUT_TAG> {\n  return createElement(OUTPUT_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance output 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 enhanceOutputs(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for output.\n  void root;\n}\n"],"names":["OUTPUT_TAG","OUTPUT_SELECTOR","toGlobalAttrs","attrs","aria","htmlFor","form","name","rest","mergedAttrs","setIfUnset","key","value","mappedAria","hasMergedAttrs","hasMappedAria","next","createOutput","text","createElement","enhanceOutputs","root"],"mappings":";AAmEO,MAAMA,IAAa,UAObC,IAAkB;AAgD/B,SAASC,EAAcC,GAA8C;AACnE,MAAI,CAACA,EAAO;AAEZ,QAAM,EAAE,MAAAC,GAAM,KAAKC,GAAS,MAAAC,GAAM,MAAAC,GAAM,GAAGC,MAASL,GAG9CM,IAAyC,EAAE,GAAID,EAAK,SAAS,CAAA,EAAC,GAE9DE,IAAa,CAACC,GAAaC,MAAuC;AACtE,IAAIA,MAAU,WACV,OAAO,UAAU,eAAe,KAAKH,GAAaE,CAAG,MACzDF,EAAYE,CAAG,IAAIC;AAAA,EACrB;AAEA,EAAAF,EAAW,OAAOL,CAAO,GACzBK,EAAW,QAAQJ,CAAI,GACvBI,EAAW,QAAQH,CAAI;AAEvB,QAAMM,IAA+C,CAAA;AACrD,EAAIT,MACE,OAAOA,EAAK,SAAU,aAAUS,EAAW,QAAQT,EAAK,QACxD,OAAOA,EAAK,cAAe,aAAUS,EAAW,aAAaT,EAAK,aAClE,OAAOA,EAAK,UAAW,cAAWS,EAAW,SAAST,EAAK;AAGjE,QAAMU,IAAiB,OAAO,KAAKL,CAAW,EAAE,SAAS,GACnDM,IAAgB,OAAO,KAAKF,CAAU,EAAE,SAAS,GAEjDG,IAAoB,EAAE,GAAGR,EAAA;AAC/B,SAAIM,QAAqB,QAAQL,IAC7BM,QAAoB,OAAOF,IAExBG;AACT;AAwBO,SAASC,EAAaC,GAAef,GAAmD;AAC7F,SAAOgB,EAAcnB,GAAYE,EAAcC,CAAK,GAAGe,CAAI;AAC7D;AAoBO,SAASE,EAAeC,IAAmB,UAAgB;AAGlE;;;;;;;;"}

package/dist/esm/chunks/index93.js

@@ -0,0 +1,33 @@
+import { c as y } from "./dom.js";
+const d = "progress", m = "progress";
+function g(t) {
+  if (!t) return;
+  const { aria: e, value: l, max: o, ...i } = t, n = { ...i.attrs ?? {} }, s = (f, b) => {
+    b !== void 0 && (Object.prototype.hasOwnProperty.call(n, f) || (n[f] = b));
+  }, c = typeof l == "number";
+  c && s("value", l), c ? s("max", typeof o == "number" ? o : 1) : s("max", typeof o == "number" ? o : void 0);
+  const 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));
+  const p = Object.keys(n).length > 0, u = Object.keys(r).length > 0, a = { ...i };
+  return p && (a.attrs = n), u && (a.aria = r), a;
+}
+function h(t, e) {
+  return y(d, g(e), t);
+}
+function O(t = document) {
+}
+const S = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  PROGRESS_SELECTOR: m,
+  PROGRESS_TAG: d,
+  createProgress: h,
+  enhanceProgresses: O
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  m as P,
+  d as a,
+  h as c,
+  O as e,
+  S as i
+};
+//# sourceMappingURL=index93.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index93.js","sources":["../../../src/elements/form/progress/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Progress element helpers.\n *\n * @remarks\n * The progress element (`<progress>`) represents the completion progress of a task.\n *\n * Best-practice guidance:\n * - Use `<progress>` to represent task completion (downloads, uploads, multi-step flows).\n * - If the amount of work is unknown, omit `value` to produce an indeterminate progress bar.\n * - Provide fallback text content for user agents that don't render `<progress>`.\n * - When using a determinate progress bar, set `value` and (usually) `max`.\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: `<progress>` element\n * - WHATWG HTML: `progress` element IDL and defaults (`max` defaults to 1.0)\n * - MDN: `:indeterminate` and indeterminate `<progress>` when `value` is absent\n *\n * @module\n * @category Elements\n */\n\nimport { createElement, type AttrValue, type ElementOf, type GlobalAttrs } from '../../../ts/dom';\n\n/**\n * Structured ARIA input supported by Fundatio element factories.\n *\n * @remarks\n * This is intentionally a small, typed subset that covers common cases and\n * prevents typo-based ARIA bugs.\n *\n * It is mapped into {@link GlobalAttrs.aria} for application by `dom.ts`.\n *\n * @category Attributes\n */\nexport type StructuredAria = {\n  /**\n   * Accessible label, mapped to `aria-label`.\n   */\n  label?: string;\n\n  /**\n   * ID reference to the labelling element(s), mapped to `aria-labelledby`.\n   */\n  labelledby?: string;\n\n  /**\n   * Decorative/hidden hint, mapped to `aria-hidden`.\n   */\n  hidden?: boolean;\n};\n\n/**\n * The semantic tag name for progress.\n *\n * @category Constants\n */\nexport const PROGRESS_TAG = 'progress' as const;\n\n/**\n * A CSS selector targeting progress elements.\n *\n * @category Constants\n */\nexport const PROGRESS_SELECTOR = 'progress';\n\n/**\n * Attribute bag for progress creation/enhancement.\n *\n * @remarks\n * Supported element-specific attributes:\n * - `value` (optional): when omitted, the progress bar is indeterminate\n * - `max` (optional): defaults to 1.0 when omitted (platform default)\n *\n * Fundatio behavior:\n * - If `value` is omitted, Fundatio does NOT set it, preserving indeterminate semantics.\n * - If `value` is provided and `max` is omitted, Fundatio applies `max=1` explicitly\n *   for predictable, testable output in node-based environments.\n *\n * @category Attributes\n */\nexport type ProgressAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Current progress value.\n   *\n   * @remarks\n   * If omitted, the progress bar is indeterminate.\n   */\n  value?: number;\n\n  /**\n   * Maximum value. Must be greater than 0.\n   *\n   * @remarks\n   * Defaults to 1.0 when omitted (platform default).\n   */\n  max?: number;\n\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link ProgressAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @remarks\n * - Preserves caller-provided `attrs` escape hatch (still validated by `dom.ts`).\n * - Element-specific attributes are merged into `attrs` without overwriting keys\n *   explicitly provided by the caller.\n * - Does NOT default `value` (keeps indeterminate semantics).\n * - Defaults `max` to `1` only when `value` is provided and caller did not supply `max`.\n *\n * @param attrs - The progress attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: ProgressAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, value, max, ...rest } = attrs;\n\n  const mergedAttrs: Record<string, AttrValue> = { ...(rest.attrs ?? {}) };\n\n  const setIfUnset = (key: string, v: AttrValue | undefined): void => {\n    if (v === undefined) return;\n    if (Object.prototype.hasOwnProperty.call(mergedAttrs, key)) return;\n    mergedAttrs[key] = v;\n  };\n\n  // Preserve indeterminate semantics: only set `value` if explicitly provided.\n  const hasValue = typeof value === 'number';\n  if (hasValue) setIfUnset('value', value);\n\n  // Only default `max` in determinate mode.\n  if (hasValue) {\n    setIfUnset('max', typeof max === 'number' ? max : 1);\n  } else {\n    // If caller explicitly provides max (or via escape hatch), allow it.\n    setIfUnset('max', typeof max === 'number' ? max : undefined);\n  }\n\n  const mappedAria: NonNullable<GlobalAttrs['aria']> = {};\n  if (aria) {\n    if (typeof aria.label === 'string') mappedAria.label = aria.label;\n    if (typeof aria.labelledby === 'string') mappedAria.labelledby = aria.labelledby;\n    if (typeof aria.hidden === 'boolean') mappedAria.hidden = aria.hidden;\n  }\n\n  const hasMergedAttrs = Object.keys(mergedAttrs).length > 0;\n  const hasMappedAria = Object.keys(mappedAria).length > 0;\n\n  const next: GlobalAttrs = { ...rest };\n  if (hasMergedAttrs) next.attrs = mergedAttrs;\n  if (hasMappedAria) next.aria = mappedAria;\n\n  return next;\n}\n\n/**\n * Create a progress element with optional fallback text and attributes.\n *\n * @remarks\n * - Fallback text is assigned via `textContent` (never `innerHTML`).\n * - Global attributes are applied via Fundatio's shared DOM helper,\n *   including security guards that block inline event handler attributes\n *   (e.g. `onclick`) and raw `style` attribute strings.\n *\n * @param text - Optional fallback text for user agents that don't render `<progress>`.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<progress>` element.\n *\n * @example\n * Indeterminate progress:\n * ```ts\n * createProgress(\"Loading...\");\n * ```\n *\n * @example\n * Determinate progress:\n * ```ts\n * createProgress(undefined, { value: 30, max: 100 });\n * ```\n *\n * @category DOM\n */\nexport function createProgress(\n  text?: string,\n  attrs?: ProgressAttrs,\n): ElementOf<typeof PROGRESS_TAG> {\n  return createElement(PROGRESS_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance progress elements within a given root.\n *\n * @remarks\n * This is intentionally a no-op in `1.0.0`.\n *\n * @param root - The node to search within. Defaults to `document`.\n *\n * @category Enhancement\n */\nexport function enhanceProgresses(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for progress.\n  void root;\n}\n"],"names":["PROGRESS_TAG","PROGRESS_SELECTOR","toGlobalAttrs","attrs","aria","value","max","rest","mergedAttrs","setIfUnset","key","v","hasValue","mappedAria","hasMergedAttrs","hasMappedAria","next","createProgress","text","createElement","enhanceProgresses","root"],"mappings":";AA+DO,MAAMA,IAAe,YAOfC,IAAoB;AAuDjC,SAASC,EAAcC,GAAgD;AACrE,MAAI,CAACA,EAAO;AAEZ,QAAM,EAAE,MAAAC,GAAM,OAAAC,GAAO,KAAAC,GAAK,GAAGC,MAASJ,GAEhCK,IAAyC,EAAE,GAAID,EAAK,SAAS,CAAA,EAAC,GAE9DE,IAAa,CAACC,GAAaC,MAAmC;AAClE,IAAIA,MAAM,WACN,OAAO,UAAU,eAAe,KAAKH,GAAaE,CAAG,MACzDF,EAAYE,CAAG,IAAIC;AAAA,EACrB,GAGMC,IAAW,OAAOP,KAAU;AAClC,EAAIO,KAAUH,EAAW,SAASJ,CAAK,GAGnCO,IACFH,EAAW,OAAO,OAAOH,KAAQ,WAAWA,IAAM,CAAC,IAGnDG,EAAW,OAAO,OAAOH,KAAQ,WAAWA,IAAM,MAAS;AAG7D,QAAMO,IAA+C,CAAA;AACrD,EAAIT,MACE,OAAOA,EAAK,SAAU,aAAUS,EAAW,QAAQT,EAAK,QACxD,OAAOA,EAAK,cAAe,aAAUS,EAAW,aAAaT,EAAK,aAClE,OAAOA,EAAK,UAAW,cAAWS,EAAW,SAAST,EAAK;AAGjE,QAAMU,IAAiB,OAAO,KAAKN,CAAW,EAAE,SAAS,GACnDO,IAAgB,OAAO,KAAKF,CAAU,EAAE,SAAS,GAEjDG,IAAoB,EAAE,GAAGT,EAAA;AAC/B,SAAIO,QAAqB,QAAQN,IAC7BO,QAAoB,OAAOF,IAExBG;AACT;AA6BO,SAASC,EACdC,GACAf,GACgC;AAChC,SAAOgB,EAAcnB,GAAcE,EAAcC,CAAK,GAAGe,CAAI;AAC/D;AAYO,SAASE,EAAkBC,IAAmB,UAAgB;AAGrE;;;;;;;;"}

package/dist/esm/chunks/index94.js

@@ -0,0 +1,47 @@
+import { c as g } from "./dom.js";
+const c = "select", h = "select";
+function E(o) {
+  if (!o) return;
+  const {
+    aria: r,
+    name: f,
+    form: u,
+    disabled: d,
+    required: b,
+    multiple: m,
+    size: a,
+    autofocus: p,
+    autoComplete: y,
+    dirName: S,
+    ...l
+  } = o, i = { ...l.attrs ?? {} }, e = (t, s) => {
+    s !== void 0 && (Object.prototype.hasOwnProperty.call(i, t) || (i[t] = s));
+  };
+  e("name", f), e("form", u), typeof a == "number" && e("size", a), e("autocomplete", y), e("dirname", S), d === !0 && e("disabled", ""), b === !0 && e("required", ""), m === !0 && e("multiple", ""), p === !0 && e("autofocus", "");
+  const n = { ...l };
+  if (Object.keys(i).length > 0 && (n.attrs = i), r) {
+    const t = {};
+    typeof r.label == "string" && (t.label = r.label), typeof r.labelledby == "string" && (t.labelledby = r.labelledby), typeof r.hidden == "boolean" && (t.hidden = r.hidden), Object.keys(t).length > 0 && (n.aria = t);
+  }
+  return n;
+}
+function O(o) {
+  return g(c, E(o));
+}
+function _(o = document) {
+}
+const T = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  SELECT_SELECTOR: h,
+  SELECT_TAG: c,
+  createSelect: O,
+  enhanceSelects: _
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  h as S,
+  c as a,
+  O as c,
+  _ as e,
+  T as i
+};
+//# sourceMappingURL=index94.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index94.js","sources":["../../../src/elements/form/select/index.ts"],"sourcesContent":["/**\n * Fundatio Design Foundation: Select element helpers.\n *\n * @remarks\n * The select element (`<select>`) is a form control for choosing one or more\n * options from a list, typically expressed via child `<option>` and `<optgroup>`\n * elements. ([developer.mozilla.org](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/select?utm_source=chatgpt.com))\n *\n * Best-practice guidance:\n * - Provide an accessible name via a `<label>` or ARIA labelling.\n * - Prefer native semantics over custom \"fake selects\" unless you have a very\n *   good reason (and a lot of time for accessibility testing).\n * - Use `multiple` and/or `size` intentionally; they change presentation and\n *   interaction patterns. ([developer.mozilla.org](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/select?utm_source=chatgpt.com))\n * - Use `autocomplete` as a hint to user agents, not a security control. (HTML Standard)\n *\n * Fundatio-specific conventions:\n * - Applies global attributes via Fundatio's hardened DOM helpers (`dom.ts`), which\n *   block inline event handler attributes (e.g. `onclick`) and the raw `style`\n *   attribute string.\n * - Supports a small structured ARIA input to reduce typo-based ARIA bugs.\n *\n * This module has no side effects and does not mutate the DOM unless you call\n * its functions.\n *\n * @module\n * @category Elements\n */\n\nimport { createElement, type AttrValue, type ElementOf, type GlobalAttrs } from '../../../ts/dom';\n\n/**\n * Structured ARIA input supported by Fundatio element factories.\n *\n * @remarks\n * This is intentionally a small, typed subset mapped into {@link GlobalAttrs.aria}.\n *\n * @category Attributes\n */\nexport type StructuredAria = {\n  /**\n   * Accessible label, mapped to `aria-label`.\n   */\n  label?: string;\n\n  /**\n   * ID reference(s) to labelling element(s), mapped to `aria-labelledby`.\n   */\n  labelledby?: string;\n\n  /**\n   * Decorative/hidden hint, mapped to `aria-hidden`.\n   */\n  hidden?: boolean;\n};\n\n/**\n * The semantic tag name for select controls.\n *\n * @category Constants\n */\nexport const SELECT_TAG = 'select' as const;\n\n/**\n * A CSS selector targeting select elements.\n *\n * @category Constants\n */\nexport const SELECT_SELECTOR = 'select';\n\n/**\n * Attribute bag for select creation/enhancement.\n *\n * @remarks\n * `<select>` accepts global attributes plus a small set of form-control and\n * select-specific attributes such as `multiple` and `size`. ([developer.mozilla.org](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/select?utm_source=chatgpt.com))\n *\n * Fundatio models the most common attributes explicitly and leaves an escape hatch via\n * {@link GlobalAttrs.attrs} for less common cases (validated by `dom.ts`).\n *\n * @category Attributes\n */\nexport type SelectAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n\n  /**\n   * The form control name (used during submission).\n   */\n  name?: string;\n\n  /**\n   * Explicitly associate the control with a form by ID.\n   */\n  form?: string;\n\n  /**\n   * Disables the control when true.\n   */\n  disabled?: boolean;\n\n  /**\n   * Marks the control required for form submission.\n   */\n  required?: boolean;\n\n  /**\n   * Enables selection of multiple options.\n   */\n  multiple?: boolean;\n\n  /**\n   * Number of options visible at once. Commonly used with `multiple`.\n   */\n  size?: number;\n\n  /**\n   * Autofocus hint.\n   */\n  autofocus?: boolean;\n\n  /**\n   * Autofill hint for user agents.\n   *\n   * @remarks\n   * Defined by HTML for form controls.\n   */\n  autoComplete?: string;\n\n  /**\n   * Directionality submission control (submits `name.dir`).\n   *\n   * @remarks\n   * Defined by the HTML form-control infrastructure (`dirname`).\n   */\n  dirName?: string;\n};\n\n/**\n * Normalize {@link SelectAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @remarks\n * Pattern:\n * - Start with any caller-provided raw attrs escape hatch.\n * - Apply typed attributes without overriding explicit raw attributes.\n * - Map structured ARIA into {@link GlobalAttrs.aria}.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: SelectAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const {\n    aria,\n    name,\n    form,\n    disabled,\n    required,\n    multiple,\n    size,\n    autofocus,\n    autoComplete,\n    dirName,\n    ...rest\n  } = attrs;\n\n  const mergedAttrs: Record<string, AttrValue> = { ...(rest.attrs ?? {}) };\n\n  const setIfUnset = (key: string, v: AttrValue | undefined): void => {\n    if (v === undefined) return;\n    if (Object.prototype.hasOwnProperty.call(mergedAttrs, key)) return;\n    mergedAttrs[key] = v;\n  };\n\n  setIfUnset('name', name);\n  setIfUnset('form', form);\n\n  if (typeof size === 'number') setIfUnset('size', size);\n\n  setIfUnset('autocomplete', autoComplete);\n  setIfUnset('dirname', dirName);\n\n  // Boolean attributes: presence (empty string) when true.\n  if (disabled === true) setIfUnset('disabled', '');\n  if (required === true) setIfUnset('required', '');\n  if (multiple === true) setIfUnset('multiple', '');\n  if (autofocus === true) setIfUnset('autofocus', '');\n\n  const mapped: GlobalAttrs = { ...rest };\n\n  if (Object.keys(mergedAttrs).length > 0) {\n    mapped.attrs = mergedAttrs;\n  }\n\n  if (aria) {\n    const mappedAria: NonNullable<GlobalAttrs['aria']> = {};\n    if (typeof aria.label === 'string') mappedAria.label = aria.label;\n    if (typeof aria.labelledby === 'string') mappedAria.labelledby = aria.labelledby;\n    if (typeof aria.hidden === 'boolean') mappedAria.hidden = aria.hidden;\n\n    if (Object.keys(mappedAria).length > 0) {\n      mapped.aria = mappedAria;\n    }\n  }\n\n  return mapped;\n}\n\n/**\n * Create a select element with optional attributes.\n *\n * @remarks\n * - `<select>` content is provided via child `<option>`/`<optgroup>` elements,\n *   not text content. ([developer.mozilla.org](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/select?utm_source=chatgpt.com))\n * - Global attributes are applied via Fundatio's shared DOM helper, including security\n *   guards that block inline event handler attributes (e.g. `onclick`) and raw\n *   `style` attribute strings.\n *\n * @param attrs - Optional attributes to apply.\n * @returns The created `<select>` element.\n *\n * @example\n * ```ts\n * import { createSelect } from \"@Vastare/Fundatio/elements/form/select\";\n *\n * const s = createSelect({ name: \"country\", required: true });\n * ```\n *\n * @category DOM\n */\nexport function createSelect(attrs?: SelectAttrs): ElementOf<typeof SELECT_TAG> {\n  return createElement(SELECT_TAG, toGlobalAttrs(attrs));\n}\n\n/**\n * Enhance select elements within a given root.\n *\n * @remarks\n * This is intentionally a no-op in `1.0.0`.\n *\n * @param root - The node to search within. Defaults to `document`.\n *\n * @category Enhancement\n */\nexport function enhanceSelects(root: ParentNode = document): void {\n  // v1.0.0: no runtime behavior for select.\n  void root;\n}\n"],"names":["SELECT_TAG","SELECT_SELECTOR","toGlobalAttrs","attrs","aria","name","form","disabled","required","multiple","size","autofocus","autoComplete","dirName","rest","mergedAttrs","setIfUnset","key","v","mapped","mappedAria","createSelect","createElement","enhanceSelects","root"],"mappings":";AA6DO,MAAMA,IAAa,UAObC,IAAkB;AAmF/B,SAASC,EAAcC,GAA8C;AACnE,MAAI,CAACA,EAAO;AAEZ,QAAM;AAAA,IACJ,MAAAC;AAAA,IACA,MAAAC;AAAA,IACA,MAAAC;AAAA,IACA,UAAAC;AAAA,IACA,UAAAC;AAAA,IACA,UAAAC;AAAA,IACA,MAAAC;AAAA,IACA,WAAAC;AAAA,IACA,cAAAC;AAAA,IACA,SAAAC;AAAA,IACA,GAAGC;AAAA,EAAA,IACDX,GAEEY,IAAyC,EAAE,GAAID,EAAK,SAAS,CAAA,EAAC,GAE9DE,IAAa,CAACC,GAAaC,MAAmC;AAClE,IAAIA,MAAM,WACN,OAAO,UAAU,eAAe,KAAKH,GAAaE,CAAG,MACzDF,EAAYE,CAAG,IAAIC;AAAA,EACrB;AAEA,EAAAF,EAAW,QAAQX,CAAI,GACvBW,EAAW,QAAQV,CAAI,GAEnB,OAAOI,KAAS,YAAUM,EAAW,QAAQN,CAAI,GAErDM,EAAW,gBAAgBJ,CAAY,GACvCI,EAAW,WAAWH,CAAO,GAGzBN,MAAa,MAAMS,EAAW,YAAY,EAAE,GAC5CR,MAAa,MAAMQ,EAAW,YAAY,EAAE,GAC5CP,MAAa,MAAMO,EAAW,YAAY,EAAE,GAC5CL,MAAc,MAAMK,EAAW,aAAa,EAAE;AAElD,QAAMG,IAAsB,EAAE,GAAGL,EAAA;AAMjC,MAJI,OAAO,KAAKC,CAAW,EAAE,SAAS,MACpCI,EAAO,QAAQJ,IAGbX,GAAM;AACR,UAAMgB,IAA+C,CAAA;AACrD,IAAI,OAAOhB,EAAK,SAAU,aAAUgB,EAAW,QAAQhB,EAAK,QACxD,OAAOA,EAAK,cAAe,aAAUgB,EAAW,aAAahB,EAAK,aAClE,OAAOA,EAAK,UAAW,cAAWgB,EAAW,SAAShB,EAAK,SAE3D,OAAO,KAAKgB,CAAU,EAAE,SAAS,MACnCD,EAAO,OAAOC;AAAA,EAElB;AAEA,SAAOD;AACT;AAwBO,SAASE,EAAalB,GAAmD;AAC9E,SAAOmB,EAActB,GAAYE,EAAcC,CAAK,CAAC;AACvD;AAYO,SAASoB,EAAeC,IAAmB,UAAgB;AAGlE;;;;;;;;"}