@open-pioneer/runtime 4.7.0-dev.20260624141040 → 4.7.0-dev.20260713101438

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (67) hide show
  1. package/CHANGELOG.md +14 -1
  2. package/CustomElement.d.ts +27 -2
  3. package/CustomElement.js.map +1 -1
  4. package/_virtual/source-info.js +2 -2
  5. package/api.d.ts +55 -2
  6. package/app/AppInstance.d.ts +3 -27
  7. package/app/AppInstance.js +144 -119
  8. package/app/AppInstance.js.map +1 -1
  9. package/app/gatherConfig.js +1 -0
  10. package/app/gatherConfig.js.map +1 -1
  11. package/builtin-services/ApiServiceImpl.d.ts +1 -1
  12. package/builtin-services/ApiServiceImpl.js +3 -3
  13. package/builtin-services/ApiServiceImpl.js.map +1 -1
  14. package/builtin-services/ApplicationContextImpl.d.ts +11 -7
  15. package/builtin-services/ApplicationContextImpl.js +51 -10
  16. package/builtin-services/ApplicationContextImpl.js.map +1 -1
  17. package/builtin-services/LocaleServiceImpl.d.ts +18 -0
  18. package/builtin-services/LocaleServiceImpl.js +29 -0
  19. package/builtin-services/LocaleServiceImpl.js.map +1 -0
  20. package/builtin-services/NumberParserServiceImpl.d.ts +8 -3
  21. package/builtin-services/NumberParserServiceImpl.js +17 -12
  22. package/builtin-services/NumberParserServiceImpl.js.map +1 -1
  23. package/builtin-services/index.d.ts +3 -1
  24. package/builtin-services/index.js +34 -4
  25. package/builtin-services/index.js.map +1 -1
  26. package/dom/index.d.ts +1 -1
  27. package/dom/index.js +1 -4
  28. package/dom/index.js.map +1 -1
  29. package/i18n/AppIntl.d.ts +49 -11
  30. package/i18n/AppIntl.js +205 -87
  31. package/i18n/AppIntl.js.map +1 -1
  32. package/i18n/index.d.ts +3 -2
  33. package/i18n/index.js +2 -1
  34. package/i18n/index.js.map +1 -1
  35. package/i18n/intl-locale.d.ts +13 -0
  36. package/i18n/intl-locale.js +17 -0
  37. package/i18n/intl-locale.js.map +1 -0
  38. package/i18n/pick.d.ts +29 -16
  39. package/i18n/pick.js +78 -51
  40. package/i18n/pick.js.map +1 -1
  41. package/index.d.ts +1 -1
  42. package/index.js +6 -0
  43. package/index.js.map +1 -1
  44. package/package.json +6 -5
  45. package/react-integration/ChakraProvider.d.ts +1 -1
  46. package/react-integration/ChakraProvider.js +3 -2
  47. package/react-integration/ChakraProvider.js.map +1 -1
  48. package/react-integration/PackageContext.d.ts +1 -1
  49. package/react-integration/PackageContext.js.map +1 -1
  50. package/react-integration/ReactIntegration.d.ts +2 -10
  51. package/react-integration/ReactIntegration.js +28 -28
  52. package/react-integration/ReactIntegration.js.map +1 -1
  53. package/react-integration/hooks.js +5 -9
  54. package/react-integration/hooks.js.map +1 -1
  55. package/service-layer/ServiceLayer.d.ts +1 -20
  56. package/service-layer/ServiceLayer.js +39 -39
  57. package/service-layer/ServiceLayer.js.map +1 -1
  58. package/service-layer/ServiceLookup.d.ts +1 -3
  59. package/service-layer/ServiceLookup.js +10 -10
  60. package/service-layer/ServiceLookup.js.map +1 -1
  61. package/service-layer/ServiceRepr.d.ts +2 -11
  62. package/service-layer/ServiceRepr.js +68 -50
  63. package/service-layer/ServiceRepr.js.map +1 -1
  64. package/service-layer/verifyDependencies.js +33 -33
  65. package/service-layer/verifyDependencies.js.map +1 -1
  66. package/test-support/index.js +2 -1
  67. package/test-support/index.js.map +1 -1
package/i18n/pick.js CHANGED
@@ -1,70 +1,97 @@
1
- import { createLogger, Error } from '@open-pioneer/core';
2
- import { sourceId } from '../_virtual/source-info.js';
1
+ import { match } from '@formatjs/intl-localematcher';
2
+ import { Error } from '@open-pioneer/core';
3
3
  import { ErrorId } from '../errors.js';
4
+ import { tryParseLocale, parseLocale } from './intl-locale.js';
4
5
 
