@lnpg/pkgn-sol 1.0.0-beta.0

package/dist/esm/elements/responsive/picture/picture.js

@@ -0,0 +1,26 @@
+import { i as e, n as t } from "../../../chunks/dom.js";
+//#region src/elements/responsive/picture/index.ts
+var n = /* @__PURE__ */ e({
+	PICTURE_SELECTOR: () => i,
+	PICTURE_TAG: () => r,
+	createPicture: () => o,
+	enhancePictures: () => s
+}), r = "picture", i = "picture";
+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) {
+	return t(r, a(e));
+}
+function s(e = document) {}
+//#endregion
+export { i as PICTURE_SELECTOR, r as PICTURE_TAG, o as createPicture, s as enhancePictures, n as t };
+
+//# sourceMappingURL=picture.js.map

package/dist/esm/elements/responsive/picture/picture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"picture.js","names":[],"sources":["../../../../../src/elements/responsive/picture/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: Picture element helpers.\n *\n * @remarks\n * The picture element (`<picture>`) is a container used for responsive images.\n * It allows authors to provide multiple image sources (typically via child\n * `<source>` elements) and a required fallback `<img>` element.\n *\n * Best-practice guidance:\n * - Always include an `<img>` inside `<picture>` as the fallback and for\n *   accessibility. The alternative text (`alt`) belongs on the `<img>`, not on\n *   `<picture>`.\n * - Use `<source>` elements with `media` and/or `type` to provide format and\n *   breakpoint-specific sources.\n * - Prefer modern formats (e.g. AVIF/WebP) with a sensible fallback.\n *\n * pkgn-sol-specific conventions:\n * - `<picture>` has no element-specific attributes; this module applies global\n *   attributes via pkgn-sol's hardened DOM helpers (`dom.ts`), which block inline\n *   event handler attributes (e.g. `onclick`) and the raw `style` attribute\n *   string.\n * - Supports a small structured ARIA input to reduce typo-based ARIA bugs.\n *\n * This module has no side effects and does not mutate the DOM unless you call\n * its functions.\n *\n * @module\n * @category Elements\n */\n\nimport { createElement, type ElementOf, type GlobalAttrs } from '../../../ts/dom';\n\n/**\n * Structured ARIA input supported by 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 picture containers.\n *\n * @category Constants\n */\nexport const PICTURE_TAG = 'picture' as const;\n\n/**\n * A CSS selector targeting picture elements.\n *\n * @category Constants\n */\nexport const PICTURE_SELECTOR = 'picture';\n\n/**\n * Attribute bag for picture creation/enhancement.\n *\n * @remarks\n * `<picture>` does not define unique attributes; it is a container that affects\n * image source selection in conjunction with child `<source>` and `<img>`.\n *\n *\n * pkgn-sol supports a structured ARIA input for common ARIA fields, mapped into\n * {@link GlobalAttrs.aria}.\n *\n * @category Attributes\n */\nexport type PictureAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link PictureAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The picture attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: PictureAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, ...rest } = attrs;\n\n  if (!aria) return rest;\n\n  const mappedAria: NonNullable<GlobalAttrs['aria']> = {};\n\n  if (typeof aria.label === 'string') mappedAria.label = aria.label;\n  if (typeof aria.labelledby === 'string') mappedAria.labelledby = aria.labelledby;\n  if (typeof aria.hidden === 'boolean') mappedAria.hidden = aria.hidden;\n\n  const hasMapped = Object.keys(mappedAria).length > 0;\n\n  return hasMapped ? { ...rest, aria: mappedAria } : rest;\n}\n\n/**\n * Create a picture element with optional global attributes.\n *\n * @remarks\n * `<picture>` is a container; authors must append a fallback `<img>` and any\n * `<source>` children. The alternative text (`alt`) is provided on the `<img>`.\n *\n *\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 `<picture>` element.\n *\n * @example\n * ```ts\n * import { createPicture } from \"@lnpg/pkgn-sol/elements/responsive/picture\";\n *\n * const p = createPicture({ className: \"hero-media\" });\n * ```\n *\n * @category DOM\n */\nexport function createPicture(attrs?: PictureAttrs): ElementOf<typeof PICTURE_TAG> {\n  return createElement(PICTURE_TAG, toGlobalAttrs(attrs));\n}\n\n/**\n * Enhance picture 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 enhancePictures(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for picture.\n  void root;\n}\n"],"mappings":";;;;;;;IA8Da,IAAc,WAOd,IAAmB;AA8BhC,SAAS,EAAc,GAA+C;CACpE,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;;AA2BrD,SAAgB,EAAc,GAAqD;CACjF,OAAO,EAAc,GAAa,EAAc,EAAM,CAAC;;AAazD,SAAgB,EAAgB,IAAmB,UAAgB"}

package/dist/esm/elements/responsive/responsive.js

@@ -0,0 +1,18 @@
+import { i as e } from "../../chunks/dom.js";
+import { t } from "./area/area.js";
+import { t as n } from "./map/map.js";
+import { t as r } from "./picture/picture.js";
+import { t as i } from "./source/source.js";
+import { t as a } from "./track/track.js";
+//#region src/elements/responsive/index.ts
+var o = /* @__PURE__ */ e({
+	area: () => t,
+	map: () => n,
+	picture: () => r,
+	source: () => i,
+	track: () => a
+});
+//#endregion
+export { t as area, n as map, r as picture, i as source, o as t, a as track };
+
+//# sourceMappingURL=responsive.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"responsive.js","names":[],"sources":["../../../../src/elements/responsive/index.ts"],"sourcesContent":["/**\n * Responsive media element factories.\n *\n * Provides framework-agnostic factory functions for HTML elements commonly used\n * to deliver responsive, adaptive, and accessible media experiences.\n *\n * These factories:\n * - Create semantic responsive/media structures using pkgn-sol's hardened DOM helpers.\n * - Forward curated global attributes.\n * - Enforce structured, typed attribute bags.\n * - Preserve correct relationships between media resources and their metadata\n *   (e.g. `<picture>` + `<source>`, media maps via `<map>` + `<area>`, and timed\n *   text via `<track>`).\n * - Prevent unsafe attribute injection.\n *\n * The elements in this module support native browser features for responsive\n * images, image maps, and timed text tracks without framework assumptions.\n *\n * @module elements/responsive\n * @since 0.1.0\n */\n\n/**\n * `<area>` element factory namespace.\n *\n * Represents a clickable hotspot region within an image map, associated with a\n * `<map>` element. Typically paired with an `<img usemap=\"...\">`.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/area\n */\nexport * as area from './area';\n\n/**\n * `<map>` element factory namespace.\n *\n * Represents an image map container holding `<area>` definitions that describe\n * interactive regions on an associated image.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/map\n */\nexport * as map from './map';\n\n/**\n * `<picture>` element factory namespace.\n *\n * Represents a container for responsive images, allowing multiple `<source>`\n * candidates and a fallback `<img>`.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/picture\n */\nexport * as picture from './picture';\n\n/**\n * `<source>` element factory namespace.\n *\n * Represents a media resource candidate for `<picture>`, `<audio>`, or\n * `<video>`, selected by the browser based on type/media conditions.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/source\n */\nexport * as source from './source';\n\n/**\n * `<track>` element factory namespace.\n *\n * Represents an external timed text track (subtitles, captions, descriptions,\n * chapters, or metadata) for `<audio>` or `<video>`.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/track\n */\nexport * as track from './track';\n"],"mappings":""}

package/dist/esm/elements/responsive/source/source.js

@@ -0,0 +1,29 @@
+import { i as e, r as t } from "../../../chunks/dom.js";
+//#region src/elements/responsive/source/index.ts
+var n = /* @__PURE__ */ e({
+	SOURCE_SELECTOR: () => i,
+	SOURCE_TAG: () => r,
+	createSource: () => o,
+	enhanceSources: () => s
+}), r = "source", i = "source";
+function a(e) {
+	if (!e) return;
+	let { aria: t, src: n, srcSet: r, sizes: i, media: a, type: o, ...s } = e, c = typeof n == "string" && n.trim().length > 0, l = typeof r == "string" && r.trim().length > 0;
+	if (!c && !l) throw Error("source requires at least one of \"src\" or \"srcSet\".");
+	if (typeof i == "string" && i.trim().length > 0 && !l) throw Error("source \"sizes\" may only be specified when \"srcSet\" is provided.");
+	let u = { ...s }, d = { ...u.attrs ?? {} };
+	if (c && (d.src = n), l && (d.srcset = r), typeof i == "string" && i.trim().length > 0 && (d.sizes = i), typeof a == "string" && (d.media = a), typeof o == "string" && (d.type = o), Object.keys(d).length > 0 && (u.attrs = d), !t) return u;
+	let f = {};
+	return typeof t.label == "string" && (f.label = t.label), typeof t.labelledby == "string" && (f.labelledby = t.labelledby), typeof t.hidden == "boolean" && (f.hidden = t.hidden), Object.keys(f).length > 0 ? {
+		...u,
+		aria: f
+	} : u;
+}
+function o(e) {
+	return t(r, a(e));
+}
+function s(e = document) {}
+//#endregion
+export { i as SOURCE_SELECTOR, r as SOURCE_TAG, o as createSource, s as enhanceSources, n as t };
+
+//# sourceMappingURL=source.js.map

