@lnpg/pkgn-sol 1.0.0-beta.0

package/dist/esm/elements/form/progress/progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.js","names":[],"sources":["../../../../../src/elements/form/progress/index.ts"],"sourcesContent":["/**\n * pkgn-sol 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 * pkgn-sol notes:\n * - This module is framework-agnostic and has no side effects.\n * - Global attributes are applied via pkgn-sol'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 pkgn-sol 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 * pkgn-sol behavior:\n * - If `value` is omitted, pkgn-sol does NOT set it, preserving indeterminate semantics.\n * - If `value` is provided and `max` is omitted, pkgn-sol 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 pkgn-sol'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 `0.1.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  // v0.1.0: no runtime behavior for progress.\n  void root;\n}\n"],"mappings":";;;;;;;IA+Da,IAAe,YAOf,IAAoB;AAuDjC,SAAS,EAAc,GAAgD;CACrE,IAAI,CAAC,GAAO;CAEZ,IAAM,EAAE,SAAM,UAAO,QAAK,GAAG,MAAS,GAEhC,IAAyC,EAAE,GAAI,EAAK,SAAS,EAAE,EAAG,EAElE,KAAc,GAAa,MAAmC;EAC9D,MAAM,KAAA,MACN,OAAO,UAAU,eAAe,KAAK,GAAa,EAAI,KAC1D,EAAY,KAAO;IAIf,IAAW,OAAO,KAAU;CAIlC,AAHI,KAAU,EAAW,SAAS,EAAM,EAGpC,IACF,EAAW,OAAO,OAAO,KAAQ,WAAW,IAAM,EAAE,GAGpD,EAAW,OAAO,OAAO,KAAQ,WAAW,IAAM,KAAA,EAAU;CAG9D,IAAM,IAA+C,EAAE;CACvD,AAAI,MACE,OAAO,EAAK,SAAU,aAAU,EAAW,QAAQ,EAAK,QACxD,OAAO,EAAK,cAAe,aAAU,EAAW,aAAa,EAAK,aAClE,OAAO,EAAK,UAAW,cAAW,EAAW,SAAS,EAAK;CAGjE,IAAM,IAAiB,OAAO,KAAK,EAAY,CAAC,SAAS,GACnD,IAAgB,OAAO,KAAK,EAAW,CAAC,SAAS,GAEjD,IAAoB,EAAE,GAAG,GAAM;CAIrC,OAHI,MAAgB,EAAK,QAAQ,IAC7B,MAAe,EAAK,OAAO,IAExB;;AA8BT,SAAgB,EACd,GACA,GACgC;CAChC,OAAO,EAAc,GAAc,EAAc,EAAM,EAAE,EAAK;;AAahE,SAAgB,EAAkB,IAAmB,UAAgB"}

package/dist/esm/elements/form/select/select.js

@@ -0,0 +1,29 @@
+import { i as e, n as t } from "../../../chunks/dom.js";
+//#region src/elements/form/select/index.ts
+var n = /* @__PURE__ */ e({
+	SELECT_SELECTOR: () => i,
+	SELECT_TAG: () => r,
+	createSelect: () => o,
+	enhanceSelects: () => s
+}), r = "select", i = "select";
+function a(e) {
+	if (!e) return;
+	let { aria: t, name: n, form: r, disabled: i, required: a, multiple: o, size: s, autofocus: c, autoComplete: l, dirName: u, ...d } = e, f = { ...d.attrs ?? {} }, p = (e, t) => {
+		t !== void 0 && (Object.prototype.hasOwnProperty.call(f, e) || (f[e] = t));
+	};
+	p("name", n), p("form", r), typeof s == "number" && p("size", s), p("autocomplete", l), p("dirname", u), i === !0 && p("disabled", ""), a === !0 && p("required", ""), o === !0 && p("multiple", ""), c === !0 && p("autofocus", "");
+	let m = { ...d };
+	if (Object.keys(f).length > 0 && (m.attrs = f), t) {
+		let e = {};
+		typeof t.label == "string" && (e.label = t.label), typeof t.labelledby == "string" && (e.labelledby = t.labelledby), typeof t.hidden == "boolean" && (e.hidden = t.hidden), Object.keys(e).length > 0 && (m.aria = e);
+	}
+	return m;
+}
+function o(e) {
+	return t(r, a(e));
+}
+function s(e = document) {}
+//#endregion
+export { i as SELECT_SELECTOR, r as SELECT_TAG, o as createSelect, s as enhanceSelects, n as t };
+
+//# sourceMappingURL=select.js.map

package/dist/esm/elements/form/select/select.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.js","names":[],"sources":["../../../../../src/elements/form/select/index.ts"],"sourcesContent":["/**\n * pkgn-sol 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 * pkgn-sol-specific conventions:\n * - Applies global attributes via pkgn-sol'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 pkgn-sol 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 * pkgn-sol 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 pkgn-sol'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 \"@lnpg/pkgn-sol/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 `0.1.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  // v0.1.0: no runtime behavior for select.\n  void root;\n}\n"],"mappings":";;;;;;;IA6Da,IAAa,UAOb,IAAkB;AAmF/B,SAAS,EAAc,GAA8C;CACnE,IAAI,CAAC,GAAO;CAEZ,IAAM,EACJ,SACA,SACA,SACA,aACA,aACA,aACA,SACA,cACA,iBACA,YACA,GAAG,MACD,GAEE,IAAyC,EAAE,GAAI,EAAK,SAAS,EAAE,EAAG,EAElE,KAAc,GAAa,MAAmC;EAC9D,MAAM,KAAA,MACN,OAAO,UAAU,eAAe,KAAK,GAAa,EAAI,KAC1D,EAAY,KAAO;;CAerB,AAZA,EAAW,QAAQ,EAAK,EACxB,EAAW,QAAQ,EAAK,EAEpB,OAAO,KAAS,YAAU,EAAW,QAAQ,EAAK,EAEtD,EAAW,gBAAgB,EAAa,EACxC,EAAW,WAAW,EAAQ,EAG1B,MAAa,MAAM,EAAW,YAAY,GAAG,EAC7C,MAAa,MAAM,EAAW,YAAY,GAAG,EAC7C,MAAa,MAAM,EAAW,YAAY,GAAG,EAC7C,MAAc,MAAM,EAAW,aAAa,GAAG;CAEnD,IAAM,IAAsB,EAAE,GAAG,GAAM;CAMvC,IAJI,OAAO,KAAK,EAAY,CAAC,SAAS,MACpC,EAAO,QAAQ,IAGb,GAAM;EACR,IAAM,IAA+C,EAAE;EAKvD,AAJI,OAAO,EAAK,SAAU,aAAU,EAAW,QAAQ,EAAK,QACxD,OAAO,EAAK,cAAe,aAAU,EAAW,aAAa,EAAK,aAClE,OAAO,EAAK,UAAW,cAAW,EAAW,SAAS,EAAK,SAE3D,OAAO,KAAK,EAAW,CAAC,SAAS,MACnC,EAAO,OAAO;;CAIlB,OAAO;;AAyBT,SAAgB,EAAa,GAAmD;CAC9E,OAAO,EAAc,GAAY,EAAc,EAAM,CAAC;;AAaxD,SAAgB,EAAe,IAAmB,UAAgB"}

package/dist/esm/elements/form/textarea/textarea.js

@@ -0,0 +1,31 @@
+import { i as e, n as t } from "../../../chunks/dom.js";
+//#region src/elements/form/textarea/index.ts
+var n = /* @__PURE__ */ e({
+	TEXTAREA_SELECTOR: () => i,
+	TEXTAREA_TAG: () => r,
+	createTextarea: () => o,
+	enhanceTextareas: () => s
+}), r = "textarea", i = "textarea";
+function a(e) {
+	if (!e) return;
+	let { aria: t, name: n, form: r, disabled: i, required: a, readOnly: o, cols: s, rows: c, minLength: l, maxLength: u, placeholder: d, autoComplete: f, autoFocus: p, autoCapitalize: m, dirName: h, wrap: g, ..._ } = e, v = { ..._ }, y = { ...v.attrs ?? {} };
+	if (typeof n == "string" && (y.name = n), typeof r == "string" && (y.form = r), i === !0 && (y.disabled = !0), a === !0 && (y.required = !0), o === !0 && (y.readonly = !0), typeof s == "number" && Number.isFinite(s) && (y.cols = s), typeof c == "number" && Number.isFinite(c) && (y.rows = c), typeof l == "number" && Number.isFinite(l) && (y.minlength = l), typeof u == "number" && Number.isFinite(u) && (y.maxlength = u), typeof d == "string" && (y.placeholder = d), typeof f == "string" && (y.autocomplete = f), p === !0 && (y.autofocus = !0), typeof m == "string" && (y.autocapitalize = m), typeof h == "string") {
+		let e = h.trim();
+		if (e.length === 0) throw Error("textarea dirName must not be an empty string.");
+		y.dirname = e;
+	}
+	if ((g === "soft" || g === "hard") && (y.wrap = g, g === "hard" && y.cols === void 0 && (y.cols = 20)), Object.keys(y).length > 0 && (v.attrs = y), !t) return v;
+	let b = {};
+	return typeof t.label == "string" && (b.label = t.label), typeof t.labelledby == "string" && (b.labelledby = t.labelledby), typeof t.hidden == "boolean" && (b.hidden = t.hidden), Object.keys(b).length > 0 ? {
+		...v,
+		aria: b
+	} : v;
+}
+function o(e, n) {
+	return t(r, a(n), e);
+}
+function s(e = document) {}
+//#endregion
+export { i as TEXTAREA_SELECTOR, r as TEXTAREA_TAG, o as createTextarea, s as enhanceTextareas, n as t };
+
+//# sourceMappingURL=textarea.js.map

