` placed immediately after the opening `` tag in `root.html.heex`: Placing it at the top of `` ensures the hook mounts as early as possible, so `window.dala` is overridden before any page-specific JS runs. ### Android timing note iOS injects the native `window.dala` shim via `WKUserScript` at `.atDocumentStart` — before any page JS runs. Android injects it via `evaluateJavascript` in `onPageFinished` — after the page has loaded. Between page load and `onPageFinished` on Android, `window.dala` is undefined. In practice LiveView connects after `onPageFinished`, so both shims are available by the time the DalaHook mounts. If you call `window.dala` during `DOMContentLoaded`, guard with `if (window.dala)`. # `build_plist_entry` ```elixir @spec build_plist_entry(String.t(), term(), keyword()) :: String.t() ``` Builds a plist `/` entry for Info.plist injection. Options: - `type: :bool` — emits `` or `` instead of `` # `dala_bridge_element` ```elixir @spec dala_bridge_element() :: String.t() ``` Returns the hidden bridge `

` element that must appear in `root.html.heex`. See the module doc for why this element is required. # `dala_hook_js` ```elixir @spec dala_hook_js() :: String.t() ``` Returns the DalaHook JS constant to inject into app.js. # `find_root_html` ```elixir @spec find_root_html(String.t(), String.t()) :: String.t() | nil ``` Finds `root.html.heex` in a Phoenix project rooted at `project_dir`. Checks both the Phoenix 1.7+ convention: lib/_web/components/layouts/root.html.heex and the pre-1.7 convention: lib/_web/templates/layout/root.html.heex Returns the path string or `nil` if neither file exists. # `inject_android_network_security_config` ```elixir @spec inject_android_network_security_config(String.t()) :: String.t() ``` Adds `android:networkSecurityConfig="@xml/network_security_config"` to the `` tag in an AndroidManifest.xml string. Idempotent — returns the content unchanged if the attribute is already present. # `inject_dala_bridge_element` ```elixir @spec inject_dala_bridge_element(String.t()) :: String.t() ``` Injects the hidden bridge `

` into `content` (a `root.html.heex` file). The element is placed immediately after the opening `` tag. This is the mount point for DalaHook — without it the hook never executes and `window.dala` is never replaced with the LiveView version. See the module doc for the full explanation. Returns the patched HTML string unchanged if `id="dala-bridge"` is already present. # `inject_dala_hook` ```elixir @spec inject_dala_hook(String.t()) :: String.t() ``` Injects the DalaHook definition and registration into `content` (the full text of `assets/js/app.js`). - Inserts the hook constant after the last top-level `import` line. - Registers `DalaHook` in the `hooks:` option passed to `LiveSocket`. Returns the patched JS string. Idempotency (skip if already present) is handled by the calling task, not by this function. # `network_security_config_xml` ```elixir @spec network_security_config_xml() :: String.t() ``` Returns the XML content for the Android network security config. # `read_app_name_from` ```elixir @spec read_app_name_from(String.t()) :: String.t() ``` Reads the `app:` atom from the given `mix.exs` path and returns the app name as a string, or raises. --- *Consult [api-reference.md](api-reference.md) for complete listing*