package/dist/esm/elements/responsive/source/source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.js","names":[],"sources":["../../../../../src/elements/responsive/source/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: Source element helpers.\n *\n * @remarks\n * The source element (`<source>`) provides one or more media resources for:\n * - `<picture>` (responsive images via `srcset`/`sizes`)\n * - `<audio>` / `<video>` (alternate encodings via `src`)\n *\n * Best-practice guidance:\n * - Use `<picture><source srcset ...></picture>` for responsive images and art direction.\n * - Use multiple `<source>` children under `<audio>/<video>` to provide fallback formats.\n * - Prefer providing a `type` when possible to help user agents skip unsupported formats.\n * - Use `media` to gate sources behind media conditions.\n * - Only use `sizes` when `srcset` is present (it is meaningless otherwise).\n *\n * Attributes (element-specific):\n * - `src` (string): media resource URL (primarily for `<audio>/<video>` contexts).\n * - `srcSet` (string): source set candidates (primarily for `<picture>` contexts).\n * - `sizes` (string): sizes list for `srcset` selection.\n * - `type` (string): MIME type hint.\n * - `media` (string): media query condition.\n *\n * Notes:\n * - `<source>` is a void element (no text content).\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/source\n *\n * @module\n * @category Elements\n */\n\nimport { createVoidElement, type ElementOf, type GlobalAttrs } from '../../../ts/dom';\n\n/**\n * Structured ARIA input supported by 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 source.\n *\n * @category Constants\n */\nexport const SOURCE_TAG = 'source' as const;\n\n/**\n * A CSS selector targeting source elements.\n *\n * @category Constants\n */\nexport const SOURCE_SELECTOR = 'source';\n\n/**\n * Attribute bag for source creation/enhancement.\n *\n * @remarks\n * Source elements accept standard HTML global attributes plus source-specific\n * content attributes used by `<picture>`, `<audio>`, and `<video>`.\n *\n * pkgn-sol supports structured ARIA input for common ARIA fields, mapped into\n * {@link GlobalAttrs.aria}.\n *\n * Validation rules enforced by this module:\n * - `sizes` may only be specified when `srcSet` is provided.\n * - At least one of `src` or `srcSet` must be provided (a `<source>` without a\n *   resource is not useful).\n *\n * @category Attributes\n */\nexport type SourceAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n\n  /**\n   * Media resource URL.\n   *\n   * @remarks\n   * Primarily used by `<audio>` and `<video>`. It is ignored when the `<source>`\n   * is nested inside `<picture>`.\n   */\n  src?: string;\n\n  /**\n   * Image candidate source set.\n   *\n   * @remarks\n   * Primarily used by `<picture>` responsive images.\n   * Maps to the `srcset` content attribute.\n   */\n  srcSet?: string;\n\n  /**\n   * Sizes list describing the intended display size for `srcset` selection.\n   *\n   * @remarks\n   * Only meaningful when `srcset` is present.\n   */\n  sizes?: string;\n\n  /**\n   * Media query condition for selecting this source.\n   */\n  media?: string;\n\n  /**\n   * MIME type hint for the resource(s).\n   */\n  type?: string;\n};\n\n/**\n * Normalize {@link SourceAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The source attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @throws Error if `sizes` is provided without `srcSet`.\n * @throws Error if neither `src` nor `srcSet` are provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: SourceAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, src, srcSet, sizes, media, type, ...rest } = attrs;\n\n  const hasSrc = typeof src === 'string' && src.trim().length > 0;\n  const hasSrcSet = typeof srcSet === 'string' && srcSet.trim().length > 0;\n\n  if (!hasSrc && !hasSrcSet) {\n    throw new Error('source requires at least one of \"src\" or \"srcSet\".');\n  }\n\n  if (typeof sizes === 'string' && sizes.trim().length > 0 && !hasSrcSet) {\n    throw new Error('source \"sizes\" may only be specified when \"srcSet\" is provided.');\n  }\n\n  const mapped: GlobalAttrs = { ...rest };\n\n  const extra: NonNullable<GlobalAttrs['attrs']> = { ...(mapped.attrs ?? {}) };\n\n  if (hasSrc) extra.src = src!;\n  if (hasSrcSet) extra.srcset = srcSet!;\n  if (typeof sizes === 'string' && sizes.trim().length > 0) extra.sizes = sizes;\n  if (typeof media === 'string') extra.media = media;\n  if (typeof type === 'string') extra.type = type;\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 source element with attributes.\n *\n * @remarks\n * `<source>` is a void element: it never carries text content.\n *\n * Global attributes and escape-hatch attributes are applied via pkgn-sol's shared DOM helper,\n * including security guards that block inline event handler attributes (e.g. `onclick`)\n * and raw `style` attribute strings.\n *\n * @param attrs - Optional attributes to apply.\n * @returns The created `<source>` element.\n *\n * @example\n * Responsive image source (picture):\n * ```ts\n * import { createSource } from \"@lnpg/pkgn-sol/elements/responsive/source\";\n *\n * const s = createSource({\n *   srcSet: \"/img/hero-800.jpg 800w, /img/hero-1600.jpg 1600w\",\n *   sizes: \"(max-width: 800px) 100vw, 800px\",\n *   type: \"image/jpeg\"\n * });\n * ```\n *\n * @category DOM\n */\nexport function createSource(attrs?: SourceAttrs): ElementOf<typeof SOURCE_TAG> {\n  return createVoidElement(SOURCE_TAG, toGlobalAttrs(attrs));\n}\n\n/**\n * Enhance source 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 enhanceSources(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for source.\n  void root;\n}\n"],"mappings":";;;;;;;IAuEa,IAAa,UAOb,IAAkB;AAyE/B,SAAS,EAAc,GAA8C;CACnE,IAAI,CAAC,GAAO;CAEZ,IAAM,EAAE,SAAM,QAAK,WAAQ,UAAO,UAAO,SAAM,GAAG,MAAS,GAErD,IAAS,OAAO,KAAQ,YAAY,EAAI,MAAM,CAAC,SAAS,GACxD,IAAY,OAAO,KAAW,YAAY,EAAO,MAAM,CAAC,SAAS;CAEvE,IAAI,CAAC,KAAU,CAAC,GACd,MAAU,MAAM,yDAAqD;CAGvE,IAAI,OAAO,KAAU,YAAY,EAAM,MAAM,CAAC,SAAS,KAAK,CAAC,GAC3D,MAAU,MAAM,sEAAkE;CAGpF,IAAM,IAAsB,EAAE,GAAG,GAAM,EAEjC,IAA2C,EAAE,GAAI,EAAO,SAAS,EAAE,EAAG;CAY5E,IAVI,MAAQ,EAAM,MAAM,IACpB,MAAW,EAAM,SAAS,IAC1B,OAAO,KAAU,YAAY,EAAM,MAAM,CAAC,SAAS,MAAG,EAAM,QAAQ,IACpE,OAAO,KAAU,aAAU,EAAM,QAAQ,IACzC,OAAO,KAAS,aAAU,EAAM,OAAO,IAEvC,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;;AA8B3D,SAAgB,EAAa,GAAmD;CAC9E,OAAO,EAAkB,GAAY,EAAc,EAAM,CAAC;;AAqB5D,SAAgB,EAAe,IAAmB,UAAgB"}

package/dist/esm/elements/responsive/track/track.js

@@ -0,0 +1,27 @@
+import { i as e, r as t } from "../../../chunks/dom.js";
+//#region src/elements/responsive/track/index.ts
+var n = /* @__PURE__ */ e({
+	TRACK_SELECTOR: () => i,
+	TRACK_TAG: () => r,
+	createTrack: () => o,
+	enhanceTracks: () => s
+}), r = "track", i = "track";
+function a(e) {
+	if (!e) return;
+	let { aria: t, kind: n, src: r, srclang: i, label: a, default: o, ...s } = e, c = { ...s.attrs ?? {} }, l = (e, t) => {
+		t !== void 0 && (Object.prototype.hasOwnProperty.call(c, e) || (c[e] = t));
+	};
+	l("kind", n), l("src", r), l("srclang", i), l("label", a), o === !0 && l("default", "");
+	let u = {};
+	t && (typeof t.label == "string" && (u.label = t.label), typeof t.labelledby == "string" && (u.labelledby = t.labelledby), typeof t.hidden == "boolean" && (u.hidden = t.hidden));
+	let d = Object.keys(c).length > 0, f = Object.keys(u).length > 0, p = { ...s };
+	return d && (p.attrs = c), f && (p.aria = u), p;
+}
+function o(e) {
+	return t(r, a(e));
+}
+function s(e = document) {}
+//#endregion
+export { i as TRACK_SELECTOR, r as TRACK_TAG, o as createTrack, s as enhanceTracks, n as t };
+
+//# sourceMappingURL=track.js.map