package/dist/esm/elements/form/textarea/textarea.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"textarea.js","names":[],"sources":["../../../../../src/elements/form/textarea/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: Textarea element helpers.\n *\n * @remarks\n * The textarea element (`<textarea>`) is a multi-line plain-text form control.\n *\n * Best-practice guidance:\n * - Always provide an accessible name (typically via a `<label>`).\n * - Prefer `placeholder` as a hint, not as a substitute for a label.\n * - Use `rows`/`cols` to set a sensible baseline size, then use CSS for layout.\n * - Use `minLength`/`maxLength` for client-side constraints, but validate on the server.\n * - Use `wrap=\"hard\"` only when you intentionally want line breaks inserted for\n *   form submission, and ensure `cols` is set.\n * - Use `dirname` only when you actually want directionality included in submission.\n *\n * Attributes (element-specific):\n * - `name`, `form`, `disabled`, `required`, `readOnly`\n * - `cols`, `rows`\n * - `minLength`, `maxLength`\n * - `placeholder`\n * - `autoComplete`, `autoFocus`, `autoCapitalize`\n * - `dirName`\n * - `wrap`\n *\n * Security:\n * - Global attribute escape hatches are guarded by pkgn-sol'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/textarea\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 pkgn-sol 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 textarea.\n *\n * @category Constants\n */\nexport const TEXTAREA_TAG = 'textarea' as const;\n\n/**\n * A CSS selector targeting textarea elements.\n *\n * @category Constants\n */\nexport const TEXTAREA_SELECTOR = 'textarea';\n\n/**\n * Textarea wrap modes.\n *\n * @remarks\n * - `soft` (default): the submitted value is not forcibly wrapped.\n * - `hard`: line breaks are inserted for submission based on `cols`.\n *\n * @category Types\n */\nexport type TextareaWrap = 'soft' | 'hard';\n\n/**\n * Autocapitalize values accepted by browsers for form controls.\n *\n * @remarks\n * This is a content attribute commonly supported on form controls.\n *\n * @category Types\n */\nexport type AutoCapitalize = 'off' | 'none' | 'on' | 'sentences' | 'words' | 'characters';\n\n/**\n * Attribute bag for textarea creation/enhancement.\n *\n * @remarks\n * Textareas accept standard HTML global attributes plus textarea-specific content\n * attributes.\n *\n * pkgn-sol also supports a structured ARIA input for common ARIA fields, which is\n * mapped into {@link GlobalAttrs.aria} without changing pkgn-sol's core DOM helpers.\n *\n * @category Attributes\n */\nexport type TextareaAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n\n  /**\n   * Name used during form submission.\n   */\n  name?: string;\n\n  /**\n   * Associate the control with a form by ID.\n   */\n  form?: string;\n\n  /**\n   * Whether the textarea is disabled.\n   */\n  disabled?: boolean;\n\n  /**\n   * Whether the textarea is required.\n   */\n  required?: boolean;\n\n  /**\n   * Whether the textarea is read-only.\n   *\n   * @remarks\n   * Maps to the `readonly` content attribute.\n   */\n  readOnly?: boolean;\n\n  /**\n   * The number of visible text columns.\n   */\n  cols?: number;\n\n  /**\n   * The number of visible text rows.\n   */\n  rows?: number;\n\n  /**\n   * Minimum input length.\n   *\n   * @remarks\n   * Maps to the `minlength` content attribute.\n   */\n  minLength?: number;\n\n  /**\n   * Maximum input length.\n   *\n   * @remarks\n   * Maps to the `maxlength` content attribute.\n   */\n  maxLength?: number;\n\n  /**\n   * Placeholder hint text.\n   */\n  placeholder?: string;\n\n  /**\n   * Autofill hint.\n   */\n  autoComplete?: string;\n\n  /**\n   * Whether the control should be focused on page load.\n   */\n  autoFocus?: boolean;\n\n  /**\n   * Autocapitalization behavior.\n   */\n  autoCapitalize?: AutoCapitalize;\n\n  /**\n   * Submission directionality field name.\n   *\n   * @remarks\n   * When set, the value must not be empty.\n   * Maps to the `dirname` content attribute.\n   */\n  dirName?: string;\n\n  /**\n   * Wrapping mode for form submission.\n   */\n  wrap?: TextareaWrap;\n};\n\n/**\n * Normalize {@link TextareaAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The textarea attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @throws Error if `dirName` is provided but empty/whitespace.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: TextareaAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const {\n    aria,\n    name,\n    form,\n    disabled,\n    required,\n    readOnly,\n    cols,\n    rows,\n    minLength,\n    maxLength,\n    placeholder,\n    autoComplete,\n    autoFocus,\n    autoCapitalize,\n    dirName,\n    wrap,\n    ...rest\n  } = attrs;\n\n  const mapped: GlobalAttrs = { ...rest };\n\n  const extra: NonNullable<GlobalAttrs['attrs']> = { ...(mapped.attrs ?? {}) };\n\n  if (typeof name === 'string') extra.name = name;\n  if (typeof form === 'string') extra.form = form;\n\n  if (disabled === true) extra.disabled = true;\n  if (required === true) extra.required = true;\n  if (readOnly === true) extra.readonly = true;\n\n  if (typeof cols === 'number' && Number.isFinite(cols)) extra.cols = cols;\n  if (typeof rows === 'number' && Number.isFinite(rows)) extra.rows = rows;\n\n  if (typeof minLength === 'number' && Number.isFinite(minLength)) extra.minlength = minLength;\n  if (typeof maxLength === 'number' && Number.isFinite(maxLength)) extra.maxlength = maxLength;\n\n  if (typeof placeholder === 'string') extra.placeholder = placeholder;\n\n  if (typeof autoComplete === 'string') extra.autocomplete = autoComplete;\n  if (autoFocus === true) extra.autofocus = true;\n  if (typeof autoCapitalize === 'string') extra.autocapitalize = autoCapitalize;\n\n  if (typeof dirName === 'string') {\n    const dn = dirName.trim();\n    if (dn.length === 0) {\n      throw new Error('textarea dirName must not be an empty string.');\n    }\n    extra.dirname = dn;\n  }\n\n  if (wrap === 'soft' || wrap === 'hard') {\n    extra.wrap = wrap;\n\n    // \"hard\" wrap only has an effect when cols is set, so we enforce a safe default.\n    if (wrap === 'hard' && typeof extra.cols === 'undefined') {\n      extra.cols = 20;\n    }\n  }\n\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 a textarea element with optional initial value and attributes.\n *\n * @remarks\n * For `<textarea>`, the initial value is represented by its text content in HTML.\n * pkgn-sol assigns the provided `text` via `textContent` (never `innerHTML`).\n *\n * - Text content is assigned via `textContent` (never `innerHTML`).\n * - Global attributes and escape-hatch attributes are applied via pkgn-sol'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 initial value (assigned as `textContent`).\n * @param attrs - Optional attributes to apply.\n * @returns The created `<textarea>` element.\n *\n * @example\n * ```ts\n * import { createTextarea } from \"@lnpg/pkgn-sol/elements/form/textarea\";\n *\n * const t = createTextarea(\"Hello\", { rows: 4, cols: 40, name: \"message\" });\n * ```\n *\n * @category DOM\n */\nexport function createTextarea(\n  text?: string,\n  attrs?: TextareaAttrs,\n): ElementOf<typeof TEXTAREA_TAG> {\n  return createElement(TEXTAREA_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance textarea elements within a given root.\n *\n * @remarks\n * This is intentionally a no-op in `0.1.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 enhanceTextareas(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for textarea.\n  void root;\n}\n"],"mappings":";;;;;;;IAsEa,IAAe,YAOf,IAAoB;AA4IjC,SAAS,EAAc,GAAgD;CACrE,IAAI,CAAC,GAAO;CAEZ,IAAM,EACJ,SACA,SACA,SACA,aACA,aACA,aACA,SACA,SACA,cACA,cACA,gBACA,iBACA,cACA,mBACA,YACA,SACA,GAAG,MACD,GAEE,IAAsB,EAAE,GAAG,GAAM,EAEjC,IAA2C,EAAE,GAAI,EAAO,SAAS,EAAE,EAAG;CAqB5E,IAnBI,OAAO,KAAS,aAAU,EAAM,OAAO,IACvC,OAAO,KAAS,aAAU,EAAM,OAAO,IAEvC,MAAa,OAAM,EAAM,WAAW,KACpC,MAAa,OAAM,EAAM,WAAW,KACpC,MAAa,OAAM,EAAM,WAAW,KAEpC,OAAO,KAAS,YAAY,OAAO,SAAS,EAAK,KAAE,EAAM,OAAO,IAChE,OAAO,KAAS,YAAY,OAAO,SAAS,EAAK,KAAE,EAAM,OAAO,IAEhE,OAAO,KAAc,YAAY,OAAO,SAAS,EAAU,KAAE,EAAM,YAAY,IAC/E,OAAO,KAAc,YAAY,OAAO,SAAS,EAAU,KAAE,EAAM,YAAY,IAE/E,OAAO,KAAgB,aAAU,EAAM,cAAc,IAErD,OAAO,KAAiB,aAAU,EAAM,eAAe,IACvD,MAAc,OAAM,EAAM,YAAY,KACtC,OAAO,KAAmB,aAAU,EAAM,iBAAiB,IAE3D,OAAO,KAAY,UAAU;EAC/B,IAAM,IAAK,EAAQ,MAAM;EACzB,IAAI,EAAG,WAAW,GAChB,MAAU,MAAM,gDAAgD;EAElE,EAAM,UAAU;;CAgBlB,KAbI,MAAS,UAAU,MAAS,YAC9B,EAAM,OAAO,GAGT,MAAS,UAAiB,EAAM,SAAS,WAC3C,EAAM,OAAO,MAIb,OAAO,KAAK,EAAM,CAAC,SAAS,MAC9B,EAAO,QAAQ,IAGb,CAAC,GAAM,OAAO;CAElB,IAAM,IAA+C,EAAE;CAQvD,OANI,OAAO,EAAK,SAAU,aAAU,EAAW,QAAQ,EAAK,QACxD,OAAO,EAAK,cAAe,aAAU,EAAW,aAAa,EAAK,aAClE,OAAO,EAAK,UAAW,cAAW,EAAW,SAAS,EAAK,SAEzC,OAAO,KAAK,EAAW,CAAC,SAAS,IAEhC;EAAE,GAAG;EAAQ,MAAM;EAAY,GAAG;;AA4B3D,SAAgB,EACd,GACA,GACgC;CAChC,OAAO,EAAc,GAAc,EAAc,EAAM,EAAE,EAAK;;AAqBhE,SAAgB,EAAiB,IAAmB,UAAgB"}

package/dist/esm/elements/heading/h1/h1.js

@@ -0,0 +1,26 @@
+import { i as e, n as t } from "../../../chunks/dom.js";
+//#region src/elements/heading/h1/index.ts
+var n = /* @__PURE__ */ e({
+	H1_SELECTOR: () => "h1",
+	H1_TAG: () => "h1",
+	createH1: () => o,
+	enhanceH1s: () => s
+}), r = "h1", i = "h1";
+function a(e) {
+	if (!e) return;
+	let { aria: t, ...n } = e;
+	if (!t) return n;
+	let r = {};
+	return 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 ? {
+		...n,
+		aria: r
+	} : n;
+}
+function o(e, n) {
+	return t("h1", a(n), e);
+}
+function s(e = document) {}
+//#endregion
+export { i as H1_SELECTOR, r as H1_TAG, o as createH1, s as enhanceH1s, n as t };
+
+//# sourceMappingURL=h1.js.map

