@lnpg/pkgn-sol 1.0.0-beta.0

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

@@ -0,0 +1,102 @@
+/**
+ * Table element factories.
+ *
+ * Provides framework-agnostic factory functions for semantic HTML table
+ * structures and related elements.
+ *
+ * These factories:
+ * - Create semantic table elements using pkgn-sol's hardened DOM helpers.
+ * - Forward curated global attributes.
+ * - Enforce structured, typed attribute bags.
+ * - Preserve native table semantics and accessibility.
+ * - Prevent unsafe attribute injection.
+ *
+ * Tables in pkgn-sol are intentionally low-level primitives. They do not attempt
+ * to manage layout, styling, or data structures. Consumers remain responsible
+ * for building meaningful table structures.
+ *
+ * @module elements/table
+ * @since 0.1.0
+ */
+/**
+ * `<table>` element factory namespace.
+ *
+ * Represents tabular data arranged in rows and columns.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/table
+ */
+export * as table from './table';
+/**
+ * `<colgroup>` element factory namespace.
+ *
+ * Groups one or more `<col>` elements for shared column styling and
+ * structural definition.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/colgroup
+ */
+export * as colgroup from './colgroup';
+/**
+ * `<col>` element factory namespace.
+ *
+ * Defines column-level properties within a table.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/col
+ */
+export * as col from './col';
+/**
+ * `<thead>` element factory namespace.
+ *
+ * Groups header rows that label table columns.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/thead
+ */
+export * as thead from './thead';
+/**
+ * `<tbody>` element factory namespace.
+ *
+ * Groups the primary body rows of a table.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/tbody
+ */
+export * as tbody from './tbody';
+/**
+ * `<tfoot>` element factory namespace.
+ *
+ * Groups footer rows containing summaries or totals.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/tfoot
+ */
+export * as tfoot from './tfoot';
+/**
+ * `<tr>` element factory namespace.
+ *
+ * Represents a table row.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/tr
+ */
+export * as tr from './tr';
+/**
+ * `<th>` element factory namespace.
+ *
+ * Represents a header cell that labels a row or column.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/th
+ */
+export * as th from './th';
+/**
+ * `<td>` element factory namespace.
+ *
+ * Represents a standard table data cell.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/td
+ */
+export * as td from './td';
+/**
+ * `<caption>` element factory namespace.
+ *
+ * Provides a title or description for a table.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/caption
+ */
+export * as caption from './caption';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/elements/table/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;;;;;GAMG;AACH,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AAEjC;;;;;;;GAOG;AACH,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC;AAEvC;;;;;;GAMG;AACH,OAAO,KAAK,GAAG,MAAM,OAAO,CAAC;AAE7B;;;;;;GAMG;AACH,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AAEjC;;;;;;GAMG;AACH,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AAEjC;;;;;;GAMG;AACH,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AAEjC;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,MAAM,MAAM,CAAC;AAE3B;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,MAAM,MAAM,CAAC;AAE3B;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,MAAM,MAAM,CAAC;AAE3B;;;;;;GAMG;AACH,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC"}

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