package/dist/esm/elements/responsive/track/track.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"track.js","names":[],"sources":["../../../../../src/elements/responsive/track/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: Track element helpers.\n *\n * @remarks\n * The track element (`<track>`) provides external timed text tracks for media\n * elements such as `<video>` and `<audio>`. Tracks can represent:\n * - subtitles\n * - captions\n * - descriptions\n * - chapters\n * - metadata\n *\n * Best-practice guidance:\n * - Use `<track>` for WebVTT (and similar timed text) resources that accompany media.\n * - Use `kind` to declare the track purpose (subtitles, captions, etc.).\n * - Use `label` for a user-facing title shown in media track selection UIs.\n * - Use `srclang` to declare the track language (BCP 47 tag).\n * - If `kind=\"subtitles\"`, user agents/spec require `srclang` to be defined.\n *\n * Attribute behavior notes:\n * - `default` is a boolean attribute. When present, it indicates this track\n *   should be enabled if user preferences do not indicate a better choice.\n *\n * pkgn-sol keeps the API small and framework-agnostic:\n * - Attributes are routed through pkgn-sol's hardened DOM helpers.\n * - Unsafe attributes (inline event handlers, raw style) are blocked centrally.\n * - This module has no side effects and does not mutate the DOM unless you call\n *   its functions.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/track\n * @see https://html.spec.whatwg.org/multipage/media.html#the-track-element\n *\n * @module\n * @category Elements\n */\n\nimport {\n  createVoidElement,\n  type AttrValue,\n  type ElementOf,\n  type GlobalAttrs,\n} from '../../../ts/dom';\n\n/**\n * Structured ARIA input supported by 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 * Allowed values for the `kind` attribute on `<track>`.\n *\n * @remarks\n * This follows the HTML living standard's enumerated states.\n *\n * @category Attributes\n */\nexport type TrackKind = 'subtitles' | 'captions' | 'descriptions' | 'chapters' | 'metadata';\n\n/**\n * The semantic tag name for track.\n *\n * @category Constants\n */\nexport const TRACK_TAG = 'track' as const;\n\n/**\n * A CSS selector targeting track elements.\n *\n * @category Constants\n */\nexport const TRACK_SELECTOR = 'track';\n\n/**\n * Attribute bag for track creation/enhancement.\n *\n * @remarks\n * Track is a void element and must not carry text content or child nodes.\n *\n * Track accepts standard HTML global attributes plus track-specific attributes:\n * - `kind`\n * - `src`\n * - `srclang`\n * - `label`\n * - `default` (boolean attribute)\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 TrackAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n\n  /**\n   * The type of text track.\n   */\n  kind?: TrackKind;\n\n  /**\n   * The URL of the timed text track resource (commonly a `.vtt` file).\n   */\n  src?: string;\n\n  /**\n   * The language of the text track, as a BCP 47 language tag.\n   *\n   * @remarks\n   * If `kind` is `subtitles`, user agents/spec require `srclang` to be defined.\n   */\n  srclang?: string;\n\n  /**\n   * User-visible label for the track (typically shown in media UI menus).\n   */\n  label?: string;\n\n  /**\n   * Marks this track as the default if user preferences do not indicate another.\n   *\n   * @remarks\n   * This maps to the `default` boolean attribute (presence-based).\n   */\n  default?: boolean;\n};\n\n/**\n * Normalize {@link TrackAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The track attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: TrackAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, kind, src, srclang, label, default: isDefault, ...rest } = attrs;\n\n  // Start with any caller-provided attrs escape hatch (still validated by dom.ts).\n  const mergedAttrs: Record<string, AttrValue> = { ...(rest.attrs ?? {}) };\n\n  const setIfUnset = (key: string, value: AttrValue | undefined): void => {\n    if (value === undefined) return;\n    if (Object.prototype.hasOwnProperty.call(mergedAttrs, key)) return;\n    mergedAttrs[key] = value;\n  };\n\n  setIfUnset('kind', kind);\n  setIfUnset('src', src);\n  setIfUnset('srclang', srclang);\n  setIfUnset('label', label);\n\n  // Boolean attribute presence is represented by empty string when true.\n  if (isDefault === true) setIfUnset('default', '');\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 track element and apply attributes.\n *\n * @remarks\n * Track is a void element:\n * - It must not have text content.\n * - It must not have child nodes.\n *\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 `<track>` element.\n *\n * @example\n * ```ts\n * import { createTrack } from \"@lnpg/pkgn-sol/elements/responsive/track\";\n *\n * const t = createTrack({\n *   kind: \"subtitles\",\n *   src: \"/captions/en.vtt\",\n *   srclang: \"en\",\n *   label: \"English\",\n *   default: true\n * });\n * ```\n *\n * @category DOM\n */\nexport function createTrack(attrs?: TrackAttrs): ElementOf<typeof TRACK_TAG> {\n  return createVoidElement(TRACK_TAG, toGlobalAttrs(attrs));\n}\n\n/**\n * Enhance track 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 enhanceTracks(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for track.\n  void root;\n}\n"],"mappings":";;;;;;;IAsFa,IAAY,SAOZ,IAAiB;AAkE9B,SAAS,EAAc,GAA6C;CAClE,IAAI,CAAC,GAAO;CAEZ,IAAM,EAAE,SAAM,SAAM,QAAK,YAAS,UAAO,SAAS,GAAW,GAAG,MAAS,GAGnE,IAAyC,EAAE,GAAI,EAAK,SAAS,EAAE,EAAG,EAElE,KAAc,GAAa,MAAuC;EAClE,MAAU,KAAA,MACV,OAAO,UAAU,eAAe,KAAK,GAAa,EAAI,KAC1D,EAAY,KAAO;;CASrB,AANA,EAAW,QAAQ,EAAK,EACxB,EAAW,OAAO,EAAI,EACtB,EAAW,WAAW,EAAQ,EAC9B,EAAW,SAAS,EAAM,EAGtB,MAAc,MAAM,EAAW,WAAW,GAAG;CAEjD,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;;AAiCT,SAAgB,EAAY,GAAiD;CAC3E,OAAO,EAAkB,GAAW,EAAc,EAAM,CAAC;;AAqB3D,SAAgB,EAAc,IAAmB,UAAgB"}

package/dist/esm/elements/table/caption/caption.js

@@ -0,0 +1,26 @@
+import { i as e, n as t } from "../../../chunks/dom.js";
+//#region src/elements/table/caption/index.ts
+var n = /* @__PURE__ */ e({
+	CAPTION_SELECTOR: () => i,
+	CAPTION_TAG: () => r,
+	createCaption: () => o,
+	enhanceCaptions: () => s
+}), r = "caption", i = "caption";
+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 CAPTION_SELECTOR, r as CAPTION_TAG, o as createCaption, s as enhanceCaptions, n as t };
+
+//# sourceMappingURL=caption.js.map

package/dist/esm/elements/table/caption/caption.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"caption.js","names":[],"sources":["../../../../../src/elements/table/caption/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: Caption element helpers.\n *\n * @remarks\n * The caption element (`<caption>`) provides a title (caption) for its parent\n * `<table>`. It is an important accessibility feature because it gives the table\n * an accessible name or description when authored appropriately. :contentReference[oaicite:1]{index=1}\n *\n * Best-practice guidance:\n * - Use `<caption>` to describe the purpose of the table and help users decide\n *   whether to read it. :contentReference[oaicite:2]{index=2}\n * - Place `<caption>` as the first child of the `<table>` in source order. :contentReference[oaicite:3]{index=3}\n * - Keep the caption concise but meaningful. For complex tables, captions can be\n *   supplemented with additional explanatory text near the table (outside the\n *   caption) when necessary. :contentReference[oaicite:4]{index=4}\n * - Avoid deprecated presentational attributes (e.g. legacy `align`) and use CSS instead. :contentReference[oaicite:5]{index=5}\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create `<caption>` elements in vanilla JS/TS without templates\n * - apply consistent global attributes safely\n * - use a stable \"enhancement\" hook if 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 caption elements.\n *\n * @category Constants\n */\nexport const CAPTION_TAG = 'caption' as const;\n\n/**\n * A CSS selector targeting caption elements.\n *\n * @category Constants\n */\nexport const CAPTION_SELECTOR = 'caption';\n\n/**\n * Attribute bag for caption creation/enhancement.\n *\n * @remarks\n * Caption elements accept standard HTML global attributes.\n *\n * 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 CaptionAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link CaptionAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The caption attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: CaptionAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, ...rest } = attrs;\n\n  if (!aria) return rest;\n\n  const mappedAria: NonNullable<GlobalAttrs['aria']> = {};\n\n  if (typeof aria.label === 'string') mappedAria.label = aria.label;\n  if (typeof aria.labelledby === 'string') mappedAria.labelledby = aria.labelledby;\n  if (typeof aria.hidden === 'boolean') mappedAria.hidden = aria.hidden;\n\n  // Only attach `aria` if something was actually defined.\n  const hasMapped = Object.keys(mappedAria).length > 0;\n\n  return hasMapped ? { ...rest, aria: mappedAria } : rest;\n}\n\n/**\n * Create a caption element with optional text content and global attributes.\n *\n * @remarks\n * - Text content is assigned via `textContent` (never `innerHTML`).\n * - Global attributes are applied via 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 caption.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<caption>` element.\n *\n * @example\n * Create and prepend a caption to a table:\n * ```ts\n * import { createCaption } from \"@lnpg/pkgn-sol/elements/table/caption\";\n *\n * const table = document.createElement(\"table\");\n * table.prepend(createCaption(\"Quarterly results\"));\n * ```\n *\n * @category DOM\n */\nexport function createCaption(text?: string, attrs?: CaptionAttrs): ElementOf<typeof CAPTION_TAG> {\n  return createElement(CAPTION_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance caption elements within a given root.\n *\n * @remarks\n * This is intentionally a no-op in `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 enhanceCaptions(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for caption.\n  void root;\n}\n"],"mappings":";;;;;;;IAgEa,IAAc,WAOd,IAAmB;AAgChC,SAAS,EAAc,GAA+C;CACpE,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;;AA2BrD,SAAgB,EAAc,GAAe,GAAqD;CAChG,OAAO,EAAc,GAAa,EAAc,EAAM,EAAE,EAAK;;AAqB/D,SAAgB,EAAgB,IAAmB,UAAgB"}

