@rdlabo/capacitor-native-ui 0.0.0-stage → 2.0.0-1

package/dist/native/activation.js

@@ -0,0 +1,305 @@
+import { controlDefault } from "./shared/control-options.js";
+import { observeVerticalBarsModals } from "./shared/modal.js";
+import { toolbarOptions } from "./shared/toolbar-options.js";
+import { createDiagnostics } from "./shared/diagnostics.js";
+import { createHTMLWebProjection } from "./html.js";
+import { defineNativeUI, validateExtensions } from "./extensions.js";
+import { nativeWebViewMetrics } from "../native-integration/index.js";
+import { bounded, boundedListener } from "./shared/bridge.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/activation.ts
+const plugin = registerPlugin("NativeUI");
+const NativeUI = plugin;
+let active;
+let activeFailed = false;
+let activeRoot;
+let activeRailHost;
+let activeConfiguration;
+let activeExtensions = [];
+let stopping;
+const stopActivation = (owner, destruction) => {
+	if (active !== owner) return;
+	active = void 0;
+	activeFailed = false;
+	activeConfiguration = void 0;
+	activeRoot = void 0;
+	activeRailHost = void 0;
+	activeExtensions = [];
+	stopping = destruction;
+	const release = () => {
+		if (stopping === destruction) stopping = void 0;
+	};
+	destruction.then(release, release);
+};
+const web = (reason) => ({
+	markForCheck: () => {},
+	getStatus: () => ({
+		state: "web",
+		projected: 0,
+		updates: 0,
+		reason
+	}),
+	suspend: async () => ({ resume: async () => {} }),
+	destroy: async () => {}
+});
+const combine = (native, fallback) => ({
+	markForCheck() {
+		native.markForCheck();
+		fallback.markForCheck();
+	},
+	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 destruction;
+	return {
+		markForCheck: () => {
+			if (!destruction) handle.markForCheck();
+		},
+		getStatus: () => lifecycle.reason ? {
+			...handle.getStatus(),
+			reason: lifecycle.reason
+		} : handle.getStatus(),
+		async suspend() {
+			const lease = await handle.suspend();
+			const resume = await lifecycle.suspend?.();
+			return { async resume() {
+				await lease.resume();
+				resume?.();
+			} };
+		},
+		destroy() {
+			if (!destruction) {
+				destruction = Promise.resolve().then(async () => {
+					try {
+						await handle.destroy();
+					} finally {
+						await lifecycle.destroy?.();
+					}
+				});
+				lifecycle.stopping?.(destruction);
+			}
+			return destruction;
+		}
+	};
+};
+/** Reads the current native WebView geometry and applies it to page transitions. */
+const configureNativeTransition = async () => {
+	const metrics = typeof document !== "undefined" && Capacitor.getPlatform() === "ios" && Capacitor.isPluginAvailable("NativeUI") ? await bounded(plugin.getWebViewMetrics()) : { radius: 0 };
+	nativeWebViewMetrics.radius = metrics.radius;
+	return metrics;
+};
+/** 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 webProjection = (doc, options, enabled = () => true) => {
+	const ionic = () => createVerticalBarsWebProjection(doc, options, () => options.verticalBars?.enabled !== false && enabled());
+	if (options.source === "html") return createHTMLWebProjection(doc, options);
+	if (options.source === "auto") return combine(ionic(), createHTMLWebProjection(doc, options));
+	return ionic();
+};
+/** Call once at application startup. Ionic markup remains the source of truth. */
+const enableNativeUI = (options = {}, overlayFactory) => {
+	if (typeof document === "undefined") return Promise.resolve(web("Requires a document"));
+	const extensions = [...options.extensions ?? []];
+	const nativeState = options.nativeState = {};
+	try {
+		validateExtensions(extensions, document);
+	} catch (error) {
+		return Promise.reject(error);
+	}
+	const configuration = JSON.stringify([
+		options.source ?? "ionic",
+		options.debug === true,
+		options.ionic?.auto !== false,
+		options.verticalBars?.enabled !== false,
+		options.verticalBars?.placement?.edge,
+		options.rail?.edge,
+		toolbarOptions(options, false),
+		toolbarOptions(options, true),
+		options.ionic?.verticalBars?.buttonProjection ?? "system",
+		options.ionic?.verticalBars?.buttonDefaultFill ?? "glass",
+		...[
+			"tabs",
+			"segment",
+			"fab"
+		].flatMap((kind) => [controlDefault(options, kind, false), controlDefault(options, kind, true)]),
+		options.ionic?.verticalBars?.popover === true
+	]);
+	if (active && activeFailed) {
+		const previous = active;
+		stopActivation(previous, previous.then((handle) => handle.destroy()));
+	}
+	if (active && (activeConfiguration !== configuration || activeRoot !== options.root || activeRailHost !== options.rail?.host || extensions.length !== activeExtensions.length || extensions.some((extension, index) => extension !== activeExtensions[index]))) return Promise.reject(/* @__PURE__ */ new Error("Native UI is already running with different controls or extensions; destroy it before changing configuration."));
+	if (active) return active;
+	activeConfiguration = configuration;
+	activeRoot = options.root;
+	activeRailHost = options.rail?.host;
+	activeExtensions = extensions;
+	const previousStop = stopping;
+	let start;
+	const stop = (destruction) => stopActivation(start, destruction);
+	let releaseNative = async () => {};
+	let retired = false;
+	const pagehide = () => runtimeStopped("pagehide");
+	const runtimeStopped = (cause) => {
+		if (cause === "failure") {
+			if (active === start) activeFailed = true;
+			start.then(async () => {
+				if (!retired) document.defaultView?.addEventListener("pagehide", pagehide, { once: true });
+				await releaseNative();
+			}).catch(() => {});
+			return;
+		}
+		const destruction = start.then((handle) => handle.destroy());
+		stop(destruction);
+		destruction.catch(() => {});
+	};
+	return start = active = (async () => {
+		if (previousStop) await previousStop.catch(() => {});
+		const platform = Capacitor.getPlatform();
+		const diagnose = createDiagnostics(options.debug);
+		const stopModals = options.source === "html" ? () => {} : observeVerticalBarsModals(document);
+		const prehide = platform !== "android" && options.source !== "html" && options.ionic?.auto !== false ? prehideVerticalBarsToolbarSources(document, () => options.verticalBars?.enabled !== false, options.root, options) : void 0;
+		const fallback = (reason) => {
+			diagnose(`web-fallback: ${reason}`);
+			return manage(webProjection(document, options), {
+				reason,
+				suspend: () => prehide?.suspend(),
+				destroy: () => {
+					retired = true;
+					document.defaultView?.removeEventListener("pagehide", pagehide);
+					prehide?.stop();
+					stopModals();
+				},
+				stopping: stop
+			});
+		};
+		if (platform !== "ios" && platform !== "android") return fallback("Requires Capacitor iOS or Android");
+		if (!Capacitor.isPluginAvailable("NativeUI")) return fallback("Native UI plugin is not registered");
+		let runtime;
+		let overlays;
+		let metricsListener;
+		let nativeRelease;
+		releaseNative = () => nativeRelease ?? (nativeRelease = (async () => {
+			try {
+				await overlays?.destroy();
+			} finally {
+				if (metricsListener) await bounded(metricsListener.remove()).catch(() => {});
+			}
+		})());
+		const cleanup = async () => {
+			retired = true;
+			try {
+				await releaseNative();
+			} finally {
+				document.defaultView?.removeEventListener("pagehide", pagehide);
+				prehide?.stop();
+				stopModals();
+			}
+		};
+		try {
+			const ordinaryControls = [
+				"button",
+				"backButton",
+				"tabs",
+				"segment",
+				"fab"
+			].some((kind) => controlDefault(options, kind, false));
+			const capabilities = await bounded(plugin.configure({ suppressScrollEdgeEffect: ordinaryControls }));
+			if (!capabilities.supported) return fallback("Native UI is unavailable on this device");
+			const unavailableExtensions = /* @__PURE__ */ new Map();
+			for (const extension of extensions) if (platform === "android" && extension.placement === "tab-accessory") unavailableExtensions.set(extension.name, "unsupported-placement: tab-accessory requires a supported iOS tab host.");
+			else if (!capabilities.extensions?.includes(extension.name)) unavailableExtensions.set(extension.name, "unregistered-extension: register this name in the native app before enabling the shell, then rebuild.");
+			if (platform === "android") {
+				runtime = await createRuntime(document, plugin, {
+					...options,
+					source: "extensions",
+					extensions,
+					unavailableExtensions
+				}, () => false, runtimeStopped);
+				runtime = combine(runtime, webProjection(document, options));
+				metricsListener = await boundedListener(plugin.addListener("webViewMetricsChange", () => {
+					document.defaultView?.dispatchEvent(new Event("nativeUIRefresh"));
+				}));
+				return manage(runtime, {
+					stopping: stop,
+					destroy: cleanup
+				});
+			}
+			let deviceEdge = null;
+			const ionicRoot = () => {
+				if (options.source === "html") return null;
+				const root = options.root ?? document.body;
+				return root.closest("ion-app") ?? root.querySelector("ion-app");
+			};
+			const updateNativeEdge = () => {
+				const requested = options.verticalBars?.placement?.edge;
+				const root = ionicRoot() ?? options.root ?? document.body;
+				nativeState.edge = deviceEdge && (!requested || requested === deviceEdge) ? physicalVerticalBarEdge(deviceEdge, elementRtl(root)) : void 0;
+			};
+			const nativeVerticalBars = () => {
+				updateNativeEdge();
+				if (options.verticalBars?.enabled === false) return false;
+				const app = ionicRoot();
+				if (!app?.classList.contains("ios-theme-vertical-bars")) return !!nativeState.edge;
+				return (app.classList.contains("ios-theme-vertical-bars-left") ? "left" : "right") === nativeState.edge;
+			};
+			const applyMetrics = (metrics) => {
+				if (ordinaryControls) nativeWebViewMetrics.radius = metrics.radius;
+				deviceEdge = metrics.verticalBarEdge ?? null;
+				updateNativeEdge();
+				document.defaultView?.dispatchEvent(new Event("nativeUIRefresh"));
+			};
+			metricsListener = await boundedListener(plugin.addListener("webViewMetricsChange", applyMetrics));
+			await bounded(Promise.resolve().then(() => plugin.getWebViewMetrics())).then(applyMetrics).catch(() => void 0);
+			const native = await createRuntime(document, plugin, {
+				...options,
+				extensions,
+				unavailableExtensions
+			}, nativeVerticalBars, runtimeStopped);
+			runtime = combine(native, webProjection(document, options, () => !nativeVerticalBars() || native.getStatus().projected === 0));
+			if (options.ionic?.verticalBars?.popover === true && overlayFactory) overlays = await overlayFactory(document, plugin, options, native.retain, nativeVerticalBars);
+			return manage(runtime, {
+				suspend: async () => {
+					const restorePrehide = prehide?.suspend();
+					const resumeOverlays = await overlays?.suspend();
+					return () => {
+						restorePrehide?.();
+						resumeOverlays?.();
+					};
+				},
+				stopping: stop,
+				destroy: cleanup
+			});
+		} catch (error) {
+			await overlays?.destroy().catch(() => {});
+			await runtime?.destroy().catch(() => {});
+			if (metricsListener) await bounded(metricsListener.remove()).catch(() => {});
+			return fallback(error instanceof Error ? error.message : String(error));
+		}
+	})();
+};
+//#endregion
+export { NativeUI, configureNativeTransition, defineNativeUI, enableNativeUI };
+
+//# sourceMappingURL=activation.js.map

package/dist/native/activation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activation.js","names":[],"sources":["../../src/native/activation.ts"],"sourcesContent":["import { controlDefault } from './shared/control-options';\nimport { toolbarOptions } from './shared/toolbar-options';\nimport { createDiagnostics } from './shared/diagnostics';\nimport { createHTMLWebProjection } from './html';\nimport { validateExtensions, type NativeUIExtension } from './extensions';\nimport { Capacitor, registerPlugin } from '@capacitor/core';\nimport { nativeWebViewMetrics } from '../native-integration';\nimport type { NativeUIRuntimeHandle, NativeUIRuntimeOptions, NativeUIPlugin, VerticalBarEdge, WebViewMetrics } from './definitions';\nimport { createRuntime } from './runtime';\nimport { bounded, boundedListener } from './shared/bridge';\ninterface OverlayController {\n  suspend(): Promise<() => void>;\n  destroy(): Promise<void>;\n}\ntype OverlayFactory = (\n  doc: Document,\n  plugin: NativeUIPlugin,\n  options: NativeUIRuntimeOptions,\n  retain: (deferActivation?: (id: string) => boolean) => () => void,\n  nativeRail: () => boolean,\n) => Promise<OverlayController>;\nimport { createVerticalBarsWebProjection } from './vertical-bars-web';\nimport { prehideVerticalBarsToolbarSources } from './prehide';\nimport { observeVerticalBarsModals } from './shared/modal';\nexport { defineNativeUI } from './extensions';\nexport type { NativeUIExtension, NativeUIValue } from './extensions';\nexport type {\n  NativeUIComponent,\n  NativeUIControls,\n  NativeUIRuntimeHandle,\n  NativeUIRuntimeOptions,\n  NativeUIStatus,\n  NativeUISuspension,\n  VerticalBarEdge,\n  WebViewMetrics,\n} from './definitions';\n\nconst plugin = registerPlugin<NativeUIPlugin>('NativeUI');\nexport const NativeUI = plugin;\nlet active: Promise<NativeUIRuntimeHandle> | undefined;\nlet activeFailed = false;\nlet activeRoot: HTMLElement | undefined;\nlet activeRailHost: HTMLElement | undefined;\nlet activeConfiguration: string | undefined;\nlet activeExtensions: readonly NativeUIExtension[] = [];\nlet stopping: Promise<void> | undefined;\n\n// Every stop entry point releases the activation immediately but reserves the\n// shared native/DOM resources until its teardown has settled.\nconst stopActivation = (owner: Promise<NativeUIRuntimeHandle>, destruction: Promise<void>) => {\n  if (active !== owner) return;\n  active = undefined;\n  activeFailed = false;\n  activeConfiguration = undefined;\n  activeRoot = undefined;\n  activeRailHost = undefined;\n  activeExtensions = [];\n  stopping = destruction;\n  const release = () => {\n    if (stopping === destruction) stopping = undefined;\n  };\n  void destruction.then(release, release);\n};\nconst web = (reason: string): NativeUIRuntimeHandle => ({\n  markForCheck: () => {},\n  getStatus: () => ({ state: 'web', projected: 0, updates: 0, reason }),\n  suspend: async () => ({ resume: async () => {} }),\n  destroy: async () => {},\n});\n\nconst combine = (native: NativeUIRuntimeHandle, fallback: NativeUIRuntimeHandle): NativeUIRuntimeHandle => ({\n  markForCheck() {\n    native.markForCheck();\n    fallback.markForCheck();\n  },\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: NativeUIRuntimeHandle,\n  lifecycle: {\n    reason?: string;\n    suspend?: () => (() => void) | undefined | Promise<(() => void) | undefined>;\n    /** Registers teardown before it starts so direct destroy and disable share the same queue. */\n    stopping?: (destruction: Promise<void>) => void;\n    destroy?: () => void | Promise<void>;\n  } = {},\n): NativeUIRuntimeHandle => {\n  let destruction: Promise<void> | undefined;\n  return {\n    markForCheck: () => {\n      if (!destruction) handle.markForCheck();\n    },\n    getStatus: () => (lifecycle.reason ? { ...handle.getStatus(), reason: lifecycle.reason } : handle.getStatus()),\n    async suspend() {\n      const lease = await handle.suspend();\n      const resume = await lifecycle.suspend?.();\n      return {\n        async resume() {\n          await lease.resume();\n          resume?.();\n        },\n      };\n    },\n    destroy() {\n      if (!destruction) {\n        destruction = Promise.resolve().then(async () => {\n          try {\n            await handle.destroy();\n          } finally {\n            await lifecycle.destroy?.();\n          }\n        });\n        lifecycle.stopping?.(destruction);\n      }\n      return destruction;\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 =\n    typeof document !== 'undefined' && Capacitor.getPlatform() === 'ios' && Capacitor.isPluginAvailable('NativeUI')\n      ? await bounded(plugin.getWebViewMetrics())\n      : { radius: 0 };\n  nativeWebViewMetrics.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\nconst webProjection = (doc: Document, options: NativeUIRuntimeOptions, enabled: () => boolean = () => true) => {\n  const ionic = () => createVerticalBarsWebProjection(doc, options, () => options.verticalBars?.enabled !== false && enabled());\n  if (options.source === 'html') return createHTMLWebProjection(doc, options);\n  if (options.source === 'auto') return combine(ionic(), createHTMLWebProjection(doc, options));\n  return ionic();\n};\n\n/** Call once at application startup. Ionic markup remains the source of truth. */\nexport const enableNativeUI = (options: NativeUIRuntimeOptions = {}, overlayFactory?: OverlayFactory): Promise<NativeUIRuntimeHandle> => {\n  if (typeof document === 'undefined') return Promise.resolve(web('Requires a document'));\n  const extensions = [...(options.extensions ?? [])];\n  const nativeState: NonNullable<NativeUIRuntimeOptions['nativeState']> = (options.nativeState = {});\n  try {\n    validateExtensions(extensions, document);\n  } catch (error) {\n    return Promise.reject(error);\n  }\n  const configuration = JSON.stringify([\n    options.source ?? 'ionic',\n    options.debug === true,\n    options.ionic?.auto !== false,\n    options.verticalBars?.enabled !== false,\n    options.verticalBars?.placement?.edge,\n    options.rail?.edge,\n    toolbarOptions(options, false),\n    toolbarOptions(options, true),\n    options.ionic?.verticalBars?.buttonProjection ?? 'system',\n    // Local source overrides can use this even when the startup projection is system.\n    options.ionic?.verticalBars?.buttonDefaultFill ?? 'glass',\n    ...(['tabs', 'segment', 'fab'] as const).flatMap((kind) => [controlDefault(options, kind, false), controlDefault(options, kind, true)]),\n    options.ionic?.verticalBars?.popover === true,\n  ]);\n  if (active && activeFailed) {\n    const previous = active;\n    stopActivation(\n      previous,\n      previous.then((handle) => handle.destroy()),\n    );\n  }\n  if (\n    active &&\n    (activeConfiguration !== configuration ||\n      activeRoot !== options.root ||\n      activeRailHost !== options.rail?.host ||\n      extensions.length !== activeExtensions.length ||\n      extensions.some((extension, index) => extension !== activeExtensions[index]))\n  )\n    return Promise.reject(\n      new Error('Native UI is already running with different controls or extensions; destroy it before changing configuration.'),\n    );\n  if (active) return active;\n  activeConfiguration = configuration;\n  activeRoot = options.root;\n  activeRailHost = options.rail?.host;\n  activeExtensions = extensions;\n  const previousStop = stopping;\n  let start: Promise<NativeUIRuntimeHandle>;\n  const stop = (destruction: Promise<void>) => stopActivation(start, destruction);\n  let releaseNative = async () => {};\n  let retired = false;\n  const pagehide = () => runtimeStopped('pagehide');\n  const runtimeStopped = (cause: 'failure' | 'pagehide') => {\n    if (cause === 'failure') {\n      // Keep the Web rail usable, but replace this degraded activation on the next enable.\n      if (active === start) activeFailed = true;\n      void start\n        .then(async () => {\n          if (!retired) document.defaultView?.addEventListener('pagehide', pagehide, { once: true });\n          await releaseNative();\n        })\n        .catch(() => {});\n      return;\n    }\n    const destruction = start.then((handle) => handle.destroy());\n    stop(destruction);\n    void destruction.catch(() => {});\n  };\n  return (start = active =\n    (async () => {\n      // Native controls and DOM ownership are shared. A replacement activation\n      // must wait until the old handle has finished clearing both surfaces.\n      if (previousStop) await previousStop.catch(() => {});\n      const platform = Capacitor.getPlatform();\n      const diagnose = createDiagnostics(options.debug);\n      const stopModals = options.source === 'html' ? () => {} : observeVerticalBarsModals(document);\n      const prehide =\n        platform !== 'android' && options.source !== 'html' && options.ionic?.auto !== false\n          ? prehideVerticalBarsToolbarSources(document, () => options.verticalBars?.enabled !== false, options.root, options)\n          : undefined;\n      const fallback = (reason: string) => {\n        diagnose(`web-fallback: ${reason}`);\n        return manage(webProjection(document, options), {\n          reason,\n          suspend: () => prehide?.suspend(),\n          destroy: () => {\n            retired = true;\n            document.defaultView?.removeEventListener('pagehide', pagehide);\n            prehide?.stop();\n            stopModals();\n          },\n          stopping: stop,\n        });\n      };\n      if (platform !== 'ios' && platform !== 'android') return fallback('Requires Capacitor iOS or Android');\n      if (!Capacitor.isPluginAvailable('NativeUI')) return fallback('Native UI plugin is not registered');\n      let runtime: NativeUIRuntimeHandle | undefined;\n      let overlays: OverlayController | undefined;\n      let metricsListener: Awaited<ReturnType<typeof plugin.addListener>> | undefined;\n      let nativeRelease: Promise<void> | undefined;\n      releaseNative = () =>\n        (nativeRelease ??= (async () => {\n          try {\n            await overlays?.destroy();\n          } finally {\n            if (metricsListener) await bounded(metricsListener.remove()).catch(() => {});\n          }\n        })());\n      const cleanup = async () => {\n        retired = true;\n        try {\n          await releaseNative();\n        } finally {\n          document.defaultView?.removeEventListener('pagehide', pagehide);\n          prehide?.stop();\n          stopModals();\n        }\n      };\n      try {\n        const ordinaryControls = (['button', 'backButton', 'tabs', 'segment', 'fab'] as const).some((kind) =>\n          controlDefault(options, kind, false),\n        );\n        const capabilities = await bounded(plugin.configure({ suppressScrollEdgeEffect: ordinaryControls }));\n        if (!capabilities.supported) return fallback('Native UI is unavailable on this device');\n        const unavailableExtensions = new Map<string, string>();\n        for (const extension of extensions) {\n          if (platform === 'android' && extension.placement === 'tab-accessory')\n            unavailableExtensions.set(extension.name, 'unsupported-placement: tab-accessory requires a supported iOS tab host.');\n          else if (!capabilities.extensions?.includes(extension.name))\n            unavailableExtensions.set(\n              extension.name,\n              'unregistered-extension: register this name in the native app before enabling the shell, then rebuild.',\n            );\n        }\n        if (platform === 'android') {\n          runtime = await createRuntime(\n            document,\n            plugin,\n            {\n              ...options,\n              source: 'extensions',\n              extensions,\n              unavailableExtensions,\n            },\n            () => false,\n            runtimeStopped,\n          );\n          runtime = combine(runtime, webProjection(document, options));\n          metricsListener = await boundedListener(\n            plugin.addListener('webViewMetricsChange', () => {\n              document.defaultView?.dispatchEvent(new Event('nativeUIRefresh'));\n            }),\n          );\n          return manage(runtime, {\n            stopping: stop,\n            destroy: cleanup,\n          });\n        }\n        let deviceEdge: VerticalBarEdge = null;\n        const ionicRoot = () => {\n          if (options.source === 'html') return null;\n          const root = options.root ?? document.body;\n          return root.closest<HTMLElement>('ion-app') ?? root.querySelector<HTMLElement>('ion-app');\n        };\n        const updateNativeEdge = () => {\n          const requested = options.verticalBars?.placement?.edge;\n          const root = ionicRoot() ?? options.root ?? document.body;\n          nativeState.edge =\n            deviceEdge && (!requested || requested === deviceEdge) ? physicalVerticalBarEdge(deviceEdge, elementRtl(root)) : undefined;\n        };\n        // Ionic layout is read-only input; device metrics determine native availability.\n        const nativeVerticalBars = () => {\n          updateNativeEdge();\n          if (options.verticalBars?.enabled === false) return false;\n          const app = ionicRoot();\n          if (!app?.classList.contains('ios-theme-vertical-bars')) return !!nativeState.edge;\n          const physicalEdge = app.classList.contains('ios-theme-vertical-bars-left') ? 'left' : 'right';\n          return physicalEdge === nativeState.edge;\n        };\n        const applyMetrics = (metrics: WebViewMetrics) => {\n          if (ordinaryControls) nativeWebViewMetrics.radius = metrics.radius;\n          deviceEdge = metrics.verticalBarEdge ?? null;\n          updateNativeEdge();\n          document.defaultView?.dispatchEvent(new Event('nativeUIRefresh'));\n        };\n        metricsListener = await boundedListener(plugin.addListener('webViewMetricsChange', applyMetrics));\n        await bounded(Promise.resolve().then(() => plugin.getWebViewMetrics()))\n          .then(applyMetrics)\n          .catch(() => undefined);\n        const native = await createRuntime(\n          document,\n          plugin,\n          { ...options, extensions, unavailableExtensions },\n          nativeVerticalBars,\n          runtimeStopped,\n        );\n        runtime = combine(\n          native,\n          webProjection(document, options, () => !nativeVerticalBars() || native.getStatus().projected === 0),\n        );\n        if (options.ionic?.verticalBars?.popover === true && overlayFactory)\n          overlays = await overlayFactory(document, plugin, options, native.retain, nativeVerticalBars);\n        return manage(runtime, {\n          suspend: async () => {\n            const restorePrehide = prehide?.suspend();\n            const resumeOverlays = await overlays?.suspend();\n            return () => {\n              restorePrehide?.();\n              resumeOverlays?.();\n            };\n          },\n          stopping: stop,\n          destroy: cleanup,\n        });\n      } catch (error) {\n        await overlays?.destroy().catch(() => {});\n        await runtime?.destroy().catch(() => {});\n        if (metricsListener) await bounded(metricsListener.remove()).catch(() => {});\n        return fallback(error instanceof Error ? error.message : String(error));\n      }\n    })());\n};\n"],"mappings":"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"}

package/dist/native/components/index.d.ts

@@ -0,0 +1,19 @@
+import { Candidate, Identify } from "../shared/candidate.js";
+import { VerticalControlAreaOptions } from "../definitions.js";
+import { ion_button_d_exports } from "./ion-button.js";
+import { ion_buttons_d_exports } from "./ion-buttons.js";
+import { ion_back_button_d_exports } from "./ion-back-button.js";
+import { ion_menu_button_d_exports } from "./ion-menu-button.js";
+import { ion_tab_bar_d_exports } from "./ion-tab-bar.js";
+import { ion_segment_d_exports } from "./ion-segment.js";
+import { ion_fab_d_exports } from "./ion-fab.js";
+//#region src/native/components/index.d.ts
+export declare const components: readonly [typeof ion_button_d_exports, typeof ion_buttons_d_exports, typeof ion_back_button_d_exports, typeof ion_menu_button_d_exports, typeof ion_tab_bar_d_exports, typeof ion_segment_d_exports, typeof ion_fab_d_exports];
+export type NativeUIComponent = (typeof components)[number]['tag'];
+export declare const selector: string;
+export declare const shadowSelector: string;
+export declare const motionSelector: string;
+export declare const isVerticalBarsCandidate: (element: HTMLElement) => boolean;
+export declare const readCandidate: (element: HTMLElement, id: Identify, options?: VerticalControlAreaOptions) => Candidate | undefined;
+//#endregion
+//# sourceMappingURL=index.d.ts.map

package/dist/native/components/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":["button","buttons","backButton","menuButton","tabBar","segment","fab"],"sources":["../../../src/native/components/index.ts"],"mappings":";;;;;;;;;;qBAYa,6BAAUA,6BAAAC,8BAAAC,kCAAAC,kCAAAC,8BAAAC,8BAAAC;YACX,4BAA4B;qBAC3B;qBAIA;qBAIA;qBAQA,0BAAuB,SAAA;qBAEvB,gBAAiB,SAAS,aAAa,IAAI,UAAU,UAAS,+BAAkC"}

package/dist/native/components/index.js

@@ -0,0 +1,38 @@
+import { isVerticalBarsSource, visible, withoutPrehide } from "../shared/dom.js";
+import { ion_button_exports } from "./ion-button.js";
+import { ion_menu_button_exports } from "./ion-menu-button.js";
+import { ion_buttons_exports } from "./ion-buttons.js";
+import { ion_back_button_exports } from "./ion-back-button.js";
+import { ion_tab_bar_exports } from "./ion-tab-bar.js";
+import { ion_segment_exports } from "./ion-segment.js";
+import { ion_fab_exports } from "./ion-fab.js";
+//#region src/native/components/index.ts
+const components = [
+	ion_button_exports,
+	ion_buttons_exports,
+	ion_back_button_exports,
+	ion_menu_button_exports,
+	ion_tab_bar_exports,
+	ion_segment_exports,
+	ion_fab_exports
+];
+const selector = components.map((component) => "selector" in component ? component.selector : component.tag).filter(Boolean).join(", ");
+const shadowSelector = ["ion-icon", ...components.flatMap((component) => "shadowSelector" in component ? [component.shadowSelector] : [])].join(", ");
+const motionSelector = [
+	".ion-page",
+	"ion-header",
+	"ion-footer",
+	"ion-toolbar",
+	...components.filter((component) => "tracksMotion" in component && component.tracksMotion).map((component) => component.tag)
+].join(", ");
+const isVerticalBarsCandidate = isVerticalBarsSource;
+const readCandidate = (element, id, options = {}) => {
+	const verticalBars = isVerticalBarsCandidate(element);
+	if (!element.classList.contains("ios") && !verticalBars || !visible(element, verticalBars) || element.closest("ion-popover") || element.closest("ion-modal") && !verticalBars) return;
+	if (element.contains(element.ownerDocument.activeElement)) return;
+	return withoutPrehide(element, () => components.find((component) => component.tag === element.localName)?.read(element, id, options));
+};
+//#endregion
+export { components, isVerticalBarsCandidate, motionSelector, readCandidate, selector, shadowSelector };
+
+//# sourceMappingURL=index.js.map

package/dist/native/components/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["button","buttons","backButton","menuButton","tabBar","segment","fab"],"sources":["../../../src/native/components/index.ts"],"sourcesContent":["import type { VerticalControlAreaOptions } from '../definitions';\nimport * as button from './ion-button';\nimport * as buttons from './ion-buttons';\nimport * as backButton from './ion-back-button';\nimport * as menuButton from './ion-menu-button';\nimport * as tabBar from './ion-tab-bar';\nimport * as segment from './ion-segment';\nimport * as fab from './ion-fab';\nimport { isVerticalBarsSource, visible, withoutPrehide } from '../shared/dom';\nimport type { Candidate, Identify } from '../shared/candidate';\n\n// Static composition only. Each component declares its own tag, discovery and reader.\nexport const components = [button, buttons, backButton, menuButton, tabBar, segment, fab] as const;\nexport type NativeUIComponent = (typeof components)[number]['tag'];\nexport const selector = components\n  .map((component) => ('selector' in component ? component.selector : component.tag))\n  .filter(Boolean)\n  .join(', ');\nexport const shadowSelector = [\n  'ion-icon',\n  ...components.flatMap((component) => ('shadowSelector' in component ? [component.shadowSelector] : [])),\n].join(', ');\nexport const motionSelector = [\n  '.ion-page',\n  'ion-header',\n  'ion-footer',\n  'ion-toolbar',\n  ...components.filter((component) => 'tracksMotion' in component && component.tracksMotion).map((component) => component.tag),\n].join(', ');\n\nexport const isVerticalBarsCandidate = isVerticalBarsSource;\n\nexport const readCandidate = (element: HTMLElement, id: Identify, options: VerticalControlAreaOptions = {}): Candidate | undefined => {\n  const verticalBars = isVerticalBarsCandidate(element);\n  if (\n    (!element.classList.contains('ios') && !verticalBars) ||\n    !visible(element, verticalBars) ||\n    element.closest('ion-popover') ||\n    (element.closest('ion-modal') && !verticalBars)\n  )\n    return;\n  if (element.contains(element.ownerDocument.activeElement)) return;\n  // Read icon and control geometry before restoring prehide, which can collapse the toolbar.\n  return withoutPrehide(element, () => components.find((component) => component.tag === element.localName)?.read(element, id, options));\n};\n"],"mappings":";;;;;;;;;AAYA,MAAa,aAAa;CAACA;CAAQC;CAASC;CAAYC;CAAYC;CAAQC;CAASC;AAAG;AAExF,MAAa,WAAW,WACrB,KAAK,cAAe,cAAc,YAAY,UAAU,WAAW,UAAU,GAAI,CAAC,CAClF,OAAO,OAAO,CAAC,CACf,KAAK,IAAI;AACZ,MAAa,iBAAiB,CAC5B,YACA,GAAG,WAAW,SAAS,cAAe,oBAAoB,YAAY,CAAC,UAAU,cAAc,IAAI,CAAC,CAAE,CACxG,CAAC,CAAC,KAAK,IAAI;AACX,MAAa,iBAAiB;CAC5B;CACA;CACA;CACA;CACA,GAAG,WAAW,QAAQ,cAAc,kBAAkB,aAAa,UAAU,YAAY,CAAC,CAAC,KAAK,cAAc,UAAU,GAAG;AAC7H,CAAC,CAAC,KAAK,IAAI;AAEX,MAAa,0BAA0B;AAEvC,MAAa,iBAAiB,SAAsB,IAAc,UAAsC,CAAC,MAA6B;CACpI,MAAM,eAAe,wBAAwB,OAAO;CACpD,IACG,CAAC,QAAQ,UAAU,SAAS,KAAK,KAAK,CAAC,gBACxC,CAAC,QAAQ,SAAS,YAAY,KAC9B,QAAQ,QAAQ,aAAa,KAC5B,QAAQ,QAAQ,WAAW,KAAK,CAAC,cAElC;CACF,IAAI,QAAQ,SAAS,QAAQ,cAAc,aAAa,GAAG;CAE3D,OAAO,eAAe,eAAe,WAAW,MAAM,cAAc,UAAU,QAAQ,QAAQ,SAAS,CAAC,EAAE,KAAK,SAAS,IAAI,OAAO,CAAC;AACtI"}

