@lnpg/pkgn-sol 1.0.0-beta.0

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

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

package/dist/types/elements/media/math/index.d.ts

@@ -0,0 +1,132 @@
+/**
+ * pkgn-sol Design Foundation: Math element helpers.
+ *
+ * @remarks
+ * The MathML math element (`<math>`) represents mathematical notation.
+ *
+ * Best-practice guidance:
+ * - Prefer real MathML over images for math content when possible.
+ * - Use `display="block"` for standalone equations; inline math remains the default.
+ * - Do not rely on raw attribute injection for behavior; keep markup semantic.
+ *
+ * Accessibility defaults for pkgn-sol v0.1.0:
+ * - `<math>` is treated as decorative by default:
+ *   - `aria-hidden="true"`
+ *   - `tabIndex = -1`
+ * - If consumers provide explicit overrides (e.g. `aria.hidden`, `tabIndex`), pkgn-sol
+ *   respects them.
+ *
+ * This module provides small, framework-agnostic helpers so consumers can:
+ * - create MathML roots 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.
+ *
+ * @module
+ * @category Elements
+ */
+import { 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 MathML roots.
+ *
+ * @category Constants
+ */
+export declare const MATH_TAG: "math";
+/**
+ * A CSS selector targeting math elements.
+ *
+ * @category Constants
+ */
+export declare const MATH_SELECTOR = "math";
+/**
+ * Attribute bag for math creation/enhancement.
+ *
+ * @remarks
+ * MathML `<math>` supports the `display` attribute:
+ * - `inline` (default)
+ * - `block`
+ *
+ * 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 MathAttrs = Omit<GlobalAttrs, 'aria'> & {
+    /**
+     * Structured ARIA fields mapped into `aria-*` attributes.
+     */
+    aria?: StructuredAria;
+    /**
+     * MathML display mode.
+     *
+     * @remarks
+     * `block` renders as a block-level equation, `inline` renders inline.
+     */
+    display?: 'block' | 'inline';
+};
+/**
+ * Create a MathML `<math>` 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.
+ *
+ * Note: `<math>` is not part of {@link HTMLElementTagNameMap}, so pkgn-sol creates it
+ * via `document.createElement("math")` and narrows the type to {@link MathMLElement}.
+ *
+ * @param text - Optional text content for the math element.
+ * @param attrs - Optional attributes to apply.
+ * @returns The created `<math>` element.
+ *
+ * @category DOM
+ */
+export declare function createMath(text?: string, attrs?: MathAttrs): MathMLElement;
+/**
+ * Enhance math 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 enhanceMath(root?: ParentNode): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/elements/media/math/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/elements/media/math/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAoB,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAErE;;;;;;;;;;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;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG;IAClD;;OAEG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC;IAEtB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;CAC9B,CAAC;AAkDF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,SAAS,GAAG,aAAa,CAQ1E;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,IAAI,GAAE,UAAqB,GAAG,IAAI,CAG7D"}

package/dist/types/elements/media/object/index.d.ts

@@ -0,0 +1,183 @@
+/**
+ * pkgn-sol Design Foundation: Object element helpers.
+ *
+ * @remarks
+ * The object element (`<object>`) embeds external resources (HTML, images, PDFs,
+ * SVG, etc.) into the document.
+ *
+ * Best-practice guidance:
+ * - Prefer purpose-built elements when available:
+ *   - `<img>` for images
+ *   - `<video>` / `<audio>` for media
+ *   - `<iframe>` for embedded documents/interactive content (with sandboxing)
+ * - Always provide a meaningful fallback inside `<object>` for unsupported content.
+ * - Avoid obsolete attributes (e.g. `codebase`, `classid`, `declare`, etc.).
+ * - For layout, prefer CSS. If using `width`/`height` attributes, keep them numeric.
+ *
+ * Attribute guidance:
+ * - At least one of `data` or `type` should be provided.
+ * - If neither is provided, pkgn-sol falls back to `data="about:blank"` to avoid an
+ *   "empty" embed configuration while staying inert.
+ *
+ * This module provides small, framework-agnostic helpers so consumers can:
+ * - create object 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.
+ *
+ * @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;
+    /**
+     * ID reference to the describing element(s), mapped to `aria-describedby`.
+     */
+    describedby?: string;
+    /**
+     * Decorative/hidden hint, mapped to `aria-hidden`.
+     */
+    hidden?: boolean;
+};
+/**
+ * The semantic tag name for object embeds.
+ *
+ * @category Constants
+ */
+export declare const OBJECT_TAG: "object";
+/**
+ * A CSS selector targeting object elements.
+ *
+ * @category Constants
+ */
+export declare const OBJECT_SELECTOR = "object";
+/**
+ * Dimension values allowed for width/height attributes.
+ *
+ * @remarks
+ * Per best practice, keep these numeric (pixels). Prefer CSS for layout.
+ *
+ * @category Types
+ */
+export type ObjectDimension = number | `${number}`;
+/**
+ * Attribute bag for object creation/enhancement.
+ *
+ * @remarks
+ * - `data` and `type` are the primary configuration attributes.
+ * - Provide fallback content via `text` or by appending children after creation.
+ * - Global attributes are supported, including a structured ARIA input.
+ *
+ * @category Attributes
+ */
+export type ObjectAttrs = Omit<GlobalAttrs, 'aria'> & {
+    /**
+     * Address of the resource to embed (maps to `data`).
+     */
+    data?: string;
+    /**
+     * MIME type of the embedded resource (maps to `type`).
+     *
+     * @example
+     * "text/html", "image/svg+xml", "application/pdf"
+     */
+    type?: string;
+    /**
+     * Name of the object (maps to `name`).
+     */
+    name?: string;
+    /**
+     * Associate the object with a form (maps to `form`).
+     */
+    form?: string;
+    /**
+     * Width in CSS pixels (maps to `width`).
+     *
+     * @remarks
+     * Prefer CSS for layout.
+     */
+    width?: ObjectDimension;
+    /**
+     * Height in CSS pixels (maps to `height`).
+     *
+     * @remarks
+     * Prefer CSS for layout.
+     */
+    height?: ObjectDimension;
+    /**
+     * Structured ARIA fields mapped into `aria-*` attributes.
+     */
+    aria?: StructuredAria;
+};
+/**
+ * Create an object element with optional fallback text and attributes.
+ *
+ * @remarks
+ * - Fallback text is assigned via `textContent` (never `innerHTML`).
+ * - For richer fallback, append children after creation.
+ * - 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 fallback text content for the object.
+ * @param attrs - Optional attributes to apply.
+ * @returns The created `<object>` element.
+ *
+ * @example
+ * ```ts
+ * import { createObject } from "@lnpg/pkgn-sol/elements/media/object";
+ *
+ * const obj = createObject("Your browser can't display this content.", {
+ *   data: "/docs/guide.pdf",
+ *   type: "application/pdf",
+ *   width: 640,
+ *   height: 480,
+ * });
+ *
+ * document.body.appendChild(obj);
+ * ```
+ *
+ * @category DOM
+ */
+export declare function createObject(text?: string, attrs?: ObjectAttrs): ElementOf<typeof OBJECT_TAG>;
+/**
+ * Enhance object 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 enhanceObjects(root?: ParentNode): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/elements/media/object/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/elements/media/object/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;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,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAG,QAAiB,CAAC;AAE5C;;;;GAIG;AACH,eAAO,MAAM,eAAe,WAAW,CAAC;AAExC;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;AAEnD;;;;;;;;;GASG;AACH,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG;IACpD;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;;OAKG;IACH,KAAK,CAAC,EAAE,eAAe,CAAC;IAExB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,eAAe,CAAC;IAEzB;;OAEG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB,CAAC;AAgFF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,YAAY,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC,OAAO,UAAU,CAAC,CAE7F;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAAC,IAAI,GAAE,UAAqB,GAAG,IAAI,CAGhE"}

package/dist/types/elements/media/svg/index.d.ts

@@ -0,0 +1,44 @@
+/**
+ * pkgn-sol Design Foundation: Svg element helpers.
+ *
+ * @remarks
+ * The svg element (`<svg>`) defines scalable vector graphics.
+ *
+ * pkgn-sol enforces:
+ * - Default decorative behaviour:
+ *   - aria-hidden="true"
+ *   - tabIndex = -1
+ *   - focusable="false"
+ * - If aria.label or aria.labelledby is provided:
+ *   - role="img" is added (unless explicitly set)
+ * - Explicit overrides for role, aria-hidden and tabIndex are respected.
+ *
+ * @module
+ * @category Elements
+ */
+import { type GlobalAttrs } from '../../../ts/dom';
+/**
+ * Structured ARIA input.
+ */
+export type StructuredAria = {
+    label?: string;
+    labelledby?: string;
+    hidden?: boolean;
+};
+export declare const SVG_TAG = "svg";
+export declare const SVG_SELECTOR = "svg";
+export type SvgAttrs = Omit<GlobalAttrs, 'aria'> & {
+    viewBox?: string;
+    width?: number | string;
+    height?: number | string;
+    aria?: StructuredAria;
+};
+/**
+ * Create an SVG element with accessibility defaults.
+ */
+export declare function createSvg(text?: string, attrs?: SvgAttrs): SVGSVGElement;
+/**
+ * No-op enhancement hook.
+ */
+export declare function enhanceSvgs(root?: ParentNode): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/elements/media/svg/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/elements/media/svg/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAoB,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAErE;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,eAAO,MAAM,OAAO,QAAQ,CAAC;AAC7B,eAAO,MAAM,YAAY,QAAQ,CAAC;AAElC,MAAM,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB,CAAC;AA+DF;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,QAAQ,GAAG,aAAa,CAUxE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,GAAE,UAAqB,GAAG,IAAI,CAE7D"}