package/dist/esm/elements/heading/h1/h1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"h1.js","names":[],"sources":["../../../../../src/elements/heading/h1/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: H1 element helpers.\n *\n * @remarks\n * The h1 element (`<h1>`) represents the highest-rank section heading.\n *\n * Best-practice guidance:\n * - Use headings to convey document structure, not for visual styling.\n * - Keep heading levels ordered (don't jump from `<h1>` to `<h3>` because you\n *   like the font size). Use CSS for presentation.\n * - Prefer clear, succinct headings that describe the section that follows.\n * - Many accessibility guides recommend a single `<h1>` as the page/document's\n *   primary heading. HTML allows multiple headings, but consistency matters.\n * - Don't rely on default browser heading styles; user-agent styles can change.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create `<h1>` elements in vanilla JS/TS without templates\n * - apply consistent global attributes safely\n * - use a stable \"enhancement\" hook if pkgn-sol ever needs runtime behavior\n *\n * This module has no side effects and does not mutate the DOM unless you call\n * its functions.\n *\n * References:\n * - MDN: Heading elements: https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/Heading_Elements\n * - MDN: Headings and paragraphs: https://developer.mozilla.org/en-US/docs/Learn_web_development/Core/Structuring_content/Headings_and_paragraphs\n * - W3C WAI: Headings: https://www.w3.org/WAI/tutorials/page-structure/headings/\n * - WHATWG HTML: Sections / heading content: https://html.spec.whatwg.org/multipage/sections.html\n *\n * @module\n * @category Elements\n */\n\nimport { createElement, type ElementOf, type GlobalAttrs } from '../../../ts/dom';\n\n/**\n * Structured ARIA input supported by pkgn-sol element factories.\n *\n * @remarks\n * This is intentionally a small, typed subset that covers common cases and\n * prevents typo-based ARIA bugs (e.g. `lable`).\n *\n * It is mapped into {@link GlobalAttrs.aria} for application by `dom.ts`.\n *\n * @category Attributes\n */\nexport type StructuredAria = {\n  /**\n   * Accessible label, mapped to `aria-label`.\n   */\n  label?: string;\n\n  /**\n   * ID reference to the labelling element(s), mapped to `aria-labelledby`.\n   */\n  labelledby?: string;\n\n  /**\n   * Decorative/hidden hint, mapped to `aria-hidden`.\n   */\n  hidden?: boolean;\n};\n\n/**\n * The semantic tag name for the primary heading element.\n *\n * @category Constants\n */\nexport const H1_TAG = 'h1' as const;\n\n/**\n * A CSS selector targeting h1 elements.\n *\n * @category Constants\n */\nexport const H1_SELECTOR = 'h1';\n\n/**\n * Attribute bag for h1 creation/enhancement.\n *\n * @remarks\n * H1 elements accept standard HTML global attributes.\n *\n * pkgn-sol also supports a structured ARIA input for common ARIA fields, which is\n * mapped into {@link GlobalAttrs.aria} without changing pkgn-sol's core DOM helpers.\n *\n * @category Attributes\n */\nexport type H1Attrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link H1Attrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The h1 attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: H1Attrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, ...rest } = attrs;\n\n  if (!aria) return rest;\n\n  const mappedAria: NonNullable<GlobalAttrs['aria']> = {};\n\n  if (typeof aria.label === 'string') mappedAria.label = aria.label;\n  if (typeof aria.labelledby === 'string') mappedAria.labelledby = aria.labelledby;\n  if (typeof aria.hidden === 'boolean') mappedAria.hidden = aria.hidden;\n\n  // Only attach `aria` if something was actually defined.\n  const hasMapped = Object.keys(mappedAria).length > 0;\n\n  return hasMapped ? { ...rest, aria: mappedAria } : rest;\n}\n\n/**\n * Create an h1 element with optional text content and global attributes.\n *\n * @remarks\n * - Text content is assigned via `textContent` (never `innerHTML`).\n * - Global attributes are applied via pkgn-sol's shared DOM helper,\n *   including security guards that block inline event handler attributes\n *   (e.g. `onclick`) and raw `style` attribute strings.\n *\n * @param text - Optional text content for the heading.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<h1>` element.\n *\n * @example\n * ```ts\n * import { createH1 } from \"@lnpg/pkgn-sol/elements/heading/h1\";\n *\n * document.body.prepend(createH1(\"Page title\", { id: \"title\" }));\n * ```\n *\n * @category DOM\n */\nexport function createH1(text?: string, attrs?: H1Attrs): ElementOf<typeof H1_TAG> {\n  return createElement(H1_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance h1 elements within a given root.\n *\n * @remarks\n * This is intentionally a no-op in `0.1.0`.\n *\n * Why does it exist?\n * - It establishes a stable integration pattern for frameworks (Vue/React/etc.)\n * - It allows future progressive enhancements without changing consumer code\n *\n * What it will never do:\n * - It will not inject styles (CSS remains the source of truth)\n * - It will not introduce framework-specific behavior\n *\n * @param root - The node to search within. Defaults to `document`.\n *\n * @category Enhancement\n */\nexport function enhanceH1s(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for h1.\n  void root;\n}\n"],"mappings":";;;;;;;IAoEa,IAAS,MAOT,IAAc;AA4B3B,SAAS,EAAc,GAA0C;CAC/D,IAAI,CAAC,GAAO;CAEZ,IAAM,EAAE,SAAM,GAAG,MAAS;CAE1B,IAAI,CAAC,GAAM,OAAO;CAElB,IAAM,IAA+C,EAAE;CASvD,OAPI,OAAO,EAAK,SAAU,aAAU,EAAW,QAAQ,EAAK,QACxD,OAAO,EAAK,cAAe,aAAU,EAAW,aAAa,EAAK,aAClE,OAAO,EAAK,UAAW,cAAW,EAAW,SAAS,EAAK,SAG7C,OAAO,KAAK,EAAW,CAAC,SAAS,IAEhC;EAAE,GAAG;EAAM,MAAM;EAAY,GAAG;;AAyBrD,SAAgB,EAAS,GAAe,GAA2C;CACjF,OAAO,EAAA,MAAsB,EAAc,EAAM,EAAE,EAAK;;AAqB1D,SAAgB,EAAW,IAAmB,UAAgB"}

package/dist/esm/elements/heading/h2/h2.js

@@ -0,0 +1,26 @@
+import { i as e, n as t } from "../../../chunks/dom.js";
+//#region src/elements/heading/h2/index.ts
+var n = /* @__PURE__ */ e({
+	H2_SELECTOR: () => "h2",
+	H2_TAG: () => "h2",
+	createH2: () => o,
+	enhanceH2s: () => s
+}), r = "h2", i = "h2";
+function a(e) {
+	if (!e) return;
+	let { aria: t, ...n } = e;
+	if (!t) return n;
+	let r = {};
+	return 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 ? {
+		...n,
+		aria: r
+	} : n;
+}
+function o(e, n) {
+	return t("h2", a(n), e);
+}
+function s(e = document) {}
+//#endregion
+export { i as H2_SELECTOR, r as H2_TAG, o as createH2, s as enhanceH2s, n as t };
+
+//# sourceMappingURL=h2.js.map

package/dist/esm/elements/heading/h2/h2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"h2.js","names":[],"sources":["../../../../../src/elements/heading/h2/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: H2 element helpers.\n *\n * @remarks\n * The h2 element (`<h2>`) represents a second-level heading. Headings define the\n * hierarchical structure of a document and provide navigational landmarks for\n * assistive technologies. :contentReference[oaicite:1]{index=1}\n *\n * Best-practice guidance:\n * - Use headings to represent structure, not visual styling.\n * - Prefer a logical hierarchy (e.g. `<h1>` then `<h2>`, then `<h3>`), and avoid\n *   skipping levels purely for appearance. :contentReference[oaicite:2]{index=2}\n * - Keep headings concise and descriptive to support scanning and accessibility. :contentReference[oaicite:3]{index=3}\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create `<h2>` elements in vanilla JS/TS without templates\n * - apply consistent global attributes safely\n * - use a stable \"enhancement\" hook if pkgn-sol 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 pkgn-sol element factories.\n *\n * @remarks\n * This is intentionally a small, typed subset that covers common cases and\n * prevents typo-based ARIA bugs (e.g. `lable`).\n *\n * It is mapped into {@link GlobalAttrs.aria} for application by `dom.ts`.\n *\n * @category Attributes\n */\nexport type StructuredAria = {\n  /**\n   * Accessible label, mapped to `aria-label`.\n   */\n  label?: string;\n\n  /**\n   * ID reference to the labelling element(s), mapped to `aria-labelledby`.\n   */\n  labelledby?: string;\n\n  /**\n   * Decorative/hidden hint, mapped to `aria-hidden`.\n   */\n  hidden?: boolean;\n};\n\n/**\n * The semantic tag name for h2 headings.\n *\n * @category Constants\n */\nexport const H2_TAG = 'h2' as const;\n\n/**\n * A CSS selector targeting h2 elements.\n *\n * @category Constants\n */\nexport const H2_SELECTOR = 'h2';\n\n/**\n * Attribute bag for h2 creation/enhancement.\n *\n * @remarks\n * H2 elements accept standard HTML global attributes.\n *\n * pkgn-sol also supports a structured ARIA input for common ARIA fields, which is\n * mapped into {@link GlobalAttrs.aria} without changing pkgn-sol's core DOM helpers.\n *\n * Security notes:\n * - Inline event handler attributes (e.g. `onclick`) are blocked by `dom.ts`.\n * - The raw `style` attribute is blocked; use {@link GlobalAttrs.style} instead.\n *\n * @category Attributes\n */\nexport type H2Attrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link H2Attrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The h2 attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: H2Attrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, ...rest } = attrs;\n\n  if (!aria) return rest;\n\n  const mappedAria: NonNullable<GlobalAttrs['aria']> = {};\n\n  if (typeof aria.label === 'string') mappedAria.label = aria.label;\n  if (typeof aria.labelledby === 'string') mappedAria.labelledby = aria.labelledby;\n  if (typeof aria.hidden === 'boolean') mappedAria.hidden = aria.hidden;\n\n  // Only attach `aria` if something was actually defined.\n  const hasMapped = Object.keys(mappedAria).length > 0;\n\n  return hasMapped ? { ...rest, aria: mappedAria } : rest;\n}\n\n/**\n * Create an h2 element with optional text content and global attributes.\n *\n * @remarks\n * - Text content is assigned via `textContent` (never `innerHTML`).\n * - Global attributes are applied via pkgn-sol's shared DOM helper,\n *   including security guards that block inline event handler attributes\n *   (e.g. `onclick`) and raw `style` attribute strings.\n *\n * @param text - Optional text content for the h2.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<h2>` element.\n *\n * @example\n * Create and append a heading:\n * ```ts\n * import { createH2 } from \"@lnpg/pkgn-sol/elements/heading/h2\";\n *\n * document.body.appendChild(createH2(\"Section title\", { className: \"section-title\" }));\n * ```\n *\n * @category DOM\n */\nexport function createH2(text?: string, attrs?: H2Attrs): ElementOf<typeof H2_TAG> {\n  return createElement(H2_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance h2 elements within a given root.\n *\n * @remarks\n * This is intentionally a no-op in `0.1.0`.\n *\n * Why does it exist?\n * - It establishes a stable integration pattern for frameworks (Vue/React/etc.)\n * - It allows future progressive enhancements without changing consumer code\n *\n * What it will never do:\n * - It will not inject styles (CSS remains the source of truth)\n * - It will not introduce framework-specific behavior\n *\n * @param root - The node to search within. Defaults to `document`.\n *\n * @category Enhancement\n */\nexport function enhanceH2s(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for h2.\n  void root;\n}\n"],"mappings":";;;;;;;IA6Da,IAAS,MAOT,IAAc;AAgC3B,SAAS,EAAc,GAA0C;CAC/D,IAAI,CAAC,GAAO;CAEZ,IAAM,EAAE,SAAM,GAAG,MAAS;CAE1B,IAAI,CAAC,GAAM,OAAO;CAElB,IAAM,IAA+C,EAAE;CASvD,OAPI,OAAO,EAAK,SAAU,aAAU,EAAW,QAAQ,EAAK,QACxD,OAAO,EAAK,cAAe,aAAU,EAAW,aAAa,EAAK,aAClE,OAAO,EAAK,UAAW,cAAW,EAAW,SAAS,EAAK,SAG7C,OAAO,KAAK,EAAW,CAAC,SAAS,IAEhC;EAAE,GAAG;EAAM,MAAM;EAAY,GAAG;;AA0BrD,SAAgB,EAAS,GAAe,GAA2C;CACjF,OAAO,EAAA,MAAsB,EAAc,EAAM,EAAE,EAAK;;AAqB1D,SAAgB,EAAW,IAAmB,UAAgB"}