package/dist/esm/elements/table/col/col.js

@@ -0,0 +1,30 @@
+import { i as e, r as t } from "../../../chunks/dom.js";
+//#region src/elements/table/col/index.ts
+var n = /* @__PURE__ */ e({
+	COL_SELECTOR: () => "col",
+	COL_TAG: () => "col",
+	createCol: () => o,
+	enhanceCols: () => s
+}), r = "col", i = "col";
+function a(e) {
+	if (!e) return;
+	let { aria: t, span: n, attrs: r, ...i } = e, a = { ...i };
+	if (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 && (a.aria = e);
+	}
+	let o = { ...r ?? {} };
+	if (typeof n == "number" && !Object.prototype.hasOwnProperty.call(o, "span")) {
+		if (!Number.isInteger(n) || n <= 0) throw Error("Invalid \"span\" for <col>: expected a positive integer greater than zero.");
+		o.span = n;
+	}
+	return Object.keys(o).length > 0 && (a.attrs = o), a;
+}
+function o(e) {
+	return t("col", a(e));
+}
+function s(e = document) {}
+//#endregion
+export { i as COL_SELECTOR, r as COL_TAG, o as createCol, s as enhanceCols, n as t };
+
+//# sourceMappingURL=col.js.map

package/dist/esm/elements/table/col/col.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"col.js","names":[],"sources":["../../../../../src/elements/table/col/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: Col element helpers.\n *\n * @remarks\n * The col element (`<col>`) represents one or more columns in a table, and is\n * used to apply presentation (typically CSS) to columns as a group.\n *\n * Best-practice guidance:\n * - Use `<col>` only inside a `<colgroup>`.\n * - Use `<col>` for column-level styling (widths, background, etc.), not layout hacks.\n * - Don't rely on `<col>` for semantics or accessibility. Use proper table\n *   structure (`<caption>`, `<th>`, `scope`/`headers`) for accessible data tables.\n * - Avoid obsolete presentational attributes; prefer CSS.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create `<col>` elements in vanilla JS/TS without templates\n * - apply consistent global attributes safely\n * - use a stable \"enhancement\" hook if 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: `<col>`: https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/col\n * - WHATWG HTML: Tables: https://html.spec.whatwg.org/multipage/tables.html\n *\n * @module\n * @category Elements\n */\n\nimport { createVoidElement, type ElementOf, type GlobalAttrs } from '../../../ts/dom';\n\n/**\n * Structured ARIA input supported by 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 table column definitions.\n *\n * @category Constants\n */\nexport const COL_TAG = 'col' as const;\n\n/**\n * A CSS selector targeting col elements.\n *\n * @category Constants\n */\nexport const COL_SELECTOR = 'col';\n\n/**\n * Attribute bag for col creation/enhancement.\n *\n * @remarks\n * `<col>` supports standard HTML global attributes and one primary element\n * attribute: `span`.\n *\n * `span` specifies how many consecutive columns this `<col>` applies to.\n * If omitted, browsers treat it as `1`.\n *\n * pkgn-sol supports a structured ARIA input for common ARIA fields, mapped into\n * {@link GlobalAttrs.aria}.\n *\n * @category Attributes\n */\nexport type ColAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n\n  /**\n   * Number of consecutive columns this `<col>` element applies to.\n   *\n   * @remarks\n   * Must be a positive integer greater than zero. If omitted, the browser default\n   * is `1`.\n   */\n  span?: number;\n};\n\n/**\n * Normalize {@link ColAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The col attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: ColAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, span, attrs: rawAttrs, ...rest } = attrs;\n\n  const out: GlobalAttrs = { ...rest };\n\n  // Map structured ARIA, only if something is actually defined.\n  if (aria) {\n    const mappedAria: NonNullable<GlobalAttrs['aria']> = {};\n\n    if (typeof aria.label === 'string') mappedAria.label = aria.label;\n    if (typeof aria.labelledby === 'string') mappedAria.labelledby = aria.labelledby;\n    if (typeof aria.hidden === 'boolean') mappedAria.hidden = aria.hidden;\n\n    if (Object.keys(mappedAria).length > 0) out.aria = mappedAria;\n  }\n\n  // Preserve caller escape hatch, but allow pkgn-sol-typed fields to fill gaps.\n  const mergedAttrs: NonNullable<GlobalAttrs['attrs']> = { ...(rawAttrs ?? {}) };\n\n  // Only set `span` if provided AND caller didn't already set it via raw attrs.\n  if (typeof span === 'number' && !Object.prototype.hasOwnProperty.call(mergedAttrs, 'span')) {\n    // Spec constraint: positive integer > 0.\n    if (!Number.isInteger(span) || span <= 0) {\n      throw new Error('Invalid \"span\" for <col>: expected a positive integer greater than zero.');\n    }\n    mergedAttrs.span = span;\n  }\n\n  if (Object.keys(mergedAttrs).length > 0) out.attrs = mergedAttrs;\n\n  return out;\n}\n\n/**\n * Create a col element (`<col>`) and apply global attributes.\n *\n * @remarks\n * `<col>` is a void element. It does not accept text content or children.\n *\n * Global attributes are applied via 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 `<col>` element.\n *\n * @example\n * Create a `<col>` that spans 2 columns:\n * ```ts\n * import { createCol } from \"@lnpg/pkgn-sol/elements/table/col\";\n *\n * const col = createCol({ span: 2, className: \"numeric\" });\n * ```\n *\n * @category DOM\n */\nexport function createCol(attrs?: ColAttrs): ElementOf<typeof COL_TAG> {\n  return createVoidElement(COL_TAG, toGlobalAttrs(attrs));\n}\n\n/**\n * Enhance col elements within a given root.\n *\n * @remarks\n * This is intentionally a no-op in `0.1.0`.\n *\n * @param root - The node to search within. Defaults to `document`.\n *\n * @category Enhancement\n */\nexport function enhanceCols(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for col.\n  void root;\n}\n"],"mappings":";;;;;;;IAiEa,IAAU,OAOV,IAAe;AAyC5B,SAAS,EAAc,GAA2C;CAChE,IAAI,CAAC,GAAO;CAEZ,IAAM,EAAE,SAAM,SAAM,OAAO,GAAU,GAAG,MAAS,GAE3C,IAAmB,EAAE,GAAG,GAAM;CAGpC,IAAI,GAAM;EACR,IAAM,IAA+C,EAAE;EAMvD,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,MAAG,EAAI,OAAO;;CAIrD,IAAM,IAAiD,EAAE,GAAI,KAAY,EAAE,EAAG;CAG9E,IAAI,OAAO,KAAS,YAAY,CAAC,OAAO,UAAU,eAAe,KAAK,GAAa,OAAO,EAAE;EAE1F,IAAI,CAAC,OAAO,UAAU,EAAK,IAAI,KAAQ,GACrC,MAAU,MAAM,6EAA2E;EAE7F,EAAY,OAAO;;CAKrB,OAFI,OAAO,KAAK,EAAY,CAAC,SAAS,MAAG,EAAI,QAAQ,IAE9C;;AA0BT,SAAgB,EAAU,GAA6C;CACrE,OAAO,EAAA,OAA2B,EAAc,EAAM,CAAC;;AAazD,SAAgB,EAAY,IAAmB,UAAgB"}

package/dist/esm/elements/table/colgroup/colgroup.js

