@gov-design-system-ce/components 4.6.5-b → 4.6.5

package/dist/dist/dist/components/gov-stepper.d.ts

@@ -0,0 +1,11 @@
+import type { Components, JSX } from "../types/components";
+
+interface GovStepper extends Components.GovStepper, HTMLElement {}
+export const GovStepper: {
+    prototype: GovStepper;
+    new (): GovStepper;
+};
+/**
+ * Used to define this component and all nested components recursively.
+ */
+export const defineCustomElement: () => void;

package/dist/dist/dist/components/gov-tabs-item.d.ts

@@ -0,0 +1,11 @@
+import type { Components, JSX } from "../types/components";
+
+interface GovTabsItem extends Components.GovTabsItem, HTMLElement {}
+export const GovTabsItem: {
+    prototype: GovTabsItem;
+    new (): GovTabsItem;
+};
+/**
+ * Used to define this component and all nested components recursively.
+ */
+export const defineCustomElement: () => void;

package/dist/dist/dist/components/gov-tabs.d.ts

@@ -0,0 +1,11 @@
+import type { Components, JSX } from "../types/components";
+
+interface GovTabs extends Components.GovTabs, HTMLElement {}
+export const GovTabs: {
+    prototype: GovTabs;
+    new (): GovTabs;
+};
+/**
+ * Used to define this component and all nested components recursively.
+ */
+export const defineCustomElement: () => void;

package/dist/dist/dist/components/gov-tag.d.ts

@@ -0,0 +1,11 @@
+import type { Components, JSX } from "../types/components";
+
+interface GovTag extends Components.GovTag, HTMLElement {}
+export const GovTag: {
+    prototype: GovTag;
+    new (): GovTag;
+};
+/**
+ * Used to define this component and all nested components recursively.
+ */
+export const defineCustomElement: () => void;

package/dist/dist/dist/components/gov-theme-switch.d.ts

@@ -0,0 +1,11 @@
+import type { Components, JSX } from "../types/components";
+
+interface GovThemeSwitch extends Components.GovThemeSwitch, HTMLElement {}
+export const GovThemeSwitch: {
+    prototype: GovThemeSwitch;
+    new (): GovThemeSwitch;
+};
+/**
+ * Used to define this component and all nested components recursively.
+ */
+export const defineCustomElement: () => void;

package/dist/dist/dist/components/gov-tile.d.ts

@@ -0,0 +1,11 @@
+import type { Components, JSX } from "../types/components";
+
+interface GovTile extends Components.GovTile, HTMLElement {}
+export const GovTile: {
+    prototype: GovTile;
+    new (): GovTile;
+};
+/**
+ * Used to define this component and all nested components recursively.
+ */
+export const defineCustomElement: () => void;

package/dist/dist/dist/components/gov-toast.d.ts

@@ -0,0 +1,11 @@
+import type { Components, JSX } from "../types/components";
+
+interface GovToast extends Components.GovToast, HTMLElement {}
+export const GovToast: {
+    prototype: GovToast;
+    new (): GovToast;
+};
+/**
+ * Used to define this component and all nested components recursively.
+ */
+export const defineCustomElement: () => void;

package/dist/dist/dist/components/gov-tooltip-content.d.ts

@@ -0,0 +1,11 @@
+import type { Components, JSX } from "../types/components";
+
+interface GovTooltipContent extends Components.GovTooltipContent, HTMLElement {}
+export const GovTooltipContent: {
+    prototype: GovTooltipContent;
+    new (): GovTooltipContent;
+};
+/**
+ * Used to define this component and all nested components recursively.
+ */
+export const defineCustomElement: () => void;

package/dist/dist/dist/components/gov-tooltip.d.ts

@@ -0,0 +1,11 @@
+import type { Components, JSX } from "../types/components";
+
+interface GovTooltip extends Components.GovTooltip, HTMLElement {}
+export const GovTooltip: {
+    prototype: GovTooltip;
+    new (): GovTooltip;
+};
+/**
+ * Used to define this component and all nested components recursively.
+ */
+export const defineCustomElement: () => void;

