@stone-js/use-react 0.2.0 → 0.3.0

package/dist/index.js

@@ -1,11 +1,63 @@
-import { isNotEmpty, isEmpty, InitializationError, isMetaClassModule, isMetaFactoryModule, isFunctionModule, isObjectLikeModule, isFunction, mergeBlueprints, stoneBlueprint, classDecoratorLegacyWrapper, setMetadata, methodDecoratorLegacyWrapper, addMetadata, LIFECYCLE_HOOK_KEY, hasMetadata, getMetadata, isMatchedAdapter, Logger, addBlueprint } from '@stone-js/core';
+import { InitializationError, isEmpty, isNotEmpty, isMetaClassModule, isMetaFactoryModule, isObjectLikeModule, isFunction, isFunctionModule, mergeBlueprints, stoneBlueprint, classDecoratorLegacyWrapper, setMetadata, methodDecoratorLegacyWrapper, addMetadata, LIFECYCLE_HOOK_KEY, hasMetadata, getMetadata, isMatchedAdapter, Logger, addBlueprint } from '@stone-js/core';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 import { renderToString } from 'react-dom/server';
-import { createContext, StrictMode, useState, useEffect, useContext } from 'react';
-import { createRoot, hydrateRoot } from 'react-dom/client';
+import { createContext, StrictMode, useContext, useMemo, useState, useEffect } from 'react';
+import { hydrateRoot, createRoot } from 'react-dom/client';
 import { Config } from '@stone-js/config';
 import { GET, NODE_CONSOLE_PLATFORM, Router, RouteEvent } from '@stone-js/router';
-import { OutgoingHttpResponse, RedirectResponse, MetaStaticFileMiddleware, MetaCompressionMiddleware } from '@stone-js/http-core';
+import { RedirectResponse, OutgoingHttpResponse, MetaCompressionMiddleware, MetaStaticFileMiddleware } from '@stone-js/http-core';
+
+/**
+ * Custom error for react operations.
+ */
+class UseReactError extends InitializationError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'UseReactError';
+    }
+}
+
+/**
+ * A useReact event handler for processing incoming events
+ * For single event handler.
+ *
+ * Multiple event handlers will be processed by the router.
+ *
+ * @template IncomingEventType - The type representing the incoming event.
+ * @template OutgoingResponseType - The type representing the outgoing response.
+ */
+class UseReactEventHandler {
+    blueprint;
+    /**
+     * Constructs a `UseReactEventHandler` instance.
+     *
+     * @param options - The UseReactEventHandler options including blueprint.
+     */
+    constructor({ blueprint }) {
+        this.blueprint = blueprint;
+    }
+    /**
+     * Handle an incoming event.
+     *
+     * @returns The outgoing response.
+     */
+    handle() {
+        return this.getComponentEventHandler();
+    }
+    /**
+     * Get the component event handler.
+     *
+     * @returns The component event handler.
+     * @throws {UseReactError} If the component event handler is missing.
+     */
+    getComponentEventHandler() {
+        const handler = this.blueprint.get('stone.useReact.componentEventHandler');
+        if (isEmpty(handler)) {
+            throw new UseReactError('The component event handler is missing.');
+        }
+        return handler;
+    }
+}
 
 /**
   * Stone DOM Attribute.
@@ -269,16 +321,6 @@ const StoneError = () => {
     return (jsxs(Fragment, { children: [jsx("h1", { children: "An error occured" }), jsx("p", { children: "Sorry, something went wrong." })] }));
 };
 
-/**
- * Custom error for react operations.
- */
-class UseReactError extends InitializationError {
-    constructor(message, options) {
-        super(message, options);
-        this.name = 'UseReactError';
-    }
-}
-
 /**
  * Build the React application for the current route.
  * Or for the main handler if the route is not defined.
@@ -710,48 +752,6 @@ class ReactRuntime {
 */
 const MetaReactRuntime = { module: ReactRuntime, isClass: true, alias: 'reactRuntime', singleton: true };
 
