web-launch-kit 0.0.8 → 0.0.10

package/README.ko.md

@@ -34,7 +34,7 @@ npm install web-launch-kit
 | `LaunchKit.filepicker(options?)` | `Promise<File[]>` | 파일 또는 디렉터리 선택 (File System Access API, input 폴백) |
 | `LaunchKit.setting(type?)` | `Promise<void>` | 지원되는 환경에서 시스템 설정 화면 열기 |
 | `LaunchKit.escapeWebview(options?)` | `Promise<void>` | URL(기본값은 현재 페이지)을 외부 브라우저에서 다시 열어 인앱 웹뷰에서 탈출 |
-| `LaunchKit.utils` | object | `canOpenIntent` / `canOpenUniversal` / `canOpenSetting` / `canEscapeWebview` getter와 비동기 `getTrackId` / `getProductId` |
+| `LaunchKit.utils` | object | `canOpenIntent` / `canOpenUniversal` / `canOpenSetting` / `canEscapeWebview` getter와 비동기 `getTrackId(bundleId)` / `getProductId(packageFamilyName, language?, country?)` |
 
 `AppOpenedBy`는 `"scheme"`, `"universal"`, `"intent"`, `"fallback"`, `"store"` 중 하나입니다.
 
@@ -147,6 +147,18 @@ flowchart TD
         M2 --> M3["Priority list:<br/>scheme ⭢ fallback<br/>⭢ app store ⭢ web store (by trackId)"]
     end
 
+    subgraph LOC["web store · createWebStoreURL"]
+        L1{"country given?"}
+        L1 -->|yes| L3["Play · MS Store: hl / gl parameters<br/>App Store: /country/ path + l parameter"]
+        L1 -->|no| L2["Derive from language:<br/>region subtag ⭢ Intl.Locale.maximize()<br/>⭢ omit (store geolocation)"]
+        L2 --> L3
+    end
+
+    A5 -.->|"web store"| L1
+    I3 -.->|"web store"| L1
+    W3 -.->|"web store"| L1
+    M3 -.->|"web store"| L1
+
     AND --> P
     IOS --> P
     WIN --> P