package/dist/dist/dist/components/gov-wizard-item.d.ts

@@ -0,0 +1,11 @@
+import type { Components, JSX } from "../types/components";
+
+interface GovWizardItem extends Components.GovWizardItem, HTMLElement {}
+export const GovWizardItem: {
+    prototype: GovWizardItem;
+    new (): GovWizardItem;
+};
+/**
+ * Used to define this component and all nested components recursively.
+ */
+export const defineCustomElement: () => void;

package/dist/dist/dist/components/gov-wizard.d.ts

@@ -0,0 +1,11 @@
+import type { Components, JSX } from "../types/components";
+
+interface GovWizard extends Components.GovWizard, HTMLElement {}
+export const GovWizard: {
+    prototype: GovWizard;
+    new (): GovWizard;
+};
+/**
+ * Used to define this component and all nested components recursively.
+ */
+export const defineCustomElement: () => void;

package/dist/dist/dist/components/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Get the base path to where the assets can be found. Use "setAssetPath(path)"
+ * if the path needs to be customized.
+ */
+export declare const getAssetPath: (path: string) => string;
+
+/**
+ * Used to manually set the base path where assets can be found.
+ * If the script is used as "module", it's recommended to use "import.meta.url",
+ * such as "setAssetPath(import.meta.url)". Other options include
+ * "setAssetPath(document.currentScript.src)", or using a bundler's replace plugin to
+ * dynamically set the path at build time, such as "setAssetPath(process.env.ASSET_PATH)".
+ * But do note that this configuration depends on how your script is bundled, or lack of
+ * bundling, and where your assets can be loaded from. Additionally custom bundling
+ * will have to ensure the static assets are copied to its build directory.
+ */
+export declare const setAssetPath: (path: string) => void;
+
+/**
+ * Used to specify a nonce value that corresponds with an application's CSP.
+ * When set, the nonce will be added to all dynamically created script and style tags at runtime.
+ * Alternatively, the nonce value can be set on a meta tag in the DOM head
+ * (<meta name="csp-nonce" content="{ nonce value here }" />) which
+ * will result in the same behavior.
+ */
+export declare const setNonce: (nonce: string) => void
+
+export interface SetPlatformOptions {
+  raf?: (c: FrameRequestCallback) => number;
+  ael?: (el: EventTarget, eventName: string, listener: EventListenerOrEventListenerObject, options: boolean | AddEventListenerOptions) => void;
+  rel?: (el: EventTarget, eventName: string, listener: EventListenerOrEventListenerObject, options: boolean | AddEventListenerOptions) => void;
+}
+export declare const setPlatformOptions: (opts: SetPlatformOptions) => void;
+
+export * from '../types';

package/dist/dist/dist/globals.d.ts

@@ -0,0 +1,2 @@
+declare module "*.md";
+declare module "*.json";

package/dist/dist/dist/hydrate/index.d.ts