@@ -0,0 +1,33 @@
+import { i as e, n as t } from "../../../chunks/dom.js";
+//#region src/elements/table/colgroup/index.ts
+var n = /* @__PURE__ */ e({
+	COLGROUP_SELECTOR: () => i,
+	COLGROUP_TAG: () => r,
+	createColgroup: () => s,
+	enhanceColgroups: () => c
+}), r = "colgroup", i = "colgroup";
+function a(e, t, n) {
+	Object.prototype.hasOwnProperty.call(e, t) || (e[t] = n);
+}
+function o(e) {
+	if (!e) return;
+	let { aria: t, span: n, ...r } = e, i = t ? (() => {
+		let e = {};
+		return 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 ? e : void 0;
+	})() : void 0, o = { ...r.attrs ?? {} };
+	typeof n == "number" && Number.isFinite(n) && n > 0 && a(o, "span", Math.trunc(n));
+	let s = Object.keys(o).length > 0;
+	return {
+		...r,
+		...i ? { aria: i } : null,
+		...s ? { attrs: o } : null
+	};
+}
+function s(e) {
+	return t(r, o(e));
+}
+function c(e = document) {}
+//#endregion
+export { i as COLGROUP_SELECTOR, r as COLGROUP_TAG, s as createColgroup, c as enhanceColgroups, n as t };
+
+//# sourceMappingURL=colgroup.js.map

package/dist/esm/elements/table/colgroup/colgroup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colgroup.js","names":[],"sources":["../../../../../src/elements/table/colgroup/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: Colgroup element helpers.\n *\n * @remarks\n * The colgroup element (`<colgroup>`) represents a group of one or more columns\n * in a table and is primarily used to apply presentation (not structure) to\n * entire columns (typically via CSS). :contentReference[oaicite:1]{index=1}\n *\n * Best-practice guidance:\n * - Use `<colgroup>` (and optionally `<col>`) to apply column-level styling\n *   without repeating styles across cells.\n * - Place `<colgroup>` inside a `<table>`, after any `<caption>` and before\n *   `<thead>`, `<tbody>`, `<tfoot>`, or `<tr>`. :contentReference[oaicite:2]{index=2}\n * - Use the `span` attribute only when the `<colgroup>` contains no `<col>`\n *   children; otherwise, define spans via `<col>` elements. :contentReference[oaicite:3]{index=3}\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create `<colgroup>` 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 colgroup elements.\n *\n * @category Constants\n */\nexport const COLGROUP_TAG = 'colgroup' as const;\n\n/**\n * A CSS selector targeting colgroup elements.\n *\n * @category Constants\n */\nexport const COLGROUP_SELECTOR = 'colgroup';\n\n/**\n * Attribute bag for colgroup creation/enhancement.\n *\n * @remarks\n * Colgroup elements accept standard HTML global attributes, plus:\n * - `span`: the number of consecutive columns in the group (when no `<col>`\n *   children are present). :contentReference[oaicite:4]{index=4}\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 ColgroupAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n\n  /**\n   * Number of consecutive columns spanned by this column group.\n   *\n   * @remarks\n   * This should be a positive integer. The HTML spec clamps values above 1000\n   * and treats invalid/zero values as `1` in the table model. pkgn-sol does not\n   * attempt to emulate the full table model at runtime; it sets the attribute\n   * when you provide a valid positive integer. :contentReference[oaicite:5]{index=5}\n   *\n   * Note: Not permitted when the `<colgroup>` contains one or more `<col>`\n   * elements. pkgn-sol does not enforce child-structure rules; consumers control\n   * their DOM trees. :contentReference[oaicite:6]{index=6}\n   */\n  span?: number;\n};\n\n/**\n * Set an attribute only if it is not already present on the attribute bag.\n *\n * @remarks\n * This supports the pkgn-sol convention where explicit raw attributes provided via\n * {@link GlobalAttrs.attrs} are treated as the caller's final intent.\n *\n * @param attrs - The destination attributes object.\n * @param name - Attribute name.\n * @param value - Attribute value.\n *\n * @category Internal\n */\nfunction setIfUnset(\n  attrs: NonNullable<GlobalAttrs['attrs']>,\n  name: string,\n  value: string | number | boolean,\n): void {\n  if (Object.prototype.hasOwnProperty.call(attrs, name)) return;\n  attrs[name] = value;\n}\n\n/**\n * Normalize {@link ColgroupAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The colgroup attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: ColgroupAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, span, ...rest } = attrs;\n\n  const mappedAria: NonNullable<GlobalAttrs['aria']> | undefined = aria\n    ? (() => {\n        const out: NonNullable<GlobalAttrs['aria']> = {};\n        if (typeof aria.label === 'string') out.label = aria.label;\n        if (typeof aria.labelledby === 'string') out.labelledby = aria.labelledby;\n        if (typeof aria.hidden === 'boolean') out.hidden = aria.hidden;\n\n        return Object.keys(out).length > 0 ? out : undefined;\n      })()\n    : undefined;\n\n  const mergedAttrs: NonNullable<GlobalAttrs['attrs']> = { ...(rest.attrs ?? {}) };\n\n  // Apply `span` only when it is a valid positive integer.\n  if (typeof span === 'number' && Number.isFinite(span) && span > 0) {\n    // HTML defines span as an unsigned long; we keep it integer-ish.\n    setIfUnset(mergedAttrs, 'span', Math.trunc(span));\n  }\n\n  const hasMergedAttrs = Object.keys(mergedAttrs).length > 0;\n\n  return {\n    ...rest,\n    ...(mappedAria ? { aria: mappedAria } : null),\n    ...(hasMergedAttrs ? { attrs: mergedAttrs } : null),\n  };\n}\n\n/**\n * Create a colgroup element with global attributes.\n *\n * @remarks\n * - `<colgroup>` should not contain text content; pkgn-sol does not accept a `text`\n *   argument for this factory.\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 attrs - Optional attributes to apply.\n * @returns The created `<colgroup>` element.\n *\n * @example\n * Create a colgroup that spans two columns:\n * ```ts\n * import { createColgroup } from \"@lnpg/pkgn-sol/elements/table/colgroup\";\n *\n * const colgroup = createColgroup({ span: 2, className: \"cols\" });\n * table.appendChild(colgroup);\n * ```\n *\n * @category DOM\n */\nexport function createColgroup(attrs?: ColgroupAttrs): ElementOf<typeof COLGROUP_TAG> {\n  return createElement(COLGROUP_TAG, toGlobalAttrs(attrs));\n}\n\n/**\n * Enhance colgroup 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 enhanceColgroups(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for colgroup.\n  void root;\n}\n"],"mappings":";;;;;;;IA+Da,IAAe,YAOf,IAAoB;AAsDjC,SAAS,EACP,GACA,GACA,GACM;CACF,OAAO,UAAU,eAAe,KAAK,GAAO,EAAK,KACrD,EAAM,KAAQ;;AAWhB,SAAS,EAAc,GAAgD;CACrE,IAAI,CAAC,GAAO;CAEZ,IAAM,EAAE,SAAM,SAAM,GAAG,MAAS,GAE1B,IAA2D,WACtD;EACL,IAAM,IAAwC,EAAE;EAKhD,OAJI,OAAO,EAAK,SAAU,aAAU,EAAI,QAAQ,EAAK,QACjD,OAAO,EAAK,cAAe,aAAU,EAAI,aAAa,EAAK,aAC3D,OAAO,EAAK,UAAW,cAAW,EAAI,SAAS,EAAK,SAEjD,OAAO,KAAK,EAAI,CAAC,SAAS,IAAI,IAAM,KAAA;KACzC,GACJ,KAAA,GAEE,IAAiD,EAAE,GAAI,EAAK,SAAS,EAAE,EAAG;CAGhF,AAAI,OAAO,KAAS,YAAY,OAAO,SAAS,EAAK,IAAI,IAAO,KAE9D,EAAW,GAAa,QAAQ,KAAK,MAAM,EAAK,CAAC;CAGnD,IAAM,IAAiB,OAAO,KAAK,EAAY,CAAC,SAAS;CAEzD,OAAO;EACL,GAAG;EACH,GAAI,IAAa,EAAE,MAAM,GAAY,GAAG;EACxC,GAAI,IAAiB,EAAE,OAAO,GAAa,GAAG;EAC/C;;AA2BH,SAAgB,EAAe,GAAuD;CACpF,OAAO,EAAc,GAAc,EAAc,EAAM,CAAC;;AAqB1D,SAAgB,EAAiB,IAAmB,UAAgB"}

package/dist/esm/elements/table/table/table.js

@@ -0,0 +1,26 @@
+import { i as e, n as t } from "../../../chunks/dom.js";
+//#region src/elements/table/table/index.ts
+var n = /* @__PURE__ */ e({
+	TABLE_SELECTOR: () => i,
+	TABLE_TAG: () => r,
+	createTable: () => o,
+	enhanceTables: () => s
+}), r = "table", i = "table";
+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 TABLE_SELECTOR, r as TABLE_TAG, o as createTable, s as enhanceTables, n as t };
+
+//# sourceMappingURL=table.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"table.js","names":[],"sources":["../../../../../src/elements/table/table/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: Table element helpers.\n *\n * @remarks\n * The table element (`<table>`) represents tabular data with more than one\n * dimension (rows and columns).\n *\n * Best-practice guidance:\n * - Use tables for data, not for layout.\n * - Provide a clear `<caption>` describing the table's purpose.\n * - Use `<thead>`, `<tbody>`, and `<tfoot>` to group table content meaningfully.\n * - Mark header cells with `<th>` (not `<td>`), and use `scope`/`headers` where\n *   appropriate for accessibility, especially in more complex tables.\n * - Avoid obsolete presentational attributes (e.g. `border`, `cellpadding`,\n *   `cellspacing`, `align`, `bgcolor`). Use CSS instead.\n * - If additional long-form description is needed, consider `aria-describedby`\n *   pointing to explanatory text outside the table.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create table 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: `<table>`: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/table\n * - WHATWG: Table model: https://html.spec.whatwg.org/multipage/tables.html\n *\n * @module\n * @category Elements\n */\n\nimport { createElement, type ElementOf, type GlobalAttrs } from '../../../ts/dom';\n\n/**\n * Structured ARIA input supported by 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 HTML tables.\n *\n * @category Constants\n */\nexport const TABLE_TAG = 'table' as const;\n\n/**\n * A CSS selector targeting table elements.\n *\n * @category Constants\n */\nexport const TABLE_SELECTOR = 'table';\n\n/**\n * Attribute bag for table creation/enhancement.\n *\n * @remarks\n * Table 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 * Note: table-specific presentational attributes historically existed but are\n * obsolete in modern HTML. Consumers can still use {@link GlobalAttrs.attrs}\n * as an escape hatch where necessary, subject to pkgn-sol's security rules in\n * `dom.ts` (blocks inline event handlers and raw `style` attribute strings).\n *\n * @category Attributes\n */\nexport type TableAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link TableAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The table attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: TableAttrs): 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 table element with optional text content and global attributes.\n *\n * @remarks\n * - Table content is typically structured with child elements (`<caption>`,\n *   `<thead>`, `<tbody>`, `<tr>`, `<th>`, `<td>`). This helper does not build\n *   table structure, it only creates the `<table>` element.\n * - Optional text content is assigned via `textContent` (never `innerHTML`).\n *   In real usage, prefer building actual table child elements rather than\n *   relying on text content.\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 table (generally discouraged).\n * @param attrs - Optional attributes to apply.\n * @returns The created `<table>` element.\n *\n * @example\n * Create a table and append it:\n * ```ts\n * import { createTable } from \"@lnpg/pkgn-sol/elements/table/table\";\n *\n * const table = createTable(undefined, { className: \"data-table\" });\n * document.body.appendChild(table);\n * ```\n *\n * @category DOM\n */\nexport function createTable(text?: string, attrs?: TableAttrs): ElementOf<typeof TABLE_TAG> {\n  return createElement(TABLE_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance table 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 enhanceTables(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for table.\n  void root;\n}\n"],"mappings":";;;;;;;IAqEa,IAAY,SAOZ,IAAiB;AAiC9B,SAAS,EAAc,GAA6C;CAClE,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;;AAgCrD,SAAgB,EAAY,GAAe,GAAiD;CAC1F,OAAO,EAAc,GAAW,EAAc,EAAM,EAAE,EAAK;;AAqB7D,SAAgB,EAAc,IAAmB,UAAgB"}

