@lnpg/pkgn-sol 1.0.0-beta.0

package/dist/types/elements/figure/index.d.ts

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

package/dist/types/elements/figure/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/elements/figure/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;;;;;GAMG;AACH,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAE3C;;;;;;;GAOG;AACH,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC"}

package/dist/types/elements/form/button/index.d.ts

@@ -0,0 +1,216 @@
+/**
+ * pkgn-sol Design Foundation: Button element helpers.
+ *
+ * @remarks
+ * The button element (`<button>`) is an interactive control that users can
+ * activate via mouse, keyboard, touch, or assistive technology. :contentReference[oaicite:5]{index=5}
+ *
+ * Best-practice guidance:
+ * - Prefer native `<button>` semantics over non-semantic elements with `role="button"`.
+ * - Provide an accessible name via visible text or ARIA labelling.
+ * - Avoid placing interactive content inside a button (nested links/inputs/etc.).
+ * - In forms, explicitly set a button `type` to avoid accidental submissions.
+ *   In HTML, the default `type` is effectively `"submit"` in many form contexts. :contentReference[oaicite:6]{index=6}
+ *
+ * pkgn-sol-specific conventions:
+ * - Defaults `type` to `"button"` unless the caller explicitly sets `type`
+ *   (via the typed `type` field or via the raw `attrs` escape hatch).
+ * - Applies global attributes via pkgn-sol's hardened DOM helpers (`dom.ts`),
+ *   which block inline event handler attributes (e.g. `onclick`) and the raw
+ *   `style` attribute string.
+ * - Supports a small structured ARIA input to reduce typo-based ARIA bugs.
+ *
+ * This module has no side effects and does not mutate the DOM unless you call
+ * its functions.
+ *
+ * @module
+ * @category Elements
+ */
+import { type ElementOf, type GlobalAttrs } from '../../../ts/dom';
+/**
+ * Structured ARIA input supported by pkgn-sol element factories.
+ *
+ * @remarks
+ * This is intentionally a small, typed subset mapped into {@link GlobalAttrs.aria}.
+ *
+ * @category Attributes
+ */
+export type StructuredAria = {
+    /**
+     * Accessible label, mapped to `aria-label`.
+     */
+    label?: string;
+    /**
+     * ID reference(s) to labelling element(s), mapped to `aria-labelledby`.
+     */
+    labelledby?: string;
+    /**
+     * Decorative/hidden hint, mapped to `aria-hidden`.
+     */
+    hidden?: boolean;
+};
+/**
+ * Allowed `type` values for `<button>`.
+ *
+ * @remarks
+ * HTML supports `submit`, `reset`, and `button`. :contentReference[oaicite:7]{index=7}
+ *
+ * @category Attributes
+ */
+export type ButtonType = 'submit' | 'reset' | 'button';
+/**
+ * Allowed `formenctype` values for submit buttons.
+ *
+ * @category Attributes
+ */
+export type ButtonFormEnctype = 'application/x-www-form-urlencoded' | 'multipart/form-data' | 'text/plain';
+/**
+ * Allowed `formmethod` values for submit buttons.
+ *
+ * @remarks
+ * `dialog` is supported for form submission to a dialog in HTML. :contentReference[oaicite:8]{index=8}
+ *
+ * @category Attributes
+ */
+export type ButtonFormMethod = 'get' | 'post' | 'dialog';
+/**
+ * Allowed `popovertargetaction` values for popover trigger buttons.
+ *
+ * @remarks
+ * Mirrors the `popovertargetaction` attribute. :contentReference[oaicite:9]{index=9}
+ *
+ * @category Attributes
+ */
+export type PopoverTargetAction = 'toggle' | 'show' | 'hide';
+/**
+ * The semantic tag name for buttons.
+ *
+ * @category Constants
+ */
+export declare const BUTTON_TAG: "button";
+/**
+ * A CSS selector targeting button elements.
+ *
+ * @category Constants
+ */
+export declare const BUTTON_SELECTOR = "button";
+/**
+ * Attribute bag for button creation/enhancement.
+ *
+ * @remarks
+ * `<button>` supports global attributes plus button/form-associated attributes.
+ * This type models the most commonly used attributes in a typed way, while still
+ * providing {@link GlobalAttrs.attrs} as an escape hatch (validated by `dom.ts`).
+ *
+ * Notes:
+ * - `type` defaults to `"button"` in pkgn-sol to avoid accidental form submission.
+ * - Boolean attributes are applied by presence (empty string) when `true`.
+ * - `command` and `commandfor` are part of the HTML Invoker Commands model. :contentReference[oaicite:10]{index=10}
+ *
+ * @category Attributes
+ */
+export type ButtonAttrs = Omit<GlobalAttrs, 'aria'> & {
+    /**
+     * Structured ARIA fields mapped into `aria-*` attributes.
+     */
+    aria?: StructuredAria;
+    /**
+     * The button type. pkgn-sol defaults to `"button"` when not provided.
+     */
+    type?: ButtonType;
+    /**
+     * The button name (used during form submission).
+     */
+    name?: string;
+    /**
+     * The button value (used during form submission).
+     */
+    value?: string;
+    /**
+     * Disables the button when true.
+     */
+    disabled?: boolean;
+    /**
+     * Autofocus hint.
+     */
+    autofocus?: boolean;
+    /**
+     * Associates the button with a form element by ID.
+     */
+    form?: string;
+    /**
+     * Overrides the form `action` for submit buttons.
+     */
+    formAction?: string;
+    /**
+     * Overrides the form encoding type for submit buttons.
+     */
+    formEnctype?: ButtonFormEnctype;
+    /**
+     * Overrides the form HTTP method for submit buttons.
+     */
+    formMethod?: ButtonFormMethod;
+    /**
+     * When true, prevents constraint validation on submission.
+     */
+    formNoValidate?: boolean;
+    /**
+     * Overrides the form target for submission.
+     *
+     * @remarks
+     * Can be a special keyword like `_blank` or a named browsing context.
+     */
+    formTarget?: string;
+    /**
+     * ID of the popover element this button targets.
+     */
+    popoverTarget?: string;
+    /**
+     * Action to perform on the targeted popover.
+     */
+    popoverTargetAction?: PopoverTargetAction;
+    /**
+     * Invoker Commands: the command name.
+     */
+    command?: string;
+    /**
+     * Invoker Commands: the element ID to invoke/control.
+     */
+    commandFor?: string;
+};
+/**
+ * Create a button element with optional text content and attributes.
+ *
+ * @remarks
+ * - Text content is assigned via `textContent` (never `innerHTML`).
+ * - pkgn-sol defaults `type` to `"button"` to reduce accidental form submissions. :contentReference[oaicite:11]{index=11}
+ * - Global attributes are applied via pkgn-sol's shared DOM helper, including security
+ *   guards that block inline event handler attributes (e.g. `onclick`) and raw
+ *   `style` attribute strings.
+ *
+ * @param text - Optional text content for the button.
+ * @param attrs - Optional attributes to apply.
+ * @returns The created `<button>` element.
+ *
+ * @example
+ * ```ts
+ * import { createButton } from "@lnpg/pkgn-sol/elements/form/button";
+ *
+ * document.body.appendChild(createButton("Save", { className: "btn" }));
+ * ```
+ *
+ * @category DOM
+ */
+export declare function createButton(text?: string, attrs?: ButtonAttrs): ElementOf<typeof BUTTON_TAG>;
+/**
+ * Enhance button elements within a given root.
+ *
+ * @remarks
+ * This is intentionally a no-op in `0.1.0`.
+ *
+ * @param root - The node to search within. Defaults to `document`.
+ *
+ * @category Enhancement
+ */
+export declare function enhanceButtons(root?: ParentNode): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/elements/form/button/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/elements/form/button/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAiC,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAElG;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEvD;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GACzB,mCAAmC,GACnC,qBAAqB,GACrB,YAAY,CAAC;AAEjB;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEzD;;;;;;;GAOG;AACH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAE7D;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAG,QAAiB,CAAC;AAE5C;;;;GAIG;AACH,eAAO,MAAM,eAAe,WAAW,CAAC;AAExC;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG;IACpD;;OAEG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC;IAEtB;;OAEG;IACH,IAAI,CAAC,EAAE,UAAU,CAAC;IAElB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAEhC;;OAEG;IACH,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAE9B;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAE1C;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAsFF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,YAAY,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC,OAAO,UAAU,CAAC,CAE7F;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,IAAI,GAAE,UAAqB,GAAG,IAAI,CAGhE"}