@@ -0,0 +1,287 @@
+// Generated by dts-bundle-generator v9.5.1
+
+import { Readable } from 'node:stream';
+
+export declare function createWindowFromHtml(templateHtml: string, uniqueId: string): any;
+export type TagTransformer = (tag: string) => string;
+/**
+ * Serialize a value to a string that can be deserialized later.
+ * @param {unknown} value - The value to serialize.
+ * @returns {string} A string that can be deserialized later.
+ * @deprecated will be removed in v5. Use `@PropSerialize()` decorator instead.
+ */
+export declare function serializeProperty(value: unknown): string | number | boolean;
+/**
+ * Deserialize a value from a string that was serialized earlier.
+ * @param {string} value - The string to deserialize.
+ * @returns {unknown} The deserialized value.
+ * @deprecated will be removed in v5. Use `@AttrDeserialize()` decorator instead.
+ */
+export declare function deserializeProperty(value: string): any;
+export type ResolutionHandler = (elm: HTMLElement) => string | undefined | null;
+export interface HydrateDocumentOptions {
+	/**
+	 * Build ID that will be added to `<html data-stencil-build="BUILD_ID">`. By default
+	 * a random ID will be generated
+	 */
+	buildId?: string;
+	/**
+	 * Sets the `href` attribute on the `<link rel="canonical">`
+	 * tag within the `<head>`. If the value is not defined it will
+	 * ensure a canonical link tag is no included in the `<head>`.
+	 */
+	canonicalUrl?: string;
+	/**
+	 * Include the HTML comments and attributes used by the client-side
+	 * JavaScript to read the structure of the HTML and rebuild each
+	 * component. Defaults to `true`.
+	 */
+	clientHydrateAnnotations?: boolean;
+	/**
+	 * Constrain `setTimeout()` to 1ms, but still async. Also
+	 * only allows `setInterval()` to fire once, also constrained to 1ms.
+	 * Defaults to `true`.
+	 */
+	constrainTimeouts?: boolean;
+	/**
+	 * Sets `document.cookie`
+	 */
+	cookie?: string;
+	/**
+	 * Sets the `dir` attribute on the top level `<html>`.
+	 */
+	direction?: string;
+	/**
+	 * Component tag names listed here will not be prerendered, nor will
+	 * hydrated on the client-side. Components listed here will be ignored
+	 * as custom elements and treated no differently than a `<div>`.
+	 */
+	excludeComponents?: string[];
+	/**
+	 * Sets the `lang` attribute on the top level `<html>`.
+	 */
+	language?: string;
+	/**
+	 * Maximum number of components to hydrate on one page. Defaults to `300`.
+	 */
+	maxHydrateCount?: number;
+	/**
+	 * Sets `document.referrer`
+	 */
+	referrer?: string;
+	/**
+	 * Removes every `<script>` element found in the `document`. Defaults to `false`.
+	 */
+	removeScripts?: boolean;
+	/**
+	 * Removes CSS not used by elements within the `document`. Defaults to `true`.
+	 */
+	removeUnusedStyles?: boolean;
+	/**
+	 * The url the runtime uses for the resources, such as the assets directory.
+	 */
+	resourcesUrl?: string;
+	/**
+	 * Prints out runtime console logs to the NodeJS process. Defaults to `false`.
+	 */
+	runtimeLogging?: boolean;
+	/**
+	 * Component tags listed here will only be prerendered or server-side-rendered
+	 * and will not be client-side hydrated. This is useful for components that
+	 * are not dynamic and do not need to be defined as a custom element within the
+	 * browser. For example, a header or footer component would be a good example that
+	 * may not require any client-side JavaScript.
+	 */
+	staticComponents?: string[];
+	/**
+	 * The amount of milliseconds to wait for a page to finish rendering until
+	 * a timeout error is thrown. Defaults to `15000`.
+	 */
+	timeout?: number;
+	/**
+	 * Sets `document.title`.
+	 */
+	title?: string;
+	/**
+	 * Sets `location.href`
+	 */
+	url?: string;
+	/**
+	 * Sets `navigator.userAgent`
+	 */
+	userAgent?: string;
+	/**
+	 * Configure how Stencil serializes the components shadow root.
+	 * - If set to `declarative-shadow-dom` the component will be rendered within a Declarative Shadow DOM.
+	 * - If set to `scoped` Stencil will render the contents of the shadow root as a `scoped: true` component
+	 *   and the shadow DOM will be created during client-side hydration.
+	 * - Alternatively you can mix and match the two by providing an object with `declarative-shadow-dom` and `scoped` keys,
+	 * the value arrays containing the tag names of the components that should be rendered in that mode.
+	 *
+	 * Examples:
+	 * - `{ 'declarative-shadow-dom': ['my-component-1', 'another-component'], default: 'scoped' }`
+	 * Render all components as `scoped` apart from `my-component-1` and `another-component`
+	 * -  `{ 'scoped': ['an-option-component'], default: 'declarative-shadow-dom' }`
+	 * Render all components within `declarative-shadow-dom` apart from `an-option-component`
+	 * - `'scoped'` Render all components as `scoped`
+	 * - `false` disables shadow root serialization
+	 *
+	 * *NOTE* `true` has been deprecated in favor of `declarative-shadow-dom` and `scoped`
+	 * @default 'declarative-shadow-dom'
+	 */
+	serializeShadowRoot?: "declarative-shadow-dom" | "scoped" | {
+		"declarative-shadow-dom"?: string[];
+		scoped?: string[];
+		default: "declarative-shadow-dom" | "scoped";
+	} | boolean;
+}
+export interface SerializeDocumentOptions extends HydrateDocumentOptions {
+	/**
+	 * Runs after the `document` has been hydrated.
+	 */
+	afterHydrate?(document: any): any | Promise<any>;
+	/**
+	 * Sets an approximate line width the HTML should attempt to stay within.
+	 * Note that this is "approximate", in that HTML may often not be able
+	 * to be split at an exact line width. Additionally, new lines created
+	 * is where HTML naturally already has whitespace, such as before an
+	 * attribute or spaces between words. Defaults to `100`.
+	 */
+	approximateLineWidth?: number;
+	/**
+	 * Runs before the `document` has been hydrated.
+	 */
+	beforeHydrate?(document: any): any | Promise<any>;
+	/**
+	 * Format the HTML in a nicely indented format.
+	 * Defaults to `false`.
+	 */
+	prettyHtml?: boolean;
+	/**
+	 * Remove quotes from attribute values when possible.
+	 * Defaults to `true`.
+	 */
+	removeAttributeQuotes?: boolean;
+	/**
+	 * Remove the `=""` from standardized `boolean` attributes,
+	 * such as `hidden` or `checked`. Defaults to `true`.
+	 */
+	removeBooleanAttributeQuotes?: boolean;
+	/**
+	 * Remove these standardized attributes when their value is empty:
+	 * `class`, `dir`, `id`, `lang`, and `name`, `title`. Defaults to `true`.
+	 */
+	removeEmptyAttributes?: boolean;
+	/**
+	 * Remove HTML comments. Defaults to `true`.
+	 */
+	removeHtmlComments?: boolean;
+	/**
+	 * The `fullDocument` flag determines the format of the rendered output. Set it to true to
+	 * generate a complete HTML document, or false to render only the component.
+	 * @default true
+	 */
+	fullDocument?: boolean;
+	/**
+	 * Style modes to render the component in.
+	 * @see https://stenciljs.com/docs/styling#style-modes
+	 */
+	modes?: ResolutionHandler[];
+}
+export interface HydrateFactoryOptions extends SerializeDocumentOptions {
+	serializeToHtml: boolean;
+	destroyWindow: boolean;
+	destroyDocument: boolean;
+}
+export interface Diagnostic {
+	absFilePath?: string | undefined;
+	code?: string;
+	columnNumber?: number | undefined;
+	debugText?: string;
+	header?: string;
+	language?: string;
+	level: "error" | "warn" | "info" | "log" | "debug";
+	lineNumber?: number | undefined;
+	lines: PrintLine[];
+	messageText: string;
+	relFilePath?: string | undefined;
+	type: string;
+}
+export interface PrintLine {
+	lineIndex: number;
+	lineNumber: number;
+	text: string;
+	errorCharStart: number;
+	errorLength?: number;
+}
+export interface HydrateResults {
+	buildId: string;
+	diagnostics: Diagnostic[];
+	url: string;
+	host: string | null;
+	hostname: string | null;
+	href: string | null;
+	port: string | null;
+	pathname: string | null;
+	search: string | null;
+	hash: string | null;
+	html: string | null;
+	components: HydrateComponent[];
+	anchors: HydrateAnchorElement[];
+	imgs: HydrateImgElement[];
+	scripts: HydrateScriptElement[];
+	styles: HydrateStyleElement[];
+	staticData: HydrateStaticData[];
+	title: string | null;
+	hydratedCount: number;
+	httpStatus: number | null;
+}
+export interface HydrateComponent {
+	tag: string;
+	mode: string;
+	count: number;
+	depth: number;
+}
+export interface HydrateElement {
+	[attrName: string]: string | undefined;
+}
+export interface HydrateAnchorElement extends HydrateElement {
+	href?: string;
+	target?: string;
+}
+export interface HydrateImgElement extends HydrateElement {
+	src?: string;
+}
+export interface HydrateScriptElement extends HydrateElement {
+	src?: string;
+	type?: string;
+}
+export interface HydrateStyleElement extends HydrateElement {
+	id?: string;
+	href?: string;
+	content?: string;
+}
+export interface HydrateStaticData {
+	id: string;
+	type: string;
+	content: string;
+}
+export declare function streamToString(html: string | any, option?: SerializeDocumentOptions): Readable;
+export declare function renderToString(html: string | any, options?: SerializeDocumentOptions): Promise<HydrateResults>;
+export declare function renderToString(html: string | any, options: SerializeDocumentOptions | undefined, asStream: true): Readable;
+export declare function hydrateDocument(doc: any | string, options?: HydrateDocumentOptions): Promise<HydrateResults>;
+export declare function hydrateDocument(doc: any | string, options: HydrateDocumentOptions | undefined, asStream?: boolean): Readable;
+export declare function serializeDocumentToString(doc: Document, opts: HydrateFactoryOptions): string;
+/**
+ * Transforms a tag name using the current tag transformer
+ * @param tag - the tag to transform e.g. `my-tag`
+ * @returns the transformed tag e.g. `new-my-tag`
+ */
+export declare function transformTag<T extends string>(tag: T): T;
+/**
+ * Sets the tag transformer to be used when rendering custom elements
+ * @param transformer the transformer function to use. Must return a string
+ */
+export declare function setTagTransformer(transformer: TagTransformer): void;
+
+export {};

