@lnpg/pkgn-sol 1.0.0-beta.0

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2026 LNPG Development Team
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,64 @@
+# @lnpg/pkgn-sol (v1.0.0-beta.0)
+
+**pkgn-sol** is LNPG’s framework-agnostic design foundation for shared CSS, SCSS, design tokens,
+typography, spacing, colour, and reset styles across UI kits, applications, and websites.
+
+It ships:
+
+- **CSS** builds (ready to drop into any app)
+- **SCSS** source (tokens, functions, mixins, element styles, and adapters)
+- **Typed HTML element factories** (safe-ish DOM creation helpers with strong TypeScript typing)
+- **Tailwind v4 adapter** (preset + plugin wrapper)
+
+Repo: https://github.com/lnpgdev/pkgn-sol  
+Docs (VitePress site): `npm run docs`  
+API docs (TypeDoc markdown): generated into `docs/api/ts`
+
+---
+
+## Table of contents
+
+- [What pkgn-sol is](#what-pkgn-sol-is)
+- [Install](#install)
+- [Entry points](#entry-points)
+  - [JavaScript/TypeScript](#javascripttypescript)
+  - [Elements API](#elements-api)
+  - [Tailwind adapter](#tailwind-adapter)
+  - [CSS entry points](#css-entry-points)
+  - [SCSS entry points](#scss-entry-points)
+- [Quick start](#quick-start)
+  - [Use prebuilt CSS](#use-prebuilt-css)
+  - [Use SCSS tokens/functions/mixins](#use-scss-tokensfunctionsmixins)
+  - [Use element factories](#use-element-factories)
+  - [Use Tailwind adapter](#use-tailwind-adapter)
+- [Design + security principles](#design--security-principles)
+- [Build outputs](#build-outputs)
+- [Scripts](#scripts)
+- [Production readiness checklist](#production-readiness-checklist)
+- [Contributing](#contributing)
+- [License](#license)
+
+---
+
+## What pkgn-sol is
+
+pkgn-sol aims to be the **lowest-level** design foundation layer:
+
+- **Styles**: tokens + primitives + optional element styling
+- **DOM**: typed factories that wrap native elements (no framework assumptions)
+
+pkgn-sol intentionally does **not** attempt to be:
+
+- a full component library
+- a design system website
+- a framework binding (React/Vue/etc)
+
+Think of it as: _“a reliable base layer you can import into anything, without regretting it later.”_
+
+---
+
+## Install
+
+```bash
+npm i @lnpg/pkgn-sol
+```

package/dist/assets/fonts/montserrat/OFL.txt

@@ -0,0 +1,93 @@
+Copyright 2011 The Montserrat Project Authors (https://github.com/JulietaUla/Montserrat)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/dist/assets/fonts/montserrat/README.txt

@@ -0,0 +1,81 @@
+Montserrat Variable Font
+========================
+
+This download contains Montserrat as both variable fonts and static fonts.
+
+Montserrat is a variable font with this axis:
+  wght
+
+This means all the styles are contained in these files:
+  Montserrat-VariableFont_wght.ttf
+  Montserrat-Italic-VariableFont_wght.ttf
+
+If your app fully supports variable fonts, you can now pick intermediate styles
+that aren’t available as static fonts. Not all apps support variable fonts, and
+in those cases you can use the static font files for Montserrat:
+  static/Montserrat-Thin.ttf
+  static/Montserrat-ExtraLight.ttf
+  static/Montserrat-Light.ttf
+  static/Montserrat-Regular.ttf
+  static/Montserrat-Medium.ttf
+  static/Montserrat-SemiBold.ttf
+  static/Montserrat-Bold.ttf
+  static/Montserrat-ExtraBold.ttf
+  static/Montserrat-Black.ttf
+  static/Montserrat-ThinItalic.ttf
+  static/Montserrat-ExtraLightItalic.ttf
+  static/Montserrat-LightItalic.ttf
+  static/Montserrat-Italic.ttf
+  static/Montserrat-MediumItalic.ttf
+  static/Montserrat-SemiBoldItalic.ttf
+  static/Montserrat-BoldItalic.ttf
+  static/Montserrat-ExtraBoldItalic.ttf
+  static/Montserrat-BlackItalic.ttf
+
+Get started
+-----------
+
+1. Install the font files you want to use
+
+2. Use your app's font picker to view the font family and all the
+available styles
+
+Learn more about variable fonts
+-------------------------------
+
+  https://developers.google.com/web/fundamentals/design-and-ux/typography/variable-fonts
+  https://variablefonts.typenetwork.com
+  https://medium.com/variable-fonts
+
+In desktop apps
+
+  https://theblog.adobe.com/can-variable-fonts-illustrator-cc
+  https://helpx.adobe.com/nz/photoshop/using/fonts.html#variable_fonts
+
+Online
+
+  https://developers.google.com/fonts/docs/getting_started
+  https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Fonts/Variable_Fonts_Guide
+  https://developer.microsoft.com/en-us/microsoft-edge/testdrive/demos/variable-fonts
+
+Installing fonts
+
+  MacOS: https://support.apple.com/en-us/HT201749
+  Linux: https://www.google.com/search?q=how+to+install+a+font+on+gnu%2Blinux
+  Windows: https://support.microsoft.com/en-us/help/314960/how-to-install-or-remove-a-font-in-windows
+
+Android Apps
+
+  https://developers.google.com/fonts/docs/android
+  https://developer.android.com/guide/topics/ui/look-and-feel/downloadable-fonts
+
+License
+-------
+Please read the full license text (OFL.txt) to understand the permissions,
+restrictions and requirements for usage, redistribution, and modification.
+
+You can use them in your products & projects – print or digital,
+commercial or otherwise.
+
+This isn't legal advice, please consider consulting a lawyer and see the full
+license for all details.

package/dist/cjs/chunks/dom.cjs

@@ -0,0 +1,2 @@
+var e=Object.defineProperty,t=(t,n)=>{let r={};for(var i in t)e(r,i,{get:t[i],enumerable:!0});return n||e(r,Symbol.toStringTag,{value:`Module`}),r};function n(e){let t=String(e),n=t.trim().toLowerCase();if(n.length===0)throw Error(`Unsafe attribute "" is not allowed (empty attribute name).`);if(n.startsWith(`on`))throw Error(`Unsafe attribute "${t}" is not allowed (event handler attributes are blocked).`);if(n===`style`)throw Error(`Unsafe attribute "style" is not allowed. Use the "style" object field instead.`)}function r(e,t,r){n(t),e.setAttribute(t,String(r))}function i(e,t){if(t){if(t.id&&(e.id=t.id),t.className&&(e.className=t.className),t.title&&(e.title=t.title),t.lang&&(e.lang=t.lang),t.dir&&(e.dir=t.dir),t.role&&r(e,`role`,t.role),typeof t.hidden==`boolean`&&(e.hidden=t.hidden),typeof t.tabIndex==`number`&&(e.tabIndex=t.tabIndex),typeof t.draggable==`boolean`&&(e.draggable=t.draggable),typeof t.spellCheck==`boolean`&&(e.spellcheck=t.spellCheck),t.translate&&r(e,`translate`,t.translate),t.contentEditable&&(e.contentEditable=t.contentEditable),t.style&&Object.assign(e.style,t.style),t.dataset)for(let[n,r]of Object.entries(t.dataset))e.dataset[n]=String(r);if(t.aria)for(let[n,i]of Object.entries(t.aria))r(e,`aria-${n}`,i);if(t.attrs)for(let[n,i]of Object.entries(t.attrs))r(e,n,i)}}function a(e,t,n){let r=document.createElement(e);return i(r,t),typeof n==`string`&&(r.textContent=n),r}function o(e,t){return a(e,t)}Object.defineProperty(exports,`i`,{enumerable:!0,get:function(){return t}}),Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return a}}),Object.defineProperty(exports,`r`,{enumerable:!0,get:function(){return o}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return i}});
+//# sourceMappingURL=dom.cjs.map

package/dist/cjs/chunks/dom.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom.cjs","names":[],"sources":["../../../src/ts/dom.ts"],"sourcesContent":["/**\n * DOM helpers for pkgn-sol element modules.\n *\n * @remarks\n * pkgn-sol is a design foundation, not a component framework. These helpers exist to\n * keep element entrypoints small, consistent, and safe across:\n * - Vanilla JS\n * - TypeScript direct consumption\n * - React and Vue lifecycle usage\n *\n * The helpers apply a curated set of common global attributes and provide an\n * escape hatch for additional attributes, while preventing common XSS footguns.\n *\n * @module\n * @category Internal\n */\n\n/**\n * Canonical element return type for a given HTML tag key.\n *\n * @remarks\n * This avoids \"invented\" DOM types (e.g. `HTMLAddressElement`) and always matches\n * what TypeScript's `lib.dom.d.ts` actually provides.\n *\n * @example\n * type HrEl = ElementOf<'hr'>; // HTMLHRElement\n * type AddressEl = ElementOf<'address'>; // HTMLElement (no special DOM interface)\n *\n * @category Types\n */\nexport type ElementOf<K extends keyof HTMLElementTagNameMap> = HTMLElementTagNameMap[K];\n\n/**\n * Values that are safely coerced to strings for attributes.\n *\n * @category Types\n */\nexport type AttrValue = string | number | boolean;\n\n/**\n * A curated, safe subset of HTML global attributes commonly applied to elements.\n *\n * @remarks\n * This type intentionally focuses on widely used global attributes and provides\n * a generic escape hatch via {@link GlobalAttrs.attrs} for less common cases.\n *\n * Security rules enforced by {@link applyGlobalAttrs}:\n * - Blocks inline event handler attributes like `onclick`\n * - Blocks the raw `style` attribute. Use {@link GlobalAttrs.style} instead\n *\n * @category Attributes\n */\nexport type GlobalAttrs = {\n  /**\n   * The element ID.\n   *\n   * @remarks\n   * Must be unique within the document.\n   */\n  id?: string;\n\n  /**\n   * The element class string.\n   *\n   * @remarks\n   * This maps to `class` in HTML. Use this instead of passing `class` through\n   * {@link GlobalAttrs.attrs}.\n   */\n  className?: string;\n\n  /**\n   * Advisory information, typically shown as a tooltip in browsers.\n   */\n  title?: string;\n\n  /**\n   * Language of the element's content.\n   *\n   * @remarks\n   * Useful when rendering mixed-language documents, or when an element's content\n   * differs from the page language.\n   */\n  lang?: string;\n\n  /**\n   * Text direction of the element's content.\n   */\n  dir?: 'ltr' | 'rtl' | 'auto';\n\n  /**\n   * Optional ARIA role.\n   *\n   * @remarks\n   * Prefer native semantics when possible. Only set `role` when needed.\n   */\n  role?: string;\n\n  /**\n   * Whether the element is hidden.\n   *\n   * @remarks\n   * Mirrors the `hidden` boolean attribute.\n   */\n  hidden?: boolean;\n\n  /**\n   * Tabbing order.\n   *\n   * @remarks\n   * Use with care. Setting a tab index on non-interactive elements can reduce\n   * usability and accessibility.\n   */\n  tabIndex?: number;\n\n  /**\n   * Whether the element is draggable.\n   */\n  draggable?: boolean;\n\n  /**\n   * Whether spellchecking is enabled for editable content.\n   *\n   * @remarks\n   * Mirrors `spellcheck`. This has effect primarily when `contentEditable` is used.\n   */\n  spellCheck?: boolean;\n\n  /**\n   * Translation hint for user agents.\n   *\n   * @remarks\n   * Maps to the `translate` attribute.\n   */\n  translate?: 'yes' | 'no';\n\n  /**\n   * Whether the element is editable.\n   *\n   * @remarks\n   * Use sparingly. Many apps are better served by explicit form controls.\n   */\n  contentEditable?: 'true' | 'false' | 'plaintext-only';\n\n  /**\n   * Inline style properties to assign to the element.\n   *\n   * @remarks\n   * This is safer than accepting a raw style string because it avoids the\n   * `style=\"...\"` attribute injection surface.\n   *\n   * This does not make untrusted input \"safe\". If callers build styles from\n   * untrusted sources, they must validate inputs appropriately.\n   */\n  style?: Partial<CSSStyleDeclaration>;\n\n  /**\n   * Dataset values applied as `data-*` attributes.\n   *\n   * @remarks\n   * Keys map to `HTMLElement.dataset` keys (camelCase), and values are coerced\n   * to strings.\n   *\n   * Example: `{ trackingId: \"123\" }` becomes `data-tracking-id=\"123\"`.\n   */\n  dataset?: Record<string, AttrValue>;\n\n  /**\n   * ARIA attribute values applied as `aria-*` attributes.\n   *\n   * @remarks\n   * Keys are appended to `aria-`. Example: `{ label: \"Close\" }` becomes\n   * `aria-label=\"Close\"`.\n   */\n  aria?: Record<string, AttrValue>;\n\n  /**\n   * Escape hatch for additional attributes not modeled above.\n   *\n   * @remarks\n   * This exists to keep the API practical without turning pkgn-sol into a full DOM\n   * abstraction layer.\n   *\n   * Security rules:\n   * - Attributes starting with `on` are rejected (blocks inline event handlers)\n   * - The `style` attribute is rejected (use {@link GlobalAttrs.style})\n   */\n  attrs?: Record<string, AttrValue>;\n};\n\n/**\n * Enforce attribute-name safety rules for attribute escape hatches.\n *\n * @remarks\n * This function blocks common XSS surfaces when callers attempt to set raw\n * attributes. It is intentionally conservative.\n *\n * @param name - The attribute name as provided by the caller.\n * @throws Error if the attribute name is not permitted.\n *\n * @category Security\n */\nfunction assertSafeAttrName(name: string): void {\n  const raw = String(name);\n  const n = raw.trim().toLowerCase();\n\n  if (n.length === 0) {\n    throw new Error('Unsafe attribute \"\" is not allowed (empty attribute name).');\n  }\n\n  // Block inline event handlers: onclick, onload, onerror, etc.\n  if (n.startsWith('on')) {\n    throw new Error(\n      `Unsafe attribute \"${raw}\" is not allowed (event handler attributes are blocked).`,\n    );\n  }\n\n  // Block raw style attribute injection. Use the `style` object field instead.\n  if (n === 'style') {\n    throw new Error(\n      'Unsafe attribute \"style\" is not allowed. Use the \"style\" object field instead.',\n    );\n  }\n}\n\n/**\n * Set an attribute on an element after applying security rules.\n *\n * @param el - The element to modify.\n * @param name - The attribute name.\n * @param value - The attribute value.\n * @throws Error if the attribute name is not permitted.\n *\n * @category Internal\n */\nfunction setAttr(el: Element, name: string, value: AttrValue): void {\n  assertSafeAttrName(name);\n  el.setAttribute(name, String(value));\n}\n\n/**\n * Apply {@link GlobalAttrs} to an existing element.\n *\n * @remarks\n * - This function does not attempt to \"sanitize\" content. It avoids the biggest\n *   footguns by refusing inline event handler attributes and raw `style`.\n * - Text content should be assigned via `textContent` rather than `innerHTML`.\n *\n * @param el - The element to apply attributes to.\n * @param a - The attribute bag. If omitted, the function is a no-op.\n *\n * @example\n * Apply common attributes:\n * ```ts\n * const p = document.createElement(\"p\");\n * applyGlobalAttrs(p, { id: \"intro\", className: \"lead\", lang: \"en\" });\n * ```\n *\n * @example\n * Apply dataset and ARIA:\n * ```ts\n * applyGlobalAttrs(p, {\n *   dataset: { trackingId: \"123\" },\n *   aria: { label: \"Intro paragraph\" }\n * });\n * ```\n *\n * @throws Error if {@link GlobalAttrs.attrs} or {@link GlobalAttrs.aria} contain\n * an unsafe attribute name.\n *\n * @category Attributes\n */\nexport function applyGlobalAttrs(el: HTMLElement, a?: GlobalAttrs): void {\n  if (!a) return;\n\n  if (a.id) el.id = a.id;\n  if (a.className) el.className = a.className;\n  if (a.title) el.title = a.title;\n\n  if (a.lang) el.lang = a.lang;\n  if (a.dir) el.dir = a.dir;\n\n  if (a.role) setAttr(el, 'role', a.role);\n\n  if (typeof a.hidden === 'boolean') el.hidden = a.hidden;\n  if (typeof a.tabIndex === 'number') el.tabIndex = a.tabIndex;\n\n  if (typeof a.draggable === 'boolean') el.draggable = a.draggable;\n  if (typeof a.spellCheck === 'boolean') el.spellcheck = a.spellCheck;\n\n  if (a.translate) setAttr(el, 'translate', a.translate);\n\n  if (a.contentEditable) el.contentEditable = a.contentEditable;\n\n  if (a.style) {\n    Object.assign(el.style, a.style);\n  }\n\n  if (a.dataset) {\n    for (const [k, v] of Object.entries(a.dataset)) {\n      // Dataset keys must be valid identifiers; consumers control this.\n      el.dataset[k] = String(v);\n    }\n  }\n\n  if (a.aria) {\n    for (const [k, v] of Object.entries(a.aria)) {\n      setAttr(el, `aria-${k}`, v);\n    }\n  }\n\n  if (a.attrs) {\n    for (const [k, v] of Object.entries(a.attrs)) {\n      setAttr(el, k, v);\n    }\n  }\n}\n\n/**\n * Create a DOM element, apply {@link GlobalAttrs}, and optionally set text content.\n *\n * @remarks\n * This helper is intentionally conservative:\n * - Uses `textContent`, not `innerHTML`, which prevents HTML interpretation.\n * - Does not accept a raw style string.\n *\n * @typeParam K - A key of {@link HTMLElementTagNameMap}, inferred from `tag`.\n * @param tag - The tag name to create.\n * @param attrs - Global attributes to apply.\n * @param text - Optional text content. Assigned via `textContent`.\n * @returns The created element with the correct DOM type for the tag.\n *\n * @example\n * ```ts\n * const p = createElement(\"p\", { className: \"lead\" }, \"Hello.\");\n * document.body.appendChild(p);\n * ```\n *\n * @throws Error if unsafe attributes are provided via {@link GlobalAttrs.attrs}\n * or {@link GlobalAttrs.aria}.\n *\n * @category DOM\n */\nexport function createElement<K extends keyof HTMLElementTagNameMap>(\n  tag: K,\n  attrs?: GlobalAttrs,\n  text?: string,\n): ElementOf<K> {\n  const el = document.createElement(tag) as ElementOf<K>;\n  applyGlobalAttrs(el as unknown as HTMLElement, attrs);\n\n  // Security: textContent does not interpret HTML.\n  if (typeof text === 'string') (el as unknown as Node).textContent = text;\n\n  return el;\n}\n\n/**\n * Create a void element (e.g. `<hr>`, `<br>`) and apply {@link GlobalAttrs}.\n *\n * @remarks\n * Use this when the element must never carry text content.\n *\n * @typeParam K - A key of {@link HTMLElementTagNameMap}, inferred from `tag`.\n * @param tag - The tag name to create.\n * @param attrs - Global attributes to apply.\n * @returns The created element with the correct DOM type for the tag.\n *\n * @throws Error if unsafe attributes are provided via {@link GlobalAttrs.attrs}\n * or {@link GlobalAttrs.aria}.\n *\n * @category DOM\n */\nexport function createVoidElement<K extends keyof HTMLElementTagNameMap>(\n  tag: K,\n  attrs?: GlobalAttrs,\n): ElementOf<K> {\n  return createElement(tag, attrs);\n}\n"],"mappings":"oJAyMA,SAAS,EAAmB,EAAoB,CAC9C,IAAM,EAAM,OAAO,EAAK,CAClB,EAAI,EAAI,MAAM,CAAC,aAAa,CAElC,GAAI,EAAE,SAAW,EACf,MAAU,MAAM,6DAA6D,CAI/E,GAAI,EAAE,WAAW,KAAK,CACpB,MAAU,MACR,qBAAqB,EAAI,0DAC1B,CAIH,GAAI,IAAM,QACR,MAAU,MACR,iFACD,CAcL,SAAS,EAAQ,EAAa,EAAc,EAAwB,CAClE,EAAmB,EAAK,CACxB,EAAG,aAAa,EAAM,OAAO,EAAM,CAAC,CAmCtC,SAAgB,EAAiB,EAAiB,EAAuB,CAClE,KAyBL,IAvBI,EAAE,KAAI,EAAG,GAAK,EAAE,IAChB,EAAE,YAAW,EAAG,UAAY,EAAE,WAC9B,EAAE,QAAO,EAAG,MAAQ,EAAE,OAEtB,EAAE,OAAM,EAAG,KAAO,EAAE,MACpB,EAAE,MAAK,EAAG,IAAM,EAAE,KAElB,EAAE,MAAM,EAAQ,EAAI,OAAQ,EAAE,KAAK,CAEnC,OAAO,EAAE,QAAW,YAAW,EAAG,OAAS,EAAE,QAC7C,OAAO,EAAE,UAAa,WAAU,EAAG,SAAW,EAAE,UAEhD,OAAO,EAAE,WAAc,YAAW,EAAG,UAAY,EAAE,WACnD,OAAO,EAAE,YAAe,YAAW,EAAG,WAAa,EAAE,YAErD,EAAE,WAAW,EAAQ,EAAI,YAAa,EAAE,UAAU,CAElD,EAAE,kBAAiB,EAAG,gBAAkB,EAAE,iBAE1C,EAAE,OACJ,OAAO,OAAO,EAAG,MAAO,EAAE,MAAM,CAG9B,EAAE,QACJ,IAAK,GAAM,CAAC,EAAG,KAAM,OAAO,QAAQ,EAAE,QAAQ,CAE5C,EAAG,QAAQ,GAAK,OAAO,EAAE,CAI7B,GAAI,EAAE,KACJ,IAAK,GAAM,CAAC,EAAG,KAAM,OAAO,QAAQ,EAAE,KAAK,CACzC,EAAQ,EAAI,QAAQ,IAAK,EAAE,CAI/B,GAAI,EAAE,MACJ,IAAK,GAAM,CAAC,EAAG,KAAM,OAAO,QAAQ,EAAE,MAAM,CAC1C,EAAQ,EAAI,EAAG,EAAE,EA8BvB,SAAgB,EACd,EACA,EACA,EACc,CACd,IAAM,EAAK,SAAS,cAAc,EAAI,CAMtC,OALA,EAAiB,EAA8B,EAAM,CAGjD,OAAO,GAAS,WAAU,EAAwB,YAAc,GAE7D,EAmBT,SAAgB,EACd,EACA,EACc,CACd,OAAO,EAAc,EAAK,EAAM"}

package/dist/cjs/chunks/inline.cjs

@@ -0,0 +1,2 @@
+const e=require(`./dom.cjs`),t=require(`../elements/inline/a/a.cjs`),n=require(`../elements/inline/abbr/abbr.cjs`),r=require(`../elements/inline/b/b.cjs`),i=require(`../elements/inline/small/small.cjs`),a=require(`../elements/inline/strong/strong.cjs`),o=require(`../elements/inline/cite/cite.cjs`),s=require(`../elements/inline/code/code.cjs`),c=require(`../elements/inline/data/data.cjs`),l=require(`../elements/inline/dfn/dfn.cjs`),u=require(`../elements/inline/em/em.cjs`),d=require(`../elements/inline/i/i.cjs`),f=require(`../elements/inline/kbd/kbd.cjs`),p=require(`../elements/inline/mark/mark.cjs`),m=require(`../elements/inline/q/q.cjs`),h=require(`../elements/inline/rb/rb.cjs`),g=require(`../elements/inline/rt/rt.cjs`),_=require(`../elements/inline/rtc/rtc.cjs`),v=require(`../elements/inline/ruby/ruby.cjs`),y=require(`../elements/inline/s/s.cjs`),b=require(`../elements/inline/samp/samp.cjs`),x=require(`../elements/inline/sub/sub.cjs`),S=require(`../elements/inline/sup/sup.cjs`),C=require(`../elements/inline/time/time.cjs`),w=require(`../elements/inline/u/u.cjs`),T=require(`../elements/inline/var/var.cjs`);var E=e.i({RP_SELECTOR:()=>`rp`,RP_TAG:()=>`rp`,createRp:()=>O,enhanceRps:()=>k});function D(e){if(!e)return;let{aria:t,...n}=e;if(!t)return n;let r={};return typeof t.label==`string`&&(r.label=t.label),typeof t.labelledby==`string`&&(r.labelledby=t.labelledby),typeof t.hidden==`boolean`&&(r.hidden=t.hidden),Object.keys(r).length>0?{...n,aria:r}:n}function O(t,n){return e.n(`rp`,D(n),t)}function k(e=document){}var A=e.i({abbr:()=>n.t,anchor:()=>t.t,b:()=>r.t,cite:()=>o.t,code:()=>s.t,data:()=>c.t,dfn:()=>l.t,em:()=>u.t,italic:()=>d.t,kbd:()=>f.t,mark:()=>p.t,q:()=>m.t,rb:()=>h.t,rp:()=>E,rt:()=>g.t,rtc:()=>_.t,ruby:()=>v.t,s:()=>y.t,samp:()=>b.t,small:()=>i.t,strong:()=>a.t,sub:()=>x.t,sup:()=>S.t,time:()=>C.t,u:()=>w.t,var:()=>T.t});Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return E}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return A}});
+//# sourceMappingURL=inline.cjs.map

package/dist/cjs/chunks/inline.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"inline.cjs","names":[],"sources":["../../../src/elements/inline/rp/index.ts","../../../src/elements/inline/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: Rp element helpers.\n *\n * @remarks\n * The rp element (`<rp>`) provides fallback parentheses (or other markers) for\n * ruby annotations when ruby rendering is not supported.\n *\n * Best-practice guidance:\n * - Use `<rp>` only inside `<ruby>` as a fallback wrapper around `<rt>` content.\n * - Keep `<rp>` content short (commonly \"(\" and \")\").\n * - Do not use `<rp>` for general punctuation or layout. Use normal text instead.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create rp 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 * References:\n * - MDN: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/rp\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 rp elements.\n *\n * @category Constants\n */\nexport const RP_TAG = 'rp' as const;\n\n/**\n * A CSS selector targeting rp elements.\n *\n * @category Constants\n */\nexport const RP_SELECTOR = 'rp';\n\n/**\n * Attribute bag for rp creation/enhancement.\n *\n * @remarks\n * Rp 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 RpAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link RpAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The rp attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: RpAttrs): 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 rp 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 rp element (commonly \"(\" or \")\").\n * @param attrs - Optional attributes to apply.\n * @returns The created `<rp>` element.\n *\n * @example\n * Create a ruby fallback wrapper:\n * ```ts\n * import { createRp } from \"@lnpg/pkgn-sol/elements/inline/rp\";\n *\n * const open = createRp(\"(\");\n * const close = createRp(\")\");\n * ```\n *\n * @category DOM\n */\nexport function createRp(text?: string, attrs?: RpAttrs): ElementOf<typeof RP_TAG> {\n  return createElement(RP_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance rp 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 enhanceRps(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for rp.\n  void root;\n}\n","/**\n * Inline text element factories.\n *\n * Provides framework-agnostic factory functions for semantic and typographic\n * inline elements used inside paragraphs, headings, labels, and other text\n * content.\n *\n * These factories:\n * - Create semantic inline 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 * Inline elements refine meaning (emphasis, citations, abbreviations), express\n * user input or code, and support annotations such as Ruby text.\n *\n * @module elements/inline\n * @since 0.1.0\n */\n\n/**\n * `<a>` element factory namespace.\n *\n * Represents a hyperlink to another location.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a\n */\nexport * as anchor from './a';\n\n/**\n * `<abbr>` element factory namespace.\n *\n * Represents an abbreviation or acronym, typically with a `title` expansion.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/abbr\n */\nexport * as abbr from './abbr';\n\n/**\n * `<b>` element factory namespace.\n *\n * Represents stylistically offset text without conveying extra importance.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/b\n */\nexport * as b from './b';\n\n/**\n * `<small>` element factory namespace.\n *\n * Represents side comments or small print.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/small\n */\nexport * as small from './small';\n\n/**\n * `<strong>` element factory namespace.\n *\n * Represents strong importance, seriousness, or urgency.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/strong\n */\nexport * as strong from './strong';\n\n/**\n * `<cite>` element factory namespace.\n *\n * Represents the title of a cited creative work.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/cite\n */\nexport * as cite from './cite';\n\n/**\n * `<code>` element factory namespace.\n *\n * Represents a fragment of computer code.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/code\n */\nexport * as code from './code';\n\n/**\n * `<data>` element factory namespace.\n *\n * Associates a machine-readable value with human-readable content.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/data\n */\nexport * as data from './data';\n\n/**\n * `<dfn>` element factory namespace.\n *\n * Represents the defining instance of a term.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/dfn\n */\nexport * as dfn from './dfn';\n\n/**\n * `<em>` element factory namespace.\n *\n * Represents stress emphasis.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/em\n */\nexport * as em from './em';\n\n/**\n * `<i>` element factory namespace.\n *\n * Represents text in an alternate voice or mood, or otherwise offset from normal prose.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/i\n */\nexport * as italic from './i';\n\n/**\n * `<kbd>` element factory namespace.\n *\n * Represents user input, typically keyboard input.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/kbd\n */\nexport * as kbd from './kbd';\n\n/**\n * `<mark>` element factory namespace.\n *\n * Represents text marked or highlighted for reference.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/mark\n */\nexport * as mark from './mark';\n\n/**\n * `<q>` element factory namespace.\n *\n * Represents a short inline quotation.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/q\n */\nexport * as q from './q';\n\n/**\n * `<rb>` element factory namespace.\n *\n * Represents the base text component of a ruby annotation.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/rb\n */\nexport * as rb from './rb';\n\n/**\n * `<rp>` element factory namespace.\n *\n * Represents fallback parentheses for ruby annotations.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/rp\n */\nexport * as rp from './rp';\n\n/**\n * `<rt>` element factory namespace.\n *\n * Represents ruby text, the pronunciation/annotation for base text.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/rt\n */\nexport * as rt from './rt';\n\n/**\n * `<rtc>` element factory namespace.\n *\n * Represents a ruby text container for semantic annotation groups.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/rtc\n */\nexport * as rtc from './rtc';\n\n/**\n * `<ruby>` element factory namespace.\n *\n * Represents ruby annotations for East Asian typography.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/ruby\n */\nexport * as ruby from './ruby';\n\n/**\n * `<s>` element factory namespace.\n *\n * Represents content that is no longer accurate or relevant.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/s\n */\nexport * as s from './s';\n\n/**\n * `<samp>` element factory namespace.\n *\n * Represents sample output from a program or computing system.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/samp\n */\nexport * as samp from './samp';\n\n/**\n * `<sub>` element factory namespace.\n *\n * Represents subscript text.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/sub\n */\nexport * as sub from './sub';\n\n/**\n * `<sup>` element factory namespace.\n *\n * Represents superscript text.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/sup\n */\nexport * as sup from './sup';\n\n/**\n * `<time>` element factory namespace.\n *\n * Represents a specific time period, optionally with a machine-readable `datetime`.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/time\n */\nexport * as time from './time';\n\n/**\n * `<u>` element factory namespace.\n *\n * Represents unarticulated annotation, such as misspelled text or proper names in some contexts.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/u\n */\nexport * as u from './u';\n\n/**\n * `<var>` element factory namespace.\n *\n * Represents a variable in a mathematical expression or programming context.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/var\n */\nexport * as var from './var';\n"],"mappings":"urCA8FA,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,EA2BrD,SAAgB,EAAS,EAAe,EAA2C,CACjF,OAAO,EAAA,EAAA,KAAsB,EAAc,EAAM,CAAE,EAAK,CAqB1D,SAAgB,EAAW,EAAmB,SAAgB"}

package/dist/cjs/chunks/pkgn-sol.cjs

@@ -0,0 +1,2 @@
+throw Error(`Could not resolve "tailwindcss/plugin" imported by "@lnpg/pkgn-sol". Is it installed?`);
+//# sourceMappingURL=pkgn-sol.cjs.map

package/dist/cjs/chunks/pkgn-sol.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pkgn-sol.cjs","names":[],"sources":["../../../__vite-optional-peer-dep:tailwindcss/plugin:@lnpg/pkgn-sol"],"sourcesContent":["export default {};\nthrow new Error(`Could not resolve \"tailwindcss/plugin\" imported by \"@lnpg/pkgn-sol\". Is it installed?`)"],"mappings":"AACA,MAAU,MAAM,wFAAA"}

package/dist/cjs/elements/break/br/br.cjs

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

package/dist/cjs/elements/break/br/br.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"br.cjs","names":[],"sources":["../../../../../src/elements/break/br/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: Br element helpers.\n *\n * @remarks\n * The br element (`<br>`) represents a line break within phrasing content.\n *\n * Best-practice guidance:\n * - Use `<br>` only for line breaks within text (e.g. poems, addresses).\n * - Do not use `<br>` for layout or spacing. Use CSS instead.\n * - `<br>` is a void element and must not contain text content.\n *\n * This module provides a small, framework-agnostic helper so consumers can:\n * - create line breaks safely in vanilla JS/TS\n * - apply consistent global attributes via pkgn-sol's hardened DOM helpers\n * - rely on a stable enhancement hook for future evolution\n *\n * This module has no side effects and does not mutate the DOM unless you call\n * its functions.\n *\n * @module\n * @category Elements\n */\n\nimport { createVoidElement, type ElementOf, type GlobalAttrs } from '../../../ts/dom';\n\n/**\n * Structured ARIA input supported by 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 line break elements.\n *\n * @category Constants\n */\nexport const BR_TAG = 'br' as const;\n\n/**\n * A CSS selector targeting br elements.\n *\n * @category Constants\n */\nexport const BR_SELECTOR = 'br';\n\n/**\n * Attribute bag for br creation/enhancement.\n *\n * @remarks\n * `<br>` accepts only global HTML attributes.\n * It does not accept text content and has no element-specific attributes.\n *\n * @category Attributes\n */\nexport type BrAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link BrAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The br attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: BrAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, ...rest } = attrs;\n\n  if (!aria) return rest;\n\n  const mappedAria: NonNullable<GlobalAttrs['aria']> = {};\n\n  if (typeof aria.label === 'string') mappedAria.label = aria.label;\n  if (typeof aria.labelledby === 'string') mappedAria.labelledby = aria.labelledby;\n  if (typeof aria.hidden === 'boolean') mappedAria.hidden = aria.hidden;\n\n  const hasMapped = Object.keys(mappedAria).length > 0;\n\n  return hasMapped ? { ...rest, aria: mappedAria } : rest;\n}\n\n/**\n * Create a br element with optional global attributes.\n *\n * @remarks\n * - `<br>` is a void element and does not accept text content.\n * - Global attributes are applied via pkgn-sol's shared DOM helper,\n *   including security guards that block inline event handler attributes\n *   (e.g. `onclick`) and raw `style` attribute strings.\n *\n * @param attrs - Optional attributes to apply.\n * @returns The created `<br>` element.\n *\n * @example\n * ```ts\n * import { createBr } from \"@lnpg/pkgn-sol/elements/break/br\";\n *\n * paragraph.appendChild(createBr());\n * ```\n *\n * @category DOM\n */\nexport function createBr(attrs?: BrAttrs): ElementOf<typeof BR_TAG> {\n  return createVoidElement(BR_TAG, toGlobalAttrs(attrs));\n}\n\n/**\n * Enhance br elements within a given root.\n *\n * @remarks\n * This is intentionally a no-op in `0.1.0`.\n *\n * It exists to establish a stable enhancement pattern across all elements.\n *\n * @param root - The node to search within. Defaults to `document`.\n *\n * @category Enhancement\n */\nexport function enhanceBrs(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for br.\n  void root;\n}\n"],"mappings":"gMA0Da,EAAS,KAOT,EAAc,KA0B3B,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,EAwBrD,SAAgB,EAAS,EAA2C,CAClE,OAAO,EAAA,EAAA,KAA0B,EAAc,EAAM,CAAC,CAexD,SAAgB,EAAW,EAAmB,SAAgB"}

package/dist/cjs/elements/break/break.cjs

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

package/dist/cjs/elements/break/break.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"break.cjs","names":[],"sources":["../../../../src/elements/break/index.ts"],"sourcesContent":["/**\n * Line and word break element factories.\n *\n * Provides framework-agnostic factory functions for elements that control\n * line breaking and word breaking behaviour within text flow.\n *\n * These factories:\n * - Create semantic HTML break elements using pkgn-sol's hardened DOM helpers.\n * - Forward curated global attributes.\n * - Enforce structured ARIA input where applicable.\n * - Prevent unsafe attribute injection.\n *\n * @module elements/break\n * @since 0.1.0\n */\n\n/**\n * `<br>` element factory namespace.\n *\n * Represents a line break opportunity within text.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/br\n */\nexport * as br from './br';\n\n/**\n * `<wbr>` element factory namespace.\n *\n * Represents a word break opportunity within text.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/wbr\n */\nexport * as wbr from './wbr';\n"],"mappings":""}

package/dist/cjs/elements/break/wbr/wbr.cjs

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

package/dist/cjs/elements/break/wbr/wbr.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"wbr.cjs","names":[],"sources":["../../../../../src/elements/break/wbr/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: Wbr element helpers.\n *\n * @remarks\n * The wbr element (`<wbr>`) represents a word break opportunity.\n *\n * Best-practice guidance:\n * - Use `<wbr>` to suggest optional break points within long words or URLs.\n * - It does not force a line break; the browser decides if a break is needed.\n * - Do not use `<wbr>` for layout or spacing. Use CSS instead.\n * - `<wbr>` is a void element and must not contain text content.\n *\n * This module provides a small, framework-agnostic helper so consumers can:\n * - create word break opportunities safely in vanilla JS/TS\n * - apply consistent global attributes via pkgn-sol's hardened DOM helpers\n * - rely on a stable enhancement hook for future evolution\n *\n * This module has no side effects and does not mutate the DOM unless you call\n * its functions.\n *\n * @module\n * @category Elements\n */\n\nimport { createVoidElement, type ElementOf, type GlobalAttrs } from '../../../ts/dom';\n\n/**\n * Structured ARIA input supported by 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 word break opportunity elements.\n *\n * @category Constants\n */\nexport const WBR_TAG = 'wbr' as const;\n\n/**\n * A CSS selector targeting wbr elements.\n *\n * @category Constants\n */\nexport const WBR_SELECTOR = 'wbr';\n\n/**\n * Attribute bag for wbr creation/enhancement.\n *\n * @remarks\n * `<wbr>` accepts only global HTML attributes.\n * It does not accept text content and has no element-specific attributes.\n *\n * @category Attributes\n */\nexport type WbrAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link WbrAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The wbr attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: WbrAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, ...rest } = attrs;\n\n  if (!aria) return rest;\n\n  const mappedAria: NonNullable<GlobalAttrs['aria']> = {};\n\n  if (typeof aria.label === 'string') mappedAria.label = aria.label;\n  if (typeof aria.labelledby === 'string') mappedAria.labelledby = aria.labelledby;\n  if (typeof aria.hidden === 'boolean') mappedAria.hidden = aria.hidden;\n\n  const hasMapped = Object.keys(mappedAria).length > 0;\n\n  return hasMapped ? { ...rest, aria: mappedAria } : rest;\n}\n\n/**\n * Create a wbr element with optional global attributes.\n *\n * @remarks\n * - `<wbr>` is a void element and does not accept text content.\n * - Global attributes are applied via pkgn-sol's shared DOM helper,\n *   including security guards that block inline event handler attributes\n *   (e.g. `onclick`) and raw `style` attribute strings.\n *\n * @param attrs - Optional attributes to apply.\n * @returns The created `<wbr>` element.\n *\n * @example\n * ```ts\n * import { createWbr } from \"@lnpg/pkgn-sol/elements/break/wbr\";\n *\n * paragraph.appendChild(createWbr());\n * ```\n *\n * @category DOM\n */\nexport function createWbr(attrs?: WbrAttrs): ElementOf<typeof WBR_TAG> {\n  return createVoidElement(WBR_TAG, toGlobalAttrs(attrs));\n}\n\n/**\n * Enhance wbr elements within a given root.\n *\n * @remarks\n * This is intentionally a no-op in `0.1.0`.\n *\n * It exists to establish a stable enhancement pattern across all elements.\n *\n * @param root - The node to search within. Defaults to `document`.\n *\n * @category Enhancement\n */\nexport function enhanceWbrs(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for wbr.\n  void root;\n}\n"],"mappings":"sMA2Da,EAAU,MAOV,EAAe,MA0B5B,SAAS,EAAc,EAA2C,CAChE,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,EAwBrD,SAAgB,EAAU,EAA6C,CACrE,OAAO,EAAA,EAAA,MAA2B,EAAc,EAAM,CAAC,CAezD,SAAgB,EAAY,EAAmB,SAAgB"}

package/dist/cjs/elements/container/container.cjs

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

package/dist/cjs/elements/container/container.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.cjs","names":[],"sources":["../../../../src/elements/container/index.ts"],"sourcesContent":["/**\n * Container element factories.\n *\n * Provides framework-agnostic factory functions for generic container\n * elements used to group flow or inline content.\n *\n * These factories:\n * - Create semantic HTML elements using pkgn-sol's hardened DOM helpers.\n * - Forward curated global attributes.\n * - Enforce structured ARIA input.\n * - Prevent unsafe attribute injection.\n *\n * @module elements/container\n * @since 0.1.0\n */\n\n/**\n * `<div>` element factory namespace.\n *\n * Represents a generic block-level container with no semantic meaning.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/div\n */\nexport * as div from './div';\n\n/**\n * `<span>` element factory namespace.\n *\n * Represents a generic inline container with no semantic meaning.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/span\n */\nexport * as span from './span';\n"],"mappings":""}

package/dist/cjs/elements/container/div/div.cjs

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

package/dist/cjs/elements/container/div/div.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"div.cjs","names":[],"sources":["../../../../../src/elements/container/div/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: Div element helpers.\n *\n * @remarks\n * The div element (`<div>`) is a non-semantic, generic container.\n *\n * Best-practice guidance:\n * - Prefer semantic elements when available (e.g. `<section>`, `<nav>`, `<article>`).\n * - Use `<div>` as a last resort when no semantic element fits.\n * - Avoid obsolete attributes like `align`; use CSS instead.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create div containers in vanilla JS/TS without templates\n * - apply consistent global attributes safely\n * - use a stable \"enhancement\" hook if 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 div containers.\n *\n * @category Constants\n */\nexport const DIV_TAG = 'div' as const;\n\n/**\n * A CSS selector targeting div elements.\n *\n * @category Constants\n */\nexport const DIV_SELECTOR = 'div';\n\n/**\n * Attribute bag for div creation/enhancement.\n *\n * @remarks\n * Div elements accept standard HTML global attributes.\n *\n * 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 DivAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link DivAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The div attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: DivAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, ...rest } = attrs;\n\n  if (!aria) return rest;\n\n  const mappedAria: NonNullable<GlobalAttrs['aria']> = {};\n\n  if (typeof aria.label === 'string') mappedAria.label = aria.label;\n  if (typeof aria.labelledby === 'string') mappedAria.labelledby = aria.labelledby;\n  if (typeof aria.hidden === 'boolean') mappedAria.hidden = aria.hidden;\n\n  // Only attach `aria` if something was actually defined.\n  const hasMapped = Object.keys(mappedAria).length > 0;\n\n  return hasMapped ? { ...rest, aria: mappedAria } : rest;\n}\n\n/**\n * Create a div element with optional text content and global attributes.\n *\n * @remarks\n * - Text content is assigned via `textContent` (never `innerHTML`).\n * - Global attributes are applied via 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 div.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<div>` element.\n *\n * @example\n * Create and append a div:\n * ```ts\n * import { createDiv } from \"@lnpg/pkgn-sol/elements/container/div\";\n *\n * document.body.appendChild(\n *   createDiv(\"Hello.\", { className: \"box\", id: \"root\" })\n * );\n * ```\n *\n * @category DOM\n */\nexport function createDiv(text?: string, attrs?: DivAttrs): ElementOf<typeof DIV_TAG> {\n  return createElement(DIV_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance div elements within a given root.\n *\n * @remarks\n * This is intentionally a no-op in `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 enhanceDivs(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for div.\n  void root;\n}\n"],"mappings":"sMA0Da,EAAU,MAOV,EAAe,MA4B5B,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,EA4BrD,SAAgB,EAAU,EAAe,EAA6C,CACpF,OAAO,EAAA,EAAA,MAAuB,EAAc,EAAM,CAAE,EAAK,CAqB3D,SAAgB,EAAY,EAAmB,SAAgB"}

package/dist/cjs/elements/container/span/span.cjs

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

package/dist/cjs/elements/container/span/span.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"span.cjs","names":[],"sources":["../../../../../src/elements/container/span/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: Span element helpers.\n *\n * @remarks\n * The `<span>` element is a generic inline container for phrasing content.\n * It has no inherent semantics and should be used only when no more suitable\n * semantic element exists.\n *\n * This module:\n * - Creates `<span>` elements via pkgn-sol's DOM helpers (no direct DOM calls).\n * - Applies a curated subset of global attributes safely.\n * - Exposes an enhancement hook (currently a no-op) for consistency and\n *   potential future progressive enhancements.\n *\n * @module\n * @category Elements\n */\n\nimport { createElement, type ElementOf, type GlobalAttrs } from '../../../ts/dom';\n\n/**\n * Structured ARIA input supported by pkgn-sol element factories.\n *\n * @remarks\n * This is a small, typed subset intended to prevent typo-driven ARIA bugs and\n * keep the API practical. Values are mapped into {@link GlobalAttrs.aria}.\n *\n * @category Attributes\n */\nexport type StructuredAria = {\n  /**\n   * Accessible label, mapped to `aria-label`.\n   */\n  label?: string;\n\n  /**\n   * ID reference to the labelling element(s), mapped to `aria-labelledby`.\n   */\n  labelledby?: string;\n\n  /**\n   * Decorative/hidden hint, mapped to `aria-hidden`.\n   */\n  hidden?: boolean;\n};\n\n/**\n * The semantic tag name for span.\n *\n * @category Constants\n */\nexport const SPAN_TAG = 'span' as const;\n\n/**\n * A CSS selector targeting span elements.\n *\n * @category Constants\n */\nexport const SPAN_SELECTOR = 'span';\n\n/**\n * Attribute bag for span creation/enhancement.\n *\n * @remarks\n * `<span>` supports HTML global attributes only.\n *\n * pkgn-sol additionally supports a typed, structured ARIA input that is mapped into\n * {@link GlobalAttrs.aria} without modifying the shared DOM helpers.\n *\n * @category Attributes\n */\nexport type SpanAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link SpanAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The span attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: SpanAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, ...rest } = attrs;\n\n  if (!aria) return rest;\n\n  const mappedAria: NonNullable<GlobalAttrs['aria']> = {};\n\n  if (typeof aria.label === 'string') mappedAria.label = aria.label;\n  if (typeof aria.labelledby === 'string') mappedAria.labelledby = aria.labelledby;\n  if (typeof aria.hidden === 'boolean') mappedAria.hidden = aria.hidden;\n\n  return Object.keys(mappedAria).length > 0 ? { ...rest, aria: mappedAria } : rest;\n}\n\n/**\n * Create a span element with optional text content and global attributes.\n *\n * @remarks\n * - Text is assigned via `textContent` (never `innerHTML`).\n * - Global attributes are applied via pkgn-sol's shared DOM helper, which enforces:\n *   - No inline event handler attributes (e.g. `onclick`)\n *   - No raw `style` attribute injection (use the `style` object field)\n *   - No empty attribute names\n *\n * @param text - Optional text content for the span.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<span>` element.\n *\n * @category DOM\n */\nexport function createSpan(text?: string, attrs?: SpanAttrs): ElementOf<typeof SPAN_TAG> {\n  return createElement(SPAN_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance span elements within a given root.\n *\n * @remarks\n * Intentionally a no-op in `0.1.0`. This exists to provide a stable, consistent\n * integration hook across element modules.\n *\n * @param root - The node to search within. Defaults to `document`.\n *\n * @category Enhancement\n */\nexport function enhanceSpans(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for span.\n  void root;\n}\n"],"mappings":"kMAmDa,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,CAMvD,OAJI,OAAO,EAAK,OAAU,WAAU,EAAW,MAAQ,EAAK,OACxD,OAAO,EAAK,YAAe,WAAU,EAAW,WAAa,EAAK,YAClE,OAAO,EAAK,QAAW,YAAW,EAAW,OAAS,EAAK,QAExD,OAAO,KAAK,EAAW,CAAC,OAAS,EAAI,CAAE,GAAG,EAAM,KAAM,EAAY,CAAG,EAmB9E,SAAgB,EAAW,EAAe,EAA+C,CACvF,OAAO,EAAA,EAAc,EAAU,EAAc,EAAM,CAAE,EAAK,CAc5D,SAAgB,EAAa,EAAmB,SAAgB"}

package/dist/cjs/elements/figure/figcaption/figcaption.cjs

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

package/dist/cjs/elements/figure/figcaption/figcaption.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"figcaption.cjs","names":[],"sources":["../../../../../src/elements/figure/figcaption/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: Figcaption element helpers.\n *\n * @remarks\n * The figcaption element (`<figcaption>`) represents a caption or legend for\n * the rest of the contents of its parent `<figure>` element.\n *\n * Best-practice guidance (summary):\n * - Use `<figcaption>` as the caption for a `<figure>`.\n * - Place it as the first or last child of the `<figure>` where possible.\n * - Keep the visible caption text human-friendly and meaningful.\n * - Do not use `<figcaption>` purely for styling. Use CSS instead.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create `<figcaption>` 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 * The semantic tag name for figcaption.\n *\n * @category Constants\n */\nexport const FIGCAPTION_TAG = 'figcaption' as const;\n\n/**\n * A CSS selector targeting figcaption elements.\n *\n * @category Constants\n */\nexport const FIGCAPTION_SELECTOR = 'figcaption';\n\n/**\n * Attribute bag for figcaption creation/enhancement.\n *\n * @remarks\n * `<figcaption>` 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 FigcaptionAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link FigcaptionAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The figcaption attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: FigcaptionAttrs): 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 figcaption 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 figcaption element.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<figcaption>` element.\n *\n * @example\n * ```ts\n * import { createFigcaption } from \"@lnpg/pkgn-sol/elements/figure/figcaption\";\n *\n * const c = createFigcaption(\"Kitchen layout, 2026\", { className: \"caption\" });\n * document.body.appendChild(c);\n * ```\n *\n * @category DOM\n */\nexport function createFigcaption(\n  text?: string,\n  attrs?: FigcaptionAttrs,\n): ElementOf<typeof FIGCAPTION_TAG> {\n  return createElement(FIGCAPTION_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance figcaption 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 enhanceFigcaptions(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for figcaption.\n  void root;\n}\n"],"mappings":"0NA4Da,EAAiB,aAOjB,EAAsB,aA4BnC,SAAS,EAAc,EAAkD,CACvE,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,EA0BrD,SAAgB,EACd,EACA,EACkC,CAClC,OAAO,EAAA,EAAc,EAAgB,EAAc,EAAM,CAAE,EAAK,CAalE,SAAgB,EAAmB,EAAmB,SAAgB"}

package/dist/cjs/elements/figure/figure/figure.cjs

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

package/dist/cjs/elements/figure/figure/figure.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"figure.cjs","names":[],"sources":["../../../../../src/elements/figure/figure/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: Figure element helpers.\n *\n * @remarks\n * The figure element (`<figure>`) represents self-contained content, optionally\n * with a caption provided by a nested `<figcaption>`.\n *\n * Best-practice guidance:\n * - Use `<figure>` for content referenced from the main flow but which could be\n *   moved elsewhere without affecting the document's meaning.\n * - If a caption is present, use `<figcaption>` as the first or last child.\n * - Avoid using `<figure>` purely as a styling hook.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create `<figure>` 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/figure\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 figure.\n *\n * @category Constants\n */\nexport const FIGURE_TAG = 'figure' as const;\n\n/**\n * A CSS selector targeting figure elements.\n *\n * @category Constants\n */\nexport const FIGURE_SELECTOR = 'figure';\n\n/**\n * Attribute bag for figure creation/enhancement.\n *\n * @remarks\n * `<figure>` supports standard HTML global attributes only.\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 FigureAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link FigureAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The figure attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: FigureAttrs): 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 figure 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 * Note: `<figure>` typically contains richer flow content (images, code blocks,\n * quotes, etc.). This helper supports optional text for parity with other pkgn-sol\n * element factories; consumers can append child nodes as needed.\n *\n * @param text - Optional text content for the figure.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<figure>` element.\n *\n * @example\n * Create a figure and append custom content:\n * ```ts\n * import { createFigure } from \"@lnpg/pkgn-sol/elements/figure/figure\";\n * import { createFigcaption } from \"@lnpg/pkgn-sol/elements/figure/figcaption\";\n *\n * const fig = createFigure(undefined, { className: \"media\" });\n * fig.appendChild(document.createElement(\"img\"));\n * fig.appendChild(createFigcaption(\"Caption\"));\n * ```\n *\n * @category DOM\n */\nexport function createFigure(text?: string, attrs?: FigureAttrs): ElementOf<typeof FIGURE_TAG> {\n  return createElement(FIGURE_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance figure 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 enhanceFigures(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for figure.\n  void root;\n}\n"],"mappings":"0MA8Da,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,EAiCrD,SAAgB,EAAa,EAAe,EAAmD,CAC7F,OAAO,EAAA,EAAc,EAAY,EAAc,EAAM,CAAE,EAAK,CAa9D,SAAgB,EAAe,EAAmB,SAAgB"}

package/dist/cjs/elements/figure/figure.cjs

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

package/dist/cjs/elements/figure/figure.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"figure.cjs","names":[],"sources":["../../../../src/elements/figure/index.ts"],"sourcesContent":["/**\n * Figure and figcaption element factories.\n *\n * Provides framework-agnostic factory functions for the semantic HTML\n * `<figure>` and `<figcaption>` elements.\n *\n * These factories:\n * - Create semantic figure structures using pkgn-sol's hardened DOM helpers.\n * - Forward curated global attributes.\n * - Enforce structured, typed attribute bags.\n * - Preserve correct semantic relationships between media and captions.\n * - Prevent unsafe attribute injection.\n *\n * The `<figure>` element represents self-contained content such as images,\n * diagrams, code listings, or illustrations, optionally paired with a\n * `<figcaption>` that provides a caption or legend.\n *\n * @module elements/figure\n * @since 0.1.0\n */\n\n/**\n * `<figcaption>` element factory namespace.\n *\n * Represents a caption or legend describing the contents of a `<figure>`.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/figcaption\n */\nexport * as figcaption from './figcaption';\n\n/**\n * `<figure>` element factory namespace.\n *\n * Represents self-contained content that may include media, illustrations,\n * code examples, or diagrams, optionally associated with a `<figcaption>`.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/figure\n */\nexport * as figure from './figure';\n"],"mappings":""}

package/dist/cjs/elements/form/button/button.cjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../../../chunks/dom.cjs`);var t=e.i({BUTTON_SELECTOR:()=>r,BUTTON_TAG:()=>n,createButton:()=>a,enhanceButtons:()=>o}),n=`button`,r=`button`;function i(e){let{aria:t,type:n,name:r,value:i,disabled:a,autofocus:o,form:s,formAction:c,formEnctype:l,formMethod:u,formNoValidate:d,formTarget:f,popoverTarget:p,popoverTargetAction:m,command:h,commandFor:g,..._}=e??{},v={..._.attrs??{}},y=(e,t)=>{t!==void 0&&(Object.prototype.hasOwnProperty.call(v,e)||(v[e]=t))};y(`type`,n??`button`),y(`name`,r),y(`value`,i),y(`form`,s),y(`formaction`,c),y(`formenctype`,l),y(`formmethod`,u),y(`formtarget`,f),y(`popovertarget`,p),y(`popovertargetaction`,m),y(`command`,h),y(`commandfor`,g),a===!0&&y(`disabled`,``),o===!0&&y(`autofocus`,``),d===!0&&y(`formnovalidate`,``);let b={..._,attrs:v},x={};if(t&&(typeof t.label==`string`&&(x.label=t.label),typeof t.labelledby==`string`&&(x.labelledby=t.labelledby),typeof t.hidden==`boolean`&&(x.hidden=t.hidden)),Object.keys(x).length>0&&(b.aria=x),Object.keys(v).length===0){let{attrs:e,...t}=b;return t}return b}function a(t,r){return e.n(n,i(r),t)}function o(e=document){}exports.BUTTON_SELECTOR=r,exports.BUTTON_TAG=n,exports.createButton=a,exports.enhanceButtons=o,Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return t}});
+//# sourceMappingURL=button.cjs.map

package/dist/cjs/elements/form/button/button.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"button.cjs","names":[],"sources":["../../../../../src/elements/form/button/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: Button element helpers.\n *\n * @remarks\n * The button element (`<button>`) is an interactive control that users can\n * activate via mouse, keyboard, touch, or assistive technology. :contentReference[oaicite:5]{index=5}\n *\n * Best-practice guidance:\n * - Prefer native `<button>` semantics over non-semantic elements with `role=\"button\"`.\n * - Provide an accessible name via visible text or ARIA labelling.\n * - Avoid placing interactive content inside a button (nested links/inputs/etc.).\n * - In forms, explicitly set a button `type` to avoid accidental submissions.\n *   In HTML, the default `type` is effectively `\"submit\"` in many form contexts. :contentReference[oaicite:6]{index=6}\n *\n * pkgn-sol-specific conventions:\n * - Defaults `type` to `\"button\"` unless the caller explicitly sets `type`\n *   (via the typed `type` field or via the raw `attrs` escape hatch).\n * - Applies global attributes via pkgn-sol's hardened DOM helpers (`dom.ts`),\n *   which block inline event handler attributes (e.g. `onclick`) and the raw\n *   `style` attribute string.\n * - Supports a small structured ARIA input to reduce typo-based ARIA bugs.\n *\n * This module has no side effects and does not mutate the DOM unless you call\n * its functions.\n *\n * @module\n * @category Elements\n */\n\nimport { createElement, type AttrValue, type ElementOf, type GlobalAttrs } from '../../../ts/dom';\n\n/**\n * Structured ARIA input supported by pkgn-sol element factories.\n *\n * @remarks\n * This is intentionally a small, typed subset mapped into {@link GlobalAttrs.aria}.\n *\n * @category Attributes\n */\nexport type StructuredAria = {\n  /**\n   * Accessible label, mapped to `aria-label`.\n   */\n  label?: string;\n\n  /**\n   * ID reference(s) to labelling element(s), mapped to `aria-labelledby`.\n   */\n  labelledby?: string;\n\n  /**\n   * Decorative/hidden hint, mapped to `aria-hidden`.\n   */\n  hidden?: boolean;\n};\n\n/**\n * Allowed `type` values for `<button>`.\n *\n * @remarks\n * HTML supports `submit`, `reset`, and `button`. :contentReference[oaicite:7]{index=7}\n *\n * @category Attributes\n */\nexport type ButtonType = 'submit' | 'reset' | 'button';\n\n/**\n * Allowed `formenctype` values for submit buttons.\n *\n * @category Attributes\n */\nexport type ButtonFormEnctype =\n  | 'application/x-www-form-urlencoded'\n  | 'multipart/form-data'\n  | 'text/plain';\n\n/**\n * Allowed `formmethod` values for submit buttons.\n *\n * @remarks\n * `dialog` is supported for form submission to a dialog in HTML. :contentReference[oaicite:8]{index=8}\n *\n * @category Attributes\n */\nexport type ButtonFormMethod = 'get' | 'post' | 'dialog';\n\n/**\n * Allowed `popovertargetaction` values for popover trigger buttons.\n *\n * @remarks\n * Mirrors the `popovertargetaction` attribute. :contentReference[oaicite:9]{index=9}\n *\n * @category Attributes\n */\nexport type PopoverTargetAction = 'toggle' | 'show' | 'hide';\n\n/**\n * The semantic tag name for buttons.\n *\n * @category Constants\n */\nexport const BUTTON_TAG = 'button' as const;\n\n/**\n * A CSS selector targeting button elements.\n *\n * @category Constants\n */\nexport const BUTTON_SELECTOR = 'button';\n\n/**\n * Attribute bag for button creation/enhancement.\n *\n * @remarks\n * `<button>` supports global attributes plus button/form-associated attributes.\n * This type models the most commonly used attributes in a typed way, while still\n * providing {@link GlobalAttrs.attrs} as an escape hatch (validated by `dom.ts`).\n *\n * Notes:\n * - `type` defaults to `\"button\"` in pkgn-sol to avoid accidental form submission.\n * - Boolean attributes are applied by presence (empty string) when `true`.\n * - `command` and `commandfor` are part of the HTML Invoker Commands model. :contentReference[oaicite:10]{index=10}\n *\n * @category Attributes\n */\nexport type ButtonAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n\n  /**\n   * The button type. pkgn-sol defaults to `\"button\"` when not provided.\n   */\n  type?: ButtonType;\n\n  /**\n   * The button name (used during form submission).\n   */\n  name?: string;\n\n  /**\n   * The button value (used during form submission).\n   */\n  value?: string;\n\n  /**\n   * Disables the button when true.\n   */\n  disabled?: boolean;\n\n  /**\n   * Autofocus hint.\n   */\n  autofocus?: boolean;\n\n  /**\n   * Associates the button with a form element by ID.\n   */\n  form?: string;\n\n  /**\n   * Overrides the form `action` for submit buttons.\n   */\n  formAction?: string;\n\n  /**\n   * Overrides the form encoding type for submit buttons.\n   */\n  formEnctype?: ButtonFormEnctype;\n\n  /**\n   * Overrides the form HTTP method for submit buttons.\n   */\n  formMethod?: ButtonFormMethod;\n\n  /**\n   * When true, prevents constraint validation on submission.\n   */\n  formNoValidate?: boolean;\n\n  /**\n   * Overrides the form target for submission.\n   *\n   * @remarks\n   * Can be a special keyword like `_blank` or a named browsing context.\n   */\n  formTarget?: string;\n\n  /**\n   * ID of the popover element this button targets.\n   */\n  popoverTarget?: string;\n\n  /**\n   * Action to perform on the targeted popover.\n   */\n  popoverTargetAction?: PopoverTargetAction;\n\n  /**\n   * Invoker Commands: the command name.\n   */\n  command?: string;\n\n  /**\n   * Invoker Commands: the element ID to invoke/control.\n   */\n  commandFor?: string;\n};\n\n/**\n * Normalize {@link ButtonAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @remarks\n * This follows the same pattern used by other attribute-rich modules (e.g. iframe):\n * - Start with any caller-provided raw attrs escape hatch.\n * - Apply typed attributes without overriding explicit raw attributes.\n * - Map structured ARIA into {@link GlobalAttrs.aria}.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: ButtonAttrs): GlobalAttrs {\n  const {\n    aria,\n    type,\n    name,\n    value,\n    disabled,\n    autofocus,\n    form,\n    formAction,\n    formEnctype,\n    formMethod,\n    formNoValidate,\n    formTarget,\n    popoverTarget,\n    popoverTargetAction,\n    command,\n    commandFor,\n    ...rest\n  } = attrs ?? {};\n\n  // Start with any caller-provided attrs escape hatch (still validated by dom.ts).\n  const mergedAttrs: Record<string, AttrValue> = { ...(rest.attrs ?? {}) };\n\n  // Helper: only set if caller didn't already set the raw attribute explicitly.\n  const setIfUnset = (key: string, v: AttrValue | undefined): void => {\n    if (v === undefined) return;\n    if (Object.prototype.hasOwnProperty.call(mergedAttrs, key)) return;\n    mergedAttrs[key] = v;\n  };\n\n  // pkgn-sol safety: default to type=\"button\" unless caller explicitly overrides it.\n  setIfUnset('type', type ?? 'button');\n\n  setIfUnset('name', name);\n  setIfUnset('value', value);\n  setIfUnset('form', form);\n  setIfUnset('formaction', formAction);\n  setIfUnset('formenctype', formEnctype);\n  setIfUnset('formmethod', formMethod);\n  setIfUnset('formtarget', formTarget);\n  setIfUnset('popovertarget', popoverTarget);\n  setIfUnset('popovertargetaction', popoverTargetAction);\n  setIfUnset('command', command);\n  setIfUnset('commandfor', commandFor);\n\n  // Boolean attributes are represented by presence. We set empty-string when true.\n  if (disabled === true) setIfUnset('disabled', '');\n  if (autofocus === true) setIfUnset('autofocus', '');\n  if (formNoValidate === true) setIfUnset('formnovalidate', '');\n\n  const mapped: GlobalAttrs = { ...rest, attrs: mergedAttrs };\n\n  const mappedAria: NonNullable<GlobalAttrs['aria']> = {};\n  if (aria) {\n    if (typeof aria.label === 'string') mappedAria.label = aria.label;\n    if (typeof aria.labelledby === 'string') mappedAria.labelledby = aria.labelledby;\n    if (typeof aria.hidden === 'boolean') mappedAria.hidden = aria.hidden;\n  }\n\n  if (Object.keys(mappedAria).length > 0) {\n    mapped.aria = mappedAria;\n  }\n\n  // If mergedAttrs ended up empty, avoid attaching it.\n  if (Object.keys(mergedAttrs).length === 0) {\n    const { attrs: _unused, ...withoutAttrs } = mapped;\n    return withoutAttrs;\n  }\n\n  return mapped;\n}\n\n/**\n * Create a button element with optional text content and attributes.\n *\n * @remarks\n * - Text content is assigned via `textContent` (never `innerHTML`).\n * - pkgn-sol defaults `type` to `\"button\"` to reduce accidental form submissions. :contentReference[oaicite:11]{index=11}\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 text - Optional text content for the button.\n * @param attrs - Optional attributes to apply.\n * @returns The created `<button>` element.\n *\n * @example\n * ```ts\n * import { createButton } from \"@lnpg/pkgn-sol/elements/form/button\";\n *\n * document.body.appendChild(createButton(\"Save\", { className: \"btn\" }));\n * ```\n *\n * @category DOM\n */\nexport function createButton(text?: string, attrs?: ButtonAttrs): ElementOf<typeof BUTTON_TAG> {\n  return createElement(BUTTON_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance button 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 enhanceButtons(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for button.\n  void root;\n}\n"],"mappings":"0MAqGa,EAAa,SAOb,EAAkB,SAiH/B,SAAS,EAAc,EAAkC,CACvD,GAAM,CACJ,OACA,OACA,OACA,QACA,WACA,YACA,OACA,aACA,cACA,aACA,iBACA,aACA,gBACA,sBACA,UACA,aACA,GAAG,GACD,GAAS,EAAE,CAGT,EAAyC,CAAE,GAAI,EAAK,OAAS,EAAE,CAAG,CAGlE,GAAc,EAAa,IAAmC,CAC9D,IAAM,IAAA,KACN,OAAO,UAAU,eAAe,KAAK,EAAa,EAAI,GAC1D,EAAY,GAAO,KAIrB,EAAW,OAAQ,GAAQ,SAAS,CAEpC,EAAW,OAAQ,EAAK,CACxB,EAAW,QAAS,EAAM,CAC1B,EAAW,OAAQ,EAAK,CACxB,EAAW,aAAc,EAAW,CACpC,EAAW,cAAe,EAAY,CACtC,EAAW,aAAc,EAAW,CACpC,EAAW,aAAc,EAAW,CACpC,EAAW,gBAAiB,EAAc,CAC1C,EAAW,sBAAuB,EAAoB,CACtD,EAAW,UAAW,EAAQ,CAC9B,EAAW,aAAc,EAAW,CAGhC,IAAa,IAAM,EAAW,WAAY,GAAG,CAC7C,IAAc,IAAM,EAAW,YAAa,GAAG,CAC/C,IAAmB,IAAM,EAAW,iBAAkB,GAAG,CAE7D,IAAM,EAAsB,CAAE,GAAG,EAAM,MAAO,EAAa,CAErD,EAA+C,EAAE,CAYvD,GAXI,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,GAIZ,OAAO,KAAK,EAAY,CAAC,SAAW,EAAG,CACzC,GAAM,CAAE,MAAO,EAAS,GAAG,GAAiB,EAC5C,OAAO,EAGT,OAAO,EA0BT,SAAgB,EAAa,EAAe,EAAmD,CAC7F,OAAO,EAAA,EAAc,EAAY,EAAc,EAAM,CAAE,EAAK,CAa9D,SAAgB,EAAe,EAAmB,SAAgB"}

package/dist/cjs/elements/form/datalist/datalist.cjs

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

package/dist/cjs/elements/form/datalist/datalist.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"datalist.cjs","names":[],"sources":["../../../../../src/elements/form/datalist/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: Datalist element helpers.\n *\n * @remarks\n * The datalist element (`<datalist>`) contains a set of `<option>` elements that\n * represent permissible or recommended values for an associated form control\n * (most commonly an `<input>`), connected via the input's `list` attribute.\n *\n * Best-practice guidance:\n * - Pair a `<datalist>` with an `<input>` using a stable, unique `id` on the\n *   datalist and a matching `list` attribute on the input.\n * - Use `<datalist>` for suggestions, not strict validation. If users must pick\n *   from a fixed set, prefer `<select>`.\n * - Populate suggestions using descendant `<option>` elements, typically with\n *   `value` attributes.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create `<datalist>` 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 * Attributes:\n * - `<datalist>` supports global attributes only (no element-specific content\n *   attributes).\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/datalist\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 datalist.\n *\n * @category Constants\n */\nexport const DATALIST_TAG = 'datalist' as const;\n\n/**\n * A CSS selector targeting datalist elements.\n *\n * @category Constants\n */\nexport const DATALIST_SELECTOR = 'datalist';\n\n/**\n * Attribute bag for datalist creation/enhancement.\n *\n * @remarks\n * Datalist 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 DatalistAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n};\n\n/**\n * Normalize {@link DatalistAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The datalist attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: DatalistAttrs): 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 datalist element with optional text content and global attributes.\n *\n * @remarks\n * While `<datalist>` is typically populated with `<option>` children, this helper\n * follows pkgn-sol's consistent \"optional text\" factory signature for non-void elements.\n *\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 datalist (rare, but supported).\n * @param attrs - Optional attributes to apply.\n * @returns The created `<datalist>` element.\n *\n * @example\n * ```ts\n * import { createDatalist } from \"@lnpg/pkgn-sol/elements/form/datalist\";\n *\n * const dl = createDatalist(undefined, { id: \"city-list\" });\n * document.body.appendChild(dl);\n * ```\n *\n * @category DOM\n */\nexport function createDatalist(\n  text?: string,\n  attrs?: DatalistAttrs,\n): ElementOf<typeof DATALIST_TAG> {\n  return createElement(DATALIST_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance datalist 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 enhanceDatalists(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for datalist.\n  void root;\n}\n"],"mappings":"kNA0Ea,EAAe,WAOf,EAAoB,WA4BjC,SAAS,EAAc,EAAgD,CACrE,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,EA6BrD,SAAgB,EACd,EACA,EACgC,CAChC,OAAO,EAAA,EAAc,EAAc,EAAc,EAAM,CAAE,EAAK,CAqBhE,SAAgB,EAAiB,EAAmB,SAAgB"}

package/dist/cjs/elements/form/fieldset/fieldset.cjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../../../chunks/dom.cjs`);var t=e.i({FIELDSET_SELECTOR:()=>r,FIELDSET_TAG:()=>n,createFieldset:()=>a,enhanceFieldsets:()=>o}),n=`fieldset`,r=`fieldset`;function i(e){if(!e)return;let{aria:t,disabled:n,form:r,name:i,...a}=e,o={...a.attrs??{}},s=(e,t)=>{t!==void 0&&(Object.prototype.hasOwnProperty.call(o,e)||(o[e]=t))};s(`form`,r),s(`name`,i),n===!0&&s(`disabled`,``);let c={};t&&(typeof t.label==`string`&&(c.label=t.label),typeof t.labelledby==`string`&&(c.labelledby=t.labelledby),typeof t.hidden==`boolean`&&(c.hidden=t.hidden));let l=Object.keys(c).length>0,u=Object.keys(o).length>0,d={...a};return u&&(d.attrs=o),l&&(d.aria=c),d}function a(t,r){return e.n(n,i(r),t)}function o(e=document){}exports.FIELDSET_SELECTOR=r,exports.FIELDSET_TAG=n,exports.createFieldset=a,exports.enhanceFieldsets=o,Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return t}});
+//# sourceMappingURL=fieldset.cjs.map

package/dist/cjs/elements/form/fieldset/fieldset.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldset.cjs","names":[],"sources":["../../../../../src/elements/form/fieldset/index.ts"],"sourcesContent":["/**\n * pkgn-sol Design Foundation: Fieldset element helpers.\n *\n * @remarks\n * The fieldset element (`<fieldset>`) groups related form controls, typically\n * with a `<legend>` that provides an accessible label for the group.\n *\n * Best-practice guidance:\n * - Use `<fieldset>` to group related controls (e.g. radio button sets).\n * - Prefer a meaningful `<legend>` as the first child to label the group.\n * - Do not use `<fieldset>` purely for layout; use CSS for visual grouping.\n *\n * Attribute behavior notes:\n * - When `disabled` is set on a `<fieldset>`, user agents disable descendant\n *   form controls, except those that are descendants of the fieldset's first\n *   `<legend>` child (if any). This is native platform behavior.\n *\n * This module provides small, framework-agnostic helpers so consumers can:\n * - create fieldsets 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/fieldset\n * @see https://www.w3.org/WAI/tutorials/forms/grouping/\n *\n * @module\n * @category Elements\n */\n\nimport { createElement, type AttrValue, type ElementOf, type GlobalAttrs } from '../../../ts/dom';\n\n/**\n * Structured ARIA input supported by pkgn-sol element factories.\n *\n * @remarks\n * This is intentionally a small, typed subset that covers common cases and\n * prevents typo-based ARIA bugs.\n *\n * It is mapped into {@link GlobalAttrs.aria} for application by `dom.ts`.\n *\n * @category Attributes\n */\nexport type StructuredAria = {\n  /**\n   * Accessible label, mapped to `aria-label`.\n   */\n  label?: string;\n\n  /**\n   * ID reference to the labelling element(s), mapped to `aria-labelledby`.\n   */\n  labelledby?: string;\n\n  /**\n   * Decorative/hidden hint, mapped to `aria-hidden`.\n   */\n  hidden?: boolean;\n};\n\n/**\n * The semantic tag name for fieldset groups.\n *\n * @category Constants\n */\nexport const FIELDSET_TAG = 'fieldset' as const;\n\n/**\n * A CSS selector targeting fieldset elements.\n *\n * @category Constants\n */\nexport const FIELDSET_SELECTOR = 'fieldset';\n\n/**\n * Attribute bag for fieldset creation/enhancement.\n *\n * @remarks\n * Fieldset accepts standard HTML global attributes plus fieldset-specific\n * attributes (`disabled`, `form`, `name`).\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 FieldsetAttrs = Omit<GlobalAttrs, 'aria'> & {\n  /**\n   * Structured ARIA fields mapped into `aria-*` attributes.\n   */\n  aria?: StructuredAria;\n\n  /**\n   * Disables descendant form controls (native platform behavior).\n   *\n   * @remarks\n   * When set, controls inside the first `<legend>` (if present) are typically\n   * excluded from disabling per spec/user agent behavior.\n   */\n  disabled?: boolean;\n\n  /**\n   * Associates the fieldset with a form element by ID, even if not a descendant.\n   */\n  form?: string;\n\n  /**\n   * Name of the fieldset (submitted/associated in form processing contexts).\n   */\n  name?: string;\n};\n\n/**\n * Normalize {@link FieldsetAttrs} into {@link GlobalAttrs} for `dom.ts`.\n *\n * @param attrs - The fieldset attributes.\n * @returns A {@link GlobalAttrs} object, or `undefined` if no attrs were provided.\n *\n * @category Internal\n */\nfunction toGlobalAttrs(attrs?: FieldsetAttrs): GlobalAttrs | undefined {\n  if (!attrs) return undefined;\n\n  const { aria, disabled, form, name, ...rest } = attrs;\n\n  // Start with any caller-provided attrs escape hatch (still validated by dom.ts).\n  const mergedAttrs: Record<string, AttrValue> = { ...(rest.attrs ?? {}) };\n\n  const setIfUnset = (key: string, value: AttrValue | undefined): void => {\n    if (value === undefined) return;\n    if (Object.prototype.hasOwnProperty.call(mergedAttrs, key)) return;\n    mergedAttrs[key] = value;\n  };\n\n  setIfUnset('form', form);\n  setIfUnset('name', name);\n\n  // Boolean attributes are represented by presence. We set empty-string when true.\n  if (disabled === true) setIfUnset('disabled', '');\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 a fieldset 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 fieldset (rare; most fieldsets contain child nodes).\n * @param attrs - Optional attributes to apply.\n * @returns The created `<fieldset>` element.\n *\n * @example\n * ```ts\n * import { createFieldset } from \"@lnpg/pkgn-sol/elements/form/fieldset\";\n *\n * const fs = createFieldset(undefined, { disabled: false });\n * // fs.appendChild(createLegend(\"Shipping address\"));\n * ```\n *\n * @category DOM\n */\nexport function createFieldset(\n  text?: string,\n  attrs?: FieldsetAttrs,\n): ElementOf<typeof FIELDSET_TAG> {\n  return createElement(FIELDSET_TAG, toGlobalAttrs(attrs), text);\n}\n\n/**\n * Enhance fieldset 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 enhanceFieldsets(root: ParentNode = document): void {\n  // v0.1.0: no runtime behavior for fieldset.\n  void root;\n}\n"],"mappings":"kNAmEa,EAAe,WAOf,EAAoB,WAgDjC,SAAS,EAAc,EAAgD,CACrE,GAAI,CAAC,EAAO,OAEZ,GAAM,CAAE,OAAM,WAAU,OAAM,OAAM,GAAG,GAAS,EAG1C,EAAyC,CAAE,GAAI,EAAK,OAAS,EAAE,CAAG,CAElE,GAAc,EAAa,IAAuC,CAClE,IAAU,IAAA,KACV,OAAO,UAAU,eAAe,KAAK,EAAa,EAAI,GAC1D,EAAY,GAAO,KAGrB,EAAW,OAAQ,EAAK,CACxB,EAAW,OAAQ,EAAK,CAGpB,IAAa,IAAM,EAAW,WAAY,GAAG,CAEjD,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,EA0BT,SAAgB,EACd,EACA,EACgC,CAChC,OAAO,EAAA,EAAc,EAAc,EAAc,EAAM,CAAE,EAAK,CAqBhE,SAAgB,EAAiB,EAAmB,SAAgB"}

