udp-stencil-component-library 25.18.1 → 25.18.2-beta.10

package/dist/types/components.d.ts

@@ -7,13 +7,13 @@
 import { HTMLStencilElement, JSXBase } from "./stencil-public-runtime";
 import { AdvancedFilterConfig, Field } from "./components/advanced-search-builder/models";
 import { Search } from "./udp-utilities/interfaces/searchObject";
-import { FilterGroup } from "./components/advanced-search/types";
+import { LegacyFilterGroup } from "./components/advanced-search/types";
 import { ColDef, GridApi, GridOptions, IServerSideDatasource } from "ag-grid-community-v33";
 import { GridApiMethods, GridHeaderCustomAction, HeaderConfig } from "./components/grid/new-grid/interfaces/grid";
 import { GridFunctionConfig } from "./components/grid/new-grid/interfaces/gridFunction";
 import { GridOptions as GridOptions1 } from "ag-grid-enterprise";
 import { RenderConfig } from "./components/grid/ambient-template-grid/interfaces/gridInterfaces";
-import { FontOverrides, Guid, UdpFormQuestion } from "./components/forms/udp-forms/utils/types";
+import { FontOverrides, Guid, UdpFormQuestion } from "./components/forms/udp-forms/udp-forms-utils/types";
 import { UdpDriveFile } from "./global/types";
 import { InputMargin, InputSize } from "./components/inputs/input-types";
 import { GridFunctionConfig as GridFunctionConfig1, GridHeaderCustomAction as GridHeaderCustomAction1 } from "./components.d";
@@ -21,8 +21,8 @@ import { FormApi } from "final-form";
 import { AttachmentItem } from "./components/attachment-list/type";
 import { Event, VNode } from "./stencil-public-runtime";
 import { Guid as Guid1 } from "./global/types";
-import { UdpForm } from "./components/forms/udp-forms/utils/classes/UdpForm";
-import { UdpFormSubmission } from "./components/forms/udp-forms/utils/classes/UdpFormSubmission";
+import { UdpForm } from "./components/forms/udp-forms/udp-forms-utils/classes/UdpForm";
+import { UdpFormSubmission } from "./components/forms/udp-forms/udp-forms-utils/classes/UdpFormSubmission";
 import { KPICardActionType, KPICardColor, KPICardData } from "./components/data-display/kpi/types";
 import { SecondaryButton } from "./components/drawers/udp-side-sheet/types";
 import { LabelDisplayMode, LabelPosition, Steps } from "./components/stepper/types";
