@lnpg/pkgn-sol 1.0.0-beta.0

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

@@ -0,0 +1,210 @@
+/**
+ * pkgn-sol Design Foundation: Form element helpers.
+ *
+ * @remarks
+ * The form element (`<form>`) groups interactive controls for submitting data.
+ *
+ * Best-practice guidance:
+ * - Prefer HTTPS endpoints for `action` to protect user data in transit.
+ * - Use `method="post"` for submissions that change server state or include sensitive data.
+ * - Use `enctype="multipart/form-data"` when uploading files.
+ * - Provide explicit labels for controls and ensure accessible naming.
+ * - Consider `rel="noopener"` when using `target="_blank"` to avoid `window.opener` exposure.
+ *
+ * pkgn-sol notes:
+ * - This module is framework-agnostic and has no side effects.
+ * - Global attributes are applied via pkgn-sol's shared DOM helper, which blocks:
+ *   - inline event handler attributes (e.g. `onclick`)
+ *   - raw `style` attribute injection (use the `style` object instead)
+ * - Text passed to factories is assigned via `textContent` (never `innerHTML`).
+ *
+ * References:
+ * - MDN: `<form>` element :contentReference[oaicite:3]{index=3}
+ * - WHATWG HTML: Forms & submission attributes :contentReference[oaicite:4]{index=4}
+ * - MDN: `rel` on `<form>` / `noopener` :contentReference[oaicite:5]{index=5}
+ *
+ * @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 forms.
+ *
+ * @category Constants
+ */
+export declare const FORM_TAG: "form";
+/**
+ * A CSS selector targeting form elements.
+ *
+ * @category Constants
+ */
+export declare const FORM_SELECTOR = "form";
+/**
+ * Allowed values for the form `method` attribute.
+ *
+ * @remarks
+ * HTML supports `get`, `post`, and `dialog` (for dialog-associated forms).
+ *
+ * @category Types
+ */
+export type FormMethod = 'get' | 'post' | 'dialog';
+/**
+ * Allowed values for the form `enctype` attribute.
+ *
+ * @category Types
+ */
+export type FormEnctype = 'application/x-www-form-urlencoded' | 'multipart/form-data' | 'text/plain';
+/**
+ * Allowed values for the form `autocomplete` attribute.
+ *
+ * @category Types
+ */
+export type FormAutocomplete = 'on' | 'off';
+/**
+ * Attribute bag for form creation/enhancement.
+ *
+ * @remarks
+ * `<form>` supports standard HTML global attributes plus submission-related
+ * attributes (action, method, enctype, target, etc.).
+ *
+ * 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 FormAttrs = Omit<GlobalAttrs, 'aria'> & {
+    /**
+     * URL that processes the form submission.
+     *
+     * @remarks
+     * If omitted, the user agent submits to the current document URL.
+     */
+    action?: string;
+    /**
+     * HTTP method used to submit the form.
+     *
+     * @remarks
+     * Valid values are `get`, `post`, and `dialog`.
+     */
+    method?: FormMethod;
+    /**
+     * Encoding type for the form submission.
+     *
+     * @remarks
+     * Use `multipart/form-data` when uploading files.
+     */
+    enctype?: FormEnctype;
+    /**
+     * Character encodings that are acceptable for server processing.
+     *
+     * @remarks
+     * Maps to the `accept-charset` attribute.
+     */
+    acceptCharset?: string;
+    /**
+     * Whether the browser may autofill this form.
+     */
+    autocomplete?: FormAutocomplete;
+    /**
+     * Name of the form, used for referencing the form in scripts and documents.
+     */
+    name?: string;
+    /**
+     * Disable constraint validation when submitting the form.
+     *
+     * @remarks
+     * Maps to the boolean `novalidate` attribute (represented by attribute presence).
+     */
+    noValidate?: boolean;
+    /**
+     * Where to display the response after submitting the form.
+     *
+     * @remarks
+     * Common values: `_self`, `_blank`, `_parent`, `_top`, or a named browsing context.
+     */
+    target?: '_self' | '_blank' | '_parent' | '_top' | (string & {});
+    /**
+     * Relationship (link types) for the form submission when `target` creates a new context.
+     *
+     * @remarks
+     * This is a space-separated list of tokens (e.g. `noopener noreferrer`).
+     */
+    rel?: string;
+    /**
+     * Structured ARIA fields mapped into `aria-*` attributes.
+     */
+    aria?: StructuredAria;
+};
+/**
+ * Create a form element with optional fallback text and attributes.
+ *
+ * @remarks
+ * - Fallback text 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 form (rare, but supported for parity).
+ * @param attrs - Optional attributes to apply.
+ * @returns The created `<form>` element.
+ *
+ * @example
+ * ```ts
+ * import { createForm } from "@lnpg/pkgn-sol/elements/form/form";
+ *
+ * const form = createForm(undefined, {
+ *   action: "/submit",
+ *   method: "post",
+ *   enctype: "application/x-www-form-urlencoded",
+ * });
+ * document.body.appendChild(form);
+ * ```
+ *
+ * @category DOM
+ */
+export declare function createForm(text?: string, attrs?: FormAttrs): ElementOf<typeof FORM_TAG>;
+/**
+ * Enhance form 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 enhanceForms(root?: ParentNode): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/elements/form/form/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;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,QAAQ,EAAG,MAAe,CAAC;AAExC;;;;GAIG;AACH,eAAO,MAAM,aAAa,SAAS,CAAC;AAEpC;;;;;;;GAOG;AACH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEnD;;;;GAIG;AACH,MAAM,MAAM,WAAW,GACnB,mCAAmC,GACnC,qBAAqB,GACrB,YAAY,CAAC;AAEjB;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,IAAI,GAAG,KAAK,CAAC;AAE5C;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG;IAClD;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC;IAEpB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC;IAEtB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAEhC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAEjE;;;;;OAKG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB,CAAC;AAwEF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC,OAAO,QAAQ,CAAC,CAEvF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAAC,IAAI,GAAE,UAAqB,GAAG,IAAI,CAG9D"}

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

@@ -0,0 +1,140 @@
+/**
+ * Form element factories.
+ *
+ * Provides framework-agnostic factory functions for common HTML form elements.
+ *
+ * These factories:
+ * - Create semantic form structures using pkgn-sol's hardened DOM helpers.
+ * - Forward curated global attributes.
+ * - Enforce structured, typed attribute bags.
+ * - Preserve correct form semantics and associations (e.g. labels, fieldsets).
+ * - Prevent unsafe attribute injection.
+ *
+ * @module elements/form
+ * @since 0.1.0
+ */
+/**
+ * `<button>` element factory namespace.
+ *
+ * Represents a clickable button used to submit forms, reset forms, or trigger
+ * custom actions.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button
+ */
+export * as button from './button';
+/**
+ * `<datalist>` element factory namespace.
+ *
+ * Represents a set of `<option>` suggestions for an associated `<input>`,
+ * enabling autocomplete-like behavior.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/datalist
+ */
+export * as datalist from './datalist';
+/**
+ * `<fieldset>` element factory namespace.
+ *
+ * Represents a grouping container for related form controls, typically paired
+ * with a `<legend>` that labels the group.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/fieldset
+ */
+export * as fieldset from './fieldset';
+/**
+ * `<form>` element factory namespace.
+ *
+ * Represents a document section containing interactive controls for submitting
+ * information to a web server or handling via client-side logic.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form
+ */
+export * as form from './form';
+/**
+ * `<input>` element factory namespace.
+ *
+ * Represents an interactive control for entering data. The `type` attribute
+ * determines the control's behavior and UI.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input
+ */
+export * as input from './input';
+/**
+ * `<label>` element factory namespace.
+ *
+ * Represents a caption for a form control, improving usability and
+ * accessibility. Typically associated via the `for` attribute or by nesting.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/label
+ */
+export * as label from './label';
+/**
+ * `<legend>` element factory namespace.
+ *
+ * Represents a caption for the content of its parent `<fieldset>`, providing an
+ * accessible label for grouped controls.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/legend
+ */
+export * as legend from './legend';
+/**
+ * `<meter>` element factory namespace.
+ *
+ * Represents a scalar measurement within a known range, or a fractional value.
+ * Use `<progress>` instead for progress over time.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/meter
+ */
+export * as meter from './meter';
+/**
+ * `<optgroup>` element factory namespace.
+ *
+ * Represents a grouping of `<option>` elements within a `<select>` or
+ * `<datalist>`.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/optgroup
+ */
+export * as optgroup from './optgroup';
+/**
+ * `<option>` element factory namespace.
+ *
+ * Represents an item within a `<select>`, `<datalist>`, or `<optgroup>`.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/option
+ */
+export * as option from './option';
+/**
+ * `<output>` element factory namespace.
+ *
+ * Represents the result of a calculation or user action, commonly used in
+ * forms to display derived values.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/output
+ */
+export * as output from './output';
+/**
+ * `<progress>` element factory namespace.
+ *
+ * Represents the completion progress of a task, typically over time.
+ * Use `<meter>` instead for a measurement within a known range.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/progress
+ */
+export * as progress from './progress';
+/**
+ * `<select>` element factory namespace.
+ *
+ * Represents a control that provides a menu of options for the user to choose
+ * from.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/select
+ */
+export * as select from './select';
+/**
+ * `<textarea>` element factory namespace.
+ *
+ * Represents a multi-line plain-text editing control.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/textarea
+ */
+export * as textarea from './textarea';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/elements/form/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;;;;GAOG;AACH,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AAEnC;;;;;;;GAOG;AACH,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC;AAEvC;;;;;;;GAOG;AACH,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC;AAEvC;;;;;;;GAOG;AACH,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAE/B;;;;;;;GAOG;AACH,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AAEjC;;;;;;;GAOG;AACH,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AAEjC;;;;;;;GAOG;AACH,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AAEnC;;;;;;;GAOG;AACH,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AAEjC;;;;;;;GAOG;AACH,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC;AAEvC;;;;;;GAMG;AACH,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AAEnC;;;;;;;GAOG;AACH,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AAEnC;;;;;;;GAOG;AACH,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC;AAEvC;;;;;;;GAOG;AACH,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AAEnC;;;;;;GAMG;AACH,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC"}

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

