@lnpg/pkgn-sol 1.0.0-beta.0

package/dist/cjs/elements/interactive/dialog/dialog.cjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../../../chunks/dom.cjs`);var t=e.i({DIALOG_SELECTOR:()=>r,DIALOG_TAG:()=>n,createDialog:()=>a,enhanceDialogs:()=>o}),n=`dialog`,r=`dialog`;function i(e){if(!e)return;let{aria:t,open:n,closedBy:r,...i}=e,a={...i},o={...a.attrs??{}};if(n===!0&&(o.open=!0),(r===`any`||r===`closerequest`||r===`none`)&&(o.closedby=r),Object.keys(o).length>0&&(a.attrs=o),!t)return a;let s={};return typeof t.label==`string`&&(s.label=t.label),typeof t.labelledby==`string`&&(s.labelledby=t.labelledby),typeof t.hidden==`boolean`&&(s.hidden=t.hidden),Object.keys(s).length>0?{...a,aria:s}:a}function a(t,r){return e.n(n,i(r),t)}function o(e=document){}exports.DIALOG_SELECTOR=r,exports.DIALOG_TAG=n,exports.createDialog=a,exports.enhanceDialogs=o,Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return t}});
+//# sourceMappingURL=dialog.cjs.map

package/dist/cjs/elements/interactive/dialog/dialog.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialog.cjs","names":[],"sources":["../../../../../src/elements/interactive/dialog/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: Dialog element helpers.\n *\n * @remarks\n * The dialog element (`<dialog>`) represents a modal or non-modal dialog box\n * (e.g. a confirm prompt, inspector, or subwindow).\n *\n * Best-practice guidance:\n * - Prefer using the platform APIs:\n *   - `dialog.showModal()` for modal dialogs\n *   - `dialog.show()` for non-modal dialogs\n *   - `dialog.close()` to close, optionally supplying a return value\n * - Provide an accessible name for the dialog content (e.g. heading + `aria-labelledby`\n *   or `aria-label` when appropriate).\n * - Ensure the dialog contains an obvious close mechanism.\n * - Avoid relying solely on adding/removing `open`; prefer the element's methods\n *   for correct focus and modal behavior.\n *\n * Attributes (element-specific):\n * - `open` (boolean): when present, the dialog is active and available for interaction.\n * - `closedBy` (enumerated): maps to the `closedby` content attribute (spec-defined).\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/dialog\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 dialog.\n *\n * @category Constants\n */\nexport const DIALOG_TAG = 'dialog' as const;\n\n/**\n * A CSS selector targeting dialog elements.\n *\n * @category Constants\n */\nexport const DIALOG_SELECTOR = 'dialog';\n\n/**\n * Values supported by the `closedby` content attribute.\n *\n * @remarks\n * This is a newer platform feature that specifies which user actions can close\n * the dialog automatically.\n *\n * - `any`: close requests or clicks outside close the dialog.\n * - `closerequest`: close requests close the dialog.\n * - `none`: no user actions automatically close the dialog.\n *\n * @category Types\n */\nexport type DialogClosedBy = 'any' | 'closerequest' | 'none';\n\n/**\n * Attribute bag for dialog creation/enhancement.\n *\n * @remarks\n * Dialog elements accept standard HTML global attributes plus a small set of\n * dialog-specific content 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 DialogAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n\n  /**\n   * Whether the dialog is open (active).\n   *\n   * @remarks\n   * Maps to the `open` boolean attribute.\n   *\n   * Prefer controlling visibility via the native methods (`showModal`, `show`,\n   * `close`) when possible.\n   */\n  open?: boolean;\n\n  /**\n   * Control user actions that can close the dialog.\n   *\n   * @remarks\n   * Maps to the `closedby` content attribute.\n   */\n  closedBy?: DialogClosedBy;\n};\n\n/**\n * Normalize {@link DialogAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The dialog attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: DialogAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, open, closedBy, ...rest } = attrs;\n\n  const mapped: GlobalAttrs = { ...rest };\n\n  const extra: NonNullable<GlobalAttrs['attrs']> = { ...(mapped.attrs ?? {}) };\n\n  if (open === true) extra.open = true;\n\n  if (closedBy === 'any' || closedBy === 'closerequest' || closedBy === 'none') {\n    extra.closedby = closedBy;\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  // Only attach `aria` if something was actually defined.\n  const hasMappedAria = Object.keys(mappedAria).length > 0;\n\n  return hasMappedAria ? { ...mapped, aria: mappedAria } : mapped;\n}\n\n/**\n * Create a dialog 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 dialog.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<dialog>` element.\n *\n * @example\n * ```ts\n * import { createDialog } from \"@lnpg/pkgn-sol/elements/interactive/dialog\";\n *\n * const d = createDialog(\"Hello\", { open: true });\n * ```\n *\n * @category DOM\n */\nexport function createDialog(text?: string, attrs?: DialogAttrs): ElementOf<typeof DIALOG_TAG> {\n  return createElement(DIALOG_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance dialog 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 enhanceDialogs(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for dialog.\n  void root;\n}\n"],"mappings":"0MAoEa,EAAa,SAOb,EAAkB,SA+D/B,SAAS,EAAc,EAA8C,CACnE,GAAI,CAAC,EAAO,OAEZ,GAAM,CAAE,OAAM,OAAM,WAAU,GAAG,GAAS,EAEpC,EAAsB,CAAE,GAAG,EAAM,CAEjC,EAA2C,CAAE,GAAI,EAAO,OAAS,EAAE,CAAG,CAY5E,GAVI,IAAS,KAAM,EAAM,KAAO,KAE5B,IAAa,OAAS,IAAa,gBAAkB,IAAa,UACpE,EAAM,SAAW,GAGf,OAAO,KAAK,EAAM,CAAC,OAAS,IAC9B,EAAO,MAAQ,GAGb,CAAC,EAAM,OAAO,EAElB,IAAM,EAA+C,EAAE,CASvD,OAPI,OAAO,EAAK,OAAU,WAAU,EAAW,MAAQ,EAAK,OACxD,OAAO,EAAK,YAAe,WAAU,EAAW,WAAa,EAAK,YAClE,OAAO,EAAK,QAAW,YAAW,EAAW,OAAS,EAAK,QAGzC,OAAO,KAAK,EAAW,CAAC,OAAS,EAEhC,CAAE,GAAG,EAAQ,KAAM,EAAY,CAAG,EAyB3D,SAAgB,EAAa,EAAe,EAAmD,CAC7F,OAAO,EAAA,EAAc,EAAY,EAAc,EAAM,CAAE,EAAK,CAqB9D,SAAgB,EAAe,EAAmB,SAAgB"}

package/dist/cjs/elements/interactive/interactive.cjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../../chunks/dom.cjs`),t=require(`./details/details.cjs`),n=require(`./dialog/dialog.cjs`),r=require(`./summary/summary.cjs`);var i=e.i({details:()=>t.t,dialog:()=>n.t,summary:()=>r.t});Object.defineProperty(exports,`details`,{enumerable:!0,get:function(){return t.t}}),Object.defineProperty(exports,`dialog`,{enumerable:!0,get:function(){return n.t}}),Object.defineProperty(exports,`summary`,{enumerable:!0,get:function(){return r.t}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return i}});
+//# sourceMappingURL=interactive.cjs.map

package/dist/cjs/elements/interactive/interactive.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive.cjs","names":[],"sources":["../../../../src/elements/interactive/index.ts"],"sourcesContent":["/**\n * Interactive element factories.\n *\n * Provides framework-agnostic factory functions for interactive HTML elements\n * that expose built-in browser behaviors such as disclosure widgets and modal\n * dialogs.\n *\n * These factories:\n * - Create semantic interactive structures using pkgn-sol's hardened DOM helpers.\n * - Forward curated global attributes.\n * - Enforce structured, typed attribute bags.\n * - Preserve correct accessibility semantics and relationships.\n * - Prevent unsafe attribute injection.\n *\n * The elements in this module provide native interactivity that browsers\n * understand without requiring JavaScript frameworks.\n *\n * @module elements/interactive\n * @since 0.1.0\n */\n\n/**\n * `<details>` element factory namespace.\n *\n * Represents a disclosure widget that users can open and close to reveal\n * additional information.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/details\n */\nexport * as details from './details';\n\n/**\n * `<dialog>` element factory namespace.\n *\n * Represents a dialog box or interactive component such as a modal window,\n * alert, or confirmation interface.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/dialog\n */\nexport * as dialog from './dialog';\n\n/**\n * `<summary>` element factory namespace.\n *\n * Represents the summary or visible heading for a `<details>` disclosure\n * widget. Clicking the summary toggles the details content.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/summary\n */\nexport * as summary from './summary';\n"],"mappings":""}

package/dist/cjs/elements/interactive/summary/summary.cjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../../../chunks/dom.cjs`);var t=e.i({SUMMARY_SELECTOR:()=>r,SUMMARY_TAG:()=>n,createSummary:()=>a,enhanceSummaries:()=>o}),n=`summary`,r=`summary`;function i(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 a(t,r){return e.n(n,i(r),t)}function o(e=document){}exports.SUMMARY_SELECTOR=r,exports.SUMMARY_TAG=n,exports.createSummary=a,exports.enhanceSummaries=o,Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return t}});
+//# sourceMappingURL=summary.cjs.map

