@vastare/fundatio 0.1.0

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

@@ -0,0 +1,130 @@
+/**
+ * Fundatio Design Foundation: Thead element helpers.
+ *
+ * @remarks
+ * The thead element (`<thead>`) represents the block of rows that form the
+ * column headers (and related header-area rows) for a table.
+ *
+ * Best-practice guidance:
+ * - Use `<thead>` to group header rows, typically using `<th>` cells for headers.
+ * - Keep the table structure logical: `<caption>` (optional), then `<colgroup>`
+ *   (optional), then `<thead>`, then `<tbody>`/`<tfoot>` as needed.
+ * - Avoid deprecated presentational attributes (e.g. `align`) 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 `<thead>` elements in vanilla JS/TS without templates
+ * - apply consistent global attributes safely
+ * - use a stable "enhancement" hook if Fundatio 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 Fundatio 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 thead elements.
+ *
+ * @category Constants
+ */
+export declare const THEAD_TAG: "thead";
+/**
+ * A CSS selector targeting thead elements.
+ *
+ * @category Constants
+ */
+export declare const THEAD_SELECTOR = "thead";
+/**
+ * Attribute bag for thead creation/enhancement.
+ *
+ * @remarks
+ * Thead elements accept standard HTML global attributes.
+ *
+ * Fundatio also supports a structured ARIA input for common ARIA fields, which is
+ * mapped into {@link GlobalAttrs.aria} without changing Fundatio'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 TheadAttrs = Omit<GlobalAttrs, 'aria'> & {
+    /**
+     * Structured ARIA fields mapped into `aria-*` attributes.
+     */
+    aria?: StructuredAria;
+};
+/**
+ * Create a thead element with global attributes.
+ *
+ * @remarks
+ * - `<thead>` is a structural table element. Fundatio does not accept a text argument
+ *   for this factory. Populate it with `<tr>` and header cells (`<th>`) as needed.
+ * - Global attributes are applied via Fundatio'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 `<thead>` element.
+ *
+ * @example
+ * Create and append a thead:
+ * ```ts
+ * import { createThead } from "@Vastare/Fundatio/elements/table/thead";
+ *
+ * const thead = createThead({ className: "table-head" });
+ * table.appendChild(thead);
+ * ```
+ *
+ * @category DOM
+ */
+export declare function createThead(attrs?: TheadAttrs): ElementOf<typeof THEAD_TAG>;
+/**
+ * Enhance thead elements within a given root.
+ *
+ * @remarks
+ * This is intentionally a no-op in `1.0.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 enhanceTheads(root?: ParentNode): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/elements/table/thead/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;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"}

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

@@ -0,0 +1,134 @@
+/**
+ * Fundatio Design Foundation: Tr element helpers.
+ *
+ * @remarks
+ * The tr element (`<tr>`) represents a row of cells within a table section.
+ * A row typically contains `<td>` and/or `<th>` elements.
+ *
+ * Best-practice guidance:
+ * - Use tables for data, not layout.
+ * - Group rows with `<thead>`, `<tbody>`, and `<tfoot>` for clearer structure.
+ * - Use `<th>` for header cells (and `scope`/`headers` where appropriate) for
+ *   accessible tables.
+ * - Avoid obsolete presentational attributes on table elements (e.g. `align`,
+ *   `bgcolor`, `valign`). Use CSS instead.
+ *
+ * This module provides small, framework-agnostic helpers so consumers can:
+ * - create `<tr>` elements in vanilla JS/TS without templates
+ * - apply consistent global attributes safely
+ * - use a stable "enhancement" hook if Fundatio ever needs runtime behavior
+ *
+ * This module has no side effects and does not mutate the DOM unless you call
+ * its functions.
+ *
+ * References:
+ * - MDN: `<tr>`: https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/tr
+ * - 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 Fundatio 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 rows.
+ *
+ * @category Constants
+ */
+export declare const TR_TAG: "tr";
+/**
+ * A CSS selector targeting tr elements.
+ *
+ * @category Constants
+ */
+export declare const TR_SELECTOR = "tr";
+/**
+ * Attribute bag for tr creation/enhancement.
+ *
+ * @remarks
+ * `<tr>` accepts standard HTML global attributes.
+ *
+ * Fundatio also supports a structured ARIA input for common ARIA fields, which is
+ * mapped into {@link GlobalAttrs.aria} without changing Fundatio's core DOM helpers.
+ *
+ * Note: legacy presentational attributes historically existed for table rows,
+ * but are obsolete. Consumers can still use {@link GlobalAttrs.attrs} as an
+ * escape hatch where necessary, subject to Fundatio's security rules in `dom.ts`
+ * (blocks inline event handlers and raw `style` attribute strings).
+ *
+ * @category Attributes
+ */
+export type TrAttrs = Omit<GlobalAttrs, 'aria'> & {
+    /**
+     * Structured ARIA fields mapped into `aria-*` attributes.
+     */
+    aria?: StructuredAria;
+};
+/**
+ * Create a tr element with optional text content and global attributes.
+ *
+ * @remarks
+ * - In real usage, `<tr>` should contain `<td>` and/or `<th>` cells (not text).
+ * - Optional text content is assigned via `textContent` (never `innerHTML`).
+ * - Global attributes are applied via Fundatio'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 row (generally discouraged).
+ * @param attrs - Optional attributes to apply.
+ * @returns The created `<tr>` element.
+ *
+ * @example
+ * ```ts
+ * import { createTr } from "@Vastare/Fundatio/elements/table/tr";
+ *
+ * const row = createTr(undefined, { className: "row" });
+ * ```
+ *
+ * @category DOM
+ */
+export declare function createTr(text?: string, attrs?: TrAttrs): ElementOf<typeof TR_TAG>;
+/**
+ * Enhance tr elements within a given root.
+ *
+ * @remarks
+ * This is intentionally a no-op in `1.0.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 enhanceTrs(root?: ParentNode): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/elements/table/tr/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;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG;IAChD;;OAEG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB,CAAC;AA6BF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC,OAAO,MAAM,CAAC,CAEjF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,UAAU,CAAC,IAAI,GAAE,UAAqB,GAAG,IAAI,CAG5D"}

package/dist/types/elements/text/address/index.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Fundatio Design Foundation: Address (`address`) element helpers.
+ *
+ * @remarks
+ * The address element (`<address>`) represents contact information for a person,
+ * people, or an organization.
+ *
+ * Best-practice guidance:
+ * - Use `<address>` for contact information associated with the nearest
+ *   `<article>` or `<body>` ancestor.
+ * - Do not use `<address>` for arbitrary postal addresses. It is about contact
+ *   information for the author/owner/organization associated with the content.
+ * - Avoid using `<address>` purely for styling (e.g. italics/indentation).
+ *   Presentation is the job of CSS.
+ *
+ * This module provides small, framework-agnostic helpers so consumers can:
+ * - create address blocks in vanilla JS/TS without templates
+ * - apply consistent global attributes safely
+ * - use a stable "enhancement" hook if Fundatio ever needs runtime behavior
+ *
+ * This module has no side effects and does not mutate the DOM unless you call
+ * its functions.
+ *
+ * References:
+ * - MDN: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/address
+ * - WHATWG: https://html.spec.whatwg.org/multipage/sections.html#the-address-element
+ *
+ * @module
+ * @category Elements
+ */
+import { type ElementOf, type GlobalAttrs } from '../../../ts/dom';
+/**
+ * Structured ARIA input supported by Fundatio 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`.
+     *
+     * @remarks
+     * Prefer `labelledby` when a visible labeling element exists.
+     */
+    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 address blocks.
+ *
+ * @category Constants
+ */
+export declare const ADDRESS_TAG: "address";
+/**
+ * A CSS selector targeting address elements.
+ *
+ * @category Constants
+ */
+export declare const ADDRESS_SELECTOR = "address";
+/**
+ * Attribute bag for address creation/enhancement.
+ *
+ * @remarks
+ * Address elements accept standard HTML global attributes.
+ *
+ * Fundatio also supports a structured ARIA input for common ARIA fields, which is
+ * mapped into {@link GlobalAttrs.aria} without changing Fundatio's core DOM helpers.
+ *
+ * @category Attributes
+ */
+export type AddressAttrs = Omit<GlobalAttrs, 'aria'> & {
+    /**
+     * Structured ARIA fields mapped into `aria-*` attributes.
+     */
+    aria?: StructuredAria;
+};
+/**
+ * Create an address element with optional text content and attributes.
+ *
+ * @remarks
+ * - Text content is assigned via `textContent` (never `innerHTML`).
+ * - Global attributes are applied via Fundatio'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 address.
+ * @param attrs - Optional attributes to apply.
+ * @returns The created `<address>` element.
+ *
+ * @example
+ * ```ts
+ * import { createAddress } from "@Vastare/Fundatio/elements/text/address";
+ *
+ * document.body.appendChild(
+ *   createAddress("Contact: hello@example.com", { className: "contact" })
+ * );
+ * ```
+ *
+ * @category DOM
+ */
+export declare function createAddress(text?: string, attrs?: AddressAttrs): ElementOf<typeof ADDRESS_TAG>;
+/**
+ * Enhance address elements within a given root.
+ *
+ * @remarks
+ * This is intentionally a no-op in `1.0.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 enhanceAddresses(root?: ParentNode): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/elements/text/address/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/elements/text/address/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;;;;;OAKG;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,WAAW,EAAG,SAAkB,CAAC;AAE9C;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,YAAY,CAAC;AAE1C;;;;;;;;;;GAUG;AACH,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG;IACrD;;OAEG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB,CAAC;AA6BF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC,OAAO,WAAW,CAAC,CAEhG;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,UAAqB,GAAG,IAAI,CAGlE"}

package/dist/types/elements/text/blockquote/index.d.ts

@@ -0,0 +1,153 @@
+/**
+ * Fundatio Design Foundation: Blockquote element helpers.
+ *
+ * @remarks
+ * The blockquote element (`<blockquote>`) represents a section that is quoted
+ * from another source.
+ *
+ * Best-practice guidance:
+ * - Use `<blockquote>` for longer, block-level quotations.
+ * - Use `<q>` for short, inline quotations.
+ * - If you provide a citation URL, set the `cite` attribute, but also consider
+ *   providing a visible citation in content (e.g. a link or a `<cite>` element),
+ *   since many user agents do not surface `cite` automatically.
+ * - Avoid presentational attributes. Use CSS for styling.
+ *
+ * Element-specific attributes:
+ * - `cite`: A URL for the source of the quotation (when available).
+ *
+ * This module provides small, framework-agnostic helpers so consumers can:
+ * - create block quotes in vanilla JS/TS without templates
+ * - apply consistent global attributes safely
+ * - use a stable "enhancement" hook if Fundatio ever needs runtime behavior
+ *
+ * This module has no side effects and does not mutate the DOM unless you call
+ * its functions.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/blockquote
+ *
+ * @module
+ * @category Elements
+ */
+import { type ElementOf, type GlobalAttrs } from '../../../ts/dom';
+/**
+ * Structured ARIA input supported by Fundatio 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 block quotes.
+ *
+ * @category Constants
+ */
+export declare const BLOCKQUOTE_TAG: "blockquote";
+/**
+ * A CSS selector targeting blockquote elements.
+ *
+ * @category Constants
+ */
+export declare const BLOCKQUOTE_SELECTOR = "blockquote";
+/**
+ * Attribute bag for blockquote creation/enhancement.
+ *
+ * @remarks
+ * Blockquote accepts standard HTML global attributes and one element-specific
+ * attribute:
+ * - `cite`: A URL pointing to the quoted source (when available).
+ *
+ * Fundatio also supports a structured ARIA input for common ARIA fields, which is
+ * mapped into {@link GlobalAttrs.aria}.
+ *
+ * Security note:
+ * - Inline event handler attributes (e.g. `onclick`) are blocked by `dom.ts`.
+ * - The raw `style` attribute is blocked; use {@link GlobalAttrs.style}.
+ *
+ * @category Attributes
+ */
+export type BlockquoteAttrs = Omit<GlobalAttrs, 'aria'> & {
+    /**
+     * Citation URL for the source of the quote.
+     *
+     * @remarks
+     * This maps to the `cite` attribute. When present, it should be a valid URL.
+     * Consider also including a visible citation in the document content.
+     */
+    cite?: string;
+    /**
+     * Structured ARIA fields mapped into `aria-*` attributes.
+     */
+    aria?: StructuredAria;
+};
+/**
+ * Create a blockquote element with optional text content and attributes.
+ *
+ * @remarks
+ * - Text content is assigned via `textContent` (never `innerHTML`).
+ * - Global attributes are applied via Fundatio's shared DOM helper,
+ *   including security guards that block inline event handler attributes
+ *   (e.g. `onclick`) and raw `style` attribute strings.
+ *
+ * Note: `<blockquote>` typically contains flow content (e.g. paragraphs). This
+ * helper supports a simple `text` convenience for cases where plain text is
+ * sufficient; consumers can still append richer child nodes afterwards.
+ *
+ * @param text - Optional text content for the blockquote.
+ * @param attrs - Optional attributes to apply.
+ * @returns The created `<blockquote>` element.
+ *
+ * @example
+ * ```ts
+ * import { createBlockquote } from "@Vastare/Fundatio/elements/text/blockquote";
+ *
+ * const q = createBlockquote("To be, or not to be...", {
+ *   cite: "https://example.com/source",
+ *   className: "quote",
+ *   aria: { label: "Quotation" }
+ * });
+ *
+ * document.body.appendChild(q);
+ * ```
+ *
+ * @category DOM
+ */
+export declare function createBlockquote(text?: string, attrs?: BlockquoteAttrs): ElementOf<typeof BLOCKQUOTE_TAG>;
+/**
+ * Enhance blockquote elements within a given root.
+ *
+ * @remarks
+ * This is intentionally a no-op in `1.0.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 enhanceBlockquotes(root?: ParentNode): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/elements/text/blockquote/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/elements/text/blockquote/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;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,cAAc,EAAG,YAAqB,CAAC;AAEpD;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,eAAe,CAAC;AAEhD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG;IACxD;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB,CAAC;AAmCF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,CAAC,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,eAAe,GACtB,SAAS,CAAC,OAAO,cAAc,CAAC,CAElC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,GAAE,UAAqB,GAAG,IAAI,CAGpE"}

package/dist/types/elements/text/hr/index.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Fundatio Design Foundation: Hr element helpers.
+ *
+ * @remarks
+ * The hr element (`<hr>`) represents a thematic break between paragraph-level
+ * elements (e.g. a shift of topic or scene).
+ *
+ * Best-practice guidance:
+ * - Use `<hr>` for semantic separation of content, not for visual decoration.
+ * - Avoid obsolete presentational attributes (e.g. `align`, `size`, `width`, `noshade`);
+ *   use CSS instead.
+ * - Prefer native semantics. Only set `role` when you have a specific, justified reason.
+ *
+ * This module provides small, framework-agnostic helpers so consumers can:
+ * - create thematic breaks in vanilla JS/TS without templates
+ * - apply consistent global attributes safely
+ * - use a stable "enhancement" hook if Fundatio ever needs runtime behavior
+ *
+ * MDN: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/hr
+ *
+ * @module
+ * @category Elements
+ */
+import { type ElementOf, type GlobalAttrs } from '../../../ts/dom';
+/**
+ * Structured ARIA input supported by Fundatio 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 thematic breaks.
+ *
+ * @category Constants
+ */
+export declare const HR_TAG: "hr";
+/**
+ * A CSS selector targeting hr elements.
+ *
+ * @category Constants
+ */
+export declare const HR_SELECTOR = "hr";
+/**
+ * Attribute bag for hr creation/enhancement.
+ *
+ * @remarks
+ * Hr elements accept standard HTML global attributes.
+ *
+ * Fundatio also supports a structured ARIA input for common ARIA fields, which is
+ * mapped into {@link GlobalAttrs.aria} without changing Fundatio's core DOM helpers.
+ *
+ * @category Attributes
+ */
+export type HrAttrs = Omit<GlobalAttrs, 'aria'> & {
+    /**
+     * Structured ARIA fields mapped into `aria-*` attributes.
+     */
+    aria?: StructuredAria;
+};
+/**
+ * Create an hr element with optional global attributes.
+ *
+ * @remarks
+ * - `<hr>` is a void element and must not carry text content.
+ * - Global attributes are applied via Fundatio'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 `<hr>` element.
+ *
+ * @example
+ * Create and append a thematic break:
+ * ```ts
+ * import { createHr } from "@Vastare/Fundatio/elements/text/hr";
+ *
+ * document.body.appendChild(createHr({ className: "divider" }));
+ * ```
+ *
+ * @category DOM
+ */
+export declare function createHr(attrs?: HrAttrs): ElementOf<typeof HR_TAG>;
+/**
+ * Enhance hr elements within a given root.
+ *
+ * @remarks
+ * This is intentionally a no-op in `1.0.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 enhanceHrs(root?: ParentNode): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/elements/text/hr/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/elements/text/hr/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAqB,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEtF;;;;;;;;;;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;;;;;;;;;;GAUG;AACH,MAAM,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG;IAChD;;OAEG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB,CAAC;AA6BF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC,OAAO,MAAM,CAAC,CAElE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,UAAU,CAAC,IAAI,GAAE,UAAqB,GAAG,IAAI,CAG5D"}