@@ -191,6 +203,8 @@ const openedBy = await LaunchKit.app({
     packageName: 'com.example.myapp',
     allowAppStore: true,
     allowWebStore: true,
+    language: 'ko', // 웹스토어 UI 언어
+    country: 'KR',  // 생략하면 language 에서 유도됩니다 (region 서브태그 → Intl.Locale.maximize())
   },
   ios: {
     universal: 'https://example.com/profile/42',
@@ -206,7 +220,17 @@ console.log(openedBy) // "universal" | "scheme" | "intent" | "fallback" | "store
 플랫폼별 필드: 안드로이드는 `intent` / `scheme` / `packageName` / `fallback` /
 `allowIntent`(scheme ⇄ intent는 서로에게서 유도됩니다), iOS는 `universal` / `scheme` / `bundleId` / `trackId`, Windows는
 `scheme` / `packageFamilyName` / `productId`, macOS는 `scheme` / `bundleId` / `trackId`를
-받습니다. 모두 `fallback`, `timeout`, `allowAppStore`, `allowWebStore`를 함께 받습니다.
+받습니다. 모두 `fallback`, `timeout`, `allowAppStore`, `allowWebStore`, `language`,
+`country`를 함께 받습니다.
+
+`language` / `country`는 **웹스토어** 후보에만 적용됩니다 — Google Play와 Microsoft
+Store에서는 `hl` / `gl` 파라미터, App Store에서는 국가 경로 세그먼트와 `l` 파라미터로
+반영됩니다. `country`를 생략하면 `language`에서 유도합니다. region 서브태그가 우선하고
+(`ko-KR` → `KR`), 없으면 런타임이 지원하는 환경에서 `Intl.Locale.maximize()`를
+사용합니다. 둘 다 실패하면 국가를 붙이지 않고 스토어의 자체 위치 추정에 맡깁니다 —
+잘못된 국가는 "이 지역에서 사용할 수 없음" 페이지로 이어질 수 있어 생략이 안전한
+기본값입니다. 네이티브 앱스토어 스킴(`market://`, `itms-apps://` 등)은 건드리지
+않습니다. OS가 기기 로케일로 알아서 렌더링합니다.
 
 `onAttempt`는 각 후보 시도 직전에 동기로 호출됩니다. 대기 UI를 여기서 그리세요 — 그러지
 않으면 타임아웃 동안 화면에 아무 변화가 없습니다.
@@ -353,7 +377,12 @@ Meta 계열 웹뷰(Facebook, Instagram) 안에서는 차단됩니다. http(s) UR
 - **`utils.getTrackId` / `getProductId`는 비동기**이고 1시간 캐시됩니다. 페이지 초기화 때
   한 번 호출해두면 `app()`이 id를 인라인으로 조회하지 않습니다. `app()`은 사용자 제스처 안에서
   실행돼야 하므로, id가 없으면 `await`으로 user activation을 잃는 대신 동기로 조회합니다.
-  `trackId` / `productId`를 직접 주면 조회 자체가 생략됩니다.
+  `trackId` / `productId`를 직접 주면 조회 자체가 생략됩니다. `getProductId`는 선택적
+  `language` / `country`를 추가로 받아 Microsoft 카탈로그의 언어와 마켓을 고정합니다 —
+  조회 성공 여부가 마켓에 따라 달라질 수 있으니 `app()`에 넘길 값과 동일하게 주어야
+  프리워밍된 캐시가 같은 마켓을 커버합니다. 생략하면 웹스토어 country와 같은 방식으로
+  유도됩니다: 명시 region 서브태그 → 런타임이 지원하면 `Intl.Locale.maximize()` →
+  `en-US` / `US`. `getTrackId`는 로케일이 필요 없습니다 — iTunes lookup은 마켓과 무관합니다.
 - **스토어 id 조회는 외부 API에 의존합니다**(iTunes Lookup, Microsoft display catalog).
   1시간 캐시되며 실패는 예외가 아니라 `undefined`로 resolve됩니다.
 - **인앱 브라우저는 후보 단위로 걸러집니다.** 실행이 차단된 웹뷰(WeChat, QQ, Qzone, Baidu,
@@ -371,6 +400,11 @@ Meta 계열 웹뷰(Facebook, Instagram) 안에서는 차단됩니다. http(s) UR
 - **웹 폴백은 내비게이션 시점에 resolve합니다.** `fallback`이나 웹스토어 후보는 문서 자체를
   교체하므로 기다릴 앱 전환이 없습니다. 이동을 시작하는 즉시 resolve하며, 이동이 성공한 뒤에
   reject되는 일이 없습니다.
+- **예상 밖의 내비게이션도 결과로 확정됩니다.** 앱이 설치되지 않은 유니버설 링크, 브라우저
+  폴백이 실행된 intent처럼 실제 페이지 이동으로 바뀌는 후보는 타임아웃 전에 문서가 내려가
+  결과가 유실됐습니다. 이제 `pagehide`가 해당 후보를 resolve합니다. 앱 전환은 `pagehide` 없이
+  `hidden`만 발생하므로 두 경우는 구분됩니다. resolve는 언로드 중에 실행되며, 그 시점에도
+  `sendBeacon`은 정상 전송됩니다.
 
 ## 브라우저 지원
 

package/README.md

@@ -35,7 +35,7 @@ The bundle is self-contained (OS/locale detection is inlined) — no peer script
 | `LaunchKit.filepicker(options?)` | `Promise<File[]>` | Pick files or a directory (File System Access API, with input fallback) |
 | `LaunchKit.setting(type?)` | `Promise<void>` | Open a system-settings pane where supported |
 | `LaunchKit.escapeWebview(options?)` | `Promise<void>` | Reopen a URL (the current page by default) in the external browser, escaping an in-app webview |
-| `LaunchKit.utils` | object | `canOpenIntent` / `canOpenUniversal` / `canOpenSetting` / `canEscapeWebview` getters, plus async `getTrackId` / `getProductId` |
+| `LaunchKit.utils` | object | `canOpenIntent` / `canOpenUniversal` / `canOpenSetting` / `canEscapeWebview` getters, plus async `getTrackId(bundleId)` / `getProductId(packageFamilyName, language?, country?)` |
 
 `AppOpenedBy` is one of: `"scheme"`, `"universal"`, `"intent"`, `"fallback"`, `"store"`.
 
@@ -149,6 +149,18 @@ flowchart TD
         M2 --> M3["Priority list:<br/>scheme ⭢ fallback<br/>⭢ app store ⭢ web store (by trackId)"]
     end
 
+    subgraph LOC["web store · createWebStoreURL"]
+        L1{"country given?"}
+        L1 -->|yes| L3["Play · MS Store: hl / gl parameters<br/>App Store: /country/ path + l parameter"]
+        L1 -->|no| L2["Derive from language:<br/>region subtag ⭢ Intl.Locale.maximize()<br/>⭢ omit (store geolocation)"]
+        L2 --> L3
+    end
+
+    A5 -.->|"web store"| L1
+    I3 -.->|"web store"| L1
+    W3 -.->|"web store"| L1
+    M3 -.->|"web store"| L1
+
     AND --> P
     IOS --> P
     WIN --> P
@@ -193,6 +205,8 @@ const openedBy = await LaunchKit.app({
     packageName: 'com.example.myapp',
     allowAppStore: true,
     allowWebStore: true,
+    language: 'ko', // web-store UI language
+    country: 'KR',  // omit to derive from language (region subtag → Intl.Locale.maximize())
   },
   ios: {
     universal: 'https://example.com/profile/42',
@@ -209,7 +223,17 @@ Per-platform fields: Android accepts `intent` / `scheme` / `packageName` / `fall
 `allowIntent` (scheme ⇄ intent are derived from each other); iOS accepts `universal` / `scheme` /
 `bundleId` / `trackId`; Windows accepts `scheme` / `packageFamilyName` / `productId`;
 macOS accepts `scheme` / `bundleId` / `trackId`. All accept `fallback`, `timeout`,
-`allowAppStore`, `allowWebStore`. 
+`allowAppStore`, `allowWebStore`, `language`, `country`.
+
+`language` / `country` localize the **web-store** candidate only — `hl` / `gl` on
+Google Play and the Microsoft Store, a country path segment plus `l` on the App
+Store. When `country` is omitted it is derived from `language`: a region subtag
+wins (`ko-KR` → `KR`), then `Intl.Locale.maximize()` where the runtime supports
+it. When neither yields a region, the country is simply dropped and the store
+falls back to its own geolocation — a wrong country can land on an
+"not available in your region" page, so omission is the safe default. Native
+app-store schemes (`market://`, `itms-apps://`, …) are untouched; the OS renders
+those in the device locale.
 
 `onAttempt` fires synchronously before each candidate, which is where you drive the waiting
 UI — there is otherwise nothing on screen for the length of the timeout.
@@ -360,6 +384,12 @@ the button on `utils.canEscapeWebview`.
   during page setup keeps `app()` from resolving the id inline. `app()` must run inside a
   user gesture, so when the id is missing it looks it up synchronously rather than awaiting
   and losing user activation. Passing `trackId` / `productId` directly skips it entirely.
+  `getProductId` also takes optional `language` / `country` to pin the Microsoft catalog
+  language and market — pass the same values you will give `app()`, since whether a lookup
+  succeeds can depend on the market and the pre-warmed cache should cover the same one.
+  When omitted, the market is derived the same way as the web-store country: explicit region
+  subtag first, then `Intl.Locale.maximize()` where the runtime supports it, then `en-US` / `US`.
+  `getTrackId` needs no locale — iTunes lookup is market-independent.
 - **Store-id lookups depend on remote APIs** (iTunes Lookup, Microsoft display catalog)
   and are cached for one hour; failures resolve to `undefined` rather than throwing.
 - **In-app browsers are gated per candidate.** Inside webviews that block launches
@@ -381,6 +411,11 @@ the button on `utils.canEscapeWebview`.
 - **Web fallbacks resolve on navigation.** A `fallback` or web-store candidate replaces the
   document, so there is no app switch to wait for — those resolve as soon as the navigation
   is issued instead of risking a rejection after the move already succeeded.
+- **Unplanned navigations settle too.** A candidate that turns into a real navigation — a
+  universal link whose app is not installed, an intent whose browser fallback fires — used to
+  unload the document before the timeout, losing the result. `pagehide` now resolves the
+  candidate, and since an app switch fires `hidden` without `pagehide`, the two cases stay
+  distinguishable. The resolve runs during unload, where `sendBeacon` still delivers.
 
 ## Browser support
 

package/dist/index.d.ts

@@ -32,6 +32,8 @@ declare interface AppInfo {
     timeout?: number;
     allowAppStore?: boolean;
     allowWebStore?: boolean;
+    language?: string;
+    country?: string;
 }
 declare interface AndroidAppInfo extends AppInfo {
     intent?: URLCandidate;
@@ -102,7 +104,7 @@ interface LaunchKitUtils {
     get canOpenSetting(): boolean;
     get canEscapeWebview(): boolean;
     getTrackId(bundleId: string): Promise<string | undefined>;
-    getProductId(packageFamilyName: string): Promise<string | undefined>;
+    getProductId(packageFamilyName: string, language?: string, country?: string): Promise<string | undefined>;
 }
 interface LaunchKitInstance {
     readonly version: string;

package/dist/launch-kit.cjs

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var version$3 = "0.0.8";
+var version$3 = "0.0.10";
 var packageJSON$3 = {
 	version: version$3};
 
@@ -1284,7 +1284,7 @@ function createHiddenElement(tagName, focusable) {
     return element;
 }
 
-var version = "0.0.5";
+var version = "0.0.6";
 var packageJSON = {
 	version: version};
 
@@ -1413,6 +1413,27 @@ function expandTag(tag) {
         chain.push(segments.slice(0, i).join('-'));
     return freeze(chain);
 }
+function maximizeTag(tag) {
+    var parsed = parseTag(tag);
+    if (parsed === null)
+        return null;
+    if (parsed.script !== null && parsed.region !== null)
+        return parsed;
+    var IntlLocale = getIntlLocaleConstructor();
+    if (typeof IntlLocale === 'undefined')
+        return parsed;
+    try {
+        var intlLocale = new IntlLocale(parsed.baseName);
+        if (typeof intlLocale.maximize === 'function') {
+            var reparsed = parseTag(intlLocale.maximize().toString());
+            if (reparsed !== null)
+                return reparsed;
+        }
+    }
+    catch (_) {
+    }
+    return parsed;
+}
 function toLookupKey(tag) {
     var parsed = parseTag(tag);
     return (parsed === null ? tag : parsed.baseName).toLowerCase();
@@ -1455,6 +1476,11 @@ function resolveDirection(primary) {
         catch (_) {
         }
     }
+    if (primary.script === null) {
+        var maximized = maximizeTag(primary.baseName);
+        if (maximized !== null && maximized.script !== null)
+            return contains(RTL_SCRIPTS, maximized.script);
+    }
     return isRTL(primary);
 }
 var subtags = null;
@@ -1554,6 +1580,9 @@ var LocaleKit = {
     expand: function (tag) {
         return expandTag(tag);
     },
+    maximize: function (tag) {
+        return maximizeTag(tag);
+    },
     lookup: function (supported, fallback) {
         return lookupTag(supported, languages, typeof fallback === 'undefined' ? null : fallback);
     },
@@ -1566,6 +1595,7 @@ var CACHE_PREFIX = 'web-launch-kit:';
 var TRACK_ID = 'track-id';
 var PRODUCT_ID = 'product-id';
 var TRACK_ID_CACHE_TTL = 1000 * 60 * 60;
+var ALPHA2_REGION_PATTERN$1 = /^[A-Z]{2}$/;
 function toCacheKey(mode, query) {
     return CACHE_PREFIX + mode + ':' + query;
 }
@@ -1698,27 +1728,34 @@ function requestGet(url, async) {
         }
     }
 }
-function resolveGetProductIdURL(packageFamilyName) {
-    var locales = LocaleKit.languages;
-    var locale = 'en-US';
-    var country = 'US';
-    for (var i = 0; i < locales.length; i++) {
-        var candidate = locales[i];
-        if (candidate.indexOf('-') === -1)
-            continue;
-        var subtags = candidate.split('-');
-        for (var j = 1; j < subtags.length; j++) {
-            var subtag = subtags[j];
-            if (/^[A-Za-z]{2}$/.test(subtag) || /^\d{3}$/.test(subtag)) {
-                locale = candidate;
-                country = subtag;
-                break;
-            }
-        }
-        if (locale === candidate)
-            break;
-    }
-    return 'https://displaycatalog.md.mp.microsoft.com/v7.0/products/lookup?value=' + encodeURIComponent(packageFamilyName) + '&market=' + encodeURIComponent(country) + '&languages=' + encodeURIComponent(locale) + '&alternateId=PackageFamilyName';
+function resolveMarket(language, country) {
+    var locale = language;
+    var market;
+    if (typeof country !== 'undefined' && ALPHA2_REGION_PATTERN$1.test(country.toUpperCase()))
+        market = country.toUpperCase();
+    if (typeof market === 'undefined') {
+        var source = typeof locale !== 'undefined'
+            ? locale
+            : (LocaleKit.language === null ? undefined : LocaleKit.language);
+        if (typeof source !== 'undefined') {
+            var maximized = LocaleKit.maximize(source);
+            if (maximized !== null && maximized.region !== null && ALPHA2_REGION_PATTERN$1.test(maximized.region))
+                market = maximized.region;
+        }
+    }
+    if (typeof locale === 'undefined' && LocaleKit.language !== null)
+        locale = LocaleKit.language;
+    if (typeof locale === 'undefined')
+        locale = 'en-US';
+    if (typeof market === 'undefined')
+        market = 'US';
+    return [locale, market];
+}
+function resolveGetProductIdURL(packageFamilyName, language, country) {
+    var resolved = resolveMarket(language, country);
+    var locale = resolved[0];
+    var market = resolved[1];
+    return 'https://displaycatalog.md.mp.microsoft.com/v7.0/products/lookup?value=' + encodeURIComponent(packageFamilyName) + '&market=' + encodeURIComponent(market) + '&languages=' + encodeURIComponent(locale) + '&alternateId=PackageFamilyName';
 }
 function resolveGetTrackIdURL(bundleId) {
     return 'https://itunes.apple.com/lookup?bundleId=' + encodeURIComponent(bundleId);
@@ -1746,12 +1783,12 @@ function parseGetTrackIdResponse(response) {
         return undefined;
     return '' + result.trackId;
 }
-function getProductId(packageFamilyName) {
+function getProductId(packageFamilyName, language, country) {
     var cache = idCache.get(PRODUCT_ID, packageFamilyName);
     if (typeof cache !== 'undefined')
         return cache;
     try {
-        var productId = parseGetProductIdResponse(requestGet(resolveGetProductIdURL(packageFamilyName)));
+        var productId = parseGetProductIdResponse(requestGet(resolveGetProductIdURL(packageFamilyName, language, country)));
         if (typeof productId === 'undefined')
             return undefined;
         idCache.set(PRODUCT_ID, packageFamilyName, productId);
@@ -1776,12 +1813,12 @@ function getTrackId(bundleId) {
         return undefined;
     }
 }
-function getProductIdAsync(packageFamilyName) {
+function getProductIdAsync(packageFamilyName, language, country) {
     var cache = idCache.get(PRODUCT_ID, packageFamilyName);
     if (typeof cache !== 'undefined')
         return Promise.resolve(cache);
     try {
-        return requestGet(resolveGetProductIdURL(packageFamilyName), true)
+        return requestGet(resolveGetProductIdURL(packageFamilyName, language, country), true)
             .then(parseGetProductIdResponse)
             .then(function (productId) {
             if (typeof productId === 'undefined')
@@ -1896,6 +1933,7 @@ var MACOS_DEFAULT_TIMEOUT = 750;
 var DEFAULT_TIMEOUT = 750;
 var GLOBAL = getGlobal$1();
 var NAVIGATOR = GLOBAL.navigator;
+var ALPHA2_REGION_PATTERN = /^[A-Z]{2}$/;
 var CLEANUP_INPUT_ELEMENT = null;
 var DEBUG = false;
 var APP_IN_FLIGHT = null;
@@ -2115,6 +2153,13 @@ function resolveFocusEventConfig() {
         };
     }
 }
+function resolveEventBinding(config) {
+    return {
+        configured: typeof config.target !== 'undefined' && typeof config.type !== 'undefined',
+        target: config.target,
+        type: config.type,
+    };
+}
 function openURL(tried, url, timeout, terminal) {
     if (terminal === void 0) { terminal = false; }
     var config = resolveFocusEventConfig();
@@ -2188,6 +2233,9 @@ function openURL(tried, url, timeout, terminal) {
     return new Promise(function (resolve, reject) {
         if (DEBUG)
             debugger;
+        var blurBinding = resolveEventBinding(config.blur);
+        var focusBinding = resolveEventBinding(config.focus);
+        var visibilityBinding = resolveEventBinding(config.visibilitychange);
         var timeoutId;
         var resolved = false;
         function cleanup() {
@@ -2196,12 +2244,14 @@ function openURL(tried, url, timeout, terminal) {
                 timeoutId = undefined;
             }
             try {
-                if (typeof config.blur.target !== 'undefined' && typeof config.blur.type !== 'undefined')
-                    EventKit.remove(config.blur.target, config.blur.type, onblur);
-                if (typeof config.focus.target !== 'undefined' && typeof config.focus.type !== 'undefined')
-                    EventKit.remove(config.focus.target, config.focus.type, onfocus);
-                if (typeof config.visibilitychange.target !== 'undefined' && typeof config.visibilitychange.type !== 'undefined')
-                    EventKit.remove(config.visibilitychange.target, config.visibilitychange.type, onvisibilitychange);
+                if (blurBinding.configured)
+                    EventKit.remove(blurBinding.target, blurBinding.type, onblur);
+                if (focusBinding.configured)
+                    EventKit.remove(focusBinding.target, focusBinding.type, onfocus);
+                if (visibilityBinding.configured)
+                    EventKit.remove(visibilityBinding.target, visibilityBinding.type, onvisibilitychange);
+                if (navigationPagehide)
+                    EventKit.remove(top, 'pagehide', onpagehide);
             }
             catch (_) {
             }
@@ -2235,10 +2285,10 @@ function openURL(tried, url, timeout, terminal) {
                 clearTimeout(timeoutId);
                 timeoutId = undefined;
             }
-            if (typeof config.blur.target !== 'undefined' && typeof config.blur.type !== 'undefined')
-                EventKit.remove(config.blur.target, config.blur.type, onblur);
-            if (typeof config.focus.target !== 'undefined' && typeof config.focus.type !== 'undefined')
-                EventKit.add(config.focus.target, config.focus.type, onfocus);
+            if (blurBinding.configured)
+                EventKit.remove(blurBinding.target, blurBinding.type, onblur);
+            if (focusBinding.configured)
+                EventKit.add(focusBinding.target, focusBinding.type, onfocus);
         }
         function onfocus() {
             done(true);
@@ -2249,13 +2299,19 @@ function openURL(tried, url, timeout, terminal) {
             else
                 onfocus();
         }
+        function onpagehide() {
+            done(true);
+        }
+        var navigationPagehide = config.blur.type !== 'pagehide';
         timeoutId = setTimeout(function () {
             done(false);
         }, timeout);
-        if (typeof config.blur.target !== 'undefined' && typeof config.blur.type !== 'undefined')
-            EventKit.add(config.blur.target, config.blur.type, onblur);
-        if (typeof config.visibilitychange.target !== 'undefined' && typeof config.visibilitychange.type !== 'undefined')
-            EventKit.add(config.visibilitychange.target, config.visibilitychange.type, onvisibilitychange);
+        if (blurBinding.configured)
+            EventKit.add(blurBinding.target, blurBinding.type, onblur);
+        if (visibilityBinding.configured)
+            EventKit.add(visibilityBinding.target, visibilityBinding.type, onvisibilitychange);
+        if (navigationPagehide)
+            EventKit.add(top, 'pagehide', onpagehide);
         if (!hasFocus(topDocument))
             restoreFocus();
         try {
@@ -2345,6 +2401,8 @@ function resolveOptions(option) {
     var allowScheme;
     var assumeAllowedInApp;
     var timeout;
+    var language;
+    var country;
     var intent;
     var packageName;
     var allowIntent = true;
@@ -2367,6 +2425,8 @@ function resolveOptions(option) {
             allowWebStore = option.android.allowWebStore;
             allowScheme = canOpenScheme(assumeAllowedInApp);
             timeout = option.android.timeout;
+            language = option.android.language;
+            country = option.android.country;
             if (typeof intent !== 'undefined' && (typeof scheme === 'undefined' || typeof packageName === 'undefined' || typeof fallback === 'undefined')) {
                 var parsed = parseIntentURL(intent);
                 if (typeof parsed.scheme !== 'undefined' && typeof scheme === 'undefined')
@@ -2390,7 +2450,7 @@ function resolveOptions(option) {
                 if (allowAppStore && allowScheme)
                     resolved.push(['store', createAppStoreURL(packageName, os)]);
                 if (allowWebStore)
-                    resolved.push(['store', createWebStoreURL(packageName, os)]);
+                    resolved.push(['store', createWebStoreURL(packageName, os, language, country)]);
             }
             return [resolved, timeout];
         case 'ios':
@@ -2406,6 +2466,8 @@ function resolveOptions(option) {
             allowWebStore = option.ios.allowWebStore;
             allowScheme = canOpenScheme(assumeAllowedInApp);
             timeout = option.ios.timeout;
+            language = option.ios.language;
+            country = option.ios.country;
             if (typeof bundleId !== 'undefined' && typeof trackId === 'undefined')
                 trackId = getTrackId(bundleId);
             if (typeof timeout === 'undefined')
@@ -2420,7 +2482,7 @@ function resolveOptions(option) {
                 if (allowAppStore && allowScheme)
                     resolved.push(['store', createAppStoreURL(trackId, os)]);
                 if (allowWebStore)
-                    resolved.push(['store', createWebStoreURL(trackId, os)]);
+                    resolved.push(['store', createWebStoreURL(trackId, os, language, country)]);
             }
             return [resolved, timeout];
         case 'windows':
@@ -2433,8 +2495,10 @@ function resolveOptions(option) {
             allowAppStore = option.windows.allowAppStore;
             allowWebStore = option.windows.allowWebStore;
             timeout = option.windows.timeout;
+            language = option.windows.language;
+            country = option.windows.country;
             if (typeof packageFamilyName !== 'undefined' && typeof productId === 'undefined')
-                productId = getProductId(packageFamilyName);
+                productId = getProductId(packageFamilyName, language, country);
             if (typeof timeout === 'undefined')
                 timeout = WINDOWS_DEFAULT_TIMEOUT;
             if (typeof scheme !== 'undefined')
@@ -2445,7 +2509,7 @@ function resolveOptions(option) {
                 if (allowAppStore)
                     resolved.push(['store', createAppStoreURL(productId, os)]);
                 if (allowWebStore)
-                    resolved.push(['store', createWebStoreURL(productId, os)]);
+                    resolved.push(['store', createWebStoreURL(productId, os, language, country)]);
             }
             return [resolved, timeout];
         case 'macos':
@@ -2458,6 +2522,8 @@ function resolveOptions(option) {
             allowAppStore = option.macos.allowAppStore;
             allowWebStore = option.macos.allowWebStore;
             timeout = option.macos.timeout;
+            language = option.macos.language;
+            country = option.macos.country;
             if (typeof bundleId !== 'undefined' && typeof trackId === 'undefined')
                 trackId = getTrackId(bundleId);
             if (typeof timeout === 'undefined')
@@ -2470,7 +2536,7 @@ function resolveOptions(option) {
                 if (allowAppStore)
                     resolved.push(['store', createAppStoreURL(trackId, os)]);
                 if (allowWebStore)
-                    resolved.push(['store', createWebStoreURL(trackId, os)]);
+                    resolved.push(['store', createWebStoreURL(trackId, os, language, country)]);
             }
             return [resolved, timeout];
     }
@@ -2637,19 +2703,69 @@ function createAppStoreURL(id, os) {
             return os;
     }
 }
-function createWebStoreURL(id, os) {
+function createWebStoreURL(id, os, language, country) {
+    var resolved = resolveCountry(language, country);
+    var countryPath = typeof resolved !== 'undefined' ? resolved.toLowerCase() + '/' : '';
+    var url;
     switch (os) {
         case 'android':
-            return 'https://play.google.com/store/apps/details?id=' + id;
+            url = 'https://play.google.com/store/apps/details?id=' + id;
+            if (typeof language !== 'undefined')
+                url = appendURLParameter(url, 'hl=' + escapeURIComponentString(language));
+            if (typeof resolved !== 'undefined')
+                url = appendURLParameter(url, 'gl=' + resolved);
+            break;
         case 'ios':
-            return 'https://itunes.apple.com/app/id' + id + '?mt=8';
+            url = 'https://itunes.apple.com/' + countryPath + 'app/id' + id + '?mt=8';
+            if (typeof language !== 'undefined')
+                url = appendURLParameter(url, 'l=' + escapeURIComponentString(language));
+            break;
         case 'windows':
-            return 'https://apps.microsoft.com/detail/' + id;
+            url = 'https://apps.microsoft.com/detail/' + id;
+            if (typeof language !== 'undefined')
+                url = appendURLParameter(url, 'hl=' + escapeURIComponentString(language));
+            if (typeof resolved !== 'undefined')
+                url = appendURLParameter(url, 'gl=' + resolved);
+            break;
         case 'macos':
-            return 'https://apps.apple.com/app/id' + id + '?mt=12';
+            url = 'https://apps.apple.com/' + countryPath + 'app/id' + id + '?mt=12';
+            if (typeof language !== 'undefined')
+                url = appendURLParameter(url, 'l=' + escapeURIComponentString(language));
+            break;
         default:
             return os;
     }
+    return url;
+}
+function extractRegion(tag) {
+    var parts = tag.replace(/_/g, '-').split('-');
+    for (var i = 1; i < parts.length; i++) {
+        if (/^[A-Za-z]{2}$/.test(parts[i]))
+            return parts[i].toUpperCase();
+    }
+    return undefined;
+}
+function resolveCountry(language, country) {
+    if (typeof country !== 'undefined' && ALPHA2_REGION_PATTERN.test(country.toUpperCase()))
+        return country.toUpperCase();
+    if (typeof language === 'undefined')
+        return undefined;
+    var region = extractRegion(language);
+    if (typeof region !== 'undefined')
+        return region;
+    if (typeof Intl !== 'undefined' && typeof Intl.Locale === 'function') {
+        try {
+            var locale = new Intl.Locale(language);
+            if (typeof locale.maximize === 'function') {
+                var maximized = locale.maximize();
+                if (typeof maximized !== 'undefined' && maximized !== null && typeof maximized.region === 'string' && ALPHA2_REGION_PATTERN.test(maximized.region.toUpperCase()))
+                    return maximized.region.toUpperCase();
+            }
+        }
+        catch (_) {
+        }
+    }
+    return undefined;
 }
 function appendURLParameter(url, parameter) {
     var index = url.indexOf('#');
@@ -2799,6 +2915,8 @@ function resolveFile(module) {
         });
     }
     function resolveInput(module, resolve) {
+        var focusBinding = resolveEventBinding(config.focus);
+        var visibilityBinding = resolveEventBinding(config.visibilitychange);
         var resolved = false;
         function done(success) {
             if (resolved)
@@ -2836,10 +2954,10 @@ function resolveFile(module) {
         }
         else {
             module.onclick = function () {
-                if (typeof config.focus.target !== 'undefined' && typeof config.focus.type !== 'undefined')
-                    EventKit.add(config.focus.target, config.focus.type, onfocus);
-                if (typeof config.visibilitychange.target !== 'undefined' && typeof config.visibilitychange.type !== 'undefined')
-                    EventKit.add(config.visibilitychange.target, config.visibilitychange.type, onvisibilitychange);
+                if (focusBinding.configured)
+                    EventKit.add(focusBinding.target, focusBinding.type, onfocus);
+                if (visibilityBinding.configured)
+                    EventKit.add(visibilityBinding.target, visibilityBinding.type, onvisibilitychange);
                 setTimeout(function () {
                     EventKit.add(topDocument, 'click', onclick);
                 }, 100);
@@ -2851,10 +2969,10 @@ function resolveFile(module) {
         function cleanup() {
             CLEANUP_INPUT_ELEMENT = null;
             try {
-                if (typeof config.focus.target !== 'undefined' && typeof config.focus.type !== 'undefined')
-                    EventKit.remove(config.focus.target, config.focus.type, onfocus);
-                if (typeof config.visibilitychange.target !== 'undefined' && typeof config.visibilitychange.type !== 'undefined')
-                    EventKit.remove(config.visibilitychange.target, config.visibilitychange.type, onvisibilitychange);
+                if (focusBinding.configured)
+                    EventKit.remove(focusBinding.target, focusBinding.type, onfocus);
+                if (visibilityBinding.configured)
+                    EventKit.remove(visibilityBinding.target, visibilityBinding.type, onvisibilitychange);
                 EventKit.remove(topDocument, 'click', onclick);
             }
             catch (_) {