package/dist/native/components/ion-back-button.d.ts

@@ -0,0 +1,10 @@
+import { Candidate, Identify } from "../shared/candidate.js";
+import { VerticalControlAreaOptions } from "../definitions.js";
+declare namespace ion_back_button_d_exports {
+  export { read, tag };
+}
+export declare const tag = "ion-back-button";
+export declare const read: (element: HTMLElement, id: Identify, options?: VerticalControlAreaOptions) => Candidate | undefined;
+//#endregion
+export { ion_back_button_d_exports };
+//# sourceMappingURL=ion-back-button.d.ts.map

package/dist/native/components/ion-back-button.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ion-back-button.d.ts","names":[],"sources":["../../../src/native/components/ion-back-button.ts"],"mappings":";;;;;qBAMa;qBAEA,OAAQ,SAAS,aAAa,IAAI,UAAU,UAAS,+BAAkC"}

package/dist/native/components/ion-back-button.js

@@ -0,0 +1,21 @@
+import { __exportAll } from "../../_virtual/_rolldown/runtime.js";
+import { inFixedToolbar, isVerticalBarsSource } from "../shared/dom.js";
+import { horizontalSelected, inVerticalToolbarLayout } from "../shared/toolbar-options.js";
+import { appendItem, createCandidate } from "../shared/candidate.js";
+//#region src/native/components/ion-back-button.ts
+var ion_back_button_exports = /* @__PURE__ */ __exportAll({
+	read: () => read,
+	tag: () => tag
+});
+const tag = "ion-back-button";
+const read = (element, id, options = {}) => {
+	const button = element;
+	if ((inVerticalToolbarLayout(element) ? !isVerticalBarsSource(element) : !horizontalSelected(element, options)) || !button.shadowRoot || button.icon !== void 0 || button.color !== void 0 || !isVerticalBarsSource(element) && !inFixedToolbar(element)) return;
+	const candidate = createCandidate(element, tag, id);
+	const label = button.shadowRoot.querySelector("[part=\"text\"]")?.textContent?.trim() ?? "";
+	return appendItem(candidate, element, id, button.shadowRoot, label) ? candidate : void 0;
+};
+//#endregion
+export { ion_back_button_exports, read, tag };
+
+//# sourceMappingURL=ion-back-button.js.map

