@rdlabo/capacitor-native-ui 0.0.0-stage → 1.2.1

package/dist/native/definitions.d.ts

@@ -0,0 +1,255 @@
+import { NativeUIExtension } from "./extensions.js";
+import { PluginListenerHandle } from "@capacitor/core";
+//#region src/native/definitions.d.ts
+export type NativeUIComponent = 'ion-button' | 'ion-buttons' | 'ion-back-button' | 'ion-menu-button' | 'ion-tab-bar' | 'ion-segment' | 'ion-fab';
+export interface NativeUIStatus {
+  state: 'web' | 'native' | 'stopped';
+  projected: number;
+  updates: number;
+  reason?: string;
+}
+export interface ToolbarProjectionOptions {
+  buttons?: boolean;
+  button?: boolean;
+  backButton?: boolean;
+}
+export interface VerticalControlAreaOptions {
+  extensions?: readonly NativeUIExtension[];
+  controls?: Pick<NativeUIControls, 'popover'>;
+  horizontal?: boolean | ToolbarProjectionOptions;
+  vertical?: boolean | ToolbarProjectionOptions;
+  buttonProjection?: 'source' | 'system';
+  buttonDefaultFill?: 'solid' | null;
+}
+export interface NativeUIOptions extends VerticalControlAreaOptions {
+  debug?: boolean;
+  verticalBars?: NativeUIVerticalBarsOptions;
+  ionic?: IonicProjectionOptions;
+  root?: HTMLElement;
+  enabled?: boolean;
+  controls?: NativeUIControls;
+  verticalBarsOnly?: boolean;
+}
+export interface NativeUIRuntimeOptions extends NativeUIOptions {
+  source?: 'ionic' | 'html' | 'auto' | 'extensions';
+  explicitControls?: boolean;
+  nativeState?: {
+    edge?: 'left' | 'right';
+  };
+  unavailableExtensions?: ReadonlyMap<string, string>;
+  rail?: {
+    host: HTMLElement;
+    edge: 'left' | 'right';
+  };
+}
+export interface IonicProjectionOptions {
+  auto?: boolean | AutoIonicControls;
+}
+export interface AutoIonicControls {
+  buttons?: boolean;
+  tabs?: boolean;
+  segment?: boolean;
+  fab?: boolean;
+}
+export interface NativeUIControls {
+  buttons?: boolean;
+  tabs?: boolean;
+  toolbar?: boolean;
+  segment?: boolean;
+  fab?: boolean;
+  popover?: boolean;
+}
+export interface NativeUIHandle extends NativeUIRuntimeHandle {
+  enableVerticalControlArea(): Promise<void>;
+  disableVerticalControlArea(): Promise<void>;
+}
+export interface NativeUIVerticalBarsOptions {
+  enabled?: boolean;
+  only?: boolean;
+  buttonProjection?: 'system' | 'source';
+  buttonDefaultFill?: 'glass' | 'solid';
+  popover?: boolean;
+  placement?: {
+    edge: Exclude<VerticalBarEdge, null>;
+    webHost?: HTMLElement;
+  };
+}
+export interface NativeUIRuntimeHandle {
+  markForCheck(): void;
+  getStatus(): NativeUIStatus;
+  suspend(): Promise<NativeUISuspension>;
+  destroy(): Promise<void>;
+}
+export type VerticalBarEdge = 'leading' | 'trailing' | null;
+export interface VerticalBarPlacement {
+  edge: VerticalBarEdge;
+  inset?: number;
+  nativeEdge?: VerticalBarEdge;
+}
+export interface VerticalControlAreaHandle extends NativeUIHandle {
+  setPlacement(placement: VerticalBarEdge | VerticalBarPlacement, rtl?: boolean): void;
+}
+export interface NativeUISuspension {
+  resume(): Promise<void>;
+}
+export interface Frame {
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+}
+export interface NativeUIBadge {
+  value: string;
+  color: string;
+  textColor: string;
+}
+export interface NativeUIItem extends Frame {
+  id: string;
+  label: string;
+  accessibilityLabel: string;
+  disabled: boolean;
+  selected: boolean;
+  fontSize: number;
+  fontWeight: number;
+  color: string;
+  buttonFill?: 'clear' | 'solid' | 'outline';
+  backgroundColor?: string;
+  borderColor?: string;
+  borderWidth?: number;
+  badge?: NativeUIBadge;
+  icon?: string;
+  iconWidth?: number;
+  iconHeight?: number;
+  iconPosition?: 'leading' | 'trailing' | 'top';
+  imagePadding?: number;
+  contentInsetLeading?: number;
+  contentInsetTrailing?: number;
+  iconTemplate?: boolean;
+  visible?: boolean;
+  closeIcon?: string;
+  closeIconWidth?: number;
+  closeIconHeight?: number;
+  iconTransition?: number;
+}
+export type NativeUIControlKind = 'button' | 'button-group' | 'back-button' | 'menu-button' | 'tab-bar' | 'segment' | 'floating-action-button';
+export interface NativeUIControl extends Frame {
+  id: string;
+  kind: NativeUIControlKind | 'extension';
+  extension?: {
+    name: string;
+    props: string;
+    actions: Record<string, string>;
+    tabBarId?: string;
+  };
+  placement?: 'vertical-bars';
+  toolbarSlot?: 'start' | 'end';
+  items: NativeUIItem[];
+  dark: boolean;
+  rtl: boolean;
+  tabBarAnchor?: {
+    x: 0 | 0.5 | 1;
+    y: 0 | 1;
+  };
+  search?: NativeUISearch;
+}
+export interface NativeUISearch {
+  id: string;
+  field: NativeUIItem;
+  trigger: NativeUIItem;
+  closeId: string;
+  active: boolean;
+  available: boolean;
+  focused: boolean;
+  value: string;
+  placeholder: string;
+  disabled: boolean;
+  editSequence: number;
+  valueVersion: number;
+}
+export interface NativeUISearchEvent extends NativeUIActivation {
+  valueVersion: number;
+  phase: 'input' | 'focus' | 'blur' | 'clear' | 'commit';
+  value: string;
+  composing: boolean;
+}
+export interface NativeUISnapshot {
+  revision: number;
+  transitionDuration?: number;
+  viewportWidth: number;
+  verticalBarEdge?: 'left' | 'right';
+  verticalBarFrame?: Frame;
+  controls: NativeUIControl[];
+}
+export interface NativeUIActivation {
+  revision: number;
+  id: string;
+  sequence: number;
+  requestId?: string;
+}
+export interface WebViewMetrics {
+  radius: number;
+  verticalBarEdge?: VerticalBarEdge;
+}
+export interface NativeUIPlugin {
+  configure(options?: {
+    verticalBarsOnly?: boolean;
+  }): Promise<{
+    supported: boolean;
+    extensions?: string[];
+  }>;
+  completeExtensionAction(options: {
+    requestId: string;
+    accepted: boolean;
+  }): Promise<void>;
+  getWebViewMetrics(): Promise<WebViewMetrics>;
+  getVerticalBarsGeometry(options: {
+    viewportWidth: number;
+    ids: string[];
+  }): Promise<{
+    revision?: number;
+    items: Record<string, Frame>;
+  }>;
+  prepareOverlay(options: {
+    id: string;
+  }): Promise<void>;
+  presentOverlay(options: {
+    id: string;
+    presentation?: NativeUIPopoverPresentation;
+  }): Promise<void>;
+  dismissOverlay(options: {
+    id: string;
+    animated: boolean;
+  }): Promise<void>;
+  closeOverlay(options: {
+    id: string;
+  }): Promise<void>;
+  stopOverlays(): Promise<void>;
+  update(snapshot: NativeUISnapshot): Promise<{
+    revision: number;
+    rejectedSearches?: string[];
+    rejectedControls?: string[];
+  }>;
+  clear(options: {
+    revision: number;
+  }): Promise<void>;
+  addListener(name: 'activate', listener: (event: NativeUIActivation) => void): Promise<PluginListenerHandle>;
+  addListener(name: 'search', listener: (event: NativeUISearchEvent) => void): Promise<PluginListenerHandle>;
+  addListener(name: 'webViewMetricsChange', listener: (event: WebViewMetrics) => void): Promise<PluginListenerHandle>;
+  addListener(name: 'overlay', listener: (event: NativeUIOverlayEvent) => void): Promise<PluginListenerHandle>;
+}
+export interface NativeUIPopoverPresentation {
+  kind: 'popover';
+  animated: boolean;
+  dark: boolean;
+  anchorId: string;
+  width: number;
+  height: number;
+  backgroundColor: string;
+  backdropDismiss: boolean;
+}
+export interface NativeUIOverlayEvent {
+  id: string;
+  action: 'dismiss';
+}
+//#endregion
+//# sourceMappingURL=definitions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.d.ts","names":[],"sources":["../../src/native/definitions.ts"],"mappings":";;;YAGY;iBASK;EACf;EACA;EACA;EACA;;iBAGe;EAEf;EAEA;EAEA;;iBAGe;EAIf,sBAAsB;EAEtB,WAAW,KAAK;EAKhB,uBAAuB;EAKvB,qBAAqB;EASrB;EAOA;;iBAGe,wBAAwB;EAEvC;EACA,eAAe;EAEf,QAAQ;EAER,OAAO;EAEP;EAEA,WAAW;EAEX;;iBAIe,+BAA+B;EAC9C;EAEA;EACA;IAAgB;;EAEhB,wBAAwB;EACxB;IAAS,MAAM;IAAa;;;iBAGb;EAEf,iBAAiB;;iBAGF;EACf;EACA;EACA;EACA;;iBAGe;EAEf;EAEA;EAEA;EAEA;EAEA;EAEA;;iBAIe,uBAAuB;EAEtC,6BAA6B;EAE7B,8BAA8B;;iBAGf;EAEf;EAEA;EACA;EAEA;EAEA;EAEA;IAAc,MAAM,QAAQ;IAAwB,UAAU;;;iBAG/C;EAEf;EAEA,aAAa;EAEb,WAAW,QAAQ;EAEnB,WAAW;;YAID;iBAEK;EACf,MAAM;EAEN;EAIA,aAAa;;iBAGE,kCAAkC;EAIjD,aAAa,WAAW,kBAAkB,sBAAsB;;iBAGjD;EAEf,UAAU;;iBAGK;EACf;EACA;EACA;EACA;;iBAGe;EACf;EACA;EACA;;iBAGe,qBAAqB;EACpC;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EAEA;EACA;EACA;EACA;EACA,QAAQ;EACR;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;YAIU;iBASK,wBAAwB;EACvC;EACA,MAAM;EACN;IAAc;IAAc;IAAe,SAAS;IAAwB;;EAE5E;EAEA;EACA,OAAO;EACP;EACA;EACA;IAAiB;IAAgB;;EACjC,SAAS;;iBAGM;EACf;EACA,OAAO;EACP,SAAS;EACT;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;iBAGe,4BAA4B;EAC3C;EACA;EACA;EACA;;iBAGe;EACf;EACA;EACA;EAEA;EAEA,mBAAmB;EACnB,UAAU;;iBAGK;EACf;EACA;EACA;EAEA;;iBAGe;EAEf;EAEA,kBAAkB;;iBAGH;EACf,UAAU;IAAY;MAA+B;IAAU;IAAoB;;EACnF,wBAAwB;IAAW;IAAmB;MAAsB;EAC5E,qBAAqB,QAAQ;EAC7B,wBAAwB;IAAW;IAAuB;MAAkB;IAAU;IAAmB,OAAO,eAAe;;EAC/H,eAAe;IAAW;MAAe;EACzC,eAAe;IAAW;IAAY,eAAe;MAAgC;EACrF,eAAe;IAAW;IAAY;MAAsB;EAC5D,aAAa;IAAW;MAAe;EACvC,gBAAgB;EAChB,OAAO,UAAU,mBAAmB;IAAU;IAAkB;IAA6B;;EAC7F,MAAM;IAAW;MAAqB;EACtC,YAAY,kBAAkB,WAAW,OAAO,8BAA8B,QAAQ;EACtF,YAAY,gBAAgB,WAAW,OAAO,+BAA+B,QAAQ;EACrF,YAAY,8BAA8B,WAAW,OAAO,0BAA0B,QAAQ;EAC9F,YAAY,iBAAiB,WAAW,OAAO,gCAAgC,QAAQ;;iBAGxE;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;iBAGe;EACf;EACA"}