package/dist/esm/elements/table/table.js

@@ -0,0 +1,28 @@
+import { i as e } from "../../chunks/dom.js";
+import { t } from "./table/table.js";
+import { t as n } from "./colgroup/colgroup.js";
+import { t as r } from "./col/col.js";
+import { t as i } from "./thead/thead.js";
+import { t as a } from "./tbody/tbody.js";
+import { t as o } from "./tfoot/tfoot.js";
+import { t as s } from "./tr/tr.js";
+import { t as c } from "./th/th.js";
+import { t as l } from "./td/td.js";
+import { t as u } from "./caption/caption.js";
+//#region src/elements/table/index.ts
+var d = /* @__PURE__ */ e({
+	caption: () => u,
+	col: () => r,
+	colgroup: () => n,
+	table: () => t,
+	tbody: () => a,
+	td: () => l,
+	tfoot: () => o,
+	th: () => c,
+	thead: () => i,
+	tr: () => s
+});
+//#endregion
+export { u as caption, r as col, n as colgroup, d as t, t as table, a as tbody, l as td, o as tfoot, c as th, i as thead, s as tr };
+
+//# sourceMappingURL=table.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"table.js","names":[],"sources":["../../../../src/elements/table/index.ts"],"sourcesContent":["/**\n * Table element factories.\n *\n * Provides framework-agnostic factory functions for semantic HTML table\n * structures and related elements.\n *\n * These factories:\n * - Create semantic table elements using pkgn-sol's hardened DOM helpers.\n * - Forward curated global attributes.\n * - Enforce structured, typed attribute bags.\n * - Preserve native table semantics and accessibility.\n * - Prevent unsafe attribute injection.\n *\n * Tables in pkgn-sol are intentionally low-level primitives. They do not attempt\n * to manage layout, styling, or data structures. Consumers remain responsible\n * for building meaningful table structures.\n *\n * @module elements/table\n * @since 0.1.0\n */\n\n/**\n * `<table>` element factory namespace.\n *\n * Represents tabular data arranged in rows and columns.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/table\n */\nexport * as table from './table';\n\n/**\n * `<colgroup>` element factory namespace.\n *\n * Groups one or more `<col>` elements for shared column styling and\n * structural definition.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/colgroup\n */\nexport * as colgroup from './colgroup';\n\n/**\n * `<col>` element factory namespace.\n *\n * Defines column-level properties within a table.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/col\n */\nexport * as col from './col';\n\n/**\n * `<thead>` element factory namespace.\n *\n * Groups header rows that label table columns.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/thead\n */\nexport * as thead from './thead';\n\n/**\n * `<tbody>` element factory namespace.\n *\n * Groups the primary body rows of a table.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/tbody\n */\nexport * as tbody from './tbody';\n\n/**\n * `<tfoot>` element factory namespace.\n *\n * Groups footer rows containing summaries or totals.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/tfoot\n */\nexport * as tfoot from './tfoot';\n\n/**\n * `<tr>` element factory namespace.\n *\n * Represents a table row.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/tr\n */\nexport * as tr from './tr';\n\n/**\n * `<th>` element factory namespace.\n *\n * Represents a header cell that labels a row or column.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/th\n */\nexport * as th from './th';\n\n/**\n * `<td>` element factory namespace.\n *\n * Represents a standard table data cell.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/td\n */\nexport * as td from './td';\n\n/**\n * `<caption>` element factory namespace.\n *\n * Provides a title or description for a table.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/caption\n */\nexport * as caption from './caption';\n"],"mappings":""}

package/dist/esm/elements/table/tbody/tbody.js

@@ -0,0 +1,26 @@
+import { i as e, n as t } from "../../../chunks/dom.js";
+//#region src/elements/table/tbody/index.ts
+var n = /* @__PURE__ */ e({
+	TBODY_SELECTOR: () => i,
+	TBODY_TAG: () => r,
+	createTbody: () => o,
+	enhanceTbodies: () => s
+}), r = "tbody", i = "tbody";
+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 TBODY_SELECTOR, r as TBODY_TAG, o as createTbody, s as enhanceTbodies, n as t };
+
+//# sourceMappingURL=tbody.js.map

