xmlui 0.9.82 → 0.9.83

package/dist/scripts/package.json

@@ -1,6 +1,6 @@
 {
     "name": "xmlui",
-    "version": "0.9.82",
+    "version": "0.9.83",
     "sideEffects": false,
     "scripts": {
         "start-test-bed": "cd src/testing/infrastructure && xmlui start",

package/dist/scripts/src/components/Bookmark/Bookmark.js

@@ -35,6 +35,11 @@ exports.BookmarkMd = (0, metadata_helpers_1.createMetadata)({
             defaultValue: BookmarkNative_1.defaultProps.omitFromToc,
         },
     },
+    apis: {
+        scrollIntoView: {
+            description: "Scrolls the bookmark into view.",
+        },
+    },
 });
 exports.bookmarkComponentRenderer = (0, renderers_1.createComponentRenderer)(COMP, exports.BookmarkMd, (rendererContext) => {
     const { node, renderChild, extractValue, layoutContext } = rendererContext;

package/dist/scripts/src/components/Bookmark/BookmarkNative.js

@@ -12,11 +12,21 @@ exports.defaultProps = {
     level: 1,
     omitFromToc: false,
 };
-const Bookmark = ({ uid, level = exports.defaultProps.level, children, title, omitFromToc = exports.defaultProps.omitFromToc, }) => {
+const Bookmark = ({ uid, level = exports.defaultProps.level, children, title, omitFromToc = exports.defaultProps.omitFromToc, registerComponentApi, }) => {
     const elementRef = (0, react_1.useRef)(null);
     const tableOfContentsContext = (0, react_1.useContext)(TableOfContentsContext_1.TableOfContentsContext);
     const registerHeading = tableOfContentsContext === null || tableOfContentsContext === void 0 ? void 0 : tableOfContentsContext.registerHeading;
     const observeIntersection = tableOfContentsContext === null || tableOfContentsContext === void 0 ? void 0 : tableOfContentsContext.hasTableOfContents;
+    const scrollIntoView = (0, react_1.useCallback)((options) => {
+        if (elementRef.current) {
+            elementRef.current.scrollIntoView(Object.assign({ behavior: 'smooth', block: 'start' }, options));
+        }
+    }, []);
+    (0, react_1.useEffect)(() => {
+        registerComponentApi === null || registerComponentApi === void 0 ? void 0 : registerComponentApi({
+            scrollIntoView,
+        });
+    }, [registerComponentApi, scrollIntoView]);
     (0, react_1.useLayoutEffect)(() => {
         var _a, _b, _c;
         if (observeIntersection && elementRef.current && uid && !omitFromToc) {

package/dist/scripts/src/components/ModalDialog/ModalDialogNative.js

@@ -121,7 +121,9 @@ exports.ModalDialog = react_1.default.forwardRef(({ children, style, isInitially
     // NOTE: at this point, we can't use useAppContext here,
     // since the ModalDialog context provider (via ConfirmationModalContextProvider) is mounted outside of the AppContext,
     // and ModalDialogs can also be called using the imperative API (see functions like "confirm")
-    const isDialogRootInShadowDom = (root === null || root === void 0 ? void 0 : root.getRootNode()) instanceof ShadowRoot;
+    // String-based type checking: Use constructor.name to identify ShadowRoot
+    // This avoids direct ShadowRoot type dependency while being more explicit than duck typing
+    const isDialogRootInShadowDom = typeof ShadowRoot !== 'undefined' && (root === null || root === void 0 ? void 0 : root.getRootNode()) instanceof ShadowRoot;
     const modalRef = (0, react_1.useRef)(null);
     const composedRef = ref ? (0, react_compose_refs_1.composeRefs)(ref, modalRef) : modalRef;
     const { isOpen, doClose, doOpen } = useModalOpenState(isInitiallyOpen, onOpen, onClose);

package/dist/scripts/src/components-core/rendering/AppContent.js

@@ -197,8 +197,10 @@ function AppContent({ rootContainer, routerBaseName, globalProps, standalone, tr
                     var _a;
                     if (!rootNode)
                         return;
-                    // --- If element is in shadow DOM
-                    if (rootNode instanceof ShadowRoot) {
+                    // --- If element is in shadow DOM (string-based type checking)
+                    // --- Check constructor.name to avoid direct ShadowRoot type dependency
+                    // --- More precise than duck typing, works reliably across different environments
+                    if (typeof ShadowRoot !== 'undefined' && rootNode instanceof ShadowRoot) {
                         const el = rootNode.getElementById(lastHash.current);
                         if (!el)
                             return;
@@ -281,7 +283,10 @@ function AppContent({ rootContainer, routerBaseName, globalProps, standalone, tr
             environment,
             mediaSize,
             queryClient: AppRoot_1.queryClient,
-            standalone, appIsInShadowDom: (root === null || root === void 0 ? void 0 : root.getRootNode()) instanceof ShadowRoot }, date_functions_1.dateFunctions), math_function_1.mathFunctions), { 
+            standalone, 
+            // String-based type checking: Use constructor.name to identify ShadowRoot
+            // This avoids direct ShadowRoot type dependency while being more explicit than duck typing
+            appIsInShadowDom: typeof ShadowRoot !== 'undefined' && (root === null || root === void 0 ? void 0 : root.getRootNode()) instanceof ShadowRoot }, date_functions_1.dateFunctions), math_function_1.mathFunctions), { 
             // --- File Utilities
             formatFileSizeInBytes: misc_1.formatFileSizeInBytes,
             getFileExtension: misc_1.getFileExtension,