package/dist/types/elements/form/datalist/index.d.ts

@@ -0,0 +1,140 @@
+/**
+ * pkgn-sol Design Foundation: Datalist element helpers.
+ *
+ * @remarks
+ * The datalist element (`<datalist>`) contains a set of `<option>` elements that
+ * represent permissible or recommended values for an associated form control
+ * (most commonly an `<input>`), connected via the input's `list` attribute.
+ *
+ * Best-practice guidance:
+ * - Pair a `<datalist>` with an `<input>` using a stable, unique `id` on the
+ *   datalist and a matching `list` attribute on the input.
+ * - Use `<datalist>` for suggestions, not strict validation. If users must pick
+ *   from a fixed set, prefer `<select>`.
+ * - Populate suggestions using descendant `<option>` elements, typically with
+ *   `value` attributes.
+ *
+ * This module provides small, framework-agnostic helpers so consumers can:
+ * - create `<datalist>` elements in vanilla JS/TS without templates
+ * - apply consistent global attributes safely
+ * - use a stable "enhancement" hook if pkgn-sol ever needs runtime behavior
+ *
+ * This module has no side effects and does not mutate the DOM unless you call
+ * its functions.
+ *
+ * Attributes:
+ * - `<datalist>` supports global attributes only (no element-specific content
+ *   attributes).
+ *
+ * Security:
+ * - Global attribute escape hatches are guarded by pkgn-sol's `dom.ts` helpers which
+ *   block inline event handler attributes (e.g. `onclick`) and raw `style`
+ *   attribute injection (use the `style` object field instead).
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/datalist
+ *
+ * @module
+ * @category Elements
+ */
+import { type ElementOf, type GlobalAttrs } from '../../../ts/dom';
+/**
+ * Structured ARIA input supported by pkgn-sol element factories.
+ *
+ * @remarks
+ * This is intentionally a small, typed subset that covers common cases and
+ * prevents typo-based ARIA bugs (e.g. `lable`).
+ *
+ * It is mapped into {@link GlobalAttrs.aria} for application by `dom.ts`.
+ *
+ * @category Attributes
+ */
+export type StructuredAria = {
+    /**
+     * Accessible label, mapped to `aria-label`.
+     */
+    label?: string;
+    /**
+     * ID reference to the labelling element(s), mapped to `aria-labelledby`.
+     */
+    labelledby?: string;
+    /**
+     * Decorative/hidden hint, mapped to `aria-hidden`.
+     */
+    hidden?: boolean;
+};
+/**
+ * The semantic tag name for datalist.
+ *
+ * @category Constants
+ */
+export declare const DATALIST_TAG: "datalist";
+/**
+ * A CSS selector targeting datalist elements.
+ *
+ * @category Constants
+ */
+export declare const DATALIST_SELECTOR = "datalist";
+/**
+ * Attribute bag for datalist creation/enhancement.
+ *
+ * @remarks
+ * Datalist elements accept standard HTML global attributes.
+ *
+ * pkgn-sol also supports a structured ARIA input for common ARIA fields, which is
+ * mapped into {@link GlobalAttrs.aria} without changing pkgn-sol's core DOM helpers.
+ *
+ * @category Attributes
+ */
+export type DatalistAttrs = Omit<GlobalAttrs, 'aria'> & {
+    /**
+     * Structured ARIA fields mapped into `aria-*` attributes.
+     */
+    aria?: StructuredAria;
+};
+/**
+ * Create a datalist element with optional text content and global attributes.
+ *
+ * @remarks
+ * While `<datalist>` is typically populated with `<option>` children, this helper
+ * follows pkgn-sol's consistent "optional text" factory signature for non-void elements.
+ *
+ * - Text content is assigned via `textContent` (never `innerHTML`).
+ * - Global attributes are applied via pkgn-sol's shared DOM helper,
+ *   including security guards that block inline event handler attributes
+ *   (e.g. `onclick`) and raw `style` attribute strings.
+ *
+ * @param text - Optional text content for the datalist (rare, but supported).
+ * @param attrs - Optional attributes to apply.
+ * @returns The created `<datalist>` element.
+ *
+ * @example
+ * ```ts
+ * import { createDatalist } from "@lnpg/pkgn-sol/elements/form/datalist";
+ *
+ * const dl = createDatalist(undefined, { id: "city-list" });
+ * document.body.appendChild(dl);
+ * ```
+ *
+ * @category DOM
+ */
+export declare function createDatalist(text?: string, attrs?: DatalistAttrs): ElementOf<typeof DATALIST_TAG>;
+/**
+ * Enhance datalist elements within a given root.
+ *
+ * @remarks
+ * This is intentionally a no-op in `0.1.0`.
+ *
+ * Why does it exist?
+ * - It establishes a stable integration pattern for frameworks (Vue/React/etc.)
+ * - It allows future progressive enhancements without changing consumer code
+ *
+ * What it will never do:
+ * - It will not inject styles (CSS remains the source of truth)
+ * - It will not introduce framework-specific behavior
+ *
+ * @param root - The node to search within. Defaults to `document`.
+ *
+ * @category Enhancement
+ */
+export declare function enhanceDatalists(root?: ParentNode): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/elements/form/datalist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/elements/form/datalist/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,EAAiB,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAElF;;;;;;;;;;GAUG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAG,UAAmB,CAAC;AAEhD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,aAAa,CAAC;AAE5C;;;;;;;;;;GAUG;AACH,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG;IACtD;;OAEG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB,CAAC;AA6BF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,cAAc,CAC5B,IAAI,CAAC,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,aAAa,GACpB,SAAS,CAAC,OAAO,YAAY,CAAC,CAEhC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,UAAqB,GAAG,IAAI,CAGlE"}

