@lnpg/pkgn-sol 1.0.0-beta.0

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

@@ -0,0 +1,146 @@
+/**
+ * pkgn-sol Design Foundation: Canvas element helpers.
+ *
+ * @remarks
+ * The canvas element (`<canvas>`) provides a scriptable drawing surface.
+ *
+ * Best-practice guidance:
+ * - Prefer setting `width` and `height` attributes (not only CSS sizing) to avoid
+ *   rendering distortion from bitmap scaling.
+ * - Provide meaningful fallback content where appropriate (e.g. a short text
+ *   alternative) as the canvas element can represent its fallback content in
+ *   non-visual/unsupported contexts.
+ * - If the canvas conveys information, ensure it is labeled accessibly (e.g.
+ *   via `aria-label` / `aria-labelledby`) and that equivalent information is
+ *   available outside the canvas where needed.
+ *
+ * This module provides small, framework-agnostic helpers so consumers can:
+ * - create canvas 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 (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 canvas.
+ *
+ * @category Constants
+ */
+export declare const CANVAS_TAG: "canvas";
+/**
+ * A CSS selector targeting canvas elements.
+ *
+ * @category Constants
+ */
+export declare const CANVAS_SELECTOR = "canvas";
+/**
+ * Attribute bag for canvas creation/enhancement.
+ *
+ * @remarks
+ * Canvas supports:
+ * - standard HTML global attributes
+ * - `width` and `height` attributes for bitmap sizing
+ * - structured ARIA input mapped into `aria-*`
+ *
+ * @category Attributes
+ */
+export type CanvasAttrs = Omit<GlobalAttrs, 'aria'> & {
+    /**
+     * Structured ARIA fields mapped into `aria-*` attributes.
+     */
+    aria?: StructuredAria;
+    /**
+     * Bitmap width (in CSS pixels) for the canvas drawing surface.
+     *
+     * @remarks
+     * Prefer this over CSS-only sizing to avoid scaling distortion.
+     */
+    width?: number;
+    /**
+     * Bitmap height (in CSS pixels) for the canvas drawing surface.
+     *
+     * @remarks
+     * Prefer this over CSS-only sizing to avoid scaling distortion.
+     */
+    height?: number;
+};
+/**
+ * Create a canvas element with optional fallback text content and attributes.
+ *
+ * @remarks
+ * - Text content is assigned via `textContent` (never `innerHTML`).
+ * - `width` and `height` (if provided) are applied as attributes via the safe
+ *   attribute path in `dom.ts`.
+ * - 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 canvas.
+ * @param attrs - Optional attributes to apply.
+ * @returns The created `<canvas>` element.
+ *
+ * @example
+ * Create a 300x150 canvas with a label:
+ * ```ts
+ * import { createCanvas } from "@lnpg/pkgn-sol/elements/media/canvas";
+ *
+ * const el = createCanvas(undefined, {
+ *   width: 300,
+ *   height: 150,
+ *   aria: { label: "Sparkline chart" },
+ * });
+ * ```
+ *
+ * @category DOM
+ */
+export declare function createCanvas(text?: string, attrs?: CanvasAttrs): ElementOf<typeof CANVAS_TAG>;
+/**
+ * Enhance canvas 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 enhanceCanvases(root?: ParentNode): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/elements/media/canvas/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;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,UAAU,EAAG,QAAiB,CAAC;AAE5C;;;;GAIG;AACH,eAAO,MAAM,eAAe,WAAW,CAAC;AAExC;;;;;;;;;;GAUG;AACH,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG;IACpD;;OAEG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC;IAEtB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAmCF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,YAAY,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC,OAAO,UAAU,CAAC,CAE7F;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,IAAI,GAAE,UAAqB,GAAG,IAAI,CAGjE"}

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

@@ -0,0 +1,138 @@
+/**
+ * pkgn-sol Design Foundation: Embed element helpers.
+ *
+ * @remarks
+ * The embed element (`<embed>`) embeds external content at a point in the
+ * document. Historically this was often browser plug-ins; modern browsers have
+ * largely removed plug-in support, so relying on `<embed>` is frequently a poor
+ * choice for general-purpose sites. Prefer purpose-built elements when possible
+ * (e.g. `<img>`, `<video>`, `<audio>`, `<iframe>`, or `<object>` depending on the use case).
+ *
+ * Best-practice guidance:
+ * - Prefer native elements over `<embed>` when there is a semantic alternative.
+ * - Use the `title` attribute to label embedded content for assistive technology.
+ * - `width`/`height` should be absolute pixel values (no percentages).
+ *
+ * This module provides small, framework-agnostic helpers so consumers can:
+ * - create embed nodes 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 labelling element(s), mapped to `aria-labelledby`.
+     */
+    labelledby?: string;
+    /**
+     * Decorative/hidden hint, mapped to `aria-hidden`.
+     */
+    hidden?: boolean;
+};
+/**
+ * The semantic tag name for embed.
+ *
+ * @category Constants
+ */
+export declare const EMBED_TAG: "embed";
+/**
+ * A CSS selector targeting embed elements.
+ *
+ * @category Constants
+ */
+export declare const EMBED_SELECTOR = "embed";
+/**
+ * Attribute bag for embed creation/enhancement.
+ *
+ * @remarks
+ * `<embed>` supports global attributes plus:
+ * - `src` (URL)
+ * - `type` (MIME type)
+ * - `width` / `height` (absolute pixel values; percentages are invalid)
+ *
+ * Accessibility:
+ * - Provide a `title` (global attribute) to label the embedded content.
+ *
+ * pkgn-sol also supports a structured ARIA input for common ARIA fields, mapped into
+ * `aria-*` attributes.
+ *
+ * @category Attributes
+ */
+export type EmbedAttrs = Omit<GlobalAttrs, 'aria'> & {
+    /**
+     * URL of the resource being embedded.
+     */
+    src?: string;
+    /**
+     * MIME type used to select the appropriate handler.
+     */
+    type?: string;
+    /**
+     * Displayed width in CSS pixels (absolute; percentages are not allowed).
+     */
+    width?: number | string;
+    /**
+     * Displayed height in CSS pixels (absolute; percentages are not allowed).
+     */
+    height?: number | string;
+    /**
+     * Structured ARIA fields mapped into `aria-*` attributes.
+     */
+    aria?: StructuredAria;
+};
+/**
+ * Create an embed element and apply attributes.
+ *
+ * @remarks
+ * 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 `<embed>` element.
+ *
+ * @example
+ * ```ts
+ * import { createEmbed } from "@lnpg/pkgn-sol/elements/media/embed";
+ *
+ * document.body.appendChild(
+ *   createEmbed({ src: "/files/manual.pdf", type: "application/pdf", title: "User manual" })
+ * );
+ * ```
+ *
+ * @category DOM
+ */
+export declare function createEmbed(attrs?: EmbedAttrs): ElementOf<typeof EMBED_TAG>;
+/**
+ * Enhance embed 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 enhanceEmbeds(root?: ParentNode): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/elements/media/embed/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAGL,KAAK,SAAS,EACd,KAAK,WAAW,EACjB,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;;;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,SAAS,EAAG,OAAgB,CAAC;AAE1C;;;;GAIG;AACH,eAAO,MAAM,cAAc,UAAU,CAAC;AAEtC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG;IACnD;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAExB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAEzB;;OAEG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB,CAAC;AAwFF;;;;;;;;;;;;;;;;;;;;;GAqBG;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"}

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

@@ -0,0 +1,222 @@
+/**
+ * pkgn-sol Design Foundation: IFrame element helpers.
+ *
+ * @remarks
+ * The iframe element (`<iframe>`) embeds another HTML page into the current page.
+ *
+ * Best-practice guidance:
+ * - Prefer `<iframe>` only when you truly need third-party or isolated documents.
+ * - Consider `loading="lazy"` for non-critical iframes to reduce initial load cost.
+ * - Use `sandbox` with the least permissions possible when embedding untrusted content.
+ * - Prefer restrictive `referrerpolicy` when embedding third-party content.
+ * - Provide a meaningful `title` for accessibility (screen readers use it to identify the frame).
+ * - Avoid obsolete attributes like `frameborder`; use CSS instead.
+ *
+ * Security notes:
+ * - `srcdoc` embeds HTML directly. pkgn-sol does not sanitize or validate it.
+ *   If you build `srcdoc` from untrusted input, that is on you (and your incident report).
+ *
+ * This module provides small, framework-agnostic helpers so consumers can:
+ * - create iframes 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;
+    /**
+     * Decorative/hidden hint, mapped to `aria-hidden`.
+     */
+    hidden?: boolean;
+};
+/**
+ * The semantic tag name for iframe embeds.
+ *
+ * @category Constants
+ */
+export declare const IFRAME_TAG: "iframe";
+/**
+ * A CSS selector targeting iframe elements.
+ *
+ * @category Constants
+ */
+export declare const IFRAME_SELECTOR = "iframe";
+/**
+ * Allowed values for the iframe `loading` attribute.
+ *
+ * @category Types
+ */
+export type IFrameLoading = 'eager' | 'lazy';
+/**
+ * Allowed values for the iframe `referrerpolicy` attribute.
+ *
+ * @category Types
+ */
+export type IFrameReferrerPolicy = 'no-referrer' | 'no-referrer-when-downgrade' | 'origin' | 'origin-when-cross-origin' | 'same-origin' | 'strict-origin' | 'strict-origin-when-cross-origin' | 'unsafe-url';
+/**
+ * Allowed values for the `fetchpriority` attribute.
+ *
+ * @category Types
+ */
+export type FetchPriority = 'high' | 'low' | 'auto';
+/**
+ * Attribute bag for iframe creation/enhancement.
+ *
+ * @remarks
+ * Iframes accept standard HTML global attributes plus iframe-specific 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 IFrameAttrs = Omit<GlobalAttrs, 'aria'> & {
+    /**
+     * Structured ARIA fields mapped into `aria-*` attributes.
+     */
+    aria?: StructuredAria;
+    /**
+     * Address of the document to embed.
+     */
+    src?: string;
+    /**
+     * Inline HTML to render within the iframe.
+     *
+     * @remarks
+     * pkgn-sol does not sanitize `srcdoc`.
+     */
+    srcdoc?: string;
+    /**
+     * A name for the browsing context.
+     */
+    name?: string;
+    /**
+     * A space-separated list of sandbox tokens.
+     *
+     * @remarks
+     * Use the least permissive sandbox you can.
+     */
+    sandbox?: string;
+    /**
+     * Permissions policy for the iframe (previously "feature policy").
+     *
+     * @remarks
+     * Example: `allow="fullscreen; geolocation 'none'"`.
+     */
+    allow?: string;
+    /**
+     * Whether fullscreen is allowed.
+     *
+     * @remarks
+     * Mirrors the `allowfullscreen` boolean attribute.
+     */
+    allowFullScreen?: boolean;
+    /**
+     * Whether the iframe should be loaded lazily or eagerly.
+     */
+    loading?: IFrameLoading;
+    /**
+     * Referrer policy for requests made by the iframe.
+     */
+    referrerPolicy?: IFrameReferrerPolicy;
+    /**
+     * Display width, in CSS pixels.
+     */
+    width?: number | string;
+    /**
+     * Display height, in CSS pixels.
+     */
+    height?: number | string;
+    /**
+     * Fetch priority hint.
+     */
+    fetchPriority?: FetchPriority;
+    /**
+     * Content Security Policy to apply to the embedded document.
+     *
+     * @remarks
+     * Support varies by browser and context.
+     */
+    csp?: string;
+    /**
+     * Whether to use a credentialless iframe (privacy-oriented isolation).
+     *
+     * @remarks
+     * Mirrors the `credentialless` boolean attribute where supported.
+     */
+    credentialless?: boolean;
+};
+/**
+ * Create an iframe 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 fallback text content for the iframe (rarely used, but valid).
+ * @param attrs - Optional attributes to apply.
+ * @returns The created `<iframe>` element.
+ *
+ * @example
+ * ```ts
+ * import { createIFrame } from "@lnpg/pkgn-sol/elements/media/iframe";
+ *
+ * document.body.appendChild(
+ *   createIFrame(undefined, {
+ *     title: "Embedded map",
+ *     src: "https://example.com/map",
+ *     loading: "lazy",
+ *     sandbox: "allow-scripts allow-same-origin"
+ *   })
+ * );
+ * ```
+ *
+ * @category DOM
+ */
+export declare function createIFrame(text?: string, attrs?: IFrameAttrs): ElementOf<typeof IFRAME_TAG>;
+/**
+ * Enhance iframe 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 enhanceIFrames(root?: ParentNode): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/elements/media/iframe/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAiB,KAAK,SAAS,EAAE,KAAK,WAAW,EAAkB,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,UAAU,EAAG,QAAiB,CAAC;AAE5C;;;;GAIG;AACH,eAAO,MAAM,eAAe,WAAW,CAAC;AAExC;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,CAAC;AAE7C;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAC5B,aAAa,GACb,4BAA4B,GAC5B,QAAQ,GACR,0BAA0B,GAC1B,aAAa,GACb,eAAe,GACf,iCAAiC,GACjC,YAAY,CAAC;AAEjB;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;AAEpD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG;IACpD;;OAEG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC;IAEtB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;;OAKG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC;IAExB;;OAEG;IACH,cAAc,CAAC,EAAE,oBAAoB,CAAC;IAEtC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAExB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAEzB;;OAEG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAE9B;;;;;OAKG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;;;OAKG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AA0EF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;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/img/index.d.ts

@@ -0,0 +1,83 @@
+/**
+ * pkgn-sol Design Foundation: Img element helpers.
+ *
+ * @remarks
+ * The img element (`<img>`) embeds an image into the document.
+ *
+ * Best-practice guidance:
+ * - The `alt` attribute must always be present.
+ * - Use `alt=""` for purely decorative images.
+ * - Provide meaningful alternative text for informative images.
+ * - Do not rely on images alone to convey critical information.
+ *
+ * This module enforces:
+ * - `alt` always exists (defaults to empty string if not provided)
+ * - If neither `src` nor `srcset` is provided, a safe fallback
+ *   `src="data:,"` is applied to avoid broken network requests
+ * - All global attributes are applied via pkgn-sol's hardened DOM helpers
+ *
+ * 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.
+ *
+ * @category Attributes
+ */
+export type StructuredAria = {
+    label?: string;
+    labelledby?: string;
+    hidden?: boolean;
+};
+/**
+ * The semantic tag name for images.
+ *
+ * @category Constants
+ */
+export declare const IMG_TAG: "img";
+/**
+ * A CSS selector targeting img elements.
+ *
+ * @category Constants
+ */
+export declare const IMG_SELECTOR = "img";
+/**
+ * Img-specific attributes.
+ *
+ * @remarks
+ * `alt` is mandatory per HTML specification.
+ *
+ * @category Attributes
+ */
+export type ImgAttrs = Omit<GlobalAttrs, 'aria'> & {
+    alt?: string;
+    src?: string;
+    srcset?: string;
+    sizes?: string;
+    width?: number;
+    height?: number;
+    loading?: 'lazy' | 'eager';
+    decoding?: 'sync' | 'async' | 'auto';
+    referrerPolicy?: string;
+    aria?: StructuredAria;
+};
+/**
+ * Create an img element with enforced accessibility safeguards.
+ *
+ * @category DOM
+ */
+export declare function createImg(attrs?: ImgAttrs): ElementOf<typeof IMG_TAG>;
+/**
+ * Enhance img elements within a given root.
+ *
+ * @remarks
+ * No runtime behaviour in v0.1.0.
+ *
+ * @category Enhancement
+ */
+export declare function enhanceImgs(root?: ParentNode): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/elements/media/img/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAqB,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEtF;;;;GAIG;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;;;;GAIG;AACH,eAAO,MAAM,OAAO,EAAG,KAAc,CAAC;AAEtC;;;;GAIG;AACH,eAAO,MAAM,YAAY,QAAQ,CAAC;AAElC;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG;IACjD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IACrC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB,CAAC;AAuDF;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC,OAAO,OAAO,CAAC,CAErE;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,IAAI,GAAE,UAAqB,GAAG,IAAI,CAE7D"}

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

