@monkey-mini-app/panel 0.1.6 → 0.1.7

package/dist/index.cjs

@@ -3235,6 +3235,20 @@ function resolvePanelLocale(value) {
   }
   return value;
 }
+function localeFromLanguageTag(tag) {
+  if (tag == null) return "en";
+  const raw = String(tag).trim();
+  if (!raw) return "en";
+  const normalized = raw.replace(/_/g, "-").toLowerCase();
+  return normalized === "zh" || normalized.startsWith("zh-") ? "zh-CN" : "en";
+}
+function detectBrowserLocale(languages) {
+  const tags = languages ?? (typeof navigator !== "undefined" ? navigator.languages?.length ? [...navigator.languages] : navigator.language ? [navigator.language] : [] : []);
+  for (const tag of tags) {
+    if (tag) return localeFromLanguageTag(tag);
+  }
+  return "en";
+}
 
 // src/styles.ts
 var PANEL_CSS_TAG = "panel";
@@ -3813,6 +3827,7 @@ exports.createPanelI18n = createPanelI18n;
 exports.createRestPanelHost = createRestPanelHost;
 exports.cssVars = cssVars;
 exports.defaultHideThemePop = defaultHideThemePop;
+exports.detectBrowserLocale = detectBrowserLocale;
 exports.effectivePalette = effectivePalette;
 exports.formToHostConfigBody = formToHostConfigBody;
 exports.getPanelState = getPanelState;
@@ -3820,6 +3835,7 @@ exports.hostConfigToForm = hostConfigToForm;
 exports.hue = hue;
 exports.injectPanelCss = injectPanelCss;
 exports.isHostUnreachable = isHostUnreachable;
+exports.localeFromLanguageTag = localeFromLanguageTag;
 exports.monoOf = monoOf;
 exports.packageName = packageName;
 exports.parseAppsResponse = parseAppsResponse;

package/dist/index.d.cts