package/dist/esm/elements/table/tbody/tbody.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tbody.js","names":[],"sources":["../../../../../src/elements/table/tbody/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: Tbody element helpers.\n *\n * @remarks\n * The tbody element (`<tbody>`) represents a block of rows that make up the main\n * body of a table's data.\n *\n * Best-practice guidance:\n * - Use tables for data, not layout.\n * - Group rows meaningfully with `<thead>`, `<tbody>`, and `<tfoot>`.\n * - Prefer semantic headers via `<th>` (with appropriate `scope`/`headers`)\n *   and provide a `<caption>` for accessible tables.\n * - Avoid obsolete presentational attributes (e.g. `align`, `valign`, `char`,\n *   `charoff`). Use CSS instead.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create `<tbody>` elements in vanilla JS/TS without templates\n * - apply consistent global attributes safely\n * - use a stable \"enhancement\" hook if 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: `<tbody>`: https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/tbody\n * - WHATWG HTML: Tables: https://html.spec.whatwg.org/multipage/tables.html\n *\n * @module\n * @category Elements\n */\n\nimport { createElement, type ElementOf, type GlobalAttrs } from '../../../ts/dom';\n\n/**\n * Structured ARIA input supported by 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 table body sections.\n *\n * @category Constants\n */\nexport const TBODY_TAG = 'tbody' as const;\n\n/**\n * A CSS selector targeting tbody elements.\n *\n * @category Constants\n */\nexport const TBODY_SELECTOR = 'tbody';\n\n/**\n * Attribute bag for tbody creation/enhancement.\n *\n * @remarks\n * `<tbody>` accepts standard HTML global attributes.\n *\n * 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 * Note: some legacy presentational attributes existed historically for table\n * sections, but are obsolete. Consumers can still use {@link GlobalAttrs.attrs}\n * as an escape hatch where necessary, subject to pkgn-sol's security rules in\n * `dom.ts` (blocks inline event handlers and raw `style` attribute strings).\n *\n * @category Attributes\n */\nexport type TbodyAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link TbodyAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The tbody attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: TbodyAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, ...rest } = attrs;\n\n  if (!aria) return rest;\n\n  const mappedAria: NonNullable<GlobalAttrs['aria']> = {};\n\n  if (typeof aria.label === 'string') mappedAria.label = aria.label;\n  if (typeof aria.labelledby === 'string') mappedAria.labelledby = aria.labelledby;\n  if (typeof aria.hidden === 'boolean') mappedAria.hidden = aria.hidden;\n\n  // Only attach `aria` if something was actually defined.\n  const hasMapped = Object.keys(mappedAria).length > 0;\n\n  return hasMapped ? { ...rest, aria: mappedAria } : rest;\n}\n\n/**\n * Create a tbody element with optional text content and global attributes.\n *\n * @remarks\n * - In real usage, `<tbody>` should contain `<tr>` rows (not text).\n * - Optional text content is assigned via `textContent` (never `innerHTML`).\n * - Global attributes are applied via 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 tbody (generally discouraged).\n * @param attrs - Optional attributes to apply.\n * @returns The created `<tbody>` element.\n *\n * @example\n * ```ts\n * import { createTbody } from \"@lnpg/pkgn-sol/elements/table/tbody\";\n *\n * const tbody = createTbody(undefined, { className: \"data-body\" });\n * ```\n *\n * @category DOM\n */\nexport function createTbody(text?: string, attrs?: TbodyAttrs): ElementOf<typeof TBODY_TAG> {\n  return createElement(TBODY_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance tbody elements within a given root.\n *\n * @remarks\n * This is intentionally a no-op in `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 enhanceTbodies(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for tbody.\n  void root;\n}\n"],"mappings":";;;;;;;IAkEa,IAAY,SAOZ,IAAiB;AAiC9B,SAAS,EAAc,GAA6C;CAClE,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,EAAY,GAAe,GAAiD;CAC1F,OAAO,EAAc,GAAW,EAAc,EAAM,EAAE,EAAK;;AAqB7D,SAAgB,EAAe,IAAmB,UAAgB"}

package/dist/esm/elements/table/td/td.js

@@ -0,0 +1,39 @@
+import { i as e, n as t } from "../../../chunks/dom.js";
+//#region src/elements/table/td/index.ts
+var n = /* @__PURE__ */ e({
+	TD_SELECTOR: () => "td",
+	TD_TAG: () => "td",
+	createTd: () => o,
+	enhanceTds: () => s
+}), r = "td", i = "td";
+function a(e) {
+	if (!e) return;
+	let { aria: t, colspan: n, rowspan: r, headers: i, attrs: a, ...o } = e, s = { ...o };
+	if (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 && (s.aria = e);
+	}
+	let c = { ...a ?? {} }, l = (e) => Object.prototype.hasOwnProperty.call(c, e);
+	if (typeof n == "number" && !l("colspan")) {
+		if (!Number.isInteger(n) || n <= 0) throw Error("Invalid \"colspan\" for <td>: expected a positive integer greater than zero.");
+		c.colspan = n;
+	}
+	if (typeof r == "number" && !l("rowspan")) {
+		if (!Number.isInteger(r) || r <= 0) throw Error("Invalid \"rowspan\" for <td>: expected a positive integer greater than zero.");
+		c.rowspan = r;
+	}
+	if (typeof i == "string" && !l("headers")) {
+		let e = i.trim();
+		if (e.length === 0) throw Error("Invalid \"headers\" for <td>: expected a non-empty string.");
+		c.headers = e;
+	}
+	return Object.keys(c).length > 0 && (s.attrs = c), s;
+}
+function o(e, n) {
+	return t("td", a(n), e);
+}
+function s(e = document) {}
+//#endregion
+export { i as TD_SELECTOR, r as TD_TAG, o as createTd, s as enhanceTds, n as t };
+
+//# sourceMappingURL=td.js.map

package/dist/esm/elements/table/td/td.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"td.js","names":[],"sources":["../../../../../src/elements/table/td/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: Td element helpers.\n *\n * @remarks\n * The td element (`<td>`) represents a data cell in a table row (`<tr>`).\n *\n * Best-practice guidance:\n * - Use `<td>` for data cells and `<th>` for header cells.\n * - Provide a `<caption>` and properly marked header cells for accessible tables.\n * - Prefer simple tables. For complex tables with multi-level headers, use\n *   the `headers` attribute to associate a `<td>` with one or more `<th>` IDs.\n * - Avoid obsolete presentational attributes (e.g. `align`, `bgcolor`, `valign`).\n *   Use CSS instead.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create `<td>` elements in vanilla JS/TS without templates\n * - apply consistent global attributes safely\n * - use a stable \"enhancement\" hook if 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: `<td>`: https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/td\n * - WHATWG HTML: Tables: https://html.spec.whatwg.org/multipage/tables.html\n * - W3C WAI: Tables (headers/id technique): https://www.w3.org/WAI/tutorials/tables/multi-level/\n *\n * @module\n * @category Elements\n */\n\nimport { createElement, type ElementOf, type GlobalAttrs } from '../../../ts/dom';\n\n/**\n * Structured ARIA input supported by 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 table data cells.\n *\n * @category Constants\n */\nexport const TD_TAG = 'td' as const;\n\n/**\n * A CSS selector targeting td elements.\n *\n * @category Constants\n */\nexport const TD_SELECTOR = 'td';\n\n/**\n * Attribute bag for td creation/enhancement.\n *\n * @remarks\n * In addition to global attributes, `<td>` participates in the table model via:\n * - `colspan`: number of columns spanned (positive integer)\n * - `rowspan`: number of rows spanned (positive integer)\n * - `headers`: space-separated list of `<th id=\"...\">` references for complex tables\n *\n * pkgn-sol supports a structured ARIA input for common ARIA fields, mapped into\n * {@link GlobalAttrs.aria}.\n *\n * @category Attributes\n */\nexport type TdAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n\n  /**\n   * Number of columns this cell spans.\n   *\n   * @remarks\n   * Must be a positive integer greater than zero.\n   */\n  colspan?: number;\n\n  /**\n   * Number of rows this cell spans.\n   *\n   * @remarks\n   * Must be a positive integer greater than zero.\n   */\n  rowspan?: number;\n\n  /**\n   * Space-separated list of header cell IDs (`<th id=\"...\">`) that apply to this cell.\n   *\n   * @remarks\n   * This is typically only necessary for complex tables.\n   */\n  headers?: string;\n};\n\n/**\n * Normalize {@link TdAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The td attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: TdAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, colspan, rowspan, headers, attrs: rawAttrs, ...rest } = attrs;\n\n  const out: GlobalAttrs = { ...rest };\n\n  // Map structured ARIA, only if something is actually defined.\n  if (aria) {\n    const mappedAria: NonNullable<GlobalAttrs['aria']> = {};\n\n    if (typeof aria.label === 'string') mappedAria.label = aria.label;\n    if (typeof aria.labelledby === 'string') mappedAria.labelledby = aria.labelledby;\n    if (typeof aria.hidden === 'boolean') mappedAria.hidden = aria.hidden;\n\n    if (Object.keys(mappedAria).length > 0) out.aria = mappedAria;\n  }\n\n  // Preserve caller escape hatch, but allow pkgn-sol-typed fields to fill gaps.\n  const mergedAttrs: NonNullable<GlobalAttrs['attrs']> = { ...(rawAttrs ?? {}) };\n\n  const hasOwn = (k: string) => Object.prototype.hasOwnProperty.call(mergedAttrs, k);\n\n  if (typeof colspan === 'number' && !hasOwn('colspan')) {\n    if (!Number.isInteger(colspan) || colspan <= 0) {\n      throw new Error('Invalid \"colspan\" for <td>: expected a positive integer greater than zero.');\n    }\n    mergedAttrs.colspan = colspan;\n  }\n\n  if (typeof rowspan === 'number' && !hasOwn('rowspan')) {\n    if (!Number.isInteger(rowspan) || rowspan <= 0) {\n      throw new Error('Invalid \"rowspan\" for <td>: expected a positive integer greater than zero.');\n    }\n    mergedAttrs.rowspan = rowspan;\n  }\n\n  if (typeof headers === 'string' && !hasOwn('headers')) {\n    const trimmed = headers.trim();\n    if (trimmed.length === 0) {\n      throw new Error('Invalid \"headers\" for <td>: expected a non-empty string.');\n    }\n    mergedAttrs.headers = trimmed;\n  }\n\n  if (Object.keys(mergedAttrs).length > 0) out.attrs = mergedAttrs;\n\n  return out;\n}\n\n/**\n * Create a td element with optional text content and global attributes.\n *\n * @remarks\n * - In real usage, `<td>` contains text and/or phrasing content, but should never\n *   be built via `innerHTML` from untrusted data.\n * - Text content is assigned via `textContent` (never `innerHTML`).\n * - Global attributes are applied via 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 td.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<td>` element.\n *\n * @example\n * ```ts\n * import { createTd } from \"@lnpg/pkgn-sol/elements/table/td\";\n *\n * const cell = createTd(\"42\", { colspan: 2 });\n * ```\n *\n * @category DOM\n */\nexport function createTd(text?: string, attrs?: TdAttrs): ElementOf<typeof TD_TAG> {\n  return createElement(TD_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance td elements within a given root.\n *\n * @remarks\n * This is intentionally a no-op in `0.1.0`.\n *\n * @param root - The node to search within. Defaults to `document`.\n *\n * @category Enhancement\n */\nexport function enhanceTds(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for td.\n  void root;\n}\n"],"mappings":";;;;;;;IAkEa,IAAS,MAOT,IAAc;AAuD3B,SAAS,EAAc,GAA0C;CAC/D,IAAI,CAAC,GAAO;CAEZ,IAAM,EAAE,SAAM,YAAS,YAAS,YAAS,OAAO,GAAU,GAAG,MAAS,GAEhE,IAAmB,EAAE,GAAG,GAAM;CAGpC,IAAI,GAAM;EACR,IAAM,IAA+C,EAAE;EAMvD,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,MAAG,EAAI,OAAO;;CAIrD,IAAM,IAAiD,EAAE,GAAI,KAAY,EAAE,EAAG,EAExE,KAAU,MAAc,OAAO,UAAU,eAAe,KAAK,GAAa,EAAE;CAElF,IAAI,OAAO,KAAY,YAAY,CAAC,EAAO,UAAU,EAAE;EACrD,IAAI,CAAC,OAAO,UAAU,EAAQ,IAAI,KAAW,GAC3C,MAAU,MAAM,+EAA6E;EAE/F,EAAY,UAAU;;CAGxB,IAAI,OAAO,KAAY,YAAY,CAAC,EAAO,UAAU,EAAE;EACrD,IAAI,CAAC,OAAO,UAAU,EAAQ,IAAI,KAAW,GAC3C,MAAU,MAAM,+EAA6E;EAE/F,EAAY,UAAU;;CAGxB,IAAI,OAAO,KAAY,YAAY,CAAC,EAAO,UAAU,EAAE;EACrD,IAAM,IAAU,EAAQ,MAAM;EAC9B,IAAI,EAAQ,WAAW,GACrB,MAAU,MAAM,6DAA2D;EAE7E,EAAY,UAAU;;CAKxB,OAFI,OAAO,KAAK,EAAY,CAAC,SAAS,MAAG,EAAI,QAAQ,IAE9C;;AA2BT,SAAgB,EAAS,GAAe,GAA2C;CACjF,OAAO,EAAA,MAAsB,EAAc,EAAM,EAAE,EAAK;;AAa1D,SAAgB,EAAW,IAAmB,UAAgB"}