package/dist/native/extensions.d.ts

@@ -0,0 +1,31 @@
+import { projectionAncestors } from "./shared/clipping.js";
+import { Candidate, Identify } from "./shared/candidate.js";
+//#region src/native/extensions.d.ts
+export type NativeUIValue = string | number | boolean | null | NativeUIValue[] | {
+  [key: string]: NativeUIValue;
+};
+export type NativeUIImageReference = {
+  readonly $nativeUIImage: string;
+};
+export interface NativeUIReadContext {
+  image(element: SVGElement | HTMLElement | null, options?: {
+    template?: boolean;
+  }): NativeUIImageReference | null;
+}
+export interface NativeUIExtension {
+  readonly name: string;
+  readonly selector: string;
+  readonly placement?: 'element' | 'tab-accessory';
+  readonly read: (element: HTMLElement, context: NativeUIReadContext) => {
+    props: {
+      [key: string]: NativeUIValue;
+    };
+    actions?: Record<string, HTMLElement | null>;
+  } | null;
+}
+export declare const defineNativeUI: <T extends NativeUIExtension>(extension: T) => Readonly<T>;
+export declare const validateExtensions: (extensions: readonly NativeUIExtension[], doc: Document) => void;
+export declare const readExtension: (element: HTMLElement, extensions: readonly NativeUIExtension[], id: Identify, diagnose?: (reason: string) => void) => Candidate | undefined;
+//#endregion
+export { projectionAncestors as extensionAncestors };
+//# sourceMappingURL=extensions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.d.ts","names":[],"sources":["../../src/native/extensions.ts"],"mappings":";;;YAMY,mDAAmD;GAAqB,cAAc;;YAGtF;WAAoC;;iBAG/B;EAEf,MAAM,SAAS,aAAa,oBAAoB;IAAY;MAAuB;;iBAMpE;WACN;WACA;WAEA;WAEA,OACP,SAAS,aACT,SAAS;IAET;OAAU,cAAc;;IAExB,UAAU,eAAe;;;qBAOhB,iBAAkB,UAAU,mBAAmB,WAAW,MAAI,SAAS;qBAEvE,qBAAsB,qBAAqB,qBAAqB,KAAK;qBAoCrE,gBACX,SAAS,aACT,qBAAqB,qBACrB,IAAI,UACJ,YAAW,4BACV"}

