@open-pioneer/runtime 4.7.0-dev.20260624141040 → 4.7.0-dev.20260625125130
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.
- package/CHANGELOG.md +11 -1
- package/CustomElement.d.ts +27 -2
- package/CustomElement.js.map +1 -1
- package/_virtual/source-info.js +2 -2
- package/api.d.ts +55 -2
- package/app/AppInstance.d.ts +1 -0
- package/app/AppInstance.js +50 -33
- package/app/AppInstance.js.map +1 -1
- package/app/gatherConfig.js +1 -0
- package/app/gatherConfig.js.map +1 -1
- package/builtin-services/ApplicationContextImpl.d.ts +11 -7
- package/builtin-services/ApplicationContextImpl.js +51 -10
- package/builtin-services/ApplicationContextImpl.js.map +1 -1
- package/builtin-services/LocaleServiceImpl.d.ts +18 -0
- package/builtin-services/LocaleServiceImpl.js +29 -0
- package/builtin-services/LocaleServiceImpl.js.map +1 -0
- package/builtin-services/NumberParserServiceImpl.d.ts +8 -3
- package/builtin-services/NumberParserServiceImpl.js +17 -12
- package/builtin-services/NumberParserServiceImpl.js.map +1 -1
- package/builtin-services/index.d.ts +3 -1
- package/builtin-services/index.js +34 -4
- package/builtin-services/index.js.map +1 -1
- package/dom/index.d.ts +1 -1
- package/dom/index.js +1 -4
- package/dom/index.js.map +1 -1
- package/i18n/AppIntl.d.ts +49 -11
- package/i18n/AppIntl.js +205 -87
- package/i18n/AppIntl.js.map +1 -1
- package/i18n/index.d.ts +3 -2
- package/i18n/index.js +2 -1
- package/i18n/index.js.map +1 -1
- package/i18n/intl-locale.d.ts +13 -0
- package/i18n/intl-locale.js +17 -0
- package/i18n/intl-locale.js.map +1 -0
- package/i18n/pick.d.ts +29 -16
- package/i18n/pick.js +78 -51
- package/i18n/pick.js.map +1 -1
- package/index.d.ts +1 -1
- package/index.js +6 -0
- package/index.js.map +1 -1
- package/package.json +5 -4
- package/react-integration/ChakraProvider.d.ts +1 -1
- package/react-integration/ChakraProvider.js +3 -2
- package/react-integration/ChakraProvider.js.map +1 -1
- package/react-integration/ReactIntegration.d.ts +1 -1
- package/react-integration/ReactIntegration.js.map +1 -1
- package/test-support/index.js +2 -1
- package/test-support/index.js.map +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,10 +1,20 @@
|
|
|
1
1
|
# @open-pioneer/runtime
|
|
2
2
|
|
|
3
|
-
## 4.7.0-dev.
|
|
3
|
+
## 4.7.0-dev.20260625125130
|
|
4
4
|
|
|
5
5
|
### Minor Changes
|
|
6
6
|
|
|
7
|
+
- 278515d: Deprecate the following methods on the `ApplicationContext`: `getLocale`, `setLocale`, `getSupportedLocales()`.
|
|
8
|
+
Use the alternatives provided by the new `LocaleService` instead.
|
|
7
9
|
- e433296: Update Chakra UI to 3.36.0
|
|
10
|
+
- 278515d: Add `runtime.LocaleService` and opt-in reactive locale switching.
|
|
11
|
+
|
|
12
|
+
You can opt-in by configuring the property `advanced.enableLiveLocaleChanges` when calling `createCustomElement`.
|
|
13
|
+
Once enabled, locale switches can be done without restarting the application.
|
|
14
|
+
Use `LocaleService.changeLocale` to update the application's locale.
|
|
15
|
+
|
|
16
|
+
Also export `parseLocale` and `tryParseLocale` algorithms.
|
|
17
|
+
These can be used to construct a (cleaned up) `Intl.Locale` object from a string.
|
|
8
18
|
|
|
9
19
|
### Patch Changes
|
|
10
20
|
|
package/CustomElement.d.ts
CHANGED
|
@@ -84,13 +84,26 @@ export interface ApplicationOverrides {
|
|
|
84
84
|
*/
|
|
85
85
|
export interface ApplicationConfig {
|
|
86
86
|
/**
|
|
87
|
-
* Set this value to a locale string
|
|
87
|
+
* Set this value to a locale (BCP-47 string, e.g. `"en"`) to set the default message locale of the application.
|
|
88
|
+
*
|
|
88
89
|
* The default behavior is to choose an appropriate locale for the current user based
|
|
89
90
|
* on the browser's settings.
|
|
90
91
|
*
|
|
91
|
-
*
|
|
92
|
+
* This locale should match one of the supported message locales defined by the application's package.
|
|
92
93
|
*/
|
|
93
94
|
locale?: string | undefined;
|
|
95
|
+
/**
|
|
96
|
+
* The list of locales supported by the application.
|
|
97
|
+
*
|
|
98
|
+
* This allows a further restriction of the locales supported by the application, compared to the ones defined by the application's package.
|
|
99
|
+
* It is not possible to extend the supported locales defined by the package, only to restrict them.
|
|
100
|
+
*
|
|
101
|
+
* If this property is not set, then the application supports all locales defined by the application's package.
|
|
102
|
+
* If the values are not a valid subset of the application package supported locales, then the application will throw an error at startup.
|
|
103
|
+
*
|
|
104
|
+
* An empty array will disable loading of any message bundle.
|
|
105
|
+
*/
|
|
106
|
+
supportedLocales?: string[] | undefined;
|
|
94
107
|
/**
|
|
95
108
|
* Configures the application's initial color mode.
|
|
96
109
|
*
|
|
@@ -160,6 +173,18 @@ export interface AdvancedCustomElementOptions {
|
|
|
160
173
|
* ensure that your components work in that setting.
|
|
161
174
|
*/
|
|
162
175
|
enableShadowRoot?: boolean;
|
|
176
|
+
/**
|
|
177
|
+
* Opts into live locale changes within the running application, without performing a full application restart.
|
|
178
|
+
*
|
|
179
|
+
* Default: `false`.
|
|
180
|
+
*
|
|
181
|
+
* Live locale changes preserve the application's state when the user changes the language.
|
|
182
|
+
* It requires that react components and services in the application handle intl changes correctly (see, for example, {@link ServiceOptions.currentIntl}).
|
|
183
|
+
*
|
|
184
|
+
* Note that this option will become the new default in the next major release,
|
|
185
|
+
* at which point this option will be removed.
|
|
186
|
+
*/
|
|
187
|
+
enableLiveLocaleChanges?: boolean;
|
|
163
188
|
}
|
|
164
189
|
/**
|
|
165
190
|
* The class returned by a call to {@link createCustomElement}.
|
package/CustomElement.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"CustomElement.js","sources":["CustomElement.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2023-2025 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nimport { SystemConfig as ChakraSystemConfig } from \"@chakra-ui/react\";\nimport { createLogger, Error } from \"@open-pioneer/core\";\nimport { sourceId } from \"open-pioneer:source-info\";\nimport { ComponentType } from \"react\";\nimport { type ApiMethods, type ColorModeValue, type ApiExtension } from \"./api\";\nimport { AppInstance } from \"./app\";\nimport { ErrorId } from \"./errors\";\nimport { ApplicationMetadata } from \"./metadata\";\n\nconst LOG = createLogger(sourceId);\n\n/**\n * Options for the {@link createCustomElement} function.\n */\nexport interface CustomElementOptions {\n /**\n * Rendered UI component.\n */\n component?: ComponentType<Record<string, string>>;\n\n /**\n * Application metadata (packages, services etc.).\n * This is usually autogenerated by importing the virtual `\"open-pioneer:app\"` module.\n */\n appMetadata?: ApplicationMetadata;\n\n /**\n * Application defined configuration.\n *\n * This option can be used to override default properties of the application's packages.\n *\n * All instances of the web component will share this static configuration.\n */\n config?: ApplicationConfig;\n\n /**\n * Chakra styled system object.\n *\n * Used to configure chakra's theme.\n */\n chakraSystemConfig?: ChakraSystemConfig;\n\n /**\n * Advanced configuration that alters the behavior of the custom element.\n */\n advanced?: AdvancedCustomElementOptions;\n\n /**\n * Function to provide additional application defined configuration parameters.\n *\n * Compared to {@link config}, this function receives a context object\n * that allows the developer to provide dynamic properties on a per-application instance basis.\n *\n * Parameters returned by this function take precedence over the ones defined by {@link config}.\n */\n resolveConfig?(ctx: ConfigContext): Promise<ApplicationConfig | undefined>;\n}\n\n/**\n * A context object that is passed to the `resolveProperties` function.\n */\nexport interface ConfigContext {\n /**\n * The application's host element.\n */\n hostElement: HTMLElement;\n\n /**\n * Defined when the application forcefully restarts with new options.\n */\n overrides: ApplicationOverrides | undefined;\n\n /**\n * Returns an attribute from the application's root node.\n */\n getAttribute(name: string): string | undefined;\n}\n\n/**\n * Application overrides are defined when the is explicitly being restarted with new options.\n *\n * Options set through overrides cannot be overwritten by the `resolveConfig` hook.\n */\nexport interface ApplicationOverrides {\n /**\n * The new application locale.\n */\n locale?: string;\n\n /**\n * The new color mode.\n */\n colorMode?: ColorModeValue | \"system\";\n\n /**\n * The new used chakra system config.\n */\n chakraSystemConfig?: ChakraSystemConfig;\n}\n\n/**\n * Runtime application configuration.\n */\nexport interface ApplicationConfig {\n /**\n * Set this value to a locale string (e.g. \"en\") to for the application's locale.\n * The default behavior is to choose an appropriate locale for the current user based\n * on the browser's settings.\n *\n * The locale must be supported by the application.\n */\n locale?: string | undefined;\n\n /**\n * Configures the application's initial color mode.\n *\n * Use `system` to use the user's preferred color mode, derived from the browser or operating system.\n *\n * Default: `light`.\n */\n colorMode?: ColorModeValue | \"system\";\n\n /**\n * Properties specified here will override default properties of the application's packages.\n */\n properties?: ApplicationProperties | undefined;\n\n /**\n * Chakra styled system object.\n *\n * Used to configure chakra's theme.\n *\n * NOTE: This setting has priority over {@link CustomElementOptions.chakraSystemConfig}.\n */\n chakraSystemConfig?: ChakraSystemConfig;\n}\n\n/**\n * Allows the application to override default properties in all packages.\n *\n * Properties are typed when the package contains type definitions for them.\n */\nexport interface ApplicationProperties {\n /**\n * Key: the name of the package.\n * Value: A record of configuration properties (key/value pairs).\n *\n * Properties will override default property values in the package.\n */\n [packageName: string]: Record<string, unknown>;\n}\n\n/**\n * The interface implemented by web components produced via {@link createCustomElement}.\n */\nexport interface ApplicationElement extends HTMLElement {\n /**\n * Resolves to the element's API when the application has started.\n *\n * The API exposed by an application can be defined by implementing an {@link ApiExtension}.\n * For more details, open the documentation of the `@open-pioneer/integration` package.\n */\n when(): Promise<ApiMethods>;\n}\n\n/**\n * Advanced configuration that alters the behavior of the custom element.\n *\n * See {@link createCustomElement}.\n */\nexport interface AdvancedCustomElementOptions {\n /**\n * Enables or disables the [shadow root](https://developer.mozilla.org/en-US/docs/Web/API/ShadowRoot) inside the application's web component.\n *\n * Default: `true`.\n *\n * By default, trails applications use a shadow root to avoid conflicts (e.g. styles) with other parts of the site where the application may be embedded.\n *\n * Applications that use the entire browser viewport may not need this feature, since there may be no \"other\" parts that may conflict with the app.\n * In this case, you can disable the shadow root by setting this property to `false`.\n * In general, UI components used by the app (e.g. from Chakra UI) should work just as well when disabling the shadow root.\n * If you notice any problems, please file an issue.\n *\n * If you are developing UI components that are meant to be used in other applications, you should always use a shadow root to\n * ensure that your components work in that setting.\n */\n enableShadowRoot?: boolean;\n}\n\n/**\n * The class returned by a call to {@link createCustomElement}.\n */\nexport interface ApplicationElementConstructor {\n new (): ApplicationElement;\n}\n\n/**\n * Creates a new custom element class (web component) that can be registered within a DOM.\n *\n * @example\n * ```ts\n * import * as appMetadata from \"open-pioneer:app\";\n *\n * const CustomElementClazz = createCustomElement({\n * component: <div>Hello World!</div>,\n * appMetadata\n * });\n * customElements.define(\"sample-element\", CustomElementClazz);\n * ```\n */\nexport function createCustomElement(options: CustomElementOptions): ApplicationElementConstructor {\n class PioneerApplication extends HTMLElement implements ApplicationElement {\n #shadowRoot: ShadowRoot | undefined;\n #instance: AppInstance | undefined;\n\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n #deferredRestart: any; // A Timer\n\n static get observedAttributes(): string[] {\n return [];\n }\n\n constructor() {\n super();\n\n const enableShadowRoot = options.advanced?.enableShadowRoot ?? true;\n if (enableShadowRoot) {\n this.#shadowRoot = this.attachShadow({\n mode: \"open\"\n });\n } else {\n LOG.debug(\"Creating component instance without shadow root\");\n }\n\n if (import.meta.env.DEV) {\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n (this as any).$inspectElementState = () => this.#instance;\n }\n }\n\n connectedCallback() {\n LOG.debug(\"Launching application\");\n\n if (this.#instance) {\n this.#instance.destroy();\n }\n\n this.#instance = this.#createApplicationInstance();\n this.#instance.start();\n }\n\n disconnectedCallback() {\n LOG.debug(\"Shutting down application\");\n\n if (this.#deferredRestart) {\n clearTimeout(this.#deferredRestart);\n }\n this.#instance?.destroy();\n this.#instance = undefined;\n\n LOG.debug(\"Application destroyed\");\n }\n\n when() {\n if (!this.#instance) {\n return Promise.reject(\n new Error(\n ErrorId.NOT_MOUNTED,\n \"Cannot use the application's API because the HTML element has not yet been mounted into the DOM.\"\n )\n );\n }\n\n return this.#instance.whenAPI();\n }\n\n #triggerReload(overrides?: ApplicationOverrides) {\n // Defer the restart operation a tiny bit so calling code does not get surprised by the application's destruction.\n if (this.#deferredRestart) {\n clearTimeout(this.#deferredRestart);\n }\n this.#deferredRestart = setTimeout(() => {\n if (!this.#instance) {\n // disconnectedCallback was called in the meantime\n return;\n }\n\n LOG.debug(\"Restarting application with new options\", overrides);\n this.#instance.destroy();\n this.#instance = this.#createApplicationInstance(overrides);\n this.#instance.start();\n }, 1);\n }\n\n #createApplicationInstance(overrides?: ApplicationOverrides) {\n return new AppInstance({\n rootNode: this.#shadowRoot ?? document,\n hostElement: this,\n elementOptions: options,\n overrides: overrides,\n restart: this.#triggerReload.bind(this)\n });\n }\n }\n return PioneerApplication;\n}\n"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"CustomElement.js","sources":["CustomElement.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2023-2025 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nimport { SystemConfig as ChakraSystemConfig } from \"@chakra-ui/react\";\nimport { createLogger, Error } from \"@open-pioneer/core\";\nimport type { ServiceOptions } from \"./Service\";\nimport { sourceId } from \"open-pioneer:source-info\";\nimport { ComponentType } from \"react\";\nimport { type ApiMethods, type ColorModeValue, type ApiExtension } from \"./api\";\nimport { AppInstance } from \"./app\";\nimport { ErrorId } from \"./errors\";\nimport { ApplicationMetadata } from \"./metadata\";\n\nconst LOG = createLogger(sourceId);\n\n/**\n * Options for the {@link createCustomElement} function.\n */\nexport interface CustomElementOptions {\n /**\n * Rendered UI component.\n */\n component?: ComponentType<Record<string, string>>;\n\n /**\n * Application metadata (packages, services etc.).\n * This is usually autogenerated by importing the virtual `\"open-pioneer:app\"` module.\n */\n appMetadata?: ApplicationMetadata;\n\n /**\n * Application defined configuration.\n *\n * This option can be used to override default properties of the application's packages.\n *\n * All instances of the web component will share this static configuration.\n */\n config?: ApplicationConfig;\n\n /**\n * Chakra styled system object.\n *\n * Used to configure chakra's theme.\n */\n chakraSystemConfig?: ChakraSystemConfig;\n\n /**\n * Advanced configuration that alters the behavior of the custom element.\n */\n advanced?: AdvancedCustomElementOptions;\n\n /**\n * Function to provide additional application defined configuration parameters.\n *\n * Compared to {@link config}, this function receives a context object\n * that allows the developer to provide dynamic properties on a per-application instance basis.\n *\n * Parameters returned by this function take precedence over the ones defined by {@link config}.\n */\n resolveConfig?(ctx: ConfigContext): Promise<ApplicationConfig | undefined>;\n}\n\n/**\n * A context object that is passed to the `resolveProperties` function.\n */\nexport interface ConfigContext {\n /**\n * The application's host element.\n */\n hostElement: HTMLElement;\n\n /**\n * Defined when the application forcefully restarts with new options.\n */\n overrides: ApplicationOverrides | undefined;\n\n /**\n * Returns an attribute from the application's root node.\n */\n getAttribute(name: string): string | undefined;\n}\n\n/**\n * Application overrides are defined when the is explicitly being restarted with new options.\n *\n * Options set through overrides cannot be overwritten by the `resolveConfig` hook.\n */\nexport interface ApplicationOverrides {\n /**\n * The new application locale.\n */\n locale?: string;\n\n /**\n * The new color mode.\n */\n colorMode?: ColorModeValue | \"system\";\n\n /**\n * The new used chakra system config.\n */\n chakraSystemConfig?: ChakraSystemConfig;\n}\n\n/**\n * Runtime application configuration.\n */\nexport interface ApplicationConfig {\n /**\n * Set this value to a locale (BCP-47 string, e.g. `\"en\"`) to set the default message locale of the application.\n *\n * The default behavior is to choose an appropriate locale for the current user based\n * on the browser's settings.\n *\n * This locale should match one of the supported message locales defined by the application's package.\n */\n locale?: string | undefined;\n\n /**\n * The list of locales supported by the application.\n *\n * This allows a further restriction of the locales supported by the application, compared to the ones defined by the application's package.\n * It is not possible to extend the supported locales defined by the package, only to restrict them.\n *\n * If this property is not set, then the application supports all locales defined by the application's package.\n * If the values are not a valid subset of the application package supported locales, then the application will throw an error at startup.\n *\n * An empty array will disable loading of any message bundle.\n */\n supportedLocales?: string[] | undefined;\n\n /**\n * Configures the application's initial color mode.\n *\n * Use `system` to use the user's preferred color mode, derived from the browser or operating system.\n *\n * Default: `light`.\n */\n colorMode?: ColorModeValue | \"system\";\n\n /**\n * Properties specified here will override default properties of the application's packages.\n */\n properties?: ApplicationProperties | undefined;\n\n /**\n * Chakra styled system object.\n *\n * Used to configure chakra's theme.\n *\n * NOTE: This setting has priority over {@link CustomElementOptions.chakraSystemConfig}.\n */\n chakraSystemConfig?: ChakraSystemConfig;\n}\n\n/**\n * Allows the application to override default properties in all packages.\n *\n * Properties are typed when the package contains type definitions for them.\n */\nexport interface ApplicationProperties {\n /**\n * Key: the name of the package.\n * Value: A record of configuration properties (key/value pairs).\n *\n * Properties will override default property values in the package.\n */\n [packageName: string]: Record<string, unknown>;\n}\n\n/**\n * The interface implemented by web components produced via {@link createCustomElement}.\n */\nexport interface ApplicationElement extends HTMLElement {\n /**\n * Resolves to the element's API when the application has started.\n *\n * The API exposed by an application can be defined by implementing an {@link ApiExtension}.\n * For more details, open the documentation of the `@open-pioneer/integration` package.\n */\n when(): Promise<ApiMethods>;\n}\n\n/**\n * Advanced configuration that alters the behavior of the custom element.\n *\n * See {@link createCustomElement}.\n */\nexport interface AdvancedCustomElementOptions {\n /**\n * Enables or disables the [shadow root](https://developer.mozilla.org/en-US/docs/Web/API/ShadowRoot) inside the application's web component.\n *\n * Default: `true`.\n *\n * By default, trails applications use a shadow root to avoid conflicts (e.g. styles) with other parts of the site where the application may be embedded.\n *\n * Applications that use the entire browser viewport may not need this feature, since there may be no \"other\" parts that may conflict with the app.\n * In this case, you can disable the shadow root by setting this property to `false`.\n * In general, UI components used by the app (e.g. from Chakra UI) should work just as well when disabling the shadow root.\n * If you notice any problems, please file an issue.\n *\n * If you are developing UI components that are meant to be used in other applications, you should always use a shadow root to\n * ensure that your components work in that setting.\n */\n enableShadowRoot?: boolean;\n\n /**\n * Opts into live locale changes within the running application, without performing a full application restart.\n *\n * Default: `false`.\n *\n * Live locale changes preserve the application's state when the user changes the language.\n * It requires that react components and services in the application handle intl changes correctly (see, for example, {@link ServiceOptions.currentIntl}).\n *\n * Note that this option will become the new default in the next major release,\n * at which point this option will be removed.\n */\n enableLiveLocaleChanges?: boolean;\n}\n\n/**\n * The class returned by a call to {@link createCustomElement}.\n */\nexport interface ApplicationElementConstructor {\n new (): ApplicationElement;\n}\n\n/**\n * Creates a new custom element class (web component) that can be registered within a DOM.\n *\n * @example\n * ```ts\n * import * as appMetadata from \"open-pioneer:app\";\n *\n * const CustomElementClazz = createCustomElement({\n * component: <div>Hello World!</div>,\n * appMetadata\n * });\n * customElements.define(\"sample-element\", CustomElementClazz);\n * ```\n */\nexport function createCustomElement(options: CustomElementOptions): ApplicationElementConstructor {\n class PioneerApplication extends HTMLElement implements ApplicationElement {\n #shadowRoot: ShadowRoot | undefined;\n #instance: AppInstance | undefined;\n\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n #deferredRestart: any; // A Timer\n\n static get observedAttributes(): string[] {\n return [];\n }\n\n constructor() {\n super();\n\n const enableShadowRoot = options.advanced?.enableShadowRoot ?? true;\n if (enableShadowRoot) {\n this.#shadowRoot = this.attachShadow({\n mode: \"open\"\n });\n } else {\n LOG.debug(\"Creating component instance without shadow root\");\n }\n\n if (import.meta.env.DEV) {\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n (this as any).$inspectElementState = () => this.#instance;\n }\n }\n\n connectedCallback() {\n LOG.debug(\"Launching application\");\n\n if (this.#instance) {\n this.#instance.destroy();\n }\n\n this.#instance = this.#createApplicationInstance();\n this.#instance.start();\n }\n\n disconnectedCallback() {\n LOG.debug(\"Shutting down application\");\n\n if (this.#deferredRestart) {\n clearTimeout(this.#deferredRestart);\n }\n this.#instance?.destroy();\n this.#instance = undefined;\n\n LOG.debug(\"Application destroyed\");\n }\n\n when() {\n if (!this.#instance) {\n return Promise.reject(\n new Error(\n ErrorId.NOT_MOUNTED,\n \"Cannot use the application's API because the HTML element has not yet been mounted into the DOM.\"\n )\n );\n }\n\n return this.#instance.whenAPI();\n }\n\n #triggerReload(overrides?: ApplicationOverrides) {\n // Defer the restart operation a tiny bit so calling code does not get surprised by the application's destruction.\n if (this.#deferredRestart) {\n clearTimeout(this.#deferredRestart);\n }\n this.#deferredRestart = setTimeout(() => {\n if (!this.#instance) {\n // disconnectedCallback was called in the meantime\n return;\n }\n\n LOG.debug(\"Restarting application with new options\", overrides);\n this.#instance.destroy();\n this.#instance = this.#createApplicationInstance(overrides);\n this.#instance.start();\n }, 1);\n }\n\n #createApplicationInstance(overrides?: ApplicationOverrides) {\n return new AppInstance({\n rootNode: this.#shadowRoot ?? document,\n hostElement: this,\n elementOptions: options,\n overrides: overrides,\n restart: this.#triggerReload.bind(this)\n });\n }\n }\n return PioneerApplication;\n}\n"],"names":[],"mappings":"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"}
|
package/_virtual/source-info.js
CHANGED
|
@@ -4,7 +4,7 @@ const sourceId$5 = "@open-pioneer/runtime/app/AppInstance";
|
|
|
4
4
|
|
|
5
5
|
const sourceId$4 = "@open-pioneer/runtime/i18n/AppIntl";
|
|
6
6
|
|
|
7
|
-
const sourceId$3 = "@open-pioneer/runtime/
|
|
7
|
+
const sourceId$3 = "@open-pioneer/runtime/builtin-services/ApplicationContextImpl";
|
|
8
8
|
|
|
9
9
|
const sourceId$2 = "@open-pioneer/runtime/builtin-services/ApplicationLifecycleEventService";
|
|
10
10
|
|
|
@@ -12,5 +12,5 @@ const sourceId$1 = "@open-pioneer/runtime/builtin-services/NumberParserServiceIm
|
|
|
12
12
|
|
|
13
13
|
const sourceId = "@open-pioneer/runtime/service-layer/ServiceLayer";
|
|
14
14
|
|
|
15
|
-
export { sourceId$
|
|
15
|
+
export { sourceId$4 as sourceId, sourceId$3 as sourceId$1, sourceId$2, sourceId$1 as sourceId$3, sourceId as sourceId$4, sourceId$5, sourceId$6 };
|
|
16
16
|
//# sourceMappingURL=source-info.js.map
|
package/api.d.ts
CHANGED
|
@@ -72,6 +72,8 @@ export interface ApplicationContext extends DeclaredService<"runtime.Application
|
|
|
72
72
|
* Returns the current locale of the application.
|
|
73
73
|
*
|
|
74
74
|
* E.g. `"de-DE"`
|
|
75
|
+
*
|
|
76
|
+
* @deprecated Use {@link LocaleService.locale} instead.
|
|
75
77
|
*/
|
|
76
78
|
getLocale(): string;
|
|
77
79
|
/**
|
|
@@ -79,8 +81,7 @@ export interface ApplicationContext extends DeclaredService<"runtime.Application
|
|
|
79
81
|
* `locale` must be one of the supported locales, see {@link getSupportedLocales()} or `undefined` (for automatic locale).
|
|
80
82
|
* Note that `locale` does not need to be a precise match, e.g. `"de-DE"` is also valid if `"de"` is supported.
|
|
81
83
|
*
|
|
82
|
-
*
|
|
83
|
-
* > Altering the locale on the fly is possible in theory but has not been implemented yet.
|
|
84
|
+
* @deprecated Use {@link LocaleService.changeLocale} instead.
|
|
84
85
|
*/
|
|
85
86
|
setLocale(locale: string | undefined): void;
|
|
86
87
|
/**
|
|
@@ -88,9 +89,61 @@ export interface ApplicationContext extends DeclaredService<"runtime.Application
|
|
|
88
89
|
* the locales that have associated i18n messages.
|
|
89
90
|
*
|
|
90
91
|
* For example: `["de", "en"]`
|
|
92
|
+
* @deprecated Use {@link LocaleService.supportedMessageLocales} instead.
|
|
91
93
|
*/
|
|
92
94
|
getSupportedLocales(): readonly string[];
|
|
93
95
|
}
|
|
96
|
+
/**
|
|
97
|
+
* A service to inspect and control the application's active locale.
|
|
98
|
+
*
|
|
99
|
+
* ### `locale` vs `messageLocale`
|
|
100
|
+
*
|
|
101
|
+
* - {@link locale} is the locale used for `Intl`-based formatting (numbers, dates, ...).
|
|
102
|
+
* It may upgrade {@link messageLocale} with the user's script/region when compatible.
|
|
103
|
+
* - {@link messageLocale} is the locale of the currently loaded message bundle.
|
|
104
|
+
* Always one of {@link supportedMessageLocales}.
|
|
105
|
+
*
|
|
106
|
+
* ### Live locale changes
|
|
107
|
+
*
|
|
108
|
+
* If {@link supportsLiveChanges} is false, {@link changeLocale} triggers a full application restart.
|
|
109
|
+
* Otherwise the locale is updated in place.
|
|
110
|
+
*
|
|
111
|
+
* NOTE: live changes will become the new default with the next major release.
|
|
112
|
+
* Full application restarts due to locale changes will no longer happen then.
|
|
113
|
+
*/
|
|
114
|
+
export interface LocaleService extends DeclaredService<"runtime.LocaleService"> {
|
|
115
|
+
/**
|
|
116
|
+
* Reactive: locale used for Intl formatting.
|
|
117
|
+
* Shares language with {@link messageLocale}; may add script/region when compatible.
|
|
118
|
+
*/
|
|
119
|
+
readonly locale: Intl.Locale;
|
|
120
|
+
/**
|
|
121
|
+
* Reactive: the active locale used for i18n messages.
|
|
122
|
+
* If supportedMessageLocales is empty, this falls back to `en`.
|
|
123
|
+
*/
|
|
124
|
+
readonly messageLocale: Intl.Locale;
|
|
125
|
+
/**
|
|
126
|
+
* Locales for which the application has translated messages.
|
|
127
|
+
* This list may be empty, if the application has no message bundles.
|
|
128
|
+
*/
|
|
129
|
+
readonly supportedMessageLocales: readonly Intl.Locale[];
|
|
130
|
+
/**
|
|
131
|
+
* Flag indicating whether the application supports live changes for the current locale.
|
|
132
|
+
*
|
|
133
|
+
* If `true`, {@link changeLocale} applies the new locale in place.
|
|
134
|
+
* If `false`, {@link changeLocale} triggers a full application restart.
|
|
135
|
+
*/
|
|
136
|
+
readonly supportsLiveChanges: boolean;
|
|
137
|
+
/**
|
|
138
|
+
* Switches to `locale`. Best-fit match against {@link supportedMessageLocales};
|
|
139
|
+
* throws `UNSUPPORTED_LOCALE` on no match. `undefined` enables automatic picking.
|
|
140
|
+
*/
|
|
141
|
+
changeLocale(locale: Intl.Locale | undefined): Promise<void>;
|
|
142
|
+
/**
|
|
143
|
+
* True iff `locale` best-fits a supported message locale (regional variants accepted).
|
|
144
|
+
*/
|
|
145
|
+
supportsLocale(locale: Intl.Locale): boolean;
|
|
146
|
+
}
|
|
94
147
|
/**
|
|
95
148
|
* Implementing this interface allows a service to be notified on certain
|
|
96
149
|
* application-wide lifecycle events.
|
package/app/AppInstance.d.ts
CHANGED
package/app/AppInstance.js
CHANGED
|
@@ -1,14 +1,15 @@
|
|
|
1
|
-
import { computed, reactive, effect } from '@conterra/reactivity-core';
|
|
1
|
+
import { watchValue, computed, constant, reactive, effect } from '@conterra/reactivity-core';
|
|
2
2
|
import { createLogger, Error, createAbortError, destroyResource, createManualPromise, throwAbortError } from '@open-pioneer/core';
|
|
3
3
|
import { sourceId$5 as sourceId } from '../_virtual/source-info.js';
|
|
4
4
|
import { createElement } from 'react';
|
|
5
|
-
import { createBuiltinPackage, RUNTIME_THEME_SERVICE, RUNTIME_API_SERVICE, RUNTIME_APPLICATION_LIFECYCLE_EVENT_SERVICE, RUNTIME_AUTO_START } from '../builtin-services/index.js';
|
|
5
|
+
import { createBuiltinPackage, RUNTIME_THEME_SERVICE, RUNTIME_API_SERVICE, RUNTIME_APPLICATION_LIFECYCLE_EVENT_SERVICE, RUNTIME_LOCALE_SERVICE, RUNTIME_AUTO_START } from '../builtin-services/index.js';
|
|
6
6
|
import { DEFAULT_INITIAL_COLOR_MODE } from '../builtin-services/ThemeServiceImpl.js';
|
|
7
7
|
import { isShadowRoot, createAppRoot } from '../dom/index.js';
|
|
8
8
|
import { ErrorId } from '../errors.js';
|
|
9
|
-
import {
|
|
9
|
+
import { AppIntl } from '../i18n/AppIntl.js';
|
|
10
|
+
import { parseLocale } from '../i18n/intl-locale.js';
|
|
10
11
|
import { createPackageIntl } from '../i18n/PackageIntl.js';
|
|
11
|
-
import { getBrowserLocales,
|
|
12
|
+
import { getBrowserLocales, LocalePicker } from '../i18n/pick.js';
|
|
12
13
|
import { MESSAGES_BY_LOCALE, ErrorScreen } from '../react-integration/ErrorScreen.js';
|
|
13
14
|
import { ReactIntegration, EmptyComponent } from '../react-integration/ReactIntegration.js';
|
|
14
15
|
import { createPackages } from '../service-layer/PackageRepr.js';
|
|
@@ -37,6 +38,7 @@ class AppInstance {
|
|
|
37
38
|
themeService;
|
|
38
39
|
reactIntegration;
|
|
39
40
|
stylesWatch;
|
|
41
|
+
localeWatch;
|
|
40
42
|
constructor(options) {
|
|
41
43
|
this.options = options;
|
|
42
44
|
this.container = isShadowRoot(options.rootNode) ? options.rootNode : options.hostElement;
|
|
@@ -78,6 +80,7 @@ class AppInstance {
|
|
|
78
80
|
this.i18n = destroyResource(this.i18n);
|
|
79
81
|
this.serviceLayer = destroyResource(this.serviceLayer);
|
|
80
82
|
this.stylesWatch = destroyResource(this.stylesWatch);
|
|
83
|
+
this.localeWatch = destroyResource(this.localeWatch);
|
|
81
84
|
}
|
|
82
85
|
whenAPI() {
|
|
83
86
|
if (this.api) {
|
|
@@ -92,9 +95,32 @@ class AppInstance {
|
|
|
92
95
|
const config = this.config = await gatherConfig(hostElement, elementOptions, overrides);
|
|
93
96
|
this.checkAbort();
|
|
94
97
|
LOG.debug("Application config is", config);
|
|
95
|
-
const
|
|
98
|
+
const enableLiveLocaleChanges = elementOptions.advanced?.enableLiveLocaleChanges ?? false;
|
|
99
|
+
const restartWithLocale = (locale) => {
|
|
100
|
+
const restart = this.options.restart;
|
|
101
|
+
const themeService2 = this.themeService;
|
|
102
|
+
const colorMode = themeService2?.colorMode;
|
|
103
|
+
const chakraSystemConfig = themeService2?.systemConfig;
|
|
104
|
+
restart({ locale: locale?.baseName, colorMode, chakraSystemConfig });
|
|
105
|
+
};
|
|
106
|
+
const i18n = this.i18n = await AppIntl.create({
|
|
107
|
+
appMetadata: elementOptions.appMetadata,
|
|
108
|
+
forcedLocale: config.locale,
|
|
109
|
+
restrictSupportedLocales: config.supportedLocales,
|
|
110
|
+
supportsLiveChanges: enableLiveLocaleChanges,
|
|
111
|
+
restartWithLocale
|
|
112
|
+
});
|
|
96
113
|
this.checkAbort();
|
|
97
|
-
const appRoot = this.appRoot = createAppRoot(
|
|
114
|
+
const appRoot = this.appRoot = createAppRoot();
|
|
115
|
+
this.localeWatch = watchValue(
|
|
116
|
+
() => i18n.locale.baseName,
|
|
117
|
+
(locale) => {
|
|
118
|
+
appRoot.lang = locale;
|
|
119
|
+
},
|
|
120
|
+
{
|
|
121
|
+
immediate: true
|
|
122
|
+
}
|
|
123
|
+
);
|
|
98
124
|
this.container.appendChild(appRoot);
|
|
99
125
|
const styles = this.initStylesSignal();
|
|
100
126
|
const { serviceLayer, packages } = this.initServiceLayer({
|
|
@@ -120,7 +146,7 @@ class AppInstance {
|
|
|
120
146
|
appRoot,
|
|
121
147
|
serviceLayer,
|
|
122
148
|
packages,
|
|
123
|
-
locale: i18n.locale,
|
|
149
|
+
locale: computed(() => i18n.locale.baseName),
|
|
124
150
|
config: computed(() => themeService.systemConfig),
|
|
125
151
|
styles,
|
|
126
152
|
colorMode: computed(() => themeService.colorMode)
|
|
@@ -141,7 +167,7 @@ class AppInstance {
|
|
|
141
167
|
initStylesSignal() {
|
|
142
168
|
const stylesBox = this.options.elementOptions.appMetadata?.styles;
|
|
143
169
|
if (!stylesBox) {
|
|
144
|
-
return
|
|
170
|
+
return constant("");
|
|
145
171
|
}
|
|
146
172
|
const signal = reactive(stylesBox.value);
|
|
147
173
|
if (import.meta.hot) {
|
|
@@ -156,7 +182,7 @@ class AppInstance {
|
|
|
156
182
|
return signal;
|
|
157
183
|
}
|
|
158
184
|
initServiceLayer(config) {
|
|
159
|
-
const { hostElement, rootNode: shadowRoot, elementOptions
|
|
185
|
+
const { hostElement, rootNode: shadowRoot, elementOptions } = this.options;
|
|
160
186
|
const { container, properties, i18n, initialColorMode, initialSystemConfig } = config;
|
|
161
187
|
const packageMetadata = elementOptions.appMetadata?.packages ?? {};
|
|
162
188
|
const builtinPackage = createBuiltinPackage({
|
|
@@ -165,22 +191,7 @@ class AppInstance {
|
|
|
165
191
|
container,
|
|
166
192
|
initialColorMode,
|
|
167
193
|
initialSystemConfig,
|
|
168
|
-
|
|
169
|
-
supportedLocales: i18n.supportedMessageLocales,
|
|
170
|
-
changeLocale: (locale) => {
|
|
171
|
-
const supported = i18n.supportedMessageLocales;
|
|
172
|
-
if (locale != null && !i18n.supportsLocale(locale)) {
|
|
173
|
-
const supportedLocales = supported.join(", ");
|
|
174
|
-
throw new Error(
|
|
175
|
-
ErrorId.UNSUPPORTED_LOCALE,
|
|
176
|
-
`Unsupported locale '${locale}' (supported locales: ${supportedLocales}).`
|
|
177
|
-
);
|
|
178
|
-
}
|
|
179
|
-
const themeService = this.themeService;
|
|
180
|
-
const colorMode = themeService?.colorMode;
|
|
181
|
-
const chakraSystemConfig = themeService?.systemConfig;
|
|
182
|
-
restart({ locale, colorMode, chakraSystemConfig });
|
|
183
|
-
}
|
|
194
|
+
appIntl: i18n
|
|
184
195
|
});
|
|
185
196
|
const { serviceLayer, packages } = createServiceLayer({
|
|
186
197
|
packageMetadata,
|
|
@@ -230,11 +241,14 @@ class AppInstance {
|
|
|
230
241
|
}
|
|
231
242
|
showErrorScreen(error) {
|
|
232
243
|
const userLocales = getBrowserLocales();
|
|
233
|
-
const
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
const
|
|
237
|
-
const
|
|
244
|
+
const localePicker = new LocalePicker(
|
|
245
|
+
Object.keys(MESSAGES_BY_LOCALE).map((tag) => parseLocale(tag))
|
|
246
|
+
);
|
|
247
|
+
const { locale, messageLocale } = localePicker.pickSupportedLocale(void 0, userLocales);
|
|
248
|
+
const messages = MESSAGES_BY_LOCALE[messageLocale.baseName] ?? MESSAGES_BY_LOCALE["en"];
|
|
249
|
+
const intl = createPackageIntl(locale.baseName, messages);
|
|
250
|
+
const appRoot = this.appRoot = createAppRoot();
|
|
251
|
+
appRoot.lang = locale.baseName;
|
|
238
252
|
appRoot.classList.add("pioneer-root-error-screen");
|
|
239
253
|
this.container.appendChild(appRoot);
|
|
240
254
|
const styles = this.initStylesSignal();
|
|
@@ -242,10 +256,10 @@ class AppInstance {
|
|
|
242
256
|
rootNode: this.rootNode,
|
|
243
257
|
hostNode: this.options.hostElement,
|
|
244
258
|
appRoot,
|
|
245
|
-
locale,
|
|
246
|
-
config:
|
|
259
|
+
locale: constant(locale.baseName),
|
|
260
|
+
config: constant(this.options.elementOptions.chakraSystemConfig),
|
|
247
261
|
styles,
|
|
248
|
-
colorMode:
|
|
262
|
+
colorMode: constant(DEFAULT_INITIAL_COLOR_MODE)
|
|
249
263
|
});
|
|
250
264
|
this.reactIntegration.render(createElement(ErrorScreen, { intl, error }));
|
|
251
265
|
}
|
|
@@ -274,6 +288,9 @@ function createServiceLayer(config) {
|
|
|
274
288
|
{
|
|
275
289
|
interfaceName: RUNTIME_APPLICATION_LIFECYCLE_EVENT_SERVICE
|
|
276
290
|
},
|
|
291
|
+
{
|
|
292
|
+
interfaceName: RUNTIME_LOCALE_SERVICE
|
|
293
|
+
},
|
|
277
294
|
{
|
|
278
295
|
interfaceName: RUNTIME_THEME_SERVICE
|
|
279
296
|
},
|
package/app/AppInstance.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"AppInstance.js","sources":["AppInstance.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2023-2025 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nimport { computed, effect, reactive, ReadonlyReactive } from \"@conterra/reactivity-core\";\nimport {\n createAbortError,\n createLogger,\n createManualPromise,\n destroyResource,\n Error,\n ManualPromise,\n Resource,\n throwAbortError\n} from \"@open-pioneer/core\";\nimport { sourceId } from \"open-pioneer:source-info\";\nimport { createElement } from \"react\";\nimport { ApiMethods, ApiService, ColorModeValue, ThemeService } from \"../api\";\nimport {\n createBuiltinPackage,\n RUNTIME_API_SERVICE,\n RUNTIME_APPLICATION_LIFECYCLE_EVENT_SERVICE,\n RUNTIME_AUTO_START,\n RUNTIME_THEME_SERVICE\n} from \"../builtin-services\";\nimport { ApplicationLifecycleEventService } from \"../builtin-services/ApplicationLifecycleEventService\";\nimport { DEFAULT_INITIAL_COLOR_MODE } from \"../builtin-services/ThemeServiceImpl\";\nimport {\n ApplicationConfig,\n ApplicationOverrides,\n ApplicationProperties,\n CustomElementOptions\n} from \"../CustomElement\";\nimport { createAppRoot, isShadowRoot, RootNode } from \"../dom\";\nimport { ErrorId } from \"../errors\";\nimport { AppIntl, createPackageIntl, getBrowserLocales, I18nConfig, initI18n } from \"../i18n\";\nimport { PackageMetadata } from \"../metadata\";\nimport { ErrorScreen, MESSAGES_BY_LOCALE } from \"../react-integration/ErrorScreen\";\nimport { EmptyComponent, ReactIntegration } from \"../react-integration/ReactIntegration\";\nimport { ReferenceSpec } from \"../service-layer/InterfaceSpec\";\nimport { createPackages, PackageRepr } from \"../service-layer/PackageRepr\";\nimport { ServiceLayer } from \"../service-layer/ServiceLayer\";\nimport { gatherConfig } from \"./gatherConfig\";\n\nimport { SystemConfig } from \"@chakra-ui/react\";\nimport { logError } from \"./logErrors\";\n\nconst LOG = createLogger(sourceId);\n\nexport interface AppOptions {\n /** The root node that contains the application. */\n rootNode: RootNode;\n\n /** The HTML element that embeds the application. */\n hostElement: HTMLElement;\n\n /** Trails options for the application. */\n elementOptions: CustomElementOptions;\n\n /** These have higher priority than the options in `elementOptions`. */\n overrides: ApplicationOverrides | undefined;\n\n /**\n * A callback to restart the application with new options.\n * Currently only used for reloading with a certain locale.\n */\n restart: (overrides?: ApplicationOverrides) => void;\n}\n\nexport type AppState = \"not-started\" | \"starting\" | \"started\" | \"destroyed\" | \"error\";\n\nexport class AppInstance {\n private options: AppOptions;\n\n // Public API\n private apiPromise: ManualPromise<ApiMethods> | undefined; // Present when callers are waiting for the API\n private api: ApiMethods | undefined; // Present once started\n\n private state: AppState = \"not-started\";\n private rootNode: RootNode;\n private container: HTMLElement | ShadowRoot; // parent of .pioneer-root\n private appRoot: HTMLDivElement | undefined; // .pioneer-root\n private config: ApplicationConfig | undefined;\n private i18n: AppIntl | undefined;\n private serviceLayer: ServiceLayer | undefined;\n private lifecycleEvents: ApplicationLifecycleEventService | undefined;\n private themeService: ThemeService | undefined;\n private reactIntegration: ReactIntegration | undefined;\n\n private stylesWatch: Resource | undefined;\n\n constructor(options: AppOptions) {\n this.options = options;\n this.container = isShadowRoot(options.rootNode) ? options.rootNode : options.hostElement;\n this.rootNode = options.rootNode;\n }\n\n start() {\n if (this.state !== \"not-started\") {\n throw new Error(ErrorId.INTERNAL, `Cannot start element in state '${this.state}'`);\n }\n\n this.state = \"starting\";\n this.startImpl().catch((e) => {\n if (this.state === \"destroyed\") return;\n\n logError(e);\n this.reset();\n this.state = \"error\";\n this.showErrorScreen(e);\n });\n }\n\n destroy() {\n if (this.state === \"destroyed\") {\n return;\n }\n\n // Only call event listener when 'started' was also signalled.\n if (this.state === \"started\") {\n try {\n this.triggerApplicationLifecycleEvent(\"before-stop\");\n } catch (e) {\n void e; // Ignored\n }\n }\n this.state = \"destroyed\";\n this.reset();\n }\n\n private reset() {\n this.apiPromise?.reject(createAbortError());\n this.reactIntegration = destroyResource(this.reactIntegration);\n this.container.replaceChildren();\n this.appRoot = undefined;\n this.lifecycleEvents = undefined;\n this.themeService = undefined;\n this.i18n = destroyResource(this.i18n);\n this.serviceLayer = destroyResource(this.serviceLayer);\n this.stylesWatch = destroyResource(this.stylesWatch);\n }\n\n whenAPI(): Promise<ApiMethods> {\n if (this.api) {\n return Promise.resolve(this.api);\n }\n\n const apiPromise = (this.apiPromise ??= createManualPromise());\n return apiPromise.promise;\n }\n\n private async startImpl() {\n const { hostElement, elementOptions, overrides } = this.options;\n const root = this.rootNode;\n\n // Resolve custom application config\n const config = (this.config = await gatherConfig(hostElement, elementOptions, overrides));\n this.checkAbort();\n LOG.debug(\"Application config is\", config);\n\n // Decide on locale and load i18n messages (if any).\n const i18n = (this.i18n = await initI18n(elementOptions.appMetadata, config.locale));\n this.checkAbort();\n\n // Setup application root node in the shadow dom\n const appRoot = (this.appRoot = createAppRoot(i18n.locale));\n this.container.appendChild(appRoot);\n const styles = this.initStylesSignal();\n\n // Launch the service layer\n const { serviceLayer, packages } = this.initServiceLayer({\n container: appRoot,\n properties: config.properties,\n i18n,\n initialColorMode: config.colorMode,\n initialSystemConfig: config.chakraSystemConfig\n });\n this.lifecycleEvents = getInternalService<ApplicationLifecycleEventService>(\n serviceLayer,\n RUNTIME_APPLICATION_LIFECYCLE_EVENT_SERVICE\n );\n const themeService = (this.themeService = getInternalService<ThemeService>(\n serviceLayer,\n RUNTIME_THEME_SERVICE\n ));\n\n // init api, but do not wait for it\n const apiPromise = this.initAPI(serviceLayer);\n this.checkAbort();\n\n // Launch react\n this.reactIntegration = ReactIntegration.createForApp({\n rootNode: root,\n hostNode: hostElement,\n appRoot: appRoot,\n serviceLayer,\n packages,\n locale: i18n.locale,\n config: computed(() => themeService.systemConfig),\n styles,\n colorMode: computed(() => themeService.colorMode)\n });\n const component = this.options.elementOptions.component ?? EmptyComponent;\n this.reactIntegration.render(createElement(component));\n\n // wait for api, to ensure that the \"started\" state is only reached after the API is available.\n // but do not block the react rendering, to allow for a fast Time to Interactive and to show potential errors in the UI even if the API fails.\n await apiPromise;\n this.checkAbort();\n\n this.state = \"started\";\n\n this.triggerApplicationLifecycleEvent(\"after-start\");\n LOG.debug(\"Application started\");\n }\n\n /**\n * Returns a signal that contains the application's styles.\n * During development, the signal is updated when the user edits .css files.\n * In production, the signal is static.\n */\n private initStylesSignal(): ReadonlyReactive<string> {\n const stylesBox = this.options.elementOptions.appMetadata?.styles;\n if (!stylesBox) {\n return reactive(\"\");\n }\n\n const signal = reactive(stylesBox.value);\n if (import.meta.hot) {\n this.stylesWatch = effect(\n () => {\n signal.value = stylesBox.value;\n LOG.debug(\"Application styles changed\");\n },\n { dispatch: \"sync\" }\n );\n }\n return signal;\n }\n\n private initServiceLayer(config: {\n container: HTMLDivElement;\n properties: ApplicationProperties;\n i18n: AppIntl;\n initialColorMode: ColorModeValue | \"system\" | undefined;\n initialSystemConfig: SystemConfig | undefined;\n }) {\n const { hostElement, rootNode: shadowRoot, elementOptions, restart } = this.options;\n\n const { container, properties, i18n, initialColorMode, initialSystemConfig } = config;\n const packageMetadata = elementOptions.appMetadata?.packages ?? {};\n const builtinPackage = createBuiltinPackage({\n host: hostElement,\n rootNode: shadowRoot,\n container: container,\n initialColorMode,\n initialSystemConfig,\n locale: i18n.locale,\n supportedLocales: i18n.supportedMessageLocales,\n changeLocale: (locale) => {\n const supported = i18n.supportedMessageLocales;\n if (locale != null && !i18n.supportsLocale(locale)) {\n const supportedLocales = supported.join(\", \");\n throw new Error(\n ErrorId.UNSUPPORTED_LOCALE,\n `Unsupported locale '${locale}' (supported locales: ${supportedLocales}).`\n );\n }\n\n const themeService = this.themeService;\n const colorMode = themeService?.colorMode;\n const chakraSystemConfig = themeService?.systemConfig;\n restart({ locale, colorMode, chakraSystemConfig });\n }\n });\n const { serviceLayer, packages } = createServiceLayer({\n packageMetadata,\n builtinPackage,\n properties,\n i18n\n });\n this.serviceLayer = serviceLayer;\n\n if (LOG.isDebug()) {\n LOG.debug(\"Launching service layer with packages\", Object.fromEntries(packages));\n }\n serviceLayer.start();\n return { serviceLayer, packages };\n }\n\n private async initAPI(serviceLayer: ServiceLayer) {\n const apiService = getInternalService<ApiService>(serviceLayer, RUNTIME_API_SERVICE);\n try {\n const api = await apiService.getApi();\n this.checkAbort();\n this.api = api;\n LOG.debug(\"Application API initialized to\", api);\n this.apiPromise?.resolve(api);\n } catch (e) {\n const ex = new Error(\n ErrorId.INTERNAL,\n \"Failed to gather the application's API methods.\",\n {\n cause: e\n }\n );\n if (!this.apiPromise) {\n // no one is waiting yet.\n // keep the error for when they do\n this.apiPromise = createManualPromise();\n // prevent unhandled rejection if no one is waiting for the API\n this.apiPromise.promise.catch(() => {});\n }\n this.apiPromise.reject(ex);\n throw ex;\n }\n }\n\n private triggerApplicationLifecycleEvent(event: \"after-start\" | \"before-stop\") {\n this.lifecycleEvents?.emitLifecycleEvent(event);\n }\n\n private checkAbort() {\n if (this.state === \"destroyed\") {\n throwAbortError();\n }\n }\n\n private showErrorScreen(error: globalThis.Error) {\n const userLocales = getBrowserLocales();\n const i18nConfig = new I18nConfig(Object.keys(MESSAGES_BY_LOCALE));\n const { locale, messageLocale } = i18nConfig.pickSupportedLocale(undefined, userLocales);\n const messages =\n MESSAGES_BY_LOCALE[messageLocale as keyof typeof MESSAGES_BY_LOCALE] ??\n MESSAGES_BY_LOCALE[\"en\"];\n const intl = createPackageIntl(locale, messages);\n\n const appRoot = (this.appRoot = createAppRoot(locale));\n appRoot.classList.add(\"pioneer-root-error-screen\");\n this.container.appendChild(appRoot);\n\n const styles = this.initStylesSignal();\n\n this.reactIntegration = ReactIntegration.createForErrorScreen({\n rootNode: this.rootNode,\n hostNode: this.options.hostElement,\n appRoot: appRoot,\n locale: locale,\n config: reactive(this.options.elementOptions.chakraSystemConfig),\n styles,\n colorMode: reactive(DEFAULT_INITIAL_COLOR_MODE)\n });\n this.reactIntegration.render(createElement(ErrorScreen, { intl, error }));\n }\n}\n\nfunction createServiceLayer(config: {\n packageMetadata: Record<string, PackageMetadata> | undefined;\n properties: ApplicationProperties;\n builtinPackage: PackageRepr;\n i18n: AppIntl;\n}) {\n const { packageMetadata, properties, builtinPackage, i18n } = config;\n\n let packages: PackageRepr[];\n try {\n packages = createPackages(packageMetadata ?? {}, i18n, properties);\n } catch (e) {\n throw new Error(ErrorId.INVALID_METADATA, \"Failed to parse package metadata.\", {\n cause: e\n });\n }\n\n // Add builtin services defined within this package.\n {\n const index = packages.findIndex((pkg) => pkg.name === builtinPackage.name);\n if (index >= 0) {\n packages.splice(index, 1);\n }\n packages.push(builtinPackage);\n }\n\n // Automatically required references (-> forces services to start)\n const forcedReferences: ReferenceSpec[] = [\n {\n interfaceName: RUNTIME_API_SERVICE\n },\n {\n interfaceName: RUNTIME_APPLICATION_LIFECYCLE_EVENT_SERVICE\n },\n {\n interfaceName: RUNTIME_THEME_SERVICE\n },\n {\n interfaceName: RUNTIME_AUTO_START,\n all: true\n }\n ];\n const serviceLayer = new ServiceLayer(packages, forcedReferences);\n return {\n packages: new Map(packages.map((pkg) => [pkg.name, pkg])),\n serviceLayer: serviceLayer\n };\n}\n\nfunction getInternalService<T = unknown>(serviceLayer: ServiceLayer, interfaceName: string) {\n const result = serviceLayer.getService(\n \"@open-pioneer/runtime\",\n {\n interfaceName\n },\n { ignoreDeclarationCheck: true }\n );\n if (result.type !== \"found\") {\n throw new Error(\n ErrorId.INTERNAL,\n `Failed to find instance of '${interfaceName}' (result type '${result.type}').` +\n ` This is a builtin service that must be present exactly once.`\n );\n }\n\n return result.value.getInstanceOrThrow() as T;\n}\n"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"AppInstance.js","sources":["AppInstance.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2023-2025 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nimport {\n computed,\n constant,\n effect,\n reactive,\n ReadonlyReactive,\n watchValue\n} from \"@conterra/reactivity-core\";\nimport {\n createAbortError,\n createLogger,\n createManualPromise,\n destroyResource,\n Error,\n ManualPromise,\n Resource,\n throwAbortError\n} from \"@open-pioneer/core\";\nimport { sourceId } from \"open-pioneer:source-info\";\nimport { createElement } from \"react\";\nimport { ApiMethods, ApiService, ColorModeValue, ThemeService } from \"../api\";\nimport {\n createBuiltinPackage,\n RUNTIME_API_SERVICE,\n RUNTIME_APPLICATION_LIFECYCLE_EVENT_SERVICE,\n RUNTIME_AUTO_START,\n RUNTIME_LOCALE_SERVICE,\n RUNTIME_THEME_SERVICE\n} from \"../builtin-services\";\nimport { ApplicationLifecycleEventService } from \"../builtin-services/ApplicationLifecycleEventService\";\nimport { DEFAULT_INITIAL_COLOR_MODE } from \"../builtin-services/ThemeServiceImpl\";\nimport {\n ApplicationConfig,\n ApplicationOverrides,\n ApplicationProperties,\n CustomElementOptions\n} from \"../CustomElement\";\nimport { createAppRoot, isShadowRoot, RootNode } from \"../dom\";\nimport { ErrorId } from \"../errors\";\nimport { AppIntl, createPackageIntl, getBrowserLocales, LocalePicker, parseLocale } from \"../i18n\";\nimport { PackageMetadata } from \"../metadata\";\nimport { ErrorScreen, MESSAGES_BY_LOCALE } from \"../react-integration/ErrorScreen\";\nimport { EmptyComponent, ReactIntegration } from \"../react-integration/ReactIntegration\";\nimport { ReferenceSpec } from \"../service-layer/InterfaceSpec\";\nimport { createPackages, PackageRepr } from \"../service-layer/PackageRepr\";\nimport { ServiceLayer } from \"../service-layer/ServiceLayer\";\nimport { gatherConfig } from \"./gatherConfig\";\n\nimport { SystemConfig } from \"@chakra-ui/react\";\nimport { logError } from \"./logErrors\";\n\nconst LOG = createLogger(sourceId);\n\nexport interface AppOptions {\n /** The root node that contains the application. */\n rootNode: RootNode;\n\n /** The HTML element that embeds the application. */\n hostElement: HTMLElement;\n\n /** Trails options for the application. */\n elementOptions: CustomElementOptions;\n\n /** These have higher priority than the options in `elementOptions`. */\n overrides: ApplicationOverrides | undefined;\n\n /**\n * A callback to restart the application with new options.\n * Currently only used for reloading with a certain locale.\n */\n restart: (overrides?: ApplicationOverrides) => void;\n}\n\nexport type AppState = \"not-started\" | \"starting\" | \"started\" | \"destroyed\" | \"error\";\n\nexport class AppInstance {\n private options: AppOptions;\n\n // Public API\n private apiPromise: ManualPromise<ApiMethods> | undefined; // Present when callers are waiting for the API\n private api: ApiMethods | undefined; // Present once started\n\n private state: AppState = \"not-started\";\n private rootNode: RootNode;\n private container: HTMLElement | ShadowRoot; // parent of .pioneer-root\n private appRoot: HTMLDivElement | undefined; // .pioneer-root\n private config: ApplicationConfig | undefined;\n private i18n: AppIntl | undefined;\n private serviceLayer: ServiceLayer | undefined;\n private lifecycleEvents: ApplicationLifecycleEventService | undefined;\n private themeService: ThemeService | undefined;\n private reactIntegration: ReactIntegration | undefined;\n\n private stylesWatch: Resource | undefined;\n private localeWatch: Resource | undefined;\n\n constructor(options: AppOptions) {\n this.options = options;\n this.container = isShadowRoot(options.rootNode) ? options.rootNode : options.hostElement;\n this.rootNode = options.rootNode;\n }\n\n start() {\n if (this.state !== \"not-started\") {\n throw new Error(ErrorId.INTERNAL, `Cannot start element in state '${this.state}'`);\n }\n\n this.state = \"starting\";\n this.startImpl().catch((e) => {\n if (this.state === \"destroyed\") return;\n\n logError(e);\n this.reset();\n this.state = \"error\";\n this.showErrorScreen(e);\n });\n }\n\n destroy() {\n if (this.state === \"destroyed\") {\n return;\n }\n\n // Only call event listener when 'started' was also signalled.\n if (this.state === \"started\") {\n try {\n this.triggerApplicationLifecycleEvent(\"before-stop\");\n } catch (e) {\n void e; // Ignored\n }\n }\n this.state = \"destroyed\";\n this.reset();\n }\n\n private reset() {\n this.apiPromise?.reject(createAbortError());\n this.reactIntegration = destroyResource(this.reactIntegration);\n this.container.replaceChildren();\n this.appRoot = undefined;\n this.lifecycleEvents = undefined;\n this.themeService = undefined;\n this.i18n = destroyResource(this.i18n);\n this.serviceLayer = destroyResource(this.serviceLayer);\n this.stylesWatch = destroyResource(this.stylesWatch);\n this.localeWatch = destroyResource(this.localeWatch);\n }\n\n whenAPI(): Promise<ApiMethods> {\n if (this.api) {\n return Promise.resolve(this.api);\n }\n\n const apiPromise = (this.apiPromise ??= createManualPromise());\n return apiPromise.promise;\n }\n\n private async startImpl() {\n const { hostElement, elementOptions, overrides } = this.options;\n const root = this.rootNode;\n\n // Resolve custom application config\n const config = (this.config = await gatherConfig(hostElement, elementOptions, overrides));\n this.checkAbort();\n LOG.debug(\"Application config is\", config);\n\n // TODO (next major): always true (option can be removed).\n // Currently false by default (needs to be enabled) to preserve backwards compatibility.\n const enableLiveLocaleChanges = elementOptions.advanced?.enableLiveLocaleChanges ?? false;\n\n // TODO (next major): Remove restarting code!\n const restartWithLocale = (locale: Intl.Locale | undefined) => {\n // this code is triggered, when the app calls changeLocale while reactive switching is disabled.\n const restart = this.options.restart;\n const themeService = this.themeService;\n const colorMode = themeService?.colorMode;\n const chakraSystemConfig = themeService?.systemConfig;\n restart({ locale: locale?.baseName, colorMode, chakraSystemConfig });\n };\n\n // Decide on locale and load i18n messages (if any).\n const i18n = (this.i18n = await AppIntl.create({\n appMetadata: elementOptions.appMetadata,\n forcedLocale: config.locale,\n restrictSupportedLocales: config.supportedLocales,\n supportsLiveChanges: enableLiveLocaleChanges,\n restartWithLocale\n }));\n this.checkAbort();\n\n // Setup application root node in the shadow dom\n const appRoot = (this.appRoot = createAppRoot());\n this.localeWatch = watchValue(\n () => i18n.locale.baseName,\n (locale) => {\n appRoot.lang = locale;\n },\n {\n immediate: true\n }\n );\n this.container.appendChild(appRoot);\n\n const styles = this.initStylesSignal();\n\n // Launch the service layer\n const { serviceLayer, packages } = this.initServiceLayer({\n container: appRoot,\n properties: config.properties,\n i18n,\n initialColorMode: config.colorMode,\n initialSystemConfig: config.chakraSystemConfig\n });\n this.lifecycleEvents = getInternalService<ApplicationLifecycleEventService>(\n serviceLayer,\n RUNTIME_APPLICATION_LIFECYCLE_EVENT_SERVICE\n );\n const themeService = (this.themeService = getInternalService<ThemeService>(\n serviceLayer,\n RUNTIME_THEME_SERVICE\n ));\n\n // init api, but do not wait for it\n const apiPromise = this.initAPI(serviceLayer);\n this.checkAbort();\n\n // Launch react\n this.reactIntegration = ReactIntegration.createForApp({\n rootNode: root,\n hostNode: hostElement,\n appRoot: appRoot,\n serviceLayer,\n packages,\n locale: computed(() => i18n.locale.baseName),\n config: computed(() => themeService.systemConfig),\n styles,\n colorMode: computed(() => themeService.colorMode)\n });\n const component = this.options.elementOptions.component ?? EmptyComponent;\n this.reactIntegration.render(createElement(component));\n\n // wait for api, to ensure that the \"started\" state is only reached after the API is available.\n // but do not block the react rendering, to allow for a fast Time to Interactive and to show potential errors in the UI even if the API fails.\n await apiPromise;\n this.checkAbort();\n\n this.state = \"started\";\n\n this.triggerApplicationLifecycleEvent(\"after-start\");\n LOG.debug(\"Application started\");\n }\n\n /**\n * Returns a signal that contains the application's styles.\n * During development, the signal is updated when the user edits .css files.\n * In production, the signal is static.\n */\n private initStylesSignal(): ReadonlyReactive<string> {\n const stylesBox = this.options.elementOptions.appMetadata?.styles;\n if (!stylesBox) {\n return constant(\"\");\n }\n\n const signal = reactive(stylesBox.value);\n if (import.meta.hot) {\n this.stylesWatch = effect(\n () => {\n signal.value = stylesBox.value;\n LOG.debug(\"Application styles changed\");\n },\n { dispatch: \"sync\" }\n );\n }\n return signal;\n }\n\n private initServiceLayer(config: {\n container: HTMLDivElement;\n properties: ApplicationProperties;\n i18n: AppIntl;\n initialColorMode: ColorModeValue | \"system\" | undefined;\n initialSystemConfig: SystemConfig | undefined;\n }) {\n const { hostElement, rootNode: shadowRoot, elementOptions } = this.options;\n const { container, properties, i18n, initialColorMode, initialSystemConfig } = config;\n\n const packageMetadata = elementOptions.appMetadata?.packages ?? {};\n const builtinPackage = createBuiltinPackage({\n host: hostElement,\n rootNode: shadowRoot,\n container: container,\n initialColorMode,\n initialSystemConfig,\n appIntl: i18n\n });\n const { serviceLayer, packages } = createServiceLayer({\n packageMetadata,\n builtinPackage,\n properties,\n i18n\n });\n this.serviceLayer = serviceLayer;\n\n if (LOG.isDebug()) {\n LOG.debug(\"Launching service layer with packages\", Object.fromEntries(packages));\n }\n serviceLayer.start();\n return { serviceLayer, packages };\n }\n\n private async initAPI(serviceLayer: ServiceLayer) {\n const apiService = getInternalService<ApiService>(serviceLayer, RUNTIME_API_SERVICE);\n try {\n const api = await apiService.getApi();\n this.checkAbort();\n this.api = api;\n LOG.debug(\"Application API initialized to\", api);\n this.apiPromise?.resolve(api);\n } catch (e) {\n const ex = new Error(\n ErrorId.INTERNAL,\n \"Failed to gather the application's API methods.\",\n {\n cause: e\n }\n );\n if (!this.apiPromise) {\n // no one is waiting yet.\n // keep the error for when they do\n this.apiPromise = createManualPromise();\n // prevent unhandled rejection if no one is waiting for the API\n this.apiPromise.promise.catch(() => {});\n }\n this.apiPromise.reject(ex);\n throw ex;\n }\n }\n\n private triggerApplicationLifecycleEvent(event: \"after-start\" | \"before-stop\") {\n this.lifecycleEvents?.emitLifecycleEvent(event);\n }\n\n private checkAbort() {\n if (this.state === \"destroyed\") {\n throwAbortError();\n }\n }\n\n private showErrorScreen(error: globalThis.Error) {\n const userLocales = getBrowserLocales();\n const localePicker = new LocalePicker(\n Object.keys(MESSAGES_BY_LOCALE).map((tag) => parseLocale(tag))\n );\n const { locale, messageLocale } = localePicker.pickSupportedLocale(undefined, userLocales);\n const messages =\n MESSAGES_BY_LOCALE[messageLocale.baseName as keyof typeof MESSAGES_BY_LOCALE] ??\n MESSAGES_BY_LOCALE[\"en\"];\n const intl = createPackageIntl(locale.baseName, messages);\n\n const appRoot = (this.appRoot = createAppRoot());\n appRoot.lang = locale.baseName;\n appRoot.classList.add(\"pioneer-root-error-screen\");\n this.container.appendChild(appRoot);\n\n const styles = this.initStylesSignal();\n\n this.reactIntegration = ReactIntegration.createForErrorScreen({\n rootNode: this.rootNode,\n hostNode: this.options.hostElement,\n appRoot: appRoot,\n locale: constant(locale.baseName),\n config: constant(this.options.elementOptions.chakraSystemConfig),\n styles,\n colorMode: constant(DEFAULT_INITIAL_COLOR_MODE)\n });\n this.reactIntegration.render(createElement(ErrorScreen, { intl, error }));\n }\n}\n\nfunction createServiceLayer(config: {\n packageMetadata: Record<string, PackageMetadata> | undefined;\n properties: ApplicationProperties;\n builtinPackage: PackageRepr;\n i18n: AppIntl;\n}) {\n const { packageMetadata, properties, builtinPackage, i18n } = config;\n\n let packages: PackageRepr[];\n try {\n packages = createPackages(packageMetadata ?? {}, i18n, properties);\n } catch (e) {\n throw new Error(ErrorId.INVALID_METADATA, \"Failed to parse package metadata.\", {\n cause: e\n });\n }\n\n // Add builtin services defined within this package.\n {\n const index = packages.findIndex((pkg) => pkg.name === builtinPackage.name);\n if (index >= 0) {\n packages.splice(index, 1);\n }\n packages.push(builtinPackage);\n }\n\n // Automatically required references (-> forces services to start)\n const forcedReferences: ReferenceSpec[] = [\n {\n interfaceName: RUNTIME_API_SERVICE\n },\n {\n interfaceName: RUNTIME_APPLICATION_LIFECYCLE_EVENT_SERVICE\n },\n {\n interfaceName: RUNTIME_LOCALE_SERVICE\n },\n {\n interfaceName: RUNTIME_THEME_SERVICE\n },\n {\n interfaceName: RUNTIME_AUTO_START,\n all: true\n }\n ];\n const serviceLayer = new ServiceLayer(packages, forcedReferences);\n return {\n packages: new Map(packages.map((pkg) => [pkg.name, pkg])),\n serviceLayer: serviceLayer\n };\n}\n\nfunction getInternalService<T = unknown>(serviceLayer: ServiceLayer, interfaceName: string) {\n const result = serviceLayer.getService(\n \"@open-pioneer/runtime\",\n {\n interfaceName\n },\n { ignoreDeclarationCheck: true }\n );\n if (result.type !== \"found\") {\n throw new Error(\n ErrorId.INTERNAL,\n `Failed to find instance of '${interfaceName}' (result type '${result.type}').` +\n ` This is a builtin service that must be present exactly once.`\n );\n }\n\n return result.value.getInstanceOrThrow() as T;\n}\n"],"names":["themeService"],"mappings":"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"}
|
package/app/gatherConfig.js
CHANGED
package/app/gatherConfig.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"gatherConfig.js","sources":["gatherConfig.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 {\n ApplicationConfig,\n ApplicationOverrides,\n ApplicationProperties,\n CustomElementOptions\n} from \"../CustomElement\";\nimport { ErrorId } from \"../errors\";\n\n/**\n * Gathers application properties by reading them from the options object\n * and by (optionally) invoking the `resolveProperties` hook.\n */\nexport async function gatherConfig(\n hostElement: HTMLElement,\n options: CustomElementOptions,\n overrides?: ApplicationOverrides\n): Promise<Required<ApplicationConfig>> {\n let configs: ApplicationConfig[];\n try {\n const staticConfig = options.config ?? {};\n const dynamicConfig =\n (await options.resolveConfig?.({\n hostElement,\n getAttribute(name) {\n return hostElement.getAttribute(name) ?? undefined;\n },\n overrides\n })) ?? {};\n\n configs = [\n {\n chakraSystemConfig: options.chakraSystemConfig\n },\n staticConfig,\n dynamicConfig\n ];\n } catch (e) {\n throw new Error(\n ErrorId.CONFIG_RESOLUTION_FAILED,\n \"Failed to resolve application properties.\",\n {\n cause: e\n }\n );\n }\n\n const merged = mergeConfigs(configs);\n if (overrides) {\n if (overrides.locale) {\n merged.locale = overrides.locale;\n }\n if (overrides.colorMode) {\n merged.colorMode = overrides.colorMode;\n }\n if (overrides.chakraSystemConfig) {\n merged.chakraSystemConfig = overrides.chakraSystemConfig;\n }\n }\n\n return merged;\n}\n\n/**\n * Merges application configurations into a single object.\n * Properties / config parameters at a later position overwrite properties from earlier ones.\n */\nfunction mergeConfigs(configs: ApplicationConfig[]): Required<ApplicationConfig> {\n // Merge simple values by assigning them in order\n const mergedConfig: Required<ApplicationConfig> = Object.assign(\n {\n locale: undefined,\n chakraSystemConfig: undefined,\n colorMode: undefined,\n properties: {}\n } satisfies ApplicationConfig,\n ...configs\n );\n\n // Deep merge for application properties\n const mergedProperties: ApplicationProperties = (mergedConfig.properties = {});\n for (const config of configs) {\n for (const [packageName, packageProperties] of Object.entries(config.properties ?? {})) {\n const mergedPackageProps = (mergedProperties[packageName] ??= {});\n Object.assign(mergedPackageProps, packageProperties);\n }\n }\n\n return mergedConfig;\n}\n"],"names":[],"mappings":";;;AAeA,eAAsB,YAAA,CAClB,WAAA,EACA,OAAA,EACA,SAAA,EACoC;AACpC,EAAA,IAAI,OAAA;AACJ,EAAA,IAAI;AACA,IAAA,MAAM,YAAA,GAAe,OAAA,CAAQ,MAAA,IAAU,EAAC;AACxC,IAAA,MAAM,aAAA,GACD,MAAM,OAAA,CAAQ,aAAA,GAAgB;AAAA,MAC3B,WAAA;AAAA,MACA,aAAa,IAAA,EAAM;AACf,QAAA,OAAO,WAAA,CAAY,YAAA,CAAa,IAAI,CAAA,IAAK,KAAA,CAAA;AAAA,MAC7C,CAAA;AAAA,MACA;AAAA,KACH,KAAM,EAAC;AAEZ,IAAA,OAAA,GAAU;AAAA,MACN;AAAA,QACI,oBAAoB,OAAA,CAAQ;AAAA,OAChC;AAAA,MACA,YAAA;AAAA,MACA;AAAA,KACJ;AAAA,EACJ,SAAS,CAAA,EAAG;AACR,IAAA,MAAM,IAAI,KAAA;AAAA,MACN,OAAA,CAAQ,wBAAA;AAAA,MACR,2CAAA;AAAA,MACA;AAAA,QACI,KAAA,EAAO;AAAA;AACX,KACJ;AAAA,EACJ;AAEA,EAAA,MAAM,MAAA,GAAS,aAAa,OAAO,CAAA;AACnC,EAAA,IAAI,SAAA,EAAW;AACX,IAAA,IAAI,UAAU,MAAA,EAAQ;AAClB,MAAA,MAAA,CAAO,SAAS,SAAA,CAAU,MAAA;AAAA,IAC9B;AACA,IAAA,IAAI,UAAU,SAAA,EAAW;AACrB,MAAA,MAAA,CAAO,YAAY,SAAA,CAAU,SAAA;AAAA,IACjC;AACA,IAAA,IAAI,UAAU,kBAAA,EAAoB;AAC9B,MAAA,MAAA,CAAO,qBAAqB,SAAA,CAAU,kBAAA;AAAA,IAC1C;AAAA,EACJ;AAEA,EAAA,OAAO,MAAA;AACX;AAMA,SAAS,aAAa,OAAA,EAA2D;AAE7E,EAAA,MAAM,eAA4C,MAAA,CAAO,MAAA;AAAA,IACrD;AAAA,MACI,MAAA,EAAQ,MAAA;AAAA,MACR,kBAAA,EAAoB,MAAA;AAAA,MACpB,SAAA,EAAW,MAAA;AAAA,MACX,YAAY;AAAC,KACjB;AAAA,IACA,GAAG;AAAA,GACP;AAGA,EAAA,MAAM,gBAAA,GAA2C,YAAA,CAAa,UAAA,GAAa,EAAC;AAC5E,EAAA,KAAA,MAAW,UAAU,OAAA,EAAS;AAC1B,IAAA,KAAA,MAAW,CAAC,WAAA,EAAa,iBAAiB,CAAA,IAAK,MAAA,CAAO,QAAQ,MAAA,CAAO,UAAA,IAAc,EAAE,CAAA,EAAG;AACpF,MAAA,MAAM,kBAAA,GAAsB,gBAAA,CAAiB,WAAW,CAAA,KAAM,EAAC;AAC/D,MAAA,MAAA,CAAO,MAAA,CAAO,oBAAoB,iBAAiB,CAAA;AAAA,IACvD;AAAA,EACJ;AAEA,EAAA,OAAO,YAAA;AACX;;;;"}
|
|
1
|
+
{"version":3,"file":"gatherConfig.js","sources":["gatherConfig.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 {\n ApplicationConfig,\n ApplicationOverrides,\n ApplicationProperties,\n CustomElementOptions\n} from \"../CustomElement\";\nimport { ErrorId } from \"../errors\";\n\n/**\n * Gathers application properties by reading them from the options object\n * and by (optionally) invoking the `resolveProperties` hook.\n */\nexport async function gatherConfig(\n hostElement: HTMLElement,\n options: CustomElementOptions,\n overrides?: ApplicationOverrides\n): Promise<Required<ApplicationConfig>> {\n let configs: ApplicationConfig[];\n try {\n const staticConfig = options.config ?? {};\n const dynamicConfig =\n (await options.resolveConfig?.({\n hostElement,\n getAttribute(name) {\n return hostElement.getAttribute(name) ?? undefined;\n },\n overrides\n })) ?? {};\n\n configs = [\n {\n chakraSystemConfig: options.chakraSystemConfig\n },\n staticConfig,\n dynamicConfig\n ];\n } catch (e) {\n throw new Error(\n ErrorId.CONFIG_RESOLUTION_FAILED,\n \"Failed to resolve application properties.\",\n {\n cause: e\n }\n );\n }\n\n const merged = mergeConfigs(configs);\n if (overrides) {\n if (overrides.locale) {\n merged.locale = overrides.locale;\n }\n if (overrides.colorMode) {\n merged.colorMode = overrides.colorMode;\n }\n if (overrides.chakraSystemConfig) {\n merged.chakraSystemConfig = overrides.chakraSystemConfig;\n }\n }\n\n return merged;\n}\n\n/**\n * Merges application configurations into a single object.\n * Properties / config parameters at a later position overwrite properties from earlier ones.\n */\nfunction mergeConfigs(configs: ApplicationConfig[]): Required<ApplicationConfig> {\n // Merge simple values by assigning them in order\n const mergedConfig: Required<ApplicationConfig> = Object.assign(\n {\n locale: undefined,\n supportedLocales: undefined,\n chakraSystemConfig: undefined,\n colorMode: undefined,\n properties: {}\n } satisfies ApplicationConfig,\n ...configs\n );\n\n // Deep merge for application properties\n const mergedProperties: ApplicationProperties = (mergedConfig.properties = {});\n for (const config of configs) {\n for (const [packageName, packageProperties] of Object.entries(config.properties ?? {})) {\n const mergedPackageProps = (mergedProperties[packageName] ??= {});\n Object.assign(mergedPackageProps, packageProperties);\n }\n }\n\n return mergedConfig;\n}\n"],"names":[],"mappings":";;;AAeA,eAAsB,YAAA,CAClB,WAAA,EACA,OAAA,EACA,SAAA,EACoC;AACpC,EAAA,IAAI,OAAA;AACJ,EAAA,IAAI;AACA,IAAA,MAAM,YAAA,GAAe,OAAA,CAAQ,MAAA,IAAU,EAAC;AACxC,IAAA,MAAM,aAAA,GACD,MAAM,OAAA,CAAQ,aAAA,GAAgB;AAAA,MAC3B,WAAA;AAAA,MACA,aAAa,IAAA,EAAM;AACf,QAAA,OAAO,WAAA,CAAY,YAAA,CAAa,IAAI,CAAA,IAAK,KAAA,CAAA;AAAA,MAC7C,CAAA;AAAA,MACA;AAAA,KACH,KAAM,EAAC;AAEZ,IAAA,OAAA,GAAU;AAAA,MACN;AAAA,QACI,oBAAoB,OAAA,CAAQ;AAAA,OAChC;AAAA,MACA,YAAA;AAAA,MACA;AAAA,KACJ;AAAA,EACJ,SAAS,CAAA,EAAG;AACR,IAAA,MAAM,IAAI,KAAA;AAAA,MACN,OAAA,CAAQ,wBAAA;AAAA,MACR,2CAAA;AAAA,MACA;AAAA,QACI,KAAA,EAAO;AAAA;AACX,KACJ;AAAA,EACJ;AAEA,EAAA,MAAM,MAAA,GAAS,aAAa,OAAO,CAAA;AACnC,EAAA,IAAI,SAAA,EAAW;AACX,IAAA,IAAI,UAAU,MAAA,EAAQ;AAClB,MAAA,MAAA,CAAO,SAAS,SAAA,CAAU,MAAA;AAAA,IAC9B;AACA,IAAA,IAAI,UAAU,SAAA,EAAW;AACrB,MAAA,MAAA,CAAO,YAAY,SAAA,CAAU,SAAA;AAAA,IACjC;AACA,IAAA,IAAI,UAAU,kBAAA,EAAoB;AAC9B,MAAA,MAAA,CAAO,qBAAqB,SAAA,CAAU,kBAAA;AAAA,IAC1C;AAAA,EACJ;AAEA,EAAA,OAAO,MAAA;AACX;AAMA,SAAS,aAAa,OAAA,EAA2D;AAE7E,EAAA,MAAM,eAA4C,MAAA,CAAO,MAAA;AAAA,IACrD;AAAA,MACI,MAAA,EAAQ,MAAA;AAAA,MACR,gBAAA,EAAkB,MAAA;AAAA,MAClB,kBAAA,EAAoB,MAAA;AAAA,MACpB,SAAA,EAAW,MAAA;AAAA,MACX,YAAY;AAAC,KACjB;AAAA,IACA,GAAG;AAAA,GACP;AAGA,EAAA,MAAM,gBAAA,GAA2C,YAAA,CAAa,UAAA,GAAa,EAAC;AAC5E,EAAA,KAAA,MAAW,UAAU,OAAA,EAAS;AAC1B,IAAA,KAAA,MAAW,CAAC,WAAA,EAAa,iBAAiB,CAAA,IAAK,MAAA,CAAO,QAAQ,MAAA,CAAO,UAAA,IAAc,EAAE,CAAA,EAAG;AACpF,MAAA,MAAM,kBAAA,GAAsB,gBAAA,CAAiB,WAAW,CAAA,KAAM,EAAC;AAC/D,MAAA,MAAA,CAAO,MAAA,CAAO,oBAAoB,iBAAiB,CAAA;AAAA,IACvD;AAAA,EACJ;AAEA,EAAA,OAAO,YAAA;AACX;;;;"}
|
|
@@ -1,23 +1,27 @@
|
|
|
1
|
-
import { ApplicationContext } from "../api";
|
|
1
|
+
import { ApplicationContext, LocaleService } from "../api";
|
|
2
2
|
import { RootNode } from "../dom";
|
|
3
3
|
import { ServiceOptions } from "../Service";
|
|
4
4
|
export interface ApplicationContextProperties {
|
|
5
5
|
host: HTMLElement;
|
|
6
6
|
rootNode: RootNode;
|
|
7
7
|
container: HTMLElement;
|
|
8
|
-
locale: string;
|
|
9
|
-
supportedLocales: string[];
|
|
10
|
-
/** A callback to change the application's locale is injected by the runtime. */
|
|
11
|
-
changeLocale(locale: string): void;
|
|
12
8
|
}
|
|
9
|
+
interface ServiceReferences {
|
|
10
|
+
localeService: LocaleService;
|
|
11
|
+
}
|
|
12
|
+
export type ApplicationContextServiceOptions = ServiceOptions<ServiceReferences>;
|
|
13
13
|
export declare class ApplicationContextImpl implements ApplicationContext {
|
|
14
14
|
#private;
|
|
15
|
-
constructor(
|
|
15
|
+
constructor(options: ApplicationContextServiceOptions, properties: ApplicationContextProperties);
|
|
16
16
|
getHostElement(): HTMLElement;
|
|
17
17
|
getRoot(): RootNode;
|
|
18
18
|
getShadowRoot(): ShadowRoot | undefined;
|
|
19
19
|
getApplicationContainer(): HTMLElement;
|
|
20
|
+
/** @deprecated Use `runtime.LocaleService` instead. */
|
|
20
21
|
getLocale(): string;
|
|
21
|
-
|
|
22
|
+
/** @deprecated Use `runtime.LocaleService` instead. */
|
|
23
|
+
setLocale(locale: string | undefined): void;
|
|
24
|
+
/** @deprecated Use `runtime.LocaleService` instead. */
|
|
22
25
|
getSupportedLocales(): readonly string[];
|
|
23
26
|
}
|
|
27
|
+
export {};
|