@vastare/fundatio 0.1.0

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

@@ -0,0 +1,68 @@
+/**
+ * Heading element factories.
+ *
+ * Provides framework-agnostic factory functions for semantic HTML heading
+ * elements (`<h1>` through `<h6>`).
+ *
+ * These factories:
+ * - Create semantic heading elements using Fundatio's hardened DOM helpers.
+ * - Forward curated global attributes.
+ * - Enforce structured, typed attribute bags.
+ * - Preserve correct document outline semantics.
+ * - Prevent unsafe attribute injection.
+ *
+ * Headings define the hierarchical structure of a document and should be used
+ * in order where possible to maintain accessibility and navigability.
+ *
+ * @module elements/heading
+ * @since 1.0.0
+ */
+/**
+ * `<h1>` element factory namespace.
+ *
+ * Represents the top-level heading of a page or section.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/Heading_Elements
+ */
+export * as h1 from './h1';
+/**
+ * `<h2>` element factory namespace.
+ *
+ * Represents a second-level section heading.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/Heading_Elements
+ */
+export * as h2 from './h2';
+/**
+ * `<h3>` element factory namespace.
+ *
+ * Represents a third-level section heading.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/Heading_Elements
+ */
+export * as h3 from './h3';
+/**
+ * `<h4>` element factory namespace.
+ *
+ * Represents a fourth-level section heading.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/Heading_Elements
+ */
+export * as h4 from './h4';
+/**
+ * `<h5>` element factory namespace.
+ *
+ * Represents a fifth-level section heading.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/Heading_Elements
+ */
+export * as h5 from './h5';
+/**
+ * `<h6>` element factory namespace.
+ *
+ * Represents a sixth-level section heading.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/Heading_Elements
+ */
+export * as h6 from './h6';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/elements/heading/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;;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,EAAE,MAAM,MAAM,CAAC;AAE3B;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,MAAM,MAAM,CAAC;AAE3B;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,MAAM,MAAM,CAAC"}

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

@@ -0,0 +1,106 @@
+/**
+ * Fundatio element factory namespaces.
+ *
+ * Provides grouped access to all HTML element factory modules included in Fundatio.
+ *
+ * These namespaces:
+ * - Expose framework-agnostic DOM factory helpers.
+ * - Maintain strong TypeScript typing for attributes.
+ * - Forward Fundatio's curated global attributes safely.
+ * - Prevent unsafe attribute injection.
+ * - Keep the public API stable and predictable.
+ *
+ * Each namespace corresponds to a semantic category of HTML elements,
+ * allowing consumers to import only what they need while preserving
+ * a logical structure across the library.
+ *
+ * @module elements
+ * @since 1.0.0
+ */
+/**
+ * Container element factories.
+ *
+ * Generic structural elements such as `<div>` and `<span>` used for grouping
+ * and layout where no stronger semantic element is appropriate.
+ */
+export * as container from './container';
+/**
+ * Break element factories.
+ *
+ * Line and word break elements that influence text flow.
+ */
+export * as break from './break';
+/**
+ * Media element factories.
+ *
+ * Elements for embedding media such as images, video, audio, and embedded
+ * external resources.
+ */
+export * as media from './media';
+/**
+ * Table element factories.
+ *
+ * Elements used to construct semantic tabular data structures.
+ */
+export * as table from './table';
+/**
+ * Heading element factories.
+ *
+ * Document heading elements (`h1`-`h6`) used to create the page outline
+ * and hierarchical structure.
+ */
+export * as heading from './heading';
+/**
+ * Text content element factories.
+ *
+ * Elements used for paragraphs, quotations, horizontal rules, and other
+ * primary textual structures.
+ */
+export * as text from './text';
+/**
+ * Inline text element factories.
+ *
+ * Elements that apply semantic meaning, emphasis, or annotations within
+ * flowing text.
+ */
+export * as inline from './inline';
+/**
+ * List element factories.
+ *
+ * Elements for ordered, unordered, and description lists.
+ */
+export * as list from './list';
+/**
+ * Figure element factories.
+ *
+ * Elements for self-contained media, illustrations, diagrams, or code
+ * samples with optional captions.
+ */
+export * as figure from './figure';
+/**
+ * Form element factories.
+ *
+ * Elements used to collect, validate, and submit user input.
+ */
+export * as form from './form';
+/**
+ * Interactive element factories.
+ *
+ * Elements that provide native interactive behaviors such as dialogs
+ * and disclosure widgets.
+ */
+export * as interactive from './interactive';
+/**
+ * Responsive media element factories.
+ *
+ * Elements supporting responsive images, media sources, and timed text
+ * tracks.
+ */
+export * as responsive from './responsive';
+/**
+ * Layout element factories.
+ *
+ * High-level structural elements that define the major sections of a page.
+ */
+export * as layout from './layout';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/elements/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;GAKG;AACH,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AAEzC;;;;GAIG;AACH,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AAEjC;;;;;GAKG;AACH,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AAEjC;;;;GAIG;AACH,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AAEjC;;;;;GAKG;AACH,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AAErC;;;;;GAKG;AACH,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAE/B;;;;;GAKG;AACH,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AAEnC;;;;GAIG;AACH,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAE/B;;;;;GAKG;AACH,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AAEnC;;;;GAIG;AACH,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAE/B;;;;;GAKG;AACH,OAAO,KAAK,WAAW,MAAM,eAAe,CAAC;AAE7C;;;;;GAKG;AACH,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAE3C;;;;GAIG;AACH,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC"}