5
- const LOG = createLogger(sourceId);
6
- class I18nConfig {
7
- appLocales;
6
+ const NO_MATCH_SENTINEL = "qaa-x-no-match";
7
+ const LOCALE_FIELDS = ["language", "script", "region"];
8
+ class LocalePicker {
9
+ #supportedLocales;
10
+ #supportedTags;
8
11
  /**
9
- * @param appLocales Locales the app has i18n messages for (e.g. "en", "de")
12
+ * @param supportedLocales Locales the app has i18n messages for (e.g. `"en"`, `"de"`, `"de-CH"`).
13
+ * May be empty; in that case the picker behaves as if a single `"en"`
14
+ * supported locale were configured.
10
15
  */
11
- constructor(appLocales) {
12
- this.appLocales = appLocales;
16
+ constructor(supportedLocales) {
17
+ this.#supportedLocales = supportedLocales.length > 0 ? supportedLocales : [parseLocale("en")];
18
+ this.#supportedTags = this.#supportedLocales.map((l) => l.baseName);
13
19
  }
14
20
  /**
15
- * @param forcedLocale Optional forced locale (must be satisfied)
16
- * @param userLocales Locales requested by the user's browser
21
+ * Picks the locale to use during application startup or for a runtime locale switch.
22
+ *
23
+ * @param preferredLocale Optional preferred (forced) locale.
24
+ * @param userLocales Locales requested by the user's browser, in priority order.
17
25
  */
18
- pickSupportedLocale(forcedLocale, userLocales) {
19
- const { appLocales } = this;
20
- if (forcedLocale) {
21
- const result = this.pickImpl([forcedLocale]);
22
- if (!result) {
23
- const localesList = appLocales.join(", ");
24
- throw new Error(
25
- ErrorId.UNSUPPORTED_LOCALE,
26
- `Locale '${forcedLocale}' cannot be forced because it is not supported by the application. Supported locales are ${localesList}.`
27
- );
28
- }
29
- if (result.locale !== result.messageLocale) {
30
- LOG.warn(
31
- `Non-exact match for forced locale '${forcedLocale}': using messages from '${result.messageLocale}'.`
32
- );
33
- }
34
- return result;
35
- }
36
- const supportedLocale = this.pickImpl(userLocales);
37
- if (supportedLocale) {
38
- return supportedLocale;
39
- }
40
- return {
41
- locale: userLocales[0] ?? "en",
42
- messageLocale: appLocales[0] ?? "en"
43
- };
26
+ pickSupportedLocale(preferredLocale, userLocales) {
27
+ const messageLocale = this.#pickMessageLocale(preferredLocale, userLocales);
28
+ const base = preferredLocale ?? messageLocale;
29
+ const locale = this.#pickFormattingLocale(base, userLocales);
30
+ return { locale, messageLocale };
44
31
  }
32
+ /**
33
+ * Returns `true` if the given locale is accepted by
34
+ * {@link pickSupportedLocale}.
35
+ */
45
36
  supportsLocale(locale) {
46
- return this.pickImpl([locale]) != null;
37
+ return bestFit([locale.baseName], this.#supportedTags) !== NO_MATCH_SENTINEL;
47
38
  }
48
- pickImpl(requestedLocales) {
49
- const appLocales = this.appLocales;
50
- for (const requestedLocale of requestedLocales) {
51
- if (appLocales.includes(requestedLocale)) {
52
- return { messageLocale: requestedLocale, locale: requestedLocale };
53
- }
54
- const plainLanguage = requestedLocale.match(/^([a-z]+)/i)?.[1];
55
- if (plainLanguage && appLocales.includes(plainLanguage)) {
56
- return { messageLocale: plainLanguage, locale: requestedLocale };
39
+ #pickMessageLocale(preferred, browserLocales) {
40
+ const candidates = preferred ? [preferred] : browserLocales;
41
+ const firstSupported = this.#supportedLocales[0];
42
+ if (candidates.length === 0) {
43
+ return firstSupported;
44
+ }
45
+ const match = bestFit(
46
+ candidates.map((l) => l.baseName),
47
+ this.#supportedTags
48
+ );
49
+ if (match !== NO_MATCH_SENTINEL) {
50
+ return parseLocale(match);
51
+ }
52
+ if (preferred) {
53
+ throw new Error(
54
+ ErrorId.UNSUPPORTED_LOCALE,
55
+ `Unsupported locale '${preferred.baseName}' (supported locales: ${this.#supportedTags.join(", ")}).`
56
+ );
57
+ }
58
+ return firstSupported;
59
+ }
60
+ #pickFormattingLocale(base, userLocales) {
61
+ let candidate = base;
62
+ let bestScore = equalityScore(candidate, base);
63
+ for (const userLocale of userLocales) {
64
+ const score = equalityScore(userLocale, base);
65
+ if (score > bestScore) {
66
+ candidate = userLocale;
67
+ bestScore = score;
57
68
  }
58
69
  }
59
- return void 0;
70
+ return candidate;
60
71
  }
61
72
  }
73
+ function equalityScore(candidate, base) {
74
+ let score = 0;
75
+ for (const field of LOCALE_FIELDS) {
76
+ const b = base[field];
77
+ const c = candidate[field];
78
+ if (b && c !== b) return 0;
79
+ if (c) score++;
80
+ }
81
+ return score;
82
+ }
83
+ function bestFit(tags, supportedTags) {
84
+ return match(tags, supportedTags, NO_MATCH_SENTINEL, {
85
+ algorithm: "best fit"
86
+ });
87
+ }
62
88
  function getBrowserLocales() {
63
- if (window.navigator.languages && window.navigator.languages.length) {
64
- return Array.from(window.navigator.languages);
89
+ if (typeof window === "undefined") {
90
+ return [];
65
91
  }
66
- return [window.navigator.language];
92
+ const tags = window.navigator.languages?.length ? window.navigator.languages : [window.navigator.language];
93
+ return tags.map(tryParseLocale).filter((l) => !!l);
67
94
  }
68
95
 
69
- export { I18nConfig, getBrowserLocales };
96
+ export { LocalePicker, getBrowserLocales };
70
97
  //# sourceMappingURL=pick.js.map
package/i18n/pick.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"pick.js","sources":["pick.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2023-2025 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nimport { createLogger, Error } from \"@open-pioneer/core\";\nimport { sourceId } from \"open-pioneer:source-info\";\nimport { ErrorId } from \"../errors\";\nconst LOG = createLogger(sourceId);\n\nexport interface LocalePickResult {\n /**\n * The actual locale (e.g. en-US) for number and date formatting etc.\n */\n locale: string;\n\n /**\n * The locale identifier to load messages for. E.g. \"en\".\n */\n messageLocale: string;\n}\n\n/**\n * Picks a locale for the app.\n */\nexport class I18nConfig {\n private appLocales: string[];\n\n /**\n * @param appLocales Locales the app has i18n messages for (e.g. \"en\", \"de\")\n */\n constructor(appLocales: string[]) {\n this.appLocales = appLocales;\n }\n\n /**\n * @param forcedLocale Optional forced locale (must be satisfied)\n * @param userLocales Locales requested by the user's browser\n */\n pickSupportedLocale(forcedLocale: string | undefined, userLocales: string[]): LocalePickResult {\n const { appLocales } = this;\n // Attempt to satisfy forced locale\n if (forcedLocale) {\n const result = this.pickImpl([forcedLocale]);\n if (!result) {\n const localesList = appLocales.join(\", \");\n throw new Error(\n ErrorId.UNSUPPORTED_LOCALE,\n `Locale '${forcedLocale}' cannot be forced because it is not supported by the application.` +\n ` Supported locales are ${localesList}.`\n );\n }\n if (result.locale !== result.messageLocale) {\n LOG.warn(\n `Non-exact match for forced locale '${forcedLocale}': using messages from '${result.messageLocale}'.`\n );\n }\n return result;\n }\n\n // Match preferred locale\n const supportedLocale = this.pickImpl(userLocales);\n if (supportedLocale) {\n return supportedLocale;\n }\n\n // Fallback: Most preferred locale (for dates etc.), but some of our messages\n return {\n locale: userLocales[0] ?? \"en\",\n messageLocale: appLocales[0] ?? \"en\"\n };\n }\n\n supportsLocale(locale: string): boolean {\n return this.pickImpl([locale]) != null;\n }\n\n private pickImpl(requestedLocales: string[]) {\n const appLocales = this.appLocales;\n for (const requestedLocale of requestedLocales) {\n // try exact match\n if (appLocales.includes(requestedLocale)) {\n return { messageLocale: requestedLocale, locale: requestedLocale };\n }\n\n // try plain language tag (e.g. \"en\") as fallback\n const plainLanguage = requestedLocale.match(/^([a-z]+)/i)?.[1];\n if (plainLanguage && appLocales.includes(plainLanguage)) {\n return { messageLocale: plainLanguage, locale: requestedLocale };\n }\n }\n return undefined;\n }\n}\n\n/**\n * Returns locales supported by the browser, in order of preference (preferred first).\n *\n * See also https://developer.mozilla.org/en-US/docs/Web/API/Navigator/languages\n */\nexport function getBrowserLocales(): string[] {\n if (window.navigator.languages && window.navigator.languages.length) {\n return Array.from(window.navigator.languages);\n }\n return [window.navigator.language];\n}\n"],"names":[],"mappings":";;;;AAKA,MAAM,GAAA,GAAM,aAAa,QAAQ,CAAA;AAiB1B,MAAM,UAAA,CAAW;AAAA,EACZ,UAAA;AAAA;AAAA;AAAA;AAAA,EAKR,YAAY,UAAA,EAAsB;AAC9B,IAAA,IAAA,CAAK,UAAA,GAAa,UAAA;AAAA,EACtB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,mBAAA,CAAoB,cAAkC,WAAA,EAAyC;AAC3F,IAAA,MAAM,EAAE,YAAW,GAAI,IAAA;AAEvB,IAAA,IAAI,YAAA,EAAc;AACd,MAAA,MAAM,MAAA,GAAS,IAAA,CAAK,QAAA,CAAS,CAAC,YAAY,CAAC,CAAA;AAC3C,MAAA,IAAI,CAAC,MAAA,EAAQ;AACT,QAAA,MAAM,WAAA,GAAc,UAAA,CAAW,IAAA,CAAK,IAAI,CAAA;AACxC,QAAA,MAAM,IAAI,KAAA;AAAA,UACN,OAAA,CAAQ,kBAAA;AAAA,UACR,CAAA,QAAA,EAAW,YAAY,CAAA,yFAAA,EACO,WAAW,CAAA,CAAA;AAAA,SAC7C;AAAA,MACJ;AACA,MAAA,IAAI,MAAA,CAAO,MAAA,KAAW,MAAA,CAAO,aAAA,EAAe;AACxC,QAAA,GAAA,CAAI,IAAA;AAAA,UACA,CAAA,mCAAA,EAAsC,YAAY,CAAA,wBAAA,EAA2B,MAAA,CAAO,aAAa,CAAA,EAAA;AAAA,SACrG;AAAA,MACJ;AACA,MAAA,OAAO,MAAA;AAAA,IACX;AAGA,IAAA,MAAM,eAAA,GAAkB,IAAA,CAAK,QAAA,CAAS,WAAW,CAAA;AACjD,IAAA,IAAI,eAAA,EAAiB;AACjB,MAAA,OAAO,eAAA;AAAA,IACX;AAGA,IAAA,OAAO;AAAA,MACH,MAAA,EAAQ,WAAA,CAAY,CAAC,CAAA,IAAK,IAAA;AAAA,MAC1B,aAAA,EAAe,UAAA,CAAW,CAAC,CAAA,IAAK;AAAA,KACpC;AAAA,EACJ;AAAA,EAEA,eAAe,MAAA,EAAyB;AACpC,IAAA,OAAO,IAAA,CAAK,QAAA,CAAS,CAAC,MAAM,CAAC,CAAA,IAAK,IAAA;AAAA,EACtC;AAAA,EAEQ,SAAS,gBAAA,EAA4B;AACzC,IAAA,MAAM,aAAa,IAAA,CAAK,UAAA;AACxB,IAAA,KAAA,MAAW,mBAAmB,gBAAA,EAAkB;AAE5C,MAAA,IAAI,UAAA,CAAW,QAAA,CAAS,eAAe,CAAA,EAAG;AACtC,QAAA,OAAO,EAAE,aAAA,EAAe,eAAA,EAAiB,MAAA,EAAQ,eAAA,EAAgB;AAAA,MACrE;AAGA,MAAA,MAAM,aAAA,GAAgB,eAAA,CAAgB,KAAA,CAAM,YAAY,IAAI,CAAC,CAAA;AAC7D,MAAA,IAAI,aAAA,IAAiB,UAAA,CAAW,QAAA,CAAS,aAAa,CAAA,EAAG;AACrD,QAAA,OAAO,EAAE,aAAA,EAAe,aAAA,EAAe,MAAA,EAAQ,eAAA,EAAgB;AAAA,MACnE;AAAA,IACJ;AACA,IAAA,OAAO,MAAA;AAAA,EACX;AACJ;AAOO,SAAS,iBAAA,GAA8B;AAC1C,EAAA,IAAI,OAAO,SAAA,CAAU,SAAA,IAAa,MAAA,CAAO,SAAA,CAAU,UAAU,MAAA,EAAQ;AACjE,IAAA,OAAO,KAAA,CAAM,IAAA,CAAK,MAAA,CAAO,SAAA,CAAU,SAAS,CAAA;AAAA,EAChD;AACA,EAAA,OAAO,CAAC,MAAA,CAAO,SAAA,CAAU,QAAQ,CAAA;AACrC;;;;"}
1
+ {"version":3,"file":"pick.js","sources":["pick.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2023-2025 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nimport { match as bestFitMatch } from \"@formatjs/intl-localematcher\";\nimport { Error } from \"@open-pioneer/core\";\nimport { ErrorId } from \"../errors\";\nimport { parseLocale, tryParseLocale } from \"./intl-locale\";\n\nconst NO_MATCH_SENTINEL = \"qaa-x-no-match\";\n\nconst LOCALE_FIELDS = [\"language\", \"script\", \"region\"] as const;\n\n/**\n * Result of {@link LocalePicker.pickSupportedLocale}.\n */\nexport interface LocalePickResult {\n /**\n * The actual locale (e.g. `de-DE`) used for number/date formatting.\n */\n locale: Intl.Locale;\n\n /**\n * The locale of the matched message bundle (e.g. `de`).\n */\n messageLocale: Intl.Locale;\n}\n\n/**\n * Picks a locale for an application based on the locales it supports\n * and the locales requested by a user.\n */\nexport class LocalePicker {\n #supportedLocales: readonly Intl.Locale[];\n #supportedTags: readonly string[];\n\n /**\n * @param supportedLocales Locales the app has i18n messages for (e.g. `\"en\"`, `\"de\"`, `\"de-CH\"`).\n * May be empty; in that case the picker behaves as if a single `\"en\"`\n * supported locale were configured.\n */\n constructor(supportedLocales: ReadonlyArray<Intl.Locale>) {\n this.#supportedLocales =\n supportedLocales.length > 0 ? supportedLocales : [parseLocale(\"en\")];\n this.#supportedTags = this.#supportedLocales.map((l) => l.baseName);\n }\n\n /**\n * Picks the locale to use during application startup or for a runtime locale switch.\n *\n * @param preferredLocale Optional preferred (forced) locale.\n * @param userLocales Locales requested by the user's browser, in priority order.\n */\n pickSupportedLocale(\n preferredLocale: Intl.Locale | undefined,\n userLocales: Intl.Locale[]\n ): LocalePickResult {\n const messageLocale = this.#pickMessageLocale(preferredLocale, userLocales);\n const base = preferredLocale ?? messageLocale;\n const locale = this.#pickFormattingLocale(base, userLocales);\n return { locale, messageLocale };\n }\n\n /**\n * Returns `true` if the given locale is accepted by\n * {@link pickSupportedLocale}.\n */\n supportsLocale(locale: Intl.Locale): boolean {\n return bestFit([locale.baseName], this.#supportedTags) !== NO_MATCH_SENTINEL;\n }\n\n #pickMessageLocale(\n preferred: Intl.Locale | undefined,\n browserLocales: Intl.Locale[]\n ): Intl.Locale {\n const candidates = preferred ? [preferred] : browserLocales;\n // #supportedLocales is guaranteed non-empty (see constructor).\n // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n const firstSupported = this.#supportedLocales[0]!;\n if (candidates.length === 0) {\n return firstSupported;\n }\n\n const match = bestFit(\n candidates.map((l) => l.baseName),\n this.#supportedTags\n );\n if (match !== NO_MATCH_SENTINEL) {\n return parseLocale(match);\n }\n if (preferred) {\n throw new Error(\n ErrorId.UNSUPPORTED_LOCALE,\n `Unsupported locale '${preferred.baseName}' (supported locales: ${this.#supportedTags.join(\", \")}).`\n );\n }\n return firstSupported;\n }\n\n #pickFormattingLocale(base: Intl.Locale, userLocales: Intl.Locale[]): Intl.Locale {\n let candidate = base;\n let bestScore = equalityScore(candidate, base);\n // try to find a more specific locale from the user's browser locales\n for (const userLocale of userLocales) {\n const score = equalityScore(userLocale, base);\n if (score > bestScore) {\n candidate = userLocale;\n bestScore = score;\n }\n }\n return candidate;\n }\n}\n\n// Higher score means the candidate shares more fields with the base locale\n// without contradicting any field defined on the base.\nfunction equalityScore(candidate: Intl.Locale, base: Intl.Locale): number {\n let score = 0;\n for (const field of LOCALE_FIELDS) {\n const b = base[field];\n const c = candidate[field];\n if (b && c !== b) return 0;\n if (c) score++;\n }\n return score;\n}\n\n/**\n * Runs the CLDR best-fit matcher and returns either a supported tag or\n * {@link NO_MATCH_SENTINEL} when no real match exists.\n */\nfunction bestFit(tags: readonly string[], supportedTags: readonly string[]): string {\n return bestFitMatch(tags, supportedTags, NO_MATCH_SENTINEL, {\n algorithm: \"best fit\"\n });\n}\n\n/**\n * Returns the locales currently preferred by the user's browser, in order of preference.\n *\n * See also https://developer.mozilla.org/en-US/docs/Web/API/Navigator/languages\n *\n * Invalid entries (which should not occur in practice) are silently dropped.\n */\nexport function getBrowserLocales(): Intl.Locale[] {\n if (typeof window === \"undefined\") {\n return [];\n }\n const tags = window.navigator.languages?.length\n ? window.navigator.languages\n : [window.navigator.language];\n return tags.map(tryParseLocale).filter((l) => !!l);\n}\n"],"names":["bestFitMatch"],"mappings":";;;;;AAOA,MAAM,iBAAA,GAAoB,gBAAA;AAE1B,MAAM,aAAA,GAAgB,CAAC,UAAA,EAAY,QAAA,EAAU,QAAQ,CAAA;AAqB9C,MAAM,YAAA,CAAa;AAAA,EACtB,iBAAA;AAAA,EACA,cAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,YAAY,gBAAA,EAA8C;AACtD,IAAA,IAAA,CAAK,iBAAA,GACD,iBAAiB,MAAA,GAAS,CAAA,GAAI,mBAAmB,CAAC,WAAA,CAAY,IAAI,CAAC,CAAA;AACvE,IAAA,IAAA,CAAK,iBAAiB,IAAA,CAAK,iBAAA,CAAkB,IAAI,CAAC,CAAA,KAAM,EAAE,QAAQ,CAAA;AAAA,EACtE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,mBAAA,CACI,iBACA,WAAA,EACgB;AAChB,IAAA,MAAM,aAAA,GAAgB,IAAA,CAAK,kBAAA,CAAmB,eAAA,EAAiB,WAAW,CAAA;AAC1E,IAAA,MAAM,OAAO,eAAA,IAAmB,aAAA;AAChC,IAAA,MAAM,MAAA,GAAS,IAAA,CAAK,qBAAA,CAAsB,IAAA,EAAM,WAAW,CAAA;AAC3D,IAAA,OAAO,EAAE,QAAQ,aAAA,EAAc;AAAA,EACnC;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,eAAe,MAAA,EAA8B;AACzC,IAAA,OAAO,QAAQ,CAAC,MAAA,CAAO,QAAQ,CAAA,EAAG,IAAA,CAAK,cAAc,CAAA,KAAM,iBAAA;AAAA,EAC/D;AAAA,EAEA,kBAAA,CACI,WACA,cAAA,EACW;AACX,IAAA,MAAM,UAAA,GAAa,SAAA,GAAY,CAAC,SAAS,CAAA,GAAI,cAAA;AAG7C,IAAA,MAAM,cAAA,GAAiB,IAAA,CAAK,iBAAA,CAAkB,CAAC,CAAA;AAC/C,IAAA,IAAI,UAAA,CAAW,WAAW,CAAA,EAAG;AACzB,MAAA,OAAO,cAAA;AAAA,IACX;AAEA,IAAA,MAAM,KAAA,GAAQ,OAAA;AAAA,MACV,UAAA,CAAW,GAAA,CAAI,CAAC,CAAA,KAAM,EAAE,QAAQ,CAAA;AAAA,MAChC,IAAA,CAAK;AAAA,KACT;AACA,IAAA,IAAI,UAAU,iBAAA,EAAmB;AAC7B,MAAA,OAAO,YAAY,KAAK,CAAA;AAAA,IAC5B;AACA,IAAA,IAAI,SAAA,EAAW;AACX,MAAA,MAAM,IAAI,KAAA;AAAA,QACN,OAAA,CAAQ,kBAAA;AAAA,QACR,CAAA,oBAAA,EAAuB,UAAU,QAAQ,CAAA,sBAAA,EAAyB,KAAK,cAAA,CAAe,IAAA,CAAK,IAAI,CAAC,CAAA,EAAA;AAAA,OACpG;AAAA,IACJ;AACA,IAAA,OAAO,cAAA;AAAA,EACX;AAAA,EAEA,qBAAA,CAAsB,MAAmB,WAAA,EAAyC;AAC9E,IAAA,IAAI,SAAA,GAAY,IAAA;AAChB,IAAA,IAAI,SAAA,GAAY,aAAA,CAAc,SAAA,EAAW,IAAI,CAAA;AAE7C,IAAA,KAAA,MAAW,cAAc,WAAA,EAAa;AAClC,MAAA,MAAM,KAAA,GAAQ,aAAA,CAAc,UAAA,EAAY,IAAI,CAAA;AAC5C,MAAA,IAAI,QAAQ,SAAA,EAAW;AACnB,QAAA,SAAA,GAAY,UAAA;AACZ,QAAA,SAAA,GAAY,KAAA;AAAA,MAChB;AAAA,IACJ;AACA,IAAA,OAAO,SAAA;AAAA,EACX;AACJ;AAIA,SAAS,aAAA,CAAc,WAAwB,IAAA,EAA2B;AACtE,EAAA,IAAI,KAAA,GAAQ,CAAA;AACZ,EAAA,KAAA,MAAW,SAAS,aAAA,EAAe;AAC/B,IAAA,MAAM,CAAA,GAAI,KAAK,KAAK,CAAA;AACpB,IAAA,MAAM,CAAA,GAAI,UAAU,KAAK,CAAA;AACzB,IAAA,IAAI,CAAA,IAAK,CAAA,KAAM,CAAA,EAAG,OAAO,CAAA;AACzB,IAAA,IAAI,CAAA,EAAG,KAAA,EAAA;AAAA,EACX;AACA,EAAA,OAAO,KAAA;AACX;AAMA,SAAS,OAAA,CAAQ,MAAyB,aAAA,EAA0C;AAChF,EAAA,OAAOA,KAAA,CAAa,IAAA,EAAM,aAAA,EAAe,iBAAA,EAAmB;AAAA,IACxD,SAAA,EAAW;AAAA,GACd,CAAA;AACL;AASO,SAAS,iBAAA,GAAmC;AAC/C,EAAA,IAAI,OAAO,WAAW,WAAA,EAAa;AAC/B,IAAA,OAAO,EAAC;AAAA,EACZ;AACA,EAAA,MAAM,IAAA,GAAO,MAAA,CAAO,SAAA,CAAU,SAAA,EAAW,MAAA,GACnC,MAAA,CAAO,SAAA,CAAU,SAAA,GACjB,CAAC,MAAA,CAAO,SAAA,CAAU,QAAQ,CAAA;AAChC,EAAA,OAAO,IAAA,CAAK,IAAI,cAAc,CAAA,CAAE,OAAO,CAAC,CAAA,KAAM,CAAC,CAAC,CAAC,CAAA;AACrD;;;;"}
package/index.d.ts CHANGED
@@ -2,5 +2,5 @@ export * from "./api";
2
2
  export { createCustomElement, type AdvancedCustomElementOptions, type ApplicationConfig, type ApplicationElement, type ApplicationElementConstructor, type ApplicationOverrides, type ApplicationProperties, type ConfigContext, type CustomElementOptions } from "./CustomElement";
3
3
  export { DECLARE_SERVICE_INTERFACE, type AssociatedInterfaceName, type DeclaredService, type InterfaceNameForServiceType } from "./DeclaredService";
4
4
  export { type RootNode } from "./dom";
5
- export { type PackageIntl, type PackageIntlExtensions, type RichTextValue } from "./i18n";
5
+ export { type PackageIntl, type PackageIntlExtensions, type RichTextValue, parseLocale, tryParseLocale } from "./i18n";
6
6
  export * from "./Service";
package/index.js CHANGED
@@ -1,4 +1,10 @@
1
1
  export { createCustomElement } from './CustomElement.js';
2
2
  export { DECLARE_SERVICE_INTERFACE } from './DeclaredService.js';
3
+ import './i18n/AppIntl.js';
4
+ export { parseLocale, tryParseLocale } from './i18n/intl-locale.js';
5
+ import '@formatjs/intl';
6
+ import 'react';
7
+ import '@formatjs/intl-localematcher';
8
+ import '@open-pioneer/core';
3
9
  export { IS_SERVICE_FACTORY, defineServiceFactory } from './Service.js';
4
10
  //# sourceMappingURL=index.js.map
package/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}
1
+ {"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;"}
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "type": "module",
3
3
  "name": "@open-pioneer/runtime",
4
- "version": "4.7.0-dev.20260624141040",
4
+ "version": "4.7.0-dev.20260713101438",
5
5
  "description": "Implements the runtime environment for Open Pioneer Trails apps.",
6
6
  "keywords": [
7
7
  "open-pioneer-trails"
@@ -15,15 +15,16 @@
15
15
  },
16
16
  "dependencies": {
17
17
  "@conterra/reactivity-core": "^0.8.6",
18
- "@formatjs/intl": "^4.1.13",
18
+ "@formatjs/intl": "^4.1.15",
19
+ "@formatjs/intl-localematcher": "^0.8.11",
19
20
  "@chakra-ui/react": "^3.36.0",
20
21
  "@emotion/cache": "^11.14.0",
21
22
  "@emotion/react": "^11.14.0",
22
23
  "react": "^19.2.7",
23
24
  "react-dom": "^19.2.7",
24
- "@open-pioneer/core": "4.7.0-dev.20260624141040",
25
- "@open-pioneer/base-theme": "4.7.0-dev.20260624141040",
26
- "@open-pioneer/reactivity": "4.7.0-dev.20260624141040"
25
+ "@open-pioneer/base-theme": "4.7.0-dev.20260713101438",
26
+ "@open-pioneer/core": "4.7.0-dev.20260713101438",
27
+ "@open-pioneer/reactivity": "4.7.0-dev.20260713101438"
27
28
  },
28
29
  "exports": {
29
30
  "./package.json": "./package.json",
@@ -26,7 +26,7 @@ export type CustomChakraProviderProps = PropsWithChildren<{
26
26
  /**
27
27
  * Application locale for chakra's `LocaleProvider`.
28
28
  */
29
- locale?: string;
29
+ locale?: ReadonlyReactive<string>;
30
30
  /**
31
31
  * Custom color mode value.
32
32
  */
@@ -16,11 +16,12 @@ const CustomChakraProvider = ({
16
16
  hostNode,
17
17
  children,
18
18
  config: config$1,
19
- locale = "en-US",
19
+ locale,
20
20
  colorMode,
21
21
  styles
22
22
  }) => {
23
23
  const systemConfig = useReactiveSnapshot(() => config$1?.value ?? config, [config$1]);
24
+ const effectiveLocale = useReactiveSnapshot(() => locale?.value ?? "en-US", [locale]);
24
25
  const system = useMemo(() => {
25
26
  const mergedConfig = mergeConfigs(defaultConfig, systemConfig);
26
27
  return createSystem(
@@ -49,7 +50,7 @@ const CustomChakraProvider = ({
49
50
  {
50
51
  value: rootNode,
51
52
  portalNode: appRoot,
52
- children: /* @__PURE__ */ jsx(LocaleProvider, { locale, children: /* @__PURE__ */ jsxs(ChakraProvider, { value: system, children: [
53
+ children: /* @__PURE__ */ jsx(LocaleProvider, { locale: effectiveLocale, children: /* @__PURE__ */ jsxs(ChakraProvider, { value: system, children: [
53
54
  /* @__PURE__ */ jsx(GlobalStyles, { rootNode, hostNode, styles }),
54
55
  children
55
56
  ] }) })
@@ -1 +1 @@
1
- {"version":3,"file":"ChakraProvider.js","sources":["ChakraProvider.tsx"],"sourcesContent":["// SPDX-FileCopyrightText: 2023-2025 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nimport {\n ChakraProvider,\n createSystem,\n defaultConfig,\n defineConfig,\n EnvironmentProvider,\n LocaleProvider,\n mergeConfigs,\n SystemConfig,\n SystemStyleObject\n} from \"@chakra-ui/react\";\nimport { ReadonlyReactive } from \"@conterra/reactivity-core\";\nimport createCache, { EmotionCache } from \"@emotion/cache\";\nimport { CacheProvider, Global } from \"@emotion/react\";\nimport { config as defaultTrailsConfig } from \"@open-pioneer/base-theme\";\nimport { Error } from \"@open-pioneer/core\";\nimport { useReactiveSnapshot } from \"@open-pioneer/reactivity\";\nimport { FC, PropsWithChildren, useEffect, useLayoutEffect, useMemo, useState } from \"react\";\nimport { APP_ROOT_CLASS, getBuiltinStyles, getStylesRoot, RootNode } from \"../dom\";\nimport { ErrorId } from \"../errors\";\nimport { ColorModeValue } from \"../api\";\n\n/** @internal */\nexport type CustomChakraProviderProps = PropsWithChildren<{\n /**\n * Document root node.\n */\n rootNode: RootNode;\n\n /**\n * Web component root.\n *\n * NOTE: undefined for test support only.\n */\n hostNode?: HTMLElement;\n\n /**\n * Application container (react's render target).\n */\n appRoot: HTMLElement;\n\n /**\n * Chakra system config (can be used to provide custom theme).\n */\n config?: ReadonlyReactive<SystemConfig | undefined>;\n\n /**\n * Application locale for chakra's `LocaleProvider`.\n */\n locale?: string;\n\n /**\n * Custom color mode value.\n */\n colorMode: ReadonlyReactive<ColorModeValue>;\n\n /**\n * Custom CSS used by the application.\n */\n styles?: ReadonlyReactive<string>;\n}>;\n\nconst APP_ROOT_CSS = `.${APP_ROOT_CLASS}`;\n\n/**\n * Wraps the entire react application and configures chakra-ui (styling etc.).\n *\n * Exported so it can be used from the test-utils package.\n *\n * @internal\n */\nexport const CustomChakraProvider: FC<CustomChakraProviderProps> = ({\n rootNode,\n appRoot,\n hostNode,\n children,\n config,\n locale = \"en-US\",\n colorMode,\n styles\n}) => {\n /*\n Setup chakra integration:\n\n 1. Mount styles into the shadow root via emotion\n 2. Use chakra's EnvironmentProvider to tell it about the shadow root context\n 3. Setup global styles correctly (selectors etc.) via chakra's system object\n 4. Render the rest of the application\n */\n\n const systemConfig = useReactiveSnapshot(() => config?.value ?? defaultTrailsConfig, [config]);\n\n const system = useMemo(() => {\n const mergedConfig = mergeConfigs(defaultConfig, systemConfig);\n return createSystem(\n mergedConfig,\n\n // https://www.chakra-ui.com/docs/get-started/environments/shadow-dom\n defineConfig({\n preflight: {\n scope: APP_ROOT_CSS\n },\n cssVarsRoot: APP_ROOT_CSS,\n conditions: redirectLightCondition(mergedConfig.conditions),\n globalCss: redirectHtmlProps(mergedConfig.globalCss)\n })\n );\n }, [systemConfig]);\n\n const effectiveColorMode = useReactiveSnapshot(() => colorMode.value, [colorMode]);\n\n useLayoutEffect(() => {\n const classes = appRoot.classList;\n classes.toggle(\"light\", effectiveColorMode === \"light\");\n classes.toggle(\"dark\", effectiveColorMode === \"dark\");\n appRoot.style.colorScheme = effectiveColorMode;\n }, [appRoot, effectiveColorMode]);\n\n const cache = useEmotionCache(rootNode);\n return (\n cache && (\n <CacheProvider value={cache}>\n <EnvironmentProvider\n value={rootNode}\n // Patched property\n portalNode={appRoot}\n >\n <LocaleProvider locale={locale}>\n <ChakraProvider value={system}>\n <GlobalStyles rootNode={rootNode} hostNode={hostNode} styles={styles} />\n {children}\n </ChakraProvider>\n </LocaleProvider>\n </EnvironmentProvider>\n </CacheProvider>\n )\n );\n};\n\nfunction GlobalStyles(props: {\n rootNode: RootNode;\n hostNode: HTMLElement | undefined;\n styles: ReadonlyReactive<string> | undefined;\n}) {\n const { rootNode, hostNode, styles } = props;\n const builtinStyles = useMemo(() => {\n const css = getBuiltinStyles(rootNode, hostNode);\n return <Global styles={css} />;\n }, [rootNode, hostNode]);\n const appStyles = useReactiveSnapshot(() => {\n const css = styles?.value;\n return css && <Global styles={css} />;\n }, [styles]);\n return (\n <>\n {builtinStyles}\n {appStyles}\n </>\n );\n}\n\nfunction redirectHtmlProps(\n css: Record<string, SystemStyleObject> | undefined\n): Record<string, SystemStyleObject> {\n const { html, ...rest } = css ?? {};\n if (!html) {\n throw new Error(ErrorId.INTERNAL, \"Expected global rules on html element.\");\n }\n // Take default html styles and apply them to the host element instead\n return {\n ...rest,\n [APP_ROOT_CSS]: html\n };\n}\n\nfunction redirectLightCondition(\n conditions: Record<string, unknown> | undefined\n): Record<string, unknown> {\n // Make sure light mode tokens are applied\n return {\n ...conditions,\n // Before: \":root &, .light &\"\n light: `${APP_ROOT_CSS} &, .light &`\n };\n}\n\nfunction useEmotionCache(rootNode: RootNode): EmotionCache | undefined {\n const stylesRoot = useMemo(() => getStylesRoot(rootNode), [rootNode]);\n\n const [cache, setCache] = useState<EmotionCache | undefined>();\n useEffect(() => {\n const cache = createCache({\n key: \"css\",\n container: stylesRoot\n });\n\n // Disable useless warnings like `The pseudo class \":nth-child\" is potentially unsafe when doing server-side rendering. Try changing it to \":nth-of-type\".`\n // See: https://github.com/emotion-js/emotion/issues/1105#issuecomment-557726922\n cache.compat = true;\n\n setCache(cache);\n return () => {\n setCache(undefined);\n for (const tag of cache.sheet.tags) {\n tag.remove();\n }\n };\n }, [stylesRoot]);\n return cache;\n}\n"],"names":["config","defaultTrailsConfig","cache"],"mappings":"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"}
1
+ {"version":3,"file":"ChakraProvider.js","sources":["ChakraProvider.tsx"],"sourcesContent":["// SPDX-FileCopyrightText: 2023-2025 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nimport {\n ChakraProvider,\n createSystem,\n defaultConfig,\n defineConfig,\n EnvironmentProvider,\n LocaleProvider,\n mergeConfigs,\n SystemConfig,\n SystemStyleObject\n} from \"@chakra-ui/react\";\nimport { ReadonlyReactive } from \"@conterra/reactivity-core\";\nimport createCache, { EmotionCache } from \"@emotion/cache\";\nimport { CacheProvider, Global } from \"@emotion/react\";\nimport { config as defaultTrailsConfig } from \"@open-pioneer/base-theme\";\nimport { Error } from \"@open-pioneer/core\";\nimport { useReactiveSnapshot } from \"@open-pioneer/reactivity\";\nimport { FC, PropsWithChildren, useEffect, useLayoutEffect, useMemo, useState } from \"react\";\nimport { APP_ROOT_CLASS, getBuiltinStyles, getStylesRoot, RootNode } from \"../dom\";\nimport { ErrorId } from \"../errors\";\nimport { ColorModeValue } from \"../api\";\n\n/** @internal */\nexport type CustomChakraProviderProps = PropsWithChildren<{\n /**\n * Document root node.\n */\n rootNode: RootNode;\n\n /**\n * Web component root.\n *\n * NOTE: undefined for test support only.\n */\n hostNode?: HTMLElement;\n\n /**\n * Application container (react's render target).\n */\n appRoot: HTMLElement;\n\n /**\n * Chakra system config (can be used to provide custom theme).\n */\n config?: ReadonlyReactive<SystemConfig | undefined>;\n\n /**\n * Application locale for chakra's `LocaleProvider`.\n */\n locale?: ReadonlyReactive<string>;\n\n /**\n * Custom color mode value.\n */\n colorMode: ReadonlyReactive<ColorModeValue>;\n\n /**\n * Custom CSS used by the application.\n */\n styles?: ReadonlyReactive<string>;\n}>;\n\nconst APP_ROOT_CSS = `.${APP_ROOT_CLASS}`;\n\n/**\n * Wraps the entire react application and configures chakra-ui (styling etc.).\n *\n * Exported so it can be used from the test-utils package.\n *\n * @internal\n */\nexport const CustomChakraProvider: FC<CustomChakraProviderProps> = ({\n rootNode,\n appRoot,\n hostNode,\n children,\n config,\n locale,\n colorMode,\n styles\n}) => {\n /*\n Setup chakra integration:\n\n 1. Mount styles into the shadow root via emotion\n 2. Use chakra's EnvironmentProvider to tell it about the shadow root context\n 3. Setup global styles correctly (selectors etc.) via chakra's system object\n 4. Render the rest of the application\n */\n\n const systemConfig = useReactiveSnapshot(() => config?.value ?? defaultTrailsConfig, [config]);\n const effectiveLocale = useReactiveSnapshot(() => locale?.value ?? \"en-US\", [locale]);\n\n const system = useMemo(() => {\n const mergedConfig = mergeConfigs(defaultConfig, systemConfig);\n return createSystem(\n mergedConfig,\n\n // https://www.chakra-ui.com/docs/get-started/environments/shadow-dom\n defineConfig({\n preflight: {\n scope: APP_ROOT_CSS\n },\n cssVarsRoot: APP_ROOT_CSS,\n conditions: redirectLightCondition(mergedConfig.conditions),\n globalCss: redirectHtmlProps(mergedConfig.globalCss)\n })\n );\n }, [systemConfig]);\n\n const effectiveColorMode = useReactiveSnapshot(() => colorMode.value, [colorMode]);\n\n useLayoutEffect(() => {\n const classes = appRoot.classList;\n classes.toggle(\"light\", effectiveColorMode === \"light\");\n classes.toggle(\"dark\", effectiveColorMode === \"dark\");\n appRoot.style.colorScheme = effectiveColorMode;\n }, [appRoot, effectiveColorMode]);\n\n const cache = useEmotionCache(rootNode);\n return (\n cache && (\n <CacheProvider value={cache}>\n <EnvironmentProvider\n value={rootNode}\n // Patched property\n portalNode={appRoot}\n >\n <LocaleProvider locale={effectiveLocale}>\n <ChakraProvider value={system}>\n <GlobalStyles rootNode={rootNode} hostNode={hostNode} styles={styles} />\n {children}\n </ChakraProvider>\n </LocaleProvider>\n </EnvironmentProvider>\n </CacheProvider>\n )\n );\n};\n\nfunction GlobalStyles(props: {\n rootNode: RootNode;\n hostNode: HTMLElement | undefined;\n styles: ReadonlyReactive<string> | undefined;\n}) {\n const { rootNode, hostNode, styles } = props;\n const builtinStyles = useMemo(() => {\n const css = getBuiltinStyles(rootNode, hostNode);\n return <Global styles={css} />;\n }, [rootNode, hostNode]);\n const appStyles = useReactiveSnapshot(() => {\n const css = styles?.value;\n return css && <Global styles={css} />;\n }, [styles]);\n return (\n <>\n {builtinStyles}\n {appStyles}\n </>\n );\n}\n\nfunction redirectHtmlProps(\n css: Record<string, SystemStyleObject> | undefined\n): Record<string, SystemStyleObject> {\n const { html, ...rest } = css ?? {};\n if (!html) {\n throw new Error(ErrorId.INTERNAL, \"Expected global rules on html element.\");\n }\n // Take default html styles and apply them to the host element instead\n return {\n ...rest,\n [APP_ROOT_CSS]: html\n };\n}\n\nfunction redirectLightCondition(\n conditions: Record<string, unknown> | undefined\n): Record<string, unknown> {\n // Make sure light mode tokens are applied\n return {\n ...conditions,\n // Before: \":root &, .light &\"\n light: `${APP_ROOT_CSS} &, .light &`\n };\n}\n\nfunction useEmotionCache(rootNode: RootNode): EmotionCache | undefined {\n const stylesRoot = useMemo(() => getStylesRoot(rootNode), [rootNode]);\n\n const [cache, setCache] = useState<EmotionCache | undefined>();\n useEffect(() => {\n const cache = createCache({\n key: \"css\",\n container: stylesRoot\n });\n\n // Disable useless warnings like `The pseudo class \":nth-child\" is potentially unsafe when doing server-side rendering. Try changing it to \":nth-of-type\".`\n // See: https://github.com/emotion-js/emotion/issues/1105#issuecomment-557726922\n cache.compat = true;\n\n setCache(cache);\n return () => {\n setCache(undefined);\n for (const tag of cache.sheet.tags) {\n tag.remove();\n }\n };\n }, [stylesRoot]);\n return cache;\n}\n"],"names":["config","defaultTrailsConfig","cache"],"mappings":"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"}
@@ -6,7 +6,7 @@ export interface PackageContextMethods {
6
6
  getServices: (packageName: string, interfaceName: string) => Service[];
7
7
  getProperties: (packageName: string) => Readonly<Record<string, unknown>>;
8
8
  /**
9
- * NOTE: This is reactive during development for hot reloading support.
9
+ * NOTE: Reactive for fine grained i18n changes (during dev for i18n HMR) and for live local changes (also in production).
10
10
  */
11
11
  getIntl(packageName: string): PackageIntl;
12
12
  }
@@ -1 +1 @@
1
- {"version":3,"file":"PackageContext.js","sources":["PackageContext.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2023-2025 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nimport { createContext } from \"react\";\nimport type { PackageIntl } from \"../i18n\";\nimport type { Service } from \"../Service\";\nimport type { UseServiceOptions } from \"./hooks\";\n\nexport interface PackageContextMethods {\n getService: (packageName: string, interfaceName: string, options: UseServiceOptions) => Service;\n getServices: (packageName: string, interfaceName: string) => Service[];\n getProperties: (packageName: string) => Readonly<Record<string, unknown>>;\n\n /**\n * NOTE: This is reactive during development for hot reloading support.\n */\n getIntl(packageName: string): PackageIntl;\n}\n\nexport const PackageContext = createContext<PackageContextMethods | null>(null);\n"],"names":[],"mappings":";;AAkBO,MAAM,cAAA,GAAiB,cAA4C,IAAI;;;;"}
1
+ {"version":3,"file":"PackageContext.js","sources":["PackageContext.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2023-2025 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nimport { createContext } from \"react\";\nimport type { PackageIntl } from \"../i18n\";\nimport type { Service } from \"../Service\";\nimport type { UseServiceOptions } from \"./hooks\";\n\nexport interface PackageContextMethods {\n getService: (packageName: string, interfaceName: string, options: UseServiceOptions) => Service;\n getServices: (packageName: string, interfaceName: string) => Service[];\n getProperties: (packageName: string) => Readonly<Record<string, unknown>>;\n\n /**\n * NOTE: Reactive for fine grained i18n changes (during dev for i18n HMR) and for live local changes (also in production).\n */\n getIntl(packageName: string): PackageIntl;\n}\n\nexport const PackageContext = createContext<PackageContextMethods | null>(null);\n"],"names":[],"mappings":";;AAkBO,MAAM,cAAA,GAAiB,cAA4C,IAAI;;;;"}
@@ -11,21 +11,13 @@ export interface ReactIntegrationOptions {
11
11
  appRoot: HTMLDivElement;
12
12
  packages: Map<string, PackageRepr>;
13
13
  serviceLayer: ServiceLayer;
14
- locale: string;
14
+ locale: ReadonlyReactive<string>;
15
15
  config?: ReadonlyReactive<SystemConfig | undefined>;
16
16
  styles: ReadonlyReactive<string>;
17
17
  colorMode: ReadonlyReactive<ColorModeValue>;
18
18
  }
19
19
  export declare class ReactIntegration {
20
- private rootNode;
21
- private hostNode;
22
- private appRoot;
23
- private reactRoot;
24
- private packageContext;
25
- private locale;
26
- private chakraConfig?;
27
- private styles;
28
- private colorMode;
20
+ #private;
29
21
  static createForApp(options: ReactIntegrationOptions): ReactIntegration;
30
22
  static createForErrorScreen(options: Omit<ReactIntegrationOptions, "serviceLayer" | "packages">): ReactIntegration;
31
23
  private constructor();
@@ -10,15 +10,15 @@ import { CustomChakraProvider } from './ChakraProvider.js';
10
10
  import { PackageContext } from './PackageContext.js';
11
11
 
12
12
  class ReactIntegration {
13
- rootNode;
14
- hostNode;
15
- appRoot;
16
- reactRoot;
17
- packageContext;
18
- locale;
19
- chakraConfig;
20
- styles;
21
- colorMode;
13
+ #rootNode;
14
+ #hostNode;
15
+ #appRoot;
16
+ #reactRoot;
17
+ #packageContext;
18
+ #locale;
19
+ #chakraConfig;
20
+ #styles;
21
+ #colorMode;
22
22
  static createForApp(options) {
23
23
  const { serviceLayer, packages } = options;
24
24
  const packageContext = createPackageContext(serviceLayer, packages);
@@ -37,35 +37,35 @@ class ReactIntegration {
37
37
  return new ReactIntegration({ ...options, packageContext });
38
38
  }
39
39
  constructor(options) {
40
- this.rootNode = options.rootNode;
41
- this.hostNode = options.hostNode;
42
- this.appRoot = options.appRoot;
43
- this.reactRoot = createRoot(options.appRoot);
44
- this.chakraConfig = options.config;
45
- this.packageContext = options.packageContext;
46
- this.locale = options.locale;
47
- this.styles = options.styles;
48
- this.colorMode = options.colorMode;
40
+ this.#rootNode = options.rootNode;
41
+ this.#hostNode = options.hostNode;
42
+ this.#appRoot = options.appRoot;
43
+ this.#reactRoot = createRoot(options.appRoot);
44
+ this.#chakraConfig = options.config;
45
+ this.#packageContext = options.packageContext;
46
+ this.#locale = options.locale;
47
+ this.#styles = options.styles;
48
+ this.#colorMode = options.colorMode;
49
49
  }
50
50
  render(contentNode) {
51
- this.reactRoot.render(
51
+ this.#reactRoot.render(
52
52
  /* @__PURE__ */ jsx(StrictMode, { children: /* @__PURE__ */ jsx(
53
53
  CustomChakraProvider,
54
54
  {
55
- rootNode: this.rootNode,
56
- hostNode: this.hostNode,
57
- appRoot: this.appRoot,
58
- config: this.chakraConfig,
59
- locale: this.locale,
60
- styles: this.styles,
61
- colorMode: this.colorMode,
62
- children: /* @__PURE__ */ jsx(TooltipPropsProvider, { value: { openDelay: 500 }, children: /* @__PURE__ */ jsx(PackageContext.Provider, { value: this.packageContext, children: contentNode }) })
55
+ rootNode: this.#rootNode,
56
+ hostNode: this.#hostNode,
57
+ appRoot: this.#appRoot,
58
+ config: this.#chakraConfig,
59
+ locale: this.#locale,
60
+ styles: this.#styles,
61
+ colorMode: this.#colorMode,
62
+ children: /* @__PURE__ */ jsx(TooltipPropsProvider, { value: { openDelay: 500 }, children: /* @__PURE__ */ jsx(PackageContext.Provider, { value: this.#packageContext, children: contentNode }) })
63
63
  }
64
64
  ) })
65
65
  );
66
66
  }
67
67
  destroy() {
68
- this.reactRoot.unmount();
68
+ this.#reactRoot.unmount();
69
69
  }
70
70
  }
71
71
  function EmptyComponent() {
@@ -1 +1 @@
1
- {"version":3,"file":"ReactIntegration.js","sources":["ReactIntegration.tsx"],"sourcesContent":["// SPDX-FileCopyrightText: 2023-2025 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nimport { SystemConfig, TooltipPropsProvider } from \"@chakra-ui/react\";\nimport { ReadonlyReactive } from \"@conterra/reactivity-core\";\nimport { Error } from \"@open-pioneer/core\";\nimport { ReactNode, StrictMode } from \"react\";\nimport { createRoot, Root } from \"react-dom/client\";\nimport { RootNode } from \"../dom\";\nimport { ErrorId } from \"../errors\";\nimport { InterfaceSpec, renderInterfaceSpec } from \"../service-layer/InterfaceSpec\";\nimport { PackageRepr } from \"../service-layer/PackageRepr\";\nimport { ServiceLayer } from \"../service-layer/ServiceLayer\";\nimport { renderAmbiguousServiceChoices } from \"../service-layer/ServiceLookup\";\nimport { CustomChakraProvider } from \"./ChakraProvider\";\nimport { PackageContext, PackageContextMethods } from \"./PackageContext\";\nimport { ColorModeValue } from \"../api\";\n\nexport interface ReactIntegrationOptions {\n rootNode: RootNode;\n hostNode: HTMLElement;\n appRoot: HTMLDivElement;\n packages: Map<string, PackageRepr>;\n serviceLayer: ServiceLayer;\n\n locale: string;\n config?: ReadonlyReactive<SystemConfig | undefined>;\n styles: ReadonlyReactive<string>;\n colorMode: ReadonlyReactive<ColorModeValue>;\n}\n\nexport class ReactIntegration {\n private rootNode: RootNode;\n private hostNode: HTMLElement;\n private appRoot: HTMLDivElement;\n private reactRoot: Root;\n private packageContext: PackageContextMethods;\n private locale: string;\n private chakraConfig?: ReadonlyReactive<SystemConfig | undefined>;\n private styles: ReadonlyReactive<string>;\n private colorMode: ReadonlyReactive<ColorModeValue>;\n\n static createForApp(options: ReactIntegrationOptions): ReactIntegration {\n const { serviceLayer, packages } = options;\n const packageContext = createPackageContext(serviceLayer, packages);\n return new ReactIntegration({ ...options, packageContext });\n }\n\n static createForErrorScreen(\n options: Omit<ReactIntegrationOptions, \"serviceLayer\" | \"packages\">\n ) {\n const throwError = () => {\n throw new Error(ErrorId.INVALID_STATE, \"Hook cannot be used within the error screen.\");\n };\n const packageContext: PackageContextMethods = {\n getIntl: throwError,\n getProperties: throwError,\n getService: throwError,\n getServices: throwError\n };\n return new ReactIntegration({ ...options, packageContext });\n }\n\n private constructor(\n options: Omit<ReactIntegrationOptions, \"serviceLayer\" | \"packages\"> & {\n packageContext: PackageContextMethods;\n }\n ) {\n this.rootNode = options.rootNode;\n this.hostNode = options.hostNode;\n this.appRoot = options.appRoot;\n this.reactRoot = createRoot(options.appRoot);\n this.chakraConfig = options.config;\n this.packageContext = options.packageContext;\n this.locale = options.locale;\n this.styles = options.styles;\n this.colorMode = options.colorMode;\n }\n\n render(contentNode: ReactNode) {\n this.reactRoot.render(\n <StrictMode>\n <CustomChakraProvider\n rootNode={this.rootNode}\n hostNode={this.hostNode}\n appRoot={this.appRoot}\n config={this.chakraConfig}\n locale={this.locale}\n styles={this.styles}\n colorMode={this.colorMode}\n >\n {/*TooltipPropsProvider sets shorter `openDelay` for globally all Tooltips (500 ms instead of 1000 ms)*/}\n <TooltipPropsProvider value={{ openDelay: 500 }}>\n <PackageContext.Provider value={this.packageContext}>\n {contentNode}\n </PackageContext.Provider>\n </TooltipPropsProvider>\n </CustomChakraProvider>\n </StrictMode>\n );\n }\n\n destroy() {\n this.reactRoot.unmount();\n }\n}\n\nexport function EmptyComponent(): ReactNode {\n return null;\n}\n\nfunction createPackageContext(\n serviceLayer: ServiceLayer,\n packages: Map<string, PackageRepr>\n): PackageContextMethods {\n const getPackage = (packageName: string): PackageRepr => {\n const pkg = packages.get(packageName);\n if (!pkg) {\n throw new Error(\n ErrorId.INTERNAL,\n `Package '${packageName}' was not found in application.`\n );\n }\n return pkg;\n };\n\n const packageContext: PackageContextMethods = {\n getService: (packageName, interfaceName, options) => {\n const spec: InterfaceSpec = { interfaceName, ...options };\n const result = serviceLayer.getService(packageName, spec);\n if (result.type === \"found\") {\n return result.value.getInstanceOrThrow();\n }\n\n const renderedSpec = renderInterfaceSpec(spec);\n switch (result.type) {\n case \"unimplemented\":\n throw new Error(\n ErrorId.INTERFACE_NOT_FOUND,\n `The UI of package '${packageName}' requested the unimplemented interface ${renderedSpec}.`\n );\n case \"undeclared\":\n throw new Error(\n ErrorId.UNDECLARED_DEPENDENCY,\n `Package '${packageName}' did not declare an UI dependency on interface ${renderedSpec}.` +\n ` Add the dependency to the package configuration or remove the usage.`\n );\n case \"ambiguous\": {\n const renderedChoices = renderAmbiguousServiceChoices(result.choices);\n throw new Error(\n ErrorId.AMBIGUOUS_DEPENDENCY,\n `The UI of package '${packageName}' requires the ambiguous interface ${renderedSpec}.` +\n ` Possible choices are: ${renderedChoices}.`\n );\n }\n case \"unknown-package\":\n throw new Error(\n ErrorId.MISSING_PACKAGE,\n missingPackageMessage(packageName, interfaceName)\n );\n }\n },\n getServices: (packageName, interfaceName) => {\n const result = serviceLayer.getServices(packageName, interfaceName);\n if (result.type === \"found\") {\n return result.value.map((serviceRepr) => serviceRepr.getInstanceOrThrow());\n }\n\n switch (result.type) {\n case \"undeclared\":\n throw new Error(\n ErrorId.UNDECLARED_DEPENDENCY,\n `Package '${packageName}' did not declare an UI dependency on all services implementing interface '${interfaceName}'.` +\n ` Add the dependency (\"all\": true) to the package configuration or remove the usage.`\n );\n case \"unknown-package\":\n throw new Error(\n ErrorId.MISSING_PACKAGE,\n missingPackageMessage(packageName, interfaceName)\n );\n }\n },\n getProperties: (packageName) => {\n return getPackage(packageName).properties;\n },\n getIntl: (packageName) => {\n return getPackage(packageName).intl.value;\n }\n };\n return packageContext;\n}\n\nfunction missingPackageMessage(packageName: string, interfaceName: string) {\n return (\n `Package '${packageName}' was not found in the application's metadata while it attempted to reference the interface '${interfaceName}'. ` +\n `Check that the dependency is declared correctly in the packages that use '${packageName}'.`\n );\n}\n"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"ReactIntegration.js","sources":["ReactIntegration.tsx"],"sourcesContent":["// SPDX-FileCopyrightText: 2023-2025 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nimport { SystemConfig, TooltipPropsProvider } from \"@chakra-ui/react\";\nimport { ReadonlyReactive } from \"@conterra/reactivity-core\";\nimport { Error } from \"@open-pioneer/core\";\nimport { ReactNode, StrictMode } from \"react\";\nimport { createRoot, Root } from \"react-dom/client\";\nimport { RootNode } from \"../dom\";\nimport { ErrorId } from \"../errors\";\nimport { InterfaceSpec, renderInterfaceSpec } from \"../service-layer/InterfaceSpec\";\nimport { PackageRepr } from \"../service-layer/PackageRepr\";\nimport { ServiceLayer } from \"../service-layer/ServiceLayer\";\nimport { renderAmbiguousServiceChoices } from \"../service-layer/ServiceLookup\";\nimport { CustomChakraProvider } from \"./ChakraProvider\";\nimport { PackageContext, PackageContextMethods } from \"./PackageContext\";\nimport { ColorModeValue } from \"../api\";\n\nexport interface ReactIntegrationOptions {\n rootNode: RootNode;\n hostNode: HTMLElement;\n appRoot: HTMLDivElement;\n packages: Map<string, PackageRepr>;\n serviceLayer: ServiceLayer;\n\n locale: ReadonlyReactive<string>;\n config?: ReadonlyReactive<SystemConfig | undefined>;\n styles: ReadonlyReactive<string>;\n colorMode: ReadonlyReactive<ColorModeValue>;\n}\n\nexport class ReactIntegration {\n #rootNode: RootNode;\n #hostNode: HTMLElement;\n #appRoot: HTMLDivElement;\n #reactRoot: Root;\n #packageContext: PackageContextMethods;\n #locale: ReadonlyReactive<string>;\n #chakraConfig?: ReadonlyReactive<SystemConfig | undefined>;\n #styles: ReadonlyReactive<string>;\n #colorMode: ReadonlyReactive<ColorModeValue>;\n\n static createForApp(options: ReactIntegrationOptions): ReactIntegration {\n const { serviceLayer, packages } = options;\n const packageContext = createPackageContext(serviceLayer, packages);\n return new ReactIntegration({ ...options, packageContext });\n }\n\n static createForErrorScreen(\n options: Omit<ReactIntegrationOptions, \"serviceLayer\" | \"packages\">\n ) {\n const throwError = () => {\n throw new Error(ErrorId.INVALID_STATE, \"Hook cannot be used within the error screen.\");\n };\n const packageContext: PackageContextMethods = {\n getIntl: throwError,\n getProperties: throwError,\n getService: throwError,\n getServices: throwError\n };\n return new ReactIntegration({ ...options, packageContext });\n }\n\n private constructor(\n options: Omit<ReactIntegrationOptions, \"serviceLayer\" | \"packages\"> & {\n packageContext: PackageContextMethods;\n }\n ) {\n this.#rootNode = options.rootNode;\n this.#hostNode = options.hostNode;\n this.#appRoot = options.appRoot;\n this.#reactRoot = createRoot(options.appRoot);\n this.#chakraConfig = options.config;\n this.#packageContext = options.packageContext;\n this.#locale = options.locale;\n this.#styles = options.styles;\n this.#colorMode = options.colorMode;\n }\n\n render(contentNode: ReactNode) {\n this.#reactRoot.render(\n <StrictMode>\n <CustomChakraProvider\n rootNode={this.#rootNode}\n hostNode={this.#hostNode}\n appRoot={this.#appRoot}\n config={this.#chakraConfig}\n locale={this.#locale}\n styles={this.#styles}\n colorMode={this.#colorMode}\n >\n {/*TooltipPropsProvider sets shorter `openDelay` for globally all Tooltips (500 ms instead of 1000 ms)*/}\n <TooltipPropsProvider value={{ openDelay: 500 }}>\n <PackageContext.Provider value={this.#packageContext}>\n {contentNode}\n </PackageContext.Provider>\n </TooltipPropsProvider>\n </CustomChakraProvider>\n </StrictMode>\n );\n }\n\n destroy() {\n this.#reactRoot.unmount();\n }\n}\n\nexport function EmptyComponent(): ReactNode {\n return null;\n}\n\nfunction createPackageContext(\n serviceLayer: ServiceLayer,\n packages: Map<string, PackageRepr>\n): PackageContextMethods {\n const getPackage = (packageName: string): PackageRepr => {\n const pkg = packages.get(packageName);\n if (!pkg) {\n throw new Error(\n ErrorId.INTERNAL,\n `Package '${packageName}' was not found in application.`\n );\n }\n return pkg;\n };\n\n const packageContext: PackageContextMethods = {\n getService: (packageName, interfaceName, options) => {\n const spec: InterfaceSpec = { interfaceName, ...options };\n const result = serviceLayer.getService(packageName, spec);\n if (result.type === \"found\") {\n return result.value.getInstanceOrThrow();\n }\n\n const renderedSpec = renderInterfaceSpec(spec);\n switch (result.type) {\n case \"unimplemented\":\n throw new Error(\n ErrorId.INTERFACE_NOT_FOUND,\n `The UI of package '${packageName}' requested the unimplemented interface ${renderedSpec}.`\n );\n case \"undeclared\":\n throw new Error(\n ErrorId.UNDECLARED_DEPENDENCY,\n `Package '${packageName}' did not declare an UI dependency on interface ${renderedSpec}.` +\n ` Add the dependency to the package configuration or remove the usage.`\n );\n case \"ambiguous\": {\n const renderedChoices = renderAmbiguousServiceChoices(result.choices);\n throw new Error(\n ErrorId.AMBIGUOUS_DEPENDENCY,\n `The UI of package '${packageName}' requires the ambiguous interface ${renderedSpec}.` +\n ` Possible choices are: ${renderedChoices}.`\n );\n }\n case \"unknown-package\":\n throw new Error(\n ErrorId.MISSING_PACKAGE,\n missingPackageMessage(packageName, interfaceName)\n );\n }\n },\n getServices: (packageName, interfaceName) => {\n const result = serviceLayer.getServices(packageName, interfaceName);\n if (result.type === \"found\") {\n return result.value.map((serviceRepr) => serviceRepr.getInstanceOrThrow());\n }\n\n switch (result.type) {\n case \"undeclared\":\n throw new Error(\n ErrorId.UNDECLARED_DEPENDENCY,\n `Package '${packageName}' did not declare an UI dependency on all services implementing interface '${interfaceName}'.` +\n ` Add the dependency (\"all\": true) to the package configuration or remove the usage.`\n );\n case \"unknown-package\":\n throw new Error(\n ErrorId.MISSING_PACKAGE,\n missingPackageMessage(packageName, interfaceName)\n );\n }\n },\n getProperties: (packageName) => {\n return getPackage(packageName).properties;\n },\n getIntl: (packageName) => {\n return getPackage(packageName).intl.value;\n }\n };\n return packageContext;\n}\n\nfunction missingPackageMessage(packageName: string, interfaceName: string) {\n return (\n `Package '${packageName}' was not found in the application's metadata while it attempted to reference the interface '${interfaceName}'. ` +\n `Check that the dependency is declared correctly in the packages that use '${packageName}'.`\n );\n}\n"],"names":[],"mappings":"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"}
@@ -31,15 +31,11 @@ function usePropertiesInternal(packageName) {
31
31
  function useIntlInternal(packageName) {
32
32
  const context = useContext(PackageContext);
33
33
  const contextData = checkContext("useIntl", context);
34
- if (import.meta.hot) {
35
- const intl = useReactiveSnapshot(
36
- () => contextData.getIntl(packageName),
37
- [packageName, contextData]
38
- );
39
- return intl;
40
- } else {
41
- return contextData.getIntl(packageName);
42
- }
34
+ const intl = useReactiveSnapshot(
35
+ () => contextData.getIntl(packageName),
36
+ [packageName, contextData]
37
+ );
38
+ return intl;
43
39
  }
44
40
  function checkContext(hookName, contextData) {
45
41
  if (!contextData) {
@@ -1 +1 @@
1
- {"version":3,"file":"hooks.js","sources":["hooks.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2023-2025 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nimport { Error } from \"@open-pioneer/core\";\nimport { useContext, useMemo } from \"react\";\nimport { InterfaceNameForServiceType } from \"../DeclaredService\";\nimport { ErrorId } from \"../errors\";\nimport { PackageIntl } from \"../i18n\";\nimport { PackageContext, PackageContextMethods } from \"./PackageContext\";\nimport { useReactiveSnapshot } from \"@open-pioneer/reactivity\";\n\n/*\n\n IMPORTANT\n =========\n\n The functions in this file are part of the public API, although they should not be called directly.\n They are imported by code generated during separate package compilation generation via:\n\n import { hookName } from '@open-pioneer/runtime/react-integration'\n\n They are also imported by the vite plugin during development and when building an application.\n\n The matching exports are in the neighboring `index.ts`.\n The interfaces of these hooks must remain stable so that already published packages can continue to work in the future.\n\n See also the implementation of @open-pioneer/build-package.\n\n*/\n\nexport interface UseServiceOptions {\n /** An additional qualifier to disambiguate service instances that implement the same interface. */\n qualifier?: string;\n}\n\n/**\n * Returns a service that implements the given interface.\n * Receives the package name of the importing package as a string.\n *\n * This is an internal hook that is typically called indirectly via the hook\n * provided from `\"open-pioneer:react-hooks\"`.\n *\n * @private\n */\nexport function useServiceInternal<ServiceType = unknown>(\n packageName: string,\n interfaceName: InterfaceNameForServiceType<ServiceType>,\n options?: UseServiceOptions\n): ServiceType;\nexport function useServiceInternal(\n packageName: string,\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n interfaceName: any,\n options?: UseServiceOptions\n): unknown {\n const context = useContext(PackageContext);\n const service = useMemo(\n () =>\n checkContext(\"useService\", context).getService(\n packageName,\n interfaceName,\n options ?? {}\n ),\n [context, packageName, interfaceName, options]\n );\n return service;\n}\n\n/**\n * Returns all services that implement the given interface.\n * Receives the package name of the importing package as a string.\n *\n * This is an internal hook that is typically called indirectly via the hook\n * provided from `\"open-pioneer:react-hooks\"`.\n *\n * @private\n */\nexport function useServicesInternal<ServiceType = unknown>(\n packageName: string,\n interfaceName: InterfaceNameForServiceType<ServiceType>,\n options?: UseServiceOptions\n): ServiceType[];\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function useServicesInternal(packageName: string, interfaceName: any): unknown[] {\n const context = useContext(PackageContext);\n const services = useMemo(\n () => checkContext(\"useServices\", context).getServices(packageName, interfaceName),\n [context, packageName, interfaceName]\n );\n return services;\n}\n\n/**\n * Returns the properties for the given package.\n *\n * This is an internal hook that is typically called indirectly via the hook\n * provided from `\"open-pioneer:react-hooks\"`.\n *\n * @private\n */\nexport function usePropertiesInternal(packageName: string): Readonly<Record<string, unknown>> {\n const context = useContext(PackageContext);\n return checkContext(\"useProperties\", context).getProperties(packageName);\n}\n\n/**\n * Returns the i18n object for the given package.\n *\n * This is an internal hook that is typically called indirectly via the hook\n * provided from `\"open-pioneer:react-hooks\"`.\n *\n * @private\n */\nexport function useIntlInternal(packageName: string): PackageIntl {\n const context = useContext(PackageContext);\n const contextData = checkContext(\"useIntl\", context);\n\n if (import.meta.hot) {\n // Only reactive during dev\n // eslint-disable-next-line react-hooks/rules-of-hooks\n const intl = useReactiveSnapshot(\n () => contextData.getIntl(packageName),\n [packageName, contextData]\n );\n return intl;\n } else {\n // Not reactive in production code\n return contextData.getIntl(packageName);\n }\n}\n\nfunction checkContext(\n hookName: string,\n contextData: PackageContextMethods | null\n): PackageContextMethods {\n if (!contextData) {\n throw new Error(\n ErrorId.INTERNAL,\n `\"Failed to access package context from '${hookName}': react integration was not set up properly.`\n );\n }\n return contextData;\n}\n"],"names":[],"mappings":";;;;;;AAgDO,SAAS,kBAAA,CACZ,WAAA,EAEA,aAAA,EACA,OAAA,EACO;AACP,EAAA,MAAM,OAAA,GAAU,WAAW,cAAc,CAAA;AACzC,EAAA,MAAM,OAAA,GAAU,OAAA;AAAA,IACZ,MACI,YAAA,CAAa,YAAA,EAAc,OAAO,CAAA,CAAE,UAAA;AAAA,MAChC,WAAA;AAAA,MACA,aAAA;AAAA,MACA,WAAW;AAAC,KAChB;AAAA,IACJ,CAAC,OAAA,EAAS,WAAA,EAAa,aAAA,EAAe,OAAO;AAAA,GACjD;AACA,EAAA,OAAO,OAAA;AACX;AAiBO,SAAS,mBAAA,CAAoB,aAAqB,aAAA,EAA+B;AACpF,EAAA,MAAM,OAAA,GAAU,WAAW,cAAc,CAAA;AACzC,EAAA,MAAM,QAAA,GAAW,OAAA;AAAA,IACb,MAAM,YAAA,CAAa,aAAA,EAAe,OAAO,CAAA,CAAE,WAAA,CAAY,aAAa,aAAa,CAAA;AAAA,IACjF,CAAC,OAAA,EAAS,WAAA,EAAa,aAAa;AAAA,GACxC;AACA,EAAA,OAAO,QAAA;AACX;AAUO,SAAS,sBAAsB,WAAA,EAAwD;AAC1F,EAAA,MAAM,OAAA,GAAU,WAAW,cAAc,CAAA;AACzC,EAAA,OAAO,YAAA,CAAa,eAAA,EAAiB,OAAO,CAAA,CAAE,cAAc,WAAW,CAAA;AAC3E;AAUO,SAAS,gBAAgB,WAAA,EAAkC;AAC9D,EAAA,MAAM,OAAA,GAAU,WAAW,cAAc,CAAA;AACzC,EAAA,MAAM,WAAA,GAAc,YAAA,CAAa,SAAA,EAAW,OAAO,CAAA;AAEnD,EAAA,IAAI,YAAY,GAAA,EAAK;AAGjB,IAAA,MAAM,IAAA,GAAO,mBAAA;AAAA,MACT,MAAM,WAAA,CAAY,OAAA,CAAQ,WAAW,CAAA;AAAA,MACrC,CAAC,aAAa,WAAW;AAAA,KAC7B;AACA,IAAA,OAAO,IAAA;AAAA,EACX,CAAA,MAAO;AAEH,IAAA,OAAO,WAAA,CAAY,QAAQ,WAAW,CAAA;AAAA,EAC1C;AACJ;AAEA,SAAS,YAAA,CACL,UACA,WAAA,EACqB;AACrB,EAAA,IAAI,CAAC,WAAA,EAAa;AACd,IAAA,MAAM,IAAI,KAAA;AAAA,MACN,OAAA,CAAQ,QAAA;AAAA,MACR,2CAA2C,QAAQ,CAAA,6CAAA;AAAA,KACvD;AAAA,EACJ;AACA,EAAA,OAAO,WAAA;AACX;;;;"}
1
+ {"version":3,"file":"hooks.js","sources":["hooks.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2023-2025 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nimport { Error } from \"@open-pioneer/core\";\nimport { useContext, useMemo } from \"react\";\nimport { InterfaceNameForServiceType } from \"../DeclaredService\";\nimport { ErrorId } from \"../errors\";\nimport { PackageIntl } from \"../i18n\";\nimport { PackageContext, PackageContextMethods } from \"./PackageContext\";\nimport { useReactiveSnapshot } from \"@open-pioneer/reactivity\";\n\n/*\n\n IMPORTANT\n =========\n\n The functions in this file are part of the public API, although they should not be called directly.\n They are imported by code generated during separate package compilation generation via:\n\n import { hookName } from '@open-pioneer/runtime/react-integration'\n\n They are also imported by the vite plugin during development and when building an application.\n\n The matching exports are in the neighboring `index.ts`.\n The interfaces of these hooks must remain stable so that already published packages can continue to work in the future.\n\n See also the implementation of @open-pioneer/build-package.\n\n*/\n\nexport interface UseServiceOptions {\n /** An additional qualifier to disambiguate service instances that implement the same interface. */\n qualifier?: string;\n}\n\n/**\n * Returns a service that implements the given interface.\n * Receives the package name of the importing package as a string.\n *\n * This is an internal hook that is typically called indirectly via the hook\n * provided from `\"open-pioneer:react-hooks\"`.\n *\n * @private\n */\nexport function useServiceInternal<ServiceType = unknown>(\n packageName: string,\n interfaceName: InterfaceNameForServiceType<ServiceType>,\n options?: UseServiceOptions\n): ServiceType;\nexport function useServiceInternal(\n packageName: string,\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n interfaceName: any,\n options?: UseServiceOptions\n): unknown {\n const context = useContext(PackageContext);\n const service = useMemo(\n () =>\n checkContext(\"useService\", context).getService(\n packageName,\n interfaceName,\n options ?? {}\n ),\n [context, packageName, interfaceName, options]\n );\n return service;\n}\n\n/**\n * Returns all services that implement the given interface.\n * Receives the package name of the importing package as a string.\n *\n * This is an internal hook that is typically called indirectly via the hook\n * provided from `\"open-pioneer:react-hooks\"`.\n *\n * @private\n */\nexport function useServicesInternal<ServiceType = unknown>(\n packageName: string,\n interfaceName: InterfaceNameForServiceType<ServiceType>,\n options?: UseServiceOptions\n): ServiceType[];\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function useServicesInternal(packageName: string, interfaceName: any): unknown[] {\n const context = useContext(PackageContext);\n const services = useMemo(\n () => checkContext(\"useServices\", context).getServices(packageName, interfaceName),\n [context, packageName, interfaceName]\n );\n return services;\n}\n\n/**\n * Returns the properties for the given package.\n *\n * This is an internal hook that is typically called indirectly via the hook\n * provided from `\"open-pioneer:react-hooks\"`.\n *\n * @private\n */\nexport function usePropertiesInternal(packageName: string): Readonly<Record<string, unknown>> {\n const context = useContext(PackageContext);\n return checkContext(\"useProperties\", context).getProperties(packageName);\n}\n\n/**\n * Returns the i18n object for the given package.\n *\n * This is an internal hook that is typically called indirectly via the hook\n * provided from `\"open-pioneer:react-hooks\"`.\n *\n * @private\n */\nexport function useIntlInternal(packageName: string): PackageIntl {\n const context = useContext(PackageContext);\n const contextData = checkContext(\"useIntl\", context);\n const intl = useReactiveSnapshot(\n () => contextData.getIntl(packageName),\n [packageName, contextData]\n );\n return intl;\n}\n\nfunction checkContext(\n hookName: string,\n contextData: PackageContextMethods | null\n): PackageContextMethods {\n if (!contextData) {\n throw new Error(\n ErrorId.INTERNAL,\n `\"Failed to access package context from '${hookName}': react integration was not set up properly.`\n );\n }\n return contextData;\n}\n"],"names":[],"mappings":";;;;;;AAgDO,SAAS,kBAAA,CACZ,WAAA,EAEA,aAAA,EACA,OAAA,EACO;AACP,EAAA,MAAM,OAAA,GAAU,WAAW,cAAc,CAAA;AACzC,EAAA,MAAM,OAAA,GAAU,OAAA;AAAA,IACZ,MACI,YAAA,CAAa,YAAA,EAAc,OAAO,CAAA,CAAE,UAAA;AAAA,MAChC,WAAA;AAAA,MACA,aAAA;AAAA,MACA,WAAW;AAAC,KAChB;AAAA,IACJ,CAAC,OAAA,EAAS,WAAA,EAAa,aAAA,EAAe,OAAO;AAAA,GACjD;AACA,EAAA,OAAO,OAAA;AACX;AAiBO,SAAS,mBAAA,CAAoB,aAAqB,aAAA,EAA+B;AACpF,EAAA,MAAM,OAAA,GAAU,WAAW,cAAc,CAAA;AACzC,EAAA,MAAM,QAAA,GAAW,OAAA;AAAA,IACb,MAAM,YAAA,CAAa,aAAA,EAAe,OAAO,CAAA,CAAE,WAAA,CAAY,aAAa,aAAa,CAAA;AAAA,IACjF,CAAC,OAAA,EAAS,WAAA,EAAa,aAAa;AAAA,GACxC;AACA,EAAA,OAAO,QAAA;AACX;AAUO,SAAS,sBAAsB,WAAA,EAAwD;AAC1F,EAAA,MAAM,OAAA,GAAU,WAAW,cAAc,CAAA;AACzC,EAAA,OAAO,YAAA,CAAa,eAAA,EAAiB,OAAO,CAAA,CAAE,cAAc,WAAW,CAAA;AAC3E;AAUO,SAAS,gBAAgB,WAAA,EAAkC;AAC9D,EAAA,MAAM,OAAA,GAAU,WAAW,cAAc,CAAA;AACzC,EAAA,MAAM,WAAA,GAAc,YAAA,CAAa,SAAA,EAAW,OAAO,CAAA;AACnD,EAAA,MAAM,IAAA,GAAO,mBAAA;AAAA,IACT,MAAM,WAAA,CAAY,OAAA,CAAQ,WAAW,CAAA;AAAA,IACrC,CAAC,aAAa,WAAW;AAAA,GAC7B;AACA,EAAA,OAAO,IAAA;AACX;AAEA,SAAS,YAAA,CACL,UACA,WAAA,EACqB;AACrB,EAAA,IAAI,CAAC,WAAA,EAAa;AACd,IAAA,MAAM,IAAI,KAAA;AAAA,MACN,OAAA,CAAQ,QAAA;AAAA,MACR,2CAA2C,QAAQ,CAAA,6CAAA;AAAA,KACvD;AAAA,EACJ;AACA,EAAA,OAAO,WAAA;AACX;;;;"}
@@ -15,12 +15,7 @@ export interface UnknownPackage {
15
15
  type: "unknown-package";
16
16
  }
17
17
  export declare class ServiceLayer {
18
- private allServices;
19
- private requiredServices;
20
- private serviceLookup;
21
- private serviceDependencies;
22
- private declaredDependencies;
23
- private state;
18
+ #private;
24
19
  /**
25
20
  * Constructs a new service layer instance.
26
21
  * Requires the application's set of packages (from which services are taken)
@@ -54,18 +49,4 @@ export declare class ServiceLayer {
54
49
  * @throws if the service layer is not in 'started'.
55
50
  */
56
51
  getServices(packageName: string, interfaceName: string): ServicesLookupResult | UndeclaredDependency | UnknownPackage;
57
- /**
58
- * Initializes the given service and its dependencies.
59
- * Dependencies are initialized before the service that requires them.
60
- */
61
- private createService;
62
- /**
63
- * Destroys the given service and its dependencies.
64
- * The dependencies are destroyed after the service.
65
- */
66
- private destroyService;
67
- /** Undefined -> everything is okay */
68
- private checkDependency;
69
- private getReference;
70
- private getServiceDeps;
71
52
  }