package/dist/esm/elements/heading/h3/h3.js

@@ -0,0 +1,26 @@
+import { i as e, n as t } from "../../../chunks/dom.js";
+//#region src/elements/heading/h3/index.ts
+var n = /* @__PURE__ */ e({
+	H3_SELECTOR: () => "h3",
+	H3_TAG: () => "h3",
+	createH3: () => o,
+	enhanceH3s: () => s
+}), r = "h3", i = "h3";
+function a(e) {
+	if (!e) return;
+	let { aria: t, ...n } = e;
+	if (!t) return n;
+	let r = {};
+	return 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 ? {
+		...n,
+		aria: r
+	} : n;
+}
+function o(e, n) {
+	return t("h3", a(n), e);
+}
+function s(e = document) {}
+//#endregion
+export { i as H3_SELECTOR, r as H3_TAG, o as createH3, s as enhanceH3s, n as t };
+
+//# sourceMappingURL=h3.js.map

package/dist/esm/elements/heading/h3/h3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"h3.js","names":[],"sources":["../../../../../src/elements/heading/h3/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: H3 element helpers.\n *\n * @remarks\n * The h3 element (`<h3>`) represents a third-rank section heading.\n *\n * Best-practice guidance:\n * - Use headings to convey document structure, not for visual styling.\n * - Keep heading levels ordered (don't jump from `<h2>` to `<h4>` because you\n *   like the font size). Use CSS for presentation.\n * - Ensure headings describe the section content that follows.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create `<h3>` elements in vanilla JS/TS without templates\n * - apply consistent global attributes safely\n * - use a stable \"enhancement\" hook if pkgn-sol ever needs runtime behavior\n *\n * This module has no side effects and does not mutate the DOM unless you call\n * its functions.\n *\n * References:\n * - MDN: Heading elements: https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/Heading_Elements\n * - W3C WAI: Headings: https://www.w3.org/WAI/tutorials/page-structure/headings/\n * - WHATWG HTML: Sections / heading content: https://html.spec.whatwg.org/multipage/sections.html\n *\n * @module\n * @category Elements\n */\n\nimport { createElement, type ElementOf, type GlobalAttrs } from '../../../ts/dom';\n\n/**\n * Structured ARIA input supported by pkgn-sol element factories.\n *\n * @remarks\n * This is intentionally a small, typed subset that covers common cases and\n * prevents typo-based ARIA bugs (e.g. `lable`).\n *\n * It is mapped into {@link GlobalAttrs.aria} for application by `dom.ts`.\n *\n * @category Attributes\n */\nexport type StructuredAria = {\n  /**\n   * Accessible label, mapped to `aria-label`.\n   */\n  label?: string;\n\n  /**\n   * ID reference to the labelling element(s), mapped to `aria-labelledby`.\n   */\n  labelledby?: string;\n\n  /**\n   * Decorative/hidden hint, mapped to `aria-hidden`.\n   */\n  hidden?: boolean;\n};\n\n/**\n * The semantic tag name for third-level headings.\n *\n * @category Constants\n */\nexport const H3_TAG = 'h3' as const;\n\n/**\n * A CSS selector targeting h3 elements.\n *\n * @category Constants\n */\nexport const H3_SELECTOR = 'h3';\n\n/**\n * Attribute bag for h3 creation/enhancement.\n *\n * @remarks\n * H3 elements accept standard HTML global attributes.\n *\n * pkgn-sol also supports a structured ARIA input for common ARIA fields, which is\n * mapped into {@link GlobalAttrs.aria} without changing pkgn-sol's core DOM helpers.\n *\n * @category Attributes\n */\nexport type H3Attrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link H3Attrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The h3 attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: H3Attrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, ...rest } = attrs;\n\n  if (!aria) return rest;\n\n  const mappedAria: NonNullable<GlobalAttrs['aria']> = {};\n\n  if (typeof aria.label === 'string') mappedAria.label = aria.label;\n  if (typeof aria.labelledby === 'string') mappedAria.labelledby = aria.labelledby;\n  if (typeof aria.hidden === 'boolean') mappedAria.hidden = aria.hidden;\n\n  // Only attach `aria` if something was actually defined.\n  const hasMapped = Object.keys(mappedAria).length > 0;\n\n  return hasMapped ? { ...rest, aria: mappedAria } : rest;\n}\n\n/**\n * Create an h3 element with optional text content and global attributes.\n *\n * @remarks\n * - Text content is assigned via `textContent` (never `innerHTML`).\n * - Global attributes are applied via pkgn-sol's shared DOM helper,\n *   including security guards that block inline event handler attributes\n *   (e.g. `onclick`) and raw `style` attribute strings.\n *\n * @param text - Optional text content for the heading.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<h3>` element.\n *\n * @example\n * ```ts\n * import { createH3 } from \"@lnpg/pkgn-sol/elements/heading/h3\";\n *\n * const h = createH3(\"Section heading\", { id: \"section\" });\n * ```\n *\n * @category DOM\n */\nexport function createH3(text?: string, attrs?: H3Attrs): ElementOf<typeof H3_TAG> {\n  return createElement(H3_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance h3 elements within a given root.\n *\n * @remarks\n * This is intentionally a no-op in `0.1.0`.\n *\n * Why does it exist?\n * - It establishes a stable integration pattern for frameworks (Vue/React/etc.)\n * - It allows future progressive enhancements without changing consumer code\n *\n * What it will never do:\n * - It will not inject styles (CSS remains the source of truth)\n * - It will not introduce framework-specific behavior\n *\n * @param root - The node to search within. Defaults to `document`.\n *\n * @category Enhancement\n */\nexport function enhanceH3s(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for h3.\n  void root;\n}\n"],"mappings":";;;;;;;IAgEa,IAAS,MAOT,IAAc;AA4B3B,SAAS,EAAc,GAA0C;CAC/D,IAAI,CAAC,GAAO;CAEZ,IAAM,EAAE,SAAM,GAAG,MAAS;CAE1B,IAAI,CAAC,GAAM,OAAO;CAElB,IAAM,IAA+C,EAAE;CASvD,OAPI,OAAO,EAAK,SAAU,aAAU,EAAW,QAAQ,EAAK,QACxD,OAAO,EAAK,cAAe,aAAU,EAAW,aAAa,EAAK,aAClE,OAAO,EAAK,UAAW,cAAW,EAAW,SAAS,EAAK,SAG7C,OAAO,KAAK,EAAW,CAAC,SAAS,IAEhC;EAAE,GAAG;EAAM,MAAM;EAAY,GAAG;;AAyBrD,SAAgB,EAAS,GAAe,GAA2C;CACjF,OAAO,EAAA,MAAsB,EAAc,EAAM,EAAE,EAAK;;AAqB1D,SAAgB,EAAW,IAAmB,UAAgB"}

package/dist/esm/elements/heading/h4/h4.js

@@ -0,0 +1,26 @@
+import { i as e, n as t } from "../../../chunks/dom.js";
+//#region src/elements/heading/h4/index.ts
+var n = /* @__PURE__ */ e({
+	H4_SELECTOR: () => "h4",
+	H4_TAG: () => "h4",
+	createH4: () => o,
+	enhanceH4s: () => s
+}), r = "h4", i = "h4";
+function a(e) {
+	if (!e) return;
+	let { aria: t, ...n } = e;
+	if (!t) return n;
+	let r = {};
+	return 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 ? {
+		...n,
+		aria: r
+	} : n;
+}
+function o(e, n) {
+	return t("h4", a(n), e);
+}
+function s(e = document) {}
+//#endregion
+export { i as H4_SELECTOR, r as H4_TAG, o as createH4, s as enhanceH4s, n as t };
+
+//# sourceMappingURL=h4.js.map

package/dist/esm/elements/heading/h4/h4.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"h4.js","names":[],"sources":["../../../../../src/elements/heading/h4/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: H4 element helpers.\n *\n * @remarks\n * The `<h4>` element represents a level 4 section heading.\n *\n * Best-practice guidance:\n * - Use headings to communicate structure, not visual styling.\n * - Avoid skipping heading levels in a way that breaks hierarchy (e.g. `h2` → `h4`).\n * - Keep headings descriptive and concise for accessibility.\n * - Prefer CSS for appearance; headings are about semantics.\n *\n * This module:\n * - Creates `<h4>` elements via pkgn-sol's hardened DOM helpers (no direct DOM calls).\n * - Applies a curated subset of global attributes safely.\n * - Supports a small, typed structured ARIA input mapped into `aria-*`.\n * - Exposes a stable enhancement hook (currently a no-op) for API consistency.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/Heading_Elements\n *\n * @module\n * @category Elements\n */\n\nimport { createElement, type ElementOf, type GlobalAttrs } from '../../../ts/dom';\n\n/**\n * Structured ARIA input supported by pkgn-sol element factories.\n *\n * @remarks\n * This is a small, typed subset intended to prevent typo-driven ARIA bugs and\n * keep the API practical. Values are mapped into {@link GlobalAttrs.aria}.\n *\n * @category Attributes\n */\nexport type StructuredAria = {\n  /**\n   * Accessible label, mapped to `aria-label`.\n   */\n  label?: string;\n\n  /**\n   * ID reference to the labelling element(s), mapped to `aria-labelledby`.\n   */\n  labelledby?: string;\n\n  /**\n   * Decorative/hidden hint, mapped to `aria-hidden`.\n   */\n  hidden?: boolean;\n};\n\n/**\n * The semantic tag name for `<h4>`.\n *\n * @category Constants\n */\nexport const H4_TAG = 'h4' as const;\n\n/**\n * A CSS selector targeting `<h4>` elements.\n *\n * @category Constants\n */\nexport const H4_SELECTOR = 'h4';\n\n/**\n * Attribute bag for `<h4>` creation/enhancement.\n *\n * @remarks\n * `<h4>` supports HTML global attributes only.\n *\n * pkgn-sol additionally supports a typed, structured ARIA input that is mapped into\n * {@link GlobalAttrs.aria} without modifying the shared DOM helpers.\n *\n * @category Attributes\n */\nexport type H4Attrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link H4Attrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The `<h4>` attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: H4Attrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, ...rest } = attrs;\n\n  if (!aria) return rest;\n\n  const mappedAria: NonNullable<GlobalAttrs['aria']> = {};\n\n  if (typeof aria.label === 'string') mappedAria.label = aria.label;\n  if (typeof aria.labelledby === 'string') mappedAria.labelledby = aria.labelledby;\n  if (typeof aria.hidden === 'boolean') mappedAria.hidden = aria.hidden;\n\n  return Object.keys(mappedAria).length > 0 ? { ...rest, aria: mappedAria } : rest;\n}\n\n/**\n * Create an `<h4>` element with optional text content and global attributes.\n *\n * @remarks\n * - Text is assigned via `textContent` (never `innerHTML`).\n * - Global attributes are applied via pkgn-sol's shared DOM helper, which enforces:\n *   - No inline event handler attributes (e.g. `onclick`)\n *   - No raw `style` attribute injection (use the `style` object field)\n *   - No empty attribute names\n *\n * @param text - Optional text content for the heading.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<h4>` element.\n *\n * @example\n * ```ts\n * import { createH4 } from \"@lnpg/pkgn-sol/elements/heading/h4\";\n *\n * const h = createH4(\"Details\", { id: \"details-heading\" });\n * ```\n *\n * @category DOM\n */\nexport function createH4(text?: string, attrs?: H4Attrs): ElementOf<typeof H4_TAG> {\n  return createElement(H4_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance `<h4>` elements within a given root.\n *\n * @remarks\n * Intentionally a no-op in `0.1.0`. This exists to provide a stable, consistent\n * integration hook across element modules.\n *\n * @param root - The node to search within. Defaults to `document`.\n *\n * @category Enhancement\n */\nexport function enhanceH4s(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for h4.\n  void root;\n}\n"],"mappings":";;;;;;;IAyDa,IAAS,MAOT,IAAc;AA4B3B,SAAS,EAAc,GAA0C;CAC/D,IAAI,CAAC,GAAO;CAEZ,IAAM,EAAE,SAAM,GAAG,MAAS;CAE1B,IAAI,CAAC,GAAM,OAAO;CAElB,IAAM,IAA+C,EAAE;CAMvD,OAJI,OAAO,EAAK,SAAU,aAAU,EAAW,QAAQ,EAAK,QACxD,OAAO,EAAK,cAAe,aAAU,EAAW,aAAa,EAAK,aAClE,OAAO,EAAK,UAAW,cAAW,EAAW,SAAS,EAAK,SAExD,OAAO,KAAK,EAAW,CAAC,SAAS,IAAI;EAAE,GAAG;EAAM,MAAM;EAAY,GAAG;;AA0B9E,SAAgB,EAAS,GAAe,GAA2C;CACjF,OAAO,EAAA,MAAsB,EAAc,EAAM,EAAE,EAAK;;AAc1D,SAAgB,EAAW,IAAmB,UAAgB"}