package/dist/native/components/ion-back-button.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ion-back-button.js","names":[],"sources":["../../../src/native/components/ion-back-button.ts"],"sourcesContent":["import type { VerticalControlAreaOptions } from '../definitions';\nimport { horizontalSelected, inVerticalToolbarLayout } from '../shared/toolbar-options';\nimport { createCandidate, appendItem } from '../shared/candidate';\nimport type { Candidate, Identify } from '../shared/candidate';\nimport { inFixedToolbar, isVerticalBarsSource } from '../shared/dom';\n\nexport const tag = 'ion-back-button';\n\nexport const read = (element: HTMLElement, id: Identify, options: VerticalControlAreaOptions = {}): Candidate | undefined => {\n  const button = element as HTMLIonBackButtonElement;\n  if (\n    (inVerticalToolbarLayout(element) ? !isVerticalBarsSource(element) : !horizontalSelected(element, options)) ||\n    !button.shadowRoot ||\n    button.icon !== undefined ||\n    button.color !== undefined ||\n    (!isVerticalBarsSource(element) && !inFixedToolbar(element))\n  )\n    return;\n  const candidate = createCandidate(element, tag, id);\n  const label = button.shadowRoot.querySelector('[part=\"text\"]')?.textContent?.trim() ?? '';\n  return appendItem(candidate, element, id, button.shadowRoot, label) ? candidate : undefined;\n};\n"],"mappings":";;;;;;;;;AAMA,MAAa,MAAM;AAEnB,MAAa,QAAQ,SAAsB,IAAc,UAAsC,CAAC,MAA6B;CAC3H,MAAM,SAAS;CACf,KACG,wBAAwB,OAAO,IAAI,CAAC,qBAAqB,OAAO,IAAI,CAAC,mBAAmB,SAAS,OAAO,MACzG,CAAC,OAAO,cACR,OAAO,SAAS,KAAA,KAChB,OAAO,UAAU,KAAA,KAChB,CAAC,qBAAqB,OAAO,KAAK,CAAC,eAAe,OAAO,GAE1D;CACF,MAAM,YAAY,gBAAgB,SAAS,KAAK,EAAE;CAClD,MAAM,QAAQ,OAAO,WAAW,cAAc,iBAAe,CAAC,EAAE,aAAa,KAAK,KAAK;CACvF,OAAO,WAAW,WAAW,SAAS,IAAI,OAAO,YAAY,KAAK,IAAI,YAAY,KAAA;AACpF"}