@@ -0,0 +1,143 @@
+/**
+ * pkgn-sol Design Foundation: Table element helpers.
+ *
+ * @remarks
+ * The table element (`<table>`) represents tabular data with more than one
+ * dimension (rows and columns).
+ *
+ * Best-practice guidance:
+ * - Use tables for data, not for layout.
+ * - Provide a clear `<caption>` describing the table's purpose.
+ * - Use `<thead>`, `<tbody>`, and `<tfoot>` to group table content meaningfully.
+ * - Mark header cells with `<th>` (not `<td>`), and use `scope`/`headers` where
+ *   appropriate for accessibility, especially in more complex tables.
+ * - Avoid obsolete presentational attributes (e.g. `border`, `cellpadding`,
+ *   `cellspacing`, `align`, `bgcolor`). Use CSS instead.
+ * - If additional long-form description is needed, consider `aria-describedby`
+ *   pointing to explanatory text outside the table.
+ *
+ * This module provides small, framework-agnostic helpers so consumers can:
+ * - create table 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.
+ *
+ * References:
+ * - MDN: `<table>`: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/table
+ * - WHATWG: Table model: https://html.spec.whatwg.org/multipage/tables.html
+ *
+ * @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 HTML tables.
+ *
+ * @category Constants
+ */
+export declare const TABLE_TAG: "table";
+/**
+ * A CSS selector targeting table elements.
+ *
+ * @category Constants
+ */
+export declare const TABLE_SELECTOR = "table";
+/**
+ * Attribute bag for table creation/enhancement.
+ *
+ * @remarks
+ * Table 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.
+ *
+ * Note: table-specific presentational attributes historically existed but are
+ * obsolete in modern HTML. Consumers can still use {@link GlobalAttrs.attrs}
+ * as an escape hatch where necessary, subject to pkgn-sol's security rules in
+ * `dom.ts` (blocks inline event handlers and raw `style` attribute strings).
+ *
+ * @category Attributes
+ */
+export type TableAttrs = Omit<GlobalAttrs, 'aria'> & {
+    /**
+     * Structured ARIA fields mapped into `aria-*` attributes.
+     */
+    aria?: StructuredAria;
+};
+/**
+ * Create a table element with optional text content and global attributes.
+ *
+ * @remarks
+ * - Table content is typically structured with child elements (`<caption>`,
+ *   `<thead>`, `<tbody>`, `<tr>`, `<th>`, `<td>`). This helper does not build
+ *   table structure, it only creates the `<table>` element.
+ * - Optional text content is assigned via `textContent` (never `innerHTML`).
+ *   In real usage, prefer building actual table child elements rather than
+ *   relying on text content.
+ * - 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 table (generally discouraged).
+ * @param attrs - Optional attributes to apply.
+ * @returns The created `<table>` element.
+ *
+ * @example
+ * Create a table and append it:
+ * ```ts
+ * import { createTable } from "@lnpg/pkgn-sol/elements/table/table";
+ *
+ * const table = createTable(undefined, { className: "data-table" });
+ * document.body.appendChild(table);
+ * ```
+ *
+ * @category DOM
+ */
+export declare function createTable(text?: string, attrs?: TableAttrs): ElementOf<typeof TABLE_TAG>;
+/**
+ * Enhance table 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 enhanceTables(root?: ParentNode): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/elements/table/table/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;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,SAAS,EAAG,OAAgB,CAAC;AAE1C;;;;GAIG;AACH,eAAO,MAAM,cAAc,UAAU,CAAC;AAEtC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG;IACnD;;OAEG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB,CAAC;AA6BF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC,OAAO,SAAS,CAAC,CAE1F;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAAC,IAAI,GAAE,UAAqB,GAAG,IAAI,CAG/D"}

package/dist/types/elements/table/tbody/index.d.ts

@@ -0,0 +1,134 @@
+/**
+ * pkgn-sol Design Foundation: Tbody element helpers.
+ *
+ * @remarks
+ * The tbody element (`<tbody>`) represents a block of rows that make up the main
+ * body of a table's data.
+ *
+ * Best-practice guidance:
+ * - Use tables for data, not layout.
+ * - Group rows meaningfully with `<thead>`, `<tbody>`, and `<tfoot>`.
+ * - Prefer semantic headers via `<th>` (with appropriate `scope`/`headers`)
+ *   and provide a `<caption>` for accessible tables.
+ * - Avoid obsolete presentational attributes (e.g. `align`, `valign`, `char`,
+ *   `charoff`). Use CSS instead.
+ *
+ * This module provides small, framework-agnostic helpers so consumers can:
+ * - create `<tbody>` 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.
+ *
+ * References:
+ * - MDN: `<tbody>`: https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/tbody
+ * - WHATWG HTML: Tables: https://html.spec.whatwg.org/multipage/tables.html
+ *
+ * @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 table body sections.
+ *
+ * @category Constants
+ */
+export declare const TBODY_TAG: "tbody";
+/**
+ * A CSS selector targeting tbody elements.
+ *
+ * @category Constants
+ */
+export declare const TBODY_SELECTOR = "tbody";
+/**
+ * Attribute bag for tbody creation/enhancement.
+ *
+ * @remarks
+ * `<tbody>` accepts 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.
+ *
+ * Note: some legacy presentational attributes existed historically for table
+ * sections, but are obsolete. Consumers can still use {@link GlobalAttrs.attrs}
+ * as an escape hatch where necessary, subject to pkgn-sol's security rules in
+ * `dom.ts` (blocks inline event handlers and raw `style` attribute strings).
+ *
+ * @category Attributes
+ */
+export type TbodyAttrs = Omit<GlobalAttrs, 'aria'> & {
+    /**
+     * Structured ARIA fields mapped into `aria-*` attributes.
+     */
+    aria?: StructuredAria;
+};
+/**
+ * Create a tbody element with optional text content and global attributes.
+ *
+ * @remarks
+ * - In real usage, `<tbody>` should contain `<tr>` rows (not text).
+ * - Optional 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 tbody (generally discouraged).
+ * @param attrs - Optional attributes to apply.
+ * @returns The created `<tbody>` element.
+ *
+ * @example
+ * ```ts
+ * import { createTbody } from "@lnpg/pkgn-sol/elements/table/tbody";
+ *
+ * const tbody = createTbody(undefined, { className: "data-body" });
+ * ```
+ *
+ * @category DOM
+ */
+export declare function createTbody(text?: string, attrs?: TbodyAttrs): ElementOf<typeof TBODY_TAG>;
+/**
+ * Enhance tbody 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 enhanceTbodies(root?: ParentNode): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/elements/table/tbody/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/elements/table/tbody/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;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,SAAS,EAAG,OAAgB,CAAC;AAE1C;;;;GAIG;AACH,eAAO,MAAM,cAAc,UAAU,CAAC;AAEtC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG;IACnD;;OAEG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB,CAAC;AA6BF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC,OAAO,SAAS,CAAC,CAE1F;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAAC,IAAI,GAAE,UAAqB,GAAG,IAAI,CAGhE"}

package/dist/types/elements/table/td/index.d.ts

@@ -0,0 +1,146 @@
+/**
+ * pkgn-sol Design Foundation: Td element helpers.
+ *
+ * @remarks
+ * The td element (`<td>`) represents a data cell in a table row (`<tr>`).
+ *
+ * Best-practice guidance:
+ * - Use `<td>` for data cells and `<th>` for header cells.
+ * - Provide a `<caption>` and properly marked header cells for accessible tables.
+ * - Prefer simple tables. For complex tables with multi-level headers, use
+ *   the `headers` attribute to associate a `<td>` with one or more `<th>` IDs.
+ * - Avoid obsolete presentational attributes (e.g. `align`, `bgcolor`, `valign`).
+ *   Use CSS instead.
+ *
+ * This module provides small, framework-agnostic helpers so consumers can:
+ * - create `<td>` 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.
+ *
+ * References:
+ * - MDN: `<td>`: https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/td
+ * - WHATWG HTML: Tables: https://html.spec.whatwg.org/multipage/tables.html
+ * - W3C WAI: Tables (headers/id technique): https://www.w3.org/WAI/tutorials/tables/multi-level/
+ *
+ * @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 table data cells.
+ *
+ * @category Constants
+ */
+export declare const TD_TAG: "td";
+/**
+ * A CSS selector targeting td elements.
+ *
+ * @category Constants
+ */
+export declare const TD_SELECTOR = "td";
+/**
+ * Attribute bag for td creation/enhancement.
+ *
+ * @remarks
+ * In addition to global attributes, `<td>` participates in the table model via:
+ * - `colspan`: number of columns spanned (positive integer)
+ * - `rowspan`: number of rows spanned (positive integer)
+ * - `headers`: space-separated list of `<th id="...">` references for complex tables
+ *
+ * pkgn-sol supports a structured ARIA input for common ARIA fields, mapped into
+ * {@link GlobalAttrs.aria}.
+ *
+ * @category Attributes
+ */
+export type TdAttrs = Omit<GlobalAttrs, 'aria'> & {
+    /**
+     * Structured ARIA fields mapped into `aria-*` attributes.
+     */
+    aria?: StructuredAria;
+    /**
+     * Number of columns this cell spans.
+     *
+     * @remarks
+     * Must be a positive integer greater than zero.
+     */
+    colspan?: number;
+    /**
+     * Number of rows this cell spans.
+     *
+     * @remarks
+     * Must be a positive integer greater than zero.
+     */
+    rowspan?: number;
+    /**
+     * Space-separated list of header cell IDs (`<th id="...">`) that apply to this cell.
+     *
+     * @remarks
+     * This is typically only necessary for complex tables.
+     */
+    headers?: string;
+};
+/**
+ * Create a td element with optional text content and global attributes.
+ *
+ * @remarks
+ * - In real usage, `<td>` contains text and/or phrasing content, but should never
+ *   be built via `innerHTML` from untrusted data.
+ * - 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 td.
+ * @param attrs - Optional attributes to apply.
+ * @returns The created `<td>` element.
+ *
+ * @example
+ * ```ts
+ * import { createTd } from "@lnpg/pkgn-sol/elements/table/td";
+ *
+ * const cell = createTd("42", { colspan: 2 });
+ * ```
+ *
+ * @category DOM
+ */
+export declare function createTd(text?: string, attrs?: TdAttrs): ElementOf<typeof TD_TAG>;
+/**
+ * Enhance td 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 enhanceTds(root?: ParentNode): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/elements/table/td/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/elements/table/td/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;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,MAAM,EAAG,IAAa,CAAC;AAEpC;;;;GAIG;AACH,eAAO,MAAM,WAAW,OAAO,CAAC;AAEhC;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG;IAChD;;OAEG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC;IAEtB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AA4DF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC,OAAO,MAAM,CAAC,CAEjF;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,IAAI,GAAE,UAAqB,GAAG,IAAI,CAG5D"}

package/dist/types/elements/table/tfoot/index.d.ts

@@ -0,0 +1,131 @@
+/**
+ * pkgn-sol Design Foundation: Tfoot element helpers.
+ *
+ * @remarks
+ * The tfoot element (`<tfoot>`) encapsulates a set of table rows (`<tr>`) that
+ * comprise the footer of a table, typically containing column summaries such as
+ * totals or other aggregate values. :contentReference[oaicite:1]{index=1}
+ *
+ * Best-practice guidance:
+ * - Use `<tfoot>` for footer rows (summaries/totals), and keep the table's
+ *   structure logical with `<thead>` for headers and `<tbody>` for body rows.
+ * - Many guides recommend placing `<tfoot>` after `<tbody>` for readability. :contentReference[oaicite:2]{index=2}
+ * - Avoid deprecated presentational attributes and use CSS instead.
+ * - Prefer native table semantics; only use ARIA when you cannot express the
+ *   intended structure using proper table markup.
+ *
+ * This module provides small, framework-agnostic helpers so consumers can:
+ * - create `<tfoot>` 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 tfoot elements.
+ *
+ * @category Constants
+ */
+export declare const TFOOT_TAG: "tfoot";
+/**
+ * A CSS selector targeting tfoot elements.
+ *
+ * @category Constants
+ */
+export declare const TFOOT_SELECTOR = "tfoot";
+/**
+ * Attribute bag for tfoot creation/enhancement.
+ *
+ * @remarks
+ * Tfoot 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.
+ *
+ * Security notes:
+ * - Inline event handler attributes (e.g. `onclick`) are blocked by `dom.ts`.
+ * - The raw `style` attribute is blocked; use {@link GlobalAttrs.style} instead.
+ *
+ * @category Attributes
+ */
+export type TfootAttrs = Omit<GlobalAttrs, 'aria'> & {
+    /**
+     * Structured ARIA fields mapped into `aria-*` attributes.
+     */
+    aria?: StructuredAria;
+};
+/**
+ * Create a tfoot element with global attributes.
+ *
+ * @remarks
+ * - `<tfoot>` is a structural table element. pkgn-sol does not accept a text argument
+ *   for this factory. Populate it with `<tr>` (and cells) as needed.
+ * - 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 `<tfoot>` element.
+ *
+ * @example
+ * Create and append a tfoot:
+ * ```ts
+ * import { createTfoot } from "@lnpg/pkgn-sol/elements/table/tfoot";
+ *
+ * const tfoot = createTfoot({ className: "table-foot" });
+ * table.appendChild(tfoot);
+ * ```
+ *
+ * @category DOM
+ */
+export declare function createTfoot(attrs?: TfootAttrs): ElementOf<typeof TFOOT_TAG>;
+/**
+ * Enhance tfoot 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 enhanceTfoots(root?: ParentNode): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/elements/table/tfoot/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/elements/table/tfoot/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,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;CACvB,CAAC;AA6BF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,WAAW,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC,OAAO,SAAS,CAAC,CAE3E;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAAC,IAAI,GAAE,UAAqB,GAAG,IAAI,CAG/D"}