package/dist/esm/elements/heading/h5/h5.js

@@ -0,0 +1,26 @@
+import { i as e, n as t } from "../../../chunks/dom.js";
+//#region src/elements/heading/h5/index.ts
+var n = /* @__PURE__ */ e({
+	H5_SELECTOR: () => "h5",
+	H5_TAG: () => "h5",
+	createH5: () => o,
+	enhanceH5s: () => s
+}), r = "h5", i = "h5";
+function a(e) {
+	if (!e) return;
+	let { aria: t, ...n } = e;
+	if (!t) return n;
+	let r = {};
+	return 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 ? {
+		...n,
+		aria: r
+	} : n;
+}
+function o(e, n) {
+	return t("h5", a(n), e);
+}
+function s(e = document) {}
+//#endregion
+export { i as H5_SELECTOR, r as H5_TAG, o as createH5, s as enhanceH5s, n as t };
+
+//# sourceMappingURL=h5.js.map

package/dist/esm/elements/heading/h5/h5.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"h5.js","names":[],"sources":["../../../../../src/elements/heading/h5/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: H5 element helpers.\n *\n * @remarks\n * The h5 element (`<h5>`) represents a fifth-rank section heading.\n *\n * Best-practice guidance:\n * - Use headings to communicate document structure, not visual styling.\n * - Keep heading levels ordered (don't jump from `<h2>` to `<h5>` because you\n *   like the font size). Use CSS for presentation.\n * - Ensure headings accurately describe the section content that follows.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create `<h5>` elements in vanilla JS/TS without templates\n * - apply consistent global attributes safely\n * - use a stable \"enhancement\" hook if pkgn-sol ever needs runtime behavior\n *\n * This module has no side effects and does not mutate the DOM unless you call\n * its functions.\n *\n * References:\n * - MDN: Heading elements: https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/Heading_Elements\n * - W3C WAI: Headings: https://www.w3.org/WAI/tutorials/page-structure/headings/\n * - WHATWG HTML: Sections / heading content: https://html.spec.whatwg.org/multipage/sections.html\n *\n * @module\n * @category Elements\n */\n\nimport { createElement, type ElementOf, type GlobalAttrs } from '../../../ts/dom';\n\n/**\n * Structured ARIA input supported by pkgn-sol element factories.\n *\n * @remarks\n * This is intentionally a small, typed subset that covers common cases and\n * prevents typo-based ARIA bugs (e.g. `lable`).\n *\n * It is mapped into {@link GlobalAttrs.aria} for application by `dom.ts`.\n *\n * @category Attributes\n */\nexport type StructuredAria = {\n  /**\n   * Accessible label, mapped to `aria-label`.\n   */\n  label?: string;\n\n  /**\n   * ID reference to the labelling element(s), mapped to `aria-labelledby`.\n   */\n  labelledby?: string;\n\n  /**\n   * Decorative/hidden hint, mapped to `aria-hidden`.\n   */\n  hidden?: boolean;\n};\n\n/**\n * The semantic tag name for fifth-level headings.\n *\n * @category Constants\n */\nexport const H5_TAG = 'h5' as const;\n\n/**\n * A CSS selector targeting h5 elements.\n *\n * @category Constants\n */\nexport const H5_SELECTOR = 'h5';\n\n/**\n * Attribute bag for h5 creation/enhancement.\n *\n * @remarks\n * H5 elements accept standard HTML global attributes.\n *\n * pkgn-sol also supports a structured ARIA input for common ARIA fields, which is\n * mapped into {@link GlobalAttrs.aria} without changing pkgn-sol's core DOM helpers.\n *\n * @category Attributes\n */\nexport type H5Attrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link H5Attrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The h5 attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: H5Attrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, ...rest } = attrs;\n\n  if (!aria) return rest;\n\n  const mappedAria: NonNullable<GlobalAttrs['aria']> = {};\n\n  if (typeof aria.label === 'string') mappedAria.label = aria.label;\n  if (typeof aria.labelledby === 'string') mappedAria.labelledby = aria.labelledby;\n  if (typeof aria.hidden === 'boolean') mappedAria.hidden = aria.hidden;\n\n  // Only attach `aria` if something was actually defined.\n  const hasMapped = Object.keys(mappedAria).length > 0;\n\n  return hasMapped ? { ...rest, aria: mappedAria } : rest;\n}\n\n/**\n * Create an h5 element with optional text content and global attributes.\n *\n * @remarks\n * - Text content is assigned via `textContent` (never `innerHTML`).\n * - Global attributes are applied via pkgn-sol's shared DOM helper,\n *   including security guards that block inline event handler attributes\n *   (e.g. `onclick`) and raw `style` attribute strings.\n *\n * @param text - Optional text content for the heading.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<h5>` element.\n *\n * @example\n * ```ts\n * import { createH5 } from \"@lnpg/pkgn-sol/elements/heading/h5\";\n *\n * const h = createH5(\"Subsection heading\");\n * ```\n *\n * @category DOM\n */\nexport function createH5(text?: string, attrs?: H5Attrs): ElementOf<typeof H5_TAG> {\n  return createElement(H5_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance h5 elements within a given root.\n *\n * @remarks\n * This is intentionally a no-op in `0.1.0`.\n *\n * Why does it exist?\n * - It establishes a stable integration pattern for frameworks (Vue/React/etc.)\n * - It allows future progressive enhancements without changing consumer code\n *\n * What it will never do:\n * - It will not inject styles (CSS remains the source of truth)\n * - It will not introduce framework-specific behavior\n *\n * @param root - The node to search within. Defaults to `document`.\n *\n * @category Enhancement\n */\nexport function enhanceH5s(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for h5.\n  void root;\n}\n"],"mappings":";;;;;;;IAgEa,IAAS,MAOT,IAAc;AA4B3B,SAAS,EAAc,GAA0C;CAC/D,IAAI,CAAC,GAAO;CAEZ,IAAM,EAAE,SAAM,GAAG,MAAS;CAE1B,IAAI,CAAC,GAAM,OAAO;CAElB,IAAM,IAA+C,EAAE;CASvD,OAPI,OAAO,EAAK,SAAU,aAAU,EAAW,QAAQ,EAAK,QACxD,OAAO,EAAK,cAAe,aAAU,EAAW,aAAa,EAAK,aAClE,OAAO,EAAK,UAAW,cAAW,EAAW,SAAS,EAAK,SAG7C,OAAO,KAAK,EAAW,CAAC,SAAS,IAEhC;EAAE,GAAG;EAAM,MAAM;EAAY,GAAG;;AAyBrD,SAAgB,EAAS,GAAe,GAA2C;CACjF,OAAO,EAAA,MAAsB,EAAc,EAAM,EAAE,EAAK;;AAqB1D,SAAgB,EAAW,IAAmB,UAAgB"}

package/dist/esm/elements/heading/h6/h6.js

@@ -0,0 +1,26 @@
+import { i as e, n as t } from "../../../chunks/dom.js";
+//#region src/elements/heading/h6/index.ts
+var n = /* @__PURE__ */ e({
+	H6_SELECTOR: () => "h6",
+	H6_TAG: () => "h6",
+	createH6: () => o,
+	enhanceH6s: () => s
+}), r = "h6", i = "h6";
+function a(e) {
+	if (!e) return;
+	let { aria: t, ...n } = e;
+	if (!t) return n;
+	let r = {};
+	return 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 ? {
+		...n,
+		aria: r
+	} : n;
+}
+function o(e, n) {
+	return t("h6", a(n), e);
+}
+function s(e = document) {}
+//#endregion
+export { i as H6_SELECTOR, r as H6_TAG, o as createH6, s as enhanceH6s, n as t };
+
+//# sourceMappingURL=h6.js.map