package/dist/native/components/ion-button.d.ts

@@ -0,0 +1,10 @@
+import { Candidate, Identify } from "../shared/candidate.js";
+import { VerticalControlAreaOptions } from "../definitions.js";
+declare namespace ion_button_d_exports {
+  export { read, tag };
+}
+export declare const tag = "ion-button";
+export declare const read: (element: HTMLElement, id: Identify, options?: VerticalControlAreaOptions) => Candidate | undefined;
+//#endregion
+export { ion_button_d_exports };
+//# sourceMappingURL=ion-button.d.ts.map

package/dist/native/components/ion-button.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ion-button.d.ts","names":[],"sources":["../../../src/native/components/ion-button.ts"],"mappings":";;;;;qBAMa;qBAEA,OAAQ,SAAS,aAAa,IAAI,UAAU,UAAS,+BAAkC"}

package/dist/native/components/ion-button.js

@@ -0,0 +1,25 @@
+import { __exportAll } from "../../_virtual/_rolldown/runtime.js";
+import { inFixedToolbar, isVerticalBarsToolbarAction, isVerticalBarsToolbarGroup } from "../shared/dom.js";
+import { horizontalSelected, horizontalToolbarGroup, inVerticalToolbarLayout } from "../shared/toolbar-options.js";
+import { appendItem, createCandidate } from "../shared/candidate.js";
+//#region src/native/components/ion-button.ts
+var ion_button_exports = /* @__PURE__ */ __exportAll({
+	read: () => read,
+	tag: () => tag
+});
+const tag = "ion-button";
+const read = (element, id, options = {}) => {
+	const button = element;
+	const verticalBars = inVerticalToolbarLayout(element);
+	if (verticalBars && element.parentElement && isVerticalBarsToolbarGroup(element.parentElement)) return;
+	const fill = button.fill ?? "default";
+	const group = element.parentElement?.matches("ion-buttons") ? element.parentElement : void 0;
+	if (!verticalBars && (!horizontalSelected(element, options) || group && horizontalToolbarGroup(group, options))) return;
+	if (!inFixedToolbar(element) || verticalBars && !isVerticalBarsToolbarAction(element) || !verticalBars && fill !== "default" && !(group && fill === "clear") || !verticalBars && button.classList.contains("ion-color")) return;
+	const candidate = createCandidate(element, tag, id, options);
+	return appendItem(candidate, element, id) ? candidate : void 0;
+};
+//#endregion
+export { ion_button_exports, read, tag };
+
+//# sourceMappingURL=ion-button.js.map