@@ -0,0 +1,89 @@
+/**
+ * Media element factories.
+ *
+ * Provides framework-agnostic factory functions for embedded, graphical,
+ * and time-based media elements.
+ *
+ * These factories:
+ * - Create semantic HTML media elements using pkgn-sol's hardened DOM helpers.
+ * - Forward curated global attributes.
+ * - Enforce structured, typed attribute bags.
+ * - Apply sensible fallbacks where required by the HTML specification.
+ * - Prevent unsafe attribute injection.
+ *
+ * @module elements/media
+ * @since 0.1.0
+ */
+/**
+ * `<img>` element factory namespace.
+ *
+ * Embeds raster images into the document.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/img
+ */
+export * as img from './img';
+/**
+ * `<svg>` element factory namespace.
+ *
+ * Embeds scalable vector graphics content.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/svg
+ */
+export * as svg from './svg';
+/**
+ * `<math>` element factory namespace.
+ *
+ * Embeds MathML content for mathematical notation.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/math
+ */
+export * as math from './math';
+/**
+ * `<canvas>` element factory namespace.
+ *
+ * Provides a bitmap rendering surface for scripted drawing.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/canvas
+ */
+export * as canvas from './canvas';
+/**
+ * `<iframe>` element factory namespace.
+ *
+ * Embeds another HTML page within the current document.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/iframe
+ */
+export * as iframe from './iframe';
+/**
+ * `<embed>` element factory namespace.
+ *
+ * Embeds external content such as plugins or media resources.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/embed
+ */
+export * as embed from './embed';
+/**
+ * `<object>` element factory namespace.
+ *
+ * Embeds external resources such as images, PDFs, or interactive content.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/object
+ */
+export * as object from './object';
+/**
+ * `<video>` element factory namespace.
+ *
+ * Embeds time-based video media.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/video
+ */
+export * as video from './video';
+/**
+ * `<audio>` element factory namespace.
+ *
+ * Embeds time-based audio media.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/audio
+ */
+export * as audio from './audio';
+//# sourceMappingURL=index.d.ts.map