web-launch-kit 0.0.4 → 0.0.5

package/README.ko.md

@@ -24,6 +24,7 @@ npm install web-launch-kit
 | 멤버 | 시그니처 | 설명 |
 | --- | --- | --- |
 | `LaunchKit.version` | `string` | 설치된 패키지 버전 |
+| `LaunchKit.debug` | `boolean` (get/set) | 각 실행 시도 전에 `debugger`로 정지. 기본값 `false` |
 | `LaunchKit.SettingType` | `enum` | 설정 화면: `General`, `Network`, `Display`, `Appearance`, `Accessibility`, `Battery`, `Datetime`, `Language`, `Accounts`, `Storage` |
 | `LaunchKit.app(options?)` | `Promise<AppOpenedBy>` | 가능한 최선의 경로로 앱을 실행하고, 어떤 경로로 열렸는지 반환 |
 | `LaunchKit.telephone(options?)` | `Promise<void>` | 전화 앱 열기 (`tel:`) |
@@ -259,6 +260,24 @@ await LaunchKit.map({ directions: { destination: 'Seoul Station', origin: [37.56
 경로는 Google Maps 폴백을 쓰고, Windows도 지도 앱이 단종되어 `bingmaps:`가 대개 웹 폴백으로
 넘어갑니다.
 
+## 콘솔에서 테스트하기
+
+DevTools 콘솔에서 실행 메서드를 호출하면 페이지에 포커스도, 사용자 activation도 없는
+상태가 됩니다. 둘 다 프로그램으로는 되돌릴 수 없어서 시도가 실패하고 앱 전환 감지도 볼 것이
+없습니다. 같은 호출을 클릭 핸들러 안에서 하면 정상 동작합니다.
+
+`debug`를 켜면 화면 이동 직전에 정지합니다. 재개 버튼을 누르면 포커스와 activation이
+돌아와서 콘솔에서도 실제 탭과 동일하게 동작합니다.
+
+```js
+LaunchKit.debug = true
+
+await LaunchKit.app({ ios: { scheme: 'myapp://profile/42' } })
+```
+
+그 외에는 꺼두세요. 모든 실행 메서드가 같은 지점을 지나므로 `telephone`, `message`,
+`mail`, `map`에서도 후보마다 한 번씩 정지합니다.
+
 ## 시스템 설정
 
 ```js

package/README.md

@@ -25,6 +25,7 @@ The bundle is self-contained (OS/locale detection is inlined) — no peer script
 | Member | Signature | Description |
 | --- | --- | --- |
 | `LaunchKit.version` | `string` | The installed package version |
+| `LaunchKit.debug` | `boolean` (get/set) | Pause on a `debugger` before each launch attempt; defaults to `false` |
 | `LaunchKit.SettingType` | `enum` | Setting panes: `General`, `Network`, `Display`, `Appearance`, `Accessibility`, `Battery`, `Datetime`, `Language`, `Accounts`, `Storage` |
 | `LaunchKit.app(options?)` | `Promise<AppOpenedBy>` | Launch an app via the best available route; resolves with which route opened it |
 | `LaunchKit.telephone(options?)` | `Promise<void>` | Open the dialer (`tel:`) |
@@ -262,6 +263,24 @@ handlers other than Google Maps misread the labelled form as a search. Android's
 fallback there, and on Windows the discontinued Maps app means `bingmaps:` usually
 defers to the web fallback too.
 
+## Testing from the console
+
+Calling a launch method from the DevTools console leaves the page without focus and without
+user activation. Neither can be restored programmatically, so the attempt fails and
+app-switch detection has nothing to observe — the same call from a click handler works fine.
+
+Set `debug` to pause before the navigation. Pressing resume hands focus and activation back,
+so the console behaves like a real tap.
+
+```js
+LaunchKit.debug = true
+
+await LaunchKit.app({ ios: { scheme: 'myapp://profile/42' } })
+```
+
+Leave it off otherwise — every launch method routes through the same place, so it would
+pause on `telephone`, `message`, `mail`, and `map` too, once per candidate.
+
 ## System settings
 
 ```js

package/dist/index.d.ts

@@ -89,6 +89,8 @@ interface LaunchKitUtils {
 interface LaunchKitInstance {
     readonly version: string;
     readonly SettingType: typeof SettingType;
+    get debug(): boolean;
+    set debug(value: boolean);
     readonly utils: LaunchKitUtils;
     app(options?: AppOpenOptions): Promise<AppOpenedBy>;
     telephone(options?: TelephoneOptions): Promise<void>;

package/dist/launch-kit.cjs

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var version$3 = "0.0.4";
+var version$3 = "0.0.5";
 var packageJSON$3 = {
 	version: version$3};
 
@@ -262,7 +262,7 @@ function parseWebview() {
         return true;
     if (/\belectron\//i.test(currentUserAgent))
         return true;
-    if (/(?:iphone|ipad|ipod)/i.test(currentUserAgent) && /applewebkit/i.test(currentUserAgent) && /safari/i.test(currentUserAgent) === false)
+    if (/iphone|ipad|ipod/i.test(currentUserAgent) && /applewebkit/i.test(currentUserAgent) && /safari/i.test(currentUserAgent) === false)
         return true;
     return parseInAppBrowser() !== null;
 }
@@ -492,7 +492,7 @@ function getGlobal$2() {
     return {};
 }
 
-var version$1 = "0.0.1";
+var version$1 = "0.0.3";
 var packageJSON$1 = {
 	version: version$1};
 
@@ -942,8 +942,6 @@ var GLOBAL$4 = getGlobal$2();
 var LISTENER_STORE = [];
 var NOOP = function () {
 };
-// Records live on the target itself, so they are collected with it and lookups only scan
-// that target's own listeners. Targets that reject the expando fall back to LISTENER_STORE.
 var STORE_KEY = '__webEventKitListeners__';
 function resolveBucket(target, create) {
     var holder = target;
@@ -1001,9 +999,6 @@ function invokeCallback(callback, target, event) {
     if (typeof callback === 'object' && callback !== null && typeof callback.handleEvent === 'function')
         return callback.handleEvent(event);
 }
-// The same Event object is handed to every listener, so any property this kit overrides has
-// to be put back before the next one runs — otherwise a `pointerdown` listener would observe
-// the `touchstart` type and synthetic touches written by a listener registered before it.
 function patchEventProperty(event, property, value, patches) {
     var holder = event;
     var had = false;
@@ -1169,8 +1164,6 @@ var EventKit = {
             return NOOP;
         var normalized = normalizeListenerOptions(options);
         var existing = findListenerRecord(target, type, callback, normalized.capture);
-        // Native `addEventListener` ignores a duplicate registration, so hand back a releaser
-        // that does nothing rather than one that would detach the first caller's listener.
         if (typeof existing !== 'undefined')
             return NOOP;
         if (typeof normalized.signal !== 'undefined' && normalized.signal.aborted)
@@ -1200,8 +1193,6 @@ var EventKit = {
             record.onAbort = function () {
                 releaseListenerRecord(record);
             };
-            // Engines without listener-options coerce `{once: true}` to capture, which would then
-            // fail to match on removal; releaseListenerRecord detaches this anyway.
             record.signal.addEventListener('abort', record.onAbort, false);
         }
         return function () {
@@ -1906,6 +1897,7 @@ var DEFAULT_TIMEOUT = 750;
 var GLOBAL = getGlobal$1();
 var NAVIGATOR = GLOBAL.navigator;
 var CLEANUP_INPUT_ELEMENT = null;
+var DEBUG = false;
 function createTypeGuard(tag) {
     return function (value) {
         return Object.prototype.toString.call(value) === '[object ' + tag + ']';
@@ -2179,7 +2171,8 @@ function openURL(tried, url, timeout) {
         }
     }
     return new Promise(function (resolve, reject) {
-        debugger;
+        if (DEBUG)
+            debugger;
         var timeoutId;
         var resolved = false;
         function cleanup() {
@@ -2803,6 +2796,12 @@ function walk(directory, basePath) {
 var LaunchKit = {
     SettingType: exports.SettingType,
     version: packageJSON$3.version,
+    get debug() {
+        return DEBUG;
+    },
+    set debug(value) {
+        DEBUG = value === true;
+    },
     utils: {
         get canOpenIntent() {
             return canOpenIntent();