package/dist/dist/dist/types/components/gov-accordion/constants.d.ts

@@ -0,0 +1,19 @@
+import { Sizes } from '../../core/constants/sizes';
+import { ValueOf } from '../../types/interfaces';
+export declare const AccordionSizes: Pick<typeof Sizes, "_XS" | "_S" | "_M" | "_L" | "_XL">;
+export type AccordionSizeType = `${ValueOf<typeof AccordionSizes>}`;
+export declare const AccordionClass: {
+    root: string;
+};
+export declare const AccordionItemClass: {
+    root: string;
+    disabled: string;
+    details: string;
+    summary: string;
+    icon: string;
+    title: string;
+    suffix: string;
+    right: string;
+    arrow: string;
+    content: string;
+};

package/dist/dist/dist/types/components/gov-accordion/gov-accordion-item.d.ts

@@ -0,0 +1,43 @@
+import { EventEmitter } from "../../stencil-public-runtime";
+import { AccordionSizeType } from "./constants";
+import { AccordionItemEvent } from "./gov-accordion.types";
+export declare class GovAccordionItem {
+    private h;
+    private inheritedAttributes;
+    constructor();
+    readonly host: HTMLGovAccordionItemElement;
+    openState: boolean;
+    /**
+     * Custom accordion item identifier.
+     */
+    readonly identifier: string;
+    /**
+     * Accordion’s size.
+     */
+    size?: AccordionSizeType;
+    /**
+     * Makes the button component disabled.
+     */
+    readonly disabled: boolean;
+    /**
+     * Defines whether the accordion is open or closed by button
+     */
+    open: boolean;
+    /**
+     * Called when the accordion state changes
+     */
+    govChange: EventEmitter<AccordionItemEvent>;
+    validateSize(newValue: string): void;
+    componentWillLoad(): void;
+    componentDidRender(): void;
+    private getPropsFromParents;
+    render(): any;
+    /**
+     * Accordion switch
+     */
+    toggle(): Promise<void>;
+    /**
+     * Returns the current state of the component
+     */
+    currentState(): Promise<boolean>;
+}