package/dist/cjs/elements/interactive/summary/summary.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.cjs","names":[],"sources":["../../../../../src/elements/interactive/summary/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: Summary element helpers.\n *\n * @remarks\n * The summary element (`<summary>`) provides the visible label for a parent\n * `<details>` disclosure widget. Activating (clicking / pressing Enter) on the\n * `<summary>` toggles the open state of the parent `<details>` element.\n *\n * Best-practice guidance:\n * - Use `<summary>` only as the first child of a `<details>` element.\n * - Use clear, concise text so the disclosure purpose is obvious.\n * - Prefer semantic content inside `<summary>`; avoid overly complex interactive\n *   children inside the summary label.\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: `<summary>` element\n * - WHATWG HTML: `<details>` content model and summary semantics\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 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 summary.\n *\n * @category Constants\n */\nexport const SUMMARY_TAG = 'summary' as const;\n\n/**\n * A CSS selector targeting summary elements.\n *\n * @category Constants\n */\nexport const SUMMARY_SELECTOR = 'summary';\n\n/**\n * Attribute bag for summary creation/enhancement.\n *\n * @remarks\n * `<summary>` supports 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 SummaryAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link SummaryAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The summary attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: SummaryAttrs): 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 summary 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 summary.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<summary>` element.\n *\n * @example\n * ```ts\n * import { createSummary } from \"@lnpg/pkgn-sol/elements/interactive/summary\";\n *\n * const s = createSummary(\"More details\");\n * ```\n *\n * @category DOM\n */\nexport function createSummary(text?: string, attrs?: SummaryAttrs): ElementOf<typeof SUMMARY_TAG> {\n  return createElement(SUMMARY_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance summary 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 * @param root - The node to search within. Defaults to `document`.\n *\n * @category Enhancement\n */\nexport function enhanceSummaries(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for summary.\n  void root;\n}\n"],"mappings":"+MAgEa,EAAc,UAOd,EAAmB,UA4BhC,SAAS,EAAc,EAA+C,CACpE,GAAI,CAAC,EAAO,OAEZ,GAAM,CAAE,OAAM,GAAG,GAAS,EAE1B,GAAI,CAAC,EAAM,OAAO,EAElB,IAAM,EAA+C,EAAE,CAQvD,OANI,OAAO,EAAK,OAAU,WAAU,EAAW,MAAQ,EAAK,OACxD,OAAO,EAAK,YAAe,WAAU,EAAW,WAAa,EAAK,YAClE,OAAO,EAAK,QAAW,YAAW,EAAW,OAAS,EAAK,QAE7C,OAAO,KAAK,EAAW,CAAC,OAAS,EAEhC,CAAE,GAAG,EAAM,KAAM,EAAY,CAAG,EAyBrD,SAAgB,EAAc,EAAe,EAAqD,CAChG,OAAO,EAAA,EAAc,EAAa,EAAc,EAAM,CAAE,EAAK,CAiB/D,SAAgB,EAAiB,EAAmB,SAAgB"}

package/dist/cjs/elements/layout/article/article.cjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../../../chunks/dom.cjs`);var t=e.i({ARTICLE_SELECTOR:()=>r,ARTICLE_TAG:()=>n,createArticle:()=>a,enhanceArticles:()=>o}),n=`article`,r=`article`;function i(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 a(t,r){return e.n(n,i(r),t)}function o(e=document){}exports.ARTICLE_SELECTOR=r,exports.ARTICLE_TAG=n,exports.createArticle=a,exports.enhanceArticles=o,Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return t}});
+//# sourceMappingURL=article.cjs.map

package/dist/cjs/elements/layout/article/article.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"article.cjs","names":[],"sources":["../../../../../src/elements/layout/article/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: Article element helpers.\n *\n * @remarks\n * The article element (`<article>`) represents a self-contained composition in a\n * document, page, application, or site that is intended to be independently\n * distributable or reusable (e.g. syndication).\n *\n * Best-practice guidance:\n * - Use `<article>` for content that makes sense on its own (blog post, news item,\n *   forum post, comment, product card, etc.).\n * - Prefer `<section>` for thematic grouping that is not independently distributable.\n * - Articles commonly include a heading (h1-h6) in their content, but this module\n *   does not enforce structure at runtime.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create article sections 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/Element/article\n * @see https://html.spec.whatwg.org/multipage/sections.html#the-article-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.\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 article.\n *\n * @category Constants\n */\nexport const ARTICLE_TAG = 'article' as const;\n\n/**\n * A CSS selector targeting article elements.\n *\n * @category Constants\n */\nexport const ARTICLE_SELECTOR = 'article';\n\n/**\n * Attribute bag for article creation/enhancement.\n *\n * @remarks\n * Article 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 ArticleAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link ArticleAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The article attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: ArticleAttrs): 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 article 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 article.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<article>` element.\n *\n * @example\n * ```ts\n * import { createArticle } from \"@lnpg/pkgn-sol/elements/layout/article\";\n *\n * document.body.appendChild(\n *   createArticle(undefined, { className: \"post\", aria: { label: \"Blog post\" } })\n * );\n * ```\n *\n * @category DOM\n */\nexport function createArticle(text?: string, attrs?: ArticleAttrs): ElementOf<typeof ARTICLE_TAG> {\n  return createElement(ARTICLE_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance article 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 enhanceArticles(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for article.\n  void root;\n}\n"],"mappings":"8MAiEa,EAAc,UAOd,EAAmB,UA4BhC,SAAS,EAAc,EAA+C,CACpE,GAAI,CAAC,EAAO,OAEZ,GAAM,CAAE,OAAM,GAAG,GAAS,EAE1B,GAAI,CAAC,EAAM,OAAO,EAElB,IAAM,EAA+C,EAAE,CASvD,OAPI,OAAO,EAAK,OAAU,WAAU,EAAW,MAAQ,EAAK,OACxD,OAAO,EAAK,YAAe,WAAU,EAAW,WAAa,EAAK,YAClE,OAAO,EAAK,QAAW,YAAW,EAAW,OAAS,EAAK,QAG7C,OAAO,KAAK,EAAW,CAAC,OAAS,EAEhC,CAAE,GAAG,EAAM,KAAM,EAAY,CAAG,EA2BrD,SAAgB,EAAc,EAAe,EAAqD,CAChG,OAAO,EAAA,EAAc,EAAa,EAAc,EAAM,CAAE,EAAK,CAqB/D,SAAgB,EAAgB,EAAmB,SAAgB"}

package/dist/cjs/elements/layout/aside/aside.cjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../../../chunks/dom.cjs`);var t=e.i({ASIDE_SELECTOR:()=>r,ASIDE_TAG:()=>n,createAside:()=>a,enhanceAsides:()=>o}),n=`aside`,r=`aside`;function i(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 a(t,r){return e.n(n,i(r),t)}function o(e=document){}exports.ASIDE_SELECTOR=r,exports.ASIDE_TAG=n,exports.createAside=a,exports.enhanceAsides=o,Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return t}});
+//# sourceMappingURL=aside.cjs.map

package/dist/cjs/elements/layout/aside/aside.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"aside.cjs","names":[],"sources":["../../../../../src/elements/layout/aside/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: Aside element helpers.\n *\n * @remarks\n * The aside element (`<aside>`) represents content that is tangentially related\n * to the content around it, such as sidebars, callout boxes, pull quotes, or\n * related links.\n *\n * Best-practice guidance:\n * - Use `<aside>` for content related to the surrounding section, but not part of\n *   the main narrative flow.\n * - Avoid using `<aside>` purely for visual layout. Use CSS for layout and choose\n *   semantic elements for meaning.\n * - Prefer native semantics. Only add ARIA roles when needed.\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: `<aside>` 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.\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 aside.\n *\n * @category Constants\n */\nexport const ASIDE_TAG = 'aside' as const;\n\n/**\n * A CSS selector targeting aside elements.\n *\n * @category Constants\n */\nexport const ASIDE_SELECTOR = 'aside';\n\n/**\n * Attribute bag for aside creation/enhancement.\n *\n * @remarks\n * Aside 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 AsideAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link AsideAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The aside attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: AsideAttrs): 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 aside 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 aside.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<aside>` element.\n *\n * @example\n * ```ts\n * import { createAside } from \"@lnpg/pkgn-sol/elements/layout/aside\";\n *\n * const a = createAside(\"Related links\", { className: \"sidebar\" });\n * ```\n *\n * @category DOM\n */\nexport function createAside(text?: string, attrs?: AsideAttrs): ElementOf<typeof ASIDE_TAG> {\n  return createElement(ASIDE_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance aside 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 * @param root - The node to search within. Defaults to `document`.\n *\n * @category Enhancement\n */\nexport function enhanceAsides(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for aside.\n  void root;\n}\n"],"mappings":"sMAgEa,EAAY,QAOZ,EAAiB,QA4B9B,SAAS,EAAc,EAA6C,CAClE,GAAI,CAAC,EAAO,OAEZ,GAAM,CAAE,OAAM,GAAG,GAAS,EAE1B,GAAI,CAAC,EAAM,OAAO,EAElB,IAAM,EAA+C,EAAE,CAQvD,OANI,OAAO,EAAK,OAAU,WAAU,EAAW,MAAQ,EAAK,OACxD,OAAO,EAAK,YAAe,WAAU,EAAW,WAAa,EAAK,YAClE,OAAO,EAAK,QAAW,YAAW,EAAW,OAAS,EAAK,QAE7C,OAAO,KAAK,EAAW,CAAC,OAAS,EAEhC,CAAE,GAAG,EAAM,KAAM,EAAY,CAAG,EAyBrD,SAAgB,EAAY,EAAe,EAAiD,CAC1F,OAAO,EAAA,EAAc,EAAW,EAAc,EAAM,CAAE,EAAK,CAiB7D,SAAgB,EAAc,EAAmB,SAAgB"}

package/dist/cjs/elements/layout/footer/footer.cjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../../../chunks/dom.cjs`);var t=e.i({FOOTER_SELECTOR:()=>r,FOOTER_TAG:()=>n,createFooter:()=>a,enhanceFooters:()=>o}),n=`footer`,r=`footer`;function i(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 a(t,r){return e.n(n,i(r),t)}function o(e=document){}exports.FOOTER_SELECTOR=r,exports.FOOTER_TAG=n,exports.createFooter=a,exports.enhanceFooters=o,Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return t}});
+//# sourceMappingURL=footer.cjs.map

package/dist/cjs/elements/layout/footer/footer.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"footer.cjs","names":[],"sources":["../../../../../src/elements/layout/footer/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: Footer element helpers.\n *\n * @remarks\n * The footer element (`<footer>`) represents a footer for its nearest ancestor\n * sectioning content or sectioning root. It can be used as a page footer or as\n * a footer within an `<article>`, `<section>`, etc.\n *\n * Best-practice guidance:\n * - Use `<footer>` for information about the section it belongs to (author info,\n *   related links, legal text, etc.).\n * - Do not use `<footer>` purely for visual positioning. Layout is CSS; meaning\n *   is HTML.\n * - Prefer native semantics. Only add ARIA roles when needed.\n *\n * 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: `<footer>` element\n *\n * @module\n * @category Elements\n */\n\nimport { createElement, type ElementOf, type GlobalAttrs } from '../../../ts/dom';\n\n/**\n * Structured ARIA input supported by 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 footer.\n *\n * @category Constants\n */\nexport const FOOTER_TAG = 'footer' as const;\n\n/**\n * A CSS selector targeting footer elements.\n *\n * @category Constants\n */\nexport const FOOTER_SELECTOR = 'footer';\n\n/**\n * Attribute bag for footer creation/enhancement.\n *\n * @remarks\n * Footer elements accept standard HTML global attributes.\n *\n * 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 FooterAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link FooterAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The footer attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: FooterAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, ...rest } = attrs;\n\n  if (!aria) return rest;\n\n  const mappedAria: NonNullable<GlobalAttrs['aria']> = {};\n\n  if (typeof aria.label === 'string') mappedAria.label = aria.label;\n  if (typeof aria.labelledby === 'string') mappedAria.labelledby = aria.labelledby;\n  if (typeof aria.hidden === 'boolean') mappedAria.hidden = aria.hidden;\n\n  const hasMapped = Object.keys(mappedAria).length > 0;\n\n  return hasMapped ? { ...rest, aria: mappedAria } : rest;\n}\n\n/**\n * Create a footer element with optional text content and global attributes.\n *\n * @remarks\n * - Text content is assigned via `textContent` (never `innerHTML`).\n * - Global attributes are applied via 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 footer.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<footer>` element.\n *\n * @example\n * ```ts\n * import { createFooter } from \"@lnpg/pkgn-sol/elements/layout/footer\";\n *\n * const f = createFooter(\"© 2026\", { className: \"site-footer\" });\n * ```\n *\n * @category DOM\n */\nexport function createFooter(text?: string, attrs?: FooterAttrs): ElementOf<typeof FOOTER_TAG> {\n  return createElement(FOOTER_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance footer elements within a given root.\n *\n * @remarks\n * This is intentionally a no-op in `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 * @param root - The node to search within. Defaults to `document`.\n *\n * @category Enhancement\n */\nexport function enhanceFooters(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for footer.\n  void root;\n}\n"],"mappings":"0MAgEa,EAAa,SAOb,EAAkB,SA4B/B,SAAS,EAAc,EAA8C,CACnE,GAAI,CAAC,EAAO,OAEZ,GAAM,CAAE,OAAM,GAAG,GAAS,EAE1B,GAAI,CAAC,EAAM,OAAO,EAElB,IAAM,EAA+C,EAAE,CAQvD,OANI,OAAO,EAAK,OAAU,WAAU,EAAW,MAAQ,EAAK,OACxD,OAAO,EAAK,YAAe,WAAU,EAAW,WAAa,EAAK,YAClE,OAAO,EAAK,QAAW,YAAW,EAAW,OAAS,EAAK,QAE7C,OAAO,KAAK,EAAW,CAAC,OAAS,EAEhC,CAAE,GAAG,EAAM,KAAM,EAAY,CAAG,EAyBrD,SAAgB,EAAa,EAAe,EAAmD,CAC7F,OAAO,EAAA,EAAc,EAAY,EAAc,EAAM,CAAE,EAAK,CAiB9D,SAAgB,EAAe,EAAmB,SAAgB"}

package/dist/cjs/elements/layout/header/header.cjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../../../chunks/dom.cjs`);var t=e.i({HEADER_SELECTOR:()=>r,HEADER_TAG:()=>n,createHeader:()=>a,enhanceHeaders:()=>o}),n=`header`,r=`header`;function i(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 a(t,r){return e.n(n,i(r),t)}function o(e=document){}exports.HEADER_SELECTOR=r,exports.HEADER_TAG=n,exports.createHeader=a,exports.enhanceHeaders=o,Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return t}});
+//# sourceMappingURL=header.cjs.map

package/dist/cjs/elements/layout/header/header.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"header.cjs","names":[],"sources":["../../../../../src/elements/layout/header/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: Header (`header`) element helpers.\n *\n * @remarks\n * The header element (`<header>`) represents introductory content for its nearest\n * ancestor sectioning root or sectioning content element. It commonly contains a\n * heading (`<h1>`-`<h6>`), branding, navigation aids, or other introductory UI.\n *\n * Best-practice guidance:\n * - Use `<header>` to group introductory content for a page or section.\n * - Prefer meaningful structure (headings, landmarks) over generic containers.\n * - Avoid using `<header>` purely for styling. Use CSS classes for styling and\n *   keep semantics intentional.\n * - A top-level `<header>` (scoped to `<body>` and not inside sectioning content)\n *   may be exposed as a landmark; nested headers typically are not.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create header elements in vanilla JS/TS without templates\n * - apply consistent global attributes safely\n * - use a stable \"enhancement\" hook if 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/Element/header\n * @see https://html.spec.whatwg.org/multipage/sections.html#the-header-element\n *\n * @module\n * @category Elements\n */\n\nimport { createElement, type ElementOf, type GlobalAttrs } from '../../../ts/dom';\n\n/**\n * Structured ARIA input supported by 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 header elements.\n *\n * @category Constants\n */\nexport const HEADER_TAG = 'header' as const;\n\n/**\n * A CSS selector targeting header elements.\n *\n * @category Constants\n */\nexport const HEADER_SELECTOR = 'header';\n\n/**\n * Attribute bag for header creation/enhancement.\n *\n * @remarks\n * `<header>` accepts standard HTML global attributes.\n *\n * 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 HeaderAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link HeaderAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The header attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: HeaderAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, ...rest } = attrs;\n\n  if (!aria) return rest;\n\n  const mappedAria: NonNullable<GlobalAttrs['aria']> = {};\n\n  if (typeof aria.label === 'string') mappedAria.label = aria.label;\n  if (typeof aria.labelledby === 'string') mappedAria.labelledby = aria.labelledby;\n  if (typeof aria.hidden === 'boolean') mappedAria.hidden = aria.hidden;\n\n  // Only attach `aria` if something was actually defined.\n  const hasMapped = Object.keys(mappedAria).length > 0;\n\n  return hasMapped ? { ...rest, aria: mappedAria } : rest;\n}\n\n/**\n * Create a header element with optional text content and global attributes.\n *\n * @remarks\n * - Text content is assigned via `textContent` (never `innerHTML`).\n * - Global attributes are applied via 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 header.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<header>` element.\n *\n * @example\n * Create and append a header:\n * ```ts\n * import { createHeader } from \"@lnpg/pkgn-sol/elements/layout/header\";\n *\n * document.body.prepend(\n *   createHeader(undefined, { className: \"site-header\" })\n * );\n * ```\n *\n * @category DOM\n */\nexport function createHeader(text?: string, attrs?: HeaderAttrs): ElementOf<typeof HEADER_TAG> {\n  return createElement(HEADER_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance header elements within a given root.\n *\n * @remarks\n * This is intentionally a no-op in `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 enhanceHeaders(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for header.\n  void root;\n}\n"],"mappings":"0MAkEa,EAAa,SAOb,EAAkB,SA4B/B,SAAS,EAAc,EAA8C,CACnE,GAAI,CAAC,EAAO,OAEZ,GAAM,CAAE,OAAM,GAAG,GAAS,EAE1B,GAAI,CAAC,EAAM,OAAO,EAElB,IAAM,EAA+C,EAAE,CASvD,OAPI,OAAO,EAAK,OAAU,WAAU,EAAW,MAAQ,EAAK,OACxD,OAAO,EAAK,YAAe,WAAU,EAAW,WAAa,EAAK,YAClE,OAAO,EAAK,QAAW,YAAW,EAAW,OAAS,EAAK,QAG7C,OAAO,KAAK,EAAW,CAAC,OAAS,EAEhC,CAAE,GAAG,EAAM,KAAM,EAAY,CAAG,EA4BrD,SAAgB,EAAa,EAAe,EAAmD,CAC7F,OAAO,EAAA,EAAc,EAAY,EAAc,EAAM,CAAE,EAAK,CAqB9D,SAAgB,EAAe,EAAmB,SAAgB"}

package/dist/cjs/elements/layout/layout.cjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../../chunks/dom.cjs`),t=require(`./article/article.cjs`),n=require(`./aside/aside.cjs`),r=require(`./footer/footer.cjs`),i=require(`./header/header.cjs`),a=require(`./main/main.cjs`),o=require(`./nav/nav.cjs`),s=require(`./section/section.cjs`);var c=e.i({article:()=>t.t,aside:()=>n.t,footer:()=>r.t,header:()=>i.t,main:()=>a.t,nav:()=>o.t,section:()=>s.t});Object.defineProperty(exports,`article`,{enumerable:!0,get:function(){return t.t}}),Object.defineProperty(exports,`aside`,{enumerable:!0,get:function(){return n.t}}),Object.defineProperty(exports,`footer`,{enumerable:!0,get:function(){return r.t}}),Object.defineProperty(exports,`header`,{enumerable:!0,get:function(){return i.t}}),Object.defineProperty(exports,`main`,{enumerable:!0,get:function(){return a.t}}),Object.defineProperty(exports,`nav`,{enumerable:!0,get:function(){return o.t}}),Object.defineProperty(exports,`section`,{enumerable:!0,get:function(){return s.t}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return c}});
+//# sourceMappingURL=layout.cjs.map

package/dist/cjs/elements/layout/layout.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.cjs","names":[],"sources":["../../../../src/elements/layout/index.ts"],"sourcesContent":["/**\n * Layout element factories.\n *\n * Provides framework-agnostic factory functions for HTML elements used to\n * structure the major sections of a document or application.\n *\n * These factories:\n * - Create semantic layout structures using pkgn-sol's hardened DOM helpers.\n * - Forward curated global attributes.\n * - Enforce structured, typed attribute bags.\n * - Preserve correct document outline and accessibility semantics.\n * - Prevent unsafe attribute injection.\n *\n * The elements in this module define the high-level structure of pages,\n * articles, navigation regions, and supporting content.\n *\n * @module elements/layout\n * @since 0.1.0\n */\n\n/**\n * `<article>` element factory namespace.\n *\n * Represents a self-contained composition that can be independently\n * distributed or reused, such as a blog post, news article, or forum entry.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/article\n */\nexport * as article from './article';\n\n/**\n * `<aside>` element factory namespace.\n *\n * Represents content indirectly related to the surrounding content, often\n * presented as a sidebar, pull quote, or complementary section.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/aside\n */\nexport * as aside from './aside';\n\n/**\n * `<footer>` element factory namespace.\n *\n * Represents a footer for its nearest sectioning content or sectioning root,\n * typically containing metadata, copyright information, or related links.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/footer\n */\nexport * as footer from './footer';\n\n/**\n * `<header>` element factory namespace.\n *\n * Represents introductory content or navigational aids for a page or section,\n * often containing headings, logos, or navigation elements.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/header\n */\nexport * as header from './header';\n\n/**\n * `<main>` element factory namespace.\n *\n * Represents the dominant content of the document body. There should only be\n * one `<main>` element per document.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/main\n */\nexport * as main from './main';\n\n/**\n * `<nav>` element factory namespace.\n *\n * Represents a section of the page containing navigation links to other\n * pages or parts of the current page.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/nav\n */\nexport * as nav from './nav';\n\n/**\n * `<section>` element factory namespace.\n *\n * Represents a thematic grouping of content, typically with a heading.\n * Sections contribute to the document outline.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/section\n */\nexport * as section from './section';\n"],"mappings":""}

package/dist/cjs/elements/layout/main/main.cjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../../../chunks/dom.cjs`);var t=e.i({MAIN_SELECTOR:()=>r,MAIN_TAG:()=>n,createMain:()=>a,enhanceMains:()=>o}),n=`main`,r=`main`;function i(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 a(t,r){return e.n(n,i(r),t)}function o(e=document){}exports.MAIN_SELECTOR=r,exports.MAIN_TAG=n,exports.createMain=a,exports.enhanceMains=o,Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return t}});
+//# sourceMappingURL=main.cjs.map

package/dist/cjs/elements/layout/main/main.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.cjs","names":[],"sources":["../../../../../src/elements/layout/main/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: Main element helpers.\n *\n * @remarks\n * The main element (`<main>`) represents the dominant content of the document.\n * It is a landmark element that helps assistive technologies and other tooling\n * identify the primary content area.\n *\n * Best-practice guidance:\n * - Use **only one** `<main>` per document.\n * - The content of `<main>` should be unique to the document (avoid repeated UI\n *   like nav, site chrome, copyright, etc.).\n * - Do not place `<main>` as a descendant of `<article>`, `<aside>`, `<footer>`,\n *   `<header>`, or `<nav>`.\n *\n * Attributes:\n * - `<main>` supports **global attributes only**.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create main landmarks in vanilla JS/TS without templates\n * - apply consistent global attributes safely\n * - use a stable \"enhancement\" hook if 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: Main element (`<main>`)\n *\n * @module\n * @category Elements\n */\n\nimport { createElement, type ElementOf, type GlobalAttrs } from '../../../ts/dom';\n\n/**\n * Structured ARIA input supported by 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 main landmarks.\n *\n * @category Constants\n */\nexport const MAIN_TAG = 'main' as const;\n\n/**\n * A CSS selector targeting main elements.\n *\n * @category Constants\n */\nexport const MAIN_SELECTOR = 'main';\n\n/**\n * Attribute bag for main creation/enhancement.\n *\n * @remarks\n * Main elements accept standard HTML global attributes.\n *\n * 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 MainAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link MainAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The main attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: MainAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, ...rest } = attrs;\n\n  if (!aria) return rest;\n\n  const mappedAria: NonNullable<GlobalAttrs['aria']> = {};\n\n  if (typeof aria.label === 'string') mappedAria.label = aria.label;\n  if (typeof aria.labelledby === 'string') mappedAria.labelledby = aria.labelledby;\n  if (typeof aria.hidden === 'boolean') mappedAria.hidden = aria.hidden;\n\n  // Only attach `aria` if something was actually defined.\n  const hasMapped = Object.keys(mappedAria).length > 0;\n\n  return hasMapped ? { ...rest, aria: mappedAria } : rest;\n}\n\n/**\n * Create a main element with optional text content and global attributes.\n *\n * @remarks\n * - Text content is assigned via `textContent` (never `innerHTML`).\n * - Global attributes are applied via 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 * This helper does not enforce document-level semantics (e.g. \"only one `<main>`\")\n * at runtime. That is a document-authoring responsibility.\n *\n * @param text - Optional text content for the main element.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<main>` element.\n *\n * @example\n * ```ts\n * import { createMain } from \"@lnpg/pkgn-sol/elements/layout/main\";\n *\n * document.body.appendChild(\n *   createMain(undefined, { id: \"content\", className: \"page-main\" })\n * );\n * ```\n *\n * @category DOM\n */\nexport function createMain(text?: string, attrs?: MainAttrs): ElementOf<typeof MAIN_TAG> {\n  return createElement(MAIN_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance main elements within a given root.\n *\n * @remarks\n * This is intentionally a no-op in `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 enhanceMains(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for main.\n  void root;\n}\n"],"mappings":"kMAoEa,EAAW,OAOX,EAAgB,OA4B7B,SAAS,EAAc,EAA4C,CACjE,GAAI,CAAC,EAAO,OAEZ,GAAM,CAAE,OAAM,GAAG,GAAS,EAE1B,GAAI,CAAC,EAAM,OAAO,EAElB,IAAM,EAA+C,EAAE,CASvD,OAPI,OAAO,EAAK,OAAU,WAAU,EAAW,MAAQ,EAAK,OACxD,OAAO,EAAK,YAAe,WAAU,EAAW,WAAa,EAAK,YAClE,OAAO,EAAK,QAAW,YAAW,EAAW,OAAS,EAAK,QAG7C,OAAO,KAAK,EAAW,CAAC,OAAS,EAEhC,CAAE,GAAG,EAAM,KAAM,EAAY,CAAG,EA8BrD,SAAgB,EAAW,EAAe,EAA+C,CACvF,OAAO,EAAA,EAAc,EAAU,EAAc,EAAM,CAAE,EAAK,CAqB5D,SAAgB,EAAa,EAAmB,SAAgB"}

