@unsetsoft/ryunixjs 1.2.5-canary.12 → 1.2.5-canary.13

package/dist/Ryunix.umd.js

@@ -432,6 +432,7 @@
         const el = dom;
         const domEl = el;
         const handlerMap = domEl._ryunixHandlers;
+        const elRecord = el;
         Object.keys(prevProps)
             .filter(isEvent)
             .filter((key) => isGone(nextProps)(key) || isNew(prevProps, nextProps)(key))
@@ -466,7 +467,7 @@
                 el.removeAttribute(attrName);
             }
             else {
-                el[propKey] = '';
+                elRecord[propKey] = '';
                 el.removeAttribute(propKey);
             }
         });
@@ -487,8 +488,8 @@
                 }
                 else {
                     if (propKey === 'value' || propKey === 'checked') {
-                        if (el[propKey] !== nextProps[propKey]) {
-                            el[propKey] = nextProps[propKey];
+                        if (elRecord[propKey] !== nextProps[propKey]) {
+                            elRecord[propKey] = nextProps[propKey];
                         }
                     }
                     else {
@@ -496,15 +497,15 @@
                         if (isSvgNode) {
                             const attrName = toSvgAttrName(propKey);
                             const svgValidated = checkAttributeUri(attrName, nextProps[propKey]);
-                            el.setAttribute(attrName, svgValidated);
+                            el.setAttribute(attrName, String(svgValidated));
                         }
                         else {
                             const attrVal = nextProps[propKey];
                             const safeValue = checkAttributeUri(propKey, attrVal);
-                            el[propKey] = safeValue;
+                            elRecord[propKey] = safeValue;
                             if (typeof attrVal !== 'object' &&
                                 typeof attrVal !== 'function') {
-                                el.setAttribute(propKey, safeValue);
+                                el.setAttribute(propKey, String(safeValue));
                             }
                         }
                     }
@@ -671,9 +672,7 @@
                 }
                 try {
                     const cleanup = hook.effect();
-                    hook.cancel = is.function(cleanup)
-                        ? cleanup
-                        : null;
+                    hook.cancel = is.function(cleanup) ? cleanup : null;
                 }
                 catch (error) {
                     if (process.env.NODE_ENV !== 'production') {
@@ -705,9 +704,7 @@
                 }
                 try {
                     const cleanup = hook.effect();
-                    hook.cancel = is.function(cleanup)
-                        ? cleanup
-                        : null;
+                    hook.cancel = is.function(cleanup) ? cleanup : null;
                 }
                 catch (error) {
                     if (process.env.NODE_ENV !== 'production') {
@@ -723,6 +720,8 @@
         const state = getState();
         state.deletions.forEach(commitWork);
         const finishedWork = state.wipRoot;
+        if (!finishedWork)
+            return;
         state.currentRoot = finishedWork;
         if (state.isHydrating || state.hydrationFailed) {
             if (process.env.NODE_ENV !== 'production' && process.env.RYUNIX_DEBUG) {
@@ -779,6 +778,8 @@
             return;
         }
         const domParent = domParentFiber.dom;
+        if (!domParent)
+            return;
         if (fiber.effectTag === EFFECT_TAGS.PLACEMENT) {
             if (fiber.dom != null) {
                 if (process.env.NODE_ENV !== 'production' && process.env.RYUNIX_DEBUG) {
@@ -792,7 +793,7 @@
         else if (fiber.effectTag === EFFECT_TAGS.UPDATE) {
             cancelEffects(fiber);
             if (fiber.dom != null) {
-                updateDom(fiber.dom, fiber.alternate.props, fiber.props);
+                updateDom(fiber.dom, fiber.alternate?.props, fiber.props);
             }
             runLayoutEffects(fiber);
             runNormalEffects(fiber);
@@ -841,7 +842,7 @@
         else if (fiber.effectTag === EFFECT_TAGS.UPDATE) {
             cancelEffects(fiber);
             if (fiber.dom != null) {
-                updateDom(fiber.dom, fiber.alternate.props, fiber.props);
+                updateDom(fiber.dom, fiber.alternate?.props, fiber.props);
             }
             runLayoutEffects(fiber);
             runNormalEffects(fiber);
@@ -894,6 +895,12 @@
             let newFiber;
             const sameType = matchedFiber && element.type === matchedFiber.type;
             if (sameType && matchedFiber) {
+                const matchedType = matchedFiber.type;
+                const isErrorBoundary = typeof matchedFiber.type === 'function' &&
+                    matchedType?.ryunix_type === 'RYUNIX_ERROR_BOUNDARY';
+                const preserveBoundaryError = isErrorBoundary &&
+                    matchedFiber.stateError != null &&
+                    matchedFiber.child == null;
                 newFiber = {
                     type: matchedFiber.type,
                     props: element.props,
@@ -902,7 +909,7 @@
                     alternate: matchedFiber,
                     effectTag: EFFECT_TAGS.UPDATE,
                     hooks: matchedFiber.hooks,
-                    stateError: matchedFiber.stateError,
+                    stateError: preserveBoundaryError ? matchedFiber.stateError : undefined,
                     key: element.key,
                     index,
                 };
@@ -970,8 +977,7 @@
             const maybeTyped = type;
             if (type &&
                 typeof type === 'function' &&
-                (maybeTyped?.ryunix_type === 'RYUNIX_HYDRATION_BOUNDARY' ||
-                    maybeTyped?.ryunix_type === 'RYUNIX_SERVER_BOUNDARY')) {
+                maybeTyped?.ryunix_type === 'RYUNIX_HYDRATION_BOUNDARY') {
                 return current;
             }
             current = current.parent || null;
@@ -1037,11 +1043,15 @@
         const state = getState();
         state.wipFiber = fiber;
         state.hookIndex = 0;
-        state.wipFiber.hooks = [];
+        fiber.hooks = [];
+        const componentType = fiber.type;
+        if (state.hydrationRecover &&
+            componentType.ryunix_type === 'RYUNIX_ERROR_BOUNDARY') {
+            fiber.stateError = undefined;
+        }
         if (state.isHydrating) {
             fiber.effectTag = EFFECT_TAGS.HYDRATE;
         }
-        const componentType = fiber.type;
         if (componentType._isMemo && fiber.alternate) {
             const { children: _pc, ...prevRest } = fiber.alternate.props || {};
             const { children: _nc, ...nextRest } = fiber.props || {};
@@ -1055,7 +1065,7 @@
                 return;
             }
         }
-        let children = [
+        const children = [
             componentType(fiber.props),
         ];
         if (componentType._contextId && fiber.props?.value !== undefined) {
@@ -1073,11 +1083,24 @@
         }
         return false;
     };
+    const isUnderServerPreserveBoundary = (fiber) => {
+        let current = fiber?.parent || null;
+        while (current) {
+            if (current._hydratePreserveServer)
+                return true;
+            current = current.parent || null;
+        }
+        return false;
+    };
+    const normalizeChildNodes = (children) => {
+        if (children == null)
+            return [];
+        return Array.isArray(children) ? children : [children];
+    };
     const updateHostComponent = (fiber) => {
         const state = getState();
         if (fiber.type === RYUNIX_TYPES.RYUNIX_CONTEXT) {
-            fiber._contextId =
-                fiber.props?._contextId;
+            fiber._contextId = fiber.props?._contextId;
             fiber._contextValue = fiber.props?.value;
         }
         const isPassthrough = fiber.type === RYUNIX_TYPES.RYUNIX_FRAGMENT ||
@@ -1086,6 +1109,9 @@
         if (state.isHydrating && isPassthrough) {
             fiber.effectTag = EFFECT_TAGS.HYDRATE;
         }
+        else if (state.isHydrating && isUnderServerPreserveBoundary(fiber)) {
+            return;
+        }
         else if (state.isHydrating && isUnderClientOnlyBoundary(fiber)) {
             if (!fiber.dom) {
                 fiber.dom = createDom(fiber);
@@ -1108,6 +1134,13 @@
                         domNode.nodeValue = String(fiber.props.nodeValue);
                         logHydrationRecoverable('text');
                     }
+                    if (isElement &&
+                        domNode.hasAttribute('data-ryunix-server')) {
+                        fiber._hydratePreserveServer = true;
+                        state.hydrateCursor = nextValidSibling$1(domNode);
+                        reconcileChildren(fiber, []);
+                        return;
+                    }
                     if (isElement &&
                         domNode.hasAttribute('data-ryunix-hydrate-boundary')) {
                         fiber._hydrateClientOnly = true;
@@ -1116,7 +1149,7 @@
                 }
                 else {
                     const policy = getHydrationPolicy();
-                    const detail = `Mismatch at ${getTypeLabel(fiber.type)}. Expected ${domNode.nodeType === 1 ? domNode.tagName : 'text'} but got ${String(fiber.type)}.`;
+                    const detail = `Mismatch at ${getTypeLabel(fiber.type ?? 'unknown')}. Expected ${domNode.nodeType === 1 ? domNode.tagName : 'text'} but got ${String(fiber.type)}.`;
                     const boundaryFiber = findNearestHydrationBoundary(fiber);
                     const boundaryDom = (boundaryFiber ? getBoundaryDom(boundaryFiber) : null) ??
                         findBoundaryDomFromNode(state.hydrateCursor);
@@ -1148,7 +1181,10 @@
                 fiber.dom = createDom(fiber);
             }
         }
-        const children = fiber.props?.children || [];
+        if (fiber._hydratePreserveServer) {
+            return;
+        }
+        const children = normalizeChildNodes(fiber.props?.children);
         reconcileChildren(fiber, children);
     };
     const getTypeLabel = (type) => {
@@ -1172,6 +1208,11 @@
         }
     };
 
+    const getRootChild = (children) => {
+        if (children == null)
+            return undefined;
+        return Array.isArray(children) ? children[0] : children;
+    };
     const renderSubtree = (element, container) => {
         clearContainer(container);
         const root = {
@@ -1201,7 +1242,7 @@
         if (policy.recover === 'none')
             return;
         const container = state.containerRoot || state.currentRoot?.dom;
-        const element = state.currentRoot?.props?.children?.[0];
+        const element = getRootChild(state.currentRoot?.props?.children);
         if (!container || element == null)
             return;
         state.hydrationRecover = true;
@@ -1211,8 +1252,10 @@
         renderSubtree(element, container);
     };
     const runHydrationRecovery = () => {
+        const state = getState();
         recoverScopedHydrationFailures();
         recoverHydrationFailureIfNeeded();
+        state.hydrationRecover = false;
     };
 
     let workQueue = [];
@@ -1232,32 +1275,36 @@
             if (process.env.NODE_ENV !== 'production') {
                 console.error('[Ryunix ErrorBoundary] Caught error during render:', error);
                 try {
-                    const src = fiber.props && fiber.props.__source;
+                    const fiberProps = fiber.props;
+                    const src = fiberProps?.__source;
                     if (src && error && typeof error === 'object') {
+                        ;
                         error.__ryunix_source = src;
                     }
                     let targetFiber = fiber;
                     while (!error.__ryunix_source && targetFiber) {
-                        if (targetFiber.props && targetFiber.props.__source) {
-                            error.__ryunix_source = targetFiber.props.__source;
+                        const targetProps = targetFiber.props;
+                        if (targetProps?.__source) {
+                            ;
+                            error.__ryunix_source = targetProps.__source;
                         }
                         targetFiber = targetFiber.parent;
                     }
                 }
-                catch (e) { }
+                catch (_e) { }
             }
             let boundaryFiber = fiber.parent;
             let foundBoundary = false;
             while (boundaryFiber) {
                 if (boundaryFiber.type &&
-                    boundaryFiber.type
-                        .ryunix_type === 'RYUNIX_ERROR_BOUNDARY') {
+                    boundaryFiber.type.ryunix_type ===
+                        'RYUNIX_ERROR_BOUNDARY') {
                     foundBoundary = true;
                     break;
                 }
                 boundaryFiber = boundaryFiber.parent;
             }
-            if (foundBoundary) {
+            if (foundBoundary && boundaryFiber) {
                 if (process.env.NODE_ENV !== 'production') {
                     console.warn('[Ryunix ErrorBoundary] Recovering tree at nearest boundary.');
                 }
@@ -1284,6 +1331,7 @@
             }
             nextFiber = nextFiber.parent;
         }
+        return null;
     }
     const workLoop = (deadline) => {
         const state = getState();
@@ -1291,6 +1339,8 @@
         while ((state.nextUnitOfWork || workQueue.length > 0) && !shouldYield) {
             if (!state.nextUnitOfWork && workQueue.length > 0) {
                 const nextRoot = workQueue.shift();
+                if (!nextRoot)
+                    continue;
                 state.wipRoot = nextRoot;
                 state.nextUnitOfWork = nextRoot;
                 state.deletions = [];
@@ -1351,9 +1401,7 @@
         const root = {
             dom: container,
             props: {
-                children: [
-                    element,
-                ],
+                children: [element],
             },
             alternate: state.currentRoot,
             isHydrating: false,
@@ -1366,7 +1414,7 @@
     const nextValidSibling = (node) => {
         let next = node;
         while (next &&
-            ((next.nodeType === 3 && !next.nodeValue.trim()) ||
+            ((next.nodeType === 3 && !next.nodeValue?.trim()) ||
                 next.nodeType === 8 ||
                 (next.nodeType === 1 &&
                     next.hasAttribute('data-ryunix-ssr')))) {
@@ -1380,9 +1428,7 @@
         const root = {
             dom: container,
             props: {
-                children: [
-                    element,
-                ],
+                children: [element],
             },
             alternate: state.currentRoot,
             isHydrating: true,
@@ -1391,7 +1437,7 @@
         scheduleWork(root);
         return root;
     };
-    const init = (MainElement, root = '__ryunix', components = {}) => {
+    const init = (MainElement, root = '__ryunix', _components = {}) => {
         const state = getState();
         const container = document.getElementById(root);
         state.containerRoot = container;
@@ -1488,6 +1534,82 @@
         }
     };
 
+    const INTERNAL_META_KEYS = new Set([
+        'title',
+        'pageTitle',
+        'canonical',
+        'titleTemplate',
+        'titleDefault',
+        'lastmod',
+        'changefreq',
+        'priority',
+        'custom',
+        'icon',
+        'appleTouchIcon',
+    ]);
+    const isTitleConfig = (value) => is.object(value) &&
+        value !== null &&
+        ('default' in value || 'template' in value);
+    const pickString = (value) => typeof value === 'string' && value.trim() ? value.trim() : undefined;
+    function resolvePageMetadata(meta = {}, options = {}) {
+        const template = pickString(options.title?.template) ||
+            pickString(meta.titleTemplate) ||
+            (isTitleConfig(meta.title) ? pickString(meta.title.template) : undefined);
+        const defaultTitle = pickString(options.title?.prefix) ||
+            pickString(meta.titleDefault) ||
+            (isTitleConfig(meta.title) ? pickString(meta.title.default) : undefined) ||
+            'Ryunix App';
+        const pageTitle = pickString(meta.pageTitle) ||
+            (typeof meta.title === 'string' ? pickString(meta.title) : undefined);
+        let title = defaultTitle;
+        if (pageTitle) {
+            title =
+                template && template.includes('%s')
+                    ? template.replace('%s', pageTitle)
+                    : pageTitle;
+        }
+        const tags = {};
+        for (const [key, value] of Object.entries(meta)) {
+            if (INTERNAL_META_KEYS.has(key))
+                continue;
+            if (key === 'title' && isTitleConfig(value))
+                continue;
+            if (Array.isArray(value)) {
+                const items = value
+                    .map((item) => (typeof item === 'string' ? item.trim() : ''))
+                    .filter(Boolean);
+                if (items.length > 0)
+                    tags[key] = items;
+                continue;
+            }
+            if (typeof value === 'string' && value.trim()) {
+                tags[key] = value.trim();
+            }
+        }
+        if (pickString(meta.canonical)) {
+            tags.canonical = meta.canonical;
+        }
+        if (pickString(meta.icon)) {
+            tags.icon = meta.icon;
+        }
+        if (pickString(meta.appleTouchIcon)) {
+            tags.appleTouchIcon = meta.appleTouchIcon;
+        }
+        return { title, tags };
+    }
+    function mergeRouteMetadata(base = {}, next = {}) {
+        const merged = { ...base, ...next };
+        if (typeof next.title === 'string' && isTitleConfig(base.title)) {
+            if (!pickString(merged.titleTemplate) && pickString(base.title.template)) {
+                merged.titleTemplate = base.title.template;
+            }
+            if (!pickString(merged.titleDefault) && pickString(base.title.default)) {
+                merged.titleDefault = base.title.default;
+            }
+        }
+        return merged;
+    }
+
     const haveDepsChanged = (oldDeps, newDeps) => {
         if (!oldDeps || !newDeps)
             return true;
@@ -1527,6 +1649,8 @@
         validateHookContext();
         const { hookIndex } = state;
         const wipFiber = state.wipFiber;
+        if (!wipFiber.hooks)
+            wipFiber.hooks = [];
         const oldHook = wipFiber.alternate?.hooks?.[hookIndex];
         const hook = {
             hookID: hookIndex,
@@ -1566,8 +1690,7 @@
             };
             queueUpdate(() => scheduleWork$1(newRoot, priority));
         };
-        wipFiber.hooks[hookIndex] =
-            hook;
+        wipFiber.hooks[hookIndex] = hook;
         state.hookIndex++;
         return [hook.state, dispatch];
     };
@@ -1588,6 +1711,8 @@
         }
         const { hookIndex } = state;
         const wipFiber = state.wipFiber;
+        if (!wipFiber.hooks)
+            wipFiber.hooks = [];
         const oldHook = wipFiber.alternate?.hooks?.[hookIndex];
         const hasChanged = haveDepsChanged(oldHook?.deps, deps);
         const hook = {
@@ -1597,8 +1722,7 @@
             effect: hasChanged ? callback : null,
             cancel: oldHook?.cancel,
         };
-        wipFiber.hooks[hookIndex] =
-            hook;
+        wipFiber.hooks[hookIndex] = hook;
         state.hookIndex++;
     };
     const useRef = (initialValue) => {
@@ -1612,6 +1736,8 @@
         validateHookContext();
         const { hookIndex } = state;
         const wipFiber = state.wipFiber;
+        if (!wipFiber.hooks)
+            wipFiber.hooks = [];
         const oldHook = wipFiber.alternate?.hooks?.[hookIndex];
         const hook = {
             hookID: hookIndex,
@@ -1620,8 +1746,7 @@
                 ? oldHook.value
                 : { current: initialValue },
         };
-        wipFiber.hooks[hookIndex] =
-            hook;
+        wipFiber.hooks[hookIndex] = hook;
         state.hookIndex++;
         return hook.value;
     };
@@ -1642,6 +1767,8 @@
         }
         const { hookIndex } = state;
         const wipFiber = state.wipFiber;
+        if (!wipFiber.hooks)
+            wipFiber.hooks = [];
         const oldHook = wipFiber.alternate?.hooks?.[hookIndex];
         let value;
         if (oldHook && !haveDepsChanged(oldHook.deps, deps)) {
@@ -1664,8 +1791,7 @@
             value,
             deps,
         };
-        wipFiber.hooks[hookIndex] =
-            hook;
+        wipFiber.hooks[hookIndex] = hook;
         state.hookIndex++;
         return value;
     };
@@ -1676,7 +1802,7 @@
         return useMemo(() => callback, deps);
     };
     const createContext = (contextId = RYUNIX_TYPES.RYUNIX_CONTEXT, defaultValue = {}) => {
-        const Provider = ({ value, children }) => {
+        const Provider = ({ value, children, }) => {
             return createElement(RYUNIX_TYPES.RYUNIX_CONTEXT, { value, children, _contextId: contextId }, ...flattenArray([children]));
         };
         Provider._contextId = contextId;
@@ -1731,7 +1857,7 @@
     const useMetadata = (tags = {}, options = {}) => {
         const state = getState();
         if (state.isServerRendering) {
-            state.ssrMetadata = { ...state.ssrMetadata, ...tags };
+            state.ssrMetadata = mergeRouteMetadata((state.ssrMetadata || {}), tags);
             return;
         }
         useEffect(() => {
@@ -1762,6 +1888,8 @@
             Object.entries(tags).forEach(([key, value]) => {
                 if (['title', 'pageTitle', 'canonical'].includes(key))
                     return;
+                if (value == null)
+                    return;
                 const isProperty = key.startsWith('og:') || key.startsWith('twitter:');
                 const selector = `meta[${isProperty ? 'property' : 'name'}='${key}']`;
                 let meta = document.head.querySelector(selector);
@@ -1785,7 +1913,7 @@
         const pathname = path.split('?')[0].split('#')[0];
         const notFoundRoute = routes.find((route) => route.NotFound);
         const notFound = notFoundRoute
-            ? { route: { component: notFoundRoute.NotFound }, params: {} }
+            ? { route: { component: notFoundRoute.NotFound ?? null }, params: {} }
             : { route: { component: null }, params: {} };
         for (const route of routes) {
             if (route.subRoutes) {
@@ -1821,7 +1949,7 @@
         }
         return '/';
     };
-    const RouterProvider = ({ routes, children }) => {
+    const RouterProvider = ({ routes, children, }) => {
         if (typeof window === 'undefined') {
             const location = getSsrPathname();
             const currentRouteData = findRoute(routes, location);
@@ -1855,7 +1983,7 @@
         const currentRouteData = findRoute(routes, location);
         const query = useQuery();
         const contextValue = {
-            location,
+            location: location,
             params: currentRouteData.params || {},
             query,
             navigate,
@@ -1877,10 +2005,13 @@
                 const el = document.getElementById(id);
                 if (el)
                     el.scrollIntoView({ block: 'start', behavior: 'smooth' });
+                return;
+            }
+            if (typeof window !== 'undefined') {
+                window.scrollTo(0, 0);
             }
-        }, [hash]);
+        }, [location, hash]);
         return createElement(route.component, {
-            key: location,
             params,
             query,
             hash,
@@ -1911,14 +2042,14 @@
             href: to,
             onClick: handleClick,
             onMouseEnter: handleMouseEnter,
-            className: props.className || props['ryunix-class'],
+            className: (props.className || props['ryunix-class']),
             ...cleanedProps,
         }, props.children);
     };
     const NavLink = ({ to, exact = false, ...props }) => {
         const { location, navigate } = useRouter();
         const isActive = exact ? location === to : location.startsWith(to);
-        const resolveClass = (cls) => typeof cls === 'function' ? cls({ isActive }) : cls || '';
+        const resolveClass = (cls) => (typeof cls === 'function' ? cls({ isActive }) : cls || '');
         const handleClick = (e) => {
             if (e.button !== 0 || e.metaKey || e.altKey || e.ctrlKey || e.shiftKey) {
                 return;
@@ -1927,7 +2058,7 @@
             navigate(to);
         };
         const classAttrName = props['ryunix-class'] ? 'ryunix-class' : 'className';
-        const classAttrValue = resolveClass(props['ryunix-class'] || props.className);
+        const classAttrValue = resolveClass((props['ryunix-class'] || props.className));
         const { ['ryunix-class']: _omitRyunix, className: _omitClassName, ...cleanedProps } = props;
         return createElement('a', {
             href: to,
@@ -1979,7 +2110,7 @@
                 const item = window.localStorage.getItem(key);
                 return item ? JSON.parse(item) : initialState;
             }
-            catch (error) {
+            catch (_error) {
                 return initialState;
             }
         });
@@ -2018,6 +2149,8 @@
         }
         const { hookIndex } = state;
         const wipFiber = state.wipFiber;
+        if (!wipFiber.hooks)
+            wipFiber.hooks = [];
         const oldHook = wipFiber.alternate?.hooks?.[hookIndex];
         const hasChanged = haveDepsChanged(oldHook?.deps, deps);
         const hook = {
@@ -2028,8 +2161,7 @@
             cancel: oldHook?.cancel,
             isLayout: true,
         };
-        wipFiber.hooks[hookIndex] =
-            hook;
+        wipFiber.hooks[hookIndex] = hook;
         state.hookIndex++;
     };
     let idCounter = 0;
@@ -2044,16 +2176,15 @@
         validateHookContext();
         const { hookIndex } = state;
         const wipFiber = state.wipFiber;
+        if (!wipFiber.hooks)
+            wipFiber.hooks = [];
         const oldHook = wipFiber.alternate?.hooks?.[hookIndex];
         const hook = {
             hookID: hookIndex,
             type: RYUNIX_TYPES.RYUNIX_REF,
-            value: oldHook
-                ? oldHook.value
-                : `:r${idCounter++}:`,
+            value: oldHook ? oldHook.value : `:r${idCounter++}:`,
         };
-        wipFiber.hooks[hookIndex] =
-            hook;
+        wipFiber.hooks[hookIndex] = hook;
         state.hookIndex++;
         return hook.value;
     };
@@ -2088,6 +2219,7 @@
         return throttledValue;
     };
 
+    const ASYNC_RENDER_ERROR = 'Async components require renderToStringAsync or renderToReadableStream, not renderToString';
     const escapeHtml = (unsafe) => {
         if (typeof unsafe !== 'string')
             return String(unsafe);
@@ -2122,6 +2254,83 @@
         'track',
         'wbr',
     ]);
+    const normalizeChildren = (children) => {
+        if (children == null)
+            return [];
+        return Array.isArray(children) ? children : [children];
+    };
+    const assertSyncRenderResult = (rendered) => {
+        if (rendered != null &&
+            typeof rendered === 'object' &&
+            'then' in rendered &&
+            typeof rendered.then === 'function') {
+            throw new Error(ASYNC_RENDER_ERROR);
+        }
+        return rendered;
+    };
+    const buildHostProps = (props, renderChild) => {
+        let attributes = '';
+        let htmlChildren = '';
+        let innerHTML = null;
+        Object.entries(props).forEach(([key, value]) => {
+            if (key === 'children') {
+                if (Array.isArray(value)) {
+                    htmlChildren = value
+                        .map((child) => renderChild(child))
+                        .join('');
+                }
+                else {
+                    htmlChildren = renderChild(value);
+                }
+            }
+            else if (key === 'dangerouslySetInnerHTML') {
+                const inner = value;
+                if (inner?.__html) {
+                    innerHTML = inner.__html;
+                }
+            }
+            else if (key === STRINGS.STYLE || key === OLD_STRINGS.STYLE) {
+                const styleString = renderStyle(value);
+                if (styleString) {
+                    attributes += ` style="${escapeHtml(styleString)}"`;
+                }
+            }
+            else if (key === STRINGS.CLASS_NAME || key === OLD_STRINGS.CLASS_NAME) {
+                if (value) {
+                    attributes += ` class="${escapeHtml(value)}"`;
+                }
+            }
+            else if (!key.startsWith('on') &&
+                key !== 'key' &&
+                key !== 'ref' &&
+                key !== '__source' &&
+                key !== '__self') {
+                if (typeof value === 'boolean') {
+                    if (value)
+                        attributes += ` ${key}=""`;
+                }
+                else if (value != null) {
+                    const attrName = toSvgAttrName(key);
+                    const validatedValue = validateUri(attrName, value);
+                    attributes += ` ${attrName}="${escapeHtml(validatedValue)}"`;
+                }
+            }
+        });
+        return { attributes, innerHTML, htmlChildren };
+    };
+    const formatHostOpenTag = (hostTag, attributes) => {
+        if (VOID_ELEMENTS.has(hostTag)) {
+            return `<${hostTag}${attributes} />`;
+        }
+        return `<${hostTag}${attributes}>`;
+    };
+    const beginSsrRender = () => {
+        const state = getState();
+        state.isServerRendering = true;
+        state.ssrMetadata = {};
+        state.ssrContexts = {};
+        resetIdCounter();
+    };
     const renderToStringImpl = (element) => {
         if (element == null || typeof element === 'boolean') {
             return '';
@@ -2134,20 +2343,18 @@
         }
         const vnode = element;
         if (vnode.type === RYUNIX_TYPES.TEXT_ELEMENT) {
-            return escapeHtml(vnode.props
-                .nodeValue);
+            return escapeHtml(vnode.props.nodeValue);
         }
         if (vnode.type === RYUNIX_TYPES.RYUNIX_FRAGMENT) {
-            const children = vnode.props?.children || [];
+            const children = normalizeChildren(vnode.props?.children);
             return children.map((child) => renderToStringImpl(child)).join('');
         }
         if (vnode.type === RYUNIX_TYPES.RYUNIX_CONTEXT) {
             const state = getState();
             state.ssrContexts = state.ssrContexts || {};
-            const ctxProps = vnode.props ||
-                {};
+            const ctxProps = (vnode.props || {});
             const ctxId = ctxProps._contextId;
-            const prevCtx = state.ssrContexts[ctxId];
+            const prevCtx = ctxId ? state.ssrContexts[ctxId] : undefined;
             if (ctxId) {
                 state.ssrContexts[ctxId] = ctxProps.value;
             }
@@ -2167,61 +2374,17 @@
         if (typeof vnode.type === 'function') {
             const type = vnode.type;
             const props = vnode.props || {};
-            const renderedElement = type(props);
+            const renderedElement = assertSyncRenderResult(type(props));
             return renderToStringImpl(renderedElement);
         }
         const type = String(vnode.type);
         const props = vnode.props || {};
-        let attributes = '';
-        let htmlChildren = '';
-        let innerHTML = null;
-        Object.entries(props).forEach(([key, value]) => {
-            if (key === 'children') {
-                if (Array.isArray(value)) {
-                    htmlChildren = value.map((child) => renderToStringImpl(child)).join('');
-                }
-                else {
-                    htmlChildren = renderToStringImpl(value);
-                }
-            }
-            else if (key === 'dangerouslySetInnerHTML') {
-                const inner = value;
-                if (inner?.__html) {
-                    innerHTML = inner.__html;
-                }
-            }
-            else if (key === STRINGS.STYLE || key === OLD_STRINGS.STYLE) {
-                const styleString = renderStyle(value);
-                if (styleString) {
-                    attributes += ` style="${escapeHtml(styleString)}"`;
-                }
-            }
-            else if (key === STRINGS.CLASS_NAME || key === OLD_STRINGS.CLASS_NAME) {
-                if (value) {
-                    attributes += ` class="${escapeHtml(value)}"`;
-                }
-            }
-            else if (!key.startsWith('on') &&
-                key !== 'key' &&
-                key !== 'ref' &&
-                key !== '__source' &&
-                key !== '__self') {
-                if (typeof value === 'boolean') {
-                    if (value)
-                        attributes += ` ${key}=""`;
-                }
-                else if (value != null) {
-                    let attrName = toSvgAttrName(key);
-                    let validatedValue = validateUri(attrName, value);
-                    attributes += ` ${attrName}="${escapeHtml(validatedValue)}"`;
-                }
-            }
-        });
+        const { attributes, innerHTML, htmlChildren } = buildHostProps(props, renderToStringImpl);
         if (VOID_ELEMENTS.has(type)) {
-            return `<${type}${attributes} />`;
+            return formatHostOpenTag(type, attributes);
         }
         const finalContent = innerHTML !== null ? innerHTML : htmlChildren;
-        return `<${type}${attributes}>${finalContent}</${type}>`;
+        return `${formatHostOpenTag(type, attributes)}${finalContent}</${type}>`;
     };
     const RC_SCRIPT = `
 function $RC(id, templateId) {
@@ -2236,13 +2399,11 @@ function $RC(id, templateId) {
         .replace(/\s+/g, ' ')
         .trim();
     const renderToStreamImpl = async (element, push, suspenseTasks = []) => {
-        if (element == null || typeof element === 'boolean') {
-            return;
-        }
         if (element instanceof Promise) {
             element = await element;
-            if (element == null || typeof element === 'boolean')
-                return;
+        }
+        if (element == null || typeof element === 'boolean') {
+            return;
         }
         if (typeof element === 'string' || typeof element === 'number') {
             push(escapeHtml(element));
@@ -2256,12 +2417,11 @@ function $RC(id, templateId) {
         }
         const vnode = element;
         if (vnode.type === RYUNIX_TYPES.TEXT_ELEMENT) {
-            push(escapeHtml(vnode
-                .props.nodeValue));
+            push(escapeHtml(vnode.props.nodeValue));
             return;
         }
         if (vnode.type === RYUNIX_TYPES.RYUNIX_FRAGMENT) {
-            const children = vnode.props?.children || [];
+            const children = normalizeChildren(vnode.props?.children);
             for (const child of children) {
                 await renderToStreamImpl(child, push, suspenseTasks);
             }
@@ -2270,10 +2430,9 @@ function $RC(id, templateId) {
         if (vnode.type === RYUNIX_TYPES.RYUNIX_CONTEXT) {
             const state = getState();
             state.ssrContexts = state.ssrContexts || {};
-            const ctxProps = vnode.props ||
-                {};
+            const ctxProps = (vnode.props || {});
             const ctxId = ctxProps._contextId;
-            const prevCtx = state.ssrContexts[ctxId];
+            const prevCtx = ctxId ? state.ssrContexts[ctxId] : undefined;
             if (ctxId) {
                 state.ssrContexts[ctxId] = ctxProps.value;
             }
@@ -2295,11 +2454,9 @@ function $RC(id, templateId) {
         const isSuspenseBoundary = vnode.type === RYUNIX_TYPES.RYUNIX_SUSPENSE ||
             (typeof suspenseType === 'object' &&
                 suspenseType != null &&
-                suspenseType.type ===
-                    RYUNIX_TYPES.RYUNIX_SUSPENSE);
+                suspenseType.type === RYUNIX_TYPES.RYUNIX_SUSPENSE);
         if (isSuspenseBoundary) {
-            const suspenseProps = vnode.props ||
-                {};
+            const suspenseProps = (vnode.props || {});
             const { fallback, children } = suspenseProps;
             const id = `s-${Math.random().toString(36).slice(2, 9)}`;
             push(`<!--$?--><template id="B:${id}"></template><div id="S:${id}">`);
@@ -2321,14 +2478,14 @@ function $RC(id, templateId) {
                 finally {
                     state.isSuspenseBackground = wasBackground;
                 }
-            })();
+            });
             suspenseTasks.push(task);
             await renderToStreamImpl(fallback, push, suspenseTasks);
             push(`</div><!--$/-->`);
             return;
         }
-        let type = vnode.type;
-        let props = vnode.props || {};
+        const type = vnode.type;
+        const props = vnode.props || {};
         if (typeof type === 'function') {
             if (process.env.RYUNIX_DEBUG) {
                 console.log('[SSR Debug] Rendering function:', type.name || 'anonymous');
@@ -2338,49 +2495,13 @@ function $RC(id, templateId) {
             return;
         }
         const hostTag = String(type);
-        let attributes = '';
-        let innerHTML = null;
-        let children = props.children || [];
-        Object.entries(props).forEach(([key, value]) => {
-            if (key === 'children') ;
-            else if (key === 'dangerouslySetInnerHTML') {
-                const inner = value;
-                if (inner?.__html) {
-                    innerHTML = inner.__html;
-                }
-            }
-            else if (key === STRINGS.STYLE || key === OLD_STRINGS.STYLE) {
-                const styleString = renderStyle(value);
-                if (styleString) {
-                    attributes += ` style="${escapeHtml(styleString)}"`;
-                }
-            }
-            else if (key === STRINGS.CLASS_NAME || key === OLD_STRINGS.CLASS_NAME) {
-                if (value) {
-                    attributes += ` class="${escapeHtml(value)}"`;
-                }
-            }
-            else if (!key.startsWith('on') &&
-                key !== 'key' &&
-                key !== 'ref' &&
-                key !== '__source' &&
-                key !== '__self') {
-                if (typeof value === 'boolean') {
-                    if (value)
-                        attributes += ` ${key}=""`;
-                }
-                else if (value != null) {
-                    const attrName = toSvgAttrName(key);
-                    const validatedValue = validateUri(attrName, value);
-                    attributes += ` ${attrName}="${escapeHtml(validatedValue)}"`;
-                }
-            }
-        });
-        push(`<${hostTag}${attributes}>`);
+        const children = props.children || [];
+        const { attributes, innerHTML } = buildHostProps(props, () => '');
+        push(formatHostOpenTag(hostTag, attributes));
         if (innerHTML !== null) {
             push(innerHTML);
         }
-        else {
+        else if (!VOID_ELEMENTS.has(hostTag)) {
             if (Array.isArray(children)) {
                 for (const child of children) {
                     await renderToStreamImpl(child, push, suspenseTasks);
@@ -2389,20 +2510,30 @@ function $RC(id, templateId) {
             else {
                 await renderToStreamImpl(children, push, suspenseTasks);
             }
-        }
-        if (!VOID_ELEMENTS.has(hostTag)) {
             push(`</${hostTag}>`);
         }
     };
+    const handleSuspenseTaskResult = (res, push, nonceAttr) => {
+        if (res.success) {
+            push(`<template id="P:${res.id}" data-ryunix-ssr>${res.content}</template>`);
+            push(`<script${nonceAttr} data-ryunix-ssr>$RC("S:${res.id}", "P:${res.id}")</script>`);
+            return;
+        }
+        const message = res.error instanceof Error
+            ? res.error.message
+            : String(res.error ?? 'Unknown error');
+        if (process.env.NODE_ENV !== 'production') {
+            console.error('[Ryunix SSR] Suspense boundary failed:', res.error);
+        }
+        push(`<!-- Ryunix Suspense error: ${escapeHtml(message)} -->`);
+    };
     const renderToReadableStream = (element, options = {}) => {
         const state = getState();
         const encoder = new TextEncoder();
-        resetIdCounter();
         return new ReadableStream({
             async start(controller) {
                 const wasServerRendering = state.isServerRendering;
-                state.isServerRendering = true;
-                state.ssrMetadata = {};
+                beginSsrRender();
                 const push = (text) => controller.enqueue(encoder.encode(text));
                 const suspenseTasks = [];
                 try {
@@ -2411,11 +2542,10 @@ function $RC(id, templateId) {
                     await renderToStreamImpl(element, push, suspenseTasks);
                     while (suspenseTasks.length > 0) {
                         const task = suspenseTasks.shift();
-                        const res = await task;
-                        if (res.success) {
-                            push(`<template id="P:${res.id}" data-ryunix-ssr>${res.content}</template>`);
-                            push(`<script${nonceAttr} data-ryunix-ssr>$RC("S:${res.id}", "P:${res.id}")</script>`);
-                        }
+                        if (!task)
+                            continue;
+                        const res = await task();
+                        handleSuspenseTaskResult(res, push, nonceAttr);
                     }
                     controller.close();
                 }
@@ -2428,12 +2558,10 @@ function $RC(id, templateId) {
             },
         });
     };
-    const renderToString = (element, options = {}) => {
+    const renderToString = (element, _options = {}) => {
         const state = getState();
         const wasServerRendering = state.isServerRendering;
-        state.isServerRendering = true;
-        state.ssrMetadata = {};
-        resetIdCounter();
+        beginSsrRender();
         try {
             return renderToStringImpl(element);
         }
@@ -2587,7 +2715,9 @@ function $RC(id, templateId) {
         if (anyPending && !getState().isSuspenseBackground) {
             return fallback || null;
         }
-        return createElement(Fragment, { children });
+        return createElement(Fragment, {
+            children: children,
+        });
     };
     Suspense.type = RYUNIX_TYPES.RYUNIX_SUSPENSE;
     function preload(importFn) {
@@ -2597,6 +2727,7 @@ function $RC(id, templateId) {
     var index = /*#__PURE__*/Object.freeze({
         __proto__: null,
         Children: Children,
+        INTERNAL_META_KEYS: INTERNAL_META_KEYS,
         Link: Link,
         NavLink: NavLink,
         RouterProvider: RouterProvider,
@@ -2606,8 +2737,10 @@ function $RC(id, templateId) {
         forwardRef: forwardRef,
         lazy: lazy,
         memo: memo,
+        mergeRouteMetadata: mergeRouteMetadata,
         preload: preload,
         resetIdCounter: resetIdCounter,
+        resolvePageMetadata: resolvePageMetadata,
         shallowEqual: shallowEqual,
         useCallback: useCallback,
         useDebounce: useDebounce,
@@ -2754,11 +2887,11 @@ function $RC(id, templateId) {
         return Profiled;
     }
 
-    function ServerBoundary({ children, id }) {
+    function ServerBoundary({ children, id, }) {
         return createElement('div', { 'data-ryunix-server': id, style: { display: 'contents' } }, children);
     }
     ServerBoundary.ryunix_type = 'RYUNIX_SERVER_BOUNDARY';
-    function HydrationBoundary({ children, id }) {
+    function HydrationBoundary({ children, id, }) {
         return createElement('div', {
             'data-ryunix-hydrate-boundary': id ?? '',
             suppressHydrationWarning: true,
@@ -2793,7 +2926,7 @@ function $RC(id, templateId) {
                 body: JSON.stringify({ actionId, args }),
             });
             if (!response.ok) {
-                const errorData = await response.json().catch(() => ({}));
+                const errorData = (await response.json().catch(() => ({})));
                 throw new Error(errorData.error || 'Server Action failed');
             }
             return response.json();
@@ -2819,9 +2952,7 @@ function $RC(id, templateId) {
             else if ('error' in rawError) {
                 const nested = rawError.error;
                 error =
-                    nested && typeof nested === 'object'
-                        ? nested
-                        : null;
+                    nested && typeof nested === 'object' ? nested : null;
             }
             else {
                 error = rawError;
@@ -3159,9 +3290,7 @@ function $RC(id, templateId) {
                     if (parts.length >= 2) {
                         const lastPart = parts[parts.length - 1];
                         const colonIdx = lastPart.indexOf(':');
-                        const fileCandidate = colonIdx > 0
-                            ? lastPart.slice(0, colonIdx)
-                            : lastPart;
+                        const fileCandidate = colonIdx > 0 ? lastPart.slice(0, colonIdx) : lastPart;
                         if (exts.some((ext) => fileCandidate.endsWith(ext))) {
                             fnName = parts.slice(0, -1).join(' ');
                             filePath = lastPart;
@@ -3448,9 +3577,243 @@ function $RC(id, templateId) {
             : null, bottomBar));
     }
 
+    function getRyunixI18nConfig() {
+        try {
+            const value = ryunix.config.i18n;
+            if (value && Array.isArray(value.locales) && value.locales.length > 0) {
+                return value;
+            }
+        }
+        catch {
+        }
+        return null;
+    }
+
+    function defineMessages(messages) {
+        return messages;
+    }
+    function resolveMessageKey(tree, key) {
+        if (!tree)
+            return undefined;
+        const parts = key.split('.');
+        let node = tree;
+        for (const part of parts) {
+            if (node == null || typeof node === 'string')
+                return undefined;
+            node = node[part];
+        }
+        return typeof node === 'string' ? node : undefined;
+    }
+    function formatMessage(template, params) {
+        if (!params)
+            return template;
+        return Object.entries(params).reduce((value, [name, replacement]) => value.replace(new RegExp(`\\{${escapeRegExp$2(name)}\\}`, 'g'), String(replacement)), template);
+    }
+    function escapeRegExp$2(value) {
+        return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    }
+
+    function normalizeI18nConfig(config) {
+        const locales = [...new Set(config.locales.filter(Boolean))];
+        if (locales.length === 0) {
+            throw new Error('[Ryunix i18n] At least one locale is required.');
+        }
+        const defaultLocale = locales.includes(config.defaultLocale)
+            ? config.defaultLocale
+            : locales[0];
+        return { ...config, locales, defaultLocale };
+    }
+    function pickLocale(record, locale, fallback) {
+        return record?.[locale] ?? record?.[fallback];
+    }
+    function getLocaleFromPath(pathname, locales) {
+        if (typeof pathname !== 'string' || locales.length === 0)
+            return null;
+        const pattern = new RegExp(`^/(${locales.map(escapeRegExp$1).join('|')})(/|$)`);
+        const match = pathname.match(pattern);
+        return match ? match[1] : null;
+    }
+    function localePath(locale, path = '', locales) {
+        const normalized = path.startsWith('/') ? path : path ? `/${path}` : '';
+        if (!locales.includes(locale))
+            return normalized || '/';
+        if (!normalized || normalized === '/')
+            return `/${locale}`;
+        return `/${locale}${normalized}`;
+    }
+    function swapLocalePath(pathname, targetLocale, options) {
+        const { locales } = options;
+        if (!locales.includes(targetLocale))
+            return pathname;
+        const current = getLocaleFromPath(pathname, locales);
+        if (current) {
+            const rest = pathname.slice(current.length + 1) || '';
+            return localePath(targetLocale, rest, locales);
+        }
+        if (pathname.startsWith('/')) {
+            return localePath(targetLocale, pathname, locales);
+        }
+        return localePath(targetLocale, '', locales);
+    }
+    function escapeRegExp$1(value) {
+        return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    }
+
+    const DEFAULT_LOCALE_COOKIE_NAME = 'ryunix_locale';
+    function resolveCookieOptions(cookie, cookieName, maxAgeSeconds) {
+        const enabled = cookie !== false;
+        const cookieConfig = typeof cookie === 'object' ? cookie : {};
+        return {
+            enabled,
+            cookieName: cookieName ?? cookieConfig.name ?? DEFAULT_LOCALE_COOKIE_NAME,
+            maxAgeSeconds: maxAgeSeconds ?? cookieConfig.maxAgeSeconds ?? 365 * 24 * 60 * 60,
+        };
+    }
+    function normalizeOptions(options) {
+        const base = normalizeI18nConfig({
+            locales: options.locales,
+            defaultLocale: options.defaultLocale,
+        });
+        const cookie = resolveCookieOptions(options.cookie, options.cookieName, options.maxAgeSeconds);
+        const localeLabels = { ...options.localeLabels };
+        for (const locale of base.locales) {
+            if (!localeLabels[locale])
+                localeLabels[locale] = locale.toUpperCase();
+        }
+        return {
+            locales: base.locales,
+            defaultLocale: base.defaultLocale,
+            localeLabels,
+            cookieName: cookie.cookieName,
+            maxAgeSeconds: cookie.maxAgeSeconds,
+            cookieEnabled: cookie.enabled,
+            messages: options.messages ?? {},
+        };
+    }
+    function createTranslate(messages, locale, defaultLocale) {
+        return (key, params) => {
+            const value = resolveMessageKey(messages[locale], key) ??
+                resolveMessageKey(messages[defaultLocale], key) ??
+                key;
+            return formatMessage(value, params);
+        };
+    }
+    function createI18n(options) {
+        const config = normalizeOptions(options);
+        const { Provider: I18nContextProvider, useContext } = createContext('ryunix.i18n', {
+            locale: config.defaultLocale,
+            defaultLocale: config.defaultLocale,
+            locales: config.locales,
+            localeLabels: config.localeLabels,
+            t: (key) => key,
+        });
+        const isLocale = (value) => typeof value === 'string' && config.locales.includes(value);
+        const getLocaleCookie = () => {
+            if (!config.cookieEnabled || typeof document === 'undefined')
+                return null;
+            const pattern = new RegExp(`(?:^|;\\s*)${config.cookieName}=(${config.locales.map(escapeRegExp).join('|')})(?:;|$)`);
+            const match = document.cookie.match(pattern);
+            return match ? match[1] : null;
+        };
+        const setLocaleCookie = (locale) => {
+            if (!config.cookieEnabled ||
+                typeof document === 'undefined' ||
+                !isLocale(locale))
+                return;
+            document.cookie = `${config.cookieName}=${locale}; path=/; max-age=${config.maxAgeSeconds}; SameSite=Lax`;
+        };
+        const resolveLocaleFromCookie = () => getLocaleCookie() || config.defaultLocale;
+        const getLocaleRedirectScript = () => {
+            if (!config.cookieEnabled)
+                return '';
+            const localesPattern = config.locales.map(escapeRegExp).join('|');
+            return `(function(){try{var m=document.cookie.match(/(?:^|;\\s*)${config.cookieName}=(${localesPattern})(?:;|$)/);var l=m?m[1]:'${config.defaultLocale}';var p=location.pathname;var r=new RegExp('^/(${localesPattern})(/|$)');if(!r.test(p)){location.replace('/'+l+(p==='/'?'':p));}}catch(e){}})();`;
+        };
+        const Provider = ({ locale, children, }) => {
+            const resolved = isLocale(locale) ? locale : config.defaultLocale;
+            const value = {
+                locale: resolved,
+                defaultLocale: config.defaultLocale,
+                locales: config.locales,
+                localeLabels: config.localeLabels,
+                t: createTranslate(config.messages, resolved, config.defaultLocale),
+            };
+            return createElement(I18nContextProvider, { value, children });
+        };
+        const useI18n = () => useContext();
+        const useLocale = () => useI18n().locale;
+        const useTranslations = () => useI18n().t;
+        const generateStaticParams = () => config.locales.map((locale) => ({ locale }));
+        const LocaleSwitcher = ({ className = '' }) => {
+            const { location, navigate } = useRouter();
+            const { locale: current, localeLabels, locales } = useI18n();
+            const onSelect = (locale) => {
+                if (locale === current)
+                    return;
+                setLocaleCookie(locale);
+                const next = swapLocalePath(location, locale, {
+                    locales,
+                    defaultLocale: config.defaultLocale,
+                });
+                navigate(next.startsWith(`/${locale}`) ? next : `/${locale}`);
+            };
+            return createElement('div', {
+                className: `ryunix-locale-switcher ${className}`.trim(),
+                role: 'group',
+                'aria-label': 'Language',
+                children: locales.map((locale) => createElement('button', {
+                    key: locale,
+                    type: 'button',
+                    onClick: () => onSelect(locale),
+                    className: locale === current
+                        ? 'ryunix-locale-switcher__btn is-active'
+                        : 'ryunix-locale-switcher__btn',
+                    'aria-current': locale === current ? 'true' : undefined,
+                }, localeLabels[locale] ?? locale)),
+            });
+        };
+        return {
+            config,
+            Provider,
+            useI18n,
+            useLocale,
+            useTranslations,
+            LocaleSwitcher,
+            generateStaticParams,
+            getLocaleFromPath: (pathname) => getLocaleFromPath(pathname, config.locales),
+            localePath: (locale, path = '') => localePath(locale, path, config.locales),
+            swapLocalePath: (pathname, targetLocale) => swapLocalePath(pathname, targetLocale, {
+                locales: config.locales,
+                defaultLocale: config.defaultLocale,
+            }),
+            pickLocale: (record, locale) => pickLocale(record, locale, config.defaultLocale),
+            getLocaleCookie,
+            setLocaleCookie,
+            resolveLocaleFromCookie,
+            getLocaleRedirectScript,
+        };
+    }
+    function createAppI18n(messages, fallback) {
+        const fromConfig = getRyunixI18nConfig() ?? fallback;
+        if (!fromConfig) {
+            throw new Error('[Ryunix i18n] Missing ryunix.config.i18n. Add i18n: { locales, defaultLocale } to ryunix.config.js, pass a fallback to createAppI18n(), or call createI18n() directly.');
+        }
+        return createI18n({ ...fromConfig, messages });
+    }
+    function createI18nFromConfig(config, messages) {
+        if (!config?.locales?.length) {
+            throw new Error('[Ryunix i18n] Invalid i18n config: locales array is required.');
+        }
+        return createI18n({ ...config, messages });
+    }
+    function escapeRegExp(value) {
+        return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    }
+
     var Ryunix = /*#__PURE__*/Object.freeze({
         __proto__: null,
         Children: Children,
+        DEFAULT_LOCALE_COOKIE_NAME: DEFAULT_LOCALE_COOKIE_NAME,
         DEFAULT_THEME_COOKIE_NAME: DEFAULT_THEME_COOKIE_NAME,
         ErrorBoundary: ErrorBoundary,
         Footer: Footer,
@@ -3458,6 +3821,7 @@ function $RC(id, templateId) {
         Header: Header,
         Hooks: index,
         HydrationBoundary: HydrationBoundary,
+        INTERNAL_META_KEYS: INTERNAL_META_KEYS,
         Link: Link,
         Main: Main,
         NavLink: NavLink,
@@ -3473,13 +3837,19 @@ function $RC(id, templateId) {
         batchUpdates: batchUpdates,
         cloneElement: cloneElement,
         createActionProxy: createActionProxy,
+        createAppI18n: createAppI18n,
         createContext: createContext,
         createElement: createElement,
+        createI18n: createI18n,
+        createI18nFromConfig: createI18nFromConfig,
         createPortal: createPortal,
         createThemeController: createThemeController,
         deepEqual: deepEqual,
+        defineMessages: defineMessages,
         escapeHtml: escapeHtml,
         forwardRef: forwardRef,
+        getLocaleFromPath: getLocaleFromPath,
+        getRyunixI18nConfig: getRyunixI18nConfig,
         getState: getState,
         getSystemColorScheme: getSystemColorScheme,
         getThemeCookie: getThemeCookie,
@@ -3487,12 +3857,16 @@ function $RC(id, templateId) {
         init: init,
         isValidElement: isValidElement,
         lazy: lazy,
+        localePath: localePath,
         logHydrationBoundaryMismatch: logHydrationBoundaryMismatch,
         logHydrationBoundaryRecovery: logHydrationBoundaryRecovery,
         logHydrationFatal: logHydrationFatal,
         logHydrationInfo: logHydrationInfo,
         logHydrationRecoverable: logHydrationRecoverable,
         memo: memo,
+        mergeRouteMetadata: mergeRouteMetadata,
+        normalizeI18nConfig: normalizeI18nConfig,
+        pickLocale: pickLocale,
         preload: preload,
         profiler: profiler,
         render: render,
@@ -3501,10 +3875,12 @@ function $RC(id, templateId) {
         renderToStringAsync: renderToStringAsync,
         resetIdCounter: resetIdCounter,
         resolveEffectiveTheme: resolveEffectiveTheme,
+        resolvePageMetadata: resolvePageMetadata,
         resolveThemeFromCookie: resolveThemeFromCookie,
         safeRender: safeRender,
         setThemeCookie: setThemeCookie,
         shallowEqual: shallowEqual,
+        swapLocalePath: swapLocalePath,
         themeController: themeController,
         themeInitScript: themeInitScript,
         useCallback: useCallback,
@@ -3596,7 +3972,7 @@ function $RC(id, templateId) {
     const Image = ({ src, ...props }) => {
         return createElement('img', { ...props, src });
     };
-    const MDXContent = ({ children, components = {} }) => {
+    const MDXContent = ({ children, components = {}, }) => {
         const mergedComponents = getMDXComponents(components);
         return createElement(MDXProvider, { value: mergedComponents }, createElement('div', null, children));
     };
@@ -3605,6 +3981,7 @@ function $RC(id, templateId) {
         window.Ryunix = Ryunix;
 
     exports.Children = Children;
+    exports.DEFAULT_LOCALE_COOKIE_NAME = DEFAULT_LOCALE_COOKIE_NAME;
     exports.DEFAULT_THEME_COOKIE_NAME = DEFAULT_THEME_COOKIE_NAME;
     exports.ErrorBoundary = ErrorBoundary;
     exports.Footer = Footer;
@@ -3612,6 +3989,7 @@ function $RC(id, templateId) {
     exports.Header = Header;
     exports.Hooks = index;
     exports.HydrationBoundary = HydrationBoundary;
+    exports.INTERNAL_META_KEYS = INTERNAL_META_KEYS;
     exports.Image = Image;
     exports.Link = Link;
     exports.MDXContent = MDXContent;
@@ -3630,16 +4008,22 @@ function $RC(id, templateId) {
     exports.batchUpdates = batchUpdates;
     exports.cloneElement = cloneElement;
     exports.createActionProxy = createActionProxy;
+    exports.createAppI18n = createAppI18n;
     exports.createContext = createContext;
     exports.createElement = createElement;
+    exports.createI18n = createI18n;
+    exports.createI18nFromConfig = createI18nFromConfig;
     exports.createPortal = createPortal;
     exports.createThemeController = createThemeController;
     exports.deepEqual = deepEqual;
     exports.default = Ryunix;
     exports.defaultComponents = defaultComponents;
+    exports.defineMessages = defineMessages;
     exports.escapeHtml = escapeHtml;
     exports.forwardRef = forwardRef;
+    exports.getLocaleFromPath = getLocaleFromPath;
     exports.getMDXComponents = getMDXComponents;
+    exports.getRyunixI18nConfig = getRyunixI18nConfig;
     exports.getState = getState;
     exports.getSystemColorScheme = getSystemColorScheme;
     exports.getThemeCookie = getThemeCookie;
@@ -3647,12 +4031,16 @@ function $RC(id, templateId) {
     exports.init = init;
     exports.isValidElement = isValidElement;
     exports.lazy = lazy;
+    exports.localePath = localePath;
     exports.logHydrationBoundaryMismatch = logHydrationBoundaryMismatch;
     exports.logHydrationBoundaryRecovery = logHydrationBoundaryRecovery;
     exports.logHydrationFatal = logHydrationFatal;
     exports.logHydrationInfo = logHydrationInfo;
     exports.logHydrationRecoverable = logHydrationRecoverable;
     exports.memo = memo;
+    exports.mergeRouteMetadata = mergeRouteMetadata;
+    exports.normalizeI18nConfig = normalizeI18nConfig;
+    exports.pickLocale = pickLocale;
     exports.preload = preload;
     exports.profiler = profiler;
     exports.render = render;
@@ -3661,11 +4049,13 @@ function $RC(id, templateId) {
     exports.renderToStringAsync = renderToStringAsync;
     exports.resetIdCounter = resetIdCounter;
     exports.resolveEffectiveTheme = resolveEffectiveTheme;
+    exports.resolvePageMetadata = resolvePageMetadata;
     exports.resolveThemeFromCookie = resolveThemeFromCookie;
     exports.ryxProps = ryxProps;
     exports.safeRender = safeRender;
     exports.setThemeCookie = setThemeCookie;
     exports.shallowEqual = shallowEqual;
+    exports.swapLocalePath = swapLocalePath;
     exports.themeController = themeController;
     exports.themeInitScript = themeInitScript;
     exports.useCallback = useCallback;