package/dist/esm/elements/heading/h6/h6.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"h6.js","names":[],"sources":["../../../../../src/elements/heading/h6/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: H6 element helpers.\n *\n * @remarks\n * The h6 element (`<h6>`) represents the lowest-ranked section heading.\n *\n * Best-practice guidance:\n * - Use headings to convey document structure, not visual styling.\n * - Do not choose heading levels based on appearance; use CSS for styling.\n * - Avoid skipping heading levels (e.g. jumping from `<h2>` to `<h6>`), unless the\n *   document structure genuinely calls for it.\n * - Keep headings short and descriptive to support accessibility navigation.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create heading elements in vanilla JS/TS without templates\n * - apply consistent global attributes safely\n * - use a stable \"enhancement\" hook if pkgn-sol ever needs runtime behavior\n *\n * This module has no side effects and does not mutate the DOM unless you call\n * its functions.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/Heading_Elements\n * @see https://html.spec.whatwg.org/multipage/sections.html\n *\n * @module\n * @category Elements\n */\n\nimport { createElement, type ElementOf, type GlobalAttrs } from '../../../ts/dom';\n\n/**\n * Structured ARIA input supported by pkgn-sol element factories.\n *\n * @remarks\n * This is intentionally a small, typed subset that covers common cases and\n * prevents typo-based ARIA bugs.\n *\n * It is mapped into {@link GlobalAttrs.aria} for application by `dom.ts`.\n *\n * @category Attributes\n */\nexport type StructuredAria = {\n  /**\n   * Accessible label, mapped to `aria-label`.\n   */\n  label?: string;\n\n  /**\n   * ID reference to labelling element(s), mapped to `aria-labelledby`.\n   */\n  labelledby?: string;\n\n  /**\n   * Decorative/hidden hint, mapped to `aria-hidden`.\n   */\n  hidden?: boolean;\n};\n\n/**\n * The semantic tag name for h6 headings.\n *\n * @category Constants\n */\nexport const H6_TAG = 'h6' as const;\n\n/**\n * A CSS selector targeting h6 elements.\n *\n * @category Constants\n */\nexport const H6_SELECTOR = 'h6';\n\n/**\n * Attribute bag for h6 creation/enhancement.\n *\n * @remarks\n * `<h6>` accepts standard HTML global attributes.\n *\n * pkgn-sol also supports a structured ARIA input for common ARIA fields, which is\n * mapped into {@link GlobalAttrs.aria} without changing pkgn-sol's core DOM helpers.\n *\n * @category Attributes\n */\nexport type H6Attrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link H6Attrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The h6 attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: H6Attrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, ...rest } = attrs;\n\n  if (!aria) return rest;\n\n  const mappedAria: NonNullable<GlobalAttrs['aria']> = {};\n\n  if (typeof aria.label === 'string') mappedAria.label = aria.label;\n  if (typeof aria.labelledby === 'string') mappedAria.labelledby = aria.labelledby;\n  if (typeof aria.hidden === 'boolean') mappedAria.hidden = aria.hidden;\n\n  const hasMapped = Object.keys(mappedAria).length > 0;\n\n  return hasMapped ? { ...rest, aria: mappedAria } : rest;\n}\n\n/**\n * Create an h6 element with optional text content and global attributes.\n *\n * @remarks\n * - Text content is assigned via `textContent` (never `innerHTML`).\n * - Global attributes are applied via pkgn-sol's shared DOM helper,\n *   including security guards that block inline event handler attributes\n *   (e.g. `onclick`) and raw `style` attribute strings.\n *\n * @param text - Optional text content for the heading.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<h6>` element.\n *\n * @example\n * ```ts\n * import { createH6 } from \"@lnpg/pkgn-sol/elements/heading/h6\";\n *\n * const heading = createH6(\"Minor heading\", { id: \"minor\" });\n * ```\n *\n * @category DOM\n */\nexport function createH6(text?: string, attrs?: H6Attrs): ElementOf<typeof H6_TAG> {\n  return createElement(H6_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance h6 elements within a given root.\n *\n * @remarks\n * This is intentionally a no-op in `0.1.0`.\n *\n * It exists to establish a stable enhancement pattern across all elements.\n *\n * @param root - The node to search within. Defaults to `document`.\n *\n * @category Enhancement\n */\nexport function enhanceH6s(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for h6.\n  void root;\n}\n"],"mappings":";;;;;;;IA+Da,IAAS,MAOT,IAAc;AA4B3B,SAAS,EAAc,GAA0C;CAC/D,IAAI,CAAC,GAAO;CAEZ,IAAM,EAAE,SAAM,GAAG,MAAS;CAE1B,IAAI,CAAC,GAAM,OAAO;CAElB,IAAM,IAA+C,EAAE;CAQvD,OANI,OAAO,EAAK,SAAU,aAAU,EAAW,QAAQ,EAAK,QACxD,OAAO,EAAK,cAAe,aAAU,EAAW,aAAa,EAAK,aAClE,OAAO,EAAK,UAAW,cAAW,EAAW,SAAS,EAAK,SAE7C,OAAO,KAAK,EAAW,CAAC,SAAS,IAEhC;EAAE,GAAG;EAAM,MAAM;EAAY,GAAG;;AAyBrD,SAAgB,EAAS,GAAe,GAA2C;CACjF,OAAO,EAAA,MAAsB,EAAc,EAAM,EAAE,EAAK;;AAe1D,SAAgB,EAAW,IAAmB,UAAgB"}

package/dist/esm/elements/heading/heading.js

@@ -0,0 +1,20 @@
+import { i as e } from "../../chunks/dom.js";
+import { t } from "./h1/h1.js";
+import { t as n } from "./h2/h2.js";
+import { t as r } from "./h3/h3.js";
+import { t as i } from "./h4/h4.js";
+import { t as a } from "./h5/h5.js";
+import { t as o } from "./h6/h6.js";
+//#region src/elements/heading/index.ts
+var s = /* @__PURE__ */ e({
+	h1: () => t,
+	h2: () => n,
+	h3: () => r,
+	h4: () => i,
+	h5: () => a,
+	h6: () => o
+});
+//#endregion
+export { t as h1, n as h2, r as h3, i as h4, a as h5, o as h6, s as t };
+
+//# sourceMappingURL=heading.js.map

package/dist/esm/elements/heading/heading.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heading.js","names":[],"sources":["../../../../src/elements/heading/index.ts"],"sourcesContent":["/**\n * Heading element factories.\n *\n * Provides framework-agnostic factory functions for semantic HTML heading\n * elements (`<h1>` through `<h6>`).\n *\n * These factories:\n * - Create semantic heading elements using pkgn-sol's hardened DOM helpers.\n * - Forward curated global attributes.\n * - Enforce structured, typed attribute bags.\n * - Preserve correct document outline semantics.\n * - Prevent unsafe attribute injection.\n *\n * Headings define the hierarchical structure of a document and should be used\n * in order where possible to maintain accessibility and navigability.\n *\n * @module elements/heading\n * @since 0.1.0\n */\n\n/**\n * `<h1>` element factory namespace.\n *\n * Represents the top-level heading of a page or section.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/Heading_Elements\n */\nexport * as h1 from './h1';\n\n/**\n * `<h2>` element factory namespace.\n *\n * Represents a second-level section heading.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/Heading_Elements\n */\nexport * as h2 from './h2';\n\n/**\n * `<h3>` element factory namespace.\n *\n * Represents a third-level section heading.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/Heading_Elements\n */\nexport * as h3 from './h3';\n\n/**\n * `<h4>` element factory namespace.\n *\n * Represents a fourth-level section heading.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/Heading_Elements\n */\nexport * as h4 from './h4';\n\n/**\n * `<h5>` element factory namespace.\n *\n * Represents a fifth-level section heading.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/Heading_Elements\n */\nexport * as h5 from './h5';\n\n/**\n * `<h6>` element factory namespace.\n *\n * Represents a sixth-level section heading.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/Heading_Elements\n */\nexport * as h6 from './h6';\n"],"mappings":""}

package/dist/esm/elements/inline/a/a.js

@@ -0,0 +1,28 @@
+import { i as e, n as t } from "../../../chunks/dom.js";
+//#region src/elements/inline/a/index.ts
+var n = /* @__PURE__ */ e({
+	A_SELECTOR: () => "a",
+	A_TAG: () => "a",
+	createA: () => o,
+	enhanceAs: () => s
+}), r = "a", i = "a";
+function a(e) {
+	if (!e) return;
+	let { aria: t, href: n, target: r, rel: i, download: a, hreflang: o, ping: s, referrerPolicy: c, type: l, ...u } = e, d = u, f = { ...d.attrs ?? {} };
+	typeof n == "string" && (f.href = n), typeof r == "string" && (f.target = r), typeof o == "string" && (f.hreflang = o), typeof c == "string" && (f.referrerpolicy = c), typeof l == "string" && (f.type = l), typeof s == "string" && (f.ping = s), Array.isArray(s) && (f.ping = s.join(" ")), typeof a == "string" && (f.download = a), a === !0 && (f.download = "");
+	let p = typeof f.rel == "string" && f.rel.trim().length > 0 ? f.rel : void 0;
+	if (typeof i == "string" ? f.rel = i : r === "_blank" && !p && (f.rel = "noopener noreferrer"), Object.keys(f).length > 0 && (d.attrs = f), !t) return d;
+	let m = {};
+	return typeof t.label == "string" && (m.label = t.label), typeof t.labelledby == "string" && (m.labelledby = t.labelledby), typeof t.hidden == "boolean" && (m.hidden = t.hidden), Object.keys(m).length > 0 ? {
+		...d,
+		aria: m
+	} : d;
+}
+function o(e, n) {
+	return t("a", a(n), e);
+}
+function s(e = document) {}
+//#endregion
+export { i as A_SELECTOR, r as A_TAG, o as createA, s as enhanceAs, n as t };
+
+//# sourceMappingURL=a.js.map

