xmlui 0.12.20 → 0.12.21

package/dist/standalone/xmlui-standalone.es.d.ts

@@ -196,7 +196,7 @@ declare type AppLayoutType = (typeof appLayoutNames)[number];
  * from either code-behind files or inlined markup expressions) and executes
  * the app accordingly.
  */
-declare function AppRoot({ asIsland, mainSrc, apiInterceptor, contributes, node, decorateComponentsWithTestId, debugEnabled, defaultTheme, defaultTone, resources, globalProps, globalVars, standalone, trackContainerHeight, routerBaseName, previewMode, resourceMap, sources, extensionManager, children, projectCompilation, isNested, onInit, icons, helmetContext, }: AppWrapperProps & {
+declare function AppRoot({ apiInterceptor, contributes, node, decorateComponentsWithTestId, debugEnabled, defaultTheme, defaultTone, resources, globalProps, globalVars, standalone, trackContainerHeight, routerBaseName, previewMode, resourceMap, sources, extensionManager, children, projectCompilation, isNested, onInit, icons, helmetContext, }: AppWrapperProps & {
     extensionManager?: StandaloneExtensionManager;
     isNested?: boolean;
 }): JSX_2.Element;
@@ -235,7 +235,6 @@ declare type AppThemes = {
 };
 
 declare type AppWrapperProps = {
-    asIsland?: boolean;
     node: ComponentLike;
     previewMode?: boolean;
     routerBaseName?: string;
@@ -364,7 +363,7 @@ declare interface BinaryExpression extends ExpressionBase {
     right: Expression;
 }
 
-declare type BinaryOpSymbols = "**" | "*" | "/" | "%" | "+" | "-" | "<<" | ">>" | ">>>" | "<" | "<=" | ">" | ">=" | "==" | "===" | "!=" | "!==" | "&" | "|" | "^" | "&&" | "||" | "??" | "in";
+declare type BinaryOpSymbols = "**" | "*" | "/" | "%" | "+" | "-" | "<<" | ">>" | ">>>" | "<" | "<=" | ">" | ">=" | "==" | "===" | "!=" | "!==" | "&" | "|" | "^" | "&&" | "||" | "??" | "in" | "instanceof";
 
 declare type BLOCK_STATEMENT = typeof T_BLOCK_STATEMENT;
 
@@ -686,6 +685,7 @@ declare type ConfirmOptions = {
     actionLabel?: string;
     cancelLabel?: string;
     width?: string;
+    actionThemeColor?: ButtonThemeColor;
 };
 
 declare type CONST_STATEMENT = typeof T_CONST_STATEMENT;
@@ -1289,6 +1289,7 @@ declare interface IconBaseProps extends default_2.SVGAttributes<SVGElement> {
     style?: CSSProperties;
     className?: string;
     tabIndex?: number;
+    onClick?: default_2.MouseEventHandler<any>;
     onKeyDown?: default_2.KeyboardEventHandler<any>;
 }
 
@@ -1523,6 +1524,31 @@ declare type Message = ValueOrFunction<Renderable, Toast>;
  */
 declare type ModuleErrors = Record<string, ScriptParserErrorMessage[]>;
 
+declare interface NavHierarchyNode {
+    /** The type of navigation node - either a clickable link or a grouping container */
+    type: "NavLink" | "NavGroup";
+    /** The display label/text for this navigation item */
+    label: string;
+    /** The URL/route path for navigation (present for NavLink and optional for NavGroup) */
+    to?: string;
+    /** Child navigation nodes nested under this node (only present for NavGroup types) */
+    children?: NavHierarchyNode[];
+    /** Optional icon name associated with this navigation item */
+    icon?: string;
+    /** Reference to the immediate parent node in the hierarchy (undefined for root-level nodes) */
+    parent?: NavHierarchyNode;
+    /** Array of ancestor nodes from root to this node, excluding this node itself (empty for root-level nodes) */
+    pathSegments?: NavHierarchyNode[];
+    /** Reference to the previous NavLink in the flattened navigation order */
+    prevLink?: NavHierarchyNode;
+    /** Reference to the next NavLink in the flattened navigation order */
+    nextLink?: NavHierarchyNode;
+    /** True if this is the first NavLink within its immediate parent container */
+    firstLink?: boolean;
+    /** True if this is the last NavLink within its immediate parent container */
+    lastLink?: boolean;
+}
+
 declare const NavPanelCollapseButton: NamedExoticComponent<NavPanelCollapseButtonProps>;
 
 declare type NavPanelCollapseButtonProps = {
@@ -1546,9 +1572,6 @@ declare type NestedAppProps = {
     refreshVersion?: number;
     withSplashScreen?: boolean;
     className?: string;
-    resolvedApp?: ComponentDef | CompoundComponentDef;
-    resolvedComponents?: CompoundComponentDef[];
-    asIsland?: boolean;
 };
 
 declare type NEW_EXPRESSION = typeof T_NEW_EXPRESSION;
@@ -1997,16 +2020,8 @@ declare const Stack: default_2.MemoExoticComponent<default_2.ForwardRefExoticCom
  * AppRoot is responsible for rendering the app (using an internal
  * representation); ApiInterceptor can emulate some backend functionality
  * running in the browser.
- *
- * Note: base styles (index.scss) are NOT imported here as a side-effect.
- * Instead, the `RootClasses` component (ThemeReact.tsx) injects them as a
- * `<style id="xmlui-base-styles">` tag prepended into the correct target
- * (document.head for normal apps, shadow root for islands). This ensures
- * the @layer declaration always evaluates first — before any Vite-injected
- * component styles — and that island styles are fully scoped to their
- * shadow root without leaking to the host page.
  */
-declare function StandaloneApp({ srcBase, asIsland, appDef, appGlobals: globals, decorateComponentsWithTestId, debugEnabled, runtime, extensionManager, waitForApiInterceptor, helmetContext, children, }: StandaloneAppProps): JSX_2.Element;
+declare function StandaloneApp({ appDef, appGlobals: globals, decorateComponentsWithTestId, debugEnabled, runtime, extensionManager, waitForApiInterceptor, helmetContext, children, }: StandaloneAppProps): JSX_2.Element;
 
 declare type StandaloneAppDescription = {
     name?: string;
@@ -2026,7 +2041,6 @@ declare type StandaloneAppDescription = {
 
 declare type StandaloneAppProps = {
     appDef?: StandaloneAppDescription;
-    srcBase?: string;
     appGlobals?: Record<string, any>;
     decorateComponentsWithTestId?: boolean;
     debugEnabled?: boolean;
@@ -2035,7 +2049,6 @@ declare type StandaloneAppProps = {
     waitForApiInterceptor?: boolean;
     helmetContext?: Record<string, unknown>;
     children?: ReactNode;
-    asIsland?: boolean;
 };
 
 declare function StandaloneComponent({ node, children, functions, vars }: RootComponentProps): ReactNode;
@@ -2086,7 +2099,6 @@ declare const standaloneExports: {
     dValueApi: typeof xmluiExports.dValueApi;
     parseScssVar: typeof xmluiExports.parseScssVar;
     startApp: typeof startApp;
-    startIslands: typeof xmluiExports.startIslands;
     useTheme: typeof xmluiExports.useTheme;
     AppRoot: typeof xmluiExports.AppRoot;
     ErrorBoundary: typeof xmluiExports.ErrorBoundary;
@@ -2252,9 +2264,6 @@ declare const standaloneExports: {
         refreshVersion?: number;
         withSplashScreen?: boolean;
         className?: string;
-        resolvedApp?: xmluiExports.ComponentDef | xmluiExports.CompoundComponentDef;
-        resolvedComponents?: xmluiExports.CompoundComponentDef[];
-        asIsland?: boolean;
     }>;
     VisuallyHidden: ({ children, ...props }: {
         children: default_2.ReactNode;
@@ -2284,6 +2293,7 @@ declare const standaloneExports: {
     } & Partial<Pick<HTMLAnchorElement, "type" | "rel" | "target" | "download" | "referrerPolicy" | "ping" | "hreflang">> & default_2.RefAttributes<HTMLDivElement> & {
         className?: string;
     }, "ref"> & default_2.RefAttributes<HTMLDivElement>>;
+    useLinkInfo: typeof xmluiExports.useLinkInfo;
     Heading: default_2.ForwardRefExoticComponent<Omit<Omit<HeadingProps_2, "ref"> & default_2.RefAttributes<HTMLHeadingElement> & {
         className?: string;
     }, "ref"> & default_2.RefAttributes<HTMLHeadingElement>>;
@@ -2508,8 +2518,6 @@ declare type StandaloneJsonConfig = {
  */
 declare function startApp(runtime: any, extensions?: Extension[] | Extension, extensionManager?: StandaloneExtensionManager): Root;
 
-declare function startIslands(extensionManager?: StandaloneExtensionManager): () => void;
-
 declare type State = {
     hasError: boolean;
     error: Error | null;
@@ -3183,6 +3191,8 @@ declare interface UseEventOverload {
     <TF extends callbackType>(callback: TF): any;
 }
 
+declare function useLinkInfo(): NavHierarchyNode | undefined;
+
 declare const useLogger: () => LogContextType;
 
 declare function useOption(): OptionContextValue;
@@ -3451,6 +3461,7 @@ declare namespace xmluiExports {
         ThemeTone,
         XmlUiNode,
         SearchItemData,
+        NavHierarchyNode,
         StandaloneApp,
         StandaloneExtensionManager,
         createComponentRenderer,
@@ -3495,7 +3506,6 @@ declare namespace xmluiExports {
         dValueApi,
         parseScssVar,
         startApp,
-        startIslands,
         useTheme,
         AppRoot,
         ErrorBoundary,
@@ -3522,6 +3532,7 @@ declare namespace xmluiExports {
         NestedApp,
         VisuallyHidden,
         ThemedLinkNative as LinkNative,
+        useLinkInfo,
         ThemedHeading as Heading,
         ThemedImage as Image,
         ThemedMarkdown as Markdown,