package/dist/native/components/ion-button.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ion-button.js","names":[],"sources":["../../../src/native/components/ion-button.ts"],"sourcesContent":["import { horizontalSelected, horizontalToolbarGroup, inVerticalToolbarLayout } from '../shared/toolbar-options';\nimport type { VerticalControlAreaOptions } from '../definitions';\nimport { createCandidate, appendItem } from '../shared/candidate';\nimport type { Candidate, Identify } from '../shared/candidate';\nimport { inFixedToolbar, isVerticalBarsToolbarAction, isVerticalBarsToolbarGroup } from '../shared/dom';\n\nexport const tag = 'ion-button';\n\nexport const read = (element: HTMLElement, id: Identify, options: VerticalControlAreaOptions = {}): Candidate | undefined => {\n  const button = element as HTMLIonButtonElement;\n  const verticalBars = inVerticalToolbarLayout(element);\n  if (verticalBars && element.parentElement && isVerticalBarsToolbarGroup(element.parentElement)) return;\n  const fill = button.fill ?? 'default';\n  const group = element.parentElement?.matches('ion-buttons') ? element.parentElement : undefined;\n  if (!verticalBars && (!horizontalSelected(element, options) || (group && horizontalToolbarGroup(group, options)))) return;\n  if (\n    !inFixedToolbar(element) ||\n    (verticalBars && !isVerticalBarsToolbarAction(element)) ||\n    (!verticalBars && fill !== 'default' && !(group && fill === 'clear')) ||\n    (!verticalBars && button.classList.contains('ion-color'))\n  )\n    return;\n  const candidate = createCandidate(element, tag, id, options);\n  return appendItem(candidate, element, id) ? candidate : undefined;\n};\n"],"mappings":";;;;;;;;;AAMA,MAAa,MAAM;AAEnB,MAAa,QAAQ,SAAsB,IAAc,UAAsC,CAAC,MAA6B;CAC3H,MAAM,SAAS;CACf,MAAM,eAAe,wBAAwB,OAAO;CACpD,IAAI,gBAAgB,QAAQ,iBAAiB,2BAA2B,QAAQ,aAAa,GAAG;CAChG,MAAM,OAAO,OAAO,QAAQ;CAC5B,MAAM,QAAQ,QAAQ,eAAe,QAAQ,aAAa,IAAI,QAAQ,gBAAgB,KAAA;CACtF,IAAI,CAAC,iBAAiB,CAAC,mBAAmB,SAAS,OAAO,KAAM,SAAS,uBAAuB,OAAO,OAAO,IAAK;CACnH,IACE,CAAC,eAAe,OAAO,KACtB,gBAAgB,CAAC,4BAA4B,OAAO,KACpD,CAAC,gBAAgB,SAAS,aAAa,EAAE,SAAS,SAAS,YAC3D,CAAC,gBAAgB,OAAO,UAAU,SAAS,WAAW,GAEvD;CACF,MAAM,YAAY,gBAAgB,SAAS,KAAK,IAAI,OAAO;CAC3D,OAAO,WAAW,WAAW,SAAS,EAAE,IAAI,YAAY,KAAA;AAC1D"}

