@rdlabo/ionic-theme-ios27 1.2.0-beta.pr231.sha22a35d481cf3 → 1.2.0-beta.pr237.sha90661d2c01a8

package/dist/native/index.js

@@ -1,188 +1,241 @@
-import { Capacitor, registerPlugin } from '@capacitor/core';
-import { setConfig } from '../transition/ios.transition';
-import { createRuntime } from './runtime';
-import { createVerticalBarsWebProjection } from './vertical-bars-web';
-import { prehideVerticalBarsToolbarSources } from './prehide';
-import { observeVerticalBarsModals } from './shared/modal';
-export { HingeStatus } from './definitions';
-const plugin = registerPlugin('IonicNativeUIShell');
-export const IonicNativeUIShell = plugin;
+import { setConfig } from "../transition/ios.transition.js";
+import { observeVerticalBarsModals } from "./shared/modal.js";
+import { createRuntime } from "./runtime.js";
+import { createVerticalBarsWebProjection } from "./vertical-bars-web.js";
+import { prehideVerticalBarsToolbarSources } from "./prehide.js";
+import { Capacitor, registerPlugin } from "@capacitor/core";
+//#region src/native/index.ts
+const plugin = registerPlugin("IonicNativeUIShell");
+const IonicNativeUIShell = plugin;
 let active;
 let activeConfiguration;
 const web = (reason) => ({
-    getStatus: () => ({ state: 'web', projected: 0, updates: 0, reason }),
-    suspend: async () => ({ resume: async () => { } }),
-    destroy: async () => { },
+	getStatus: () => ({
+		state: "web",
+		projected: 0,
+		updates: 0,
+		reason
+	}),
+	suspend: async () => ({ resume: async () => {} }),
+	destroy: async () => {}
 });
 const combine = (native, fallback) => ({
-    getStatus() {
-        const nativeStatus = native.getStatus();
-        const fallbackStatus = fallback.getStatus();
-        return {
-            ...nativeStatus,
-            state: nativeStatus.state === 'stopped' && fallbackStatus.state === 'stopped' ? 'stopped' : nativeStatus.projected > 0 ? 'native' : 'web',
-            projected: nativeStatus.projected + fallbackStatus.projected,
-            updates: nativeStatus.updates + fallbackStatus.updates,
-        };
-    },
-    async suspend() {
-        const [nativeLease, fallbackLease] = await Promise.all([native.suspend(), fallback.suspend()]);
-        return { resume: async () => void (await Promise.all([nativeLease.resume(), fallbackLease.resume()])) };
-    },
-    async destroy() {
-        await Promise.all([native.destroy(), fallback.destroy()]);
-    },
+	getStatus() {
+		const nativeStatus = native.getStatus();
+		const fallbackStatus = fallback.getStatus();
+		return {
+			...nativeStatus,
+			state: nativeStatus.state === "stopped" && fallbackStatus.state === "stopped" ? "stopped" : nativeStatus.projected > 0 ? "native" : "web",
+			projected: nativeStatus.projected + fallbackStatus.projected,
+			updates: nativeStatus.updates + fallbackStatus.updates
+		};
+	},
+	async suspend() {
+		const [nativeLease, fallbackLease] = await Promise.all([native.suspend(), fallback.suspend()]);
+		return { resume: async () => void await Promise.all([nativeLease.resume(), fallbackLease.resume()]) };
+	},
+	async destroy() {
+		await Promise.all([native.destroy(), fallback.destroy()]);
+	}
 });