package/dist/cjs/elements/form/form/form.cjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../../../chunks/dom.cjs`);var t=e.i({FORM_SELECTOR:()=>r,FORM_TAG:()=>n,createForm:()=>a,enhanceForms:()=>o}),n=`form`,r=`form`;function i(e){if(!e)return;let{aria:t,action:n,method:r,enctype:i,acceptCharset:a,autocomplete:o,name:s,noValidate:c,target:l,rel:u,...d}=e,f={...d.attrs??{}},p=(e,t)=>{t!==void 0&&(Object.prototype.hasOwnProperty.call(f,e)||(f[e]=t))};p(`action`,n),p(`method`,r),p(`enctype`,i),p(`accept-charset`,a),p(`autocomplete`,o),p(`name`,s),p(`target`,l),p(`rel`,u),c===!0&&p(`novalidate`,``);let m={};t&&(typeof t.label==`string`&&(m.label=t.label),typeof t.labelledby==`string`&&(m.labelledby=t.labelledby),typeof t.hidden==`boolean`&&(m.hidden=t.hidden));let h=Object.keys(m).length>0,g=Object.keys(f).length>0,_={...d};return g&&(_.attrs=f),h&&(_.aria=m),_}function a(t,r){return e.n(n,i(r),t)}function o(e=document){}exports.FORM_SELECTOR=r,exports.FORM_TAG=n,exports.createForm=a,exports.enhanceForms=o,Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return t}});
+//# sourceMappingURL=form.cjs.map