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

package/dist/Ryunix.esm.js

@@ -426,6 +426,7 @@ const updateDom = (dom, prevProps = {}, nextProps = {}) => {
     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))
@@ -460,7 +461,7 @@ const updateDom = (dom, prevProps = {}, nextProps = {}) => {
             el.removeAttribute(attrName);
         }
         else {
-            el[propKey] = '';
+            elRecord[propKey] = '';
             el.removeAttribute(propKey);
         }
     });
@@ -481,8 +482,8 @@ const updateDom = (dom, prevProps = {}, nextProps = {}) => {
             }
             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 {
@@ -490,15 +491,15 @@ const updateDom = (dom, prevProps = {}, nextProps = {}) => {
                     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));
                         }
                     }
                 }
@@ -665,9 +666,7 @@ const runLayoutEffects = (fiber) => {
             }
             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') {
@@ -699,9 +698,7 @@ const runNormalEffects = (fiber) => {
             }
             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') {
@@ -717,6 +714,8 @@ function commitRoot() {
     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) {
@@ -773,6 +772,8 @@ function commitWork(fiber) {
         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) {
@@ -786,7 +787,7 @@ function commitWork(fiber) {
     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);
@@ -835,7 +836,7 @@ const commitPortalWork = (fiber, portalContainer) => {
     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);
@@ -888,6 +889,12 @@ const reconcileChildren = (wipFiber, elements) => {
         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,
@@ -896,7 +903,7 @@ const reconcileChildren = (wipFiber, elements) => {
                 alternate: matchedFiber,
                 effectTag: EFFECT_TAGS.UPDATE,
                 hooks: matchedFiber.hooks,
-                stateError: matchedFiber.stateError,
+                stateError: preserveBoundaryError ? matchedFiber.stateError : undefined,
                 key: element.key,
                 index,
             };
@@ -964,8 +971,7 @@ const findNearestHydrationBoundary = (fiber) => {
         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;
@@ -1031,11 +1037,15 @@ const updateFunctionComponent = (fiber) => {
     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 || {};
@@ -1049,7 +1059,7 @@ const updateFunctionComponent = (fiber) => {
             return;
         }
     }
-    let children = [
+    const children = [
         componentType(fiber.props),
     ];
     if (componentType._contextId && fiber.props?.value !== undefined) {
@@ -1067,11 +1077,24 @@ const isUnderClientOnlyBoundary = (fiber) => {
     }
     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 ||
@@ -1080,6 +1103,9 @@ const updateHostComponent = (fiber) => {
     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);
@@ -1102,6 +1128,13 @@ const updateHostComponent = (fiber) => {
                     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;
@@ -1110,7 +1143,7 @@ const updateHostComponent = (fiber) => {
             }
             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);
@@ -1142,7 +1175,10 @@ const updateHostComponent = (fiber) => {
             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) => {
@@ -1166,6 +1202,11 @@ const scheduleWork$1 = (root, priority) => {
     }
 };
 
+const getRootChild = (children) => {
+    if (children == null)
+        return undefined;
+    return Array.isArray(children) ? children[0] : children;
+};
 const renderSubtree = (element, container) => {
     clearContainer(container);
     const root = {
@@ -1195,7 +1236,7 @@ const recoverHydrationFailureIfNeeded = () => {
     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;
@@ -1205,8 +1246,10 @@ const recoverHydrationFailureIfNeeded = () => {
     renderSubtree(element, container);
 };
 const runHydrationRecovery = () => {
+    const state = getState();
     recoverScopedHydrationFailures();
     recoverHydrationFailureIfNeeded();
+    state.hydrationRecover = false;
 };
 
 let workQueue = [];
@@ -1226,32 +1269,36 @@ function performUnitOfWork(fiber) {
         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.');
             }
@@ -1278,6 +1325,7 @@ function performUnitOfWork(fiber) {
         }
         nextFiber = nextFiber.parent;
     }
+    return null;
 }
 const workLoop = (deadline) => {
     const state = getState();
@@ -1285,6 +1333,8 @@ const workLoop = (deadline) => {
     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 = [];
@@ -1345,9 +1395,7 @@ const render = (element, container) => {
     const root = {
         dom: container,
         props: {
-            children: [
-                element,
-            ],
+            children: [element],
         },
         alternate: state.currentRoot,
         isHydrating: false,
@@ -1360,7 +1408,7 @@ const SSR_ROOT_ATTR = 'data-ryunix-ssr-root';
 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')))) {
@@ -1374,9 +1422,7 @@ const hydrate = (element, container) => {
     const root = {
         dom: container,
         props: {
-            children: [
-                element,
-            ],
+            children: [element],
         },
         alternate: state.currentRoot,
         isHydrating: true,
@@ -1385,7 +1431,7 @@ const hydrate = (element, container) => {
     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;
@@ -1482,6 +1528,82 @@ const validateHookContext = (hookName = 'A hook') => {
     }
 };
 
+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;
@@ -1521,6 +1643,8 @@ const useReducer = (reducer, initialState, init, defaultPriority = getCurrentPri
     validateHookContext();
     const { hookIndex } = state;
     const wipFiber = state.wipFiber;
+    if (!wipFiber.hooks)
+        wipFiber.hooks = [];
     const oldHook = wipFiber.alternate?.hooks?.[hookIndex];
     const hook = {
         hookID: hookIndex,
@@ -1560,8 +1684,7 @@ const useReducer = (reducer, initialState, init, defaultPriority = getCurrentPri
         };
         queueUpdate(() => scheduleWork$1(newRoot, priority));
     };
-    wipFiber.hooks[hookIndex] =
-        hook;
+    wipFiber.hooks[hookIndex] = hook;
     state.hookIndex++;
     return [hook.state, dispatch];
 };
@@ -1582,6 +1705,8 @@ const useEffect = (callback, deps) => {
     }
     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 = {
@@ -1591,8 +1716,7 @@ const useEffect = (callback, deps) => {
         effect: hasChanged ? callback : null,
         cancel: oldHook?.cancel,
     };
-    wipFiber.hooks[hookIndex] =
-        hook;
+    wipFiber.hooks[hookIndex] = hook;
     state.hookIndex++;
 };
 const useRef = (initialValue) => {
@@ -1606,6 +1730,8 @@ const useRef = (initialValue) => {
     validateHookContext();
     const { hookIndex } = state;
     const wipFiber = state.wipFiber;
+    if (!wipFiber.hooks)
+        wipFiber.hooks = [];
     const oldHook = wipFiber.alternate?.hooks?.[hookIndex];
     const hook = {
         hookID: hookIndex,
@@ -1614,8 +1740,7 @@ const useRef = (initialValue) => {
             ? oldHook.value
             : { current: initialValue },
     };
-    wipFiber.hooks[hookIndex] =
-        hook;
+    wipFiber.hooks[hookIndex] = hook;
     state.hookIndex++;
     return hook.value;
 };
@@ -1636,6 +1761,8 @@ const useMemo = (compute, deps) => {
     }
     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)) {
@@ -1658,8 +1785,7 @@ const useMemo = (compute, deps) => {
         value,
         deps,
     };
-    wipFiber.hooks[hookIndex] =
-        hook;
+    wipFiber.hooks[hookIndex] = hook;
     state.hookIndex++;
     return value;
 };
@@ -1670,7 +1796,7 @@ const useCallback = (callback, deps) => {
     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;
@@ -1725,7 +1851,7 @@ const useHash = () => {
 const useMetadata = (tags = {}, options = {}) => {
     const state = getState();
     if (state.isServerRendering) {
-        state.ssrMetadata = { ...state.ssrMetadata, ...tags };
+        state.ssrMetadata = mergeRouteMetadata((state.ssrMetadata || {}), tags);
         return;
     }
     useEffect(() => {
@@ -1756,6 +1882,8 @@ const useMetadata = (tags = {}, options = {}) => {
         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);
@@ -1779,7 +1907,7 @@ const findRoute = (routes, path) => {
     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) {
@@ -1815,7 +1943,7 @@ const getSsrPathname = () => {
     }
     return '/';
 };
-const RouterProvider = ({ routes, children }) => {
+const RouterProvider = ({ routes, children, }) => {
     if (typeof window === 'undefined') {
         const location = getSsrPathname();
         const currentRouteData = findRoute(routes, location);
@@ -1849,7 +1977,7 @@ const RouterProvider = ({ routes, children }) => {
     const currentRouteData = findRoute(routes, location);
     const query = useQuery();
     const contextValue = {
-        location,
+        location: location,
         params: currentRouteData.params || {},
         query,
         navigate,
@@ -1871,10 +1999,13 @@ const Children = () => {
             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,
@@ -1905,14 +2036,14 @@ const Link = ({ to, prefetch = true, ...props }) => {
         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;
@@ -1921,7 +2052,7 @@ const NavLink = ({ to, exact = false, ...props }) => {
         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,
@@ -1973,7 +2104,7 @@ const usePersistentStore = (key, initialState = '') => {
             const item = window.localStorage.getItem(key);
             return item ? JSON.parse(item) : initialState;
         }
-        catch (error) {
+        catch (_error) {
             return initialState;
         }
     });
@@ -2012,6 +2143,8 @@ const useLayoutEffect = (callback, deps) => {
     }
     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 = {
@@ -2022,8 +2155,7 @@ const useLayoutEffect = (callback, deps) => {
         cancel: oldHook?.cancel,
         isLayout: true,
     };
-    wipFiber.hooks[hookIndex] =
-        hook;
+    wipFiber.hooks[hookIndex] = hook;
     state.hookIndex++;
 };
 let idCounter = 0;
@@ -2038,16 +2170,15 @@ const useId = () => {
     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;
 };
@@ -2082,6 +2213,7 @@ const useThrottle = (value, interval = 300) => {
     return throttledValue;
 };
 
+const ASYNC_RENDER_ERROR = 'Async components require renderToStringAsync or renderToReadableStream, not renderToString';
 const escapeHtml = (unsafe) => {
     if (typeof unsafe !== 'string')
         return String(unsafe);
@@ -2116,6 +2248,83 @@ const VOID_ELEMENTS = new Set([
     '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 '';
@@ -2128,20 +2337,18 @@ const renderToStringImpl = (element) => {
     }
     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;
         }
@@ -2161,61 +2368,17 @@ const renderToStringImpl = (element) => {
     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) {
@@ -2230,13 +2393,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));
@@ -2250,12 +2411,11 @@ const renderToStreamImpl = async (element, push, suspenseTasks = []) => {
     }
     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);
         }
@@ -2264,10 +2424,9 @@ const renderToStreamImpl = async (element, push, suspenseTasks = []) => {
     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;
         }
@@ -2289,11 +2448,9 @@ const renderToStreamImpl = async (element, push, suspenseTasks = []) => {
     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}">`);
@@ -2315,14 +2472,14 @@ const renderToStreamImpl = async (element, push, suspenseTasks = []) => {
             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');
@@ -2332,49 +2489,13 @@ const renderToStreamImpl = async (element, push, suspenseTasks = []) => {
         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);
@@ -2383,20 +2504,30 @@ const renderToStreamImpl = async (element, push, suspenseTasks = []) => {
         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 {
@@ -2405,11 +2536,10 @@ const renderToReadableStream = (element, options = {}) => {
                 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();
             }
@@ -2422,12 +2552,10 @@ const renderToReadableStream = (element, options = {}) => {
         },
     });
 };
-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);
     }
@@ -2581,7 +2709,9 @@ const Suspense = ({ fallback, children, }) => {
     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) {
@@ -2591,6 +2721,7 @@ function preload(importFn) {
 var index = /*#__PURE__*/Object.freeze({
     __proto__: null,
     Children: Children,
+    INTERNAL_META_KEYS: INTERNAL_META_KEYS,
     Link: Link,
     NavLink: NavLink,
     RouterProvider: RouterProvider,
@@ -2600,8 +2731,10 @@ var index = /*#__PURE__*/Object.freeze({
     forwardRef: forwardRef,
     lazy: lazy,
     memo: memo,
+    mergeRouteMetadata: mergeRouteMetadata,
     preload: preload,
     resetIdCounter: resetIdCounter,
+    resolvePageMetadata: resolvePageMetadata,
     shallowEqual: shallowEqual,
     useCallback: useCallback,
     useDebounce: useDebounce,
@@ -2748,11 +2881,11 @@ function withProfiler(Component, name) {
     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,
@@ -2787,7 +2920,7 @@ function createActionProxy(actionId) {
             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();
@@ -2813,9 +2946,7 @@ function RyunixDevOverlay(propsOrError) {
         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;
@@ -3153,9 +3284,7 @@ function RyunixDevOverlay(propsOrError) {
                 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;
@@ -3442,9 +3571,243 @@ function Footer({ image, title, description, href = '/', imageAlt, className = '
         : 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,
@@ -3452,6 +3815,7 @@ var Ryunix = /*#__PURE__*/Object.freeze({
     Header: Header,
     Hooks: index,
     HydrationBoundary: HydrationBoundary,
+    INTERNAL_META_KEYS: INTERNAL_META_KEYS,
     Link: Link,
     Main: Main,
     NavLink: NavLink,
@@ -3467,13 +3831,19 @@ var Ryunix = /*#__PURE__*/Object.freeze({
     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,
@@ -3481,12 +3851,16 @@ var Ryunix = /*#__PURE__*/Object.freeze({
     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,
@@ -3495,10 +3869,12 @@ var Ryunix = /*#__PURE__*/Object.freeze({
     renderToStringAsync: renderToStringAsync,
     resetIdCounter: resetIdCounter,
     resolveEffectiveTheme: resolveEffectiveTheme,
+    resolvePageMetadata: resolvePageMetadata,
     resolveThemeFromCookie: resolveThemeFromCookie,
     safeRender: safeRender,
     setThemeCookie: setThemeCookie,
     shallowEqual: shallowEqual,
+    swapLocalePath: swapLocalePath,
     themeController: themeController,
     themeInitScript: themeInitScript,
     useCallback: useCallback,
@@ -3590,7 +3966,7 @@ const defaultComponents = {
 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));
 };
@@ -3598,5 +3974,5 @@ const MDXContent = ({ children, components = {} }) => {
 if (typeof window !== 'undefined')
     window.Ryunix = Ryunix;
 
-export { Children, DEFAULT_THEME_COOKIE_NAME, ErrorBoundary, Footer, Fragment, Header, index as Hooks, HydrationBoundary, Image, Link, MDXContent, MDXProvider, Main, NavLink, Priority, RouterProvider, RyunixDevOverlay, ServerBoundary, Suspense, THEME_PREFERENCES, ThemeInitScript, ThemeToggle, applyTheme, batchUpdates, cloneElement, createActionProxy, createContext, createElement, createPortal, createThemeController, deepEqual, Ryunix as default, defaultComponents, escapeHtml, forwardRef, getMDXComponents, getState, getSystemColorScheme, getThemeCookie, hydrate, init, isValidElement, lazy, logHydrationBoundaryMismatch, logHydrationBoundaryRecovery, logHydrationFatal, logHydrationInfo, logHydrationRecoverable, memo, preload, profiler, render, renderToReadableStream, renderToString, renderToStringAsync, resetIdCounter, resolveEffectiveTheme, resolveThemeFromCookie, ryxProps, safeRender, setThemeCookie, shallowEqual, themeController, themeInitScript, useCallback, useDebounce, useDeferredValue, useEffect, useHash, useId, useLayoutEffect, useMDXComponents, useMemo, useMetadata, usePathname, usePersistentStore, usePersistentStore as usePersitentStore, useProfiler, useQuery, useReducer, useRef, useRouter, useSearchParams, useStore, useStorePriority, useSwitch, useThrottle, useTransition, watchSystemTheme, withProfiler };
+export { Children, DEFAULT_LOCALE_COOKIE_NAME, DEFAULT_THEME_COOKIE_NAME, ErrorBoundary, Footer, Fragment, Header, index as Hooks, HydrationBoundary, INTERNAL_META_KEYS, Image, Link, MDXContent, MDXProvider, Main, NavLink, Priority, RouterProvider, RyunixDevOverlay, ServerBoundary, Suspense, THEME_PREFERENCES, ThemeInitScript, ThemeToggle, applyTheme, batchUpdates, cloneElement, createActionProxy, createAppI18n, createContext, createElement, createI18n, createI18nFromConfig, createPortal, createThemeController, deepEqual, Ryunix as default, defaultComponents, defineMessages, escapeHtml, forwardRef, getLocaleFromPath, getMDXComponents, getRyunixI18nConfig, getState, getSystemColorScheme, getThemeCookie, hydrate, init, isValidElement, lazy, localePath, logHydrationBoundaryMismatch, logHydrationBoundaryRecovery, logHydrationFatal, logHydrationInfo, logHydrationRecoverable, memo, mergeRouteMetadata, normalizeI18nConfig, pickLocale, preload, profiler, render, renderToReadableStream, renderToString, renderToStringAsync, resetIdCounter, resolveEffectiveTheme, resolvePageMetadata, resolveThemeFromCookie, ryxProps, safeRender, setThemeCookie, shallowEqual, swapLocalePath, themeController, themeInitScript, useCallback, useDebounce, useDeferredValue, useEffect, useHash, useId, useLayoutEffect, useMDXComponents, useMemo, useMetadata, usePathname, usePersistentStore, usePersistentStore as usePersitentStore, useProfiler, useQuery, useReducer, useRef, useRouter, useSearchParams, useStore, useStorePriority, useSwitch, useThrottle, useTransition, watchSystemTheme, withProfiler };
 //# sourceMappingURL=Ryunix.esm.js.map