package/dist/types/elements/media/video/index.d.ts

@@ -0,0 +1,225 @@
+/**
+ * pkgn-sol Design Foundation: Video element helpers.
+ *
+ * @remarks
+ * The video element (`<video>`) embeds media playback.
+ *
+ * Best-practice guidance:
+ * - Provide user controls (`controls`) unless you have a very strong reason not to.
+ * - Autoplay is often blocked when audio is present; if `autoplay` is enabled,
+ *   videos commonly need to be `muted` to actually autoplay in modern browsers.
+ * - Prefer captions/subtitles via `<track>` for accessibility when relevant.
+ * - Avoid obsolete attributes; use modern properties/attributes and CSS instead.
+ *
+ * This module provides small, framework-agnostic helpers so consumers can:
+ * - create video 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.
+ *
+ * @module
+ * @category Elements
+ */
+import { 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;
+};
+/**
+ * Token values for the `preload` attribute.
+ *
+ * @category Attributes
+ */
+export type VideoPreload = 'none' | 'metadata' | 'auto';
+/**
+ * Token values for the `crossorigin` attribute.
+ *
+ * @category Attributes
+ */
+export type VideoCrossOrigin = 'anonymous' | 'use-credentials';
+/**
+ * Token values for the `referrerpolicy` attribute.
+ *
+ * @category Attributes
+ */
+export type VideoReferrerPolicy = 'no-referrer' | 'no-referrer-when-downgrade' | 'origin' | 'origin-when-cross-origin' | 'same-origin' | 'strict-origin' | 'strict-origin-when-cross-origin' | 'unsafe-url';
+/**
+ * Token values for the `fetchpriority` attribute (where supported).
+ *
+ * @category Attributes
+ */
+export type VideoFetchPriority = 'high' | 'low' | 'auto';
+/**
+ * The semantic tag name for video.
+ *
+ * @category Constants
+ */
+export declare const VIDEO_TAG: "video";
+/**
+ * A CSS selector targeting video elements.
+ *
+ * @category Constants
+ */
+export declare const VIDEO_SELECTOR = "video";
+/**
+ * Attribute bag for video creation/enhancement.
+ *
+ * @remarks
+ * Video elements accept standard HTML global attributes, plus media-specific
+ * attributes and properties.
+ *
+ * pkgn-sol supports a structured ARIA input for common ARIA fields, mapped into
+ * {@link GlobalAttrs.aria} without changing pkgn-sol's core DOM helpers.
+ *
+ * @category Attributes
+ */
+export type VideoAttrs = Omit<GlobalAttrs, 'aria'> & {
+    /**
+     * Structured ARIA fields mapped into `aria-*` attributes.
+     */
+    aria?: StructuredAria;
+    /**
+     * Source URL for the video.
+     */
+    src?: string;
+    /**
+     * Whether the browser should offer playback controls to the user.
+     */
+    controls?: boolean;
+    /**
+     * Whether the video should start playing automatically.
+     *
+     * @remarks
+     * Autoplay is frequently blocked unless the video is muted.
+     */
+    autoplay?: boolean;
+    /**
+     * Whether the video should loop after ending.
+     */
+    loop?: boolean;
+    /**
+     * Whether the audio should be muted.
+     */
+    muted?: boolean;
+    /**
+     * Hint that playback should happen inline on mobile browsers (not fullscreen).
+     */
+    playsInline?: boolean;
+    /**
+     * Preload behavior hint.
+     */
+    preload?: VideoPreload;
+    /**
+     * Poster image URL shown before playback starts.
+     */
+    poster?: string;
+    /**
+     * Display width in CSS pixels (attribute-reflected).
+     */
+    width?: number;
+    /**
+     * Display height in CSS pixels (attribute-reflected).
+     */
+    height?: number;
+    /**
+     * CORS setting for fetching the media.
+     */
+    crossOrigin?: VideoCrossOrigin;
+    /**
+     * Feature-control tokens for the video UI.
+     *
+     * @remarks
+     * Maps to the `controlslist` attribute (space-separated tokens).
+     */
+    controlsList?: string[] | string;
+    /**
+     * Disable Picture-in-Picture where supported.
+     */
+    disablePictureInPicture?: boolean;
+    /**
+     * Disable remote playback where supported.
+     */
+    disableRemotePlayback?: boolean;
+    /**
+     * Referrer policy for fetching the media.
+     */
+    referrerPolicy?: VideoReferrerPolicy;
+    /**
+     * Fetch priority hint (where supported).
+     */
+    fetchPriority?: VideoFetchPriority;
+};
+/**
+ * Create a video 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.
+ * - If `autoplay` is enabled and `muted` is not explicitly provided, pkgn-sol will
+ *   default `muted` to `true` to align with common browser autoplay policies.
+ *
+ * @param text - Optional fallback text shown if video is unsupported.
+ * @param attrs - Optional attributes to apply.
+ * @returns The created `<video>` element.
+ *
+ * @example
+ * ```ts
+ * import { createVideo } from "@lnpg/pkgn-sol/elements/media/video";
+ *
+ * document.body.appendChild(
+ *   createVideo("Your browser does not support video.", {
+ *     src: "/media/intro.mp4",
+ *     controls: true,
+ *     preload: "metadata",
+ *   })
+ * );
+ * ```
+ *
+ * @category DOM
+ */
+export declare function createVideo(text?: string, attrs?: VideoAttrs): HTMLVideoElement;
+/**
+ * Enhance video 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 enhanceVideos(root?: ParentNode): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/elements/media/video/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/elements/media/video/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAiB,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAElE;;;;;;;;;;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,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;AAExD;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,iBAAiB,CAAC;AAE/D;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAC3B,aAAa,GACb,4BAA4B,GAC5B,QAAQ,GACR,0BAA0B,GAC1B,aAAa,GACb,eAAe,GACf,iCAAiC,GACjC,YAAY,CAAC;AAEjB;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;AAEzD;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAG,OAAgB,CAAC;AAE1C;;;;GAIG;AACH,eAAO,MAAM,cAAc,UAAU,CAAC;AAEtC;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG;IACnD;;OAEG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC;IAEtB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;OAEG;IACH,OAAO,CAAC,EAAE,YAAY,CAAC;IAEvB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAE/B;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAEjC;;OAEG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAElC;;OAEG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAEhC;;OAEG;IACH,cAAc,CAAC,EAAE,mBAAmB,CAAC;IAErC;;OAEG;IACH,aAAa,CAAC,EAAE,kBAAkB,CAAC;CACpC,CAAC;AAkFF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,UAAU,GAAG,gBAAgB,CAgC/E;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAAC,IAAI,GAAE,UAAqB,GAAG,IAAI,CAG/D"}