package/dist/dist/dist/types/components/gov-accordion/gov-accordion.d.ts

@@ -0,0 +1,26 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+import { AccordionSizeType } from './constants';
+import { AccordionEvent } from "./gov-accordion.types";
+export declare class GovAccordion {
+    private h;
+    private hydrated;
+    constructor();
+    readonly host: HTMLGovAccordionElement;
+    /**
+     * Accordion’s size.
+     */
+    readonly size?: AccordionSizeType;
+    /**
+     * Accordion item underline
+     */
+    readonly noBorder: boolean;
+    /**
+     * Called when the accordion state changes
+     */
+    govChange: EventEmitter<AccordionEvent>;
+    validateSize(newValue: string): void;
+    componentWillLoad(): void;
+    componentDidLoad(): void;
+    connectedCallback(): void;
+    render(): any;
+}

package/dist/dist/dist/types/components/gov-accordion/gov-accordion.types.d.ts

@@ -0,0 +1,9 @@
+import { GovBaseEvent } from "../../types/event.types";
+export interface AccordionItemEvent extends GovBaseEvent {
+    open: boolean;
+    ref: HTMLGovAccordionItemElement;
+}
+export interface AccordionEvent extends GovBaseEvent {
+    open: boolean;
+    ref: HTMLGovAccordionItemElement;
+}