package/dist/cjs/elements/layout/nav/nav.cjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../../../chunks/dom.cjs`);var t=e.i({NAV_SELECTOR:()=>`nav`,NAV_TAG:()=>`nav`,createNav:()=>a,enhanceNavs:()=>o}),n=`nav`,r=`nav`;function i(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 a(t,n){return e.n(`nav`,i(n),t)}function o(e=document){}exports.NAV_SELECTOR=r,exports.NAV_TAG=n,exports.createNav=a,exports.enhanceNavs=o,Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return t}});
+//# sourceMappingURL=nav.cjs.map

package/dist/cjs/elements/layout/nav/nav.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav.cjs","names":[],"sources":["../../../../../src/elements/layout/nav/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: Nav element helpers.\n *\n * @remarks\n * The nav element (`<nav>`) represents a section of a page whose purpose is to\n * provide navigation links.\n *\n * Best-practice guidance:\n * - Use `<nav>` for major navigation blocks (site navigation, table of contents).\n * - If a page has multiple navigation regions, provide an accessible name via\n *   `aria-label` or `aria-labelledby` so assistive tech can distinguish them.\n * - Avoid nesting `<nav>` elements.\n * - Prefer semantic grouping of links (e.g. lists) inside the nav.\n *\n * pkgn-sol provides small, framework-agnostic helpers so consumers can:\n * - create navigation regions without templates\n * - apply consistent global attributes safely\n * - use a stable \"enhancement\" hook if 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/Element/nav\n * @see https://html.spec.whatwg.org/multipage/sections.html#the-nav-element\n *\n * @module\n * @category Elements\n */\n\nimport { createElement, type ElementOf, type GlobalAttrs } from '../../../ts/dom';\n\n/**\n * Structured ARIA input supported by pkgn-sol element factories.\n *\n * @remarks\n * `<nav>` is a landmark with an implicit `navigation` role.\n *\n * pkgn-sol intentionally encourages naming navigation regions when multiple navs\n * exist on the same page (e.g. primary vs footer vs breadcrumb navigation).\n *\n * It is mapped into {@link GlobalAttrs.aria} for application by `dom.ts`.\n *\n * @category Attributes\n */\nexport type StructuredAria = {\n  /**\n   * Accessible label, mapped to `aria-label`.\n   */\n  label?: string;\n\n  /**\n   * ID reference to the labelling element(s), mapped to `aria-labelledby`.\n   */\n  labelledby?: string;\n\n  /**\n   * Decorative/hidden hint, mapped to `aria-hidden`.\n   */\n  hidden?: boolean;\n};\n\n/**\n * The semantic tag name for nav.\n *\n * @category Constants\n */\nexport const NAV_TAG = 'nav' as const;\n\n/**\n * A CSS selector targeting nav elements.\n *\n * @category Constants\n */\nexport const NAV_SELECTOR = 'nav';\n\n/**\n * Attribute bag for nav creation/enhancement.\n *\n * @remarks\n * Nav elements accept standard HTML global attributes.\n *\n * Accessibility note:\n * - `<nav>` has an implicit landmark role.\n * - The ARIA-in-HTML mapping indicates no explicit `role` is permitted for\n *   `<nav>` in normal usage. pkgn-sol therefore omits `role` from {@link NavAttrs}.\n *   Name navs via `aria-label` / `aria-labelledby` instead.\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 NavAttrs = Omit<GlobalAttrs, 'aria' | 'role'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link NavAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The nav attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: NavAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, ...rest } = attrs;\n\n  if (!aria) return rest;\n\n  const mappedAria: NonNullable<GlobalAttrs['aria']> = {};\n\n  if (typeof aria.label === 'string') mappedAria.label = aria.label;\n  if (typeof aria.labelledby === 'string') mappedAria.labelledby = aria.labelledby;\n  if (typeof aria.hidden === 'boolean') mappedAria.hidden = aria.hidden;\n\n  // Only attach `aria` if something was actually defined.\n  const hasMapped = Object.keys(mappedAria).length > 0;\n\n  return hasMapped ? { ...rest, aria: mappedAria } : rest;\n}\n\n/**\n * Create a nav element with optional text content and global attributes.\n *\n * @remarks\n * - Text content is assigned via `textContent` (never `innerHTML`).\n * - Global attributes are applied via 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 nav.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<nav>` element.\n *\n * @example\n * Create a labelled primary navigation region:\n * ```ts\n * import { createNav } from \"@lnpg/pkgn-sol/elements/layout/nav\";\n *\n * const nav = createNav(undefined, { aria: { label: \"Primary\" }, className: \"site-nav\" });\n * document.body.appendChild(nav);\n * ```\n *\n * @category DOM\n */\nexport function createNav(text?: string, attrs?: NavAttrs): ElementOf<typeof NAV_TAG> {\n  return createElement(NAV_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance nav elements within a given root.\n *\n * @remarks\n * This is intentionally a no-op in `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 enhanceNavs(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for nav.\n  void root;\n}\n"],"mappings":"sMAkEa,EAAU,MAOV,EAAe,MAkC5B,SAAS,EAAc,EAA2C,CAChE,GAAI,CAAC,EAAO,OAEZ,GAAM,CAAE,OAAM,GAAG,GAAS,EAE1B,GAAI,CAAC,EAAM,OAAO,EAElB,IAAM,EAA+C,EAAE,CASvD,OAPI,OAAO,EAAK,OAAU,WAAU,EAAW,MAAQ,EAAK,OACxD,OAAO,EAAK,YAAe,WAAU,EAAW,WAAa,EAAK,YAClE,OAAO,EAAK,QAAW,YAAW,EAAW,OAAS,EAAK,QAG7C,OAAO,KAAK,EAAW,CAAC,OAAS,EAEhC,CAAE,GAAG,EAAM,KAAM,EAAY,CAAG,EA2BrD,SAAgB,EAAU,EAAe,EAA6C,CACpF,OAAO,EAAA,EAAA,MAAuB,EAAc,EAAM,CAAE,EAAK,CAqB3D,SAAgB,EAAY,EAAmB,SAAgB"}

package/dist/cjs/elements/layout/section/section.cjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../../../chunks/dom.cjs`);var t=e.i({SECTION_SELECTOR:()=>r,SECTION_TAG:()=>n,createSection:()=>a,enhanceSections:()=>o}),n=`section`,r=`section`;function i(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 a(t,r){return e.n(n,i(r),t)}function o(e=document){}exports.SECTION_SELECTOR=r,exports.SECTION_TAG=n,exports.createSection=a,exports.enhanceSections=o,Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return t}});
+//# sourceMappingURL=section.cjs.map

package/dist/cjs/elements/layout/section/section.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"section.cjs","names":[],"sources":["../../../../../src/elements/layout/section/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: Section element helpers.\n *\n * @remarks\n * The section element (`<section>`) represents a standalone thematic grouping of\n * content, typically with a heading.\n *\n * Best-practice guidance:\n * - Do not treat `<section>` as a \"semantic `<div>`\". Use it when the content is a\n *   distinct theme that belongs in the document outline.\n * - Prefer including a heading (`<h1>`-`<h6>`) that describes the section's purpose.\n * - If you just need a generic container with no semantic meaning, use `<div>`.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create sections in vanilla JS/TS without templates\n * - apply consistent global attributes safely\n * - use a stable \"enhancement\" hook if 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/section\n * - HTML Standard: https://html.spec.whatwg.org/multipage/sections.html#the-section-element\n * - WHATWG blog (context): https://blog.whatwg.org/is-not-just-a-semantic\n *\n * @module\n * @category Elements\n */\n\nimport { createElement, type ElementOf, type GlobalAttrs } from '../../../ts/dom';\n\n/**\n * Structured ARIA input supported by 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 section elements.\n *\n * @category Constants\n */\nexport const SECTION_TAG = 'section' as const;\n\n/**\n * A CSS selector targeting section elements.\n *\n * @category Constants\n */\nexport const SECTION_SELECTOR = 'section';\n\n/**\n * Attribute bag for section creation/enhancement.\n *\n * @remarks\n * Section elements accept standard HTML global attributes.\n *\n * 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 SectionAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link SectionAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The section attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: SectionAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, ...rest } = attrs;\n\n  if (!aria) return rest;\n\n  const mappedAria: NonNullable<GlobalAttrs['aria']> = {};\n\n  if (typeof aria.label === 'string') mappedAria.label = aria.label;\n  if (typeof aria.labelledby === 'string') mappedAria.labelledby = aria.labelledby;\n  if (typeof aria.hidden === 'boolean') mappedAria.hidden = aria.hidden;\n\n  // Only attach `aria` if something was actually defined.\n  const hasMapped = Object.keys(mappedAria).length > 0;\n\n  return hasMapped ? { ...rest, aria: mappedAria } : rest;\n}\n\n/**\n * Create a section element with optional text content and global attributes.\n *\n * @remarks\n * - Text content is assigned via `textContent` (never `innerHTML`).\n * - Global attributes are applied via 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 section.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<section>` element.\n *\n * @example\n * ```ts\n * import { createSection } from \"@lnpg/pkgn-sol/elements/layout/section\";\n *\n * const s = createSection(undefined, { id: \"features\" });\n * document.body.appendChild(s);\n * ```\n *\n * @category DOM\n */\nexport function createSection(text?: string, attrs?: SectionAttrs): ElementOf<typeof SECTION_TAG> {\n  return createElement(SECTION_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance section elements within a given root.\n *\n * @remarks\n * This is intentionally a no-op in `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 enhanceSections(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for section.\n  void root;\n}\n"],"mappings":"8MAiEa,EAAc,UAOd,EAAmB,UA4BhC,SAAS,EAAc,EAA+C,CACpE,GAAI,CAAC,EAAO,OAEZ,GAAM,CAAE,OAAM,GAAG,GAAS,EAE1B,GAAI,CAAC,EAAM,OAAO,EAElB,IAAM,EAA+C,EAAE,CASvD,OAPI,OAAO,EAAK,OAAU,WAAU,EAAW,MAAQ,EAAK,OACxD,OAAO,EAAK,YAAe,WAAU,EAAW,WAAa,EAAK,YAClE,OAAO,EAAK,QAAW,YAAW,EAAW,OAAS,EAAK,QAG7C,OAAO,KAAK,EAAW,CAAC,OAAS,EAEhC,CAAE,GAAG,EAAM,KAAM,EAAY,CAAG,EA0BrD,SAAgB,EAAc,EAAe,EAAqD,CAChG,OAAO,EAAA,EAAc,EAAa,EAAc,EAAM,CAAE,EAAK,CAqB/D,SAAgB,EAAgB,EAAmB,SAAgB"}