package/dist/esm/elements/table/tfoot/tfoot.js

@@ -0,0 +1,26 @@
+import { i as e, n as t } from "../../../chunks/dom.js";
+//#region src/elements/table/tfoot/index.ts
+var n = /* @__PURE__ */ e({
+	TFOOT_SELECTOR: () => i,
+	TFOOT_TAG: () => r,
+	createTfoot: () => o,
+	enhanceTfoots: () => s
+}), r = "tfoot", i = "tfoot";
+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) {
+	return t(r, a(e));
+}
+function s(e = document) {}
+//#endregion
+export { i as TFOOT_SELECTOR, r as TFOOT_TAG, o as createTfoot, s as enhanceTfoots, n as t };
+
+//# sourceMappingURL=tfoot.js.map

package/dist/esm/elements/table/tfoot/tfoot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tfoot.js","names":[],"sources":["../../../../../src/elements/table/tfoot/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: Tfoot element helpers.\n *\n * @remarks\n * The tfoot element (`<tfoot>`) encapsulates a set of table rows (`<tr>`) that\n * comprise the footer of a table, typically containing column summaries such as\n * totals or other aggregate values. :contentReference[oaicite:1]{index=1}\n *\n * Best-practice guidance:\n * - Use `<tfoot>` for footer rows (summaries/totals), and keep the table's\n *   structure logical with `<thead>` for headers and `<tbody>` for body rows.\n * - Many guides recommend placing `<tfoot>` after `<tbody>` for readability. :contentReference[oaicite:2]{index=2}\n * - Avoid deprecated presentational attributes and use CSS instead.\n * - Prefer native table semantics; only use ARIA when you cannot express the\n *   intended structure using proper table markup.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create `<tfoot>` elements in vanilla JS/TS without templates\n * - apply consistent global attributes safely\n * - use a stable \"enhancement\" hook if 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 tfoot elements.\n *\n * @category Constants\n */\nexport const TFOOT_TAG = 'tfoot' as const;\n\n/**\n * A CSS selector targeting tfoot elements.\n *\n * @category Constants\n */\nexport const TFOOT_SELECTOR = 'tfoot';\n\n/**\n * Attribute bag for tfoot creation/enhancement.\n *\n * @remarks\n * Tfoot elements accept standard HTML global attributes.\n *\n * 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 TfootAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link TfootAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The tfoot attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: TfootAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, ...rest } = attrs;\n\n  if (!aria) return rest;\n\n  const mappedAria: NonNullable<GlobalAttrs['aria']> = {};\n\n  if (typeof aria.label === 'string') mappedAria.label = aria.label;\n  if (typeof aria.labelledby === 'string') mappedAria.labelledby = aria.labelledby;\n  if (typeof aria.hidden === 'boolean') mappedAria.hidden = aria.hidden;\n\n  // Only attach `aria` if something was actually defined.\n  const hasMapped = Object.keys(mappedAria).length > 0;\n\n  return hasMapped ? { ...rest, aria: mappedAria } : rest;\n}\n\n/**\n * Create a tfoot element with global attributes.\n *\n * @remarks\n * - `<tfoot>` is a structural table element. pkgn-sol does not accept a text argument\n *   for this factory. Populate it with `<tr>` (and cells) as needed.\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 attrs - Optional attributes to apply.\n * @returns The created `<tfoot>` element.\n *\n * @example\n * Create and append a tfoot:\n * ```ts\n * import { createTfoot } from \"@lnpg/pkgn-sol/elements/table/tfoot\";\n *\n * const tfoot = createTfoot({ className: \"table-foot\" });\n * table.appendChild(tfoot);\n * ```\n *\n * @category DOM\n */\nexport function createTfoot(attrs?: TfootAttrs): ElementOf<typeof TFOOT_TAG> {\n  return createElement(TFOOT_TAG, toGlobalAttrs(attrs));\n}\n\n/**\n * Enhance tfoot elements within a given root.\n *\n * @remarks\n * This is intentionally a no-op in `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 enhanceTfoots(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for tfoot.\n  void root;\n}\n"],"mappings":";;;;;;;IA+Da,IAAY,SAOZ,IAAiB;AAgC9B,SAAS,EAAc,GAA6C;CAClE,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;;AA2BrD,SAAgB,EAAY,GAAiD;CAC3E,OAAO,EAAc,GAAW,EAAc,EAAM,CAAC;;AAqBvD,SAAgB,EAAc,IAAmB,UAAgB"}

package/dist/esm/elements/table/th/th.js

@@ -0,0 +1,33 @@
+import { i as e, n as t } from "../../../chunks/dom.js";
+//#region src/elements/table/th/index.ts
+var n = /* @__PURE__ */ e({
+	TH_SELECTOR: () => "th",
+	TH_TAG: () => "th",
+	createTh: () => s,
+	enhanceThs: () => c
+}), r = "th", i = "th";
+function a(e, t, n) {
+	Object.prototype.hasOwnProperty.call(e, t) || (e[t] = n);
+}
+function o(e) {
+	if (!e) return;
+	let { aria: t, abbr: n, colspan: r, rowspan: i, headers: o, scope: s, ...c } = e, l = t ? (() => {
+		let e = {};
+		return 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 ? e : void 0;
+	})() : void 0, u = { ...c.attrs ?? {} };
+	typeof n == "string" && n.length > 0 && a(u, "abbr", n), typeof o == "string" && o.length > 0 && a(u, "headers", o), typeof s == "string" && s.length > 0 && a(u, "scope", s), typeof r == "number" && Number.isFinite(r) && r > 0 && a(u, "colspan", Math.trunc(r)), typeof i == "number" && Number.isFinite(i) && i > 0 && a(u, "rowspan", Math.trunc(i));
+	let d = Object.keys(u).length > 0;
+	return {
+		...c,
+		...l ? { aria: l } : null,
+		...d ? { attrs: u } : null
+	};
+}
+function s(e, n) {
+	return t("th", o(n), e);
+}
+function c(e = document) {}
+//#endregion
+export { i as TH_SELECTOR, r as TH_TAG, s as createTh, c as enhanceThs, n as t };
+
+//# sourceMappingURL=th.js.map