package/dist/dist/dist/types/components/gov-attachments/constants.d.ts

@@ -0,0 +1,11 @@
+export declare const AttachmentsClass: {
+    root: string;
+    label: string;
+    list: string;
+};
+export declare const AttachmentsItemClass: {
+    root: string;
+    name: string;
+    file: string;
+    messages: string;
+};

package/dist/dist/dist/types/components/gov-attachments/gov-attachments-item.d.d.ts

@@ -0,0 +1,4 @@
+export interface GovAttachmentsItemChangeEvent {
+    open: boolean;
+    element: HTMLGovAttachmentsItemElement;
+}

package/dist/dist/dist/types/components/gov-attachments/gov-attachments-item.d.ts

@@ -0,0 +1,24 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+export declare class GovAttachmentsItem {
+    private h;
+    constructor();
+    readonly host: HTMLGovAttachmentsItemElement;
+    /**
+     * Adds accessible label for the remove button that is only shown for screen readers.
+     */
+    readonly accessibleRemoveLabel: string;
+    /**
+     * Indicates the id of a component that labels the remove button.
+     */
+    readonly accessibleRemoveLabelledBy: string;
+    /**
+     * Emitted when the file is removed
+     */
+    govRemove: EventEmitter<PointerEvent>;
+    componentDidRender(): Promise<void>;
+    render(): any;
+    /**
+     * Validate the accessible attributes of the component
+     */
+    validateAccessibility(): Promise<void>;
+}

package/dist/dist/dist/types/components/gov-attachments/gov-attachments.d.ts

@@ -0,0 +1,19 @@
+export declare class GovAttachments {
+    private h;
+    constructor();
+    readonly host: HTMLGovAttachmentsElement;
+    /**
+     * Label of attachments section
+     */
+    readonly label: string;
+    /**
+     * Adds accessible label for the attachment section that is only shown for screen readers.
+     */
+    readonly wcagLabel: string;
+    componentDidRender(): Promise<void>;
+    render(): any;
+    /**
+     * Validate the WCAG attributes of the component
+     */
+    validateWcag(): Promise<void>;
+}

package/dist/dist/dist/types/components/gov-backdrop/constants.d.ts

@@ -0,0 +1,4 @@
+export declare const BackdropClass: {
+    root: string;
+    bg: string;
+};

package/dist/dist/dist/types/components/gov-backdrop/gov-backdrop.d.ts

@@ -0,0 +1,32 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+export declare class GovBackdrop {
+    private h;
+    constructor();
+    host: HTMLGovBackdropElement;
+    /**
+     * Determine if component should have inverse colors to be used on dark background.
+     */
+    readonly inverse: boolean;
+    /**
+     * Makes the backdrop component disabled.
+     */
+    readonly disabled: boolean;
+    /**
+     * Adds accessible label for the backdrop that is only shown for screen readers.
+     */
+    readonly accessibleLabel: string;
+    /**
+     * String of id's that indicate alternative labels elements
+     */
+    readonly accessibleLabelledBy: string;
+    /**
+     * Emitted when button clicks.
+     */
+    govClick: EventEmitter<MouseEvent>;
+    componentDidRender(): Promise<void>;
+    render(): any;
+    /**
+     * Validate the accessibility attributes of the component
+     */
+    validateAccessibility(): Promise<void>;
+}