package/dist/native/components/ion-buttons.d.ts

@@ -0,0 +1,11 @@
+import { Candidate, Identify } from "../shared/candidate.js";
+import { VerticalControlAreaOptions } from "../definitions.js";
+declare namespace ion_buttons_d_exports {
+  export { read, tag, tracksMotion };
+}
+export declare const tag = "ion-buttons";
+export declare const tracksMotion = true;
+export declare const read: (element: HTMLElement, id: Identify, options?: VerticalControlAreaOptions) => Candidate | undefined;
+//#endregion
+export { ion_buttons_d_exports };
+//# sourceMappingURL=ion-buttons.d.ts.map

package/dist/native/components/ion-buttons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ion-buttons.d.ts","names":[],"sources":["../../../src/native/components/ion-buttons.ts"],"mappings":";;;;;qBAOa;qBACA;qBAEA,OAAQ,SAAS,aAAa,IAAI,UAAU,UAAS,+BAAkC"}

package/dist/native/components/ion-buttons.js

@@ -0,0 +1,30 @@
+import { __exportAll } from "../../_virtual/_rolldown/runtime.js";
+import { childElements, inFixedToolbar, isVerticalBarsToolbarGroup, verticalBarsToolbarActions } from "../shared/dom.js";
+import { horizontalToolbarGroup, inVerticalToolbarLayout } from "../shared/toolbar-options.js";
+import { appendItem, createCandidate } from "../shared/candidate.js";
+import { append, read as read$1 } from "./ion-menu-button.js";
+//#region src/native/components/ion-buttons.ts
+var ion_buttons_exports = /* @__PURE__ */ __exportAll({
+	read: () => read,
+	tag: () => tag,
+	tracksMotion: () => true
+});
+const tag = "ion-buttons";
+const tracksMotion = true;
+const read = (element, id, options = {}) => {
+	if (!inFixedToolbar(element)) return;
+	let children = childElements(element);
+	const verticalBars = inVerticalToolbarLayout(element);
+	if (verticalBars ? !isVerticalBarsToolbarGroup(element) : !horizontalToolbarGroup(element, options)) return;
+	if (children.length === 1) return read$1(element, id, options);
+	if (verticalBars) children = verticalBarsToolbarActions(element);
+	if (!children.length || children.some((child) => !child.matches(`ion-menu-button${verticalBars ? "" : ".ios"}`) && (!child.matches(`ion-button${verticalBars ? "" : ".ios.button-clear"}`) || !verticalBars && child.fill !== "clear"))) return;
+	const candidate = createCandidate(element, tag, id, options);
+	if (verticalBars && children.length !== childElements(element).length) candidate.sources = children;
+	for (const child of children) if (!(child.matches("ion-menu-button") ? append(candidate, child, id) : appendItem(candidate, child, id))) return;
+	return candidate;
+};
+//#endregion
+export { ion_buttons_exports, read, tag, tracksMotion };
+
+//# sourceMappingURL=ion-buttons.js.map