@@ -181,6 +181,13 @@ type PanelI18n = {
 /** i18next helper bound to `locale`. Missing keys throw outside production. */
 declare function createPanelI18n(locale: LocaleId): PanelI18n;
 declare function resolvePanelLocale(value: string | undefined): LocaleId;
+/**
+ * Map a BCP 47 language tag to a supported panel locale.
+ * `zh*` (case-insensitive) → `zh-CN`; anything else → `en`.
+ */
+declare function localeFromLanguageTag(tag: string | null | undefined): LocaleId;
+/** Browser locale for first paint before host.json is loaded. */
+declare function detectBrowserLocale(languages?: readonly string[] | null): LocaleId;
 
 /**
  * PanelHost — the only seam between the panel UI and a host (dsh client, demo, …).
@@ -522,4 +529,4 @@ declare function injectPanelCss(): void;
 
 declare const packageName = "@monkey-mini-app/panel";
 
-export { type AboutInfo, type AboutPackage, type AppItem, AppList, Browse, type BrowseKind, type CardStyle, type Commit, type CommitFile, type CreateMiniAppPanelOptions, type DockId, type FrameController, type FrameControllerOptions, type FrameEnv, type FrameRecord, type HostEventHandlers, type HostShellInstance, type HostShellOptions, HostUnreachableError, type I18nParams, LOCALE_IDS, ListRegion, Loading, type LocaleId, MiniAppPanel, Modal, PANEL_CSS_TAG, type Palette, type PanelActions, type PanelCapabilities, PanelError, type PanelHost, type PanelI18n, type PanelInstance, PanelProvider, type PanelState, type RestOptions, Settings, type StorageNotice, type StorageTable, type TabItem, type TabKind, Tabs, ThemePop, type ThemeScope, TokenSet, Toolbar, type UpdateCheck, type UpdateCheckState, type ViewEvalAnswer, type ViewEvalQuery, activeAppFrom, appBlurb, appFrameUrl, capabilitiesOf, clampPaletteId, createFrameController, createHostShell, createMiniAppPanel, createPanelActions, createPanelI18n, createRestPanelHost, defaultHideThemePop, formToHostConfigBody, getPanelState, hostConfigToForm, hue, injectPanelCss, isHostUnreachable, monoOf, packageName, parseAppsResponse, parseCommitDetail, parseCommitList, parsePalettes, parseStorageTables, readJson, relayViewEval, resetPanelState, resolvePanelLocale, setPanelState, subscribeHostEvents, subscribePanel, usePanelActions, usePanelI18n, usePanelState };
+export { type AboutInfo, type AboutPackage, type AppItem, AppList, Browse, type BrowseKind, type CardStyle, type Commit, type CommitFile, type CreateMiniAppPanelOptions, type DockId, type FrameController, type FrameControllerOptions, type FrameEnv, type FrameRecord, type HostEventHandlers, type HostShellInstance, type HostShellOptions, HostUnreachableError, type I18nParams, LOCALE_IDS, ListRegion, Loading, type LocaleId, MiniAppPanel, Modal, PANEL_CSS_TAG, type Palette, type PanelActions, type PanelCapabilities, PanelError, type PanelHost, type PanelI18n, type PanelInstance, PanelProvider, type PanelState, type RestOptions, Settings, type StorageNotice, type StorageTable, type TabItem, type TabKind, Tabs, ThemePop, type ThemeScope, TokenSet, Toolbar, type UpdateCheck, type UpdateCheckState, type ViewEvalAnswer, type ViewEvalQuery, activeAppFrom, appBlurb, appFrameUrl, capabilitiesOf, clampPaletteId, createFrameController, createHostShell, createMiniAppPanel, createPanelActions, createPanelI18n, createRestPanelHost, defaultHideThemePop, detectBrowserLocale, formToHostConfigBody, getPanelState, hostConfigToForm, hue, injectPanelCss, isHostUnreachable, localeFromLanguageTag, monoOf, packageName, parseAppsResponse, parseCommitDetail, parseCommitList, parsePalettes, parseStorageTables, readJson, relayViewEval, resetPanelState, resolvePanelLocale, setPanelState, subscribeHostEvents, subscribePanel, usePanelActions, usePanelI18n, usePanelState };

package/dist/index.d.ts

@@ -181,6 +181,13 @@ type PanelI18n = {
 /** i18next helper bound to `locale`. Missing keys throw outside production. */
 declare function createPanelI18n(locale: LocaleId): PanelI18n;
 declare function resolvePanelLocale(value: string | undefined): LocaleId;
+/**
+ * Map a BCP 47 language tag to a supported panel locale.
+ * `zh*` (case-insensitive) → `zh-CN`; anything else → `en`.
+ */
+declare function localeFromLanguageTag(tag: string | null | undefined): LocaleId;
+/** Browser locale for first paint before host.json is loaded. */
+declare function detectBrowserLocale(languages?: readonly string[] | null): LocaleId;
 
 /**
  * PanelHost — the only seam between the panel UI and a host (dsh client, demo, …).
@@ -522,4 +529,4 @@ declare function injectPanelCss(): void;
 
 declare const packageName = "@monkey-mini-app/panel";
 
-export { type AboutInfo, type AboutPackage, type AppItem, AppList, Browse, type BrowseKind, type CardStyle, type Commit, type CommitFile, type CreateMiniAppPanelOptions, type DockId, type FrameController, type FrameControllerOptions, type FrameEnv, type FrameRecord, type HostEventHandlers, type HostShellInstance, type HostShellOptions, HostUnreachableError, type I18nParams, LOCALE_IDS, ListRegion, Loading, type LocaleId, MiniAppPanel, Modal, PANEL_CSS_TAG, type Palette, type PanelActions, type PanelCapabilities, PanelError, type PanelHost, type PanelI18n, type PanelInstance, PanelProvider, type PanelState, type RestOptions, Settings, type StorageNotice, type StorageTable, type TabItem, type TabKind, Tabs, ThemePop, type ThemeScope, TokenSet, Toolbar, type UpdateCheck, type UpdateCheckState, type ViewEvalAnswer, type ViewEvalQuery, activeAppFrom, appBlurb, appFrameUrl, capabilitiesOf, clampPaletteId, createFrameController, createHostShell, createMiniAppPanel, createPanelActions, createPanelI18n, createRestPanelHost, defaultHideThemePop, formToHostConfigBody, getPanelState, hostConfigToForm, hue, injectPanelCss, isHostUnreachable, monoOf, packageName, parseAppsResponse, parseCommitDetail, parseCommitList, parsePalettes, parseStorageTables, readJson, relayViewEval, resetPanelState, resolvePanelLocale, setPanelState, subscribeHostEvents, subscribePanel, usePanelActions, usePanelI18n, usePanelState };
+export { type AboutInfo, type AboutPackage, type AppItem, AppList, Browse, type BrowseKind, type CardStyle, type Commit, type CommitFile, type CreateMiniAppPanelOptions, type DockId, type FrameController, type FrameControllerOptions, type FrameEnv, type FrameRecord, type HostEventHandlers, type HostShellInstance, type HostShellOptions, HostUnreachableError, type I18nParams, LOCALE_IDS, ListRegion, Loading, type LocaleId, MiniAppPanel, Modal, PANEL_CSS_TAG, type Palette, type PanelActions, type PanelCapabilities, PanelError, type PanelHost, type PanelI18n, type PanelInstance, PanelProvider, type PanelState, type RestOptions, Settings, type StorageNotice, type StorageTable, type TabItem, type TabKind, Tabs, ThemePop, type ThemeScope, TokenSet, Toolbar, type UpdateCheck, type UpdateCheckState, type ViewEvalAnswer, type ViewEvalQuery, activeAppFrom, appBlurb, appFrameUrl, capabilitiesOf, clampPaletteId, createFrameController, createHostShell, createMiniAppPanel, createPanelActions, createPanelI18n, createRestPanelHost, defaultHideThemePop, detectBrowserLocale, formToHostConfigBody, getPanelState, hostConfigToForm, hue, injectPanelCss, isHostUnreachable, localeFromLanguageTag, monoOf, packageName, parseAppsResponse, parseCommitDetail, parseCommitList, parsePalettes, parseStorageTables, readJson, relayViewEval, resetPanelState, resolvePanelLocale, setPanelState, subscribeHostEvents, subscribePanel, usePanelActions, usePanelI18n, usePanelState };

package/dist/index.js

@@ -2658,6 +2658,20 @@ function resolvePanelLocale(value) {
   }
   return value;
 }
+function localeFromLanguageTag(tag) {
+  if (tag == null) return "en";
+  const raw = String(tag).trim();
+  if (!raw) return "en";
+  const normalized = raw.replace(/_/g, "-").toLowerCase();
+  return normalized === "zh" || normalized.startsWith("zh-") ? "zh-CN" : "en";
+}
+function detectBrowserLocale(languages) {
+  const tags = languages ?? (typeof navigator !== "undefined" ? navigator.languages?.length ? [...navigator.languages] : navigator.language ? [navigator.language] : [] : []);
+  for (const tag of tags) {
+    if (tag) return localeFromLanguageTag(tag);
+  }
+  return "en";
+}
 
 // src/styles.ts
 var PANEL_CSS_TAG = "panel";
@@ -3202,4 +3216,4 @@ function createHostShell(opts) {
 // src/index.ts
 var packageName = "@monkey-mini-app/panel";
 
-export { AppList, Browse, HostUnreachableError, LOCALE_IDS, ListRegion, Loading, MiniAppPanel, Modal, PANEL_CSS_TAG, PanelError, PanelProvider, Settings, Tabs, ThemePop, Toolbar, activeAppFrom, appBlurb, appFrameUrl, capabilitiesOf, clampPaletteId, createFrameController, createHostShell, createMiniAppPanel, createPanelActions, createPanelI18n, createRestPanelHost, defaultHideThemePop, formToHostConfigBody, getPanelState, hostConfigToForm, hue, injectPanelCss, isHostUnreachable, monoOf, packageName, parseAppsResponse, parseCommitDetail, parseCommitList, parsePalettes, parseStorageTables, readJson, relayViewEval, resetPanelState, resolvePanelLocale, setPanelState, subscribeHostEvents, subscribePanel, usePanelActions, usePanelI18n, usePanelState };
+export { AppList, Browse, HostUnreachableError, LOCALE_IDS, ListRegion, Loading, MiniAppPanel, Modal, PANEL_CSS_TAG, PanelError, PanelProvider, Settings, Tabs, ThemePop, Toolbar, activeAppFrom, appBlurb, appFrameUrl, capabilitiesOf, clampPaletteId, createFrameController, createHostShell, createMiniAppPanel, createPanelActions, createPanelI18n, createRestPanelHost, defaultHideThemePop, detectBrowserLocale, formToHostConfigBody, getPanelState, hostConfigToForm, hue, injectPanelCss, isHostUnreachable, localeFromLanguageTag, monoOf, packageName, parseAppsResponse, parseCommitDetail, parseCommitList, parsePalettes, parseStorageTables, readJson, relayViewEval, resetPanelState, resolvePanelLocale, setPanelState, subscribeHostEvents, subscribePanel, usePanelActions, usePanelI18n, usePanelState };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@monkey-mini-app/panel",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",