-/**
- * A useReact event handler for processing incoming events
- * For single event handler.
- *
- * Multiple event handlers will be processed by the router.
- *
- * @template IncomingEventType - The type representing the incoming event.
- * @template OutgoingResponseType - The type representing the outgoing response.
- */
-class UseReactEventHandler {
-    blueprint;
-    /**
-     * Constructs a `UseReactEventHandler` instance.
-     *
-     * @param options - The UseReactEventHandler options including blueprint.
-     */
-    constructor({ blueprint }) {
-        this.blueprint = blueprint;
-    }
-    /**
-     * Handle an incoming event.
-     *
-     * @returns The outgoing response.
-     */
-    handle() {
-        return this.getComponentEventHandler();
-    }
-    /**
-     * Get the component event handler.
-     *
-     * @returns The component event handler.
-     * @throws {UseReactError} If the component event handler is missing.
-     */
-    getComponentEventHandler() {
-        const handler = this.blueprint.get('stone.useReact.componentEventHandler');
-        if (isEmpty(handler)) {
-            throw new UseReactError('The component event handler is missing.');
-        }
-        return handler;
-    }
-}
-
 /**
  * Class representing an UseReactUseReactKernelErrorHandler.
  *
@@ -1098,30 +1098,6 @@ const REACT_ADAPTER_ERROR_PAGE_KEY = Symbol.for('ReactAdapterErrorPage');
  */
 const STONE_REACT_APP_KEY = Symbol.for('StoneReactApp');
 
-/**
- * A class decorator for defining a class as a React Handler layout.
- *
- * @param options - Configuration options for the layout definition.
- * @returns A method decorator to be applied to a class method.
- *
- * @example
- * ```typescript
- * import { AdapterErrorPage } from '@stone-js/use-react';
- *
- * @AdapterErrorPage({ error: 'UserNotFoundError' })
- * class UserAdapterErrorPage {
- *   render({ error }) {
- *     return <h1>User name: {error.message}</h1>;
- *   }
- * }
- * ```
- */
-const AdapterErrorPage = (options) => {
-    return classDecoratorLegacyWrapper((_target, context) => {
-        setMetadata(context, REACT_ADAPTER_ERROR_PAGE_KEY, { ...options, isClass: true });
-    });
-};
-
 /**
  * A class decorator for defining a class as a React Handler layout.
  *
@@ -1147,37 +1123,24 @@ const ErrorPage = (options) => {
 };
 
 /**
- * A class decorator for defining a class as a React Page route action.
- * Uses the `Match` decorator internally to register the route with the HTTP `GET` method.
- *
- * @param options - Configuration options for the route definition, excluding the `methods` property.
- * @returns A method decorator to be applied to a class method.
+ * Hook decorator to mark a method as a lifecycle hook
+ * And automatically add it to the global lifecycle hook registry.
  *
  * @example
  * ```typescript
- * import { Page } from '@stone-js/use-react';
- *
- * @Page('/user-profile')
- * class UserPage {
- *   handle({ event }): Record<string, string> {
- *     return { name: 'Jane Doe' };
- *   }
- *
- *   render({ data }) {
- *     return <h1>User name: {data.name}</h1>;
- *   }
+ * class MyClass {
+ *    // ...
+ *    @Hook('onPreparingPage')
+ *    onPreparingPage () {}
  * }
  * ```
+ *
+ * @param name - The name of the lifecycle hook.
+ * @returns A class decorator function that sets the metadata using the provided options.
  */