package/dist/cjs/elements/list/dd/dd.cjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../../../chunks/dom.cjs`);var t=e.i({DD_SELECTOR:()=>`dd`,DD_TAG:()=>`dd`,createDd:()=>a,enhanceDds:()=>o}),n=`dd`,r=`dd`;function i(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 a(t,n){return e.n(`dd`,i(n),t)}function o(e=document){}exports.DD_SELECTOR=r,exports.DD_TAG=n,exports.createDd=a,exports.enhanceDds=o,Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return t}});
+//# sourceMappingURL=dd.cjs.map

package/dist/cjs/elements/list/dd/dd.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dd.cjs","names":[],"sources":["../../../../../src/elements/list/dd/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: Description Details (`<dd>`) element helpers.\n *\n * @remarks\n * The `<dd>` element provides the description, definition, or value for the\n * preceding term (`<dt>`) within a description list (`<dl>`).\n *\n * Best-practice guidance:\n * - Use `<dd>` only within a `<dl>`.\n * - Pair `<dd>` with an appropriate `<dt>` term.\n * - Use semantic lists for terms/values, not for layout.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create `<dd>` elements in vanilla JS/TS without templates\n * - apply consistent global attributes safely\n * - pass a structured, typed attribute bag\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/dd\n * @see https://html.spec.whatwg.org/multipage/grouping-content.html#the-dd-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.\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 dd.\n *\n * @category Constants\n */\nexport const DD_TAG = 'dd' as const;\n\n/**\n * A CSS selector targeting dd elements.\n *\n * @category Constants\n */\nexport const DD_SELECTOR = 'dd';\n\n/**\n * Attribute bag for dd creation/enhancement.\n *\n * @remarks\n * `<dd>` only supports 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 DdAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link DdAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The dd attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: DdAttrs): 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 dd 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 dd element.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<dd>` element.\n *\n * @example\n * ```ts\n * import { createDd } from \"@lnpg/pkgn-sol/elements/list/dd\";\n *\n * const dd = createDd(\"A sea serpent.\", { className: \"desc\" });\n * ```\n *\n * @category DOM\n */\nexport function createDd(text?: string, attrs?: DdAttrs): ElementOf<typeof DD_TAG> {\n  return createElement(DD_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance dd 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 * @param root - The node to search within. Defaults to `document`.\n *\n * @category Enhancement\n */\nexport function enhanceDds(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for dd.\n  void root;\n}\n"],"mappings":"gMA8Da,EAAS,KAOT,EAAc,KA4B3B,SAAS,EAAc,EAA0C,CAC/D,GAAI,CAAC,EAAO,OAEZ,GAAM,CAAE,OAAM,GAAG,GAAS,EAE1B,GAAI,CAAC,EAAM,OAAO,EAElB,IAAM,EAA+C,EAAE,CAQvD,OANI,OAAO,EAAK,OAAU,WAAU,EAAW,MAAQ,EAAK,OACxD,OAAO,EAAK,YAAe,WAAU,EAAW,WAAa,EAAK,YAClE,OAAO,EAAK,QAAW,YAAW,EAAW,OAAS,EAAK,QAE7C,OAAO,KAAK,EAAW,CAAC,OAAS,EAEhC,CAAE,GAAG,EAAM,KAAM,EAAY,CAAG,EAyBrD,SAAgB,EAAS,EAAe,EAA2C,CACjF,OAAO,EAAA,EAAA,KAAsB,EAAc,EAAM,CAAE,EAAK,CAiB1D,SAAgB,EAAW,EAAmB,SAAgB"}

package/dist/cjs/elements/list/dl/dl.cjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../../../chunks/dom.cjs`);var t=e.i({DL_SELECTOR:()=>`dl`,DL_TAG:()=>`dl`,createDl:()=>a,enhanceDls:()=>o}),n=`dl`,r=`dl`;function i(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 a(t,n){return e.n(`dl`,i(n),t)}function o(e=document){}exports.DL_SELECTOR=r,exports.DL_TAG=n,exports.createDl=a,exports.enhanceDls=o,Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return t}});
+//# sourceMappingURL=dl.cjs.map

package/dist/cjs/elements/list/dl/dl.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dl.cjs","names":[],"sources":["../../../../../src/elements/list/dl/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: Dl element helpers.\n *\n * @remarks\n * The dl element (`<dl>`) represents a description list (a set of name-value groups).\n * It is commonly used with `<dt>` (term/name) and `<dd>` (description/value).\n *\n * Best-practice guidance:\n * - Prefer `<dl>` when you're expressing name-value pairs (not just \"a list\").\n * - Use `<dt>` / `<dd>` in sensible groupings to keep meaning clear.\n * - Avoid misusing `<dl>` for layout or arbitrary indentation; use CSS instead.\n *\n * Attributes:\n * - `<dl>` has no element-specific attributes in modern HTML.\n * - It accepts standard global attributes (id, class, lang, data-*, aria-*, etc.).\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create `<dl>` 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 description lists.\n *\n * @category Constants\n */\nexport const DL_TAG = 'dl' as const;\n\n/**\n * A CSS selector targeting dl elements.\n *\n * @category Constants\n */\nexport const DL_SELECTOR = 'dl';\n\n/**\n * Attribute bag for dl creation/enhancement.\n *\n * @remarks\n * Dl 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 DlAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link DlAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The dl attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: DlAttrs): 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 dl element with optional text content and global attributes.\n *\n * @remarks\n * - Text content is assigned via `textContent` (never `innerHTML`).\n * - In real usage, `<dl>` typically contains `<dt>` / `<dd>` children; pkgn-sol keeps\n *   factories small and safe, so this helper supports optional text as a simple\n *   convenience, not as a replacement for proper `<dt>` / `<dd>` structure.\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 dl.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<dl>` element.\n *\n * @example\n * Create and append a dl:\n * ```ts\n * import { createDl } from \"@lnpg/pkgn-sol/elements/list/dl\";\n *\n * document.body.appendChild(\n *   createDl(undefined, { className: \"meta\", id: \"product-specs\" })\n * );\n * ```\n *\n * @category DOM\n */\nexport function createDl(text?: string, attrs?: DlAttrs): ElementOf<typeof DL_TAG> {\n  return createElement(DL_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance dl 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 enhanceDls(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for dl.\n  void root;\n}\n"],"mappings":"gMA+Da,EAAS,KAOT,EAAc,KA4B3B,SAAS,EAAc,EAA0C,CAC/D,GAAI,CAAC,EAAO,OAEZ,GAAM,CAAE,OAAM,GAAG,GAAS,EAE1B,GAAI,CAAC,EAAM,OAAO,EAElB,IAAM,EAA+C,EAAE,CASvD,OAPI,OAAO,EAAK,OAAU,WAAU,EAAW,MAAQ,EAAK,OACxD,OAAO,EAAK,YAAe,WAAU,EAAW,WAAa,EAAK,YAClE,OAAO,EAAK,QAAW,YAAW,EAAW,OAAS,EAAK,QAG7C,OAAO,KAAK,EAAW,CAAC,OAAS,EAEhC,CAAE,GAAG,EAAM,KAAM,EAAY,CAAG,EA+BrD,SAAgB,EAAS,EAAe,EAA2C,CACjF,OAAO,EAAA,EAAA,KAAsB,EAAc,EAAM,CAAE,EAAK,CAqB1D,SAAgB,EAAW,EAAmB,SAAgB"}

package/dist/cjs/elements/list/dt/dt.cjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../../../chunks/dom.cjs`);var t=e.i({DT_SELECTOR:()=>`dt`,DT_TAG:()=>`dt`,createDt:()=>a,enhanceDts:()=>o}),n=`dt`,r=`dt`;function i(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 a(t,n){return e.n(`dt`,i(n),t)}function o(e=document){}exports.DT_SELECTOR=r,exports.DT_TAG=n,exports.createDt=a,exports.enhanceDts=o,Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return t}});
+//# sourceMappingURL=dt.cjs.map

package/dist/cjs/elements/list/dt/dt.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dt.cjs","names":[],"sources":["../../../../../src/elements/list/dt/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: Dt element helpers.\n *\n * @remarks\n * The dt element (`<dt>`) represents a definition term in a description list (`<dl>`).\n * It is typically paired with one or more `<dd>` elements (the descriptions/details).\n *\n * Best-practice guidance:\n * - Use `<dl>` + `<dt>` + `<dd>` for name/value groups (terms and descriptions),\n *   not for arbitrary layout or \"two-column\" grids.\n * - Keep terms concise; put the detail/content in `<dd>`.\n * - Use CSS for presentation (avoid presentational patterns that change semantics).\n *\n * Attributes:\n * - `<dt>` supports only global attributes (no element-specific attributes).\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create dt 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 * @see MDN `<dt>`: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/dt\n * @see WHATWG HTML `<dt>`: https://html.spec.whatwg.org/multipage/grouping-content.html#the-dt-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.\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 dt elements.\n *\n * @category Constants\n */\nexport const DT_TAG = 'dt' as const;\n\n/**\n * A CSS selector targeting dt elements.\n *\n * @category Constants\n */\nexport const DT_SELECTOR = 'dt';\n\n/**\n * Attribute bag for dt creation/enhancement.\n *\n * @remarks\n * Dt 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 DtAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link DtAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The dt attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: DtAttrs): 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 dt 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 dt.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<dt>` element.\n *\n * @example\n * ```ts\n * import { createDt } from \"@lnpg/pkgn-sol/elements/list/dt\";\n *\n * const dl = document.createElement(\"dl\");\n * dl.appendChild(createDt(\"Size\"));\n * ```\n *\n * @category DOM\n */\nexport function createDt(text?: string, attrs?: DtAttrs): ElementOf<typeof DT_TAG> {\n  return createElement(DT_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance dt 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 enhanceDts(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for dt.\n  void root;\n}\n"],"mappings":"gMA+Da,EAAS,KAOT,EAAc,KA4B3B,SAAS,EAAc,EAA0C,CAC/D,GAAI,CAAC,EAAO,OAEZ,GAAM,CAAE,OAAM,GAAG,GAAS,EAE1B,GAAI,CAAC,EAAM,OAAO,EAElB,IAAM,EAA+C,EAAE,CASvD,OAPI,OAAO,EAAK,OAAU,WAAU,EAAW,MAAQ,EAAK,OACxD,OAAO,EAAK,YAAe,WAAU,EAAW,WAAa,EAAK,YAClE,OAAO,EAAK,QAAW,YAAW,EAAW,OAAS,EAAK,QAG7C,OAAO,KAAK,EAAW,CAAC,OAAS,EAEhC,CAAE,GAAG,EAAM,KAAM,EAAY,CAAG,EA0BrD,SAAgB,EAAS,EAAe,EAA2C,CACjF,OAAO,EAAA,EAAA,KAAsB,EAAc,EAAM,CAAE,EAAK,CAqB1D,SAAgB,EAAW,EAAmB,SAAgB"}

package/dist/cjs/elements/list/li/li.cjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../../../chunks/dom.cjs`);var t=e.i({LI_SELECTOR:()=>`li`,LI_TAG:()=>`li`,createLi:()=>a,enhanceLis:()=>o}),n=`li`,r=`li`;function i(e){if(!e)return;let{aria:t,type:n,attrs:r,value:i,...a}=e,o={...a};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&&(o.aria=e)}let s={...r??{}};return typeof n==`string`&&n.length>0&&(s.type=n),Object.keys(s).length>0&&(o.attrs=s),o}function a(t,n){let r=e.n(`li`,i(n),t);return n&&typeof n.value==`number`&&Number.isFinite(n.value)&&(r.value=n.value),r}function o(e=document){}exports.LI_SELECTOR=r,exports.LI_TAG=n,exports.createLi=a,exports.enhanceLis=o,Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return t}});
+//# sourceMappingURL=li.cjs.map

package/dist/cjs/elements/list/li/li.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"li.cjs","names":[],"sources":["../../../../../src/elements/list/li/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: Li element helpers.\n *\n * @remarks\n * The list item element (`<li>`) represents an item in a list.\n *\n * Best-practice guidance:\n * - Use `<li>` only as a direct child of a list container (`<ul>`, `<ol>`, `<menu>`).\n * - Prefer semantic list structure over styling hacks.\n * - For ordered lists, use the `value` attribute/property to control numbering when needed\n *   (e.g. continuing a sequence after inserted items).\n * - Avoid the legacy `type` attribute where possible; prefer list-level semantics and CSS.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create `<li>` elements in vanilla JS/TS without templates\n * - apply consistent global attributes safely\n * - supply typed element-specific fields like `value`\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.\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 * Legacy marker type options for list items.\n *\n * @remarks\n * The `type` attribute on `<li>` is legacy and should be avoided when possible.\n * It is retained here for compatibility scenarios.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/li\n *\n * @category Attributes\n */\nexport type LiMarkerType = '1' | 'a' | 'A' | 'i' | 'I';\n\n/**\n * The semantic tag name for list items.\n *\n * @category Constants\n */\nexport const LI_TAG = 'li' as const;\n\n/**\n * A CSS selector targeting list item elements.\n *\n * @category Constants\n */\nexport const LI_SELECTOR = 'li';\n\n/**\n * Attribute bag for li creation/enhancement.\n *\n * @remarks\n * In addition to global attributes, `<li>` supports:\n * - `value` (primarily for `<ol>` numbering control)\n * - legacy `type` marker hint (deprecated)\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/li\n *\n * @category Attributes\n */\nexport type LiAttrs = Omit<GlobalAttrs, 'aria' | 'attrs'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n\n  /**\n   * Ordinal value for ordered lists.\n   *\n   * @remarks\n   * When used within an `<ol>`, this sets the list item's numbering value.\n   * This is modeled as a number and applied via the `HTMLLIElement.value` property.\n   */\n  value?: number;\n\n  /**\n   * Legacy marker type hint (deprecated).\n   *\n   * @remarks\n   * Prefer list semantics and CSS. Retained for compatibility.\n   */\n  type?: LiMarkerType;\n\n  /**\n   * Additional attributes not modeled above.\n   *\n   * @remarks\n   * This exists as an escape hatch while still allowing pkgn-sol to apply its\n   * attribute safety rules via `dom.ts`.\n   */\n  attrs?: GlobalAttrs['attrs'];\n};\n\n/**\n * Normalize {@link LiAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The li attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: LiAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, type, attrs: extraAttrs, value: _value, ...rest } = attrs;\n\n  const mapped: GlobalAttrs = { ...rest };\n\n  // Map structured aria.\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) mapped.aria = mappedAria;\n  }\n\n  // Merge extra attrs and map legacy `type` through the hardened attrs path.\n  const mergedAttrs: NonNullable<GlobalAttrs['attrs']> = { ...(extraAttrs ?? {}) };\n  if (typeof type === 'string' && type.length > 0) mergedAttrs.type = type;\n\n  if (Object.keys(mergedAttrs).length > 0) mapped.attrs = mergedAttrs;\n\n  return mapped;\n}\n\n/**\n * Create a list item 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 * - The `value` field is applied via the `HTMLLIElement.value` property for correct behavior.\n *\n * @param text - Optional text content for the list item.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<li>` element.\n *\n * @example\n * ```ts\n * import { createLi } from \"@lnpg/pkgn-sol/elements/list/li\";\n *\n * const li = createLi(\"Item 3\", { value: 3 });\n * ```\n *\n * @category DOM\n */\nexport function createLi(text?: string, attrs?: LiAttrs): ElementOf<typeof LI_TAG> {\n  const el = createElement(LI_TAG, toGlobalAttrs(attrs), text);\n\n  // Apply ordered-list numbering via the DOM property.\n  if (attrs && typeof attrs.value === 'number' && Number.isFinite(attrs.value)) {\n    (el as unknown as HTMLLIElement).value = attrs.value;\n  }\n\n  return el;\n}\n\n/**\n * Enhance list item 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 * @param root - The node to search within. Defaults to `document`.\n *\n * @category Enhancement\n */\nexport function enhanceLis(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for li.\n  void root;\n}\n"],"mappings":"gMAyEa,EAAS,KAOT,EAAc,KAuD3B,SAAS,EAAc,EAA0C,CAC/D,GAAI,CAAC,EAAO,OAEZ,GAAM,CAAE,OAAM,OAAM,MAAO,EAAY,MAAO,EAAQ,GAAG,GAAS,EAE5D,EAAsB,CAAE,GAAG,EAAM,CAGvC,GAAI,EAAM,CACR,IAAM,EAA+C,EAAE,CACnD,OAAO,EAAK,OAAU,WAAU,EAAW,MAAQ,EAAK,OACxD,OAAO,EAAK,YAAe,WAAU,EAAW,WAAa,EAAK,YAClE,OAAO,EAAK,QAAW,YAAW,EAAW,OAAS,EAAK,QAE3D,OAAO,KAAK,EAAW,CAAC,OAAS,IAAG,EAAO,KAAO,GAIxD,IAAM,EAAiD,CAAE,GAAI,GAAc,EAAE,CAAG,CAKhF,OAJI,OAAO,GAAS,UAAY,EAAK,OAAS,IAAG,EAAY,KAAO,GAEhE,OAAO,KAAK,EAAY,CAAC,OAAS,IAAG,EAAO,MAAQ,GAEjD,EA0BT,SAAgB,EAAS,EAAe,EAA2C,CACjF,IAAM,EAAK,EAAA,EAAA,KAAsB,EAAc,EAAM,CAAE,EAAK,CAO5D,OAJI,GAAS,OAAO,EAAM,OAAU,UAAY,OAAO,SAAS,EAAM,MAAM,GAC1E,EAAiC,MAAQ,EAAM,OAG1C,EAiBT,SAAgB,EAAW,EAAmB,SAAgB"}

package/dist/cjs/elements/list/list.cjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../../chunks/dom.cjs`),t=require(`./dd/dd.cjs`),n=require(`./dl/dl.cjs`),r=require(`./dt/dt.cjs`),i=require(`./li/li.cjs`),a=require(`./ol/ol.cjs`),o=require(`./ul/ul.cjs`);var s=e.i({dd:()=>t.t,dl:()=>n.t,dt:()=>r.t,li:()=>i.t,ol:()=>a.t,ul:()=>o.t});Object.defineProperty(exports,`dd`,{enumerable:!0,get:function(){return t.t}}),Object.defineProperty(exports,`dl`,{enumerable:!0,get:function(){return n.t}}),Object.defineProperty(exports,`dt`,{enumerable:!0,get:function(){return r.t}}),Object.defineProperty(exports,`li`,{enumerable:!0,get:function(){return i.t}}),Object.defineProperty(exports,`ol`,{enumerable:!0,get:function(){return a.t}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return s}}),Object.defineProperty(exports,`ul`,{enumerable:!0,get:function(){return o.t}});
+//# sourceMappingURL=list.cjs.map

package/dist/cjs/elements/list/list.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.cjs","names":[],"sources":["../../../../src/elements/list/index.ts"],"sourcesContent":["/**\n * List element factories.\n *\n * Provides framework-agnostic factory functions for HTML list and list-related\n * elements used to express collections of items and term/description pairs.\n *\n * These factories:\n * - Create list elements using pkgn-sol's hardened DOM helpers.\n * - Forward curated global attributes.\n * - Enforce structured, typed attribute bags.\n * - Encourage accessible, standards-aligned markup.\n * - Prevent unsafe attribute injection.\n *\n * List elements are the backbone of navigations, feature lists, checklists, and\n * definition/description content, while preserving semantic meaning for assistive\n * technologies.\n *\n * @module elements/list\n * @since 0.1.0\n */\n\n/**\n * `<dd>` element factory namespace.\n *\n * Represents the description/details/value for a term in a description list (`<dl>`).\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/dd\n */\nexport * as dd from './dd';\n\n/**\n * `<dl>` element factory namespace.\n *\n * Represents a description list (name-value groups), containing `<dt>` and `<dd>`.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/dl\n */\nexport * as dl from './dl';\n\n/**\n * `<dt>` element factory namespace.\n *\n * Represents a term/name in a description list (`<dl>`).\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/dt\n */\nexport * as dt from './dt';\n\n/**\n * `<li>` element factory namespace.\n *\n * Represents a list item inside `<ul>`, `<ol>`, or `<menu>`.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/li\n */\nexport * as li from './li';\n\n/**\n * `<ol>` element factory namespace.\n *\n * Represents an ordered list where item order is meaningful.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/ol\n */\nexport * as ol from './ol';\n\n/**\n * `<ul>` element factory namespace.\n *\n * Represents an unordered list where item order is not meaningful.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/ul\n */\nexport * as ul from './ul';\n"],"mappings":""}

package/dist/cjs/elements/list/ol/ol.cjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../../../chunks/dom.cjs`);var t=e.i({OL_SELECTOR:()=>`ol`,OL_TAG:()=>`ol`,createOl:()=>a,enhanceOls:()=>o}),n=`ol`,r=`ol`;function i(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 a(t){let n=e.n(`ol`,i(t)),r=n;return t&&(typeof t.reversed==`boolean`&&(r.reversed=t.reversed),typeof t.start==`number`&&Number.isFinite(t.start)&&(r.start=t.start),typeof t.type==`string`&&(r.type=t.type)),n}function o(e=document){}exports.OL_SELECTOR=r,exports.OL_TAG=n,exports.createOl=a,exports.enhanceOls=o,Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return t}});
+//# sourceMappingURL=ol.cjs.map

package/dist/cjs/elements/list/ol/ol.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ol.cjs","names":[],"sources":["../../../../../src/elements/list/ol/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: Ordered list element helpers.\n *\n * @remarks\n * The ordered list element (`<ol>`) represents an ordered list of items.\n *\n * Best-practice guidance:\n * - Prefer `<ol>` when the order of items matters (steps, rankings, sequences).\n * - List items should be `<li>` elements (direct children).\n * - Avoid presentational attributes when possible; prefer CSS for styling.\n * - Use `start`/`reversed` only when semantics require non-default numbering.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create ordered lists 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.\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 ordered lists.\n *\n * @category Constants\n */\nexport const OL_TAG = 'ol' as const;\n\n/**\n * A CSS selector targeting ordered list elements.\n *\n * @category Constants\n */\nexport const OL_SELECTOR = 'ol';\n\n/**\n * Allowed values for the `<ol>` `type` attribute.\n *\n * @remarks\n * While `type` is still supported by browsers, it is presentational and CSS is\n * often preferable.\n *\n * - `1`  Decimal numbers (default)\n * - `a`  Lowercase letters\n * - `A`  Uppercase letters\n * - `i`  Lowercase Roman numerals\n * - `I`  Uppercase Roman numerals\n *\n * @category Attributes\n */\nexport type OlType = '1' | 'a' | 'A' | 'i' | 'I';\n\n/**\n * Attribute bag for ordered list creation/enhancement.\n *\n * @remarks\n * Ordered lists accept HTML global attributes and a small set of specific\n * attributes:\n * - `reversed` for descending numbering\n * - `start` to set the initial counter value\n * - `type` to choose the marker style (often better via CSS)\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 OlAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Whether numbering should be descending.\n   */\n  reversed?: boolean;\n\n  /**\n   * Starting value for the list counter.\n   */\n  start?: number;\n\n  /**\n   * Marker type for list items.\n   */\n  type?: OlType;\n\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link OlAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The ordered list attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: OlAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, ...rest } = attrs;\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  return hasMapped ? { ...rest, aria: mappedAria } : rest;\n}\n\n/**\n * Create an ordered list element with global and list-specific attributes.\n *\n * @remarks\n * This helper intentionally does not accept raw HTML. Consumers should append\n * `<li>` children using DOM APIs.\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 `<ol>` element.\n *\n * @example\n * ```ts\n * import { createOl } from \"@lnpg/pkgn-sol/elements/list/ol\";\n *\n * const ol = createOl({ start: 3, reversed: true, className: \"steps\" });\n * document.body.appendChild(ol);\n * ```\n *\n * @category DOM\n */\nexport function createOl(attrs?: OlAttrs): ElementOf<typeof OL_TAG> {\n  const el = createElement(OL_TAG, toGlobalAttrs(attrs));\n  const ol = el as unknown as HTMLOListElement;\n\n  if (attrs) {\n    if (typeof attrs.reversed === 'boolean') ol.reversed = attrs.reversed;\n    if (typeof attrs.start === 'number' && Number.isFinite(attrs.start)) ol.start = attrs.start;\n    if (typeof attrs.type === 'string') ol.type = attrs.type;\n  }\n\n  return el;\n}\n\n/**\n * Enhance ordered list 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 enhanceOls(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for ol.\n  void root;\n}\n"],"mappings":"gMA2Da,EAAS,KAOT,EAAc,KAgE3B,SAAS,EAAc,EAA0C,CAC/D,GAAI,CAAC,EAAO,OAEZ,GAAM,CAAE,OAAM,GAAG,GAAS,EAC1B,GAAI,CAAC,EAAM,OAAO,EAElB,IAAM,EAA+C,EAAE,CAOvD,OALI,OAAO,EAAK,OAAU,WAAU,EAAW,MAAQ,EAAK,OACxD,OAAO,EAAK,YAAe,WAAU,EAAW,WAAa,EAAK,YAClE,OAAO,EAAK,QAAW,YAAW,EAAW,OAAS,EAAK,QAE7C,OAAO,KAAK,EAAW,CAAC,OAAS,EAChC,CAAE,GAAG,EAAM,KAAM,EAAY,CAAG,EA2BrD,SAAgB,EAAS,EAA2C,CAClE,IAAM,EAAK,EAAA,EAAA,KAAsB,EAAc,EAAM,CAAC,CAChD,EAAK,EAQX,OANI,IACE,OAAO,EAAM,UAAa,YAAW,EAAG,SAAW,EAAM,UACzD,OAAO,EAAM,OAAU,UAAY,OAAO,SAAS,EAAM,MAAM,GAAE,EAAG,MAAQ,EAAM,OAClF,OAAO,EAAM,MAAS,WAAU,EAAG,KAAO,EAAM,OAG/C,EAqBT,SAAgB,EAAW,EAAmB,SAAgB"}

package/dist/cjs/elements/list/ul/ul.cjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../../../chunks/dom.cjs`);var t=e.i({UL_SELECTOR:()=>`ul`,UL_TAG:()=>`ul`,createUl:()=>a,enhanceUls:()=>o}),n=`ul`,r=`ul`;function i(e){if(!e)return;let{aria:t,type: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??{}};return typeof n==`string`&&n.length>0&&(o.type=n),Object.keys(o).length>0&&(a.attrs=o),a}function a(t,n){return e.n(`ul`,i(n),t)}function o(e=document){}exports.UL_SELECTOR=r,exports.UL_TAG=n,exports.createUl=a,exports.enhanceUls=o,Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return t}});
+//# sourceMappingURL=ul.cjs.map

package/dist/cjs/elements/list/ul/ul.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ul.cjs","names":[],"sources":["../../../../../src/elements/list/ul/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: Unordered list (ul) element helpers.\n *\n * @remarks\n * The unordered list element (`<ul>`) represents a list of items where the\n * order does not change the meaning.\n *\n * Best-practice guidance:\n * - Use `<ul>` for lists where sequence is not meaningful (use `<ol>` when it is).\n * - Ensure list children are `<li>` elements.\n * - Do not use `<ul>` purely for indentation or spacing; use CSS for layout.\n * - The legacy `type` attribute is obsolete; prefer `list-style-type` in CSS.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create `<ul>` elements in vanilla JS/TS without templates\n * - apply consistent global attributes safely\n * - optionally set legacy presentation attributes in a controlled way\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.\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 unordered lists.\n *\n * @category Constants\n */\nexport const UL_TAG = 'ul' as const;\n\n/**\n * A CSS selector targeting unordered list elements.\n *\n * @category Constants\n */\nexport const UL_SELECTOR = 'ul';\n\n/**\n * Legacy marker style values for `<ul type=\"...\">`.\n *\n * @remarks\n * The `type` attribute is obsolete in HTML5. Prefer CSS `list-style-type`.\n * This is included as a pragmatic escape hatch for legacy markup needs.\n *\n * @category Attributes\n */\nexport type UlLegacyType = 'disc' | 'circle' | 'square';\n\n/**\n * Attribute bag for ul creation/enhancement.\n *\n * @remarks\n * `<ul>` primarily accepts standard HTML global attributes.\n *\n * pkgn-sol also supports:\n * - structured ARIA input mapped into `aria-*`\n * - optional legacy `type` mapping to the `type` attribute (obsolete)\n * - an `attrs` escape hatch, still guarded by pkgn-sol's attribute safety rules\n *\n * @category Attributes\n */\nexport type UlAttrs = Omit<GlobalAttrs, 'aria' | 'attrs'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n\n  /**\n   * Legacy bullet style hint mapped to the `type` attribute (obsolete).\n   *\n   * @remarks\n   * Prefer CSS `list-style-type` instead.\n   */\n  type?: UlLegacyType;\n\n  /**\n   * Additional attributes not modeled above.\n   *\n   * @remarks\n   * This exists as an escape hatch while still allowing pkgn-sol to apply its\n   * attribute safety rules via `dom.ts`.\n   */\n  attrs?: GlobalAttrs['attrs'];\n};\n\n/**\n * Normalize {@link UlAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The ul attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: UlAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, type, attrs: extraAttrs, ...rest } = attrs;\n\n  const mapped: GlobalAttrs = { ...rest };\n\n  // Map structured aria.\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) mapped.aria = mappedAria;\n  }\n\n  // Merge escape-hatch attrs and add legacy `type` if provided.\n  const mergedAttrs: NonNullable<GlobalAttrs['attrs']> = { ...(extraAttrs ?? {}) };\n  if (typeof type === 'string' && type.length > 0) mergedAttrs.type = type;\n\n  if (Object.keys(mergedAttrs).length > 0) mapped.attrs = mergedAttrs;\n\n  return mapped;\n}\n\n/**\n * Create an unordered list (`<ul>`) with optional text content and attributes.\n *\n * @remarks\n * - Text content is assigned via `textContent` (never `innerHTML`).\n * - In real documents, `<ul>` should contain `<li>` children, not raw text.\n *   The optional `text` parameter exists for consistency with pkgn-sol factories and\n *   testing convenience.\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 ul.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<ul>` element.\n *\n * @example\n * ```ts\n * import { createUl } from \"@lnpg/pkgn-sol/elements/list/ul\";\n *\n * const ul = createUl(undefined, { id: \"features\" });\n * document.body.appendChild(ul);\n * ```\n *\n * @category DOM\n */\nexport function createUl(text?: string, attrs?: UlAttrs): ElementOf<typeof UL_TAG> {\n  return createElement(UL_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance unordered list 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 enhanceUls(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for ul.\n  void root;\n}\n"],"mappings":"gMA4Da,EAAS,KAOT,EAAc,KA0D3B,SAAS,EAAc,EAA0C,CAC/D,GAAI,CAAC,EAAO,OAEZ,GAAM,CAAE,OAAM,OAAM,MAAO,EAAY,GAAG,GAAS,EAE7C,EAAsB,CAAE,GAAG,EAAM,CAGvC,GAAI,EAAM,CACR,IAAM,EAA+C,EAAE,CACnD,OAAO,EAAK,OAAU,WAAU,EAAW,MAAQ,EAAK,OACxD,OAAO,EAAK,YAAe,WAAU,EAAW,WAAa,EAAK,YAClE,OAAO,EAAK,QAAW,YAAW,EAAW,OAAS,EAAK,QAE3D,OAAO,KAAK,EAAW,CAAC,OAAS,IAAG,EAAO,KAAO,GAIxD,IAAM,EAAiD,CAAE,GAAI,GAAc,EAAE,CAAG,CAKhF,OAJI,OAAO,GAAS,UAAY,EAAK,OAAS,IAAG,EAAY,KAAO,GAEhE,OAAO,KAAK,EAAY,CAAC,OAAS,IAAG,EAAO,MAAQ,GAEjD,EA6BT,SAAgB,EAAS,EAAe,EAA2C,CACjF,OAAO,EAAA,EAAA,KAAsB,EAAc,EAAM,CAAE,EAAK,CAa1D,SAAgB,EAAW,EAAmB,SAAgB"}

package/dist/cjs/elements/media/audio/audio.cjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../../../chunks/dom.cjs`);var t=e.i({AUDIO_SELECTOR:()=>r,AUDIO_TAG:()=>n,createAudio:()=>a,enhanceAudios:()=>o}),n=`audio`,r=`audio`;function i(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 a(t){let r=e.n(n,i(t));return t?(typeof t.src==`string`&&(r.src=t.src),typeof t.controls==`boolean`&&(r.controls=t.controls),typeof t.autoplay==`boolean`&&(r.autoplay=t.autoplay),typeof t.loop==`boolean`&&(r.loop=t.loop),typeof t.muted==`boolean`?r.muted=t.muted:t.autoplay===!0&&(r.muted=!0),typeof t.preload==`string`&&(r.preload=t.preload),typeof t.crossOrigin==`string`&&(r.crossOrigin=t.crossOrigin),Array.isArray(t.controlsList)&&t.controlsList.length>0&&r.setAttribute(`controlslist`,t.controlsList.join(` `)),typeof t.disableRemotePlayback==`boolean`&&(t.disableRemotePlayback?r.setAttribute(`disableremoteplayback`,``):r.removeAttribute(`disableremoteplayback`)),r):r}function o(e=document){}exports.AUDIO_SELECTOR=r,exports.AUDIO_TAG=n,exports.createAudio=a,exports.enhanceAudios=o,Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return t}});
+//# sourceMappingURL=audio.cjs.map

package/dist/cjs/elements/media/audio/audio.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.cjs","names":[],"sources":["../../../../../src/elements/media/audio/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: Audio element helpers.\n *\n * @remarks\n * The audio element (`<audio>`) embeds sound content in documents.\n * It can load audio via `src` or nested `<source>` elements, and it can\n * also be a destination for streamed media via MediaStream.\n *\n * Best-practice guidance (MDN + platform norms):\n * - Avoid autoplaying audio unless the user explicitly opts in.\n * - Prefer showing controls (`controls`) when audio playback is user-facing.\n * - Use `preload=\"metadata\"` as a sensible hint if you want duration, etc.\n * - Use CORS (`crossOrigin`) when audio might be reused by `<canvas>` without tainting.\n * - Prefer multiple `<source>` elements for format fallbacks where needed.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create audio 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.\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 `preload` values for media elements.\n *\n * @remarks\n * Per MDN, browsers treat this as a hint and may ignore it; `metadata` is a\n * common best-practice default in specs/guidance.\n *\n * @category Attributes\n */\nexport type AudioPreload = 'none' | 'metadata' | 'auto';\n\n/**\n * Allowed values for the `crossorigin` attribute for media fetches.\n *\n * @category Attributes\n */\nexport type AudioCrossOrigin = 'anonymous' | 'use-credentials';\n\n/**\n * Allowed tokens for the `controlslist` attribute (when `controls` is enabled).\n *\n * @remarks\n * MDN lists allowed values including `nodownload`, `nofullscreen`, `noremoteplayback`.\n * (`nofullscreen` is effectively video-oriented but is still a valid token in the attribute.)\n *\n * @category Attributes\n */\nexport type AudioControlsList = 'nodownload' | 'nofullscreen' | 'noremoteplayback';\n\n/**\n * The semantic tag name for audio elements.\n *\n * @category Constants\n */\nexport const AUDIO_TAG = 'audio' as const;\n\n/**\n * A CSS selector targeting audio elements.\n *\n * @category Constants\n */\nexport const AUDIO_SELECTOR = 'audio';\n\n/**\n * Attribute bag for audio creation/enhancement.\n *\n * @remarks\n * Audio elements accept HTML global attributes plus a media-specific subset.\n * pkgn-sol also supports structured ARIA input for common ARIA fields.\n *\n * @category Attributes\n */\nexport type AudioAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n\n  /**\n   * The URL of the audio resource to embed.\n   *\n   * @remarks\n   * Optional if you instead provide nested `<source>` elements.\n   */\n  src?: string;\n\n  /**\n   * Whether browser playback controls should be shown.\n   */\n  controls?: boolean;\n\n  /**\n   * Whether playback should begin automatically.\n   *\n   * @remarks\n   * Autoplaying audio is often blocked unless user-initiated. If `autoplay`\n   * is enabled and `muted` is not specified, pkgn-sol defaults `muted` to `true`\n   * as a pragmatic alignment with autoplay policies.\n   */\n  autoplay?: boolean;\n\n  /**\n   * Whether the audio should loop back to the start after ending.\n   */\n  loop?: boolean;\n\n  /**\n   * Whether the audio should start out muted.\n   */\n  muted?: boolean;\n\n  /**\n   * Hint about how much to preload.\n   */\n  preload?: AudioPreload;\n\n  /**\n   * CORS mode for fetching the audio resource.\n   */\n  crossOrigin?: AudioCrossOrigin;\n\n  /**\n   * Restrict which built-in controls the user agent exposes (when `controls` is set).\n   *\n   * @example\n   * controlsList: ['nodownload', 'noremoteplayback']\n   */\n  controlsList?: AudioControlsList[];\n\n  /**\n   * Disable remote playback (Chromecast/AirPlay/etc).\n   */\n  disableRemotePlayback?: boolean;\n};\n\n/**\n * Normalize {@link AudioAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The audio attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: AudioAttrs): 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 audio element with optional attributes.\n *\n * @remarks\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 through escape hatches.\n *\n * Media-specific attributes are applied directly to the element.\n *\n * @param attrs - Optional attributes to apply.\n * @returns The created `<audio>` element.\n *\n * @example\n * ```ts\n * import { createAudio } from \"@lnpg/pkgn-sol/elements/media/audio\";\n *\n * document.body.appendChild(\n *   createAudio({ controls: true, src: \"/audio/intro.mp3\", preload: \"metadata\" })\n * );\n * ```\n *\n * @category DOM\n */\nexport function createAudio(attrs?: AudioAttrs): ElementOf<typeof AUDIO_TAG> {\n  const el = createElement(AUDIO_TAG, toGlobalAttrs(attrs));\n\n  if (!attrs) return el;\n\n  if (typeof attrs.src === 'string') el.src = attrs.src;\n\n  if (typeof attrs.controls === 'boolean') el.controls = attrs.controls;\n\n  if (typeof attrs.autoplay === 'boolean') el.autoplay = attrs.autoplay;\n  if (typeof attrs.loop === 'boolean') el.loop = attrs.loop;\n\n  // Pragmatic autoplay alignment: if autoplay is enabled and muted is not provided,\n  // default to muted to reduce the chance of autoplay being blocked.\n  if (typeof attrs.muted === 'boolean') {\n    el.muted = attrs.muted;\n  } else if (attrs.autoplay === true) {\n    el.muted = true;\n  }\n\n  if (typeof attrs.preload === 'string') el.preload = attrs.preload;\n\n  if (typeof attrs.crossOrigin === 'string') el.crossOrigin = attrs.crossOrigin;\n\n  if (Array.isArray(attrs.controlsList) && attrs.controlsList.length > 0) {\n    // `controlslist` is a token list attribute; set as a space-separated list.\n    el.setAttribute('controlslist', attrs.controlsList.join(' '));\n  }\n\n  if (typeof attrs.disableRemotePlayback === 'boolean') {\n    if (attrs.disableRemotePlayback) el.setAttribute('disableremoteplayback', '');\n    else el.removeAttribute('disableremoteplayback');\n  }\n\n  return el;\n}\n\n/**\n * Enhance audio 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 enhanceAudios(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for audio.\n  void root;\n}\n"],"mappings":"sMA2Fa,EAAY,QAOZ,EAAiB,QAkF9B,SAAS,EAAc,EAA6C,CAClE,GAAI,CAAC,EAAO,OAEZ,GAAM,CAAE,OAAM,GAAG,GAAS,EAE1B,GAAI,CAAC,EAAM,OAAO,EAElB,IAAM,EAA+C,EAAE,CAQvD,OANI,OAAO,EAAK,OAAU,WAAU,EAAW,MAAQ,EAAK,OACxD,OAAO,EAAK,YAAe,WAAU,EAAW,WAAa,EAAK,YAClE,OAAO,EAAK,QAAW,YAAW,EAAW,OAAS,EAAK,QAE7C,OAAO,KAAK,EAAW,CAAC,OAAS,EAEhC,CAAE,GAAG,EAAM,KAAM,EAAY,CAAG,EA2BrD,SAAgB,EAAY,EAAiD,CAC3E,IAAM,EAAK,EAAA,EAAc,EAAW,EAAc,EAAM,CAAC,CAiCzD,OA/BK,GAED,OAAO,EAAM,KAAQ,WAAU,EAAG,IAAM,EAAM,KAE9C,OAAO,EAAM,UAAa,YAAW,EAAG,SAAW,EAAM,UAEzD,OAAO,EAAM,UAAa,YAAW,EAAG,SAAW,EAAM,UACzD,OAAO,EAAM,MAAS,YAAW,EAAG,KAAO,EAAM,MAIjD,OAAO,EAAM,OAAU,UACzB,EAAG,MAAQ,EAAM,MACR,EAAM,WAAa,KAC5B,EAAG,MAAQ,IAGT,OAAO,EAAM,SAAY,WAAU,EAAG,QAAU,EAAM,SAEtD,OAAO,EAAM,aAAgB,WAAU,EAAG,YAAc,EAAM,aAE9D,MAAM,QAAQ,EAAM,aAAa,EAAI,EAAM,aAAa,OAAS,GAEnE,EAAG,aAAa,eAAgB,EAAM,aAAa,KAAK,IAAI,CAAC,CAG3D,OAAO,EAAM,uBAA0B,YACrC,EAAM,sBAAuB,EAAG,aAAa,wBAAyB,GAAG,CACxE,EAAG,gBAAgB,wBAAwB,EAG3C,GA/BY,EAoDrB,SAAgB,EAAc,EAAmB,SAAgB"}

package/dist/cjs/elements/media/canvas/canvas.cjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../../../chunks/dom.cjs`);var t=e.i({CANVAS_SELECTOR:()=>r,CANVAS_TAG:()=>n,createCanvas:()=>a,enhanceCanvases:()=>o}),n=`canvas`,r=`canvas`;function i(e){if(!e)return;let{aria:t,width:n,height:r,...i}=e,a={...i},o={};return typeof t?.label==`string`&&(o.label=t.label),typeof t?.labelledby==`string`&&(o.labelledby=t.labelledby),typeof t?.hidden==`boolean`&&(o.hidden=t.hidden),Object.keys(o).length>0&&(a.aria=o),(typeof n==`number`||typeof r==`number`)&&(a.attrs={...a.attrs??{}},typeof n==`number`&&(a.attrs.width=n),typeof r==`number`&&(a.attrs.height=r)),a}function a(t,r){return e.n(n,i(r),t)}function o(e=document){}exports.CANVAS_SELECTOR=r,exports.CANVAS_TAG=n,exports.createCanvas=a,exports.enhanceCanvases=o,Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return t}});
+//# sourceMappingURL=canvas.cjs.map

package/dist/cjs/elements/media/canvas/canvas.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas.cjs","names":[],"sources":["../../../../../src/elements/media/canvas/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: Canvas element helpers.\n *\n * @remarks\n * The canvas element (`<canvas>`) provides a scriptable drawing surface.\n *\n * Best-practice guidance:\n * - Prefer setting `width` and `height` attributes (not only CSS sizing) to avoid\n *   rendering distortion from bitmap scaling.\n * - Provide meaningful fallback content where appropriate (e.g. a short text\n *   alternative) as the canvas element can represent its fallback content in\n *   non-visual/unsupported contexts.\n * - If the canvas conveys information, ensure it is labeled accessibly (e.g.\n *   via `aria-label` / `aria-labelledby`) and that equivalent information is\n *   available outside the canvas where needed.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create canvas 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 canvas.\n *\n * @category Constants\n */\nexport const CANVAS_TAG = 'canvas' as const;\n\n/**\n * A CSS selector targeting canvas elements.\n *\n * @category Constants\n */\nexport const CANVAS_SELECTOR = 'canvas';\n\n/**\n * Attribute bag for canvas creation/enhancement.\n *\n * @remarks\n * Canvas supports:\n * - standard HTML global attributes\n * - `width` and `height` attributes for bitmap sizing\n * - structured ARIA input mapped into `aria-*`\n *\n * @category Attributes\n */\nexport type CanvasAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n\n  /**\n   * Bitmap width (in CSS pixels) for the canvas drawing surface.\n   *\n   * @remarks\n   * Prefer this over CSS-only sizing to avoid scaling distortion.\n   */\n  width?: number;\n\n  /**\n   * Bitmap height (in CSS pixels) for the canvas drawing surface.\n   *\n   * @remarks\n   * Prefer this over CSS-only sizing to avoid scaling distortion.\n   */\n  height?: number;\n};\n\n/**\n * Normalize {@link CanvasAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The canvas attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: CanvasAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, width, height, ...rest } = attrs;\n\n  const mapped: GlobalAttrs = { ...rest };\n\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) mapped.aria = mappedAria;\n\n  // Canvas-specific attributes are routed via the safe attrs escape hatch.\n  if (typeof width === 'number' || typeof height === 'number') {\n    mapped.attrs = { ...(mapped.attrs ?? {}) };\n\n    if (typeof width === 'number') mapped.attrs.width = width;\n    if (typeof height === 'number') mapped.attrs.height = height;\n  }\n\n  return mapped;\n}\n\n/**\n * Create a canvas element with optional fallback text content and attributes.\n *\n * @remarks\n * - Text content is assigned via `textContent` (never `innerHTML`).\n * - `width` and `height` (if provided) are applied as attributes via the safe\n *   attribute path in `dom.ts`.\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 content for the canvas.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<canvas>` element.\n *\n * @example\n * Create a 300x150 canvas with a label:\n * ```ts\n * import { createCanvas } from \"@lnpg/pkgn-sol/elements/media/canvas\";\n *\n * const el = createCanvas(undefined, {\n *   width: 300,\n *   height: 150,\n *   aria: { label: \"Sparkline chart\" },\n * });\n * ```\n *\n * @category DOM\n */\nexport function createCanvas(text?: string, attrs?: CanvasAttrs): ElementOf<typeof CANVAS_TAG> {\n  return createElement(CANVAS_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance canvas 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 enhanceCanvases(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for canvas.\n  void root;\n}\n"],"mappings":"2MA+Da,EAAa,SAOb,EAAkB,SA4C/B,SAAS,EAAc,EAA8C,CACnE,GAAI,CAAC,EAAO,OAEZ,GAAM,CAAE,OAAM,QAAO,SAAQ,GAAG,GAAS,EAEnC,EAAsB,CAAE,GAAG,EAAM,CAEjC,EAA+C,EAAE,CAevD,OAdI,OAAO,GAAM,OAAU,WAAU,EAAW,MAAQ,EAAK,OACzD,OAAO,GAAM,YAAe,WAAU,EAAW,WAAa,EAAK,YACnE,OAAO,GAAM,QAAW,YAAW,EAAW,OAAS,EAAK,QAE5D,OAAO,KAAK,EAAW,CAAC,OAAS,IAAG,EAAO,KAAO,IAGlD,OAAO,GAAU,UAAY,OAAO,GAAW,YACjD,EAAO,MAAQ,CAAE,GAAI,EAAO,OAAS,EAAE,CAAG,CAEtC,OAAO,GAAU,WAAU,EAAO,MAAM,MAAQ,GAChD,OAAO,GAAW,WAAU,EAAO,MAAM,OAAS,IAGjD,EAgCT,SAAgB,EAAa,EAAe,EAAmD,CAC7F,OAAO,EAAA,EAAc,EAAY,EAAc,EAAM,CAAE,EAAK,CAqB9D,SAAgB,EAAgB,EAAmB,SAAgB"}

package/dist/cjs/elements/media/embed/embed.cjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../../../chunks/dom.cjs`);var t=e.i({EMBED_SELECTOR:()=>r,EMBED_TAG:()=>n,createEmbed:()=>o,enhanceEmbeds:()=>s}),n=`embed`,r=`embed`;function i(e,t){if(e==null)return;if(typeof e==`number`){if(!Number.isFinite(e)||e<0)throw Error(`Invalid ${t}: must be a finite, non-negative number.`);return String(Math.floor(e))}let n=String(e).trim();if(n.length!==0){if(n.includes(`%`))throw Error(`Invalid ${t}: percentages are not allowed for <embed> ${t}.`);if(!/^\d+$/.test(n))throw Error(`Invalid ${t}: must be a non-negative integer (CSS pixels).`);return n}}function a(e){if(!e)return;let{aria:t,src:n,type:r,width:a,height:o,attrs: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=i(a,`width`),d=i(o,`height`),f=(()=>{let e={...s??{}};return typeof n==`string`&&n.length>0&&(e.src=n),typeof r==`string`&&r.length>0&&(e.type=r),typeof u==`string`&&(e.width=u),typeof d==`string`&&(e.height=d),Object.keys(e).length>0?e:void 0})();return{...c,...l?{aria:l}:null,...f?{attrs:f}:null}}function o(t){return e.r(n,a(t))}function s(e=document){}exports.EMBED_SELECTOR=r,exports.EMBED_TAG=n,exports.createEmbed=o,exports.enhanceEmbeds=s,Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return t}});
+//# sourceMappingURL=embed.cjs.map

package/dist/cjs/elements/media/embed/embed.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"embed.cjs","names":[],"sources":["../../../../../src/elements/media/embed/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: Embed element helpers.\n *\n * @remarks\n * The embed element (`<embed>`) embeds external content at a point in the\n * document. Historically this was often browser plug-ins; modern browsers have\n * largely removed plug-in support, so relying on `<embed>` is frequently a poor\n * choice for general-purpose sites. Prefer purpose-built elements when possible\n * (e.g. `<img>`, `<video>`, `<audio>`, `<iframe>`, or `<object>` depending on the use case).\n *\n * Best-practice guidance:\n * - Prefer native elements over `<embed>` when there is a semantic alternative.\n * - Use the `title` attribute to label embedded content for assistive technology.\n * - `width`/`height` should be absolute pixel values (no percentages).\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create embed nodes 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 {\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 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 embed.\n *\n * @category Constants\n */\nexport const EMBED_TAG = 'embed' as const;\n\n/**\n * A CSS selector targeting embed elements.\n *\n * @category Constants\n */\nexport const EMBED_SELECTOR = 'embed';\n\n/**\n * Attribute bag for embed creation/enhancement.\n *\n * @remarks\n * `<embed>` supports global attributes plus:\n * - `src` (URL)\n * - `type` (MIME type)\n * - `width` / `height` (absolute pixel values; percentages are invalid)\n *\n * Accessibility:\n * - Provide a `title` (global attribute) to label the embedded content.\n *\n * pkgn-sol also supports a structured ARIA input for common ARIA fields, mapped into\n * `aria-*` attributes.\n *\n * @category Attributes\n */\nexport type EmbedAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * URL of the resource being embedded.\n   */\n  src?: string;\n\n  /**\n   * MIME type used to select the appropriate handler.\n   */\n  type?: string;\n\n  /**\n   * Displayed width in CSS pixels (absolute; percentages are not allowed).\n   */\n  width?: number | string;\n\n  /**\n   * Displayed height in CSS pixels (absolute; percentages are not allowed).\n   */\n  height?: number | string;\n\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize an HTML dimension attribute value.\n *\n * @remarks\n * MDN notes `width`/`height` must be absolute values (percentages are invalid).\n * HTML attribute values for these are effectively numeric pixel counts.\n *\n * @param v - The provided dimension.\n * @param name - Attribute name for error messages.\n * @returns A stringified non-negative integer, or `undefined` if not provided.\n *\n * @category Internal\n */\nfunction normalizeDim(v: EmbedAttrs['width'], name: 'width' | 'height'): string | undefined {\n  if (v === undefined || v === null) return undefined;\n\n  if (typeof v === 'number') {\n    if (!Number.isFinite(v) || v < 0) {\n      throw new Error(`Invalid ${name}: must be a finite, non-negative number.`);\n    }\n    // HTML width/height attributes are integer-like; normalize safely.\n    return String(Math.floor(v));\n  }\n\n  const s = String(v).trim();\n\n  if (s.length === 0) return undefined;\n\n  if (s.includes('%')) {\n    throw new Error(`Invalid ${name}: percentages are not allowed for <embed> ${name}.`);\n  }\n\n  if (!/^\\d+$/.test(s)) {\n    throw new Error(`Invalid ${name}: must be a non-negative integer (CSS pixels).`);\n  }\n\n  return s;\n}\n\n/**\n * Normalize {@link EmbedAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The embed attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: EmbedAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, src, type, width, height, attrs: extraAttrs, ...rest } = attrs;\n\n  const mappedAria: NonNullable<GlobalAttrs['aria']> | undefined = aria\n    ? (() => {\n        const a: NonNullable<GlobalAttrs['aria']> = {};\n        if (typeof aria.label === 'string') a.label = aria.label;\n        if (typeof aria.labelledby === 'string') a.labelledby = aria.labelledby;\n        if (typeof aria.hidden === 'boolean') a.hidden = aria.hidden;\n        return Object.keys(a).length > 0 ? a : undefined;\n      })()\n    : undefined;\n\n  const w = normalizeDim(width, 'width');\n  const h = normalizeDim(height, 'height');\n\n  const mergedAttrs: Record<string, AttrValue> | undefined = (() => {\n    const a: Record<string, AttrValue> = { ...(extraAttrs ?? {}) };\n\n    if (typeof src === 'string' && src.length > 0) a.src = src;\n    if (typeof type === 'string' && type.length > 0) a.type = type;\n\n    if (typeof w === 'string') a.width = w;\n    if (typeof h === 'string') a.height = h;\n\n    return Object.keys(a).length > 0 ? a : undefined;\n  })();\n\n  const mapped: GlobalAttrs = {\n    ...rest,\n    ...(mappedAria ? { aria: mappedAria } : null),\n    ...(mergedAttrs ? { attrs: mergedAttrs } : null),\n  };\n\n  return mapped;\n}\n\n/**\n * Create an embed element and apply attributes.\n *\n * @remarks\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 `<embed>` element.\n *\n * @example\n * ```ts\n * import { createEmbed } from \"@lnpg/pkgn-sol/elements/media/embed\";\n *\n * document.body.appendChild(\n *   createEmbed({ src: \"/files/manual.pdf\", type: \"application/pdf\", title: \"User manual\" })\n * );\n * ```\n *\n * @category DOM\n */\nexport function createEmbed(attrs?: EmbedAttrs): ElementOf<typeof EMBED_TAG> {\n  return createVoidElement(EMBED_TAG, toGlobalAttrs(attrs));\n}\n\n/**\n * Enhance embed 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 enhanceEmbeds(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for embed.\n  void root;\n}\n"],"mappings":"sMAmEa,EAAY,QAOZ,EAAiB,QA2D9B,SAAS,EAAa,EAAwB,EAA8C,CAC1F,GAAI,GAAyB,KAAM,OAEnC,GAAI,OAAO,GAAM,SAAU,CACzB,GAAI,CAAC,OAAO,SAAS,EAAE,EAAI,EAAI,EAC7B,MAAU,MAAM,WAAW,EAAK,0CAA0C,CAG5E,OAAO,OAAO,KAAK,MAAM,EAAE,CAAC,CAG9B,IAAM,EAAI,OAAO,EAAE,CAAC,MAAM,CAEtB,KAAE,SAAW,EAEjB,IAAI,EAAE,SAAS,IAAI,CACjB,MAAU,MAAM,WAAW,EAAK,4CAA4C,EAAK,GAAG,CAGtF,GAAI,CAAC,QAAQ,KAAK,EAAE,CAClB,MAAU,MAAM,WAAW,EAAK,gDAAgD,CAGlF,OAAO,GAWT,SAAS,EAAc,EAA6C,CAClE,GAAI,CAAC,EAAO,OAEZ,GAAM,CAAE,OAAM,MAAK,OAAM,QAAO,SAAQ,MAAO,EAAY,GAAG,GAAS,EAEjE,EAA2D,OACtD,CACL,IAAM,EAAsC,EAAE,CAI9C,OAHI,OAAO,EAAK,OAAU,WAAU,EAAE,MAAQ,EAAK,OAC/C,OAAO,EAAK,YAAe,WAAU,EAAE,WAAa,EAAK,YACzD,OAAO,EAAK,QAAW,YAAW,EAAE,OAAS,EAAK,QAC/C,OAAO,KAAK,EAAE,CAAC,OAAS,EAAI,EAAI,IAAA,MACrC,CACJ,IAAA,GAEE,EAAI,EAAa,EAAO,QAAQ,CAChC,EAAI,EAAa,EAAQ,SAAS,CAElC,OAA4D,CAChE,IAAM,EAA+B,CAAE,GAAI,GAAc,EAAE,CAAG,CAQ9D,OANI,OAAO,GAAQ,UAAY,EAAI,OAAS,IAAG,EAAE,IAAM,GACnD,OAAO,GAAS,UAAY,EAAK,OAAS,IAAG,EAAE,KAAO,GAEtD,OAAO,GAAM,WAAU,EAAE,MAAQ,GACjC,OAAO,GAAM,WAAU,EAAE,OAAS,GAE/B,OAAO,KAAK,EAAE,CAAC,OAAS,EAAI,EAAI,IAAA,MACrC,CAQJ,MAAO,CALL,GAAG,EACH,GAAI,EAAa,CAAE,KAAM,EAAY,CAAG,KACxC,GAAI,EAAc,CAAE,MAAO,EAAa,CAAG,KAGtC,CAyBT,SAAgB,EAAY,EAAiD,CAC3E,OAAO,EAAA,EAAkB,EAAW,EAAc,EAAM,CAAC,CAa3D,SAAgB,EAAc,EAAmB,SAAgB"}

package/dist/cjs/elements/media/iframe/iframe.cjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../../../chunks/dom.cjs`);var t=e.i({IFRAME_SELECTOR:()=>r,IFRAME_TAG:()=>n,createIFrame:()=>a,enhanceIFrames:()=>o}),n=`iframe`,r=`iframe`;function i(e){if(!e)return;let{aria:t,src:n,srcdoc:r,name:i,sandbox:a,allow:o,allowFullScreen:s,loading:c,referrerPolicy:l,width:u,height:d,fetchPriority:f,csp:p,credentialless:m,...h}=e,g={...h.attrs??{}},_=(e,t)=>{t!==void 0&&(Object.prototype.hasOwnProperty.call(g,e)||(g[e]=t))};_(`src`,n),_(`srcdoc`,r),_(`name`,i),_(`sandbox`,a),_(`allow`,o),_(`loading`,c),_(`referrerpolicy`,l),_(`width`,u),_(`height`,d),_(`fetchpriority`,f),_(`csp`,p),s===!0&&_(`allowfullscreen`,``),m===!0&&_(`credentialless`,``);let v={};t&&(typeof t.label==`string`&&(v.label=t.label),typeof t.labelledby==`string`&&(v.labelledby=t.labelledby),typeof t.hidden==`boolean`&&(v.hidden=t.hidden));let y=Object.keys(v).length>0,b=Object.keys(g).length>0,x={...h};return b&&(x.attrs=g),y&&(x.aria=v),x}function a(t,r){return e.n(n,i(r),t)}function o(e=document){}exports.IFRAME_SELECTOR=r,exports.IFRAME_TAG=n,exports.createIFrame=a,exports.enhanceIFrames=o,Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return t}});
+//# sourceMappingURL=iframe.cjs.map

package/dist/cjs/elements/media/iframe/iframe.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"iframe.cjs","names":[],"sources":["../../../../../src/elements/media/iframe/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: IFrame element helpers.\n *\n * @remarks\n * The iframe element (`<iframe>`) embeds another HTML page into the current page.\n *\n * Best-practice guidance:\n * - Prefer `<iframe>` only when you truly need third-party or isolated documents.\n * - Consider `loading=\"lazy\"` for non-critical iframes to reduce initial load cost.\n * - Use `sandbox` with the least permissions possible when embedding untrusted content.\n * - Prefer restrictive `referrerpolicy` when embedding third-party content.\n * - Provide a meaningful `title` for accessibility (screen readers use it to identify the frame).\n * - Avoid obsolete attributes like `frameborder`; use CSS instead.\n *\n * Security notes:\n * - `srcdoc` embeds HTML directly. pkgn-sol does not sanitize or validate it.\n *   If you build `srcdoc` from untrusted input, that is on you (and your incident report).\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create iframes 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, type AttrValue } 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 iframe embeds.\n *\n * @category Constants\n */\nexport const IFRAME_TAG = 'iframe' as const;\n\n/**\n * A CSS selector targeting iframe elements.\n *\n * @category Constants\n */\nexport const IFRAME_SELECTOR = 'iframe';\n\n/**\n * Allowed values for the iframe `loading` attribute.\n *\n * @category Types\n */\nexport type IFrameLoading = 'eager' | 'lazy';\n\n/**\n * Allowed values for the iframe `referrerpolicy` attribute.\n *\n * @category Types\n */\nexport type IFrameReferrerPolicy =\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 * Allowed values for the `fetchpriority` attribute.\n *\n * @category Types\n */\nexport type FetchPriority = 'high' | 'low' | 'auto';\n\n/**\n * Attribute bag for iframe creation/enhancement.\n *\n * @remarks\n * Iframes accept standard HTML global attributes plus iframe-specific 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 IFrameAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n\n  /**\n   * Address of the document to embed.\n   */\n  src?: string;\n\n  /**\n   * Inline HTML to render within the iframe.\n   *\n   * @remarks\n   * pkgn-sol does not sanitize `srcdoc`.\n   */\n  srcdoc?: string;\n\n  /**\n   * A name for the browsing context.\n   */\n  name?: string;\n\n  /**\n   * A space-separated list of sandbox tokens.\n   *\n   * @remarks\n   * Use the least permissive sandbox you can.\n   */\n  sandbox?: string;\n\n  /**\n   * Permissions policy for the iframe (previously \"feature policy\").\n   *\n   * @remarks\n   * Example: `allow=\"fullscreen; geolocation 'none'\"`.\n   */\n  allow?: string;\n\n  /**\n   * Whether fullscreen is allowed.\n   *\n   * @remarks\n   * Mirrors the `allowfullscreen` boolean attribute.\n   */\n  allowFullScreen?: boolean;\n\n  /**\n   * Whether the iframe should be loaded lazily or eagerly.\n   */\n  loading?: IFrameLoading;\n\n  /**\n   * Referrer policy for requests made by the iframe.\n   */\n  referrerPolicy?: IFrameReferrerPolicy;\n\n  /**\n   * Display width, in CSS pixels.\n   */\n  width?: number | string;\n\n  /**\n   * Display height, in CSS pixels.\n   */\n  height?: number | string;\n\n  /**\n   * Fetch priority hint.\n   */\n  fetchPriority?: FetchPriority;\n\n  /**\n   * Content Security Policy to apply to the embedded document.\n   *\n   * @remarks\n   * Support varies by browser and context.\n   */\n  csp?: string;\n\n  /**\n   * Whether to use a credentialless iframe (privacy-oriented isolation).\n   *\n   * @remarks\n   * Mirrors the `credentialless` boolean attribute where supported.\n   */\n  credentialless?: boolean;\n};\n\n/**\n * Normalize {@link IFrameAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The iframe attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: IFrameAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const {\n    aria,\n    src,\n    srcdoc,\n    name,\n    sandbox,\n    allow,\n    allowFullScreen,\n    loading,\n    referrerPolicy,\n    width,\n    height,\n    fetchPriority,\n    csp,\n    credentialless,\n    ...rest\n  } = attrs;\n\n  // Start with any caller-provided attrs escape hatch (it is still validated by dom.ts).\n  const mergedAttrs: Record<string, AttrValue> = { ...(rest.attrs ?? {}) };\n\n  // Helper: only set if caller didn't already set the raw attribute explicitly.\n  const setIfUnset = (key: string, 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('src', src);\n  setIfUnset('srcdoc', srcdoc);\n  setIfUnset('name', name);\n  setIfUnset('sandbox', sandbox);\n  setIfUnset('allow', allow);\n  setIfUnset('loading', loading);\n  setIfUnset('referrerpolicy', referrerPolicy);\n  setIfUnset('width', width);\n  setIfUnset('height', height);\n  setIfUnset('fetchpriority', fetchPriority);\n  setIfUnset('csp', csp);\n\n  // Boolean attributes are represented by presence. We set empty-string when true.\n  if (allowFullScreen === true) setIfUnset('allowfullscreen', '');\n  if (credentialless === true) setIfUnset('credentialless', '');\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 hasMappedAria = Object.keys(mappedAria).length > 0;\n  const hasMergedAttrs = Object.keys(mergedAttrs).length > 0;\n\n  const next: GlobalAttrs = { ...rest };\n  if (hasMergedAttrs) next.attrs = mergedAttrs;\n  if (hasMappedAria) next.aria = mappedAria;\n\n  return next;\n}\n\n/**\n * Create an iframe 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 content for the iframe (rarely used, but valid).\n * @param attrs - Optional attributes to apply.\n * @returns The created `<iframe>` element.\n *\n * @example\n * ```ts\n * import { createIFrame } from \"@lnpg/pkgn-sol/elements/media/iframe\";\n *\n * document.body.appendChild(\n *   createIFrame(undefined, {\n *     title: \"Embedded map\",\n *     src: \"https://example.com/map\",\n *     loading: \"lazy\",\n *     sandbox: \"allow-scripts allow-same-origin\"\n *   })\n * );\n * ```\n *\n * @category DOM\n */\nexport function createIFrame(text?: string, attrs?: IFrameAttrs): ElementOf<typeof IFRAME_TAG> {\n  return createElement(IFRAME_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance iframe 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 enhanceIFrames(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for iframe.\n  void root;\n}\n"],"mappings":"0MAiEa,EAAa,SAOb,EAAkB,SA4I/B,SAAS,EAAc,EAA8C,CACnE,GAAI,CAAC,EAAO,OAEZ,GAAM,CACJ,OACA,MACA,SACA,OACA,UACA,QACA,kBACA,UACA,iBACA,QACA,SACA,gBACA,MACA,iBACA,GAAG,GACD,EAGE,EAAyC,CAAE,GAAI,EAAK,OAAS,EAAE,CAAG,CAGlE,GAAc,EAAa,IAAuC,CAClE,IAAU,IAAA,KACV,OAAO,UAAU,eAAe,KAAK,EAAa,EAAI,GAC1D,EAAY,GAAO,KAGrB,EAAW,MAAO,EAAI,CACtB,EAAW,SAAU,EAAO,CAC5B,EAAW,OAAQ,EAAK,CACxB,EAAW,UAAW,EAAQ,CAC9B,EAAW,QAAS,EAAM,CAC1B,EAAW,UAAW,EAAQ,CAC9B,EAAW,iBAAkB,EAAe,CAC5C,EAAW,QAAS,EAAM,CAC1B,EAAW,SAAU,EAAO,CAC5B,EAAW,gBAAiB,EAAc,CAC1C,EAAW,MAAO,EAAI,CAGlB,IAAoB,IAAM,EAAW,kBAAmB,GAAG,CAC3D,IAAmB,IAAM,EAAW,iBAAkB,GAAG,CAE7D,IAAM,EAA+C,EAAE,CACnD,IACE,OAAO,EAAK,OAAU,WAAU,EAAW,MAAQ,EAAK,OACxD,OAAO,EAAK,YAAe,WAAU,EAAW,WAAa,EAAK,YAClE,OAAO,EAAK,QAAW,YAAW,EAAW,OAAS,EAAK,SAGjE,IAAM,EAAgB,OAAO,KAAK,EAAW,CAAC,OAAS,EACjD,EAAiB,OAAO,KAAK,EAAY,CAAC,OAAS,EAEnD,EAAoB,CAAE,GAAG,EAAM,CAIrC,OAHI,IAAgB,EAAK,MAAQ,GAC7B,IAAe,EAAK,KAAO,GAExB,EAgCT,SAAgB,EAAa,EAAe,EAAmD,CAC7F,OAAO,EAAA,EAAc,EAAY,EAAc,EAAM,CAAE,EAAK,CAqB9D,SAAgB,EAAe,EAAmB,SAAgB"}