package/dist/esm/elements/inline/a/a.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"a.js","names":[],"sources":["../../../../../src/elements/inline/a/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: Anchor (`a`) element helpers.\n *\n * @remarks\n * The anchor element (`<a>`) creates a hyperlink when the `href` attribute is\n * present. It can link to web pages, files, email addresses, locations within\n * the same page, or any URL-addressable resource.\n *\n * Best-practice guidance:\n * - Prefer clear, descriptive link text. Avoid \"click here\".\n * - If using `target=\"_blank\"`, strongly consider `rel=\"noopener noreferrer\"`\n *   to prevent opener-based attacks (reverse tabnabbing).\n * - Do not use `<a>` as a button. Use `<button>` for actions and controls.\n * - Validate/sanitize untrusted URLs before assigning them to `href`.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create anchors in vanilla JS/TS without templates\n * - apply consistent global attributes safely\n * - use a stable \"enhancement\" hook if pkgn-sol ever needs runtime behavior\n *\n * This module has no side effects and does not mutate the DOM unless you call\n * its functions.\n *\n * References:\n * - MDN: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a\n * - WHATWG: https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-a-element\n * - MDN rel=noopener: https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/rel/noopener\n * - MDN rel=noreferrer: https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/rel/noreferrer\n *\n * @module\n * @category Elements\n */\n\nimport { createElement, type ElementOf, type GlobalAttrs } from '../../../ts/dom';\n\n/**\n * Structured ARIA input supported by pkgn-sol element factories.\n *\n * @remarks\n * This is intentionally a small, typed subset that covers common cases and\n * prevents typo-based ARIA bugs (e.g. `lable`).\n *\n * It is mapped into {@link GlobalAttrs.aria} for application by `dom.ts`.\n *\n * @category Attributes\n */\nexport type StructuredAria = {\n  /**\n   * Accessible label, mapped to `aria-label`.\n   *\n   * @remarks\n   * Prefer `labelledby` when a visible labeling element exists.\n   */\n  label?: string;\n\n  /**\n   * ID reference to the labelling element(s), mapped to `aria-labelledby`.\n   */\n  labelledby?: string;\n\n  /**\n   * Decorative/hidden hint, mapped to `aria-hidden`.\n   */\n  hidden?: boolean;\n};\n\n/**\n * Common targets for anchor navigation.\n *\n * @remarks\n * Browsers also accept custom named targets (e.g. `myWindow`).\n *\n * @category Attributes\n */\nexport type AnchorTarget = '_self' | '_blank' | '_parent' | '_top' | (string & {});\n\n/**\n * Allowed values for the `referrerpolicy` attribute.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/referrerpolicy\n *\n * @category Attributes\n */\nexport type ReferrerPolicy =\n  | 'no-referrer'\n  | 'no-referrer-when-downgrade'\n  | 'origin'\n  | 'origin-when-cross-origin'\n  | 'same-origin'\n  | 'strict-origin'\n  | 'strict-origin-when-cross-origin'\n  | 'unsafe-url';\n\n/**\n * The semantic tag name for anchors.\n *\n * @category Constants\n */\nexport const A_TAG = 'a' as const;\n\n/**\n * A CSS selector targeting anchor elements.\n *\n * @category Constants\n */\nexport const A_SELECTOR = 'a';\n\n/**\n * Attribute bag for anchor creation/enhancement.\n *\n * @remarks\n * Anchor elements accept standard HTML global attributes, plus link-related\n * attributes such as `href`, `target`, and `rel`.\n *\n * Security notes:\n * - pkgn-sol blocks unsafe attribute *names* (e.g. `onclick`, raw `style`).\n * - pkgn-sol does not sanitize attribute *values*. Callers must validate untrusted\n *   URLs before passing them as `href`.\n * - When `target=\"_blank\"` is used and `rel` is not provided, pkgn-sol applies a\n *   conservative default: `rel=\"noopener noreferrer\"`.\n *\n * @category Attributes\n */\nexport type AnchorAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Destination URL for the hyperlink.\n   *\n   * @remarks\n   * If omitted, the anchor is not a hyperlink.\n   */\n  href?: string;\n\n  /**\n   * Where to display the linked URL.\n   */\n  target?: AnchorTarget;\n\n  /**\n   * Relationship between the current document and the linked resource.\n   *\n   * @remarks\n   * If `target=\"_blank\"` is used and `rel` is not provided, pkgn-sol applies\n   * `noopener noreferrer` by default.\n   */\n  rel?: string;\n\n  /**\n   * Indicates the linked resource should be downloaded.\n   *\n   * @remarks\n   * - `true` sets a bare `download` attribute.\n   * - A string sets the suggested filename.\n   */\n  download?: boolean | string;\n\n  /**\n   * Language of the linked resource.\n   */\n  hreflang?: string;\n\n  /**\n   * Space-separated list of URLs to notify (POST \"ping\") when the link is followed.\n   *\n   * @remarks\n   * Limited browser support; use with care.\n   */\n  ping?: string | string[];\n\n  /**\n   * Referrer policy for the request initiated by following the hyperlink.\n   */\n  referrerPolicy?: ReferrerPolicy;\n\n  /**\n   * MIME type hint for the linked resource.\n   */\n  type?: string;\n\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link AnchorAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - Anchor attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: AnchorAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, href, target, rel, download, hreflang, ping, referrerPolicy, type, ...rest } =\n    attrs;\n\n  const out: GlobalAttrs = rest;\n\n  // Start with any escape-hatch attrs the caller provided.\n  const rawAttrs: NonNullable<GlobalAttrs['attrs']> = { ...(out.attrs ?? {}) };\n\n  if (typeof href === 'string') rawAttrs.href = href;\n  if (typeof target === 'string') rawAttrs.target = target;\n  if (typeof hreflang === 'string') rawAttrs.hreflang = hreflang;\n  if (typeof referrerPolicy === 'string') rawAttrs.referrerpolicy = referrerPolicy;\n  if (typeof type === 'string') rawAttrs.type = type;\n\n  if (typeof ping === 'string') rawAttrs.ping = ping;\n  if (Array.isArray(ping)) rawAttrs.ping = ping.join(' ');\n\n  if (typeof download === 'string') rawAttrs.download = download;\n  if (download === true) rawAttrs.download = '';\n\n  // Apply rel (explicit wins). Otherwise provide a conservative default for target=_blank.\n  const existingRel =\n    typeof rawAttrs.rel === 'string' && rawAttrs.rel.trim().length > 0 ? rawAttrs.rel : undefined;\n\n  if (typeof rel === 'string') {\n    rawAttrs.rel = rel;\n  } else if (target === '_blank' && !existingRel) {\n    rawAttrs.rel = 'noopener noreferrer';\n  }\n\n  // Only attach `attrs` if something was actually defined.\n  if (Object.keys(rawAttrs).length > 0) out.attrs = rawAttrs;\n\n  if (!aria) return out;\n\n  const mappedAria: NonNullable<GlobalAttrs['aria']> = {};\n\n  if (typeof aria.label === 'string') mappedAria.label = aria.label;\n  if (typeof aria.labelledby === 'string') mappedAria.labelledby = aria.labelledby;\n  if (typeof aria.hidden === 'boolean') mappedAria.hidden = aria.hidden;\n\n  const hasMapped = Object.keys(mappedAria).length > 0;\n\n  return hasMapped ? { ...out, aria: mappedAria } : out;\n}\n\n/**\n * Create an anchor element with optional text content and attributes.\n *\n * @remarks\n * - Text content is assigned via `textContent` (never `innerHTML`).\n * - Global attributes are applied via pkgn-sol's shared DOM helper,\n *   including security guards that block inline event handler attributes\n *   (e.g. `onclick`) and raw `style` attribute strings.\n *\n * @param text - Optional text content for the anchor.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<a>` element.\n *\n * @example\n * ```ts\n * import { createA } from \"@lnpg/pkgn-sol/elements/inline/a\";\n *\n * document.body.appendChild(\n *   createA(\"Read more\", { href: \"/docs\", className: \"link\" })\n * );\n * ```\n *\n * @category DOM\n */\nexport function createA(text?: string, attrs?: AnchorAttrs): ElementOf<typeof A_TAG> {\n  return createElement(A_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance anchor elements within a given root.\n *\n * @remarks\n * This is intentionally a no-op in `0.1.0`.\n *\n * Why does it exist?\n * - It establishes a stable integration pattern for frameworks (Vue/React/etc.)\n * - It allows future progressive enhancements without changing consumer code\n *\n * What it will never do:\n * - It will not inject styles (CSS remains the source of truth)\n * - It will not introduce framework-specific behavior\n *\n * @param root - The node to search within. Defaults to `document`.\n *\n * @category Enhancement\n */\nexport function enhanceAs(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for anchors.\n  void root;\n}\n"],"mappings":";;;;;;;IAkGa,IAAQ,KAOR,IAAa;AAuF1B,SAAS,EAAc,GAA8C;CACnE,IAAI,CAAC,GAAO;CAEZ,IAAM,EAAE,SAAM,SAAM,WAAQ,QAAK,aAAU,aAAU,SAAM,mBAAgB,SAAM,GAAG,MAClF,GAEI,IAAmB,GAGnB,IAA8C,EAAE,GAAI,EAAI,SAAS,EAAE,EAAG;CAY5E,AAVI,OAAO,KAAS,aAAU,EAAS,OAAO,IAC1C,OAAO,KAAW,aAAU,EAAS,SAAS,IAC9C,OAAO,KAAa,aAAU,EAAS,WAAW,IAClD,OAAO,KAAmB,aAAU,EAAS,iBAAiB,IAC9D,OAAO,KAAS,aAAU,EAAS,OAAO,IAE1C,OAAO,KAAS,aAAU,EAAS,OAAO,IAC1C,MAAM,QAAQ,EAAK,KAAE,EAAS,OAAO,EAAK,KAAK,IAAI,GAEnD,OAAO,KAAa,aAAU,EAAS,WAAW,IAClD,MAAa,OAAM,EAAS,WAAW;CAG3C,IAAM,IACJ,OAAO,EAAS,OAAQ,YAAY,EAAS,IAAI,MAAM,CAAC,SAAS,IAAI,EAAS,MAAM,KAAA;CAWtF,IATI,OAAO,KAAQ,WACjB,EAAS,MAAM,IACN,MAAW,YAAY,CAAC,MACjC,EAAS,MAAM,wBAIb,OAAO,KAAK,EAAS,CAAC,SAAS,MAAG,EAAI,QAAQ,IAE9C,CAAC,GAAM,OAAO;CAElB,IAAM,IAA+C,EAAE;CAQvD,OANI,OAAO,EAAK,SAAU,aAAU,EAAW,QAAQ,EAAK,QACxD,OAAO,EAAK,cAAe,aAAU,EAAW,aAAa,EAAK,aAClE,OAAO,EAAK,UAAW,cAAW,EAAW,SAAS,EAAK,SAE7C,OAAO,KAAK,EAAW,CAAC,SAAS,IAEhC;EAAE,GAAG;EAAK,MAAM;EAAY,GAAG;;AA2BpD,SAAgB,EAAQ,GAAe,GAA8C;CACnF,OAAO,EAAA,KAAqB,EAAc,EAAM,EAAE,EAAK;;AAqBzD,SAAgB,EAAU,IAAmB,UAAgB"}

package/dist/esm/elements/inline/abbr/abbr.js

@@ -0,0 +1,26 @@
+import { i as e, n as t } from "../../../chunks/dom.js";
+//#region src/elements/inline/abbr/index.ts
+var n = /* @__PURE__ */ e({
+	ABBR_SELECTOR: () => i,
+	ABBR_TAG: () => r,
+	createAbbr: () => o,
+	enhanceAbbrs: () => s
+}), r = "abbr", i = "abbr";
+function a(e) {
+	if (!e) return;
+	let { aria: t, ...n } = e;
+	if (!t) return n;
+	let r = {};
+	return 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 ? {
+		...n,
+		aria: r
+	} : n;
+}
+function o(e, n) {
+	return t(r, a(n), e);
+}
+function s(e = document) {}
+//#endregion
+export { i as ABBR_SELECTOR, r as ABBR_TAG, o as createAbbr, s as enhanceAbbrs, n as t };
+
+//# sourceMappingURL=abbr.js.map

