xmlui 0.4.1 → 0.4.2-beta.1

package/dist/xmlui.es.d.ts

@@ -1,6 +1,5 @@
 import { CSSProperties } from 'react';
-import { default as default_2 } from 'react-dom/client';
-import { default as default_3 } from 'react';
+import { default as default_2 } from 'react';
 import type { DefaultToastOptions } from 'react-hot-toast';
 import { ErrorInfo } from 'react';
 import { JSX as JSX_2 } from 'react/jsx-runtime';
@@ -8,6 +7,7 @@ import type { NavigateOptions } from 'react-router-dom';
 import type { QueryClient } from '@tanstack/react-query';
 import { ReactNode } from 'react';
 import type { Renderable } from 'react-hot-toast';
+import type { Root } from 'react-dom/client';
 import type { To } from 'react-router-dom';
 import type { Toast } from 'react-hot-toast';
 import type { ToastOptions } from 'react-hot-toast';
@@ -145,6 +145,7 @@ declare type AppContextObject = {
      */
     readonly standalone?: boolean;
     readonly decorateComponentsWithTestId?: boolean;
+    readonly debugEnabled?: boolean;
     readonly signError: (error: Error | string) => void;
     readonly toast: {
         (message: Message, opts?: ToastOptions): string;
@@ -302,15 +303,15 @@ declare interface BreakStatement extends StatementBase {
     type: "BrkS";
 }
 
-export declare const Button: default_3.ForwardRefExoticComponent<{
+export declare const Button: default_2.ForwardRefExoticComponent<{
     id?: string;
     type?: ButtonType;
     variant?: ButtonVariant;
     themeColor?: ButtonThemeColor;
     size?: ButtonSize;
     disabled?: boolean;
-    children?: default_3.ReactNode | default_3.ReactNode[];
-    icon?: default_3.ReactNode;
+    children?: default_2.ReactNode | default_2.ReactNode[];
+    icon?: default_2.ReactNode;
     iconPosition?: IconPosition;
     contentPosition?: AlignmentOptions;
     orientation?: OrientationOptions;
@@ -320,7 +321,7 @@ export declare const Button: default_3.ForwardRefExoticComponent<{
     accessibilityProps?: any;
     autoFocus?: boolean;
     title?: string;
-} & Pick<default_3.HTMLAttributes<HTMLButtonElement>, "className" | "onClick" | "tabIndex" | "onFocus" | "onBlur" | ButtonAria> & default_3.RefAttributes<HTMLButtonElement>>;
+} & Pick<default_2.HTMLAttributes<HTMLButtonElement>, "className" | "onClick" | "tabIndex" | "onFocus" | "onBlur" | "onMouseEnter" | "onMouseLeave" | ButtonAria> & default_2.RefAttributes<HTMLButtonElement>>;
 
 declare type ButtonAria = "aria-controls" | "aria-expanded" | "aria-disabled" | "aria-label";
 
@@ -418,6 +419,13 @@ export declare interface ComponentDef<T extends string = string> extends Scripta
      * property holds the name of state values to flow down to the direct child containers.
      */
     uses?: string[];
+    /**
+     * Arbitrary debug information that can be attached to a component definition.
+     * Current usage:
+     * - `debug: { source: { start: number, end: number } }` Ther start and end positions of of the source
+     *   belonging to the particular component definition.
+     */
+    debug?: Record<string, any>;
 }
 
 declare type ComponentDescriptor<T extends ComponentDef> = {
@@ -479,7 +487,7 @@ declare type ComponentRendererDef = {
 };
 
 /**
- *
+ * This function renders a component definition into a React component
  */
 declare type ComponentRendererFn<T extends ComponentDef> = (context: RendererContext<T>) => ReactNode;
 
@@ -508,6 +516,13 @@ export declare interface CompoundComponentDef extends Scriptable {
      * definition.
      */
     vars?: Record<string, any>;
+    /**
+     * Arbitrary debug information that can be attached to a component definition.
+     * Current usage:
+     * - `debug: { source: { start: number, end: number } }` Ther start and end positions of of the source
+     *   belonging to the particular component definition.
+     */
+    debug?: Record<string, any>;
 }
 
 declare interface ConditionalExpression extends ExpressionBase {
@@ -598,7 +613,7 @@ declare interface EmptyStatement extends StatementBase {
 /**
  * This component serves as an error boundary; it catches any errors within the nested components
  */
-export declare class ErrorBoundary extends default_3.Component<Props, State> {
+export declare class ErrorBoundary extends default_2.Component<Props, State> {
     /**
      * We start with "no error" state
      */
@@ -621,7 +636,7 @@ export declare class ErrorBoundary extends default_3.Component<Props, State> {
      * @param snapshot Optional snapshot (not used in this component)
      */
     componentDidUpdate(prevProps: Readonly<Props>, prevState: Readonly<State>, snapshot?: any): void;
-    render(): string | number | boolean | Iterable<default_3.ReactNode> | JSX_2.Element;
+    render(): string | number | boolean | Iterable<default_2.ReactNode> | JSX_2.Element;
 }
 
 declare type EventDescriptorHash<T extends ComponentDef> = Partial<Record<keyof NonNullable<T["events"]>, ComponentPropertyDescriptor>>;
@@ -728,15 +743,15 @@ declare interface IApiInterceptorContext {
     isMocked: (url: string) => boolean;
 }
 
-export declare const Icon: ({ name, fallback, layout, className, ...restProps }: IconBaseProps) => JSX_2.Element;
+export declare const Icon: default_2.ForwardRefExoticComponent<IconBaseProps & default_2.RefAttributes<unknown>>;
 
-declare interface IconBaseProps extends default_3.SVGAttributes<SVGElement> {
-    children?: default_3.ReactNode;
+declare interface IconBaseProps extends default_2.SVGAttributes<SVGElement> {
+    children?: default_2.ReactNode;
     color?: string;
     title?: string;
     size?: string;
     isInline?: boolean;
-    fallback?: string | default_3.ReactNode;
+    fallback?: string | default_2.ReactNode;
     layout?: CSSProperties;
 }
 
@@ -982,7 +997,7 @@ declare type Orientation = "horizontal" | "vertical";
 
 declare type OrientationOptions = "horizontal" | "vertical";
 
-export declare function parseXmlUiMarkup(source: string, moduleResolver?: ModuleResolver, useOldParser?: boolean): ComponentDef<string> | CompoundComponentDef;
+export declare function parseXmlUiMarkup(source: string, fileId?: string | number, moduleResolver?: ModuleResolver): ComponentDef<string> | CompoundComponentDef;
 
 declare interface PostfixOpExpression extends ExpressionBase {
     type: "PostfE";
@@ -1088,7 +1103,7 @@ declare interface ReturnStatement extends StatementBase {
     expression?: Expression;
 }
 
-export declare function RootComponent({ apiInterceptor, contributes, node, decorateComponentsWithTestId, defaultTheme, defaultTone, resources, globalProps, standalone, baseName, previewMode, servedFromSingleFile, resourceMap, }: RootComponentProps): JSX_2.Element;
+export declare function RootComponent({ apiInterceptor, contributes, node, decorateComponentsWithTestId, debugEnabled, defaultTheme, defaultTone, resources, globalProps, standalone, baseName, previewMode, servedFromSingleFile, resourceMap, sources }: RootComponentProps): JSX_2.Element;
 
 /**
  * The properties of the root component
@@ -1121,10 +1136,12 @@ declare type RootComponentProps = {
      */
     standalone?: boolean;
     decorateComponentsWithTestId?: boolean;
+    debugEnabled?: boolean;
     apiInterceptor?: ApiInterceptorDefinition;
     defaultTheme?: string;
     defaultTone?: ThemeTone;
     resourceMap?: Record<string, string>;
+    sources?: Record<string, string>;
 };
 
 declare type SchemaDescriptor = {
@@ -1186,15 +1203,15 @@ declare type SplitProps = {
     /**
      * The children to display in the splitter.
      */
-    children: default_3.ReactNode[] | default_3.ReactNode;
+    children: default_2.ReactNode[] | default_2.ReactNode;
     /**
      * The layout of the splitter.
      */
-    layout?: default_3.CSSProperties;
+    layout?: default_2.CSSProperties;
     /**
      * The template to display in the splitter.
      */
-    splitterTemplate?: default_3.ReactNode;
+    splitterTemplate?: default_2.ReactNode;
     /**
      * The orientation of the splitter.
      * The default is "horizontal".
@@ -1237,9 +1254,9 @@ declare interface SpreadExpression extends ExpressionBase {
     operand: Expression;
 }
 
-export declare const Stack: default_3.ForwardRefExoticComponent<Props_2 & default_3.RefAttributes<any>>;
+export declare const Stack: default_2.ForwardRefExoticComponent<Props_2 & default_2.RefAttributes<any>>;
 
-export declare function StandaloneApp({ appDef, decorateComponentsWithTestId, runtime, components: customComponents, }: StandaloneAppProps): JSX_2.Element;
+export declare function StandaloneApp({ appDef, decorateComponentsWithTestId, debugEnabled, runtime, components: customComponents, }: StandaloneAppProps): JSX_2.Element;
 
 export declare type StandaloneAppDescription = {
     name?: string;
@@ -1253,11 +1270,13 @@ export declare type StandaloneAppDescription = {
     resourceMap?: Record<string, string>;
     globals?: Record<string, any>;
     apiInterceptor?: ApiInterceptorDefinition;
+    sources?: Record<string, string>;
 };
 
 declare type StandaloneAppProps = {
     appDef?: StandaloneAppDescription;
     decorateComponentsWithTestId?: boolean;
+    debugEnabled?: boolean;
     runtime?: any;
     components?: ComponentRendererDef[];
 };
@@ -1274,7 +1293,7 @@ export declare type StandaloneJsonConfig = {
     apiInterceptor?: ApiInterceptorDefinition;
 };
 
-export declare function startApp(runtime?: any, components?: ComponentRendererDef[]): default_2.Root;
+export declare function startApp(runtime?: any, components?: ComponentRendererDef[]): Root;
 
 /**
  * This type represents the current state of the error boundary

package/dist/xmlui.es.js

@@ -1,4 +1,4 @@
-import { B as o, E as e, I as r, A as t, e as p, b as n, S as u, c as l, f as m, p as C, s as c, t as S, h as d, u as A } from "./index-D4lrwrU-.mjs";
+import { B as o, E as e, I as r, A as t, e as p, b as n, S as u, c as l, f as m, p as C, s as c, t as S, h as d, u as A } from "./index-DFmApFOY.mjs";
 export {
   o as Button,
   e as ErrorBoundary,