-const Page = (path, options = {}) => {
-    return classDecoratorLegacyWrapper((target, context) => {
-        setMetadata(context, REACT_PAGE_KEY, {
-            ...options,
-            path,
-            method: GET,
-            methods: [],
-            handler: { isClass: true, isComponent: true, layout: options.layout, module: target }
-        });
+const Hook = (name) => {
+    return methodDecoratorLegacyWrapper((_target, context) => {
+        addMetadata(context, LIFECYCLE_HOOK_KEY, { name, method: context.name });
     });
 };
 
@@ -1206,24 +1169,26 @@ const PageLayout = (options) => {
 };
 
 /**
- * Hook decorator to mark a method as a lifecycle hook
- * And automatically add it to the global lifecycle hook registry.
+ * A class decorator for defining a class as a React Handler layout.
+ *
+ * @param options - Configuration options for the layout definition.
+ * @returns A method decorator to be applied to a class method.
  *
  * @example
  * ```typescript
- * class MyClass {
- *    // ...
- *    @Hook('onPreparingPage')
- *    onPreparingPage () {}
+ * import { AdapterErrorPage } from '@stone-js/use-react';
+ *
+ * @AdapterErrorPage({ error: 'UserNotFoundError' })
+ * class UserAdapterErrorPage {
+ *   render({ error }) {
+ *     return <h1>User name: {error.message}</h1>;
+ *   }
  * }
  * ```
- *
- * @param name - The name of the lifecycle hook.
- * @returns A class decorator function that sets the metadata using the provided options.
  */
-const Hook = (name) => {
-    return methodDecoratorLegacyWrapper((_target, context) => {
-        addMetadata(context, LIFECYCLE_HOOK_KEY, { name, method: context.name });
+const AdapterErrorPage = (options) => {
+    return classDecoratorLegacyWrapper((_target, context) => {
+        setMetadata(context, REACT_ADAPTER_ERROR_PAGE_KEY, { ...options, isClass: true });
     });
 };
 
@@ -1256,6 +1221,41 @@ const PageStatus = (statusCode = 200, headers = {}) => {
     });
 };
 
+/**
+ * A class decorator for defining a class as a React Page route action.
+ * Uses the `Match` decorator internally to register the route with the HTTP `GET` method.
+ *
+ * @param options - Configuration options for the route definition, excluding the `methods` property.
+ * @returns A method decorator to be applied to a class method.
+ *
+ * @example
+ * ```typescript
+ * import { Page } from '@stone-js/use-react';
+ *
+ * @Page('/user-profile')
+ * class UserPage {
+ *   handle({ event }): Record<string, string> {
+ *     return { name: 'Jane Doe' };
+ *   }
+ *
+ *   render({ data }) {
+ *     return <h1>User name: {data.name}</h1>;
+ *   }
+ * }
+ * ```
+ */
+const Page = (path, options = {}) => {
+    return classDecoratorLegacyWrapper((target, context) => {
+        setMetadata(context, REACT_PAGE_KEY, {
+            ...options,
+            path,
+            method: GET,
+            methods: [],
+            handler: { isClass: true, isComponent: true, layout: options.layout, module: target }
+        });
+    });
+};
+
 /**
  * Decorator to create a snapshot of the current data.
  *
@@ -1285,6 +1285,111 @@ const Snapshot = (name) => {
     });
 };
 
+/**
+ * Sets the error handler for the React adapter and registers error pages.
+ *
+ * @param errorHandler - The error handler to set for the React adapter.
+ * @param context - The blueprint context containing modules and blueprint.
+ * @returns The updated blueprint context with the error handler and error pages set.
+ */
+function setUseReactAdapterErrorHandler(errorHandler, context) {
+    context
+        .blueprint
+        .set('stone.adapter.errorHandlers.default', { module: errorHandler, isClass: true });
+    context
+        .modules
+        .filter(module => hasMetadata(module, REACT_ADAPTER_ERROR_PAGE_KEY))
+        .forEach(module => {
+        const { error, layout, adapterAlias, platform } = getMetadata(module, REACT_ADAPTER_ERROR_PAGE_KEY, { error: 'default' });
+        if (isMatchedAdapter(context.blueprint, platform, adapterAlias)) {
+            Array(error).flat().forEach(name => {
+                context
+                    .blueprint
+                    .set(`stone.useReact.adapterErrorPages.${name}`, { isClass: true, layout, module });
+            });
+        }
+    });
+    // Process both eager and lazy loaded error pages
+    Object
+        .keys(context.blueprint.get('stone.useReact.adapterErrorPages', {}))
+        .forEach((name) => {
+        context
+            .blueprint
+            .set(`stone.adapter.errorHandlers.${name}`, { module: errorHandler, isClass: true });
+    });
+    return context;
+}
+
+/**
+ * Create an UseReact response.
+ *
+ * @param options - The options for creating the response.
+ * @returns The React response.
+ */
+const reactResponse = (options) => {
+    if (isNotEmpty(options) &&
+        (isNotEmpty(options.url) ||
+            (isNotEmpty(options.content) && isNotEmpty(options.content.redirect)))) {
+        return reactRedirectResponse(options);
+    }
+    return OutgoingHttpResponse.create(options);
+};
+/**
+ * Create an UseReact redirect response.
+ *
+ * @param options - The options for creating the response.
+ * @returns The React redirect response.
+ */
+const reactRedirectResponse = (options) => {
+    return RedirectResponse.create({ statusCode: 302, ...options });
+};
+
+/**
+ * Class representing an UseReactServerErrorHandler.
+ *
+ * Adapter level error handler for React applications.
+ */
+class UseReactServerErrorHandler {
+    logger;
+    blueprint;
+    /**
+     * Create an UseReactServerErrorHandler.
+     *
+     * @param options - UseReactServerErrorHandler options.
+     */
+    constructor({ blueprint }) {
+        this.blueprint = blueprint;
+        this.logger = Logger.getInstance();
+    }
+    /**
+     * Handle an error.
+     *
+     * @param error - The error to handle.
+     * @param context - The context of the adapter.
+     * @returns The raw response.
+     */
+    async handle(error, context) {
+        this.logger.error(error.message, { error });
+        return context
+            .rawResponseBuilder
+            .add('statusCode', error.statusCode ?? 500)
+            .add('headers', new Headers({ 'Content-Type': 'text/html' }))
+            .add('body', await this.getErrorBody(error, context));
+    }
+    /**
+     * Get the error body.
+     *
+     * @param error - The error to handle.
+     * @returns The error body.
+    */
+    async getErrorBody(error, context) {
+        const statusCode = error.statusCode ?? 500;
+        const template = htmlTemplate(this.blueprint);
+        const ClientApp = await buildAdapterErrorComponent(this.blueprint, context, statusCode, error);
+        return template.replace('<!--app-html-->', renderToString(ClientApp));
+    }
+}
+
 /**
  * Blueprint middleware to dynamically set lifecycle hooks for react.
  *
@@ -1416,111 +1521,6 @@ async function SetUseReactEventHandlerMiddleware(context, next) {
     return blueprint;
 }
 
-/**
- * Sets the error handler for the React adapter and registers error pages.
- *
- * @param errorHandler - The error handler to set for the React adapter.
- * @param context - The blueprint context containing modules and blueprint.
- * @returns The updated blueprint context with the error handler and error pages set.
- */
-function setUseReactAdapterErrorHandler(errorHandler, context) {
-    context
-        .blueprint
-        .set('stone.adapter.errorHandlers.default', { module: errorHandler, isClass: true });
-    context
-        .modules
-        .filter(module => hasMetadata(module, REACT_ADAPTER_ERROR_PAGE_KEY))
-        .forEach(module => {
-        const { error, layout, adapterAlias, platform } = getMetadata(module, REACT_ADAPTER_ERROR_PAGE_KEY, { error: 'default' });
-        if (isMatchedAdapter(context.blueprint, platform, adapterAlias)) {
-            Array(error).flat().forEach(name => {
-                context
-                    .blueprint
-                    .set(`stone.useReact.adapterErrorPages.${name}`, { isClass: true, layout, module });
-            });
-        }
-    });
-    // Process both eager and lazy loaded error pages
-    Object
-        .keys(context.blueprint.get('stone.useReact.adapterErrorPages', {}))
-        .forEach((name) => {
-        context
-            .blueprint
-            .set(`stone.adapter.errorHandlers.${name}`, { module: errorHandler, isClass: true });
-    });
-    return context;
-}
-
-/**
- * Create an UseReact response.
- *
- * @param options - The options for creating the response.
- * @returns The React response.
- */
-const reactResponse = (options) => {
-    if (isNotEmpty(options) &&
-        (isNotEmpty(options.url) ||
-            (isNotEmpty(options.content) && isNotEmpty(options.content.redirect)))) {
-        return reactRedirectResponse(options);
-    }
-    return OutgoingHttpResponse.create(options);
-};
-/**
- * Create an UseReact redirect response.
- *
- * @param options - The options for creating the response.
- * @returns The React redirect response.
- */
-const reactRedirectResponse = (options) => {
-    return RedirectResponse.create({ statusCode: 302, ...options });
-};
-
-/**
- * Class representing an UseReactServerErrorHandler.
- *
- * Adapter level error handler for React applications.
- */
-class UseReactServerErrorHandler {
-    logger;
-    blueprint;
-    /**
-     * Create an UseReactServerErrorHandler.
-     *
-     * @param options - UseReactServerErrorHandler options.
-     */
-    constructor({ blueprint }) {
-        this.blueprint = blueprint;
-        this.logger = Logger.getInstance();
-    }
-    /**
-     * Handle an error.
-     *
-     * @param error - The error to handle.
-     * @param context - The context of the adapter.
-     * @returns The raw response.
-     */
-    async handle(error, context) {
-        this.logger.error(error.message, { error });
-        return context
-            .rawResponseBuilder
-            .add('statusCode', error.statusCode ?? 500)
-            .add('headers', new Headers({ 'Content-Type': 'text/html' }))
-            .add('body', await this.getErrorBody(error, context));
-    }
-    /**
-     * Get the error body.
-     *
-     * @param error - The error to handle.
-     * @returns The error body.
-    */
-    async getErrorBody(error, context) {
-        const statusCode = error.statusCode ?? 500;
-        const template = htmlTemplate(this.blueprint);
-        const ClientApp = await buildAdapterErrorComponent(this.blueprint, context, statusCode, error);
-        return template.replace('<!--app-html-->', renderToString(ClientApp));
-    }
-}
-
 /**
  * Blueprint middleware to process and register adapter error page definitions from modules.
  *
@@ -1624,6 +1624,47 @@ const StoneClient = ({ children }) => {
     return isClient() ? jsx(Fragment, { children: children }) : jsx(Fragment, {});
 };
 
+/**
+ * Internal link component using Stone.js router.
+ */
+const StoneLink = ({ to, href, noRel, external, children, ariaCurrentValue = 'page', selectedClass = 'selected', ...rest }) => {
+    const isExternal = external === true;
+    const shouldHandleNav = !isExternal && isNotEmpty(to);
+    const router = useContext(StoneContext).container.resolve(Router);
+    const path = useMemo(() => {
+        return isObjectLikeModule(to) ? router.generate(to) : to ?? href ?? '#';
+    }, [to, href, router]);
+    const [currentRoute, setCurrentRoute] = useState(router.getCurrentRoute());
+    const selectedClassName = currentRoute?.path === path ? selectedClass : undefined;
+    const elemClassName = [rest.className, selectedClassName].filter(Boolean).join(' ').trim();
+    const handleClick = (event) => {
+        rest.onClick?.(event);
+        if (event.defaultPrevented || isExternal)
+            return;
+        event.preventDefault();
+        isNotEmpty(to) && router.navigate(to);
+    };
+    if (isEmpty(to) && isEmpty(href)) {
+        Logger.warn('StoneLink: missing "to" or "href"');
+    }
+    useEffect(() => {
+        const routerEventHandler = (event) => {
+            setCurrentRoute(event.get('route'));
+        };
+        router.on(RouteEvent.ROUTED, routerEventHandler);
+        return () => {
+            router.off(RouteEvent.ROUTED, routerEventHandler);
+        };
+    }, [router]);
+    return (
+    // eslint-disable-next-line react/jsx-no-target-blank
+    jsx("a", { ...rest, href: path, className: elemClassName, target: isExternal ? '_blank' : rest.target, "aria-current": isNotEmpty(selectedClassName) ? ariaCurrentValue : undefined, rel: noRel === true
+            ? undefined
+            : isExternal
+                ? 'noopener noreferrer'
+                : rest.rel, onClick: shouldHandleNav ? handleClick : rest.onClick, children: children }));
+};
+
 /**
  * A dynamic rendering component that updates its content based on a global event.
  *
@@ -1636,7 +1677,7 @@ const StoneClient = ({ children }) => {
  * @param options - The options to create the Stone Outlet.
  * @returns The Stone Outlet component.
  */
-const StoneOutlet = ({ children }) => {
+const StoneOutlet = ({ children, ...rest }) => {
     const [currentView, setCurrentView] = useState(children);
     useEffect(() => {
         const eventName = STONE_PAGE_EVENT_OUTLET;
@@ -1648,44 +1689,7 @@ const StoneOutlet = ({ children }) => {
         window.addEventListener(eventName, handleEvent);
         return () => window.removeEventListener(eventName, handleEvent);
     }, []);
-    return jsx("div", { "data-stone-outlet": 'true', children: currentView });
-};
-
-/**
- * Internal link component using Stone.js router.
- */
-const InternalLink = ({ to, href, noRel, children, className, defaultNav, selectedClass = 'selected', ariaCurrentValue = 'page', rel = 'noopener noreferrer' }) => {
-    const router = useContext(StoneContext).container.resolve(Router);
-    const path = isObjectLikeModule(to) ? router.generate(to) : to ?? href;
-    const [currentRoute, setCurrentRoute] = useState(router.getCurrentRoute());
-    const selectedClassName = currentRoute?.path === path ? selectedClass : undefined;
-    const elemClassName = [className, selectedClassName].filter(Boolean).join(' ').trim();
-    const handleClick = (event) => {
-        event.preventDefault();
-        router.navigate(to ?? '');
-    };
-    useEffect(() => {
-        const routerEventHandler = (event) => {
-            setCurrentRoute(event.get('route'));
-        };
-        router.on(RouteEvent.ROUTED, routerEventHandler);
-        return () => {
-            router.off(RouteEvent.ROUTED, routerEventHandler);
-        };
-    }, [router]);
-    return defaultNav === true
-        ? (jsx("a", { href: path, className: elemClassName, "aria-current": ariaCurrentValue, rel: noRel !== undefined ? undefined : rel, children: children }))
-        : (jsx("button", { onClick: handleClick, className: elemClassName, "aria-current": ariaCurrentValue, rel: noRel !== undefined ? undefined : rel, children: children }));
-};
-/**
- * External link component rendering a regular <a> tag.
- */
-const ExternalLink = ({ to, href, noRel, target, children, className, ariaCurrentValue = 'page', rel = 'noopener noreferrer' }) => (jsx("a", { target: target, className: className, "aria-current": ariaCurrentValue, rel: noRel !== undefined ? undefined : rel, href: typeof to === 'string' ? to : href, children: children }));
-/**
- * Main StoneLink component delegating to internal or external versions.
- */
-const StoneLink = (props) => {
-    return props.external === true ? jsx(ExternalLink, { ...props }) : jsx(InternalLink, { ...props });
+    return jsx("div", { ...rest, "data-stone-outlet": 'true', children: currentView });
 };
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stone-js/use-react",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "React integration for Stone.js, universal rendering, SSR hydration, layouts, pages, snapshots, head management, and more.",
   "author": "Mr. Stone <evensstone@gmail.com>",
   "license": "MIT",
@@ -60,9 +60,9 @@
     "@stone-js/browser-adapter": "^0.1.0",
     "@stone-js/browser-core": "^0.1.1",
     "@stone-js/config": "^0.1.0",
-    "@stone-js/core": "^0.1.1",
+    "@stone-js/core": "^0.1.4",
     "@stone-js/http-core": "^0.1.2",
-    "@stone-js/router": "^0.1.0",
+    "@stone-js/router": "^0.2.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
@@ -72,25 +72,25 @@
     "@rollup/plugin-commonjs": "^28.0.5",
     "@rollup/plugin-multi-entry": "^6.0.1",
     "@rollup/plugin-node-resolve": "^16.0.1",
-    "@rollup/plugin-typescript": "^12.1.1",
+    "@rollup/plugin-typescript": "^12.1.4",
     "@testing-library/react": "^16.3.0",
-    "@types/node": "^24.0.0",
+    "@types/node": "^24.0.7",
     "@types/react": "^19.0.7",
     "@types/react-dom": "^19.0.3",
-    "@vitest/coverage-v8": "^3.2.3",
+    "@vitest/coverage-v8": "^3.2.4",
     "husky": "^9.1.7",
     "jsdom": "^26.1.0",
     "rimraf": "^6.0.1",
-    "rollup": "^4.43.0",
+    "rollup": "^4.44.1",
     "rollup-plugin-delete": "^3.0.1",
     "rollup-plugin-dts": "^6.2.1",
-    "rollup-plugin-node-externals": "^8.0.0",
+    "rollup-plugin-node-externals": "^8.0.1",
     "ts-standard": "^12.0.2",
     "tslib": "^2.8.1",
-    "typedoc": "^0.28.5",
-    "typedoc-plugin-markdown": "^4.6.4",
+    "typedoc": "^0.28.6",
+    "typedoc-plugin-markdown": "^4.7.0",
     "typescript": "^5.6.3",
-    "vitest": "^3.2.3"
+    "vitest": "^3.2.4"
   },
   "ts-standard": {
     "globals": [