package/dist/native/components/ion-buttons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ion-buttons.js","names":["menuButton.read","menuButton.append"],"sources":["../../../src/native/components/ion-buttons.ts"],"sourcesContent":["import { horizontalToolbarGroup, inVerticalToolbarLayout } from '../shared/toolbar-options';\nimport type { VerticalControlAreaOptions } from '../definitions';\nimport { createCandidate, appendItem } from '../shared/candidate';\nimport type { Candidate, Identify } from '../shared/candidate';\nimport { childElements, verticalBarsToolbarActions, inFixedToolbar, isVerticalBarsToolbarGroup } from '../shared/dom';\nimport * as menuButton from './ion-menu-button';\n\nexport const tag = 'ion-buttons';\nexport const tracksMotion = true;\n\nexport const read = (element: HTMLElement, id: Identify, options: VerticalControlAreaOptions = {}): Candidate | undefined => {\n  if (!inFixedToolbar(element)) return;\n  let children = childElements(element);\n  const verticalBars = inVerticalToolbarLayout(element);\n  if (verticalBars ? !isVerticalBarsToolbarGroup(element) : !horizontalToolbarGroup(element, options)) return;\n  if (children.length === 1) return menuButton.read(element, id, options);\n  if (verticalBars) children = verticalBarsToolbarActions(element);\n  if (\n    !children.length ||\n    children.some(\n      (child) =>\n        !child.matches(`${menuButton.tag}${verticalBars ? '' : '.ios'}`) &&\n        (!child.matches(`ion-button${verticalBars ? '' : '.ios.button-clear'}`) ||\n          (!verticalBars && (child as HTMLIonButtonElement).fill !== 'clear')),\n    )\n  )\n    return;\n  const candidate = createCandidate(element, tag, id, options);\n  if (verticalBars && children.length !== childElements(element).length) candidate.sources = children;\n  for (const child of children) {\n    const supported = child.matches(menuButton.tag)\n      ? menuButton.append(candidate, child as HTMLIonMenuButtonElement, id)\n      : appendItem(candidate, child, id);\n    if (!supported) return;\n  }\n  return candidate;\n};\n"],"mappings":";;;;;;;;;;;AAOA,MAAa,MAAM;AACnB,MAAa,eAAe;AAE5B,MAAa,QAAQ,SAAsB,IAAc,UAAsC,CAAC,MAA6B;CAC3H,IAAI,CAAC,eAAe,OAAO,GAAG;CAC9B,IAAI,WAAW,cAAc,OAAO;CACpC,MAAM,eAAe,wBAAwB,OAAO;CACpD,IAAI,eAAe,CAAC,2BAA2B,OAAO,IAAI,CAAC,uBAAuB,SAAS,OAAO,GAAG;CACrG,IAAI,SAAS,WAAW,GAAG,OAAOA,OAAgB,SAAS,IAAI,OAAO;CACtE,IAAI,cAAc,WAAW,2BAA2B,OAAO;CAC/D,IACE,CAAC,SAAS,UACV,SAAS,MACN,UACC,CAAC,MAAM,QAAQ,kBAAoB,eAAe,KAAK,QAAQ,MAC9D,CAAC,MAAM,QAAQ,aAAa,eAAe,KAAK,qBAAqB,KACnE,CAAC,gBAAiB,MAA+B,SAAS,QACjE,GAEA;CACF,MAAM,YAAY,gBAAgB,SAAS,KAAK,IAAI,OAAO;CAC3D,IAAI,gBAAgB,SAAS,WAAW,cAAc,OAAO,CAAC,CAAC,QAAQ,UAAU,UAAU;CAC3F,KAAK,MAAM,SAAS,UAIlB,IAAI,EAHc,MAAM,QAAQ,iBAAc,IAC1CC,OAAkB,WAAW,OAAmC,EAAE,IAClE,WAAW,WAAW,OAAO,EAAE,IACnB;CAElB,OAAO;AACT"}

package/dist/native/components/ion-fab.d.ts

@@ -0,0 +1,10 @@
+import { Candidate } from "../shared/candidate.js";
+declare namespace ion_fab_d_exports {
+  export { read, shadowSelector, tag };
+}
+export declare const tag = "ion-fab";
+export declare const shadowSelector = "ion-fab-button, ion-fab-list";
+export declare const read: (fab: HTMLElement, id: (element: HTMLElement) => string) => Candidate | undefined;
+//#endregion
+export { ion_fab_d_exports };
+//# sourceMappingURL=ion-fab.d.ts.map

package/dist/native/components/ion-fab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ion-fab.d.ts","names":[],"sources":["../../../src/native/components/ion-fab.ts"],"mappings":";;;;qBAKa;qBACA;qBAOA,OAAQ,KAAK,aAAa,KAAK,SAAS,2BAAyB"}