package/dist/cjs/elements/media/img/img.cjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../../../chunks/dom.cjs`);var t=e.i({IMG_SELECTOR:()=>`img`,IMG_TAG:()=>`img`,createImg:()=>a,enhanceImgs:()=>o}),n=`img`,r=`img`;function i(e){let{aria:t,alt:n,src:r,srcset:i,sizes:a,width:o,height:s,loading:c,decoding:l,referrerPolicy:u,...d}=e??{},f={...d},p={};t&&(typeof t.label==`string`&&(p.label=t.label),typeof t.labelledby==`string`&&(p.labelledby=t.labelledby),typeof t.hidden==`boolean`&&(p.hidden=t.hidden)),Object.keys(p).length>0&&(f.aria=p),f.attrs={...f.attrs??{},alt:typeof n==`string`?n:``};let m=typeof r==`string`&&r.length>0,h=typeof i==`string`&&i.length>0;return m&&(f.attrs.src=r),h&&(f.attrs.srcset=i),a&&(f.attrs.sizes=a),typeof o==`number`&&(f.attrs.width=o),typeof s==`number`&&(f.attrs.height=s),c&&(f.attrs.loading=c),l&&(f.attrs.decoding=l),u&&(f.attrs.referrerpolicy=u),!m&&!h&&(f.attrs.src=`data:,`),f}function a(t){return e.r(`img`,i(t))}function o(e=document){}exports.IMG_SELECTOR=r,exports.IMG_TAG=n,exports.createImg=a,exports.enhanceImgs=o,Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return t}});
+//# sourceMappingURL=img.cjs.map

package/dist/cjs/elements/media/img/img.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"img.cjs","names":[],"sources":["../../../../../src/elements/media/img/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: Img element helpers.\n *\n * @remarks\n * The img element (`<img>`) embeds an image into the document.\n *\n * Best-practice guidance:\n * - The `alt` attribute must always be present.\n * - Use `alt=\"\"` for purely decorative images.\n * - Provide meaningful alternative text for informative images.\n * - Do not rely on images alone to convey critical information.\n *\n * This module enforces:\n * - `alt` always exists (defaults to empty string if not provided)\n * - If neither `src` nor `srcset` is provided, a safe fallback\n *   `src=\"data:,\"` is applied to avoid broken network requests\n * - All global attributes are applied via pkgn-sol's hardened DOM helpers\n *\n * This module has no side effects and does not mutate the DOM unless you call\n * its functions.\n *\n * @module\n * @category Elements\n */\n\nimport { createVoidElement, type ElementOf, type GlobalAttrs } from '../../../ts/dom';\n\n/**\n * Structured ARIA input supported by pkgn-sol element factories.\n *\n * @category Attributes\n */\nexport type StructuredAria = {\n  label?: string;\n  labelledby?: string;\n  hidden?: boolean;\n};\n\n/**\n * The semantic tag name for images.\n *\n * @category Constants\n */\nexport const IMG_TAG = 'img' as const;\n\n/**\n * A CSS selector targeting img elements.\n *\n * @category Constants\n */\nexport const IMG_SELECTOR = 'img';\n\n/**\n * Img-specific attributes.\n *\n * @remarks\n * `alt` is mandatory per HTML specification.\n *\n * @category Attributes\n */\nexport type ImgAttrs = Omit<GlobalAttrs, 'aria'> & {\n  alt?: string;\n  src?: string;\n  srcset?: string;\n  sizes?: string;\n  width?: number;\n  height?: number;\n  loading?: 'lazy' | 'eager';\n  decoding?: 'sync' | 'async' | 'auto';\n  referrerPolicy?: string;\n  aria?: StructuredAria;\n};\n\nfunction toGlobalAttrs(attrs?: ImgAttrs): GlobalAttrs {\n  const {\n    aria,\n    alt,\n    src,\n    srcset,\n    sizes,\n    width,\n    height,\n    loading,\n    decoding,\n    referrerPolicy,\n    ...rest\n  } = attrs ?? {};\n\n  const mapped: GlobalAttrs = { ...rest };\n\n  const mappedAria: NonNullable<GlobalAttrs['aria']> = {};\n\n  if (aria) {\n    if (typeof aria.label === 'string') mappedAria.label = aria.label;\n    if (typeof aria.labelledby === 'string') mappedAria.labelledby = aria.labelledby;\n    if (typeof aria.hidden === 'boolean') mappedAria.hidden = aria.hidden;\n  }\n\n  if (Object.keys(mappedAria).length > 0) {\n    mapped.aria = mappedAria;\n  }\n\n  mapped.attrs = {\n    ...(mapped.attrs ?? {}),\n    alt: typeof alt === 'string' ? alt : '',\n  };\n\n  const hasSrc = typeof src === 'string' && src.length > 0;\n  const hasSrcset = typeof srcset === 'string' && srcset.length > 0;\n\n  if (hasSrc) mapped.attrs.src = src;\n  if (hasSrcset) mapped.attrs.srcset = srcset;\n  if (sizes) mapped.attrs.sizes = sizes;\n  if (typeof width === 'number') mapped.attrs.width = width;\n  if (typeof height === 'number') mapped.attrs.height = height;\n  if (loading) mapped.attrs.loading = loading;\n  if (decoding) mapped.attrs.decoding = decoding;\n  if (referrerPolicy) mapped.attrs.referrerpolicy = referrerPolicy;\n\n  if (!hasSrc && !hasSrcset) {\n    mapped.attrs.src = 'data:,';\n  }\n\n  return mapped;\n}\n\n/**\n * Create an img element with enforced accessibility safeguards.\n *\n * @category DOM\n */\nexport function createImg(attrs?: ImgAttrs): ElementOf<typeof IMG_TAG> {\n  return createVoidElement(IMG_TAG, toGlobalAttrs(attrs));\n}\n\n/**\n * Enhance img elements within a given root.\n *\n * @remarks\n * No runtime behaviour in v0.1.0.\n *\n * @category Enhancement\n */\nexport function enhanceImgs(root: ParentNode = document): void {\n  void root;\n}\n"],"mappings":"sMA2Ca,EAAU,MAOV,EAAe,MAuB5B,SAAS,EAAc,EAA+B,CACpD,GAAM,CACJ,OACA,MACA,MACA,SACA,QACA,QACA,SACA,UACA,WACA,iBACA,GAAG,GACD,GAAS,EAAE,CAET,EAAsB,CAAE,GAAG,EAAM,CAEjC,EAA+C,EAAE,CAEnD,IACE,OAAO,EAAK,OAAU,WAAU,EAAW,MAAQ,EAAK,OACxD,OAAO,EAAK,YAAe,WAAU,EAAW,WAAa,EAAK,YAClE,OAAO,EAAK,QAAW,YAAW,EAAW,OAAS,EAAK,SAG7D,OAAO,KAAK,EAAW,CAAC,OAAS,IACnC,EAAO,KAAO,GAGhB,EAAO,MAAQ,CACb,GAAI,EAAO,OAAS,EAAE,CACtB,IAAK,OAAO,GAAQ,SAAW,EAAM,GACtC,CAED,IAAM,EAAS,OAAO,GAAQ,UAAY,EAAI,OAAS,EACjD,EAAY,OAAO,GAAW,UAAY,EAAO,OAAS,EAehE,OAbI,IAAQ,EAAO,MAAM,IAAM,GAC3B,IAAW,EAAO,MAAM,OAAS,GACjC,IAAO,EAAO,MAAM,MAAQ,GAC5B,OAAO,GAAU,WAAU,EAAO,MAAM,MAAQ,GAChD,OAAO,GAAW,WAAU,EAAO,MAAM,OAAS,GAClD,IAAS,EAAO,MAAM,QAAU,GAChC,IAAU,EAAO,MAAM,SAAW,GAClC,IAAgB,EAAO,MAAM,eAAiB,GAE9C,CAAC,GAAU,CAAC,IACd,EAAO,MAAM,IAAM,UAGd,EAQT,SAAgB,EAAU,EAA6C,CACrE,OAAO,EAAA,EAAA,MAA2B,EAAc,EAAM,CAAC,CAWzD,SAAgB,EAAY,EAAmB,SAAgB"}

package/dist/cjs/elements/media/math/math.cjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../../../chunks/dom.cjs`);var t=e.i({MATH_SELECTOR:()=>r,MATH_TAG:()=>n,createMath:()=>a,enhanceMath:()=>o}),n=`math`,r=`math`;function i(e){let{aria:t,display:n,attrs:r,tabIndex:i,...a}=e??{},o={...a},s={};typeof t?.label==`string`&&(s.label=t.label),typeof t?.labelledby==`string`&&(s.labelledby=t.labelledby),typeof t?.hidden==`boolean`?s.hidden=t.hidden:s.hidden=!0,Object.keys(s).length>0&&(o.aria=s),typeof i==`number`?o.tabIndex=i:o.tabIndex=-1;let c={...r??{}};return n&&(c.display=n),Object.keys(c).length>0&&(o.attrs=c),o}function a(t,r){let a=document.createElement(n);return e.t(a,i(r)),typeof t==`string`&&(a.textContent=t),a}function o(e=document){}exports.MATH_SELECTOR=r,exports.MATH_TAG=n,exports.createMath=a,exports.enhanceMath=o,Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return t}});
+//# sourceMappingURL=math.cjs.map