@nysds/components 1.13.0 → 1.13.1

package/dist/packages/nys-badge/src/nys-badge.d.ts

@@ -1,19 +1,45 @@
 import { LitElement } from "lit";
 /**
- * `<nys-badge>` displays a badge with optional prefix/suffix icons and labels.
+ * A compact label for status, counts, or categorization. Supports semantic intents with auto-selected icons.
  *
- * Features:
- * - Conveys an intent (`neutral`, `error`, `success`, `warning`) which affects default icons and styling.
- * - Supports custom prefix and suffix icons.
+ * Use badges to highlight metadata like status ("Approved"), counts ("3 new"), or categories.
+ * Set `intent` to apply semantic meaning. Add `prefixIcon` or `suffixIcon` as boolean for default icons,
+ * or pass icon name strings for custom icons.
+ *
+ * @summary Compact label for status, counts, or categorization with semantic styling.
+ * @element nys-badge
+ *
+ * @example Status badge
+ * ```html
+ * <nys-badge intent="success" label="Approved" prefixIcon></nys-badge>
+ * ```
+ *
+ * @example Count badge
+ * ```html
+ * <nys-badge prefixLabel="Messages" label="12"></nys-badge>
+ * ```
  */
 export declare class NysBadge extends LitElement {
     static styles: import("lit").CSSResult;
+    /** Unique identifier. */
     id: string;
+    /** Name attribute for form association. */
     name: string;
+    /**
+     * Badge size: `sm` (smaller text) or `md` (default).
+     * @default "md"
+     */
     size: "sm" | "md";
+    /**
+     * Semantic intent affecting color: `neutral`, `error`, `success`, or `warning`.
+     * @default "neutral"
+     */
     intent: "neutral" | "error" | "success" | "warning";
+    /** Secondary label displayed before the main label. */
     prefixLabel: string;
+    /** Primary label text displayed in the badge. */
     label: string;
+    variant: "strong" | "";
     private _prefixIcon;
     get prefixIcon(): string | boolean;
     set prefixIcon(value: string | boolean);

package/dist/packages/nys-button/src/nys-button.d.ts

@@ -1,38 +1,155 @@
 import { LitElement } from "lit";
 /**
- * `<nys-button>` is a versatile button component supporting:
- * - Multiple variants (`filled`, `outline`, `ghost`, `text`)
- * - Sizes (`sm`, `md`, `lg`) and full-width layout
- * - Icons (prefix, suffix, or circle) and optional labels
- * - Native `<button>` or link `<a>` behavior with form association
- * - Keyboard and accessibility support (`aria-label`, `aria-controls`, `aria-description`)
+ * A button for actions like saving, submitting, or navigating. Form-associated with full keyboard support.
  *
- * @fires nys-click - Fired on button click
- * @fires nys-focus - Fired when button receives focus
- * @fires nys-blur - Fired when button loses focus
+ * Use `filled` for primary actions (one per section), `outline` for secondary, `ghost` for tertiary,
+ * `text` for inline. Set `href` to render as a navigation link.
+ *
+ * @summary Button for actions and CTAs with variants, sizes, and icon support.
+ * @element nys-button
+ *
+ * @slot prefix-icon - Icon before label. Not shown for `text` variant.
+ * @slot suffix-icon - Icon after label. Not shown for `text` variant.
+ * @slot circle-icon - Icon for circle mode. Overrides `icon` prop.
+ *
+ * @cssprop [--nys-button-color] - Text color of the button label.
+ * @cssprop [--nys-button-color--hover] - Text color when hovered.
+ * @cssprop [--nys-button-color--active] - Text color when active/pressed.
+ * @cssprop [--nys-button-background-color] - Background color of the button.
+ * @cssprop [--nys-button-background-color--hover] - Background color when hovered.
+ * @cssprop [--nys-button-background-color--active] - Background color when active/pressed.
+ * @cssprop [--nys-button-border-color] - Border color of the button.
+ * @cssprop [--nys-button-border-color--hover] - Border color when hovered.
+ * @cssprop [--nys-button-border-color--active] - Border color when active/pressed.
+ *
+ * @fires nys-click - Fired when the button is clicked (mouse or keyboard). Not fired when disabled.
+ * @fires nys-focus - Fired when the button receives focus.
+ * @fires nys-blur - Fired when the button loses focus.
+ *
+ * @example Basic filled button
+ * ```html
+ * <nys-button label="Submit" variant="filled"></nys-button>
+ * ```
+ *
+ * @example Secondary outline button
+ * ```html
+ * <nys-button label="Cancel" variant="outline"></nys-button>
+ * ```
+ *
+ * @example Button with icons
+ * ```html
+ * <nys-button label="Previous" prefixIcon="chevron_left"></nys-button>
+ * <nys-button label="Next" suffixIcon="chevron_right"></nys-button>
+ * ```
+ *
+ * @example Circle icon button
+ * ```html
+ * <nys-button circle icon="close" label="Close dialog"></nys-button>
+ * ```
+ *
+ * @example Link-style button for navigation
+ * ```html
+ * <nys-button label="Visit NY.gov" href="https://www.ny.gov/" target="_blank" suffixIcon="open_in_new"></nys-button>
+ * ```
+ *
+ * @example Form submit button
+ * ```html
+ * <nys-button type="submit" label="Save Changes" variant="filled"></nys-button>
+ * ```
  */
 export declare class NysButton extends LitElement {
     static styles: import("lit").CSSResult;
+    /**
+     * Unique identifier. Auto-generated if not provided.
+     */
     id: string;
+    /**
+     * Name for form submission.
+     */
     name: string;
+    /**
+     * Button height: `sm` (40px) for dense UIs, `md` (48px, default) for standard use, `lg` (56px) for prominent CTAs.
+     * @default "md"
+     */
     size: "sm" | "md" | "lg";
+    /**
+     * Expands button to fill container width. Use for mobile layouts or stacked button groups.
+     * @default false
+     */
     fullWidth: boolean;
+    /**
+     * Visual style: `filled` for primary (one per section), `outline` for secondary, `ghost` for tertiary, `text` for inline actions. Avoid `text` for navigation.
+     * @default "filled"
+     */
     variant: "filled" | "outline" | "ghost" | "text";
+    /**
+     * Adjusts colors for dark backgrounds.
+     * @default false
+     */
     inverted: boolean;
+    /**
+     * Visible button text. Use sentence case, action-oriented text (e.g., "Save Draft"). Becomes aria-label in `circle` mode.
+     */
     label: string;
+    /**
+     * Screen reader label. Required for icon-only buttons if `label` is not set.
+     */
     ariaLabel: string;
+    /**
+     * ID of controlled element (e.g., dropdown or modal). Sets `aria-controls`.
+     */
     ariaControls: string;
+    /**
+     * Material Symbol icon before label. Not shown for `text` variant or `circle` mode.
+     */
     prefixIcon: string;
+    /**
+     * Material Symbol icon after label. Use `chevron_down` for dropdowns, `open_in_new` for external links. Not shown for `text` variant or `circle` mode.
+     */
     suffixIcon: string;
+    /**
+     * Renders circular icon-only button. Requires `icon` prop. `label` becomes aria-label.
+     * @default false
+     */
     circle: boolean;
+    /**
+     * Icon for circle mode. Required when `circle` is true. Scales with size (sm=24px, md=32px, lg=40px).
+     */
     icon: string;
+    /**
+     * Prevents interaction. Avoid disabling without explanation—show validation errors instead.
+     * @default false
+     */
     disabled: boolean;
+    /**
+     * Form `id` to associate with. Use when button is outside the form element.
+     */
     form: string | null;
+    /**
+     * Value submitted with form data. Only used when `type="submit"`.
+     */
     value: string;
+    /**
+     * Additional screen reader description. Sets `aria-description`.
+     */
     ariaDescription: string;
+    /**
+     * Form behavior: `button` (default, no form action), `submit` (submits form), `reset` (resets form). Always set explicitly to avoid unintended submissions.
+     * @default "button"
+     */
     type: "submit" | "reset" | "button";
+    /**
+     * Click handler. Use instead of `@click` to ensure keyboard accessibility.
+     */
     onClick: ((event: Event) => void) | null;
+    /**
+     * URL to navigate to. Renders as `<a>` tag. Omit for action buttons.
+     */
     href: string;
+    /**
+     * Link target: `_self` (same tab), `_blank` (new tab—add `suffixIcon="open_in_new"`), `_parent`, `_top`, or frame name.
+     * @default "_self"
+     */
     target: "_self" | "_blank" | "_parent" | "_top" | "framename";
     getButtonElement(): Promise<HTMLElement | null>;
     private _internals;

package/dist/packages/nys-checkbox/src/nys-checkbox.d.ts

@@ -1,38 +1,70 @@
 import { LitElement } from "lit";
 import "./nys-checkboxgroup";
 /**
- * `<nys-checkbox>` is an accessible, form-associated checkbox component.
- * Can be used standalone or within a `<nys-checkboxgroup>`.
+ * A checkbox input for binary choices or multi-select lists. Can be used standalone or in a `nys-checkboxgroup`.
+ * Form-associated with validation via ElementInternals.
  *
- * Features:
- * - Supports labels, descriptions, and tooltips
- * - Displays error messages with `showError` and `errorMessage`
- * - Keyboard interaction with spacebar toggle
- * - Form integration via ElementInternals (`checked` value submitted)
+ * Use for binary decisions (agree/disagree) or selecting multiple options from a list.
+ * For single selection from 2-6 options, use `nys-radiobutton`. For immediate state changes, use `nys-toggle`.
  *
- * @fires nys-change - Fired when checkbox value changes
- * @fires nys-focus - Fired on focus
- * @fires nys-blur - Fired on blur
+ * @summary Checkbox for binary choices or multi-select options.
+ * @element nys-checkbox
  *
- * @slot description - Slot to provide a custom description element
+ * @slot description - Custom HTML description content.
+ *
+ * @fires nys-change - Fired when checked state changes. Detail: `{id, checked, name, value}`.
+ * @fires nys-focus - Fired when checkbox gains focus.
+ * @fires nys-blur - Fired when checkbox loses focus.
+ *
+ * @example Single checkbox
+ * ```html
+ * <nys-checkbox label="I agree to the terms" name="terms" required></nys-checkbox>
+ * ```
+ *
+ * @example Checkbox group
+ * ```html
+ * <nys-checkboxgroup label="Select landmarks">
+ *   <nys-checkbox name="landmarks" value="adirondacks" label="Adirondacks"></nys-checkbox>
+ *   <nys-checkbox name="landmarks" value="niagara" label="Niagara Falls"></nys-checkbox>
+ * </nys-checkboxgroup>
+ * ```
  */
 export declare class NysCheckbox extends LitElement {
     static styles: import("lit").CSSResult;
+    /** Whether checkbox is checked. */
     checked: boolean;
+    /** Prevents interaction. */
     disabled: boolean;
+    /** Marks as required. Validates that checkbox is checked. */
     required: boolean;
+    /** Visible label text. Required for accessibility. */
     label: string;
+    /** Helper text below label. Use slot for custom HTML. */
     description: string;
+    /** Unique identifier. Auto-generated if not provided. */
     id: string;
+    /** Name for form submission. Use same name for grouped checkboxes. */
     name: string;
+    /** Value submitted when checked. */
     value: string;
+    /** Form `id` to associate with when checkbox is outside form element. */
     form: string | null;
+    /** Shows error message when true. */
     showError: boolean;
+    /** Error message text. Shown only when `showError` is true. */
     errorMessage: string;
+    /** Internal: Set by parent checkboxgroup. Do not set manually. */
     groupExist: boolean;
+    /** Renders as tile with larger clickable area. Apply to group for consistency. */
     tile: boolean;
+    /** Adjusts colors for dark backgrounds. */
     inverted: boolean;
+    /** Tooltip text shown on hover/focus of info icon. */
     tooltip: string;
+    /**
+     * Checkbox size: `sm` (24px) or `md` (32px, default).
+     * @default "md"
+     */
     size: "sm" | "md";
     getInputElement(): Promise<HTMLInputElement | null>;
     private _internals;

package/dist/packages/nys-checkbox/src/nys-checkboxgroup.d.ts

@@ -1,35 +1,55 @@
 import { LitElement } from "lit";
 /**
- * `<nys-checkboxgroup>` is a form-associated container for multiple `<nys-checkbox>` components.
- * Handles grouping, validation, required constraints, form submission, and accessibility.
+ * A container for grouping multiple `nys-checkbox` components as a single form control.
+ * Handles validation, required constraints, and submits comma-separated values.
  *
- * Features:
- * - Manages multiple checkboxes as a single form field
- * - Supports required/optional flags and error messages
- * - Propagates size, tile, and inverted styling to child checkboxes
- * - Keyboard and screen reader accessible via fieldset/legend
+ * Use to allow users to select multiple options from a list. Apply `tile`, `size`, and `inverted` to the group
+ * and all children inherit these styles automatically.
  *
- * @slot default - Slot for child `<nys-checkbox>` elements
- * @slot description - Slot for custom description content
+ * @summary Container for grouping checkboxes as a single form control.
+ * @element nys-checkboxgroup
  *
- * @fires nys-change - Fired when any child checkbox changes
- * @fires nys-focus - Fired when any child checkbox gains focus
- * @fires nys-blur - Fired when any child checkbox loses focus
+ * @slot - Default slot for `nys-checkbox` elements.
+ * @slot description - Custom HTML description content.
+ *
+ * @example Basic checkbox group
+ * ```html
+ * <nys-checkboxgroup label="Select landmarks" required>
+ *   <nys-checkbox name="landmarks" value="adirondacks" label="Adirondacks"></nys-checkbox>
+ *   <nys-checkbox name="landmarks" value="niagara" label="Niagara Falls"></nys-checkbox>
+ * </nys-checkboxgroup>
+ * ```
  */
 export declare class NysCheckboxgroup extends LitElement {
     static styles: import("lit").CSSResult;
+    /** Unique identifier. Auto-generated if not provided. */
     id: string;
+    /** Name for form submission. Set on group, not individual checkboxes. */
     name: string;
+    /** Requires at least one checkbox to be checked. */
     required: boolean;
+    /** Shows "Optional" flag. */
     optional: boolean;
+    /** Shows error message when true. */
     showError: boolean;
+    /** Error message text. Shown only when `showError` is true. */
     errorMessage: string;
+    /** Visible label text for the group. */
     label: string;
+    /** Helper text below label. Use slot for custom HTML. */
     description: string;
+    /** Renders all checkboxes as tiles with larger clickable area. */
     tile: boolean;
+    /** Tooltip text shown on hover/focus of info icon. */
     tooltip: string;
+    /** Adjusts colors for dark backgrounds. Applied to all children. */
     inverted: boolean;
+    /** Form `id` to associate with. Applied to all children. */
     form: string | null;
+    /**
+     * Checkbox size for all children: `sm` (24px) or `md` (32px, default).
+     * @default "md"
+     */
     size: "sm" | "md";
     private _slottedDescriptionText;
     private _internals;
@@ -56,6 +76,7 @@ export declare class NysCheckboxgroup extends LitElement {
     private _updateCheckboxShowError;
     private _updateCheckboxForm;
     private _getSlotDescriptionForAria;
+    formResetCallback(): void;
     private _handleInvalid;
     /**
      * Event Handlers

package/dist/packages/nys-divider/src/nys-divider.d.ts

@@ -1,11 +1,29 @@
 import { LitElement } from "lit";
 /**
- * `<nys-divider>` renders a horizontal rule `<hr>` element with optional styling.
- * Can be inverted for dark backgrounds.
+ * A horizontal rule for visual separation between content sections. Renders a semantic `<hr>` element.
+ *
+ * Use to separate distinct content areas within a page. Set `inverted` for use on dark backgrounds.
+ *
+ * @summary Horizontal divider for visual separation of content sections.
+ * @element nys-divider
+ *
+ * @example Basic divider
+ * ```html
+ * <p>Section one content</p>
+ * <nys-divider></nys-divider>
+ * <p>Section two content</p>
+ * ```
  */
 export declare class NysDivider extends LitElement {
     static styles: import("lit").CSSResult;
+    /** Adjusts colors for dark backgrounds. */
     inverted: boolean;
     constructor();
+    connectedCallback(): void;
+    /**
+     * Functions
+     * --------------------------------------------------------------------------
+     */
+    private _generateUniqueId;
     render(): import("lit-html").TemplateResult<1>;
 }

package/dist/packages/nys-errormessage/src/nys-errormessage.d.ts

@@ -1,13 +1,20 @@
 import { LitElement } from "lit";
 /**
- * THIS IS A PRIVATE COMPONENT!
- * `<nys-errormessage>` displays an error message for form elements.
- * Can optionally show a divider and supports native form validation messages.
+ * **Internal component.** Displays error messages for form validation with icon and ARIA alert role.
+ *
+ * Used internally by form components. Not intended for direct use. Shows error icon and message
+ * when `showError` is true. Integrates with ElementInternals for native form validation messages.
+ *
+ * @summary Internal error message display with icon and ARIA alert support.
+ * @element nys-errormessage
  */
 export declare class NysErrorMessage extends LitElement {
     static styles: import("lit").CSSResult;
+    /** Whether to display the error message. */
     showError: boolean;
+    /** Error text to display. Falls back to native validation message if available. */
     errorMessage: string;
+    /** Shows a divider line above the error message. */
     showDivider: boolean;
     private _internals;
     /**

package/dist/packages/nys-fileinput/src/nys-fileinput.d.ts

@@ -1,39 +1,64 @@
 import { LitElement } from "lit";
 import "./nys-fileitem";
 /**
- * `<nys-fileinput>` provides accessible file selection with optional
- * drag-and-drop support, progress tracking, validation, and form submission.
+ * A file input for uploading files with support for multiple files, drag-and-drop, and progress tracking.
+ * Validates file types via magic bytes (not just extension). Form-associated via ElementInternals.
  *
- * Features:
- * - Supports single or multiple file uploads
- * - Optional drag-and-drop dropzone
- * - File type validation and upload progress
- * - Form-associated with native validation behavior
- * - Keyboard and screen reader accessible
+ * Use for document uploads, image uploads, or any file submission. Enable `dropzone` for drag-and-drop UI.
  *
- * @slot description - Custom description content under the label
+ * @summary File input with drag-and-drop, validation, and progress tracking.
+ * @element nys-fileinput
  *
- * @fires nys-change - Fired when files are added or removed
+ * @slot description - Custom HTML description content.
  *
- * @returns {boolean} checkValidity - Returns validity state for form validation
+ * @fires nys-change - Fired when files are added or removed. Detail: `{id, files}`.
+ *
+ * @example Single file upload
+ * ```html
+ * <nys-fileinput label="Upload document" accept=".pdf,.doc" required></nys-fileinput>
+ * ```
+ *
+ * @example Multiple files with dropzone
+ * ```html
+ * <nys-fileinput label="Upload images" accept="image/*" multiple dropzone></nys-fileinput>
+ * ```
  */
 export declare class NysFileinput extends LitElement {
     static styles: import("lit").CSSResult;
+    /** Unique identifier. Auto-generated if not provided. */
     id: string;
+    /** Name for form submission. */
     name: string;
+    /** Visible label text. */
     label: string;
+    /** Helper text below label. Use slot for custom HTML. */
     description: string;
+    /** Allows selecting multiple files. */
     multiple: boolean;
+    /** Form `id` to associate with. */
     form: string | null;
+    /** Tooltip text shown on hover/focus of info icon. */
     tooltip: string;
+    /** Accepted file types. Use MIME types (`image/*`) or extensions (`.pdf`). Validated via magic bytes. */
     accept: string;
+    /** Prevents interaction. */
     disabled: boolean;
+    /** Requires at least one file to be uploaded. */
     required: boolean;
+    /** Shows "Optional" flag. */
     optional: boolean;
+    /** Shows error message when true. */
     showError: boolean;
+    /** Error message text. Shown only when `showError` is true. */
     errorMessage: string;
+    /** Enables drag-and-drop zone UI. */
     dropzone: boolean;
+    /**
+     * Component width: `lg` (384px) or `full` (100%, default).
+     * @default "full"
+     */
     width: "lg" | "full";
+    /** Adjusts colors for dark backgrounds. */
     inverted: boolean;
     private _selectedFiles;
     private _dragActive;
@@ -60,6 +85,7 @@ export declare class NysFileinput extends LitElement {
     private _setValidityMessage;
     private _validate;
     checkValidity(): boolean;
+    formResetCallback(): void;
     private _handleInvalid;
     /**
      * Functions

package/dist/packages/nys-fileinput/src/nys-fileitem.d.ts

@@ -1,13 +1,27 @@
 import { LitElement } from "lit";
 /**
- * `<nys-fileitem>` displays an individual file in a file input component.
- * It shows the file name, upload status, progress bar, and error messages.
+ * **Internal component.** Displays an individual file within `nys-fileinput` with status and progress.
+ *
+ * Rendered automatically by `nys-fileinput` for each selected file. Shows filename, upload status
+ * (pending/processing/done/error), progress bar during upload, and error messages. Remove button emits event.
+ *
+ * @summary Internal file item display with status, progress bar, and remove action.
+ * @element nys-fileitem
+ *
+ * @fires nys-fileRemove - Fired when remove button is clicked. Detail: `{filename}`.
  */
 export declare class NysFileItem extends LitElement {
     static styles: import("lit").CSSResult;
+    /** Name of the file being displayed. */
     filename: string;
+    /**
+     * Upload status: `pending` (queued), `processing` (uploading), `done` (complete), `error` (failed).
+     * @default "pending"
+     */
     status: "pending" | "processing" | "done" | "error";
+    /** Upload progress percentage (0-100). Only shown when status is `processing`. */
     progress: number;
+    /** Error message displayed when status is `error`. */
     errorMessage: string;
     private _handleRemove;
     private splitFilename;

package/dist/packages/nys-globalfooter/src/nys-globalfooter.d.ts

@@ -1,19 +1,28 @@
 import { LitElement } from "lit";
 /**
- * `<nys-globalfooter>` renders a New York State–style global footer.
+ * Agency-branded footer with agency name and slotted content sections. Auto-layouts based on content structure.
  *
- * Displays an agency name with an optional homepage link and supports
- * structured footer content via slots.
+ * Place above `nys-unavfooter`. Slot contact info, links, or other content. Use `<h4>` elements
+ * to create multi-column layouts; without `<h4>`, renders as compact single section.
  *
- * @slot default - Footer content such as headings, links, or groups
+ * @summary Agency footer with auto-layout for contact info and link sections.
+ * @element nys-globalfooter
  *
- * Layout behavior:
- * - Multiple `<h4>` elements trigger a multi-column layout
- * - Single group content renders in a compact layout
+ * @slot - Footer content (links, contact info). Use `<h4>` for column headings.
+ *
+ * @example Simple footer
+ * ```html
+ * <nys-globalfooter agencyName="Department of Health" homepageLink="/">
+ *   <span>123 Main St, Albany NY</span>
+ *   <span>info@health.ny.gov</span>
+ * </nys-globalfooter>
+ * ```
  */
 export declare class NysGlobalFooter extends LitElement {
     static styles: import("lit").CSSResult;
+    /** Agency name displayed as the footer heading. */
     agencyName: string;
+    /** URL for the agency name link. If empty, name is not clickable. */
     homepageLink: string;
     private slotHasContent;
     /**

package/dist/packages/nys-globalheader/src/nys-globalheader.d.ts

@@ -1,23 +1,29 @@
 import { LitElement } from "lit";
 /**
- * `<nys-globalheader>` renders a New York State–style global header.
+ * Agency-branded header with app/agency name, navigation, and responsive mobile menu.
  *
- * Displays an optional application name, agency name, and homepage link.
- * Supports slotted navigation content with automatic active-link detection
- * and a responsive mobile menu.
+ * Place below `nys-unavheader`. Slot navigation links as `<ul><li><a>` elements; active links
+ * are auto-highlighted based on current URL. Mobile menu toggles automatically on narrow screens.
  *
- * @slot default - Primary navigation list, typically a `<ul>` with links
- * @slot user-actions - Optional user action elements such as login or profile
+ * @summary Agency header with navigation, mobile menu, and active link highlighting.
+ * @element nys-globalheader
  *
- * Behavior:
- * - Automatically highlights the best matching link based on the current URL
- * - Duplicates navigation content for desktop and mobile layouts
- * - Provides a toggleable mobile menu when navigation content exists
+ * @slot - Navigation content (typically `<ul>` with `<li><a>` links). Auto-sanitized.
+ *
+ * @example Basic header
+ * ```html
+ * <nys-globalheader appName="My App" agencyName="Department of Health" homepageLink="/">
+ *   <ul><li><a href="/about">About</a></li><li><a href="/contact">Contact</a></li></ul>
+ * </nys-globalheader>
+ * ```
  */
 export declare class NysGlobalHeader extends LitElement {
     static styles: import("lit").CSSResult;
+    /** Application name displayed prominently. */
     appName: string;
+    /** Agency name displayed below app name (or as main title if no appName). */
     agencyName: string;
+    /** URL for the header title link. If empty, title is not clickable. */
     homepageLink: string;
     private isMobileMenuOpen;
     private hasLinkContent;