package/dist/types/elements/inline/a/index.d.ts

@@ -0,0 +1,203 @@
+/**
+ * Fundatio Design Foundation: Anchor (`a`) element helpers.
+ *
+ * @remarks
+ * The anchor element (`<a>`) creates a hyperlink when the `href` attribute is
+ * present. It can link to web pages, files, email addresses, locations within
+ * the same page, or any URL-addressable resource.
+ *
+ * Best-practice guidance:
+ * - Prefer clear, descriptive link text. Avoid "click here".
+ * - If using `target="_blank"`, strongly consider `rel="noopener noreferrer"`
+ *   to prevent opener-based attacks (reverse tabnabbing).
+ * - Do not use `<a>` as a button. Use `<button>` for actions and controls.
+ * - Validate/sanitize untrusted URLs before assigning them to `href`.
+ *
+ * This module provides small, framework-agnostic helpers so consumers can:
+ * - create anchors 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/a
+ * - WHATWG: https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-a-element
+ * - MDN rel=noopener: https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/rel/noopener
+ * - MDN rel=noreferrer: https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/rel/noreferrer
+ *
+ * @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;
+};
+/**
+ * Common targets for anchor navigation.
+ *
+ * @remarks
+ * Browsers also accept custom named targets (e.g. `myWindow`).
+ *
+ * @category Attributes
+ */
+export type AnchorTarget = '_self' | '_blank' | '_parent' | '_top' | (string & {});
+/**
+ * Allowed values for the `referrerpolicy` attribute.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/referrerpolicy
+ *
+ * @category Attributes
+ */
+export type ReferrerPolicy = 'no-referrer' | 'no-referrer-when-downgrade' | 'origin' | 'origin-when-cross-origin' | 'same-origin' | 'strict-origin' | 'strict-origin-when-cross-origin' | 'unsafe-url';
+/**
+ * The semantic tag name for anchors.
+ *
+ * @category Constants
+ */
+export declare const A_TAG: "a";
+/**
+ * A CSS selector targeting anchor elements.
+ *
+ * @category Constants
+ */
+export declare const A_SELECTOR = "a";
+/**
+ * Attribute bag for anchor creation/enhancement.
+ *
+ * @remarks
+ * Anchor elements accept standard HTML global attributes, plus link-related
+ * attributes such as `href`, `target`, and `rel`.
+ *
+ * Security notes:
+ * - Fundatio blocks unsafe attribute *names* (e.g. `onclick`, raw `style`).
+ * - Fundatio does not sanitize attribute *values*. Callers must validate untrusted
+ *   URLs before passing them as `href`.
+ * - When `target="_blank"` is used and `rel` is not provided, Fundatio applies a
+ *   conservative default: `rel="noopener noreferrer"`.
+ *
+ * @category Attributes
+ */
+export type AnchorAttrs = Omit<GlobalAttrs, 'aria'> & {
+    /**
+     * Destination URL for the hyperlink.
+     *
+     * @remarks
+     * If omitted, the anchor is not a hyperlink.
+     */
+    href?: string;
+    /**
+     * Where to display the linked URL.
+     */
+    target?: AnchorTarget;
+    /**
+     * Relationship between the current document and the linked resource.
+     *
+     * @remarks
+     * If `target="_blank"` is used and `rel` is not provided, Fundatio applies
+     * `noopener noreferrer` by default.
+     */
+    rel?: string;
+    /**
+     * Indicates the linked resource should be downloaded.
+     *
+     * @remarks
+     * - `true` sets a bare `download` attribute.
+     * - A string sets the suggested filename.
+     */
+    download?: boolean | string;
+    /**
+     * Language of the linked resource.
+     */
+    hreflang?: string;
+    /**
+     * Space-separated list of URLs to notify (POST "ping") when the link is followed.
+     *
+     * @remarks
+     * Limited browser support; use with care.
+     */
+    ping?: string | string[];
+    /**
+     * Referrer policy for the request initiated by following the hyperlink.
+     */
+    referrerPolicy?: ReferrerPolicy;
+    /**
+     * MIME type hint for the linked resource.
+     */
+    type?: string;
+    /**
+     * Structured ARIA fields mapped into `aria-*` attributes.
+     */
+    aria?: StructuredAria;
+};
+/**
+ * Create an anchor 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 anchor.
+ * @param attrs - Optional attributes to apply.
+ * @returns The created `<a>` element.
+ *
+ * @example
+ * ```ts
+ * import { createA } from "@Vastare/Fundatio/elements/inline/a";
+ *
+ * document.body.appendChild(
+ *   createA("Read more", { href: "/docs", className: "link" })
+ * );
+ * ```
+ *
+ * @category DOM
+ */
+export declare function createA(text?: string, attrs?: AnchorAttrs): ElementOf<typeof A_TAG>;
+/**
+ * Enhance anchor 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 enhanceAs(root?: ParentNode): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/elements/inline/a/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/elements/inline/a/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;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;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAEnF;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GACtB,aAAa,GACb,4BAA4B,GAC5B,QAAQ,GACR,0BAA0B,GAC1B,aAAa,GACb,eAAe,GACf,iCAAiC,GACjC,YAAY,CAAC;AAEjB;;;;GAIG;AACH,eAAO,MAAM,KAAK,EAAG,GAAY,CAAC;AAElC;;;;GAIG;AACH,eAAO,MAAM,UAAU,MAAM,CAAC;AAE9B;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG;IACpD;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;IAEtB;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAEzB;;OAEG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB,CAAC;AA2DF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC,OAAO,KAAK,CAAC,CAEnF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CAAC,IAAI,GAAE,UAAqB,GAAG,IAAI,CAG3D"}

package/dist/types/elements/inline/abbr/index.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Fundatio Design Foundation: Abbreviation (`abbr`) element helpers.
+ *
+ * @remarks
+ * The abbreviation element (`<abbr>`) represents an abbreviation or acronym.
+ *
+ * Best-practice guidance:
+ * - Provide the expanded form in plain text on first use where possible.
+ * - Optionally provide an expansion via the `title` attribute.
+ *   Spec guidance: if `title` is used on `<abbr>`, it should contain the expansion
+ *   of the abbreviation and nothing else.
+ * - Do not rely solely on `title` tooltips for accessibility; tooltip exposure
+ *   varies across browsers and assistive technologies.
+ *
+ * This module provides small, framework-agnostic helpers so consumers can:
+ * - create abbr 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: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/abbr
+ * - WHATWG: https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-abbr-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`.
+     */
+    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 abbreviations.
+ *
+ * @category Constants
+ */
+export declare const ABBR_TAG: "abbr";
+/**
+ * A CSS selector targeting abbr elements.
+ *
+ * @category Constants
+ */
+export declare const ABBR_SELECTOR = "abbr";
+/**
+ * Attribute bag for abbr creation/enhancement.
+ *
+ * @remarks
+ * Abbr elements accept standard HTML global attributes.
+ *
+ * For expansions, prefer:
+ * - expanding the term in plain text on first use, and/or
+ * - using {@link GlobalAttrs.title} to provide an expansion (advisory text).
+ *
+ * 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 AbbrAttrs = Omit<GlobalAttrs, 'aria'> & {
+    /**
+     * Structured ARIA fields mapped into `aria-*` attributes.
+     */
+    aria?: StructuredAria;
+};
+/**
+ * Create an abbr 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 abbreviation (e.g. "NASA").
+ * @param attrs - Optional attributes to apply (e.g. `title` for expansion).
+ * @returns The created `<abbr>` element.
+ *
+ * @example
+ * ```ts
+ * import { createAbbr } from "@Vastare/Fundatio/elements/inline/abbr";
+ *
+ * const el = createAbbr("NASA", { title: "National Aeronautics and Space Administration" });
+ * document.body.appendChild(el);
+ * ```
+ *
+ * @category DOM
+ */
+export declare function createAbbr(text?: string, attrs?: AbbrAttrs): ElementOf<typeof ABBR_TAG>;
+/**
+ * Enhance abbr 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 enhanceAbbrs(root?: ParentNode): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/elements/inline/abbr/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/elements/inline/abbr/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;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,QAAQ,EAAG,MAAe,CAAC;AAExC;;;;GAIG;AACH,eAAO,MAAM,aAAa,SAAS,CAAC;AAEpC;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG;IAClD;;OAEG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB,CAAC;AA6BF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC,OAAO,QAAQ,CAAC,CAEvF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAAC,IAAI,GAAE,UAAqB,GAAG,IAAI,CAG9D"}

package/dist/types/elements/inline/b/index.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Fundatio Design Foundation: B element helpers.
+ *
+ * @remarks
+ * The b element (`<b>`) represents a span of text to which attention is being
+ * drawn for utilitarian purposes, without conveying extra importance.
+ *
+ * Best-practice guidance:
+ * - Use `<b>` to draw attention without implying importance.
+ * - Use `<strong>` for strong importance and `<em>` for stress emphasis.
+ * - Do not use `<b>` purely for styling. Prefer CSS (e.g. `font-weight`) when the
+ *   goal is visual bolding rather than semantics.
+ *
+ * This module provides small, framework-agnostic helpers so consumers can:
+ * - create inline attention spans 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/b
+ *
+ * @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 "bring attention to" spans.
+ *
+ * @category Constants
+ */
+export declare const B_TAG: "b";
+/**
+ * A CSS selector targeting b elements.
+ *
+ * @category Constants
+ */
+export declare const B_SELECTOR = "b";
+/**
+ * Attribute bag for b creation/enhancement.
+ *
+ * @remarks
+ * B 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 BAttrs = Omit<GlobalAttrs, 'aria'> & {
+    /**
+     * Structured ARIA fields mapped into `aria-*` attributes.
+     */
+    aria?: StructuredAria;
+};
+/**
+ * Create a b element with optional text content and global 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 b element.
+ * @param attrs - Optional attributes to apply.
+ * @returns The created `<b>` element.
+ *
+ * @example
+ * ```ts
+ * import { createB } from "@Vastare/Fundatio/elements/inline/b";
+ *
+ * document.body.appendChild(createB("Keyword", { className: "keyword" }));
+ * ```
+ *
+ * @category DOM
+ */
+export declare function createB(text?: string, attrs?: BAttrs): ElementOf<typeof B_TAG>;
+/**
+ * Enhance b 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 enhanceBs(root?: ParentNode): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/elements/inline/b/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/elements/inline/b/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;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,KAAK,EAAG,GAAY,CAAC;AAElC;;;;GAIG;AACH,eAAO,MAAM,UAAU,MAAM,CAAC;AAE9B;;;;;;;;;;GAUG;AACH,MAAM,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG;IAC/C;;OAEG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB,CAAC;AA6BF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,KAAK,CAAC,CAE9E;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CAAC,IAAI,GAAE,UAAqB,GAAG,IAAI,CAG3D"}