package/dist/esm/elements/inline/abbr/abbr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abbr.js","names":[],"sources":["../../../../../src/elements/inline/abbr/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: Abbreviation (`abbr`) element helpers.\n *\n * @remarks\n * The abbreviation element (`<abbr>`) represents an abbreviation or acronym.\n *\n * Best-practice guidance:\n * - Provide the expanded form in plain text on first use where possible.\n * - Optionally provide an expansion via the `title` attribute.\n *   Spec guidance: if `title` is used on `<abbr>`, it should contain the expansion\n *   of the abbreviation and nothing else.\n * - Do not rely solely on `title` tooltips for accessibility; tooltip exposure\n *   varies across browsers and assistive technologies.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create abbr elements in vanilla JS/TS without templates\n * - apply consistent global attributes safely\n * - use a stable \"enhancement\" hook if pkgn-sol ever needs runtime behavior\n *\n * This module has no side effects and does not mutate the DOM unless you call\n * its functions.\n *\n * References:\n * - MDN: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/abbr\n * - WHATWG: https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-abbr-element\n *\n * @module\n * @category Elements\n */\n\nimport { createElement, type ElementOf, type GlobalAttrs } from '../../../ts/dom';\n\n/**\n * Structured ARIA input supported by pkgn-sol element factories.\n *\n * @remarks\n * This is intentionally a small, typed subset that covers common cases and\n * prevents typo-based ARIA bugs (e.g. `lable`).\n *\n * It is mapped into {@link GlobalAttrs.aria} for application by `dom.ts`.\n *\n * @category Attributes\n */\nexport type StructuredAria = {\n  /**\n   * Accessible label, mapped to `aria-label`.\n   */\n  label?: string;\n\n  /**\n   * ID reference to the labelling element(s), mapped to `aria-labelledby`.\n   */\n  labelledby?: string;\n\n  /**\n   * Decorative/hidden hint, mapped to `aria-hidden`.\n   */\n  hidden?: boolean;\n};\n\n/**\n * The semantic tag name for abbreviations.\n *\n * @category Constants\n */\nexport const ABBR_TAG = 'abbr' as const;\n\n/**\n * A CSS selector targeting abbr elements.\n *\n * @category Constants\n */\nexport const ABBR_SELECTOR = 'abbr';\n\n/**\n * Attribute bag for abbr creation/enhancement.\n *\n * @remarks\n * Abbr elements accept standard HTML global attributes.\n *\n * For expansions, prefer:\n * - expanding the term in plain text on first use, and/or\n * - using {@link GlobalAttrs.title} to provide an expansion (advisory text).\n *\n * pkgn-sol also supports a structured ARIA input for common ARIA fields, which is\n * mapped into {@link GlobalAttrs.aria} without changing pkgn-sol's core DOM helpers.\n *\n * @category Attributes\n */\nexport type AbbrAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link AbbrAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The abbr attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: AbbrAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, ...rest } = attrs;\n\n  if (!aria) return rest;\n\n  const mappedAria: NonNullable<GlobalAttrs['aria']> = {};\n\n  if (typeof aria.label === 'string') mappedAria.label = aria.label;\n  if (typeof aria.labelledby === 'string') mappedAria.labelledby = aria.labelledby;\n  if (typeof aria.hidden === 'boolean') mappedAria.hidden = aria.hidden;\n\n  // Only attach `aria` if something was actually defined.\n  const hasMapped = Object.keys(mappedAria).length > 0;\n\n  return hasMapped ? { ...rest, aria: mappedAria } : rest;\n}\n\n/**\n * Create an abbr element with optional text content and attributes.\n *\n * @remarks\n * - Text content is assigned via `textContent` (never `innerHTML`).\n * - Global attributes are applied via pkgn-sol's shared DOM helper,\n *   including security guards that block inline event handler attributes\n *   (e.g. `onclick`) and raw `style` attribute strings.\n *\n * @param text - Optional text content for the abbreviation (e.g. \"NASA\").\n * @param attrs - Optional attributes to apply (e.g. `title` for expansion).\n * @returns The created `<abbr>` element.\n *\n * @example\n * ```ts\n * import { createAbbr } from \"@lnpg/pkgn-sol/elements/inline/abbr\";\n *\n * const el = createAbbr(\"NASA\", { title: \"National Aeronautics and Space Administration\" });\n * document.body.appendChild(el);\n * ```\n *\n * @category DOM\n */\nexport function createAbbr(text?: string, attrs?: AbbrAttrs): ElementOf<typeof ABBR_TAG> {\n  return createElement(ABBR_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance abbr elements within a given root.\n *\n * @remarks\n * This is intentionally a no-op in `0.1.0`.\n *\n * Why does it exist?\n * - It establishes a stable integration pattern for frameworks (Vue/React/etc.)\n * - It allows future progressive enhancements without changing consumer code\n *\n * What it will never do:\n * - It will not inject styles (CSS remains the source of truth)\n * - It will not introduce framework-specific behavior\n *\n * @param root - The node to search within. Defaults to `document`.\n *\n * @category Enhancement\n */\nexport function enhanceAbbrs(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for abbr.\n  void root;\n}\n"],"mappings":";;;;;;;IAiEa,IAAW,QAOX,IAAgB;AAgC7B,SAAS,EAAc,GAA4C;CACjE,IAAI,CAAC,GAAO;CAEZ,IAAM,EAAE,SAAM,GAAG,MAAS;CAE1B,IAAI,CAAC,GAAM,OAAO;CAElB,IAAM,IAA+C,EAAE;CASvD,OAPI,OAAO,EAAK,SAAU,aAAU,EAAW,QAAQ,EAAK,QACxD,OAAO,EAAK,cAAe,aAAU,EAAW,aAAa,EAAK,aAClE,OAAO,EAAK,UAAW,cAAW,EAAW,SAAS,EAAK,SAG7C,OAAO,KAAK,EAAW,CAAC,SAAS,IAEhC;EAAE,GAAG;EAAM,MAAM;EAAY,GAAG;;AA0BrD,SAAgB,EAAW,GAAe,GAA+C;CACvF,OAAO,EAAc,GAAU,EAAc,EAAM,EAAE,EAAK;;AAqB5D,SAAgB,EAAa,IAAmB,UAAgB"}

package/dist/esm/elements/inline/b/b.js

@@ -0,0 +1,26 @@
+import { i as e, n as t } from "../../../chunks/dom.js";
+//#region src/elements/inline/b/index.ts
+var n = /* @__PURE__ */ e({
+	B_SELECTOR: () => "b",
+	B_TAG: () => "b",
+	createB: () => o,
+	enhanceBs: () => s
+}), r = "b", i = "b";
+function a(e) {
+	if (!e) return;
+	let { aria: t, ...n } = e;
+	if (!t) return n;
+	let r = {};
+	return 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 ? {
+		...n,
+		aria: r
+	} : n;
+}
+function o(e, n) {
+	return t("b", a(n), e);
+}
+function s(e = document) {}
+//#endregion
+export { i as B_SELECTOR, r as B_TAG, o as createB, s as enhanceBs, n as t };
+
+//# sourceMappingURL=b.js.map

package/dist/esm/elements/inline/b/b.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"b.js","names":[],"sources":["../../../../../src/elements/inline/b/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: B element helpers.\n *\n * @remarks\n * The b element (`<b>`) represents a span of text to which attention is being\n * drawn for utilitarian purposes, without conveying extra importance.\n *\n * Best-practice guidance:\n * - Use `<b>` to draw attention without implying importance.\n * - Use `<strong>` for strong importance and `<em>` for stress emphasis.\n * - Do not use `<b>` purely for styling. Prefer CSS (e.g. `font-weight`) when the\n *   goal is visual bolding rather than semantics.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create inline attention spans in vanilla JS/TS without templates\n * - apply consistent global attributes safely\n * - use a stable \"enhancement\" hook if pkgn-sol ever needs runtime behavior\n *\n * MDN: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/b\n *\n * @module\n * @category Elements\n */\n\nimport { createElement, type ElementOf, type GlobalAttrs } from '../../../ts/dom';\n\n/**\n * Structured ARIA input supported by pkgn-sol element factories.\n *\n * @remarks\n * This is intentionally a small, typed subset that covers common cases and\n * prevents typo-based ARIA bugs (e.g. `lable`).\n *\n * It is mapped into {@link GlobalAttrs.aria} for application by `dom.ts`.\n *\n * @category Attributes\n */\nexport type StructuredAria = {\n  /**\n   * Accessible label, mapped to `aria-label`.\n   */\n  label?: string;\n\n  /**\n   * ID reference to the labelling element(s), mapped to `aria-labelledby`.\n   */\n  labelledby?: string;\n\n  /**\n   * Decorative/hidden hint, mapped to `aria-hidden`.\n   */\n  hidden?: boolean;\n};\n\n/**\n * The semantic tag name for \"bring attention to\" spans.\n *\n * @category Constants\n */\nexport const B_TAG = 'b' as const;\n\n/**\n * A CSS selector targeting b elements.\n *\n * @category Constants\n */\nexport const B_SELECTOR = 'b';\n\n/**\n * Attribute bag for b creation/enhancement.\n *\n * @remarks\n * B elements accept standard HTML global attributes.\n *\n * pkgn-sol also supports a structured ARIA input for common ARIA fields, which is\n * mapped into {@link GlobalAttrs.aria} without changing pkgn-sol's core DOM helpers.\n *\n * @category Attributes\n */\nexport type BAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link BAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The b attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: BAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, ...rest } = attrs;\n\n  if (!aria) return rest;\n\n  const mappedAria: NonNullable<GlobalAttrs['aria']> = {};\n\n  if (typeof aria.label === 'string') mappedAria.label = aria.label;\n  if (typeof aria.labelledby === 'string') mappedAria.labelledby = aria.labelledby;\n  if (typeof aria.hidden === 'boolean') mappedAria.hidden = aria.hidden;\n\n  // Only attach `aria` if something was actually defined.\n  const hasMapped = Object.keys(mappedAria).length > 0;\n\n  return hasMapped ? { ...rest, aria: mappedAria } : rest;\n}\n\n/**\n * Create a b element with optional text content and global attributes.\n *\n * @remarks\n * - Text content is assigned via `textContent` (never `innerHTML`).\n * - Global attributes are applied via pkgn-sol's shared DOM helper,\n *   including security guards that block inline event handler attributes\n *   (e.g. `onclick`) and raw `style` attribute strings.\n *\n * @param text - Optional text content for the b element.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<b>` element.\n *\n * @example\n * ```ts\n * import { createB } from \"@lnpg/pkgn-sol/elements/inline/b\";\n *\n * document.body.appendChild(createB(\"Keyword\", { className: \"keyword\" }));\n * ```\n *\n * @category DOM\n */\nexport function createB(text?: string, attrs?: BAttrs): ElementOf<typeof B_TAG> {\n  return createElement(B_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance b elements within a given root.\n *\n * @remarks\n * This is intentionally a no-op in `0.1.0`.\n *\n * Why does it exist?\n * - It establishes a stable integration pattern for frameworks (Vue/React/etc.)\n * - It allows future progressive enhancements without changing consumer code\n *\n * What it will never do:\n * - It will not inject styles (CSS remains the source of truth)\n * - It will not introduce framework-specific behavior\n *\n * @param root - The node to search within. Defaults to `document`.\n *\n * @category Enhancement\n */\nexport function enhanceBs(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for b.\n  void root;\n}\n"],"mappings":";;;;;;;IA2Da,IAAQ,KAOR,IAAa;AA4B1B,SAAS,EAAc,GAAyC;CAC9D,IAAI,CAAC,GAAO;CAEZ,IAAM,EAAE,SAAM,GAAG,MAAS;CAE1B,IAAI,CAAC,GAAM,OAAO;CAElB,IAAM,IAA+C,EAAE;CASvD,OAPI,OAAO,EAAK,SAAU,aAAU,EAAW,QAAQ,EAAK,QACxD,OAAO,EAAK,cAAe,aAAU,EAAW,aAAa,EAAK,aAClE,OAAO,EAAK,UAAW,cAAW,EAAW,SAAS,EAAK,SAG7C,OAAO,KAAK,EAAW,CAAC,SAAS,IAEhC;EAAE,GAAG;EAAM,MAAM;EAAY,GAAG;;AAyBrD,SAAgB,EAAQ,GAAe,GAAyC;CAC9E,OAAO,EAAA,KAAqB,EAAc,EAAM,EAAE,EAAK;;AAqBzD,SAAgB,EAAU,IAAmB,UAAgB"}

package/dist/esm/elements/inline/cite/cite.js

@@ -0,0 +1,26 @@
+import { i as e, n as t } from "../../../chunks/dom.js";
+//#region src/elements/inline/cite/index.ts
+var n = /* @__PURE__ */ e({
+	CITE_SELECTOR: () => i,
+	CITE_TAG: () => r,
+	createCite: () => o,
+	enhanceCites: () => s
+}), r = "cite", i = "cite";
+function a(e) {
+	if (!e) return;
+	let { aria: t, ...n } = e;
+	if (!t) return n;
+	let r = {};
+	return 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 ? {
+		...n,
+		aria: r
+	} : n;
+}
+function o(e, n) {
+	return t(r, a(n), e);
+}
+function s(e = document) {}
+//#endregion
+export { i as CITE_SELECTOR, r as CITE_TAG, o as createCite, s as enhanceCites, n as t };
+
+//# sourceMappingURL=cite.js.map