@@ -30,13 +30,13 @@ import { XYMultiSeriesSeriesProps, XYMultiSeriesXAxisProps, XYMultiSeriesYAxisPr
 import { TypographyColor, TypographyVariant } from "./components/unity-typography/types";
 export { AdvancedFilterConfig, Field } from "./components/advanced-search-builder/models";
 export { Search } from "./udp-utilities/interfaces/searchObject";
-export { FilterGroup } from "./components/advanced-search/types";
+export { LegacyFilterGroup } from "./components/advanced-search/types";
 export { ColDef, GridApi, GridOptions, IServerSideDatasource } from "ag-grid-community-v33";
 export { GridApiMethods, GridHeaderCustomAction, HeaderConfig } from "./components/grid/new-grid/interfaces/grid";
 export { GridFunctionConfig } from "./components/grid/new-grid/interfaces/gridFunction";
 export { GridOptions as GridOptions1 } from "ag-grid-enterprise";
 export { RenderConfig } from "./components/grid/ambient-template-grid/interfaces/gridInterfaces";
-export { FontOverrides, Guid, UdpFormQuestion } from "./components/forms/udp-forms/utils/types";
+export { FontOverrides, Guid, UdpFormQuestion } from "./components/forms/udp-forms/udp-forms-utils/types";
 export { UdpDriveFile } from "./global/types";
 export { InputMargin, InputSize } from "./components/inputs/input-types";
 export { GridFunctionConfig as GridFunctionConfig1, GridHeaderCustomAction as GridHeaderCustomAction1 } from "./components.d";
@@ -44,8 +44,8 @@ export { FormApi } from "final-form";
 export { AttachmentItem } from "./components/attachment-list/type";
 export { Event, VNode } from "./stencil-public-runtime";
 export { Guid as Guid1 } from "./global/types";
-export { UdpForm } from "./components/forms/udp-forms/utils/classes/UdpForm";
-export { UdpFormSubmission } from "./components/forms/udp-forms/utils/classes/UdpFormSubmission";
+export { UdpForm } from "./components/forms/udp-forms/udp-forms-utils/classes/UdpForm";
+export { UdpFormSubmission } from "./components/forms/udp-forms/udp-forms-utils/classes/UdpFormSubmission";
 export { KPICardActionType, KPICardColor, KPICardData } from "./components/data-display/kpi/types";
 export { SecondaryButton } from "./components/drawers/udp-side-sheet/types";
 export { LabelDisplayMode, LabelPosition, Steps } from "./components/stepper/types";
@@ -139,12 +139,12 @@ export namespace Components {
         /**
           * @default []
          */
-        "filterObjectsWithGroups": FilterGroup[];
+        "filterObjectsWithGroups": LegacyFilterGroup[];
         /**
           * @default []
          */
         "filterRenderList": any[];
-        "findGroupById": (groups: FilterGroup[], id: string) => FilterGroup | null;
+        "findGroupById": (groups: LegacyFilterGroup[], id: string) => LegacyFilterGroup | null;
         "fullClearSearch": () => void;
         "getHeaderFieldLabel": (fieldName: string) => string;
         "getLogicalOperatorCode": (logicalOperator: 'AND' | 'OR') => number;
@@ -943,6 +943,60 @@ export namespace Components {
         "title": string;
         "titleId": string;
     }
+    /**
+     * A small display-only component for showing read-only form metadata.
+     * Intended usage:
+     * - Rendered near the top or bottom of a form submission view
+     * - Pure presentational output based on props (no internal state, no events)
+     * Layout:
+     * - Uses a simple "label + value" row pattern for consistent alignment
+     * - Hides rows when the corresponding value is missing or the display flag is false
+     * @example ```tsx
+     * <form-metadata-display
+     *   userDisplayName="Ada Lovelace"
+     *   userEmail="ada@example.com"
+     *   submittedOn={new Date()}
+     * />
+     * ```
+     */
+    interface FormMetadataDisplay {
+        /**
+          * Toggles rendering of the "Email" row. Defaults to true.
+          * @default true
+         */
+        "displayOwnerEmail": boolean;
+        /**
+          * Toggles rendering of the "Name" row. Defaults to true.
+          * @default true
+         */
+        "displayOwnerFullName": boolean;
+        /**
+          * Toggles rendering of the "Submitted on" row. Defaults to true.
+          * @default true
+         */
+        "displaySubmissionDate": boolean;
+        /**
+          * Submission timestamp. Row is only rendered when `displaySubmissionDate` is true and this value is non-null.
+         */
+        "submittedOn": string | null;
+        /**
+          * Full name (or display name) of the form owner/submitter. Row is only rendered when `displayOwnerFullName` is true and this value is non-empty.
+         */
+        "userDisplayName": string;
+        /**
+          * Email of the form owner/submitter. Row is only rendered when `displayOwnerEmail` is true and this value is non-empty.
+         */
+        "userEmail": string;
+    }
+    interface FormMetadataDisplayRenderer {
+        "formSectionsDraft": any[][];
+        "getHandler": (fieldTypeId: number, handlerName: string) => any;
+        "isViewOnly": boolean;
+        "onFormSectionsDraftChange": (updatedSections: any[][]) => void;
+        "qIndex": number;
+        "question": UdpFormQuestion;
+        "sIndex": number;
+    }
     interface GhostRender {
     }
     interface GridHeader {
@@ -3597,7 +3651,7 @@ export namespace Components {
         "formsBuilderUrlPath": string;
         "history": { push: (path: string) => void };
         /**
-          * @default false
+          * @default true
          */
         "isCommentingConfigOn": boolean;
         /**
@@ -3712,9 +3766,6 @@ export namespace Components {
         "closeSnackbar": Function;
         "enqueueSnackbar": Function;
         "formId"?: Guid | null;
-        "generic1": any;
-        "generic2": any;
-        "generic3": any;
         "getUserCallback"?: Function;
         "history": any;
         /**
@@ -3723,9 +3774,21 @@ export namespace Components {
         "isPublic": boolean;
         "submissionId"?: Guid | null;
         "triggerAction": (actionId: Guid, params: Object) => void;
+        /**
+          * @default {}
+         */
+        "urlContext": Record<string, any>;
         "version"?: number | null;
     }
     interface UdpFormsUi {
+        /**
+          * @default {     id: null,     displayName: null,     email: null,   }
+         */
+        "clientUserInfo": { id: string | null; displayName: string | null; email: string | null };
+        /**
+          * @default {}
+         */
+        "currentValues": { [name: string]: any };
         "deleteRepeatableSection": any;
         /**
           * @default false
@@ -3738,14 +3801,6 @@ export namespace Components {
         "handleFinish": () => void;
         "handleSave": (values: { [name: string]: any }) => Promise<void>;
         "handleSubmit": (values: any) => Promise<void>;
-        /**
-          * @default {}
-         */
-        "initialValues": { [name: string]: any };
-        /**
-          * @default false
-         */
-        "isCommentAllowed": boolean;
         /**
           * @default false
          */
@@ -3781,10 +3836,6 @@ export namespace Components {
         "submitSuccessful": boolean;
         "udpForm": UdpForm;
         "udpFormSubmission": UdpFormSubmission;
-        /**
-          * @default null
-         */
-        "userId": Guid | null;
     }
     /**
      * @deprecated This component is deprecated and will be removed in a future version.
@@ -4524,17 +4575,17 @@ export namespace Components {
     }
     interface UdpQuestion {
         /**
-          * @default false
+          * @default {     id: null,     displayName: null,     email: null,   }
          */
-        "disabled": boolean;
+        "clientUserInfo": { id: string | null; displayName: string | null; email: string | null };
         /**
           * @default {}
          */
-        "initialValues": { [name: string]: any };
+        "currentValues": { [name: string]: any };
         /**
           * @default false
          */
-        "isCommentAllowed": boolean;
+        "disabled": boolean;
         "question": UdpFormQuestion;
         "questionNumber": number;
         /**
@@ -4549,7 +4600,7 @@ export namespace Components {
         /**
           * @default null
          */
-        "userId": Guid | null;
+        "udpFormSubmission": UdpFormSubmission;
         "value": string;
     }
     interface UdpQuestionComments {
@@ -4560,7 +4611,7 @@ export namespace Components {
         /**
           * @default {}
          */
-        "initialValues": { [name: string]: any };
+        "currentValues": { [name: string]: any };
         "question": UdpFormQuestion;
         /**
           * @default null
@@ -5980,6 +6031,34 @@ declare global {
         prototype: HTMLFluentDialogElement;
         new (): HTMLFluentDialogElement;
     };
+    /**
+     * A small display-only component for showing read-only form metadata.
+     * Intended usage:
+     * - Rendered near the top or bottom of a form submission view
+     * - Pure presentational output based on props (no internal state, no events)
+     * Layout:
+     * - Uses a simple "label + value" row pattern for consistent alignment
+     * - Hides rows when the corresponding value is missing or the display flag is false
+     * @example ```tsx
+     * <form-metadata-display
+     *   userDisplayName="Ada Lovelace"
+     *   userEmail="ada@example.com"
+     *   submittedOn={new Date()}
+     * />
+     * ```
+     */
+    interface HTMLFormMetadataDisplayElement extends Components.FormMetadataDisplay, HTMLStencilElement {
+    }
+    var HTMLFormMetadataDisplayElement: {
+        prototype: HTMLFormMetadataDisplayElement;
+        new (): HTMLFormMetadataDisplayElement;
+    };
+    interface HTMLFormMetadataDisplayRendererElement extends Components.FormMetadataDisplayRenderer, HTMLStencilElement {
+    }
+    var HTMLFormMetadataDisplayRendererElement: {
+        prototype: HTMLFormMetadataDisplayRendererElement;
+        new (): HTMLFormMetadataDisplayRendererElement;
+    };
     interface HTMLGhostRenderElement extends Components.GhostRender, HTMLStencilElement {
     }
     var HTMLGhostRenderElement: {
@@ -7733,6 +7812,8 @@ declare global {
         "filter-conditions": HTMLFilterConditionsElement;
         "filter-group": HTMLFilterGroupElement;
         "fluent-dialog": HTMLFluentDialogElement;
+        "form-metadata-display": HTMLFormMetadataDisplayElement;
+        "form-metadata-display-renderer": HTMLFormMetadataDisplayRendererElement;
         "ghost-render": HTMLGhostRenderElement;
         "grid-header": HTMLGridHeaderElement;
         "grid-primary-bar": HTMLGridPrimaryBarElement;
@@ -7972,12 +8053,12 @@ declare namespace LocalJSX {
         /**
           * @default []
          */
-        "filterObjectsWithGroups"?: FilterGroup[];
+        "filterObjectsWithGroups"?: LegacyFilterGroup[];
         /**
           * @default []
          */
         "filterRenderList"?: any[];
-        "findGroupById"?: (groups: FilterGroup[], id: string) => FilterGroup | null;
+        "findGroupById"?: (groups: LegacyFilterGroup[], id: string) => LegacyFilterGroup | null;
         "fullClearSearch"?: () => void;
         "getHeaderFieldLabel"?: (fieldName: string) => string;
         "getLogicalOperatorCode"?: (logicalOperator: 'AND' | 'OR') => number;
@@ -8813,6 +8894,60 @@ declare namespace LocalJSX {
         "title"?: string;
         "titleId"?: string;
     }
+    /**
+     * A small display-only component for showing read-only form metadata.
+     * Intended usage:
+     * - Rendered near the top or bottom of a form submission view
+     * - Pure presentational output based on props (no internal state, no events)
+     * Layout:
+     * - Uses a simple "label + value" row pattern for consistent alignment
+     * - Hides rows when the corresponding value is missing or the display flag is false
+     * @example ```tsx
+     * <form-metadata-display
+     *   userDisplayName="Ada Lovelace"
+     *   userEmail="ada@example.com"
+     *   submittedOn={new Date()}
+     * />
+     * ```
+     */
+    interface FormMetadataDisplay {
+        /**
+          * Toggles rendering of the "Email" row. Defaults to true.
+          * @default true
+         */
+        "displayOwnerEmail"?: boolean;
+        /**
+          * Toggles rendering of the "Name" row. Defaults to true.
+          * @default true
+         */
+        "displayOwnerFullName"?: boolean;
+        /**
+          * Toggles rendering of the "Submitted on" row. Defaults to true.
+          * @default true
+         */
+        "displaySubmissionDate"?: boolean;
+        /**
+          * Submission timestamp. Row is only rendered when `displaySubmissionDate` is true and this value is non-null.
+         */
+        "submittedOn"?: string | null;
+        /**
+          * Full name (or display name) of the form owner/submitter. Row is only rendered when `displayOwnerFullName` is true and this value is non-empty.
+         */
+        "userDisplayName"?: string;
+        /**
+          * Email of the form owner/submitter. Row is only rendered when `displayOwnerEmail` is true and this value is non-empty.
+         */
+        "userEmail"?: string;
+    }
+    interface FormMetadataDisplayRenderer {
+        "formSectionsDraft"?: any[][];
+        "getHandler"?: (fieldTypeId: number, handlerName: string) => any;
+        "isViewOnly"?: boolean;
+        "onFormSectionsDraftChange"?: (updatedSections: any[][]) => void;
+        "qIndex"?: number;
+        "question"?: UdpFormQuestion;
+        "sIndex"?: number;
+    }
     interface GhostRender {
     }
     interface GridHeader {
@@ -11555,7 +11690,7 @@ declare namespace LocalJSX {
         "formsBuilderUrlPath"?: string;
         "history"?: { push: (path: string) => void };
         /**
-          * @default false
+          * @default true
          */
         "isCommentingConfigOn"?: boolean;
         /**
@@ -11677,9 +11812,6 @@ declare namespace LocalJSX {
         "closeSnackbar"?: Function;
         "enqueueSnackbar"?: Function;
         "formId"?: Guid | null;
-        "generic1"?: any;
-        "generic2"?: any;
-        "generic3"?: any;
         "getUserCallback"?: Function;
         "history"?: any;
         /**
@@ -11688,9 +11820,21 @@ declare namespace LocalJSX {
         "isPublic"?: boolean;
         "submissionId"?: Guid | null;
         "triggerAction"?: (actionId: Guid, params: Object) => void;
+        /**
+          * @default {}
+         */
+        "urlContext"?: Record<string, any>;
         "version"?: number | null;
     }
     interface UdpFormsUi {
+        /**
+          * @default {     id: null,     displayName: null,     email: null,   }
+         */
+        "clientUserInfo"?: { id: string | null; displayName: string | null; email: string | null };
+        /**
+          * @default {}
+         */
+        "currentValues"?: { [name: string]: any };
         "deleteRepeatableSection"?: any;
         /**
           * @default false
@@ -11703,14 +11847,6 @@ declare namespace LocalJSX {
         "handleFinish"?: () => void;
         "handleSave"?: (values: { [name: string]: any }) => Promise<void>;
         "handleSubmit"?: (values: any) => Promise<void>;
-        /**
-          * @default {}
-         */
-        "initialValues"?: { [name: string]: any };
-        /**
-          * @default false
-         */
-        "isCommentAllowed"?: boolean;
         /**
           * @default false
          */
@@ -11747,10 +11883,6 @@ declare namespace LocalJSX {
         "submitSuccessful"?: boolean;
         "udpForm"?: UdpForm;
         "udpFormSubmission"?: UdpFormSubmission;
-        /**
-          * @default null
-         */
-        "userId"?: Guid | null;
     }
     /**
      * @deprecated This component is deprecated and will be removed in a future version.
@@ -12520,17 +12652,17 @@ declare namespace LocalJSX {
     }
     interface UdpQuestion {
         /**
-          * @default false
+          * @default {     id: null,     displayName: null,     email: null,   }
          */
-        "disabled"?: boolean;
+        "clientUserInfo"?: { id: string | null; displayName: string | null; email: string | null };
         /**
           * @default {}
          */
-        "initialValues"?: { [name: string]: any };
+        "currentValues"?: { [name: string]: any };
         /**
           * @default false
          */
-        "isCommentAllowed"?: boolean;
+        "disabled"?: boolean;
         "onLaunchFollowUpFormSideSheet"?: (event: UdpQuestionCustomEvent<any>) => void;
         "question"?: UdpFormQuestion;
         "questionNumber"?: number;
@@ -12546,7 +12678,7 @@ declare namespace LocalJSX {
         /**
           * @default null
          */
-        "userId"?: Guid | null;
+        "udpFormSubmission"?: UdpFormSubmission;
         "value"?: string;
     }
     interface UdpQuestionComments {
@@ -12557,7 +12689,7 @@ declare namespace LocalJSX {
         /**
           * @default {}
          */
-        "initialValues"?: { [name: string]: any };
+        "currentValues"?: { [name: string]: any };
         "onQuestionCommentAction"?: (event: UdpQuestionCommentsCustomEvent<{
     type: 'add' | 'save' | 'edit' | 'delete' | 'editClose';
     questionIdentifierKey: string;
@@ -13413,6 +13545,8 @@ declare namespace LocalJSX {
         "filter-conditions": FilterConditions;
         "filter-group": FilterGroup;
         "fluent-dialog": FluentDialog;
+        "form-metadata-display": FormMetadataDisplay;
+        "form-metadata-display-renderer": FormMetadataDisplayRenderer;
         "ghost-render": GhostRender;
         "grid-header": GridHeader;
         "grid-primary-bar": GridPrimaryBar;
@@ -13701,6 +13835,24 @@ declare module "@stencil/core" {
              * Please use `udp-dialog` instead
              */
             "fluent-dialog": LocalJSX.FluentDialog & JSXBase.HTMLAttributes<HTMLFluentDialogElement>;
+            /**
+             * A small display-only component for showing read-only form metadata.
+             * Intended usage:
+             * - Rendered near the top or bottom of a form submission view
+             * - Pure presentational output based on props (no internal state, no events)
+             * Layout:
+             * - Uses a simple "label + value" row pattern for consistent alignment
+             * - Hides rows when the corresponding value is missing or the display flag is false
+             * @example ```tsx
+             * <form-metadata-display
+             *   userDisplayName="Ada Lovelace"
+             *   userEmail="ada@example.com"
+             *   submittedOn={new Date()}
+             * />
+             * ```
+             */
+            "form-metadata-display": LocalJSX.FormMetadataDisplay & JSXBase.HTMLAttributes<HTMLFormMetadataDisplayElement>;
+            "form-metadata-display-renderer": LocalJSX.FormMetadataDisplayRenderer & JSXBase.HTMLAttributes<HTMLFormMetadataDisplayRendererElement>;
             "ghost-render": LocalJSX.GhostRender & JSXBase.HTMLAttributes<HTMLGhostRenderElement>;
             "grid-header": LocalJSX.GridHeader & JSXBase.HTMLAttributes<HTMLGridHeaderElement>;
             "grid-primary-bar": LocalJSX.GridPrimaryBar & JSXBase.HTMLAttributes<HTMLGridPrimaryBarElement>;

package/dist/types/index.d.ts

@@ -7,3 +7,4 @@ export type { Search as SearchInterface, SearchFilters, SearchFilterGroups, Grou
 export * from './store/catalog-store';
 export * from './udp-utilities/api-config';
 export { useMatchBreakpoint } from './udp-utilities/layout/breakpoints/useMatchBreakpoint';
+export * from './udp-utilities/udp-websocket-client/udp-websocket-client';

package/dist/types/stencil-public-runtime.d.ts

@@ -63,6 +63,12 @@ export interface ShadowRootOptions {
      * focusable part is given focus, and the shadow host is given any available `:focus` styling.
      */
     delegatesFocus?: boolean;
+    /**
+     * Sets the slot assignment mode for the shadow root. When set to `'manual'`, enables imperative
+     * slotting using the `HTMLSlotElement.assign()` method. Defaults to `'named'` for standard
+     * declarative slotting behavior.
+     */
+    slotAssignment?: 'manual' | 'named';
 }
 export interface ModeStyles {
     [modeName: string]: string | string[];
@@ -125,6 +131,9 @@ export interface AttachInternalsDecorator {
 export interface ListenDecorator {
     (eventName: string, opts?: ListenOptions): CustomMethodDecorator<any>;
 }
+export interface ResolveVarFunction {
+    <T>(variable: T): string;
+}
 export interface ListenOptions {
     /**
      * Handlers can also be registered for an event other than the host itself.
@@ -153,7 +162,9 @@ export interface StateDecorator {
     (): PropertyDecorator;
 }
 export interface WatchDecorator {
-    (propName: any): CustomMethodDecorator<(newValue?: any, oldValue?: any, propName?: any, ...args: any[]) => any | void>;
+    (propName: any, watchOptions?: {
+        immediate?: boolean;
+    }): CustomMethodDecorator<(newValue?: any, oldValue?: any, propName?: any, ...args: any[]) => any | void>;
 }
 export interface PropSerializeDecorator {
     (propName: any): CustomMethodDecorator<(newValue?: any, propName?: string, ...args: any[]) => string | null>;
@@ -208,6 +219,24 @@ export declare const AttachInternals: AttachInternalsDecorator;
  * https://stenciljs.com/docs/events#listen-decorator
  */
 export declare const Listen: ListenDecorator;
+/**
+ * The `resolveVar()` function is a compile-time utility that resolves const variables
+ * and object properties to their string literal values. This allows variables to be
+ * used in `@Listen` and `@Event` decorators instead of hardcoded strings.
+ *
+ * @example
+ * ```ts
+ * const MY_EVENT = 'myEvent';
+ * @Listen(resolveVar(MY_EVENT))
+ * ```
+ *
+ * @example
+ * ```ts
+ * const EVENTS = { MY_EVENT: 'myEvent' } as const;
+ * @Event({ eventName: resolveVar(EVENTS.MY_EVENT) })
+ * ```
+ */
+export declare const resolveVar: ResolveVarFunction;
 /**
  * The `@Method()` decorator is used to expose methods on the public API.
  * Class methods decorated with the @Method() decorator can be called directly
@@ -339,7 +368,7 @@ export declare function forceUpdate(ref: any): void;
  * @returns the rendering ref
  */
 export declare function getRenderingRef(): any;
-export interface HTMLStencilElement extends Omit<HTMLElement, 'autocorrect'> {
+export interface HTMLStencilElement extends HTMLElement {
     componentOnReady(): Promise<this>;
 }
 /**
@@ -365,6 +394,27 @@ export declare function readTask(task: RafCallback): void;
  * Unhandled exception raised while rendering, during event handling, or lifecycles will trigger the custom event handler.
  */
 export declare const setErrorHandler: (handler: ErrorHandler) => void;
+export type TagTransformer = (tag: string) => string;
+/**
+ * Sets a tag transformer to be used when rendering your custom elements.
+ * ```ts
+ * setTagTransformer((tag) => {
+ *  if (tag.startsWith('my-')) return `new-${tag}`
+ *  return tag;
+ * });
+ * ```
+ * Will mean all your components that start with `my-` are defined instead with `new-my-` prefix.
+ *
+ * @param transformer the transformer function to use which must return a string.
+ */
+export declare function setTagTransformer(transformer: TagTransformer): void;
+/**
+ * Transforms a tag name using a transformer set via `setTagTransformer`
+ *
+ * @param tag - the tag to transform e.g. `my-tag`
+ * @returns the transformed tag e.g. `new-my-tag`
+ */
+export declare function transformTag(tag: string): string;
 /**
  * @deprecated - Use `MixedInCtor` instead:
  * ```ts
@@ -568,7 +618,7 @@ export interface FunctionalUtilities {
     map: (children: VNode[], cb: (vnode: ChildNode, index: number, array: ChildNode[]) => ChildNode) => VNode[];
 }
 export interface FunctionalComponent<T = {}> {
-    (props: T, children: VNode[], utils: FunctionalUtilities): VNode | VNode[];
+    (props: T, children: VNode[], utils: FunctionalUtilities): VNode | VNode[] | null;
 }
 /**
  * A Child VDOM node
@@ -623,6 +673,35 @@ export declare function h(sel: any, text: string): VNode;
 export declare function h(sel: any, children: Array<VNode | undefined | null>): VNode;
 export declare function h(sel: any, data: VNodeData | null, text: string): VNode;
 export declare function h(sel: any, data: VNodeData | null, children: Array<VNode | undefined | null>): VNode;
+/**
+ * Automatic JSX runtime functions for TypeScript's react-jsx mode.
+ * These functions are called automatically by TypeScript when using "jsx": "react-jsx".
+ * @param type type of node
+ * @param props properties of node
+ * @param key optional key for the node
+ * @returns a jsx vnode
+ */
+export declare function jsx(type: any, props: any, key?: string): VNode;
+/**
+ * Automatic JSX runtime functions for TypeScript's react-jsxmode with multiple children.
+ * @param type type of node
+ * @param props properties of node
+ * @param key optional key for the node
+ * @returns a jsx vnode
+ */
+export declare function jsxs(type: any, props: any, key?: string): VNode;
+/**
+ * Automatic JSX runtime functions for TypeScript's react-jsxdev mode.
+ * These functions are called automatically by TypeScript when using "jsx": "react-jsxdev".
+ * @param type type of node
+ * @param props properties of node
+ * @param key optional key for the node
+ * @param isStaticChildren indicates if the children are static
+ * @param source source information
+ * @param self reference to the component instance
+ * @returns a jsx vnode
+ */
+export declare function jsxDEV(type: any, props: any, key?: string | number, isStaticChildren?: boolean, source?: any, self?: any): VNode;
 export declare function h(sel: any, data: VNodeData | null, children: VNode): VNode;
 /**
  * A virtual DOM node
@@ -653,7 +732,7 @@ declare namespace LocalJSX {
 export { LocalJSX as JSX };
 export declare namespace JSXBase {
     interface IntrinsicElements {
-        slot: JSXBase.SlotAttributes;
+        slot: JSXBase.SlotAttributes<HTMLSlotElement>;
         a: JSXBase.AnchorHTMLAttributes<HTMLAnchorElement>;
         abbr: JSXBase.HTMLAttributes;
         address: JSXBase.HTMLAttributes;
@@ -823,7 +902,7 @@ export declare namespace JSXBase {
         use: JSXBase.SVGAttributes;
         view: JSXBase.SVGAttributes;
     }
-    interface SlotAttributes extends JSXAttributes {
+    interface SlotAttributes<T = HTMLSlotElement> extends JSXAttributes<T> {
         name?: string;
         slot?: string;
         onSlotchange?: (event: Event) => void;
@@ -879,6 +958,9 @@ export declare namespace JSXBase {
         popoverTargetAction?: string;
         popoverTargetElement?: Element | null;
         popoverTarget?: string;
+        command?: string;
+        commandFor?: string;
+        commandfor?: string;
     }
     interface CanvasHTMLAttributes<T> extends HTMLAttributes<T> {
         height?: number | string;
@@ -1747,6 +1829,7 @@ export interface CustomElementsDefineOptions {
     exclude?: string[];
     resourcesUrl?: string;
     syncQueue?: boolean;
+    /** @deprecated in-favour of `setTagTransformer` and `transformTag` */
     transformTagName?: (tagName: string) => string;
     jmp?: (c: Function) => any;
     raf?: (c: FrameRequestCallback) => number;