package/dist/native/extensions.js

@@ -0,0 +1,122 @@
+import { frame, isDark, visible } from "./shared/dom.js";
+import { fitsClip, projectionAncestors } from "./shared/clipping.js";
+import { iconSource } from "./shared/icons.js";
+//#region src/native/extensions.ts
+/** Defines a projection locally; it does not start native work or register a Capacitor plugin.
+* @experimental API and behavior may change in future releases.
+*/
+const defineNativeUI = (extension) => Object.freeze({ ...extension });
+const validateExtensions = (extensions, doc) => {
+	const names = /* @__PURE__ */ new Set();
+	for (const extension of extensions) {
+		if (!extension.name.trim() || names.has(extension.name)) throw new Error("Native UI extension names must be nonempty and unique");
+		names.add(extension.name);
+		if (!extension.selector.trim()) throw new Error("Native UI extensions require a selector");
+		doc.querySelector(extension.selector);
+		if (extension.placement && !["element", "tab-accessory"].includes(extension.placement)) throw new Error("Invalid native UI placement");
+	}
+};
+const json = (value, images) => {
+	if (!value || typeof value !== "object" || Object.getPrototypeOf(value) !== Object.prototype) throw new Error("Native UI props must be a JSON object");
+	const result = JSON.stringify(value, (_key, item) => {
+		if (item === void 0 || typeof item === "function" || typeof item === "symbol" || typeof item === "number" && !Number.isFinite(item) || item !== null && typeof item === "object" && !Array.isArray(item) && Object.getPrototypeOf(item) !== Object.prototype) throw new Error("Native UI props must contain only JSON values");
+		if (item && typeof item === "object" && "$nativeUIImage" in item) {
+			const image = images.get(item.$nativeUIImage);
+			if (!image || Object.keys(item).length !== 1) throw new Error("Invalid native image reference");
+			return image;
+		}
+		return item;
+	});
+	if (!result || result.length > 65536) throw new Error("Native UI props exceed 64K characters");
+	return result;
+};
+/** Follow slot assignment too: Ionic scroll containers live inside shadow roots. */
+const readExtension = (element, extensions, id, diagnose = () => {}) => {
+	const skip = (reason) => {
+		diagnose(reason);
+	};
+	const matches = extensions.filter((extension) => element.matches(extension.selector));
+	if (matches.length !== 1) return skip("overlapping-selectors: exactly one extension must own this source.");
+	if (!visible(element)) return skip("source-hidden: the source must be visible and inside the viewport.");
+	if (element.closest("ion-modal, ion-popover, ion-menu")) return skip("unsupported-overlay: extension sources inside Web overlays stay on the Web.");
+	if (element.contains(element.ownerDocument.activeElement)) return skip("source-focused: keep the focused Web source until focus leaves.");
+	const extension = matches[0];
+	if (extension.placement !== "tab-accessory" && !fitsClip(element)) return skip("source-clipped: the source must fit its clipping ancestors without transformed ancestors.");
+	try {
+		const images = [];
+		const imageValues = /* @__PURE__ */ new Map();
+		let state;
+		try {
+			state = extension.read(element, { image(owner, options) {
+				if (!owner || !(element.contains(owner) || element.shadowRoot?.contains(owner))) return null;
+				const svg = owner.matches("svg") ? owner : owner.shadowRoot?.querySelector("svg");
+				if (!svg) return null;
+				const source = iconSource(svg);
+				const { width, height } = owner.getBoundingClientRect();
+				if (!source || !Number.isFinite(width) || !Number.isFinite(height) || width <= 0 || height <= 0) return null;
+				const value = {
+					data: "",
+					width,
+					height,
+					template: options?.template ?? false
+				};
+				const key = String(images.length);
+				images.push({
+					value,
+					source
+				});
+				imageValues.set(key, value);
+				return { $nativeUIImage: key };
+			} });
+		} catch {
+			return skip("reader-error: the extension reader threw; inspect its implementation.");
+		}
+		if (!state) return skip("reader-opt-out: the reader returned null.");
+		const props = json(state.props, imageValues);
+		const actions = /* @__PURE__ */ new Map();
+		const targets = {};
+		for (const [name, target] of Object.entries(state.actions ?? {})) {
+			if (!name || target && !element.contains(target)) return skip("invalid-actions: use named targets inside the source element.");
+			if (!target || !visible(target) || target.disabled || target.matches(":disabled, [disabled]") || target.closest("[aria-disabled=\"true\"]") || getComputedStyle(target).pointerEvents === "none") continue;
+			targets[name] = id(target);
+			actions.set(id(target), target);
+		}
+		if (Object.keys(targets).length > 30) return skip("invalid-actions: a source can expose at most 30 actions.");
+		const tabBar = extension.placement === "tab-accessory" ? Array.from(element.closest("ion-tabs")?.querySelectorAll("ion-tab-bar") ?? []).find((bar) => bar.closest("ion-tabs") === element.closest("ion-tabs")) : void 0;
+		if (extension.placement === "tab-accessory" && !tabBar) return skip("missing-tab-owner: a tab accessory needs an owning ion-tabs with ion-tab-bar.");
+		const style = getComputedStyle(element);
+		const control = {
+			id: id(element),
+			kind: "extension",
+			...frame(element.getBoundingClientRect()),
+			items: [],
+			dark: isDark(style),
+			rtl: style.direction === "rtl",
+			extension: {
+				name: extension.name,
+				props,
+				actions: targets,
+				tabBarId: tabBar ? id(tabBar) : void 0
+			}
+		};
+		return {
+			element,
+			actions,
+			icons: [],
+			control,
+			assets: images.length ? {
+				signature: JSON.stringify(images),
+				async render(renderer) {
+					for (const { value, source } of images) value.data = await renderer.render(source, value.width, value.height);
+					control.extension.props = json(state.props, imageValues);
+				}
+			} : void 0
+		};
+	} catch {
+		return skip("invalid-props: return a JSON object with finite values, valid image references, and at most 64K characters.");
+	}
+};
+//#endregion
+export { defineNativeUI, projectionAncestors as extensionAncestors, readExtension, validateExtensions };
+
+//# sourceMappingURL=extensions.js.map

