@absolutejs/absolute 0.20.0-beta.54 → 0.20.0-beta.56

package/dist/cli/config/server.js

@@ -39067,6 +39067,9 @@ var renderSpaNotFound = async (framework, pageName, request) => {
   });
 };
 
+// src/core/browserTranslation.ts
+var BROWSER_TRANSLATION_BASELINE_SCRIPT = "window.__ABSOLUTE_SSR_TEXT_BASELINES__=new WeakMap();" + "{const r=document.body,b=window.__ABSOLUTE_SSR_TEXT_BASELINES__;" + 'if(r)for(const e of [r,...r.querySelectorAll("*")]){' + "const t=new Map();for(const [i,n]of[...e.childNodes].entries())" + 'if(n.nodeType===3)t.set(i,n.nodeValue??"");if(t.size)b.set(e,t);}}';
+
 // src/react/pageHandler.ts
 var withRequestUrl = (props, url) => Object.assign(Object.create(null), props, { url });
 var resolveRequestPathname = (request) => {
@@ -39121,7 +39124,7 @@ var handleReactPageRequest = async (input) => {
       const refreshSetup = buildRefreshSetup();
       const stream = await renderToReadableStream(element, {
         bootstrapModules: [resolvedIndex],
-        bootstrapScriptContent: propsScript + refreshSetup || undefined,
+        bootstrapScriptContent: BROWSER_TRANSLATION_BASELINE_SCRIPT + propsScript + refreshSetup,
         onError(error) {
           console.error("[SSR] React streaming error:", error);
         }

package/dist/cli/index.js

@@ -1358,7 +1358,7 @@ import { existsSync as existsSync3, readFileSync as readFileSync7 } from "fs";
 import { extname, join as join7, relative, resolve as resolve4 } from "path";
 import { fileURLToPath } from "url";
 import ts from "typescript";
-var DEVICES_PACKAGE = "@absolutejs/devices", ADAPTERS, SOURCE_GLOB, IGNORED_DIRECTORIES, IDENTIFIER_PATTERN, providerModulePattern = (provider) => new RegExp(`^@absolutejs/devices-${provider}/[a-z][a-z0-9-]*$`, "u"), providerPackagePattern = (provider) => provider === "capacitor" ? /^@capacitor\/[a-z][a-z0-9-]*@\d+\.\d+\.\d+$/u : /^(?:expo-[a-z][a-z0-9-]*|@react-native-[a-z0-9-]+\/[a-z][a-z0-9-]*)@\d+\.\d+\.\d+$/u, providerLabel = (provider) => provider === "capacitor" ? "Capacitor" : "Expo", ANDROID_PERMISSION_PATTERN, IOS_USAGE_DESCRIPTIONS, IOS_PRIVACY_ACCESSED_API_REASONS, IOS_PRIVACY_ACCESSED_APIS, object2 = (value) => typeof value === "object" && value !== null && !Array.isArray(value), readJson = (path) => {
+var DEVICES_PACKAGE = "@absolutejs/devices", ABSOLUTE_MOBILE_SHELL_DEVICE_CAPABILITIES, ADAPTERS, SOURCE_GLOB, IGNORED_DIRECTORIES, IDENTIFIER_PATTERN, providerModulePattern = (provider) => new RegExp(`^@absolutejs/devices-${provider}/[a-z][a-z0-9-]*$`, "u"), providerPackagePattern = (provider) => provider === "capacitor" ? /^@capacitor\/[a-z][a-z0-9-]*@\d+\.\d+\.\d+$/u : /^(?:expo-[a-z][a-z0-9-]*|@react-native-[a-z0-9-]+\/[a-z][a-z0-9-]*)@\d+\.\d+\.\d+$/u, providerLabel = (provider) => provider === "capacitor" ? "Capacitor" : "Expo", ANDROID_PERMISSION_PATTERN, IOS_USAGE_DESCRIPTIONS, IOS_PRIVACY_ACCESSED_API_REASONS, IOS_PRIVACY_ACCESSED_APIS, object2 = (value) => typeof value === "object" && value !== null && !Array.isArray(value), readJson = (path) => {
   const value = JSON.parse(readFileSync7(path, "utf8"));
   if (!object2(value))
     throw new TypeError(`${path} must contain an object.`);
@@ -1578,6 +1578,11 @@ var DEVICES_PACKAGE = "@absolutejs/devices", ADAPTERS, SOURCE_GLOB, IGNORED_DIRE
 }), resolveAbsoluteDeviceCapabilityPlan = (projectRoot, provider = "capacitor") => {
   const allProviders = loadAbsoluteDeviceCapabilityProviders(projectRoot, provider);
   const capabilities = discoverAbsoluteDeviceCapabilities(projectRoot, allProviders);
+  for (const capability of ABSOLUTE_MOBILE_SHELL_DEVICE_CAPABILITIES) {
+    if (allProviders[capability] && !capabilities.includes(capability))
+      capabilities.push(capability);
+  }
+  capabilities.sort();
   const providers = {};
   for (const name of capabilities) {
     const capabilityProvider = allProviders[name];
@@ -1593,6 +1598,10 @@ var DEVICES_PACKAGE = "@absolutejs/devices", ADAPTERS, SOURCE_GLOB, IGNORED_DIRE
   };
 };
 var init_deviceCapabilities = __esm(() => {
+  ABSOLUTE_MOBILE_SHELL_DEVICE_CAPABILITIES = [
+    "keyboard",
+    "systemBars"
+  ];
   ADAPTERS = {
     capacitor: "@absolutejs/devices-capacitor",
     expo: "@absolutejs/devices-expo"
@@ -2093,6 +2102,7 @@ export const createAbsoluteExpoSyncBridge = async (
 import { router, usePathname } from 'expo-router';
 import { useEffect, useRef, useState } from 'react';
 import { ActivityIndicator, BackHandler, Platform, StyleSheet, View } from 'react-native';
+import { useSafeAreaInsets } from 'react-native-safe-area-context';
 import { WebView, type WebViewMessageEvent } from 'react-native-webview';
 import { materializeAbsoluteWebBundle } from './webAssets';
 import { createExpoDevicesBridgeHost } from '@absolutejs/devices-expo/bridge';
@@ -2125,7 +2135,10 @@ const isNativeRoute = (pathname: string) => {
 	});
 };
 
-const bridgeBootstrap = (path: string) => {
+const hostMetricsScript = (safeAreaInsets: { bottom: number; left: number; right: number; top: number }) =>
+	\`globalThis.__absoluteNativeHostMetrics = \${JSON.stringify({ safeAreaInsets })}; dispatchEvent(new CustomEvent('absolute:native-host-metrics', { detail: globalThis.__absoluteNativeHostMetrics })); true;\`;
+
+const bridgeBootstrap = (path: string, safeAreaInsets: { bottom: number; left: number; right: number; top: number }) => {
 	const initialPath = DEV_ORIGIN
 		? 'location.pathname + location.search + location.hash'
 		: JSON.stringify(path);
@@ -2134,6 +2147,7 @@ const bridgeBootstrap = (path: string) => {
 	const listeners = new Map();
 	let sequence = 0;
 	let currentPath = \${initialPath};
+	globalThis.__absoluteNativeHostMetrics = \${JSON.stringify({ safeAreaInsets })};
 	const send = value => {
 		const source = JSON.stringify(value);
 		if (new TextEncoder().encode(source).byteLength > 65536) throw new Error('Expo bridge message exceeds 64 KiB.');
@@ -2238,6 +2252,7 @@ const authStatus = async () => {
 
 export function AbsoluteWebHost() {
 	const pathname = usePathname() || '/';
+	const safeAreaInsets = useSafeAreaInsets();
 	const webView = useRef<WebView>(null);
 	const devicesBridge = useRef<{ close(): void | Promise<void>; request(method: string, params: Record<string, unknown>): Promise<unknown> } | undefined>(undefined);
 	const syncBridge = useRef<{ close(): void | Promise<void>; request(method: string, params: Record<string, unknown>): Promise<unknown> } | undefined>(undefined);
@@ -2280,6 +2295,9 @@ export function AbsoluteWebHost() {
 		}
 		void materializeAbsoluteWebBundle().then(uri => setIndexUri(uri + '?absolutePath=' + encodeURIComponent(pathname)));
 	}, [pathname]);
+	useEffect(() => {
+		webView.current?.injectJavaScript(hostMetricsScript(safeAreaInsets));
+	}, [safeAreaInsets.bottom, safeAreaInsets.left, safeAreaInsets.right, safeAreaInsets.top]);
 	useEffect(() => {
 		const subscription = BackHandler.addEventListener('hardwareBackPress', () => {
 			if (!canGoBack) return false;
@@ -2363,7 +2381,7 @@ export function AbsoluteWebHost() {
 		allowFileAccessFromFileURLs
 		allowUniversalAccessFromFileURLs={false}
 		allowingReadAccessToURL={indexUri.slice(0, indexUri.lastIndexOf('/') + 1)}
-		injectedJavaScriptBeforeContentLoaded={bridgeBootstrap(pathname)}
+		injectedJavaScriptBeforeContentLoaded={bridgeBootstrap(pathname, safeAreaInsets)}
 		onMessage={onMessage}
 		onNavigationStateChange={state => setCanGoBack(state.canGoBack)}
 		onShouldStartLoadWithRequest={request => {
@@ -21350,6 +21368,22 @@ var init_iosTestReport = __esm(() => {
     ["SETUP-05", "Confirm generated iOS project signing and Xcode warnings."],
     ["DEV-01", "Record cold and warm bun dev startup timings."],
     ["DEV-02", "Complete route traversal, HMR, relaunch, and recovery checks."],
+    [
+      "ADAPT-01",
+      "Confirm safe-area variables and platform attributes on React, Angular, Vue, Svelte, HTML, and HTMX pages."
+    ],
+    [
+      "ADAPT-02",
+      "Rotate with the keyboard open and confirm viewport and available-height variables update without double padding."
+    ],
+    [
+      "ADAPT-03",
+      "Go offline and reconnect; confirm the root state and accessibility announcement update."
+    ],
+    [
+      "ADAPT-04",
+      "Confirm automatic system-bar appearance and unchanged author layout."
+    ],
     ...Array.from({ length: 10 }, (_, index) => [
       `DEVICEDEV-${String(index + 1).padStart(2, "0")}`,
       `Complete physical-device development runbook check DEVICEDEV-${String(index + 1).padStart(2, "0")}.`
@@ -21435,6 +21469,22 @@ var init_androidTestReport = __esm(() => {
     ],
     ["DEV-01", "Record cold and warm native startup timings."],
     ["DEV-02", "Complete route traversal, HMR, relaunch, and recovery checks."],
+    [
+      "ADAPT-01",
+      "Confirm safe-area variables and platform attributes on every embedded framework."
+    ],
+    [
+      "ADAPT-02",
+      "Rotate with the keyboard open and confirm viewport and available-height variables update without double padding."
+    ],
+    [
+      "ADAPT-03",
+      "Go offline and reconnect; confirm the root state and accessibility announcement update."
+    ],
+    [
+      "ADAPT-04",
+      "Confirm automatic system-bar appearance and unchanged author layout."
+    ],
     ["CAP-01", "Complete automatic device-capability provisioning checks."],
     [
       "SYSUI-01",

package/dist/client/index.js

@@ -235,6 +235,82 @@ var init_islandMarkupAttributes = __esm(() => {
   init_islands();
 });
 
+// src/client/browserTranslation.ts
+var translationRestorer = (restore, hasTranslation) => Object.assign(restore, { hasTranslation }), emptyTranslationRestorer = () => translationRestorer(() => {
+  return;
+}, false), textNodeAt = (parent, index) => {
+  const node = parent.childNodes[index];
+  return node instanceof Text ? node : undefined;
+}, visitElements = (root, visit) => {
+  visit(root);
+  for (const element of root.querySelectorAll("*"))
+    visit(element);
+}, elementPath = (root, element) => {
+  const path = [];
+  let current = element;
+  while (current !== root) {
+    const parent = current.parentElement;
+    if (parent === null)
+      return null;
+    path.unshift([...parent.children].indexOf(current));
+    current = parent;
+  }
+  return path;
+}, elementAtPath = (root, path) => {
+  let current = root;
+  for (const index of path) {
+    const child = current.children[index];
+    if (!(child instanceof Element))
+      return null;
+    current = child;
+  }
+  return current;
+}, captureSsrTextBaselines = (root) => {
+  if (root === null || typeof window === "undefined")
+    return;
+  const baselines = window.__ABSOLUTE_SSR_TEXT_BASELINES__ ?? new WeakMap;
+  visitElements(root, (element) => {
+    const text = new Map;
+    for (const [index, node] of [...element.childNodes].entries()) {
+      if (node.nodeType === Node.TEXT_NODE)
+        text.set(index, node.nodeValue ?? "");
+    }
+    if (text.size > 0)
+      baselines.set(element, text);
+  });
+  window.__ABSOLUTE_SSR_TEXT_BASELINES__ = baselines;
+}, prepareBrowserTranslationHydration = (root) => {
+  if (root === null || typeof window === "undefined")
+    return emptyTranslationRestorer();
+  const baselines = window.__ABSOLUTE_SSR_TEXT_BASELINES__;
+  if (baselines === undefined)
+    return emptyTranslationRestorer();
+  const translated = [];
+  visitElements(root, (element) => {
+    const text = baselines.get(element);
+    const path = elementPath(root, element);
+    if (text === undefined || path === null)
+      return;
+    for (const [index, baseline] of text) {
+      const node = textNodeAt(element, index);
+      if (node === undefined || node.data === baseline)
+        continue;
+      translated.push({ baseline, index, path, translated: node.data });
+      node.data = baseline;
+    }
+  });
+  return translationRestorer(() => {
+    for (const snapshot of translated) {
+      const parent = elementAtPath(root, snapshot.path);
+      if (parent === null)
+        continue;
+      const node = textNodeAt(parent, snapshot.index);
+      if (node !== undefined && node.data === snapshot.baseline)
+        node.data = snapshot.translated;
+    }
+  }, translated.length > 0);
+};
+
 // src/client/hydrators/react.ts
 var exports_react = {};
 __export(exports_react, {
@@ -243,6 +319,7 @@ __export(exports_react, {
 });
 import { createElement } from "react";
 import { hydrateRoot } from "react-dom/client";
+import { flushSync } from "react-dom";
 var reactIslandRoots, isPropsRecord = (value) => typeof value === "object" && value !== null, HOST_REACT_EXPANDO_PREFIXES, detachFromHostReactRoot = (element) => {
   for (const key of Object.keys(element)) {
     const isHostExpando = HOST_REACT_EXPANDO_PREFIXES.some((prefix) => key.startsWith(prefix));
@@ -257,11 +334,28 @@ var reactIslandRoots, isPropsRecord = (value) => typeof value === "object" && va
     return;
   }
   detachFromHostReactRoot(element);
+  const restoreTranslation = prepareBrowserTranslationHydration(element);
+  const hydrate = (elementToHydrate) => {
+    let root;
+    const startHydration = () => {
+      root = hydrateRoot(element, elementToHydrate);
+    };
+    try {
+      if (restoreTranslation.hasTranslation)
+        flushSync(startHydration);
+      else
+        startHydration();
+    } finally {
+      restoreTranslation();
+    }
+    if (root !== undefined)
+      reactIslandRoots.set(element, root);
+  };
   if (!isPropsRecord(props)) {
-    reactIslandRoots.set(element, hydrateRoot(element, createElement(component)));
+    hydrate(createElement(component));
     return;
   }
-  reactIslandRoots.set(element, hydrateRoot(element, createElement(component, props)));
+  hydrate(createElement(component, props));
 }, isReactComponent = (value) => typeof value === "function";
 var init_react = __esm(() => {
   reactIslandRoots = new WeakMap;
@@ -638,6 +732,20 @@ var init_registerClientScript = __esm(() => {
   }
 });
 
+// src/core/browserTranslation.ts
+var BASELINE_MARKER = "__ABSOLUTE_SSR_TEXT_BASELINES__", BROWSER_TRANSLATION_BASELINE_SCRIPT, browserTranslationBaselineTag = () => `<script>${BROWSER_TRANSLATION_BASELINE_SCRIPT}</script>`, injectBrowserTranslationBaseline = (html) => {
+  if (html.includes(BASELINE_MARKER))
+    return html;
+  const script = browserTranslationBaselineTag();
+  const closingBodyIndex = html.lastIndexOf("</body>");
+  if (closingBodyIndex < 0)
+    return `${html}${script}`;
+  return `${html.slice(0, closingBodyIndex)}${script}${html.slice(closingBodyIndex)}`;
+};
+var init_browserTranslation = __esm(() => {
+  BROWSER_TRANSLATION_BASELINE_SCRIPT = "window.__ABSOLUTE_SSR_TEXT_BASELINES__=new WeakMap();" + "{const r=document.body,b=window.__ABSOLUTE_SSR_TEXT_BASELINES__;" + 'if(r)for(const e of [r,...r.querySelectorAll("*")]){' + "const t=new Map();for(const [i,n]of[...e.childNodes].entries())" + 'if(n.nodeType===3)t.set(i,n.nodeValue??"");if(t.size)b.set(e,t);}}';
+});
+
 // src/angular/httpTransferCache.ts
 var ABSOLUTE_HTTP_TRANSFER_CACHE_SKIP_HEADER = "x-skip-transfer-cache", buildAbsoluteHttpTransferCacheOptions = (options = {}) => {
   const {
@@ -690,7 +798,7 @@ var routeContextCache, cacheRouteData = (pagePath, data) => {
   }
   return html + snippet;
 }, injectSsrScripts = (html, requestId, indexPath, requestContext) => {
-  let result = html;
+  let result = injectBeforeClose(html, browserTranslationBaselineTag());
   const registeredScripts = getAndClearClientScripts(requestId);
   if (registeredScripts.length > 0) {
     result = injectBeforeClose(result, generateClientScriptCode(registeredScripts));
@@ -726,6 +834,7 @@ var routeContextCache, cacheRouteData = (pagePath, data) => {
 };
 var init_ssrRender = __esm(() => {
   init_registerClientScript();
+  init_browserTranslation();
   routeContextCache = new Map;
   selectorCache = new Map;
 });
@@ -1113,6 +1222,14 @@ var isPropsRecord4 = (value) => typeof value === "object" && value !== null;
 var isIslandElement = (value) => value instanceof HTMLElement && value.dataset.island === "true";
 var observedRoots = new WeakSet;
 var hydratingIslands = new WeakSet;
+var hydratePreservingBrowserTranslation = async (element, hydrate) => {
+  const restoreTranslation = prepareBrowserTranslationHydration(element);
+  try {
+    await hydrate();
+  } finally {
+    restoreTranslation();
+  }
+};
 var hydrateByFramework = async (registry, framework, componentName, element, props, resolveComponent) => {
   const propsRecord = isPropsRecord4(props) ? props : undefined;
   if (framework === "react") {
@@ -1129,7 +1246,7 @@ var hydrateByFramework = async (registry, framework, componentName, element, pro
     const resolvedComponent = await resolveComponent?.(framework, componentName) ?? getIslandComponent(registry.svelte?.[componentName]);
     if (!isSvelteComponent2(resolvedComponent))
       return;
-    hydrateSvelteIsland2(resolvedComponent, element, propsRecord);
+    await hydratePreservingBrowserTranslation(element, () => hydrateSvelteIsland2(resolvedComponent, element, propsRecord));
     element.dataset.hydrated = "true";
     return;
   }
@@ -1138,7 +1255,7 @@ var hydrateByFramework = async (registry, framework, componentName, element, pro
     const resolvedComponent = await resolveComponent?.(framework, componentName) ?? getIslandComponent(registry.vue?.[componentName]);
     if (!isVueComponent2(resolvedComponent))
       return;
-    hydrateVueIsland2(resolvedComponent, element, propsRecord);
+    await hydratePreservingBrowserTranslation(element, () => hydrateVueIsland2(resolvedComponent, element, propsRecord));
     element.dataset.hydrated = "true";
     return;
   }
@@ -1148,7 +1265,7 @@ var hydrateByFramework = async (registry, framework, componentName, element, pro
     const { islandId } = element.dataset;
     if (!isAngularComponent2(resolvedComponent) || !islandId)
       return;
-    await mountAngularIsland2(resolvedComponent, element, propsRecord ?? {}, islandId);
+    await hydratePreservingBrowserTranslation(element, () => mountAngularIsland2(resolvedComponent, element, propsRecord ?? {}, islandId));
     element.dataset.hydrated = "true";
   }
 };
@@ -1239,15 +1356,17 @@ var startIslands = ({
   });
 };
 export {
+  captureSsrTextBaselines,
   createIslandManifestResolver,
   createIslandStore,
   getIslandStoreServerSnapshot,
   getStreamSwapRuntimeScript,
   initializeIslandStores,
+  prepareBrowserTranslationHydration,
   readIslandStore,
   startIslands,
   subscribeIslandStore
 };
 
-//# debugId=A44D536D7433EB4864756E2164756E21
+//# debugId=77AFDE1DACC53DED64756E2164756E21
 //# sourceMappingURL=index.js.map