+/** Wraps a runtime handle with the shared enable-lifecycle: reason, suspend hooks and idempotent destroy. */
 const manage = (handle, lifecycle = {}) => {
-    let destroyed = false;
-    return {
-        getStatus: () => (lifecycle.reason ? { ...handle.getStatus(), reason: lifecycle.reason } : handle.getStatus()),
-        async suspend() {
-            const lease = await handle.suspend();
-            const resume = lifecycle.suspend?.();
-            return {
-                async resume() {
-                    await lease.resume();
-                    resume?.();
-                },
-            };
-        },
-        async destroy() {
-            if (destroyed)
-                return;
-            destroyed = true;
-            try {
-                await handle.destroy();
-            }
-            finally {
-                await lifecycle.destroy?.();
-                lifecycle.release?.();
-            }
-        },
-    };
+	let destroyed = false;
+	return {
+		getStatus: () => lifecycle.reason ? {
+			...handle.getStatus(),
+			reason: lifecycle.reason
+		} : handle.getStatus(),
+		async suspend() {
+			const lease = await handle.suspend();
+			const resume = lifecycle.suspend?.();
+			return { async resume() {
+				await lease.resume();
+				resume?.();
+			} };
+		},
+		async destroy() {
+			if (destroyed) return;
+			destroyed = true;
+			try {
+				await handle.destroy();
+			} finally {
+				await lifecycle.destroy?.();
+				lifecycle.release?.();
+			}
+		}
+	};
 };
