@types/govuk-frontend 5.8.0 → 5.11.0

govuk-frontend/README.md

@@ -8,8 +8,8 @@ This package contains type definitions for govuk-frontend (https://github.com/al
 Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/govuk-frontend.
 
 ### Additional Details
- * Last updated: Mon, 03 Feb 2025 16:02:40 GMT
+ * Last updated: Fri, 12 Sep 2025 19:02:26 GMT
  * Dependencies: none
 
 # Credits
-These definitions were written by [Colin Rotherham](https://github.com/colinrotherham), and [Romaric Pascal](https://github.com/romaricpascal).
+These definitions were written by [Colin Rotherham](https://github.com/colinrotherham), [Paul Robert Lloyd](https://github.com/paulrobertlloyd), and [Romaric Pascal](https://github.com/romaricpascal).

govuk-frontend/dist/govuk/all.bundle.d.mts

@@ -1,12 +1,14 @@
 export { ConfigurableComponent } from "./common/configuration.mjs";
 export { version } from "./common/govuk-frontend-version.mjs";
 export { isSupported } from "./common/index.mjs";
+export { Component } from "./component.mjs";
 export { Accordion } from "./components/accordion/accordion.mjs";
 export { Button } from "./components/button/button.mjs";
 export { CharacterCount } from "./components/character-count/character-count.mjs";
 export { Checkboxes } from "./components/checkboxes/checkboxes.mjs";
 export { ErrorSummary } from "./components/error-summary/error-summary.mjs";
 export { ExitThisPage } from "./components/exit-this-page/exit-this-page.mjs";
+export { FileUpload } from "./components/file-upload/file-upload.mjs";
 export { Header } from "./components/header/header.mjs";
 export { NotificationBanner } from "./components/notification-banner/notification-banner.mjs";
 export { PasswordInput } from "./components/password-input/password-input.mjs";
@@ -14,5 +16,4 @@ export { Radios } from "./components/radios/radios.mjs";
 export { ServiceNavigation } from "./components/service-navigation/service-navigation.mjs";
 export { SkipLink } from "./components/skip-link/skip-link.mjs";
 export { Tabs } from "./components/tabs/tabs.mjs";
-export { GOVUKFrontendComponent as Component } from "./govuk-frontend-component.mjs";
 export { type Config, type ConfigKey, createAll, initAll } from "./init.mjs";

govuk-frontend/dist/govuk/all.bundle.d.ts

@@ -1,12 +1,14 @@
 import { ConfigurableComponent } from "./common/configuration.js";
 import { version } from "./common/govuk-frontend-version.js";
 import { isSupported } from "./common/index.js";
+import { Component } from "./component.js";
 import { Accordion } from "./components/accordion/accordion.js";
 import { Button } from "./components/button/button.js";
 import { CharacterCount } from "./components/character-count/character-count.js";
 import { Checkboxes } from "./components/checkboxes/checkboxes.js";
 import { ErrorSummary } from "./components/error-summary/error-summary.js";
 import { ExitThisPage } from "./components/exit-this-page/exit-this-page.js";
+import { FileUpload } from "./components/file-upload/file-upload.js";
 import { Header } from "./components/header/header.js";
 import { NotificationBanner } from "./components/notification-banner/notification-banner.js";
 import { PasswordInput } from "./components/password-input/password-input.js";
@@ -14,7 +16,6 @@ import { Radios } from "./components/radios/radios.js";
 import { ServiceNavigation } from "./components/service-navigation/service-navigation.js";
 import { SkipLink } from "./components/skip-link/skip-link.js";
 import { Tabs } from "./components/tabs/tabs.js";
-import { GOVUKFrontendComponent as Component } from "./govuk-frontend-component.js";
 import { type Config as ConfigImport, type ConfigKey as ConfigKeyImport, createAll, initAll } from "./init.js";
 
 declare namespace GOVUKFrontend {
@@ -31,6 +32,7 @@ declare const GOVUKFrontend: {
     Checkboxes: typeof Checkboxes;
     ErrorSummary: typeof ErrorSummary;
     ExitThisPage: typeof ExitThisPage;
+    FileUpload: typeof FileUpload;
     Header: typeof Header;
     NotificationBanner: typeof NotificationBanner;
     PasswordInput: typeof PasswordInput;

govuk-frontend/dist/govuk/common/closest-attribute-value.d.ts

@@ -6,4 +6,7 @@
  * @param {string} attributeName - The name of the attribute
  * @returns {string | null} Attribute value
  */
-export function closestAttributeValue($element: Element, attributeName: string): string | null;
+export function closestAttributeValue(
+    $element: Element,
+    attributeName: string,
+): string | null;

govuk-frontend/dist/govuk/common/configuration.d.ts

@@ -1,4 +1,5 @@
-import { GOVUKFrontendComponent } from "../govuk-frontend-component.js";
+import { Component } from "../component.js";
+import { type CompatibleClass, type Config, type CreateAllOptions, type OnErrorCallback } from "../init.js";
 
 /**
  * Normalise string
@@ -28,18 +29,41 @@ export function normaliseString(
  * optionally expanding nested `i18n.field`
  *
  * @internal
- * @param {{ schema?: Schema<ObjectNested>, moduleName: string }} Component - Component class
+ * @template {Partial<Record<keyof ConfigurationType, unknown>>} ConfigurationType
+ * @template {[keyof ConfigurationType, SchemaProperty | undefined][]} SchemaEntryType
+ * @param {{ schema?: Schema<ConfigurationType>, moduleName: string }} Component - Component class
  * @param {DOMStringMap} dataset - HTML element dataset
  * @returns {ObjectNested} Normalised dataset
  */
-export function normaliseDataset(
+export function normaliseDataset<
+    ConfigurationType extends Partial<Record<keyof ConfigurationType, unknown>>,
+>(
     Component: {
-        schema?: Schema<ObjectNested>;
+        schema?: Schema<ConfigurationType>;
         moduleName: string;
     },
     dataset: DOMStringMap,
 ): ObjectNested;
 
+/**
+ * Normalise options passed to `initAll` or `createAll`
+ *
+ * @internal
+ * @template {CompatibleClass} ComponentClass
+ * @param {Config | CreateAllOptions<ComponentClass> | OnErrorCallback<ComponentClass> | Element | Document | null} [scopeOrOptions] - Scope of the document to search within, initialisation options or error callback function
+ * @returns {CreateAllOptions<ComponentClass>} Normalised options
+ */
+export function normaliseOptions<
+    ComponentClass extends CompatibleClass,
+>(
+    scopeOrOptions?:
+        | Config
+        | CreateAllOptions<ComponentClass>
+        | OnErrorCallback<ComponentClass>
+        | Element
+        | Document
+        | null,
+): CreateAllOptions<ComponentClass>;
 /**
  * Config merging function
  *
@@ -51,9 +75,9 @@ export function normaliseDataset(
  * @returns {{ [key: string]: unknown }} A merged config object
  */
 export function mergeConfigs(
-    ...configObjects: Array<{
+    ...configObjects: {
         [key: string]: unknown;
-    }>
+    }[]
 ): {
     [key: string]: unknown;
 };
@@ -73,13 +97,8 @@ export function mergeConfigs(
  * @returns {string[]} List of validation errors
  */
 export function validateConfig<
-    ConfigurationType extends Partial<
-        Record<keyof ConfigurationType, unknown>
-    >,
->(
-    schema: Schema<ConfigurationType>,
-    config: ConfigurationType,
-): string[];
+    ConfigurationType extends Partial<Record<keyof ConfigurationType, unknown>>,
+>(schema: Schema<ConfigurationType>, config: ConfigurationType): string[];
 
 /**
  * Extracts keys starting with a particular namespace from dataset ('data-*')
@@ -93,9 +112,7 @@ export function validateConfig<
  * @returns {ObjectNested | undefined} Nested object with dot-separated key namespace removed
  */
 export function extractConfigByNamespace<
-    ConfigurationType extends Partial<
-        Record<keyof ConfigurationType, unknown>
-    >,
+    ConfigurationType extends Partial<Record<keyof ConfigurationType, unknown>>,
 >(
     schema: Schema<ConfigurationType>,
     dataset: DOMStringMap,
@@ -109,8 +126,8 @@ export const configOverride: unique symbol;
  *
  * Centralises the behaviours shared by our components
  *
- * @template {Partial<Record<keyof ConfigurationType, unknown>>} [ConfigurationType=ObjectNested]
- * @template {Element & { dataset: DOMStringMap }} [RootElementType=HTMLElement]
+ * @template {Partial<Record<keyof ConfigurationType, unknown>>} ConfigurationType
+ * @template {Element & { dataset: DOMStringMap }} RootElementType
  */
 export abstract class ConfigurableComponent<
     ConfigurationType extends Partial<
@@ -119,7 +136,7 @@ export abstract class ConfigurableComponent<
     RootElementType extends Element & {
         dataset: DOMStringMap;
     } = HTMLElement,
-> extends GOVUKFrontendComponent<RootElementType> {
+> extends Component<RootElementType> {
     /**
      * Constructs a new component, validating that GOV.UK Frontend is supported
      *
@@ -154,7 +171,9 @@ export abstract class ConfigurableComponent<
      * @param {Partial<ConfigurationType>} [param] - Configuration object
      * @returns {Partial<ConfigurationType>} return - Configuration object
      */
-    [configOverride](param?: Partial<ConfigurationType>): Partial<ConfigurationType>;
+    [configOverride](
+        param?: Partial<ConfigurationType>,
+    ): Partial<ConfigurationType>;
 }
 
 export type NestedKey = keyof ObjectNested;
@@ -167,9 +186,7 @@ export interface ObjectNested {
  * Schema for component config
  */
 export interface Schema<
-    ConfigurationType extends Partial<
-        Record<keyof ConfigurationType, unknown>
-    >,
+    ConfigurationType extends Partial<Record<keyof ConfigurationType, unknown>>,
 > {
     /**
      * - Schema properties
@@ -179,7 +196,7 @@ export interface Schema<
     /**
      * - List of schema conditions
      */
-    anyOf?: SchemaCondition[] | undefined;
+    anyOf?: SchemaCondition<ConfigurationType>[] | undefined;
 }
 
 /**
@@ -195,11 +212,13 @@ export interface SchemaProperty {
 /**
  * Schema condition for component config
  */
-export interface SchemaCondition {
+export interface SchemaCondition<
+    ConfigurationType extends Partial<Record<keyof ConfigurationType, unknown>>,
+> {
     /**
      * - List of required config fields
      */
-    required: string[];
+    required: (keyof ConfigurationType)[];
 
     /**
      * - Error message when required config fields not provided

govuk-frontend/dist/govuk/common/index.d.ts

@@ -1,5 +1,3 @@
-import { type ObjectNested } from "./configuration.js";
-
 /**
  * Common helpers which do not require polyfill.
  *
@@ -7,18 +5,6 @@ import { type ObjectNested } from "./configuration.js";
  * so that the polyfill can be properly tree-shaken and does not burden
  * the components that do not need that helper
  */
-
-/**
- * Get hash fragment from URL
- *
- * Extract the hash fragment (everything after the hash) from a URL,
- * but not including the hash symbol
- *
- * @param {string} url - URL
- * @returns {string | undefined} Fragment from URL, without the hash
- */
-export function getFragmentFromUrl(url: string): string | undefined;
-
 /**
  * Get GOV.UK Frontend breakpoint value from CSS custom property
  *
@@ -75,15 +61,25 @@ export function isSupported($scope?: HTMLElement | null): boolean;
  * Check for an object
  *
  * @internal
- * @template {Partial<Record<keyof ObjectType, unknown>>} [ObjectType=ObjectNested]
+ * @template {Partial<Record<keyof ObjectType, unknown>>} ObjectType
  * @param {unknown | ObjectType} option - Option to check
  * @returns {option is ObjectType} Whether the option is an object
  */
 export function isObject<
-    ObjectType extends Partial<Record<keyof ObjectType, unknown>> = ObjectNested,
->(
-    option: unknown,
-): option is ObjectType;
+    ObjectType extends Partial<Record<keyof ObjectType, unknown>>,
+>(option: unknown | ObjectType): option is ObjectType;
+
+/**
+ * Check for valid scope
+ *
+ * @internal
+ * @template {Element | Document} ScopeType
+ * @param {unknown | ScopeType} $scope - Scope of the document to search within
+ * @returns {$scope is ScopeType} Whether the scope can be queried
+ */
+export function isScope<ScopeType extends Element | Document>(
+    $scope: unknown | ScopeType,
+): $scope is ScopeType;
 
 /**
  * Format error message
@@ -93,7 +89,10 @@ export function isObject<
  * @param {string} message - Error message
  * @returns {string} - Formatted error message
  */
-export function formatErrorMessage(Component: ComponentWithModuleName, message: string): string;
+export function formatErrorMessage(
+    Component: ComponentWithModuleName,
+    message: string,
+): string;
 
 export interface ComponentWithModuleName {
     /**

govuk-frontend/dist/govuk/component.d.mts

@@ -0,0 +1 @@
+export * from "./component.js";

govuk-frontend/dist/govuk/{govuk-frontend-component.d.ts → component.d.ts}

@@ -2,8 +2,10 @@
  * Base Component class
  *
  * Centralises the behaviours shared by our components
+ *
+ * @template {Element} [RootElementType=HTMLElement]
  */
-export abstract class GOVUKFrontendComponent<RootElementType extends Element = HTMLElement> {
+export abstract class Component<RootElementType extends Element = HTMLElement> {
     static elementType: typeof Element;
 
     /**

govuk-frontend/dist/govuk/components/accordion/accordion.d.ts

@@ -12,7 +12,10 @@ import { ConfigurableComponent } from "../../common/configuration.js";
  * The state of each section is saved to the DOM via the `aria-expanded`
  * attribute, which also provides accessibility.
  */
-export class Accordion extends ConfigurableComponent<AccordionConfig, HTMLElement> {
+export class Accordion extends ConfigurableComponent<
+    AccordionConfig,
+    HTMLElement
+> {
     /**
      * Name for the component used when initialising using data-module attributes.
      */
@@ -22,13 +25,15 @@ export class Accordion extends ConfigurableComponent<AccordionConfig, HTMLElemen
      * Accordion default config
      *
      * @see {@link AccordionConfig}
+     * @constant
      */
     static defaults: AccordionConfig;
 
     /**
      * Accordion config schema
      *
-     * @satisfies {Schema}
+     * @constant
+     * @satisfies {Schema<AccordionConfig>}
      */
     static schema: Readonly<{
         properties: {

govuk-frontend/dist/govuk/components/button/button.d.ts

@@ -13,13 +13,15 @@ export class Button extends ConfigurableComponent<ButtonConfig, HTMLElement> {
      * Button default config
      *
      * @see {@link ButtonConfig}
+     * @constant
      */
     static defaults: ButtonConfig;
 
     /**
      * Button config schema
      *
-     * @satisfies {Schema}
+     * @constant
+     * @satisfies {Schema<ButtonConfig>}
      */
     static schema: Readonly<{
         properties: {

govuk-frontend/dist/govuk/components/character-count/character-count.d.ts

@@ -11,7 +11,10 @@ import { type TranslationPluralForms } from "../../i18n.js";
  * You can configure the message to only appear after a certain percentage
  * of the available characters/words has been entered.
  */
-export class CharacterCount extends ConfigurableComponent<CharacterCountConfig, HTMLElement> {
+export class CharacterCount extends ConfigurableComponent<
+    CharacterCountConfig,
+    HTMLElement
+> {
     /**
      * Name for the component used when initialising using data-module attributes.
      */
@@ -21,13 +24,15 @@ export class CharacterCount extends ConfigurableComponent<CharacterCountConfig,
      * Character count default config
      *
      * @see {@link CharacterCountConfig}
+     * @constant
      */
     static defaults: CharacterCountConfig;
 
     /**
      * Character count config schema
      *
-     * @satisfies {Schema}
+     * @constant
+     * @satisfies {Schema<CharacterCountConfig>}
      */
     static schema: Readonly<{
         properties: {
@@ -44,10 +49,16 @@ export class CharacterCount extends ConfigurableComponent<CharacterCountConfig,
                 type: "number";
             };
         };
-        anyOf: Array<{
-            required: string[];
-            errorMessage: string;
-        }>;
+        anyOf: (
+            | {
+                required: "maxwords"[];
+                errorMessage: string;
+            }
+            | {
+                required: "maxlength"[];
+                errorMessage: string;
+            }
+        )[];
     }>;
 
     /**

govuk-frontend/dist/govuk/components/checkboxes/checkboxes.d.ts

@@ -1,9 +1,9 @@
-import { GOVUKFrontendComponent } from "../../govuk-frontend-component.js";
+import { Component } from "../../component.js";
 
 /**
  * Checkboxes component
  */
-export class Checkboxes extends GOVUKFrontendComponent<HTMLElement> {
+export class Checkboxes extends Component<HTMLElement> {
     /**
      * Name for the component used when initialising using data-module attributes.
      */

govuk-frontend/dist/govuk/components/error-summary/error-summary.d.ts

@@ -6,7 +6,10 @@ import { ConfigurableComponent } from "../../common/configuration.js";
  * Takes focus on initialisation for accessible announcement, unless disabled in
  * configuration.
  */
-export class ErrorSummary extends ConfigurableComponent<ErrorSummaryConfig, HTMLElement> {
+export class ErrorSummary extends ConfigurableComponent<
+    ErrorSummaryConfig,
+    HTMLElement
+> {
     /**
      * Name for the component used when initialising using data-module attributes.
      */
@@ -16,13 +19,15 @@ export class ErrorSummary extends ConfigurableComponent<ErrorSummaryConfig, HTML
      * Error summary default config
      *
      * @see {@link ErrorSummaryConfig}
+     * @constant
      */
     static defaults: ErrorSummaryConfig;
 
     /**
      * Error summary config schema
      *
-     * @satisfies {Schema}
+     * @constant
+     * @satisfies {Schema<ErrorSummaryConfig>}
      */
     static schema: Readonly<{
         properties: {
@@ -47,5 +52,5 @@ export interface ErrorSummaryConfig {
      * - If set to `true` the error
      * summary will not be focussed when the page loads.
      */
-    disableAutoFocus?: boolean;
+    disableAutoFocus?: boolean | undefined;
 }

govuk-frontend/dist/govuk/components/exit-this-page/exit-this-page.d.ts

@@ -3,7 +3,10 @@ import { ConfigurableComponent } from "../../common/configuration.js";
 /**
  * Exit this page component
  */
-export class ExitThisPage extends ConfigurableComponent<ExitThisPageConfig, HTMLElement> {
+export class ExitThisPage extends ConfigurableComponent<
+    ExitThisPageConfig,
+    HTMLElement
+> {
     /**
      * Name for the component used when initialising using data-module attributes.
      */
@@ -13,13 +16,15 @@ export class ExitThisPage extends ConfigurableComponent<ExitThisPageConfig, HTML
      * Exit this page default config
      *
      * @see {@link ExitThisPageConfig}
+     * @constant
      */
     static defaults: ExitThisPageConfig;
 
     /**
      * Exit this page config schema
      *
-     * @satisfies {Schema}
+     * @constant
+     * @satisfies {Schema<ExitThisPageConfig>}
      */
     static schema: Readonly<{
         properties: {

govuk-frontend/dist/govuk/components/file-upload/file-upload.d.mts

@@ -0,0 +1 @@
+export * from "./file-upload.js";

govuk-frontend/dist/govuk/components/file-upload/file-upload.d.ts

@@ -0,0 +1,95 @@
+import { ConfigurableComponent } from "../../common/configuration.js";
+import { type TranslationPluralForms } from "../../i18n.js";
+
+/**
+ * File upload component
+ */
+export class FileUpload extends ConfigurableComponent<
+    FileUploadConfig,
+    HTMLElement
+> {
+    /**
+     * Name for the component used when initialising using data-module attributes.
+     */
+    static moduleName: string;
+
+    /**
+     * File upload default config
+     *
+     * @see {@link FileUploadConfig}
+     * @constant
+     */
+    static defaults: FileUploadConfig;
+
+    /**
+     * File upload config schema
+     *
+     * @constant
+     * @satisfies {Schema<FileUploadConfig>}
+     */
+    static schema: Readonly<{
+        properties: {
+            i18n: {
+                type: "object";
+            };
+        };
+    }>;
+
+    /**
+     * @param {Element | null} $root - File input element
+     * @param {FileUploadConfig} [config] - File Upload config
+     */
+    constructor($root: Element | null, config?: FileUploadConfig);
+}
+
+export type HTMLFileInputElement = HTMLInputElement & {
+    files: FileList;
+};
+
+/**
+ * File upload config
+ */
+export interface FileUploadConfig {
+    /**
+     * - File upload translations
+     */
+    i18n?: FileUploadTranslations | undefined;
+}
+
+/**
+ * Messages used by the component
+ */
+export interface FileUploadTranslations {
+    /**
+     * - The text of the button that opens the file picker
+     */
+    chooseFile?: string | undefined;
+
+    /**
+     * - The text informing users they can drop files
+     */
+    dropInstruction?: string | undefined;
+
+    /**
+     * - The text displayed when multiple files
+     * have been chosen by the user
+     */
+    multipleFilesChosen?: TranslationPluralForms | undefined;
+
+    /**
+     * - The text to displayed when no file has been chosen by the user
+     */
+    noFileChosen?: string | undefined;
+
+    /**
+     * - The text announced by assistive technology
+     * when user drags files and enters the drop zone
+     */
+    enteredDropZone?: string | undefined;
+
+    /**
+     * - The text announced by assistive technology
+     * when user drags files and leaves the drop zone without dropping
+     */
+    leftDropZone?: string | undefined;
+}

govuk-frontend/dist/govuk/components/header/header.d.ts

@@ -1,9 +1,9 @@
-import { GOVUKFrontendComponent } from "../../govuk-frontend-component.js";
+import { Component } from "../../component.js";
 
 /**
  * Header component
  */
-export class Header extends GOVUKFrontendComponent<HTMLElement> {
+export class Header extends Component<HTMLElement> {
     /**
      * Name for the component used when initialising using data-module attributes.
      */

govuk-frontend/dist/govuk/components/notification-banner/notification-banner.d.ts

@@ -3,7 +3,10 @@ import { ConfigurableComponent } from "../../common/configuration.js";
 /**
  * Notification Banner component
  */
-export class NotificationBanner extends ConfigurableComponent<NotificationBannerConfig, HTMLElement> {
+export class NotificationBanner extends ConfigurableComponent<
+    NotificationBannerConfig,
+    HTMLElement
+> {
     /**
      * Name for the component used when initialising using data-module attributes.
      */
@@ -13,13 +16,15 @@ export class NotificationBanner extends ConfigurableComponent<NotificationBanner
      * Notification banner default config
      *
      * @see {@link NotificationBannerConfig}
+     * @constant
      */
     static defaults: NotificationBannerConfig;
 
     /**
      * Notification banner config schema
      *
-     * @satisfies {Schema}
+     * @constant
+     * @satisfies {Schema<NotificationBannerConfig>}
      */
     static schema: Readonly<{
         properties: {

govuk-frontend/dist/govuk/components/password-input/password-input.d.ts

@@ -3,7 +3,10 @@ import { ConfigurableComponent } from "../../common/configuration.js";
 /**
  * Password input component
  */
-export class PasswordInput extends ConfigurableComponent<PasswordInputConfig, HTMLElement> {
+export class PasswordInput extends ConfigurableComponent<
+    PasswordInputConfig,
+    HTMLElement
+> {
     /**
      * Name for the component used when initialising using data-module attributes.
      */
@@ -13,13 +16,16 @@ export class PasswordInput extends ConfigurableComponent<PasswordInputConfig, HT
      * Password input default config
      *
      * @see {@link PasswordInputConfig}
+     * @constant
+     * @default
      */
     static defaults: PasswordInputConfig;
 
     /**
      * Password input config schema
      *
-     * @satisfies {Schema}
+     * @constant
+     * @satisfies {Schema<PasswordInputConfig>}
      */
     static schema: Readonly<{
         properties: {

govuk-frontend/dist/govuk/components/radios/radios.d.ts

@@ -1,9 +1,9 @@
-import { GOVUKFrontendComponent } from "../../govuk-frontend-component.js";
+import { Component } from "../../component.js";
 
 /**
  * Radios component
  */
-export class Radios extends GOVUKFrontendComponent<HTMLElement> {
+export class Radios extends Component<HTMLElement> {
     /**
      * Name for the component used when initialising using data-module attributes.
      */

govuk-frontend/dist/govuk/components/service-navigation/service-navigation.d.ts

@@ -1,9 +1,9 @@
-import { GOVUKFrontendComponent } from "../../govuk-frontend-component.js";
+import { Component } from "../../component.js";
 
 /**
  * Service Navigation component
  */
-export class ServiceNavigation extends GOVUKFrontendComponent<HTMLElement> {
+export class ServiceNavigation extends Component<HTMLElement> {
     /**
      * Name for the component used when initialising using data-module attributes.
      */

govuk-frontend/dist/govuk/components/skip-link/skip-link.d.ts

@@ -1,9 +1,9 @@
-import { GOVUKFrontendComponent } from "../../govuk-frontend-component.js";
+import { Component } from "../../component.js";
 
 /**
  * Skip link component
  */
-export class SkipLink extends GOVUKFrontendComponent<HTMLAnchorElement> {
+export class SkipLink extends Component<HTMLAnchorElement> {
     static elementType: {
         new(): HTMLAnchorElement;
         prototype: HTMLAnchorElement;

govuk-frontend/dist/govuk/components/tabs/tabs.d.ts

@@ -1,9 +1,9 @@
-import { GOVUKFrontendComponent } from "../../govuk-frontend-component.js";
+import { Component } from "../../component.js";
 
 /**
  * Tabs component
  */
-export class Tabs extends GOVUKFrontendComponent<HTMLElement> {
+export class Tabs extends Component<HTMLElement> {
     /**
      * Name for the component used when initialising using data-module attributes.
      */

govuk-frontend/dist/govuk/errors/index.d.ts

@@ -19,8 +19,7 @@ import { type ComponentWithModuleName } from "../common/index.js";
  * }
  * ```
  */
-export abstract class GOVUKFrontendError extends Error {
-}
+export abstract class GOVUKFrontendError extends Error {}
 
 /**
  * Indicates that GOV.UK Frontend is not supported
@@ -37,8 +36,7 @@ export class SupportError extends GOVUKFrontendError {
 /**
  * Indicates that a component has received an illegal configuration
  */
-export class ConfigError extends GOVUKFrontendError {
-}
+export class ConfigError extends GOVUKFrontendError {}
 
 /**
  * Indicates an issue with an element (possibly `null` or `undefined`)
@@ -75,22 +73,22 @@ export class InitError extends GOVUKFrontendError {
  */
 export interface ElementErrorOptions {
     /**
-     * - An identifier that'll let the user understand which element has an error. This is whatever makes the most sense
+     * - The element in error (optional)
      */
-    identifier: string;
+    element?: Document | Element | null | undefined;
 
     /**
-     * - The element in error
+     * - Component throwing the error (optional)
      */
-    element?: Element | null | undefined;
+    component?: ComponentWithModuleName | undefined;
 
     /**
-     * - The type that was expected for the identifier
+     * - An identifier that'll let the user understand which element has an error. This is whatever makes the most sense
      */
-    expectedType?: string | undefined;
+    identifier: string;
 
     /**
-     * - Component throwing the error
+     * - The type that was expected for the identifier (optional)
      */
-    component: ComponentWithModuleName;
+    expectedType?: string | undefined;
 }

govuk-frontend/dist/govuk/i18n.d.ts

@@ -104,9 +104,12 @@ export class I18n {
      * @param {{ [key: string]: unknown }} options - Any options passed with the translation string, e.g: for string interpolation.
      * @returns {string} The translation string to output, with $\{\} placeholders replaced
      */
-    replacePlaceholders(translationString: string, options: {
-        [key: string]: unknown;
-    }): string;
+    replacePlaceholders(
+        translationString: string,
+        options: {
+            [key: string]: unknown;
+        },
+    ): string;
 
     /**
      * Check to see if the browser supports Intl.PluralRules

govuk-frontend/dist/govuk/init.d.ts

@@ -1,10 +1,14 @@
-import { type AccordionConfig } from "./components/accordion/accordion.js";
-import { type ButtonConfig } from "./components/button/button.js";
-import { type CharacterCountConfig } from "./components/character-count/character-count.js";
-import { type ErrorSummaryConfig } from "./components/error-summary/error-summary.js";
-import { type ExitThisPageConfig } from "./components/exit-this-page/exit-this-page.js";
-import { type NotificationBannerConfig } from "./components/notification-banner/notification-banner.js";
-import { type PasswordInputConfig } from "./components/password-input/password-input.js";
+import { Accordion, type AccordionConfig } from "./components/accordion/accordion.js";
+import { Button, type ButtonConfig } from "./components/button/button.js";
+import { CharacterCount, type CharacterCountConfig } from "./components/character-count/character-count.js";
+import { ErrorSummary, type ErrorSummaryConfig } from "./components/error-summary/error-summary.js";
+import { ExitThisPage, type ExitThisPageConfig } from "./components/exit-this-page/exit-this-page.js";
+import { FileUpload, type FileUploadConfig } from "./components/file-upload/file-upload.js";
+import {
+    NotificationBanner,
+    type NotificationBannerConfig,
+} from "./components/notification-banner/notification-banner.js";
+import { PasswordInput, type PasswordInputConfig } from "./components/password-input/password-input.js";
 
 export interface CompatibleClass {
     new(...args: any[]): any;
@@ -15,6 +19,28 @@ export interface CompatibleClass {
  * Config for all components via `initAll()`
  */
 export interface Config {
+    /**
+     * - Scope of the document to search within
+     */
+    scope?: Document | Element | null | undefined;
+
+    /**
+     * - Initialisation error callback
+     */
+    onError?:
+        | OnErrorCallback<
+            | typeof Accordion
+            | typeof Button
+            | typeof CharacterCount
+            | typeof ErrorSummary
+            | typeof ExitThisPage
+            | typeof FileUpload
+            | typeof NotificationBanner
+            | typeof PasswordInput
+            | undefined
+        >
+        | undefined;
+
     /**
      * - Accordion config
      */
@@ -40,6 +66,11 @@ export interface Config {
      */
     exitThisPage?: ExitThisPageConfig | undefined;
 
+    /**
+     * - File Upload config
+     */
+    fileUpload?: FileUploadConfig | undefined;
+
     /**
      * - Notification Banner config
      */
@@ -54,15 +85,18 @@ export interface Config {
 /**
  * Component config keys, e.g. `accordion` and `characterCount`
  */
-export type ConfigKey = keyof Config;
+export type ConfigKey = keyof Omit<Config, "scope" | "onError">;
 
 export type ComponentConfig<ComponentClass extends CompatibleClass> = ConstructorParameters<ComponentClass>[1];
 
-export interface ErrorContext<ComponentClass extends CompatibleClass> {
+export interface ErrorContext<
+    ComponentClass extends CompatibleClass | undefined = undefined,
+> {
     /**
      * - Element used for component module initialisation
      */
-    element?: Element | undefined;
+    element?: ComponentClass extends CompatibleClass ? Element
+        : undefined;
 
     /**
      * - Class of component
@@ -70,12 +104,15 @@ export interface ErrorContext<ComponentClass extends CompatibleClass> {
     component?: ComponentClass | undefined;
 
     /**
-     * - Config supplied to component
+     * - Config supplied to components
      */
-    config: ComponentConfig<ComponentClass>;
+    config?: ComponentClass extends CompatibleClass ? ComponentConfig<ComponentClass>
+        : Config;
 }
 
-export type OnErrorCallback<ComponentClass extends CompatibleClass> = (
+export type OnErrorCallback<
+    ComponentClass extends CompatibleClass | undefined = undefined,
+> = (
     error: unknown,
     context: ErrorContext<ComponentClass>,
 ) => any;
@@ -84,7 +121,7 @@ export interface CreateAllOptions<ComponentClass extends CompatibleClass> {
     /**
      * - scope of the document to search within
      */
-    scope?: Document | Element | undefined;
+    scope?: Document | Element | null | undefined;
 
     /**
      * - callback function if error throw by component on init
@@ -98,13 +135,10 @@ export interface CreateAllOptions<ComponentClass extends CompatibleClass> {
  * Use the `data-module` attributes to find, instantiate and init all of the
  * components provided as part of GOV.UK Frontend.
  *
- * @param {Config & { scope?: Element, onError?: OnErrorCallback<CompatibleClass> }} [config] - Config for all components (with optional scope)
+ * @param {Config | Element | Document | null} [scopeOrConfig] - Scope of the document to search within or config for all components (with optional scope)
  */
 export function initAll(
-    config?: Config & {
-        scope?: Element;
-        onError?: OnErrorCallback<CompatibleClass>;
-    },
+    scopeOrConfig?: Config | Element | Document | null,
 ): void;
 
 /**
@@ -119,11 +153,16 @@ export function initAll(
  * @template {CompatibleClass} ComponentClass
  * @param {ComponentClass} Component - class of the component to create
  * @param {ComponentConfig<ComponentClass>} [config] - Config supplied to component
- * @param {OnErrorCallback<ComponentClass> | Element | Document | CreateAllOptions<ComponentClass> } [createAllOptions] - options for createAll including scope of the document to search within and callback function if error throw by component on init
+ * @param {OnErrorCallback<ComponentClass> | Element | Document | null | CreateAllOptions<ComponentClass>} [scopeOrOptions] - options for createAll including scope of the document to search within and callback function if error throw by component on init
  * @returns {Array<InstanceType<ComponentClass>>} - array of instantiated components
  */
 export function createAll<ComponentClass extends CompatibleClass>(
     Component: ComponentClass,
     config?: ComponentConfig<ComponentClass>,
-    createAllOptions?: OnErrorCallback<ComponentClass> | Element | Document | CreateAllOptions<ComponentClass>,
+    scopeOrOptions?:
+        | OnErrorCallback<ComponentClass>
+        | Element
+        | Document
+        | null
+        | CreateAllOptions<ComponentClass>,
 ): Array<InstanceType<ComponentClass>>;

govuk-frontend/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/govuk-frontend",
-    "version": "5.8.0",
+    "version": "5.11.0",
     "description": "TypeScript definitions for govuk-frontend",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/govuk-frontend",
     "license": "MIT",
@@ -10,6 +10,11 @@
             "githubUsername": "colinrotherham",
             "url": "https://github.com/colinrotherham"
         },
+        {
+            "name": "Paul Robert Lloyd",
+            "githubUsername": "paulrobertlloyd",
+            "url": "https://github.com/paulrobertlloyd"
+        },
         {
             "name": "Romaric Pascal",
             "githubUsername": "romaricpascal",
@@ -33,6 +38,6 @@
     "scripts": {},
     "dependencies": {},
     "peerDependencies": {},
-    "typesPublisherContentHash": "3df1d321f714ae24feef605eab0f6302b12f0717613036605b5de394fb136253",
-    "typeScriptVersion": "5.0"
+    "typesPublisherContentHash": "33f390f9de3c3dfe7ef78c5fee7171a541a00aeecaedc5460d56c20acb614a45",
+    "typeScriptVersion": "5.2"
 }

govuk-frontend/dist/govuk/govuk-frontend-component.d.mts

@@ -1 +0,0 @@
-export * from "./govuk-frontend-component.js";