@@ -0,0 +1,313 @@
+/**
+ * pkgn-sol Design Foundation: Input element helpers.
+ *
+ * @remarks
+ * The input element (`<input>`) represents a typed data field whose behavior is
+ * primarily controlled by its `type` attribute. :contentReference[oaicite:5]{index=5}
+ *
+ * Best-practice guidance:
+ * - Prefer the most specific `type` possible (e.g. `email`, `tel`, `number`)
+ *   to improve UX and validation behavior.
+ * - Always provide an accessible name (visible label, `aria-label`, or
+ *   `aria-labelledby`).
+ * - Treat `autocomplete`, `inputmode`, and `enterkeyhint` as UX hints, not
+ *   security controls. :contentReference[oaicite:6]{index=6}
+ * - For `<input type="image">`, include meaningful `alt` text; while it may be
+ *   technically optional, it should be provided for usability/accessibility. :contentReference[oaicite:7]{index=7}
+ *
+ * pkgn-sol-specific conventions:
+ * - Defaults `type` to `"text"` unless explicitly overridden (typed field or raw
+ *   attrs escape hatch), matching HTML's default behavior. :contentReference[oaicite:8]{index=8}
+ * - 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;
+};
+/**
+ * Common input `type` values.
+ *
+ * @remarks
+ * The `type` attribute controls which control is rendered and how values are
+ * processed. :contentReference[oaicite:9]{index=9}
+ *
+ * pkgn-sol models the widely used types while still allowing the raw `attrs` escape
+ * hatch for unusual/experimental values.
+ *
+ * @category Attributes
+ */
+export type InputType = 'text' | 'password' | 'email' | 'number' | 'search' | 'tel' | 'url' | 'date' | 'datetime-local' | 'month' | 'week' | 'time' | 'color' | 'checkbox' | 'radio' | 'file' | 'hidden' | 'image' | 'range' | 'reset' | 'submit' | 'button';
+/**
+ * Values for the `inputmode` hint.
+ *
+ * @remarks
+ * `inputmode` is a hint to user agents about what kind of virtual keyboard to
+ * show. :contentReference[oaicite:10]{index=10}
+ *
+ * @category Attributes
+ */
+export type InputMode = 'none' | 'text' | 'tel' | 'url' | 'email' | 'numeric' | 'decimal' | 'search';
+/**
+ * Values for the `enterkeyhint` hint.
+ *
+ * @remarks
+ * Defines what action label/icon to present for the enter key on virtual
+ * keyboards. :contentReference[oaicite:11]{index=11}
+ *
+ * @category Attributes
+ */
+export type EnterKeyHint = 'enter' | 'done' | 'go' | 'next' | 'previous' | 'search' | 'send';
+/**
+ * Values for the `popovertargetaction` attribute when the input is used as a
+ * popover invoker button.
+ *
+ * @category Attributes
+ */
+export type PopoverTargetAction = 'toggle' | 'show' | 'hide';
+/**
+ * The semantic tag name for inputs.
+ *
+ * @category Constants
+ */
+export declare const INPUT_TAG: "input";
+/**
+ * A CSS selector targeting input elements.
+ *
+ * @category Constants
+ */
+export declare const INPUT_SELECTOR = "input";
+/**
+ * Attribute bag for input creation/enhancement.
+ *
+ * @remarks
+ * `<input>` supports a large surface area of attributes, many of which are
+ * type-dependent. pkgn-sol models common attributes explicitly and provides
+ * {@link GlobalAttrs.attrs} as an escape hatch (validated by `dom.ts`).
+ *
+ * Notes:
+ * - pkgn-sol defaults `type` to `"text"` unless explicitly overridden. :contentReference[oaicite:12]{index=12}
+ * - Boolean attributes are applied by presence (empty string) when `true`.
+ * - For `type="image"`, `alt` should be provided for accessibility. :contentReference[oaicite:13]{index=13}
+ *
+ * @category Attributes
+ */
+export type InputAttrs = Omit<GlobalAttrs, 'aria'> & {
+    /**
+     * Structured ARIA fields mapped into `aria-*` attributes.
+     */
+    aria?: StructuredAria;
+    /**
+     * The input type. Defaults to `"text"` in pkgn-sol.
+     */
+    type?: InputType;
+    /**
+     * Form field name (used during submission).
+     */
+    name?: string;
+    /**
+     * Initial/current value (type-dependent semantics).
+     */
+    value?: string;
+    /**
+     * Placeholder hint (text-like types).
+     */
+    placeholder?: string;
+    /**
+     * Disables the control when true.
+     */
+    disabled?: boolean;
+    /**
+     * Marks the control read-only when true (where applicable).
+     */
+    readOnly?: boolean;
+    /**
+     * Marks the control required for form submission.
+     */
+    required?: boolean;
+    /**
+     * Enables multiple values (e.g. file inputs).
+     */
+    multiple?: boolean;
+    /**
+     * Marks a checkbox or radio as checked.
+     */
+    checked?: boolean;
+    /**
+     * Minimum value (number/date/time/range-like types).
+     */
+    min?: string | number;
+    /**
+     * Maximum value (number/date/time/range-like types).
+     */
+    max?: string | number;
+    /**
+     * Step interval (number/date/time/range-like types).
+     */
+    step?: string | number;
+    /**
+     * Minimum length (text-like types).
+     */
+    minLength?: number;
+    /**
+     * Maximum length (text-like types).
+     */
+    maxLength?: number;
+    /**
+     * Validation pattern (text-like types).
+     */
+    pattern?: string;
+    /**
+     * Size hint (visible character width, where applicable).
+     */
+    size?: number;
+    /**
+     * Autocomplete hint.
+     */
+    autoComplete?: string;
+    /**
+     * Autofocus hint.
+     */
+    autofocus?: boolean;
+    /**
+     * Associates the control with a datalist element by ID.
+     */
+    list?: string;
+    /**
+     * Associates the control with a form element by ID.
+     */
+    form?: string;
+    /**
+     * Overrides form submission target for submit/image inputs.
+     */
+    formAction?: string;
+    /**
+     * Overrides form submission encoding for submit/image inputs.
+     */
+    formEnctype?: 'application/x-www-form-urlencoded' | 'multipart/form-data' | 'text/plain';
+    /**
+     * Overrides form submission method for submit/image inputs.
+     */
+    formMethod?: 'get' | 'post' | 'dialog';
+    /**
+     * Prevents constraint validation on submission.
+     */
+    formNoValidate?: boolean;
+    /**
+     * Overrides form submission browsing context target.
+     */
+    formTarget?: string;
+    /**
+     * Source URL for `type="image"`.
+     */
+    src?: string;
+    /**
+     * Alternate text for `type="image"`.
+     *
+     * @remarks
+     * This is only meaningful for image inputs and should be provided. :contentReference[oaicite:14]{index=14}
+     */
+    alt?: string;
+    /**
+     * Width for `type="image"`.
+     */
+    width?: number;
+    /**
+     * Height for `type="image"`.
+     */
+    height?: number;
+    /**
+     * Accepted file types (for `type="file"`).
+     */
+    accept?: string;
+    /**
+     * Media capture hint (primarily file inputs on mobile).
+     *
+     * @remarks
+     * If set to `true`, the boolean attribute is applied by presence.
+     */
+    capture?: 'user' | 'environment' | true;
+    /**
+     * Hint for the virtual keyboard shown on touch devices.
+     */
+    inputMode?: InputMode;
+    /**
+     * Hint for the virtual keyboard enter key label/icon.
+     */
+    enterKeyHint?: EnterKeyHint;
+    /**
+     * ID of the popover element this input controls (typically `type="button"`).
+     */
+    popoverTarget?: string;
+    /**
+     * Action to perform on the targeted popover.
+     */
+    popoverTargetAction?: PopoverTargetAction;
+};
+/**
+ * Create an input element with attributes.
+ *
+ * @remarks
+ * - `<input>` is a void element; it never receives text content. :contentReference[oaicite:15]{index=15}
+ * - pkgn-sol defaults `type` to `"text"` unless overridden. :contentReference[oaicite:16]{index=16}
+ * - 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 attrs - Optional attributes to apply.
+ * @returns The created `<input>` element.
+ *
+ * @example
+ * ```ts
+ * import { createInput } from "@lnpg/pkgn-sol/elements/form/input";
+ *
+ * const email = createInput({
+ *   type: "email",
+ *   name: "email",
+ *   autoComplete: "email",
+ *   inputMode: "email",
+ * });
+ * ```
+ *
+ * @category DOM
+ */
+export declare function createInput(attrs?: InputAttrs): ElementOf<typeof INPUT_TAG>;
+/**
+ * Enhance input 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 enhanceInputs(root?: ParentNode): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/elements/form/input/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAGL,KAAK,SAAS,EACd,KAAK,WAAW,EACjB,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;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;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,UAAU,GACV,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,KAAK,GACL,KAAK,GACL,MAAM,GACN,gBAAgB,GAChB,OAAO,GACP,MAAM,GACN,MAAM,GACN,OAAO,GACP,UAAU,GACV,OAAO,GACP,MAAM,GACN,QAAQ,GACR,OAAO,GACP,OAAO,GACP,OAAO,GACP,QAAQ,GACR,QAAQ,CAAC;AAEb;;;;;;;;GAQG;AACH,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,MAAM,GACN,KAAK,GACL,KAAK,GACL,OAAO,GACP,SAAS,GACT,SAAS,GACT,QAAQ,CAAC;AAEb;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE7F;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAE7D;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAG,OAAgB,CAAC;AAE1C;;;;GAIG;AACH,eAAO,MAAM,cAAc,UAAU,CAAC;AAEtC;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG;IACnD;;OAEG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC;IAEtB;;OAEG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;IAEjB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAEtB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAEtB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAEvB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,WAAW,CAAC,EAAE,mCAAmC,GAAG,qBAAqB,GAAG,YAAY,CAAC;IAEzF;;OAEG;IACH,UAAU,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;IAEvC;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;;;OAKG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAAC;IAExC;;OAEG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IAEtB;;OAEG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;IAE5B;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CAC3C,CAAC;AAkIF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,WAAW,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC,OAAO,SAAS,CAAC,CAE3E;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,IAAI,GAAE,UAAqB,GAAG,IAAI,CAG/D"}