-export const configureNativeTransition = async () => {
-    const metrics = typeof document !== 'undefined' && Capacitor.getPlatform() === 'ios' ? (await plugin.getDeviceLayout()).webViewMetrics : { radius: 0 };
-    setConfig({ radius: metrics.radius });
-    return metrics;
+/** Reads the current native WebView geometry and applies it to page transitions. */
+const configureNativeTransition = async () => {
+	const metrics = typeof document !== "undefined" && Capacitor.getPlatform() === "ios" ? await plugin.getWebViewMetrics() : { radius: 0 };
+	setConfig({ radius: metrics.radius });
+	return metrics;
 };
-const physicalVerticalBarEdge = (edge, rtl) => (edge === 'leading') !== rtl ? 'left' : 'right';
-const elementRtl = (element) => element.closest('[dir]')?.getAttribute('dir') === 'rtl';
-export const setVerticalControlAreaPlacement = (placement, rtl) => {
-    if (typeof document === 'undefined')
-        return;
-    const app = document.querySelector('ion-app');
-    if (!app)
-        throw new Error('Vertical Control Area requires ion-app');
-    const { edge, inset } = placement && typeof placement === 'object' ? placement : { edge: placement, inset: 0 };
-    app.classList.toggle('ios-theme-vertical-bars', edge !== null);
-    app.classList.toggle('ios-theme-vertical-bars-left', edge !== null && physicalVerticalBarEdge(edge, rtl ?? elementRtl(app)) === 'left');
-    if (edge && Number.isFinite(inset) && inset > 0)
-        app.style.setProperty('--ios-theme-vertical-bars-native-inset', `${inset}px`);
-    else
-        app.style.removeProperty('--ios-theme-vertical-bars-native-inset');
+/** Resolves a logical vertical-bar edge to the physical side for the given direction. */
+const physicalVerticalBarEdge = (edge, rtl) => edge === "leading" !== rtl ? "left" : "right";
+const elementRtl = (element) => element.closest("[dir]")?.getAttribute("dir") === "rtl";
+const nativePlacements = /* @__PURE__ */ new WeakMap();
+const horizontalFallbackAttribute = "data-native-ui-shell-vertical-bars-suspended";
+const observeNativeVerticalBarsLayout = (doc) => {
+	const reconcile = () => {
+		const app = doc.querySelector("ion-app");
+		if (!app) return;
+		const requested = app.classList.contains("ios-theme-vertical-bars") || app.hasAttribute(horizontalFallbackAttribute);
+		const suspended = requested && nativePlacements.get(app)?.edge == null;
+		if (app.hasAttribute(horizontalFallbackAttribute) !== suspended) app.toggleAttribute(horizontalFallbackAttribute, suspended);
+		if (app.classList.contains("ios-theme-vertical-bars") !== (requested && !suspended)) app.classList.toggle("ios-theme-vertical-bars", requested && !suspended);
+	};
+	const observer = new MutationObserver(reconcile);
+	observer.observe(doc.documentElement, {
+		childList: true,
+		subtree: true,
+		attributes: true,
+		attributeFilter: ["class"]
+	});
+	doc.defaultView?.addEventListener("nativeUIShellRefresh", reconcile);
+	reconcile();
+	return () => {
+		observer.disconnect();
+		doc.defaultView?.removeEventListener("nativeUIShellRefresh", reconcile);
+		const app = doc.querySelector(`ion-app[${horizontalFallbackAttribute}]`);
+		if (app) {
+			app.removeAttribute(horizontalFallbackAttribute);
+			app.classList.add("ios-theme-vertical-bars");
+		}
+	};
 };
-export const enableVerticalControlArea = async () => {
-    const handle = await enableNativeUIShell({ controls: { tabs: true, toolbar: true }, verticalBarsOnly: true });
-    return {
-        getStatus: () => handle.getStatus(),
-        suspend: () => handle.suspend(),
-        destroy: () => handle.destroy(),
-        setPlacement: setVerticalControlAreaPlacement,
-    };
+/**
+* Applies one placement to the CSS layout and both Web/native projections.
+* Pass `rtl` when the document direction is known; otherwise the nearest `dir` attribute is used.
+*/
+const setVerticalControlAreaPlacement = (placement, rtl) => {
+	if (typeof document === "undefined") return;
+	const app = document.querySelector("ion-app");
+	if (!app) throw new Error("Vertical Control Area requires ion-app");
+	const { edge, inset = 0 } = placement && typeof placement === "object" ? placement : {
+		edge: placement,
+		inset: 0
+	};
+	if (placement && typeof placement === "object" && placement.nativeEdge !== void 0) nativePlacements.set(app, {
+		edge: placement.nativeEdge,
+		rtl
+	});
+	app.removeAttribute(horizontalFallbackAttribute);
+	app.classList.toggle("ios-theme-vertical-bars", edge !== null);
+	app.classList.toggle("ios-theme-vertical-bars-left", edge !== null && physicalVerticalBarEdge(edge, rtl ?? elementRtl(app)) === "left");
+	if (edge && Number.isFinite(inset) && inset > 0) app.style.setProperty("--ios-theme-vertical-bars-native-inset", `${inset}px`);
+	else app.style.removeProperty("--ios-theme-vertical-bars-native-inset");
+	document.defaultView?.dispatchEvent(new Event("nativeUIShellRefresh"));
 };
-export const enableNativeUIShell = (options = {}) => {
-    if (options.enabled === false) {
-        const current = active;
-        active = undefined;
-        activeConfiguration = undefined;
-        return current
-            ? current.then(async (handle) => {
-                await handle.destroy();
-                return web('Disabled');
-            })
-            : Promise.resolve(web('Disabled'));
-    }
-    if (typeof document === 'undefined')
-        return Promise.resolve(web('Requires a document'));
-    const controls = options.controls;
-    const configuration = JSON.stringify([
-        options.verticalBarsOnly === true,
-        ...['tabs', 'toolbar', 'segment', 'fab'].map((component) => !controls || controls[component] === true),
-    ]);
-    if (active && activeConfiguration !== configuration)
-        return Promise.reject(new Error('Native UI Shell is already running with different controls; destroy it before changing configuration.'));
-    if (active)
-        return active;
-    activeConfiguration = configuration;
-    const stopModals = observeVerticalBarsModals(document);
-    const prehide = options.controls === undefined || options.controls.toolbar === true ? prehideVerticalBarsToolbarSources(document) : undefined;
-    let start;
-    const release = () => {
-        if (active === start) {
-            active = undefined;
-            activeConfiguration = undefined;
-        }
-    };
-    const fallback = (reason) => manage(createVerticalBarsWebProjection(document, options), {
-        reason,
-        suspend: () => prehide?.suspend(),
-        destroy: () => {
-            prehide?.stop();
-            stopModals();
-        },
-        release,
-    });
-    return (start = active =
-        (async () => {
-            if (Capacitor.getPlatform() !== 'ios')
-                return fallback('Requires Capacitor iOS');
-            let runtime;
-            let placementListener;
-            let monitoring = false;
-            try {
-                if (!options.verticalBarsOnly)
-                    await configureNativeTransition().catch(() => undefined);
-                const capabilities = await plugin.configure({ verticalBarsOnly: options.verticalBarsOnly === true });
-                if (!capabilities.supported)
-                    return fallback('Requires iOS 26 or later');
-                let nativeEdge = null;
-                const nativeVerticalBars = () => {
-                    const root = document.querySelector('ion-app.ios-theme-vertical-bars');
-                    if (!root)
-                        return false;
-                    const domEdge = root.classList.contains('ios-theme-vertical-bars-left') ? 'left' : 'right';
-                    return nativeEdge === null || physicalVerticalBarEdge(nativeEdge, elementRtl(root)) === domEdge;
-                };
-                await plugin.startDeviceLayoutMonitoring();
-                monitoring = true;
-                placementListener = await plugin.addListener('deviceLayoutChange', ({ placement, webViewMetrics }) => {
-                    nativeEdge = placement.edge;
-                    if (!options.verticalBarsOnly)
-                        setConfig({ radius: webViewMetrics.radius });
-                    document.defaultView?.dispatchEvent(new Event('nativeUIShellRefresh'));
-                });
-                nativeEdge = (await plugin.getDeviceLayout()).placement.edge;
-                const native = await createRuntime(document, plugin, options, nativeVerticalBars, options.verticalBarsOnly === true);
-                runtime = combine(native, createVerticalBarsWebProjection(document, options, () => !nativeVerticalBars() || native.getStatus().state === 'stopped'));
-                return manage(runtime, {
-                    suspend: () => prehide?.suspend(),
-                    release,
-                    destroy: async () => {
-                        await placementListener?.remove().catch(() => { });
-                        if (monitoring)
-                            await plugin.stopDeviceLayoutMonitoring().catch(() => { });
-                        prehide?.stop();
-                        stopModals();
-                    },
-                });
-            }
-            catch (error) {
-                await runtime?.destroy();
-                await placementListener?.remove().catch(() => { });
-                if (monitoring)
-                    await plugin.stopDeviceLayoutMonitoring().catch(() => { });
-                return fallback(error instanceof Error ? error.message : String(error));
-            }
-        })());
+/**
+* Call once after ion-app is mounted. Ionic markup remains the source of truth.
+* Set buttonDefaultFill to `solid` for Ionic's default design, or `null` for this
+* theme's glass design. Omitting it is equivalent to `null` (existing behavior).
+* This default affects native vertical projection only; explicit button fills win.
+*/
+const enableVerticalControlArea = async (options = {}) => {
+	const handle = await enableNativeUIShell({
+		buttonDefaultFill: options.buttonDefaultFill,
+		controls: {
+			tabs: true,
+			toolbar: true
+		},
+		verticalBarsOnly: true
+	});
+	return {
+		getStatus: () => handle.getStatus(),
+		suspend: () => handle.suspend(),
+		destroy: () => handle.destroy(),
+		setPlacement: setVerticalControlAreaPlacement
+	};
 };
+/** Call once at application startup. Ionic markup remains the source of truth. */
+const enableNativeUIShell = (options = {}) => {
+	if (options.enabled === false) {
+		const current = active;
+		active = void 0;
+		activeConfiguration = void 0;
+		return current ? current.then(async (handle) => {
+			await handle.destroy();
+			return web("Disabled");
+		}) : Promise.resolve(web("Disabled"));
+	}
+	if (typeof document === "undefined") return Promise.resolve(web("Requires a document"));
+	const controls = options.controls;
+	const configuration = JSON.stringify([
+		options.verticalBarsOnly === true,
+		options.buttonDefaultFill ?? null,
+		...[
+			"tabs",
+			"toolbar",
+			"segment",
+			"fab"
+		].map((component) => !controls || controls[component] === true)
+	]);
+	if (active && activeConfiguration !== configuration) return Promise.reject(/* @__PURE__ */ new Error("Native UI Shell is already running with different controls; destroy it before changing configuration."));
+	if (active) return active;
+	activeConfiguration = configuration;
+	const stopModals = observeVerticalBarsModals(document);
+	const prehide = options.controls === void 0 || options.controls.toolbar === true ? prehideVerticalBarsToolbarSources(document) : void 0;
+	let start;
+	const release = () => {
+		if (active === start) {
+			active = void 0;
+			activeConfiguration = void 0;
+		}
+	};
+	const fallback = (reason) => manage(createVerticalBarsWebProjection(document, options), {
+		reason,
+		suspend: () => prehide?.suspend(),
+		destroy: () => {
+			prehide?.stop();
+			stopModals();
+		},
+		release
+	});
+	return start = active = (async () => {
+		if (Capacitor.getPlatform() !== "ios") return fallback("Requires Capacitor iOS");
+		let runtime;
+		let metricsListener;
+		let stopVerticalBarsLayout;
+		try {
+			if (!(await plugin.configure({ verticalBarsOnly: options.verticalBarsOnly === true })).supported) return fallback("Requires iOS 26 or later");
+			if (!options.verticalBarsOnly) stopVerticalBarsLayout = observeNativeVerticalBarsLayout(document);
+			const nativeVerticalBars = () => {
+				const app = document.querySelector("ion-app.ios-theme-vertical-bars");
+				if (!app) return false;
+				const reported = nativePlacements.get(app);
+				if (!reported?.edge) return false;
+				return (app.classList.contains("ios-theme-vertical-bars-left") ? "left" : "right") === physicalVerticalBarEdge(reported.edge, reported.rtl ?? elementRtl(app));
+			};
+			if (!options.verticalBarsOnly) {
+				metricsListener = await plugin.addListener("webViewMetricsChange", (metrics) => {
+					setConfig({ radius: metrics.radius });
+				});
+				await configureNativeTransition().catch(() => void 0);
+			}
+			const native = await createRuntime(document, plugin, options, nativeVerticalBars, options.verticalBarsOnly === true);
+			runtime = combine(native, createVerticalBarsWebProjection(document, options, () => !nativeVerticalBars() || native.getStatus().state === "stopped"));
+			return manage(runtime, {
+				suspend: () => prehide?.suspend(),
+				release,
+				destroy: async () => {
+					await metricsListener?.remove().catch(() => {});
+					stopVerticalBarsLayout?.();
+					prehide?.stop();
+					stopModals();
+				}
+			});
+		} catch (error) {
+			await runtime?.destroy();
+			await metricsListener?.remove().catch(() => {});
+			stopVerticalBarsLayout?.();
+			return fallback(error instanceof Error ? error.message : String(error));
+		}
+	})();
+};
+//#endregion
+export { IonicNativeUIShell, configureNativeTransition, enableNativeUIShell, enableVerticalControlArea, setVerticalControlAreaPlacement };
+
+//# sourceMappingURL=index.js.map

package/dist/native/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/native/index.ts"],"sourcesContent":["import { Capacitor, registerPlugin } from '@capacitor/core';\nimport { setConfig } from '../transition/ios.transition';\nimport type {\n  NativeUIShellHandle,\n  NativeUIShellOptions,\n  NativeUIShellPlugin,\n  VerticalBarEdge,\n  VerticalBarPlacement,\n  VerticalControlAreaHandle,\n  VerticalControlAreaOptions,\n  WebViewMetrics,\n} from './definitions';\nimport { createRuntime } from './runtime';\nimport { createVerticalBarsWebProjection } from './vertical-bars-web';\nimport { prehideVerticalBarsToolbarSources } from './prehide';\nimport { observeVerticalBarsModals } from './shared/modal';\nexport type {\n  NativeUIShellComponent,\n  NativeUIShellControls,\n  NativeUIShellHandle,\n  NativeUIShellOptions,\n  NativeUIShellStatus,\n  NativeUIShellSuspension,\n  VerticalBarEdge,\n  VerticalBarPlacement,\n  VerticalControlAreaHandle,\n  VerticalControlAreaOptions,\n  WebViewMetrics,\n} from './definitions';\n\nconst plugin = registerPlugin<NativeUIShellPlugin>('IonicNativeUIShell');\nexport const IonicNativeUIShell = plugin;\nlet active: Promise<NativeUIShellHandle> | undefined;\nlet activeConfiguration: string | undefined;\nconst web = (reason: string): NativeUIShellHandle => ({\n  getStatus: () => ({ state: 'web', projected: 0, updates: 0, reason }),\n  suspend: async () => ({ resume: async () => {} }),\n  destroy: async () => {},\n});\n\nconst combine = (native: NativeUIShellHandle, fallback: NativeUIShellHandle): NativeUIShellHandle => ({\n  getStatus() {\n    const nativeStatus = native.getStatus();\n    const fallbackStatus = fallback.getStatus();\n    return {\n      ...nativeStatus,\n      state:\n        nativeStatus.state === 'stopped' && fallbackStatus.state === 'stopped' ? 'stopped' : nativeStatus.projected > 0 ? 'native' : 'web',\n      projected: nativeStatus.projected + fallbackStatus.projected,\n      updates: nativeStatus.updates + fallbackStatus.updates,\n    };\n  },\n  async suspend() {\n    const [nativeLease, fallbackLease] = await Promise.all([native.suspend(), fallback.suspend()]);\n    return { resume: async () => void (await Promise.all([nativeLease.resume(), fallbackLease.resume()])) };\n  },\n  async destroy() {\n    await Promise.all([native.destroy(), fallback.destroy()]);\n  },\n});\n\n/** Wraps a runtime handle with the shared enable-lifecycle: reason, suspend hooks and idempotent destroy. */\nconst manage = (\n  handle: NativeUIShellHandle,\n  lifecycle: {\n    reason?: string;\n    suspend?: () => (() => void) | undefined;\n    /** Runs after teardown; clears the shared slot only while this activation owns it. */\n    release?: () => void;\n    destroy?: () => void | Promise<void>;\n  } = {},\n): NativeUIShellHandle => {\n  let destroyed = false;\n  return {\n    getStatus: () => (lifecycle.reason ? { ...handle.getStatus(), reason: lifecycle.reason } : handle.getStatus()),\n    async suspend() {\n      const lease = await handle.suspend();\n      const resume = lifecycle.suspend?.();\n      return {\n        async resume() {\n          await lease.resume();\n          resume?.();\n        },\n      };\n    },\n    async destroy() {\n      if (destroyed) return;\n      destroyed = true;\n      try {\n        await handle.destroy();\n      } finally {\n        await lifecycle.destroy?.();\n        lifecycle.release?.();\n      }\n    },\n  };\n};\n\n/** Reads the current native WebView geometry and applies it to page transitions. */\nexport const configureNativeTransition = async (): Promise<WebViewMetrics> => {\n  const metrics = typeof document !== 'undefined' && Capacitor.getPlatform() === 'ios' ? await plugin.getWebViewMetrics() : { radius: 0 };\n  setConfig({ radius: metrics.radius });\n  return metrics;\n};\n\n/** Resolves a logical vertical-bar edge to the physical side for the given direction. */\nconst physicalVerticalBarEdge = (edge: Exclude<VerticalBarEdge, null>, rtl: boolean): 'left' | 'right' =>\n  (edge === 'leading') !== rtl ? 'left' : 'right';\n\nconst elementRtl = (element: Element): boolean => element.closest('[dir]')?.getAttribute('dir') === 'rtl';\n\n// Device facts are supplied by the application; the theme only compares placement.\nconst nativePlacements = new WeakMap<HTMLElement, { edge: VerticalBarEdge; rtl?: boolean }>();\nconst horizontalFallbackAttribute = 'data-native-ui-shell-vertical-bars-suspended';\n\n// Keep the requested rail while ordinary Native UI Shell temporarily uses its\n// horizontal layout. Removing the effective class restores normal measurements,\n// toolbar ownership and safe areas throughout the existing rendering pipeline.\nconst observeNativeVerticalBarsLayout = (doc: Document): (() => void) => {\n  const reconcile = () => {\n    const app = doc.querySelector<HTMLElement>('ion-app');\n    if (!app) return;\n    const requested = app.classList.contains('ios-theme-vertical-bars') || app.hasAttribute(horizontalFallbackAttribute);\n    const suspended = requested && nativePlacements.get(app)?.edge == null;\n    if (app.hasAttribute(horizontalFallbackAttribute) !== suspended) app.toggleAttribute(horizontalFallbackAttribute, suspended);\n    if (app.classList.contains('ios-theme-vertical-bars') !== (requested && !suspended)) {\n      app.classList.toggle('ios-theme-vertical-bars', requested && !suspended);\n    }\n  };\n  const observer = new MutationObserver(reconcile);\n  observer.observe(doc.documentElement, { childList: true, subtree: true, attributes: true, attributeFilter: ['class'] });\n  doc.defaultView?.addEventListener('nativeUIShellRefresh', reconcile);\n  reconcile();\n  return () => {\n    observer.disconnect();\n    doc.defaultView?.removeEventListener('nativeUIShellRefresh', reconcile);\n    const app = doc.querySelector<HTMLElement>(`ion-app[${horizontalFallbackAttribute}]`);\n    if (app) {\n      app.removeAttribute(horizontalFallbackAttribute);\n      app.classList.add('ios-theme-vertical-bars');\n    }\n  };\n};\n\n/**\n * Applies one placement to the CSS layout and both Web/native projections.\n * Pass `rtl` when the document direction is known; otherwise the nearest `dir` attribute is used.\n */\nexport const setVerticalControlAreaPlacement = (placement: VerticalBarEdge | VerticalBarPlacement, rtl?: boolean): void => {\n  if (typeof document === 'undefined') return;\n  const app = document.querySelector<HTMLElement>('ion-app');\n  if (!app) throw new Error('Vertical Control Area requires ion-app');\n  const { edge, inset = 0 } = placement && typeof placement === 'object' ? placement : { edge: placement, inset: 0 };\n  if (placement && typeof placement === 'object' && placement.nativeEdge !== undefined) {\n    nativePlacements.set(app, { edge: placement.nativeEdge, rtl });\n  }\n  app.removeAttribute(horizontalFallbackAttribute);\n  app.classList.toggle('ios-theme-vertical-bars', edge !== null);\n  app.classList.toggle('ios-theme-vertical-bars-left', edge !== null && physicalVerticalBarEdge(edge, rtl ?? elementRtl(app)) === 'left');\n  if (edge && Number.isFinite(inset) && inset > 0) app.style.setProperty('--ios-theme-vertical-bars-native-inset', `${inset}px`);\n  else app.style.removeProperty('--ios-theme-vertical-bars-native-inset');\n  document.defaultView?.dispatchEvent(new Event('nativeUIShellRefresh'));\n};\n\n/**\n * Call once after ion-app is mounted. Ionic markup remains the source of truth.\n * Set buttonDefaultFill to `solid` for Ionic's default design, or `null` for this\n * theme's glass design. Omitting it is equivalent to `null` (existing behavior).\n * This default affects native vertical projection only; explicit button fills win.\n */\nexport const enableVerticalControlArea = async (options: VerticalControlAreaOptions = {}): Promise<VerticalControlAreaHandle> => {\n  const handle = await enableNativeUIShell({\n    buttonDefaultFill: options.buttonDefaultFill,\n    controls: { tabs: true, toolbar: true },\n    verticalBarsOnly: true,\n  });\n  return {\n    getStatus: () => handle.getStatus(),\n    suspend: () => handle.suspend(),\n    destroy: () => handle.destroy(),\n    setPlacement: setVerticalControlAreaPlacement,\n  };\n};\n\n/** Call once at application startup. Ionic markup remains the source of truth. */\nexport const enableNativeUIShell = (options: NativeUIShellOptions = {}): Promise<NativeUIShellHandle> => {\n  if (options.enabled === false) {\n    const current = active;\n    active = undefined;\n    activeConfiguration = undefined;\n    return current\n      ? current.then(async (handle) => {\n          await handle.destroy();\n          return web('Disabled');\n        })\n      : Promise.resolve(web('Disabled'));\n  }\n  if (typeof document === 'undefined') return Promise.resolve(web('Requires a document'));\n  const controls = options.controls;\n  const configuration = JSON.stringify([\n    options.verticalBarsOnly === true,\n    options.buttonDefaultFill ?? null,\n    ...(['tabs', 'toolbar', 'segment', 'fab'] as const).map((component) => !controls || controls[component] === true),\n  ]);\n  if (active && activeConfiguration !== configuration)\n    return Promise.reject(\n      new Error('Native UI Shell is already running with different controls; destroy it before changing configuration.'),\n    );\n  if (active) return active;\n  activeConfiguration = configuration;\n  const stopModals = observeVerticalBarsModals(document);\n  const prehide =\n    options.controls === undefined || options.controls.toolbar === true ? prehideVerticalBarsToolbarSources(document) : undefined;\n  // A slow destroy of a superseded activation must not release a newer one.\n  let start: Promise<NativeUIShellHandle>;\n  const release = () => {\n    if (active === start) {\n      active = undefined;\n      activeConfiguration = undefined;\n    }\n  };\n  const fallback = (reason: string) =>\n    manage(createVerticalBarsWebProjection(document, options), {\n      reason,\n      suspend: () => prehide?.suspend(),\n      destroy: () => {\n        prehide?.stop();\n        stopModals();\n      },\n      release,\n    });\n  return (start = active =\n    (async () => {\n      if (Capacitor.getPlatform() !== 'ios') return fallback('Requires Capacitor iOS');\n      let runtime: NativeUIShellHandle | undefined;\n      let metricsListener: Awaited<ReturnType<typeof plugin.addListener>> | undefined;\n      let stopVerticalBarsLayout: (() => void) | undefined;\n      try {\n        const capabilities = await plugin.configure({ verticalBarsOnly: options.verticalBarsOnly === true });\n        if (!capabilities.supported) return fallback('Requires iOS 26 or later');\n        if (!options.verticalBarsOnly) stopVerticalBarsLayout = observeNativeVerticalBarsLayout(document);\n        // The application owns device state and selects the rail through placement classes.\n        const nativeVerticalBars = () => {\n          const app = document.querySelector<HTMLElement>('ion-app.ios-theme-vertical-bars');\n          if (!app) return false;\n          const reported = nativePlacements.get(app);\n          if (!reported?.edge) return false;\n          const physicalEdge = app.classList.contains('ios-theme-vertical-bars-left') ? 'left' : 'right';\n          return physicalEdge === physicalVerticalBarEdge(reported.edge, reported.rtl ?? elementRtl(app));\n        };\n        if (!options.verticalBarsOnly) {\n          metricsListener = await plugin.addListener('webViewMetricsChange', (metrics) => {\n            setConfig({ radius: metrics.radius });\n          });\n          await configureNativeTransition().catch(() => undefined);\n        }\n        const native = await createRuntime(document, plugin, options, nativeVerticalBars, options.verticalBarsOnly === true);\n        runtime = combine(\n          native,\n          createVerticalBarsWebProjection(document, options, () => !nativeVerticalBars() || native.getStatus().state === 'stopped'),\n        );\n        return manage(runtime, {\n          suspend: () => prehide?.suspend(),\n          release,\n          destroy: async () => {\n            await metricsListener?.remove().catch(() => {});\n            stopVerticalBarsLayout?.();\n            prehide?.stop();\n            stopModals();\n          },\n        });\n      } catch (error) {\n        await runtime?.destroy();\n        await metricsListener?.remove().catch(() => {});\n        stopVerticalBarsLayout?.();\n        return fallback(error instanceof Error ? error.message : String(error));\n      }\n    })());\n};\n"],"mappings":"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"}

package/dist/native/prehide.d.ts

@@ -1,5 +1,7 @@
+//#region src/native/prehide.d.ts
 export declare const prehideVerticalBarsToolbarSources: (doc: Document) => {
-    suspend: () => () => void;
-    stop: () => void;
+  suspend: () => () => void;
+  stop: () => void;
 };
+//#endregion
 //# sourceMappingURL=prehide.d.ts.map

package/dist/native/prehide.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prehide.d.ts","sourceRoot":"","sources":["../../src/native/prehide.ts"],"names":[],"mappings":"AAkCA,eAAO,MAAM,iCAAiC,GAAI,KAAK,QAAQ,KAAG;IAAE,OAAO,EAAE,MAAM,MAAM,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,IAAI,CAAA;CA+N9G,CAAC"}
+{"version":3,"file":"prehide.d.ts","names":[],"sources":["../../src/native/prehide.ts"],"mappings":";qBAkCa,oCAAqC,KAAK;EAAa;EAA2B"}