@ait-co/devtools 0.1.58 → 0.1.60

package/dist/unplugin/index.d.ts

@@ -10150,6 +10150,25 @@ interface AitDevtoolsOptions {
     cdp?: boolean;
   };
 }
+/**
+ * Resolves the effective tunnel option (#425).
+ *
+ * An explicit `tunnel` value (including `false`) always takes priority over
+ * env vars — the `??` operator means `undefined` (= omitted) falls through,
+ * but `false` / `true` / an object are preserved as-is (non-breaking).
+ *
+ * When the option is omitted:
+ * - `AIT_TUNNEL=1` enables the base screen-preview tunnel.
+ * - `AIT_TUNNEL_CDP=1` (requires `AIT_TUNNEL`) upgrades to the CDP relay.
+ * - Neither set → `false` (disabled).
+ *
+ * Extracted as a pure function so it can be unit-tested without standing up
+ * a full Vite dev server.
+ *
+ * @param explicit - The `tunnel` option as passed by the consumer (or `undefined` when omitted).
+ * @param env - The process environment (injectable for testing).
+ */
+declare function resolveTunnelOption(explicit: AitDevtoolsOptions['tunnel'], env: Record<string, string | undefined>): AitDevtoolsOptions['tunnel'];
 declare const aitDevtoolsPlugin: _$unplugin.UnpluginInstance<AitDevtoolsOptions | undefined, boolean>;
 declare const vite: (options?: AitDevtoolsOptions | undefined) => Plugin<any> | Plugin<any>[];
 declare const webpack: (options?: AitDevtoolsOptions | undefined) => WebpackPluginInstance;
@@ -10157,5 +10176,5 @@ declare const rollup: (options?: AitDevtoolsOptions | undefined) => any;
 declare const esbuild: (options?: AitDevtoolsOptions | undefined) => _$unplugin.EsbuildPlugin;
 declare const rspack: (options?: AitDevtoolsOptions | undefined) => RspackPluginInstance;
 //#endregion
-export { AitDevtoolsOptions, aitDevtoolsPlugin as default, esbuild, rollup, rspack, vite, webpack };
+export { AitDevtoolsOptions, aitDevtoolsPlugin as default, esbuild, resolveTunnelOption, rollup, rspack, vite, webpack };
 //# sourceMappingURL=index.d.ts.map