package/dist/types/elements/form/fieldset/index.d.ts

@@ -0,0 +1,147 @@
+/**
+ * pkgn-sol Design Foundation: Fieldset element helpers.
+ *
+ * @remarks
+ * The fieldset element (`<fieldset>`) groups related form controls, typically
+ * with a `<legend>` that provides an accessible label for the group.
+ *
+ * Best-practice guidance:
+ * - Use `<fieldset>` to group related controls (e.g. radio button sets).
+ * - Prefer a meaningful `<legend>` as the first child to label the group.
+ * - Do not use `<fieldset>` purely for layout; use CSS for visual grouping.
+ *
+ * Attribute behavior notes:
+ * - When `disabled` is set on a `<fieldset>`, user agents disable descendant
+ *   form controls, except those that are descendants of the fieldset's first
+ *   `<legend>` child (if any). This is native platform behavior.
+ *
+ * This module provides small, framework-agnostic helpers so consumers can:
+ * - create fieldsets in vanilla JS/TS without templates
+ * - apply consistent global attributes safely
+ * - use a stable "enhancement" hook if pkgn-sol ever needs runtime behavior
+ *
+ * This module has no side effects and does not mutate the DOM unless you call
+ * its functions.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/fieldset
+ * @see https://www.w3.org/WAI/tutorials/forms/grouping/
+ *
+ * @module
+ * @category Elements
+ */
+import { type ElementOf, type GlobalAttrs } from '../../../ts/dom';
+/**
+ * Structured ARIA input supported by pkgn-sol element factories.
+ *
+ * @remarks
+ * This is intentionally a small, typed subset that covers common cases and
+ * prevents typo-based ARIA bugs.
+ *
+ * It is mapped into {@link GlobalAttrs.aria} for application by `dom.ts`.
+ *
+ * @category Attributes
+ */
+export type StructuredAria = {
+    /**
+     * Accessible label, mapped to `aria-label`.
+     */
+    label?: string;
+    /**
+     * ID reference to the labelling element(s), mapped to `aria-labelledby`.
+     */
+    labelledby?: string;
+    /**
+     * Decorative/hidden hint, mapped to `aria-hidden`.
+     */
+    hidden?: boolean;
+};
+/**
+ * The semantic tag name for fieldset groups.
+ *
+ * @category Constants
+ */
+export declare const FIELDSET_TAG: "fieldset";
+/**
+ * A CSS selector targeting fieldset elements.
+ *
+ * @category Constants
+ */
+export declare const FIELDSET_SELECTOR = "fieldset";
+/**
+ * Attribute bag for fieldset creation/enhancement.
+ *
+ * @remarks
+ * Fieldset accepts standard HTML global attributes plus fieldset-specific
+ * attributes (`disabled`, `form`, `name`).
+ *
+ * pkgn-sol also supports a structured ARIA input for common ARIA fields, which is
+ * mapped into {@link GlobalAttrs.aria} without changing pkgn-sol's core DOM helpers.
+ *
+ * @category Attributes
+ */
+export type FieldsetAttrs = Omit<GlobalAttrs, 'aria'> & {
+    /**
+     * Structured ARIA fields mapped into `aria-*` attributes.
+     */
+    aria?: StructuredAria;
+    /**
+     * Disables descendant form controls (native platform behavior).
+     *
+     * @remarks
+     * When set, controls inside the first `<legend>` (if present) are typically
+     * excluded from disabling per spec/user agent behavior.
+     */
+    disabled?: boolean;
+    /**
+     * Associates the fieldset with a form element by ID, even if not a descendant.
+     */
+    form?: string;
+    /**
+     * Name of the fieldset (submitted/associated in form processing contexts).
+     */
+    name?: string;
+};
+/**
+ * Create a fieldset element with optional text content and attributes.
+ *
+ * @remarks
+ * - Text content is assigned via `textContent` (never `innerHTML`).
+ * - Global attributes are applied via pkgn-sol's shared DOM helper,
+ *   including security guards that block inline event handler attributes
+ *   (e.g. `onclick`) and raw `style` attribute strings.
+ *
+ * @param text - Optional text content for the fieldset (rare; most fieldsets contain child nodes).
+ * @param attrs - Optional attributes to apply.
+ * @returns The created `<fieldset>` element.
+ *
+ * @example
+ * ```ts
+ * import { createFieldset } from "@lnpg/pkgn-sol/elements/form/fieldset";
+ *
+ * const fs = createFieldset(undefined, { disabled: false });
+ * // fs.appendChild(createLegend("Shipping address"));
+ * ```
+ *
+ * @category DOM
+ */
+export declare function createFieldset(text?: string, attrs?: FieldsetAttrs): ElementOf<typeof FIELDSET_TAG>;
+/**
+ * Enhance fieldset elements within a given root.
+ *
+ * @remarks
+ * This is intentionally a no-op in `0.1.0`.
+ *
+ * Why does it exist?
+ * - It establishes a stable integration pattern for frameworks (Vue/React/etc.)
+ * - It allows future progressive enhancements without changing consumer code
+ *
+ * What it will never do:
+ * - It will not inject styles (CSS remains the source of truth)
+ * - It will not introduce framework-specific behavior
+ *
+ * @param root - The node to search within. Defaults to `document`.
+ *
+ * @category Enhancement
+ */
+export declare function enhanceFieldsets(root?: ParentNode): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/elements/form/fieldset/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/elements/form/fieldset/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAAiC,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAElG;;;;;;;;;;GAUG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAG,UAAmB,CAAC;AAEhD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,aAAa,CAAC;AAE5C;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG;IACtD;;OAEG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC;IAEtB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AA+CF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,cAAc,CAC5B,IAAI,CAAC,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,aAAa,GACpB,SAAS,CAAC,OAAO,YAAY,CAAC,CAEhC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,UAAqB,GAAG,IAAI,CAGlE"}