package/dist/native/extensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.js","names":[],"sources":["../../src/native/extensions.ts"],"sourcesContent":["import { fitsClip } from './shared/clipping';\nexport { projectionAncestors as extensionAncestors } from './shared/clipping';\nimport type { Candidate, Identify } from './shared/candidate';\nimport { frame, isDark, visible } from './shared/dom';\nimport { iconSource, type createIconRenderer } from './shared/icons';\n\nexport type NativeUIValue = string | number | boolean | null | NativeUIValue[] | { [key: string]: NativeUIValue };\n\n/** Opaque image reference. Return it in props; the shell replaces it with NativeUIImage data before transmission. */\nexport type NativeUIImageReference = { readonly $nativeUIImage: string };\ntype NativeUIImage = { data: string; width: number; height: number; template: boolean };\n\nexport interface NativeUIReadContext {\n  /** Capture a local SVG or resolved ion-icon using the standard renderer. Unsupported artwork returns null. */\n  image(element: SVGElement | HTMLElement | null, options?: { template?: boolean }): NativeUIImageReference | null;\n}\n\n/** An app-local DOM projection. Swift or Kotlin registers its native content under the same name.\n * @experimental API and behavior may change in future releases.\n */\nexport interface NativeUIExtension {\n  readonly name: string;\n  readonly selector: string;\n  /** Defaults to the source element's frame. Unsupported hosts keep the Web source visible. */\n  readonly placement?: 'element' | 'tab-accessory';\n  /** Return null to keep this instance on the Web. Read current source state without side effects. Notify property-only changes with shell.markForCheck(). */\n  readonly read: (\n    element: HTMLElement,\n    context: NativeUIReadContext,\n  ) => {\n    props: { [key: string]: NativeUIValue };\n    /** Click targets must belong to the source element. Null targets are unavailable. */\n    actions?: Record<string, HTMLElement | null>;\n  } | null;\n}\n\n/** Defines a projection locally; it does not start native work or register a Capacitor plugin.\n * @experimental API and behavior may change in future releases.\n */\nexport const defineNativeUI = <T extends NativeUIExtension>(extension: T): Readonly<T> => Object.freeze({ ...extension });\n\nexport const validateExtensions = (extensions: readonly NativeUIExtension[], doc: Document): void => {\n  const names = new Set<string>();\n  for (const extension of extensions) {\n    if (!extension.name.trim() || names.has(extension.name)) throw new Error('Native UI extension names must be nonempty and unique');\n    names.add(extension.name);\n    if (!extension.selector.trim()) throw new Error('Native UI extensions require a selector');\n    doc.querySelector(extension.selector);\n    if (extension.placement && !['element', 'tab-accessory'].includes(extension.placement)) throw new Error('Invalid native UI placement');\n  }\n};\n\nconst json = (value: unknown, images: Map<string, NativeUIImage>): string => {\n  if (!value || typeof value !== 'object' || Object.getPrototypeOf(value) !== Object.prototype)\n    throw new Error('Native UI props must be a JSON object');\n  const result = JSON.stringify(value, (_key, item: unknown) => {\n    if (\n      item === undefined ||\n      typeof item === 'function' ||\n      typeof item === 'symbol' ||\n      (typeof item === 'number' && !Number.isFinite(item)) ||\n      (item !== null && typeof item === 'object' && !Array.isArray(item) && Object.getPrototypeOf(item) !== Object.prototype)\n    )\n      throw new Error('Native UI props must contain only JSON values');\n    if (item && typeof item === 'object' && '$nativeUIImage' in item) {\n      const image = images.get(item.$nativeUIImage as string);\n      if (!image || Object.keys(item).length !== 1) throw new Error('Invalid native image reference');\n      return image;\n    }\n    return item;\n  });\n  if (!result || result.length > 65536) throw new Error('Native UI props exceed 64K characters');\n  return result;\n};\n\n/** Follow slot assignment too: Ionic scroll containers live inside shadow roots. */\n\nexport const readExtension = (\n  element: HTMLElement,\n  extensions: readonly NativeUIExtension[],\n  id: Identify,\n  diagnose: (reason: string) => void = () => {},\n): Candidate | undefined => {\n  const skip = (reason: string): undefined => {\n    diagnose(reason);\n    return undefined;\n  };\n  const matches = extensions.filter((extension) => element.matches(extension.selector));\n  if (matches.length !== 1) return skip('overlapping-selectors: exactly one extension must own this source.');\n  if (!visible(element)) return skip('source-hidden: the source must be visible and inside the viewport.');\n  if (element.closest('ion-modal, ion-popover, ion-menu'))\n    return skip('unsupported-overlay: extension sources inside Web overlays stay on the Web.');\n  if (element.contains(element.ownerDocument.activeElement)) return skip('source-focused: keep the focused Web source until focus leaves.');\n  const extension = matches[0];\n  if (extension.placement !== 'tab-accessory' && !fitsClip(element))\n    return skip('source-clipped: the source must fit its clipping ancestors without transformed ancestors.');\n  try {\n    const images: { value: NativeUIImage; source: string }[] = [];\n    const imageValues = new Map<string, NativeUIImage>();\n    let state: ReturnType<NativeUIExtension['read']>;\n    try {\n      state = extension.read(element, {\n        image(owner, options) {\n          if (!owner || !(element.contains(owner) || element.shadowRoot?.contains(owner))) return null;\n          const svg = owner.matches('svg') ? (owner as SVGElement) : owner.shadowRoot?.querySelector<SVGElement>('svg');\n          if (!svg) return null;\n          const source = iconSource(svg);\n          const { width, height } = owner.getBoundingClientRect();\n          if (!source || !Number.isFinite(width) || !Number.isFinite(height) || width <= 0 || height <= 0) return null;\n          const value: NativeUIImage = { data: '', width, height, template: options?.template ?? false };\n          const key = String(images.length);\n          images.push({ value, source });\n          imageValues.set(key, value);\n          return { $nativeUIImage: key };\n        },\n      });\n    } catch {\n      return skip('reader-error: the extension reader threw; inspect its implementation.');\n    }\n    if (!state) return skip('reader-opt-out: the reader returned null.');\n    const props = json(state.props, imageValues);\n    const actions = new Map<string, HTMLElement>();\n    const targets: Record<string, string> = {};\n    for (const [name, target] of Object.entries(state.actions ?? {})) {\n      if (!name || (target && !element.contains(target))) return skip('invalid-actions: use named targets inside the source element.');\n      if (\n        !target ||\n        !visible(target) ||\n        (target as HTMLElement & { disabled?: boolean }).disabled ||\n        target.matches(':disabled, [disabled]') ||\n        target.closest('[aria-disabled=\"true\"]') ||\n        getComputedStyle(target).pointerEvents === 'none'\n      )\n        continue;\n      targets[name] = id(target);\n      actions.set(id(target), target);\n    }\n    if (Object.keys(targets).length > 30) return skip('invalid-actions: a source can expose at most 30 actions.');\n    const tabBar =\n      extension.placement === 'tab-accessory'\n        ? Array.from(element.closest('ion-tabs')?.querySelectorAll<HTMLElement>('ion-tab-bar') ?? []).find(\n            (bar) => bar.closest('ion-tabs') === element.closest('ion-tabs'),\n          )\n        : undefined;\n    if (extension.placement === 'tab-accessory' && !tabBar)\n      return skip('missing-tab-owner: a tab accessory needs an owning ion-tabs with ion-tab-bar.');\n    const style = getComputedStyle(element);\n    const control = {\n      id: id(element),\n      kind: 'extension' as const,\n      ...frame(element.getBoundingClientRect()),\n      items: [],\n      dark: isDark(style),\n      rtl: style.direction === 'rtl',\n      extension: { name: extension.name, props, actions: targets, tabBarId: tabBar ? id(tabBar) : undefined },\n    };\n    return {\n      element,\n      actions,\n      icons: [],\n      control,\n      assets: images.length\n        ? {\n            signature: JSON.stringify(images),\n            async render(renderer: ReturnType<typeof createIconRenderer>) {\n              for (const { value, source } of images) value.data = await renderer.render(source, value.width, value.height);\n              control.extension.props = json(state.props, imageValues);\n            },\n          }\n        : undefined,\n    };\n  } catch {\n    // Keep the source usable without exposing props or application exception data.\n    return skip('invalid-props: return a JSON object with finite values, valid image references, and at most 64K characters.');\n  }\n};\n"],"mappings":"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"}

package/dist/native/foldable/fold-state.d.ts

@@ -0,0 +1,5 @@
+import { FoldState } from "./types.js";
+//#region src/native/foldable/fold-state.d.ts
+export declare function applyFoldStateClasses(root: HTMLElement, fold: FoldState): void;
+//#endregion
+//# sourceMappingURL=fold-state.d.ts.map

package/dist/native/foldable/fold-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fold-state.d.ts","names":[],"sources":["../../../src/native/foldable/fold-state.ts"],"mappings":";;wBAIgB,sBAAsB,MAAM,aAAa,MAAM"}

package/dist/native/foldable/fold-state.js

@@ -0,0 +1,15 @@
+//#region src/native/foldable/fold-state.ts
+/** @deprecated Import applyFoldStateClasses from @rdlabo/ionic-theme-ios27 instead.
+* Keep posture on ion-app so descendants can follow it through CSS. */
+function applyFoldStateClasses(root, fold) {
+	for (const state of [
+		"flat",
+		"half-opened",
+		"closed"
+	]) root.classList.toggle(`ios-theme-fold-${state}`, fold.state === state);
+	root.classList.toggle("ios-theme-fold-expanded", fold.state === "half-opened" || fold.state === "flat" && !!fold.hingeBounds);
+}
+//#endregion
+export { applyFoldStateClasses };
+
+//# sourceMappingURL=fold-state.js.map

package/dist/native/foldable/fold-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fold-state.js","names":[],"sources":["../../../src/native/foldable/fold-state.ts"],"sourcesContent":["import type { FoldState } from './types';\n\n/** @deprecated Import applyFoldStateClasses from @rdlabo/ionic-theme-ios27 instead.\n * Keep posture on ion-app so descendants can follow it through CSS. */\nexport function applyFoldStateClasses(root: HTMLElement, fold: FoldState): void {\n  for (const state of ['flat', 'half-opened', 'closed']) {\n    root.classList.toggle(`ios-theme-fold-${state}`, fold.state === state);\n  }\n  root.classList.toggle('ios-theme-fold-expanded', fold.state === 'half-opened' || (fold.state === 'flat' && !!fold.hingeBounds));\n}\n"],"mappings":";;;AAIA,SAAgB,sBAAsB,MAAmB,MAAuB;CAC9E,KAAK,MAAM,SAAS;EAAC;EAAQ;EAAe;CAAQ,GAClD,KAAK,UAAU,OAAO,kBAAkB,SAAS,KAAK,UAAU,KAAK;CAEvE,KAAK,UAAU,OAAO,2BAA2B,KAAK,UAAU,iBAAkB,KAAK,UAAU,UAAU,CAAC,CAAC,KAAK,WAAY;AAChI"}

package/dist/native/foldable/types.d.ts

@@ -0,0 +1,12 @@
+//#region src/native/foldable/types.d.ts
+export interface FoldState {
+  state: 'flat' | 'half-opened' | 'closed';
+  hingeBounds?: {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+  };
+}
+//#endregion
+//# sourceMappingURL=types.d.ts.map

package/dist/native/foldable/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/native/foldable/types.ts"],"mappings":";iBAAiB;EACf;EACA;IAAgB;IAAW;IAAW;IAAe"}

package/dist/native/html.d.ts

@@ -0,0 +1,9 @@
+import { Candidate, Identify } from "./shared/candidate.js";
+import { NativeUIRuntimeHandle, NativeUIRuntimeOptions } from "./definitions.js";
+//#region src/native/html.d.ts
+export declare const htmlSelector = "[data-native-ui=\"button\"], [data-native-ui=\"back-button\"]";
+export declare const htmlRailSource: (element: Element) => boolean;
+export declare const readHTMLControl: (element: HTMLElement, id: Identify, options: NativeUIRuntimeOptions) => Candidate | undefined;
+export declare const createHTMLWebProjection: (doc: Document, options: NativeUIRuntimeOptions) => NativeUIRuntimeHandle;
+//#endregion
+//# sourceMappingURL=html.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"html.d.ts","names":[],"sources":["../../src/native/html.ts"],"mappings":";;;qBAMa;qBACA,iBAAkB,SAAS;qBAG3B,kBAAmB,SAAS,aAAa,IAAI,UAAU,SAAS,2BAAyB;qBAoCzF,0BAA2B,KAAK,UAAU,SAAS,2BAAyB"}