@open-pioneer/runtime 2.1.4 → 2.1.6
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 +27 -0
- package/CustomElement.d.ts +4 -0
- package/CustomElement.js +73 -30
- package/CustomElement.js.map +1 -1
- package/api.d.ts +10 -0
- package/builtin-services/ApplicationContextImpl.d.ts +3 -0
- package/builtin-services/ApplicationContextImpl.js +5 -0
- package/builtin-services/ApplicationContextImpl.js.map +1 -1
- package/errors.d.ts +1 -0
- package/errors.js +1 -0
- package/errors.js.map +1 -1
- package/i18n.d.ts +19 -7
- package/i18n.js +54 -33
- package/i18n.js.map +1 -1
- package/package.json +3 -3
- package/react-integration/ReactIntegration.js +13 -0
- package/react-integration/ReactIntegration.js.map +1 -1
- package/service-layer/ServiceLayer.d.ts +13 -3
- package/service-layer/ServiceLayer.js +17 -10
- package/service-layer/ServiceLayer.js.map +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,32 @@
|
|
|
1
1
|
# @open-pioneer/runtime
|
|
2
2
|
|
|
3
|
+
## 2.1.6
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- e945264: Improve error message when metadata is missing (#55)
|
|
8
|
+
- @open-pioneer/runtime-react-support@1.0.2
|
|
9
|
+
|
|
10
|
+
## 2.1.5
|
|
11
|
+
|
|
12
|
+
### Patch Changes
|
|
13
|
+
|
|
14
|
+
- 90d0cce: The `resolveConfig` callback of an app's configuration can now inspect the application's `hostElement`.
|
|
15
|
+
- 90d0cce: Add a builtin method on the `ApplicationContext` to change the application's locale.
|
|
16
|
+
Note that with the current implementation, the application will simply restart with the new locale.
|
|
17
|
+
The application's state will be lost.
|
|
18
|
+
|
|
19
|
+
Example:
|
|
20
|
+
|
|
21
|
+
```ts
|
|
22
|
+
import { ApplicationContext } from "@open-pioneer/runtime";
|
|
23
|
+
|
|
24
|
+
const appCtx: ApplicationContext = ...; // injected
|
|
25
|
+
appCtx.setLocale("en-US");
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
- @open-pioneer/runtime-react-support@1.0.2
|
|
29
|
+
|
|
3
30
|
## 2.1.4
|
|
4
31
|
|
|
5
32
|
### Patch Changes
|
package/CustomElement.d.ts
CHANGED
|
@@ -40,6 +40,10 @@ export interface CustomElementOptions {
|
|
|
40
40
|
* A context object that is passed to the `resolveProperties` function.
|
|
41
41
|
*/
|
|
42
42
|
export interface ConfigContext {
|
|
43
|
+
/**
|
|
44
|
+
* The application's host element.
|
|
45
|
+
*/
|
|
46
|
+
hostElement: HTMLElement;
|
|
43
47
|
/**
|
|
44
48
|
* Returns an attribute from the application's root node.
|
|
45
49
|
*/
|
package/CustomElement.js
CHANGED
|
@@ -10,7 +10,10 @@ const LOG = createLogger("runtime:CustomElement");
|
|
|
10
10
|
function createCustomElement(options) {
|
|
11
11
|
class PioneerApplication extends HTMLElement {
|
|
12
12
|
#shadowRoot;
|
|
13
|
-
#
|
|
13
|
+
#instance;
|
|
14
|
+
// eslint-disable-next-line @typescript-eslint/no-explicit-any
|
|
15
|
+
#deferredRestart;
|
|
16
|
+
// A Timer
|
|
14
17
|
static get observedAttributes() {
|
|
15
18
|
return [];
|
|
16
19
|
}
|
|
@@ -20,25 +23,28 @@ function createCustomElement(options) {
|
|
|
20
23
|
mode: "open"
|
|
21
24
|
});
|
|
22
25
|
if (import.meta.env.DEV) {
|
|
23
|
-
this.$inspectElementState = () => this.#
|
|
26
|
+
this.$inspectElementState = () => this.#instance;
|
|
24
27
|
}
|
|
25
28
|
}
|
|
26
29
|
connectedCallback() {
|
|
27
30
|
LOG.debug("Launching application");
|
|
28
|
-
if (this.#
|
|
29
|
-
this.#
|
|
31
|
+
if (this.#instance) {
|
|
32
|
+
this.#instance.destroy();
|
|
30
33
|
}
|
|
31
|
-
this.#
|
|
32
|
-
this.#
|
|
34
|
+
this.#instance = this.#createApplicationInstance();
|
|
35
|
+
this.#instance.start();
|
|
33
36
|
}
|
|
34
37
|
disconnectedCallback() {
|
|
35
38
|
LOG.debug("Shutting down application");
|
|
36
|
-
this.#
|
|
37
|
-
|
|
39
|
+
if (this.#deferredRestart) {
|
|
40
|
+
clearTimeout(this.#deferredRestart);
|
|
41
|
+
}
|
|
42
|
+
this.#instance?.destroy();
|
|
43
|
+
this.#instance = void 0;
|
|
38
44
|
LOG.debug("Application destroyed");
|
|
39
45
|
}
|
|
40
46
|
when() {
|
|
41
|
-
if (!this.#
|
|
47
|
+
if (!this.#instance) {
|
|
42
48
|
return Promise.reject(
|
|
43
49
|
new Error(
|
|
44
50
|
ErrorId.NOT_MOUNTED,
|
|
@@ -46,14 +52,35 @@ function createCustomElement(options) {
|
|
|
46
52
|
)
|
|
47
53
|
);
|
|
48
54
|
}
|
|
49
|
-
return this.#
|
|
55
|
+
return this.#instance.whenAPI();
|
|
56
|
+
}
|
|
57
|
+
#triggerReload(overrides) {
|
|
58
|
+
if (this.#deferredRestart) {
|
|
59
|
+
clearTimeout(this.#deferredRestart);
|
|
60
|
+
}
|
|
61
|
+
this.#deferredRestart = setTimeout(() => {
|
|
62
|
+
if (!this.#instance) {
|
|
63
|
+
return;
|
|
64
|
+
}
|
|
65
|
+
LOG.debug("Restarting application with new options", overrides);
|
|
66
|
+
this.#instance.destroy();
|
|
67
|
+
this.#instance = this.#createApplicationInstance(overrides);
|
|
68
|
+
this.#instance.start();
|
|
69
|
+
}, 1);
|
|
70
|
+
}
|
|
71
|
+
#createApplicationInstance(overrides) {
|
|
72
|
+
return new ApplicationInstance({
|
|
73
|
+
hostElement: this,
|
|
74
|
+
shadowRoot: this.#shadowRoot,
|
|
75
|
+
elementOptions: options,
|
|
76
|
+
overrides,
|
|
77
|
+
restart: this.#triggerReload.bind(this)
|
|
78
|
+
});
|
|
50
79
|
}
|
|
51
80
|
}
|
|
52
81
|
return PioneerApplication;
|
|
53
82
|
}
|
|
54
|
-
class
|
|
55
|
-
hostElement;
|
|
56
|
-
shadowRoot;
|
|
83
|
+
class ApplicationInstance {
|
|
57
84
|
options;
|
|
58
85
|
// Public API
|
|
59
86
|
apiPromise;
|
|
@@ -68,9 +95,7 @@ class ElementState {
|
|
|
68
95
|
lifecycleEvents;
|
|
69
96
|
reactIntegration;
|
|
70
97
|
stylesWatch;
|
|
71
|
-
constructor(
|
|
72
|
-
this.hostElement = hostElement;
|
|
73
|
-
this.shadowRoot = shadowRoot;
|
|
98
|
+
constructor(options) {
|
|
74
99
|
this.options = options;
|
|
75
100
|
}
|
|
76
101
|
start() {
|
|
@@ -98,7 +123,7 @@ class ElementState {
|
|
|
98
123
|
this.state = "destroyed";
|
|
99
124
|
this.apiPromise?.reject(createAbortError());
|
|
100
125
|
this.reactIntegration = destroyResource(this.reactIntegration);
|
|
101
|
-
this.shadowRoot.replaceChildren();
|
|
126
|
+
this.options.shadowRoot.replaceChildren();
|
|
102
127
|
this.container = void 0;
|
|
103
128
|
this.lifecycleEvents = void 0;
|
|
104
129
|
this.serviceLayer = destroyResource(this.serviceLayer);
|
|
@@ -112,11 +137,11 @@ class ElementState {
|
|
|
112
137
|
return apiPromise.promise;
|
|
113
138
|
}
|
|
114
139
|
async startImpl() {
|
|
115
|
-
const {
|
|
116
|
-
const config = this.config = await gatherConfig(hostElement,
|
|
140
|
+
const { shadowRoot, hostElement, elementOptions, overrides } = this.options;
|
|
141
|
+
const config = this.config = await gatherConfig(hostElement, elementOptions, overrides);
|
|
117
142
|
this.checkAbort();
|
|
118
143
|
LOG.debug("Application config is", config);
|
|
119
|
-
const i18n = await initI18n(
|
|
144
|
+
const i18n = await initI18n(elementOptions.appMetadata, config.locale);
|
|
120
145
|
this.checkAbort();
|
|
121
146
|
const container = this.container = createContainer(i18n.locale);
|
|
122
147
|
const styles = this.initStyles();
|
|
@@ -135,7 +160,7 @@ class ElementState {
|
|
|
135
160
|
this.reactIntegration = new ReactIntegration({
|
|
136
161
|
rootNode: container,
|
|
137
162
|
container: shadowRoot,
|
|
138
|
-
theme:
|
|
163
|
+
theme: elementOptions.theme,
|
|
139
164
|
serviceLayer,
|
|
140
165
|
packages
|
|
141
166
|
});
|
|
@@ -145,13 +170,14 @@ class ElementState {
|
|
|
145
170
|
LOG.debug("Application started");
|
|
146
171
|
}
|
|
147
172
|
render() {
|
|
148
|
-
this.
|
|
173
|
+
const component = this.options.elementOptions.component ?? emptyComponent;
|
|
174
|
+
this.reactIntegration?.render(component);
|
|
149
175
|
}
|
|
150
176
|
initStyles() {
|
|
151
177
|
const builtinStyles = ":host { all: initial; display: block; }";
|
|
152
178
|
const builtinStylesNode = document.createElement("style");
|
|
153
179
|
applyStyles(builtinStylesNode, { value: builtinStyles });
|
|
154
|
-
const appStyles = this.options.appMetadata?.styles;
|
|
180
|
+
const appStyles = this.options.elementOptions.appMetadata?.styles;
|
|
155
181
|
const appStylesNode = document.createElement("style");
|
|
156
182
|
applyStyles(appStylesNode, appStyles);
|
|
157
183
|
if (import.meta.hot) {
|
|
@@ -163,15 +189,27 @@ class ElementState {
|
|
|
163
189
|
return [builtinStylesNode, appStylesNode];
|
|
164
190
|
}
|
|
165
191
|
initServiceLayer(config) {
|
|
166
|
-
const
|
|
192
|
+
const { hostElement, shadowRoot, elementOptions, restart } = this.options;
|
|
167
193
|
const { container, properties, i18n } = config;
|
|
168
|
-
const packageMetadata =
|
|
194
|
+
const packageMetadata = elementOptions.appMetadata?.packages ?? {};
|
|
169
195
|
const builtinPackage = createBuiltinPackage({
|
|
170
|
-
host:
|
|
171
|
-
shadowRoot
|
|
196
|
+
host: hostElement,
|
|
197
|
+
shadowRoot,
|
|
172
198
|
container,
|
|
173
199
|
locale: i18n.locale,
|
|
174
|
-
supportedLocales: i18n.
|
|
200
|
+
supportedLocales: i18n.supportedMessageLocales,
|
|
201
|
+
changeLocale(locale) {
|
|
202
|
+
const supported = i18n.supportedMessageLocales;
|
|
203
|
+
if (locale != null && !i18n.supportsLocale(locale)) {
|
|
204
|
+
throw new Error(
|
|
205
|
+
ErrorId.UNSUPPORTED_LOCALE,
|
|
206
|
+
`Unsupported locale '${locale}' (supported locales: ${supported.join(
|
|
207
|
+
", "
|
|
208
|
+
)}).`
|
|
209
|
+
);
|
|
210
|
+
}
|
|
211
|
+
restart({ locale });
|
|
212
|
+
}
|
|
175
213
|
});
|
|
176
214
|
const { serviceLayer, packages } = createServiceLayer({
|
|
177
215
|
packageMetadata,
|
|
@@ -268,11 +306,12 @@ function getInternalService(serviceLayer, interfaceName) {
|
|
|
268
306
|
}
|
|
269
307
|
return result.value.getInstanceOrThrow();
|
|
270
308
|
}
|
|
271
|
-
async function gatherConfig(hostElement, options) {
|
|
309
|
+
async function gatherConfig(hostElement, options, overrides) {
|
|
272
310
|
let configs;
|
|
273
311
|
try {
|
|
274
312
|
const staticConfig = options.config ?? {};
|
|
275
313
|
const dynamicConfig = await options.resolveConfig?.({
|
|
314
|
+
hostElement,
|
|
276
315
|
getAttribute(name) {
|
|
277
316
|
return hostElement.getAttribute(name) ?? void 0;
|
|
278
317
|
}
|
|
@@ -287,7 +326,11 @@ async function gatherConfig(hostElement, options) {
|
|
|
287
326
|
}
|
|
288
327
|
);
|
|
289
328
|
}
|
|
290
|
-
|
|
329
|
+
const merged = mergeConfigs(configs);
|
|
330
|
+
if (overrides?.locale) {
|
|
331
|
+
merged.locale = overrides.locale;
|
|
332
|
+
}
|
|
333
|
+
return merged;
|
|
291
334
|
}
|
|
292
335
|
function mergeConfigs(configs) {
|
|
293
336
|
const mergedConfig = Object.assign(
|
package/CustomElement.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"CustomElement.js","sources":["CustomElement.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2023 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nimport { ComponentType } from \"react\";\nimport {\n createAbortError,\n createLogger,\n createManualPromise,\n destroyResource,\n Error,\n isAbortError,\n ManualPromise,\n Resource,\n throwAbortError\n} from \"@open-pioneer/core\";\nimport { ErrorId } from \"./errors\";\nimport { ApplicationMetadata, PackageMetadata } from \"./metadata\";\nimport { PackageRepr, createPackages } from \"./service-layer/PackageRepr\";\nimport { ServiceLayer } from \"./service-layer/ServiceLayer\";\nimport { getErrorChain } from \"@open-pioneer/core\";\nimport { ReactIntegration } from \"./react-integration/ReactIntegration\";\nimport { ApiMethods, ApiService } from \"./api\";\nimport {\n createBuiltinPackage,\n RUNTIME_API_SERVICE,\n RUNTIME_APPLICATION_LIFECYCLE_EVENT_SERVICE,\n RUNTIME_AUTO_START\n} from \"./builtin-services\";\nimport { ReferenceSpec } from \"./service-layer/InterfaceSpec\";\nimport { AppI18n, initI18n } from \"./i18n\";\nimport { ApplicationLifecycleEventService } from \"./builtin-services/ApplicationLifecycleEventService\";\nconst LOG = createLogger(\"runtime:CustomElement\");\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 * 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 * Chakra theming object.\n */\n theme?: Record<string, unknown>;\n}\n\n/**\n * A context object that is passed to the `resolveProperties` function.\n */\nexport interface ConfigContext {\n /**\n * Returns an attribute from the application's root node.\n */\n getAttribute(name: string): string | undefined;\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 * Properties specified here will override default properties of the application's packages.\n */\n properties?: ApplicationProperties | undefined;\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 /** Resolves to the element's API when the application has started. */\n when(): Promise<ApiMethods>;\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;\n #state: ElementState | undefined;\n\n static get observedAttributes(): string[] {\n return [];\n }\n\n constructor() {\n super();\n\n this.#shadowRoot = this.attachShadow({\n mode: \"open\"\n });\n\n if (import.meta.env.DEV) {\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n (this as any).$inspectElementState = () => this.#state;\n }\n }\n\n connectedCallback() {\n LOG.debug(\"Launching application\");\n\n if (this.#state) {\n this.#state.destroy();\n }\n\n this.#state = new ElementState(this, this.#shadowRoot, options);\n this.#state.start();\n }\n\n disconnectedCallback() {\n LOG.debug(\"Shutting down application\");\n\n this.#state?.destroy();\n this.#state = undefined;\n\n LOG.debug(\"Application destroyed\");\n }\n\n when() {\n if (!this.#state) {\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.#state.whenAPI();\n }\n }\n return PioneerApplication;\n}\n\nclass ElementState {\n private hostElement: HTMLElement;\n private shadowRoot: ShadowRoot;\n private options: CustomElementOptions;\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 = \"not-started\" as \"not-started\" | \"starting\" | \"started\" | \"destroyed\";\n private locale: string | undefined;\n private container: HTMLDivElement | undefined;\n private config: ApplicationConfig | undefined;\n private serviceLayer: ServiceLayer | undefined;\n private lifecycleEvents: ApplicationLifecycleEventService | undefined;\n private reactIntegration: ReactIntegration | undefined;\n private stylesWatch: Resource | undefined;\n\n constructor(hostElement: HTMLElement, shadowRoot: ShadowRoot, options: CustomElementOptions) {\n this.hostElement = hostElement;\n this.shadowRoot = shadowRoot;\n this.options = options;\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 // TODO: Error splash?\n this.destroy();\n if (!isAbortError(e)) {\n logError(e);\n }\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.apiPromise?.reject(createAbortError());\n this.reactIntegration = destroyResource(this.reactIntegration);\n this.shadowRoot.replaceChildren();\n this.container = undefined;\n this.lifecycleEvents = undefined;\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 { options, shadowRoot, hostElement } = this;\n\n // Resolve custom application config\n const config = (this.config = await gatherConfig(hostElement, options));\n this.checkAbort();\n LOG.debug(\"Application config is\", config);\n\n // Decide on locale and load i18n messages (if any).\n const i18n = await initI18n(options.appMetadata, config.locale);\n this.checkAbort();\n\n // Setup application root node in the shadow dom\n const container = (this.container = createContainer(i18n.locale));\n const styles = this.initStyles();\n shadowRoot.replaceChildren(container, ...styles);\n\n // Launch the service layer\n const { serviceLayer, packages } = this.initServiceLayer({\n container,\n properties: config.properties,\n i18n\n });\n this.lifecycleEvents = getInternalService<ApplicationLifecycleEventService>(\n serviceLayer,\n RUNTIME_APPLICATION_LIFECYCLE_EVENT_SERVICE\n );\n\n await this.initAPI(serviceLayer);\n this.checkAbort();\n\n // Launch react\n this.reactIntegration = new ReactIntegration({\n rootNode: container,\n container: shadowRoot,\n theme: options.theme,\n serviceLayer,\n packages\n });\n this.render();\n this.state = \"started\";\n\n this.triggerApplicationLifecycleEvent(\"after-start\");\n LOG.debug(\"Application started\");\n }\n\n private render() {\n this.reactIntegration?.render(this.options.component ?? emptyComponent);\n }\n\n private initStyles() {\n // Prevent inheritance of certain css values and normalize to display: block by default.\n // See https://open-wc.org/guides/knowledge/styling/styles-piercing-shadow-dom/\n const builtinStyles = \":host { all: initial; display: block; }\";\n const builtinStylesNode = document.createElement(\"style\");\n applyStyles(builtinStylesNode, { value: builtinStyles });\n\n const appStyles = this.options.appMetadata?.styles;\n const appStylesNode = document.createElement(\"style\");\n applyStyles(appStylesNode, appStyles);\n if (import.meta.hot) {\n this.stylesWatch = appStyles?.on?.(\"changed\", () => {\n LOG.debug(\"Application styles changed\");\n applyStyles(appStylesNode, appStyles);\n });\n }\n return [builtinStylesNode, appStylesNode];\n }\n\n private initServiceLayer(config: {\n container: HTMLDivElement;\n properties: ApplicationProperties;\n i18n: AppI18n;\n }) {\n const options = this.options;\n const { container, properties, i18n } = config;\n const packageMetadata = options.appMetadata?.packages ?? {};\n const builtinPackage = createBuiltinPackage({\n host: this.hostElement,\n shadowRoot: this.shadowRoot,\n container: container,\n locale: i18n.locale,\n supportedLocales: i18n.supportedLocales\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 = (this.api = await apiService.getApi());\n LOG.debug(\"Application API initialized to\", api);\n this.apiPromise?.resolve(api);\n } catch (e) {\n throw new Error(ErrorId.INTERNAL, \"Failed to gather the application's API methods.\", {\n cause: e\n });\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\nfunction createContainer(locale: string) {\n // Setup application root node in the shadow dom\n const container = document.createElement(\"div\");\n container.classList.add(\"pioneer-root\");\n container.style.minHeight = \"100%\";\n container.style.height = \"100%\";\n if (locale) {\n container.lang = locale;\n }\n return container;\n}\n\nfunction createServiceLayer(config: {\n packageMetadata: Record<string, PackageMetadata> | undefined;\n properties: ApplicationProperties;\n builtinPackage: PackageRepr;\n i18n: AppI18n;\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_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\n/**\n * Gathers application properties by reading them from the options object\n * and by (optionally) invoking the `resolveProperties` hook.\n */\nasync function gatherConfig(hostElement: HTMLElement, options: CustomElementOptions) {\n let configs: ApplicationConfig[];\n try {\n const staticConfig = options.config ?? {};\n const dynamicConfig =\n (await options.resolveConfig?.({\n getAttribute(name) {\n return hostElement.getAttribute(name) ?? undefined;\n }\n })) ?? {};\n\n configs = [staticConfig, dynamicConfig];\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 return mergeConfigs(configs);\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 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\n// Applies application styles to the given style node.\n// Can be called multiple times in development mode to implement hot reloading.\nfunction applyStyles(styleNode: HTMLStyleElement, styles: { value: string } | undefined) {\n let cssValue = styles?.value ?? \"\";\n // Remove sourcemaps from inline css.\n // This currently does not work because a) the 'importer' (the index.html file) does not\n // match the actual path the source map would exist and b) vite refuses to generate it anyway, probably\n // because of our virtual modules.\n // TODO: both should be fixed once we can refer to actual `.css` files\n // and don't have to embed inline css anymore.\n cssValue = cssValue.replace(/\\/\\*# sourceMappingURL=.*$/, \"\");\n const cssNode = document.createTextNode(cssValue);\n styleNode.replaceChildren(cssNode);\n}\n\nfunction logError(e: unknown) {\n if (e instanceof Error) {\n const chain = getErrorChain(e).reverse();\n if (chain.length === 1) {\n console.error(e);\n return;\n }\n\n let n = 1;\n for (const error of chain) {\n console.error(`#${n}`, error);\n ++n;\n }\n } else {\n console.error(\"Unexpected error\", e);\n }\n}\n\nfunction emptyComponent() {\n return null;\n}\n"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"CustomElement.js","sources":["CustomElement.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2023 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nimport { ComponentType } from \"react\";\nimport {\n createAbortError,\n createLogger,\n createManualPromise,\n destroyResource,\n Error,\n isAbortError,\n ManualPromise,\n Resource,\n throwAbortError\n} from \"@open-pioneer/core\";\nimport { ErrorId } from \"./errors\";\nimport { ApplicationMetadata, PackageMetadata } from \"./metadata\";\nimport { PackageRepr, createPackages } from \"./service-layer/PackageRepr\";\nimport { ServiceLayer } from \"./service-layer/ServiceLayer\";\nimport { getErrorChain } from \"@open-pioneer/core\";\nimport { ReactIntegration } from \"./react-integration/ReactIntegration\";\nimport { ApiMethods, ApiService } from \"./api\";\nimport {\n createBuiltinPackage,\n RUNTIME_API_SERVICE,\n RUNTIME_APPLICATION_LIFECYCLE_EVENT_SERVICE,\n RUNTIME_AUTO_START\n} from \"./builtin-services\";\nimport { ReferenceSpec } from \"./service-layer/InterfaceSpec\";\nimport { AppI18n, initI18n } from \"./i18n\";\nimport { ApplicationLifecycleEventService } from \"./builtin-services/ApplicationLifecycleEventService\";\nconst LOG = createLogger(\"runtime:CustomElement\");\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 * 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 * Chakra theming object.\n */\n theme?: Record<string, unknown>;\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 * Returns an attribute from the application's root node.\n */\n getAttribute(name: string): string | undefined;\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 * Properties specified here will override default properties of the application's packages.\n */\n properties?: ApplicationProperties | undefined;\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 /** Resolves to the element's API when the application has started. */\n when(): Promise<ApiMethods>;\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;\n #instance: ApplicationInstance | 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 this.#shadowRoot = this.attachShadow({\n mode: \"open\"\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 ApplicationInstance({\n hostElement: this,\n shadowRoot: this.#shadowRoot,\n elementOptions: options,\n overrides: overrides,\n restart: this.#triggerReload.bind(this)\n });\n }\n }\n return PioneerApplication;\n}\n\ninterface InstanceOptions {\n /** The HTML element that embeds the application. */\n hostElement: HTMLElement;\n\n /** The shadow root inside the host element that contains the rest of the application. */\n shadowRoot: ShadowRoot;\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\ninterface ApplicationOverrides {\n locale?: string;\n}\n\nclass ApplicationInstance {\n private options: InstanceOptions;\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 = \"not-started\" as \"not-started\" | \"starting\" | \"started\" | \"destroyed\";\n private locale: string | undefined;\n private container: HTMLDivElement | undefined;\n private config: ApplicationConfig | undefined;\n private serviceLayer: ServiceLayer | undefined;\n private lifecycleEvents: ApplicationLifecycleEventService | undefined;\n private reactIntegration: ReactIntegration | undefined;\n private stylesWatch: Resource | undefined;\n\n constructor(options: InstanceOptions) {\n this.options = options;\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 // TODO: Error splash?\n this.destroy();\n if (!isAbortError(e)) {\n logError(e);\n }\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.apiPromise?.reject(createAbortError());\n this.reactIntegration = destroyResource(this.reactIntegration);\n this.options.shadowRoot.replaceChildren();\n this.container = undefined;\n this.lifecycleEvents = undefined;\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 { shadowRoot, hostElement, elementOptions, overrides } = this.options;\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 = await initI18n(elementOptions.appMetadata, config.locale);\n this.checkAbort();\n\n // Setup application root node in the shadow dom\n const container = (this.container = createContainer(i18n.locale));\n const styles = this.initStyles();\n shadowRoot.replaceChildren(container, ...styles);\n\n // Launch the service layer\n const { serviceLayer, packages } = this.initServiceLayer({\n container,\n properties: config.properties,\n i18n\n });\n this.lifecycleEvents = getInternalService<ApplicationLifecycleEventService>(\n serviceLayer,\n RUNTIME_APPLICATION_LIFECYCLE_EVENT_SERVICE\n );\n\n await this.initAPI(serviceLayer);\n this.checkAbort();\n\n // Launch react\n this.reactIntegration = new ReactIntegration({\n rootNode: container,\n container: shadowRoot,\n theme: elementOptions.theme,\n serviceLayer,\n packages\n });\n this.render();\n this.state = \"started\";\n\n this.triggerApplicationLifecycleEvent(\"after-start\");\n LOG.debug(\"Application started\");\n }\n\n private render() {\n const component = this.options.elementOptions.component ?? emptyComponent;\n this.reactIntegration?.render(component);\n }\n\n private initStyles() {\n // Prevent inheritance of certain css values and normalize to display: block by default.\n // See https://open-wc.org/guides/knowledge/styling/styles-piercing-shadow-dom/\n const builtinStyles = \":host { all: initial; display: block; }\";\n const builtinStylesNode = document.createElement(\"style\");\n applyStyles(builtinStylesNode, { value: builtinStyles });\n\n const appStyles = this.options.elementOptions.appMetadata?.styles;\n const appStylesNode = document.createElement(\"style\");\n applyStyles(appStylesNode, appStyles);\n if (import.meta.hot) {\n this.stylesWatch = appStyles?.on?.(\"changed\", () => {\n LOG.debug(\"Application styles changed\");\n applyStyles(appStylesNode, appStyles);\n });\n }\n return [builtinStylesNode, appStylesNode];\n }\n\n private initServiceLayer(config: {\n container: HTMLDivElement;\n properties: ApplicationProperties;\n i18n: AppI18n;\n }) {\n const { hostElement, shadowRoot, elementOptions, restart } = this.options;\n const { container, properties, i18n } = config;\n const packageMetadata = elementOptions.appMetadata?.packages ?? {};\n const builtinPackage = createBuiltinPackage({\n host: hostElement,\n shadowRoot: shadowRoot,\n container: container,\n locale: i18n.locale,\n supportedLocales: i18n.supportedMessageLocales,\n changeLocale(locale) {\n const supported = i18n.supportedMessageLocales;\n if (locale != null && !i18n.supportsLocale(locale)) {\n throw new Error(\n ErrorId.UNSUPPORTED_LOCALE,\n `Unsupported locale '${locale}' (supported locales: ${supported.join(\n \", \"\n )}).`\n );\n }\n restart({ locale });\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 = (this.api = await apiService.getApi());\n LOG.debug(\"Application API initialized to\", api);\n this.apiPromise?.resolve(api);\n } catch (e) {\n throw new Error(ErrorId.INTERNAL, \"Failed to gather the application's API methods.\", {\n cause: e\n });\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\nfunction createContainer(locale: string) {\n // Setup application root node in the shadow dom\n const container = document.createElement(\"div\");\n container.classList.add(\"pioneer-root\");\n container.style.minHeight = \"100%\";\n container.style.height = \"100%\";\n if (locale) {\n container.lang = locale;\n }\n return container;\n}\n\nfunction createServiceLayer(config: {\n packageMetadata: Record<string, PackageMetadata> | undefined;\n properties: ApplicationProperties;\n builtinPackage: PackageRepr;\n i18n: AppI18n;\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_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\n/**\n * Gathers application properties by reading them from the options object\n * and by (optionally) invoking the `resolveProperties` hook.\n */\nasync function gatherConfig(\n hostElement: HTMLElement,\n options: CustomElementOptions,\n overrides?: ApplicationOverrides\n) {\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 })) ?? {};\n\n configs = [staticConfig, dynamicConfig];\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?.locale) {\n merged.locale = overrides.locale;\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 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\n// Applies application styles to the given style node.\n// Can be called multiple times in development mode to implement hot reloading.\nfunction applyStyles(styleNode: HTMLStyleElement, styles: { value: string } | undefined) {\n let cssValue = styles?.value ?? \"\";\n // Remove sourcemaps from inline css.\n // This currently does not work because a) the 'importer' (the index.html file) does not\n // match the actual path the source map would exist and b) vite refuses to generate it anyway, probably\n // because of our virtual modules.\n // TODO: both should be fixed once we can refer to actual `.css` files\n // and don't have to embed inline css anymore.\n cssValue = cssValue.replace(/\\/\\*# sourceMappingURL=.*$/, \"\");\n const cssNode = document.createTextNode(cssValue);\n styleNode.replaceChildren(cssNode);\n}\n\nfunction logError(e: unknown) {\n if (e instanceof Error) {\n const chain = getErrorChain(e).reverse();\n if (chain.length === 1) {\n console.error(e);\n return;\n }\n\n let n = 1;\n for (const error of chain) {\n console.error(`#${n}`, error);\n ++n;\n }\n } else {\n console.error(\"Unexpected error\", e);\n }\n}\n\nfunction emptyComponent() {\n return null;\n}\n"],"names":[],"mappings":"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"}
|
package/api.d.ts
CHANGED
|
@@ -34,6 +34,7 @@ export interface ApplicationContext extends DeclaredService<"runtime.Application
|
|
|
34
34
|
getHostElement(): HTMLElement;
|
|
35
35
|
/**
|
|
36
36
|
* The current web component's shadow root.
|
|
37
|
+
* This shadow root is located inside the host element.
|
|
37
38
|
*/
|
|
38
39
|
getShadowRoot(): ShadowRoot;
|
|
39
40
|
/**
|
|
@@ -46,6 +47,15 @@ export interface ApplicationContext extends DeclaredService<"runtime.Application
|
|
|
46
47
|
* E.g. `"de-DE"`
|
|
47
48
|
*/
|
|
48
49
|
getLocale(): string;
|
|
50
|
+
/**
|
|
51
|
+
* Changes the application's locale.
|
|
52
|
+
* `locale` must be one of the supported locales, see {@link getSupportedLocales()} or `undefined` (for automatic locale).
|
|
53
|
+
* Note that `locale` does not need to be a precise match, e.g. `"de-DE"` is also valid if `"de"` is supported.
|
|
54
|
+
*
|
|
55
|
+
* > NOTE: This method will currently trigger a full restart of the application.
|
|
56
|
+
* > Altering the locale on the fly is possible in theory but has not been implemented yet.
|
|
57
|
+
*/
|
|
58
|
+
setLocale(locale: string | undefined): void;
|
|
49
59
|
/**
|
|
50
60
|
* Returns the locales supported by the application, i.e.
|
|
51
61
|
* the locales that have associated i18n messages.
|
|
@@ -6,6 +6,8 @@ export interface ApplicationContextProperties {
|
|
|
6
6
|
container: HTMLElement;
|
|
7
7
|
locale: string;
|
|
8
8
|
supportedLocales: string[];
|
|
9
|
+
/** A callback to change the application's locale is injected by the runtime. */
|
|
10
|
+
changeLocale(locale: string): void;
|
|
9
11
|
}
|
|
10
12
|
export declare class ApplicationContextImpl implements ApplicationContext {
|
|
11
13
|
#private;
|
|
@@ -14,5 +16,6 @@ export declare class ApplicationContextImpl implements ApplicationContext {
|
|
|
14
16
|
getShadowRoot(): ShadowRoot;
|
|
15
17
|
getApplicationContainer(): HTMLElement;
|
|
16
18
|
getLocale(): string;
|
|
19
|
+
setLocale(locale: string): void;
|
|
17
20
|
getSupportedLocales(): readonly string[];
|
|
18
21
|
}
|
|
@@ -4,12 +4,14 @@ class ApplicationContextImpl {
|
|
|
4
4
|
#container;
|
|
5
5
|
#locale;
|
|
6
6
|
#supportedLocales;
|
|
7
|
+
#changeLocale;
|
|
7
8
|
constructor(options, properties) {
|
|
8
9
|
this.#host = properties.host;
|
|
9
10
|
this.#shadowRoot = properties.shadowRoot;
|
|
10
11
|
this.#container = properties.container;
|
|
11
12
|
this.#locale = properties.locale;
|
|
12
13
|
this.#supportedLocales = Object.freeze(Array.from(properties.supportedLocales));
|
|
14
|
+
this.#changeLocale = properties.changeLocale;
|
|
13
15
|
}
|
|
14
16
|
getHostElement() {
|
|
15
17
|
return this.#host;
|
|
@@ -23,6 +25,9 @@ class ApplicationContextImpl {
|
|
|
23
25
|
getLocale() {
|
|
24
26
|
return this.#locale;
|
|
25
27
|
}
|
|
28
|
+
setLocale(locale) {
|
|
29
|
+
this.#changeLocale(locale);
|
|
30
|
+
}
|
|
26
31
|
getSupportedLocales() {
|
|
27
32
|
return this.#supportedLocales;
|
|
28
33
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"ApplicationContextImpl.js","sources":["ApplicationContextImpl.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2023 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nimport { ApplicationContext } from \"../api\";\nimport { ServiceOptions } from \"../Service\";\n\nexport interface ApplicationContextProperties {\n host: HTMLElement;\n shadowRoot: ShadowRoot;\n container: HTMLElement;\n locale: string;\n supportedLocales: string[];\n}\n\nexport class ApplicationContextImpl implements ApplicationContext {\n #host: HTMLElement;\n #shadowRoot: ShadowRoot;\n #container: HTMLElement;\n #locale: string;\n #supportedLocales: readonly string[];\n\n constructor(options: ServiceOptions, properties: ApplicationContextProperties) {\n this.#host = properties.host;\n this.#shadowRoot = properties.shadowRoot;\n this.#container = properties.container;\n this.#locale = properties.locale;\n this.#supportedLocales = Object.freeze(Array.from(properties.supportedLocales));\n }\n\n getHostElement(): HTMLElement {\n return this.#host;\n }\n\n getShadowRoot(): ShadowRoot {\n return this.#shadowRoot;\n }\n\n getApplicationContainer(): HTMLElement {\n return this.#container;\n }\n\n getLocale(): string {\n return this.#locale;\n }\n\n getSupportedLocales(): readonly string[] {\n return this.#supportedLocales;\n }\n}\n"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"ApplicationContextImpl.js","sources":["ApplicationContextImpl.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2023 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nimport { ApplicationContext } from \"../api\";\nimport { ServiceOptions } from \"../Service\";\n\nexport interface ApplicationContextProperties {\n host: HTMLElement;\n shadowRoot: ShadowRoot;\n container: HTMLElement;\n locale: string;\n supportedLocales: string[];\n\n /** A callback to change the application's locale is injected by the runtime. */\n changeLocale(locale: string): void;\n}\n\nexport class ApplicationContextImpl implements ApplicationContext {\n #host: HTMLElement;\n #shadowRoot: ShadowRoot;\n #container: HTMLElement;\n #locale: string;\n #supportedLocales: readonly string[];\n #changeLocale: (locale: string) => void;\n\n constructor(options: ServiceOptions, properties: ApplicationContextProperties) {\n this.#host = properties.host;\n this.#shadowRoot = properties.shadowRoot;\n this.#container = properties.container;\n this.#locale = properties.locale;\n this.#supportedLocales = Object.freeze(Array.from(properties.supportedLocales));\n this.#changeLocale = properties.changeLocale;\n }\n\n getHostElement(): HTMLElement {\n return this.#host;\n }\n\n getShadowRoot(): ShadowRoot {\n return this.#shadowRoot;\n }\n\n getApplicationContainer(): HTMLElement {\n return this.#container;\n }\n\n getLocale(): string {\n return this.#locale;\n }\n\n setLocale(locale: string): void {\n this.#changeLocale(locale);\n }\n\n getSupportedLocales(): readonly string[] {\n return this.#supportedLocales;\n }\n}\n"],"names":[],"mappings":"AAgBO,MAAM,sBAAqD,CAAA;AAAA,EAC9D,KAAA,CAAA;AAAA,EACA,WAAA,CAAA;AAAA,EACA,UAAA,CAAA;AAAA,EACA,OAAA,CAAA;AAAA,EACA,iBAAA,CAAA;AAAA,EACA,aAAA,CAAA;AAAA,EAEA,WAAA,CAAY,SAAyB,UAA0C,EAAA;AAC3E,IAAA,IAAA,CAAK,QAAQ,UAAW,CAAA,IAAA,CAAA;AACxB,IAAA,IAAA,CAAK,cAAc,UAAW,CAAA,UAAA,CAAA;AAC9B,IAAA,IAAA,CAAK,aAAa,UAAW,CAAA,SAAA,CAAA;AAC7B,IAAA,IAAA,CAAK,UAAU,UAAW,CAAA,MAAA,CAAA;AAC1B,IAAA,IAAA,CAAK,oBAAoB,MAAO,CAAA,MAAA,CAAO,MAAM,IAAK,CAAA,UAAA,CAAW,gBAAgB,CAAC,CAAA,CAAA;AAC9E,IAAA,IAAA,CAAK,gBAAgB,UAAW,CAAA,YAAA,CAAA;AAAA,GACpC;AAAA,EAEA,cAA8B,GAAA;AAC1B,IAAA,OAAO,IAAK,CAAA,KAAA,CAAA;AAAA,GAChB;AAAA,EAEA,aAA4B,GAAA;AACxB,IAAA,OAAO,IAAK,CAAA,WAAA,CAAA;AAAA,GAChB;AAAA,EAEA,uBAAuC,GAAA;AACnC,IAAA,OAAO,IAAK,CAAA,UAAA,CAAA;AAAA,GAChB;AAAA,EAEA,SAAoB,GAAA;AAChB,IAAA,OAAO,IAAK,CAAA,OAAA,CAAA;AAAA,GAChB;AAAA,EAEA,UAAU,MAAsB,EAAA;AAC5B,IAAA,IAAA,CAAK,cAAc,MAAM,CAAA,CAAA;AAAA,GAC7B;AAAA,EAEA,mBAAyC,GAAA;AACrC,IAAA,OAAO,IAAK,CAAA,iBAAA,CAAA;AAAA,GAChB;AACJ;;;;"}
|
package/errors.d.ts
CHANGED
|
@@ -8,6 +8,7 @@ export declare enum ErrorId {
|
|
|
8
8
|
INTERFACE_NOT_FOUND = "runtime:interface-not-found",
|
|
9
9
|
AMBIGUOUS_DEPENDENCY = "runtime:ambiguous-dependency",
|
|
10
10
|
UNDECLARED_DEPENDENCY = "runtime:undeclared-dependency",
|
|
11
|
+
MISSING_PACKAGE = "runtime:missing-package",
|
|
11
12
|
SERVICE_CONSTRUCTION_FAILED = "runtime:service-construction-failed",
|
|
12
13
|
SERVICE_DESTRUCTION_FAILED = "runtime:service-destruction-failed",
|
|
13
14
|
DUPLICATE_INTERFACE = "runtime:duplicate-interface",
|
package/errors.js
CHANGED
|
@@ -8,6 +8,7 @@ var ErrorId = /* @__PURE__ */ ((ErrorId2) => {
|
|
|
8
8
|
ErrorId2["INTERFACE_NOT_FOUND"] = "runtime:interface-not-found";
|
|
9
9
|
ErrorId2["AMBIGUOUS_DEPENDENCY"] = "runtime:ambiguous-dependency";
|
|
10
10
|
ErrorId2["UNDECLARED_DEPENDENCY"] = "runtime:undeclared-dependency";
|
|
11
|
+
ErrorId2["MISSING_PACKAGE"] = "runtime:missing-package";
|
|
11
12
|
ErrorId2["SERVICE_CONSTRUCTION_FAILED"] = "runtime:service-construction-failed";
|
|
12
13
|
ErrorId2["SERVICE_DESTRUCTION_FAILED"] = "runtime:service-destruction-failed";
|
|
13
14
|
ErrorId2["DUPLICATE_INTERFACE"] = "runtime:duplicate-interface";
|
package/errors.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"errors.js","sources":["errors.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2023 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nexport enum ErrorId {\n // Problems with application metadata\n INVALID_METADATA = \"runtime:invalid-metadata\",\n INVALID_PROPERTY_NAME = \"runtime:invalid-property-name\",\n REQUIRED_PROPERTY = \"runtime:required-property\",\n\n // Application lifecycle\n NOT_MOUNTED = \"runtime:element-not-mounted\",\n UNSUPPORTED_LOCALE = \"runtime:unsupported-locale\",\n CONFIG_RESOLUTION_FAILED = \"runtime:config-resolution-failed\",\n\n // Service layer\n INTERFACE_NOT_FOUND = \"runtime:interface-not-found\",\n AMBIGUOUS_DEPENDENCY = \"runtime:ambiguous-dependency\",\n UNDECLARED_DEPENDENCY = \"runtime:undeclared-dependency\",\n SERVICE_CONSTRUCTION_FAILED = \"runtime:service-construction-failed\",\n SERVICE_DESTRUCTION_FAILED = \"runtime:service-destruction-failed\",\n DUPLICATE_INTERFACE = \"runtime:duplicate-interface\",\n DEPENDENCY_CYCLE = \"runtime:dependency-cycle\",\n\n // Web component API\n DUPLICATE_API_METHODS = \"runtime:duplicate-api-methods\",\n\n // Internal\n INTERNAL = \"runtime:internal-error\"\n}\n"],"names":["ErrorId"],"mappings":"AAEY,IAAA,OAAA,qBAAAA,QAAL,KAAA;AAEH,EAAAA,SAAA,kBAAmB,CAAA,GAAA,0BAAA,CAAA;AACnB,EAAAA,SAAA,uBAAwB,CAAA,GAAA,+BAAA,CAAA;AACxB,EAAAA,SAAA,mBAAoB,CAAA,GAAA,2BAAA,CAAA;AAGpB,EAAAA,SAAA,aAAc,CAAA,GAAA,6BAAA,CAAA;AACd,EAAAA,SAAA,oBAAqB,CAAA,GAAA,4BAAA,CAAA;AACrB,EAAAA,SAAA,0BAA2B,CAAA,GAAA,kCAAA,CAAA;AAG3B,EAAAA,SAAA,qBAAsB,CAAA,GAAA,6BAAA,CAAA;AACtB,EAAAA,SAAA,sBAAuB,CAAA,GAAA,8BAAA,CAAA;AACvB,EAAAA,SAAA,uBAAwB,CAAA,GAAA,+BAAA,CAAA;AACxB,EAAAA,SAAA,6BAA8B,CAAA,GAAA,qCAAA,CAAA;AAC9B,EAAAA,SAAA,4BAA6B,CAAA,GAAA,oCAAA,CAAA;AAC7B,EAAAA,SAAA,qBAAsB,CAAA,GAAA,6BAAA,CAAA;AACtB,EAAAA,SAAA,kBAAmB,CAAA,GAAA,0BAAA,CAAA;AAGnB,EAAAA,SAAA,uBAAwB,CAAA,GAAA,+BAAA,CAAA;AAGxB,EAAAA,SAAA,UAAW,CAAA,GAAA,wBAAA,CAAA;
|
|
1
|
+
{"version":3,"file":"errors.js","sources":["errors.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2023 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nexport enum ErrorId {\n // Problems with application metadata\n INVALID_METADATA = \"runtime:invalid-metadata\",\n INVALID_PROPERTY_NAME = \"runtime:invalid-property-name\",\n REQUIRED_PROPERTY = \"runtime:required-property\",\n\n // Application lifecycle\n NOT_MOUNTED = \"runtime:element-not-mounted\",\n UNSUPPORTED_LOCALE = \"runtime:unsupported-locale\",\n CONFIG_RESOLUTION_FAILED = \"runtime:config-resolution-failed\",\n\n // Service layer\n INTERFACE_NOT_FOUND = \"runtime:interface-not-found\",\n AMBIGUOUS_DEPENDENCY = \"runtime:ambiguous-dependency\",\n UNDECLARED_DEPENDENCY = \"runtime:undeclared-dependency\",\n MISSING_PACKAGE = \"runtime:missing-package\",\n SERVICE_CONSTRUCTION_FAILED = \"runtime:service-construction-failed\",\n SERVICE_DESTRUCTION_FAILED = \"runtime:service-destruction-failed\",\n DUPLICATE_INTERFACE = \"runtime:duplicate-interface\",\n DEPENDENCY_CYCLE = \"runtime:dependency-cycle\",\n\n // Web component API\n DUPLICATE_API_METHODS = \"runtime:duplicate-api-methods\",\n\n // Internal\n INTERNAL = \"runtime:internal-error\"\n}\n"],"names":["ErrorId"],"mappings":"AAEY,IAAA,OAAA,qBAAAA,QAAL,KAAA;AAEH,EAAAA,SAAA,kBAAmB,CAAA,GAAA,0BAAA,CAAA;AACnB,EAAAA,SAAA,uBAAwB,CAAA,GAAA,+BAAA,CAAA;AACxB,EAAAA,SAAA,mBAAoB,CAAA,GAAA,2BAAA,CAAA;AAGpB,EAAAA,SAAA,aAAc,CAAA,GAAA,6BAAA,CAAA;AACd,EAAAA,SAAA,oBAAqB,CAAA,GAAA,4BAAA,CAAA;AACrB,EAAAA,SAAA,0BAA2B,CAAA,GAAA,kCAAA,CAAA;AAG3B,EAAAA,SAAA,qBAAsB,CAAA,GAAA,6BAAA,CAAA;AACtB,EAAAA,SAAA,sBAAuB,CAAA,GAAA,8BAAA,CAAA;AACvB,EAAAA,SAAA,uBAAwB,CAAA,GAAA,+BAAA,CAAA;AACxB,EAAAA,SAAA,iBAAkB,CAAA,GAAA,yBAAA,CAAA;AAClB,EAAAA,SAAA,6BAA8B,CAAA,GAAA,qCAAA,CAAA;AAC9B,EAAAA,SAAA,4BAA6B,CAAA,GAAA,oCAAA,CAAA;AAC7B,EAAAA,SAAA,qBAAsB,CAAA,GAAA,6BAAA,CAAA;AACtB,EAAAA,SAAA,kBAAmB,CAAA,GAAA,0BAAA,CAAA;AAGnB,EAAAA,SAAA,uBAAwB,CAAA,GAAA,+BAAA,CAAA;AAGxB,EAAAA,SAAA,UAAW,CAAA,GAAA,wBAAA,CAAA;AAzBH,EAAAA,OAAAA,QAAAA,CAAAA;AAAA,CAAA,EAAA,OAAA,IAAA,EAAA;;;;"}
|
package/i18n.d.ts
CHANGED
|
@@ -8,7 +8,9 @@ export interface AppI18n {
|
|
|
8
8
|
/** Chosen locale */
|
|
9
9
|
readonly locale: string;
|
|
10
10
|
/** Supported locales from app metadata. */
|
|
11
|
-
readonly
|
|
11
|
+
readonly supportedMessageLocales: string[];
|
|
12
|
+
/** True if the locale can be used in this application (i.e. if there are any messages). */
|
|
13
|
+
supportsLocale(locale: string): boolean;
|
|
12
14
|
/** Given the package name, constructs a package i18n instance. */
|
|
13
15
|
createPackageI18n(packageName: string): PackageIntl;
|
|
14
16
|
}
|
|
@@ -24,7 +26,7 @@ export type PackageIntl = Pick<IntlShape, "locale" | "timeZone"> & IntlFormatter
|
|
|
24
26
|
export declare function initI18n(appMetadata: ApplicationMetadata | undefined, forcedLocale: string | undefined): Promise<AppI18n>;
|
|
25
27
|
/** Creates an empty i18n instance, e.g. for tests. */
|
|
26
28
|
export declare function createEmptyI18n(locale?: string): PackageIntl;
|
|
27
|
-
|
|
29
|
+
interface LocalePickResult {
|
|
28
30
|
/** The actual locale (e.g. en-US) for number and date formatting etc. */
|
|
29
31
|
locale: string;
|
|
30
32
|
/**
|
|
@@ -34,9 +36,19 @@ export interface LocalePickResult {
|
|
|
34
36
|
}
|
|
35
37
|
/**
|
|
36
38
|
* Picks a locale for the app. Exported for tests.
|
|
37
|
-
*
|
|
38
|
-
* @param forcedLocale Optional forced locale (must be satisfied)
|
|
39
|
-
* @param appLocales Locales the app has i18n messages for (e.g. "en", "de")
|
|
40
|
-
* @param userLocales Locales requested by the user's browser
|
|
41
39
|
*/
|
|
42
|
-
export declare
|
|
40
|
+
export declare class I18nConfig {
|
|
41
|
+
private appLocales;
|
|
42
|
+
/**
|
|
43
|
+
* @param appLocales Locales the app has i18n messages for (e.g. "en", "de")
|
|
44
|
+
*/
|
|
45
|
+
constructor(appLocales: string[]);
|
|
46
|
+
/**
|
|
47
|
+
* @param forcedLocale Optional forced locale (must be satisfied)
|
|
48
|
+
* @param userLocales Locales requested by the user's browser
|
|
49
|
+
*/
|
|
50
|
+
pickSupportedLocale(forcedLocale: string | undefined, userLocales: string[]): LocalePickResult;
|
|
51
|
+
supportsLocale(locale: string): boolean;
|
|
52
|
+
private pickImpl;
|
|
53
|
+
}
|
|
54
|
+
export {};
|
package/i18n.js
CHANGED
|
@@ -14,27 +14,24 @@ function createPackageIntl(locale, messages) {
|
|
|
14
14
|
);
|
|
15
15
|
}
|
|
16
16
|
async function initI18n(appMetadata, forcedLocale) {
|
|
17
|
-
const
|
|
17
|
+
const messageLocales = appMetadata?.locales ?? [];
|
|
18
18
|
const userLocales = getBrowserLocales();
|
|
19
19
|
if (LOG.isDebug()) {
|
|
20
20
|
LOG.debug(
|
|
21
21
|
`Attempting to pick locale for user (locales: ${userLocales.join(
|
|
22
22
|
", "
|
|
23
|
-
)}) from app (supported locales: ${
|
|
23
|
+
)}) from app (supported locales: ${messageLocales.join(
|
|
24
24
|
", "
|
|
25
25
|
)}) [forcedLocale=${forcedLocale}].`
|
|
26
26
|
);
|
|
27
27
|
}
|
|
28
|
-
const
|
|
29
|
-
|
|
30
|
-
supportedLocales,
|
|
31
|
-
getBrowserLocales()
|
|
32
|
-
);
|
|
28
|
+
const i18nConfig = new I18nConfig(messageLocales);
|
|
29
|
+
const { locale, messageLocale } = i18nConfig.pickSupportedLocale(forcedLocale, userLocales);
|
|
33
30
|
if (LOG.isDebug()) {
|
|
34
31
|
LOG.debug(`Using locale '${locale}' with messages from locale '${messageLocale}'.`);
|
|
35
32
|
}
|
|
36
33
|
let messages;
|
|
37
|
-
if (
|
|
34
|
+
if (messageLocales.includes(messageLocale)) {
|
|
38
35
|
try {
|
|
39
36
|
messages = await appMetadata?.loadMessages?.(messageLocale) ?? {};
|
|
40
37
|
} catch (e) {
|
|
@@ -49,7 +46,10 @@ async function initI18n(appMetadata, forcedLocale) {
|
|
|
49
46
|
}
|
|
50
47
|
return {
|
|
51
48
|
locale,
|
|
52
|
-
|
|
49
|
+
supportedMessageLocales: messageLocales,
|
|
50
|
+
supportsLocale(locale2) {
|
|
51
|
+
return i18nConfig.supportsLocale(locale2);
|
|
52
|
+
},
|
|
53
53
|
createPackageI18n(packageName) {
|
|
54
54
|
const packageMessage = messages?.[packageName] ?? {};
|
|
55
55
|
return createPackageIntl(locale, packageMessage);
|
|
@@ -59,8 +59,50 @@ async function initI18n(appMetadata, forcedLocale) {
|
|
|
59
59
|
function createEmptyI18n(locale = "en") {
|
|
60
60
|
return createPackageIntl(locale, {});
|
|
61
61
|
}
|
|
62
|
-
|
|
63
|
-
|
|
62
|
+
class I18nConfig {
|
|
63
|
+
appLocales;
|
|
64
|
+
/**
|
|
65
|
+
* @param appLocales Locales the app has i18n messages for (e.g. "en", "de")
|
|
66
|
+
*/
|
|
67
|
+
constructor(appLocales) {
|
|
68
|
+
this.appLocales = appLocales;
|
|
69
|
+
}
|
|
70
|
+
/**
|
|
71
|
+
* @param forcedLocale Optional forced locale (must be satisfied)
|
|
72
|
+
* @param userLocales Locales requested by the user's browser
|
|
73
|
+
*/
|
|
74
|
+
pickSupportedLocale(forcedLocale, userLocales) {
|
|
75
|
+
const { appLocales } = this;
|
|
76
|
+
if (forcedLocale) {
|
|
77
|
+
const result = this.pickImpl([forcedLocale]);
|
|
78
|
+
if (!result) {
|
|
79
|
+
const localesList = appLocales.join(", ");
|
|
80
|
+
throw new Error(
|
|
81
|
+
ErrorId.UNSUPPORTED_LOCALE,
|
|
82
|
+
`Locale '${forcedLocale}' cannot be forced because it is not supported by the application. Supported locales are ${localesList}.`
|
|
83
|
+
);
|
|
84
|
+
}
|
|
85
|
+
if (result.locale !== result.messageLocale) {
|
|
86
|
+
LOG.warn(
|
|
87
|
+
`Non-exact match for forced locale '${forcedLocale}': using messages from '${result.messageLocale}'.`
|
|
88
|
+
);
|
|
89
|
+
}
|
|
90
|
+
return result;
|
|
91
|
+
}
|
|
92
|
+
const supportedLocale = this.pickImpl(userLocales);
|
|
93
|
+
if (supportedLocale) {
|
|
94
|
+
return supportedLocale;
|
|
95
|
+
}
|
|
96
|
+
return {
|
|
97
|
+
locale: userLocales[0] ?? "en",
|
|
98
|
+
messageLocale: appLocales[0] ?? "en"
|
|
99
|
+
};
|
|
100
|
+
}
|
|
101
|
+
supportsLocale(locale) {
|
|
102
|
+
return this.pickImpl([locale]) != null;
|
|
103
|
+
}
|
|
104
|
+
pickImpl(requestedLocales) {
|
|
105
|
+
const appLocales = this.appLocales;
|
|
64
106
|
for (const requestedLocale of requestedLocales) {
|
|
65
107
|
if (appLocales.includes(requestedLocale)) {
|
|
66
108
|
return { messageLocale: requestedLocale, locale: requestedLocale };
|
|
@@ -71,28 +113,7 @@ function pickLocale(forcedLocale, appLocales, userLocales) {
|
|
|
71
113
|
}
|
|
72
114
|
}
|
|
73
115
|
return void 0;
|
|
74
|
-
};
|
|
75
|
-
if (forcedLocale) {
|
|
76
|
-
const result = pickImpl([forcedLocale]);
|
|
77
|
-
if (!result) {
|
|
78
|
-
const localesList = appLocales.join(", ");
|
|
79
|
-
throw new Error(
|
|
80
|
-
ErrorId.UNSUPPORTED_LOCALE,
|
|
81
|
-
`Locale '${forcedLocale}' cannot be forced because it is not supported by the application. Supported locales are ${localesList}.`
|
|
82
|
-
);
|
|
83
|
-
}
|
|
84
|
-
if (result.locale !== result.messageLocale) {
|
|
85
|
-
LOG.warn(
|
|
86
|
-
`Non-exact match for forced locale '${forcedLocale}': using messages from '${result.messageLocale}'.`
|
|
87
|
-
);
|
|
88
|
-
}
|
|
89
|
-
return result;
|
|
90
|
-
}
|
|
91
|
-
const supportedLocale = pickImpl(userLocales);
|
|
92
|
-
if (supportedLocale) {
|
|
93
|
-
return supportedLocale;
|
|
94
116
|
}
|
|
95
|
-
return { locale: userLocales[0] ?? "en", messageLocale: appLocales[0] ?? "en" };
|
|
96
117
|
}
|
|
97
118
|
function getBrowserLocales() {
|
|
98
119
|
if (window.navigator.languages && window.navigator.languages.length) {
|
|
@@ -101,5 +122,5 @@ function getBrowserLocales() {
|
|
|
101
122
|
return [window.navigator.language];
|
|
102
123
|
}
|
|
103
124
|
|
|
104
|
-
export { createEmptyI18n, initI18n
|
|
125
|
+
export { I18nConfig, createEmptyI18n, initI18n };
|
|
105
126
|
//# sourceMappingURL=i18n.js.map
|
package/i18n.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"i18n.js","sources":["i18n.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2023 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nimport { createIntl, createIntlCache, IntlFormatters, IntlShape } from \"@formatjs/intl\";\nimport { ErrorId } from \"./errors\";\nimport { createLogger, Error } from \"@open-pioneer/core\";\nimport { ApplicationMetadata } from \"./metadata\";\nconst LOG = createLogger(\"runtime:i18n\");\n\n/**\n * Represents i18n info for the entire application.\n * Currently not exposed to user code.\n */\nexport interface AppI18n {\n /** Chosen locale */\n readonly locale: string;\n\n /** Supported locales from app metadata. */\n readonly supportedLocales: string[];\n\n /** Given the package name, constructs a package i18n instance. */\n createPackageI18n(packageName: string): PackageIntl;\n}\n\n/**\n * Gives access to the package's i18n messages for the current locale.\n *\n * See also https://formatjs.io/docs/intl\n */\nexport type PackageIntl = Pick<IntlShape, \"locale\" | \"timeZone\"> & IntlFormatters<string>;\n\nfunction createPackageIntl(locale: string, messages: Record<string, string>) {\n const cache = createIntlCache();\n return createIntl(\n {\n locale,\n messages\n },\n cache\n );\n}\n\n/**\n * Initializes the application's locale and fetches the appropriate i18n messages.\n */\nexport async function initI18n(\n appMetadata: ApplicationMetadata | undefined,\n forcedLocale: string | undefined\n): Promise<AppI18n> {\n const supportedLocales = appMetadata?.locales ?? [];\n const userLocales = getBrowserLocales();\n if (LOG.isDebug()) {\n LOG.debug(\n `Attempting to pick locale for user (locales: ${userLocales.join(\n \", \"\n )}) from app (supported locales: ${supportedLocales.join(\n \", \"\n )}) [forcedLocale=${forcedLocale}].`\n );\n }\n\n const { locale, messageLocale } = pickLocale(\n forcedLocale,\n supportedLocales,\n getBrowserLocales()\n );\n\n if (LOG.isDebug()) {\n LOG.debug(`Using locale '${locale}' with messages from locale '${messageLocale}'.`);\n }\n\n let messages: Record<string, Record<string, string>>;\n if (supportedLocales.includes(messageLocale)) {\n try {\n messages = (await appMetadata?.loadMessages?.(messageLocale)) ?? {};\n } catch (e) {\n throw new Error(\n ErrorId.INTERNAL,\n `Failed to load messages for locale '${messageLocale}'.`,\n {\n cause: e\n }\n );\n }\n }\n return {\n locale,\n supportedLocales,\n createPackageI18n(packageName) {\n const packageMessage = messages?.[packageName] ?? {};\n return createPackageIntl(locale, packageMessage);\n }\n };\n}\n\n/** Creates an empty i18n instance, e.g. for tests. */\nexport function createEmptyI18n(locale = \"en\"): PackageIntl {\n return createPackageIntl(locale, {});\n}\n\nexport interface LocalePickResult {\n /** The actual locale (e.g. en-US) for number and date formatting etc. */\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. Exported for tests.\n *\n * @param forcedLocale Optional forced locale (must be satisfied)\n * @param appLocales Locales the app has i18n messages for (e.g. \"en\", \"de\")\n * @param userLocales Locales requested by the user's browser\n */\nexport function pickLocale(\n forcedLocale: string | undefined,\n appLocales: string[],\n userLocales: string[]\n): LocalePickResult {\n const pickImpl = (requestedLocales: string[]): LocalePickResult | undefined => {\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 // Attempt to satisfy forced locale\n if (forcedLocale) {\n const result = 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 = 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 { locale: userLocales[0] ?? \"en\", messageLocale: appLocales[0] ?? \"en\" };\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 */\nfunction 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":"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"}
|
|
1
|
+
{"version":3,"file":"i18n.js","sources":["i18n.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2023 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nimport { createIntl, createIntlCache, IntlFormatters, IntlShape } from \"@formatjs/intl\";\nimport { ErrorId } from \"./errors\";\nimport { createLogger, Error } from \"@open-pioneer/core\";\nimport { ApplicationMetadata } from \"./metadata\";\nconst LOG = createLogger(\"runtime:i18n\");\n\n/**\n * Represents i18n info for the entire application.\n * Currently not exposed to user code.\n */\nexport interface AppI18n {\n /** Chosen locale */\n readonly locale: string;\n\n /** Supported locales from app metadata. */\n readonly supportedMessageLocales: string[];\n\n /** True if the locale can be used in this application (i.e. if there are any messages). */\n supportsLocale(locale: string): boolean;\n\n /** Given the package name, constructs a package i18n instance. */\n createPackageI18n(packageName: string): PackageIntl;\n}\n\n/**\n * Gives access to the package's i18n messages for the current locale.\n *\n * See also https://formatjs.io/docs/intl\n */\nexport type PackageIntl = Pick<IntlShape, \"locale\" | \"timeZone\"> & IntlFormatters<string>;\n\nfunction createPackageIntl(locale: string, messages: Record<string, string>) {\n const cache = createIntlCache();\n return createIntl(\n {\n locale,\n messages\n },\n cache\n );\n}\n\n/**\n * Initializes the application's locale and fetches the appropriate i18n messages.\n */\nexport async function initI18n(\n appMetadata: ApplicationMetadata | undefined,\n forcedLocale: string | undefined\n): Promise<AppI18n> {\n const messageLocales = appMetadata?.locales ?? [];\n const userLocales = getBrowserLocales();\n if (LOG.isDebug()) {\n LOG.debug(\n `Attempting to pick locale for user (locales: ${userLocales.join(\n \", \"\n )}) from app (supported locales: ${messageLocales.join(\n \", \"\n )}) [forcedLocale=${forcedLocale}].`\n );\n }\n\n const i18nConfig = new I18nConfig(messageLocales);\n const { locale, messageLocale } = i18nConfig.pickSupportedLocale(forcedLocale, userLocales);\n\n if (LOG.isDebug()) {\n LOG.debug(`Using locale '${locale}' with messages from locale '${messageLocale}'.`);\n }\n\n let messages: Record<string, Record<string, string>>;\n if (messageLocales.includes(messageLocale)) {\n try {\n messages = (await appMetadata?.loadMessages?.(messageLocale)) ?? {};\n } catch (e) {\n throw new Error(\n ErrorId.INTERNAL,\n `Failed to load messages for locale '${messageLocale}'.`,\n {\n cause: e\n }\n );\n }\n }\n return {\n locale,\n supportedMessageLocales: messageLocales,\n supportsLocale(locale) {\n return i18nConfig.supportsLocale(locale);\n },\n createPackageI18n(packageName) {\n const packageMessage = messages?.[packageName] ?? {};\n return createPackageIntl(locale, packageMessage);\n }\n };\n}\n\n/** Creates an empty i18n instance, e.g. for tests. */\nexport function createEmptyI18n(locale = \"en\"): PackageIntl {\n return createPackageIntl(locale, {});\n}\n\ninterface LocalePickResult {\n /** The actual locale (e.g. en-US) for number and date formatting etc. */\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. Exported for tests.\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 */\nfunction 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":["locale"],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"type": "module",
|
|
3
3
|
"name": "@open-pioneer/runtime",
|
|
4
|
-
"version": "2.1.
|
|
4
|
+
"version": "2.1.6",
|
|
5
5
|
"description": "Implements the runtime environment for Open Pioneer Trails apps.",
|
|
6
6
|
"keywords": [
|
|
7
7
|
"open-pioneer-trails"
|
|
@@ -19,8 +19,8 @@
|
|
|
19
19
|
"react-dom": "^18.2.0",
|
|
20
20
|
"@open-pioneer/base-theme": "^0.3.2",
|
|
21
21
|
"@open-pioneer/chakra-integration": "^1.1.3",
|
|
22
|
-
"@open-pioneer/
|
|
23
|
-
"@open-pioneer/
|
|
22
|
+
"@open-pioneer/runtime-react-support": "^1.0.2",
|
|
23
|
+
"@open-pioneer/core": "^1.2.3"
|
|
24
24
|
},
|
|
25
25
|
"exports": {
|
|
26
26
|
"./package.json": "./package.json",
|
|
@@ -48,6 +48,11 @@ class ReactIntegration {
|
|
|
48
48
|
`The UI of package '${packageName}' requires the ambiguous interface ${renderedSpec}. Possible choices are: ${renderedChoices}.`
|
|
49
49
|
);
|
|
50
50
|
}
|
|
51
|
+
case "unknown-package":
|
|
52
|
+
throw new Error(
|
|
53
|
+
ErrorId.MISSING_PACKAGE,
|
|
54
|
+
missingPackageMessage(packageName, interfaceName)
|
|
55
|
+
);
|
|
51
56
|
}
|
|
52
57
|
},
|
|
53
58
|
getServices: (packageName, interfaceName) => {
|
|
@@ -61,6 +66,11 @@ class ReactIntegration {
|
|
|
61
66
|
ErrorId.UNDECLARED_DEPENDENCY,
|
|
62
67
|
`Package '${packageName}' did not declare an UI dependency on all services implementing interface '${interfaceName}'. Add the dependency ("all": true) to the package configuration or remove the usage.`
|
|
63
68
|
);
|
|
69
|
+
case "unknown-package":
|
|
70
|
+
throw new Error(
|
|
71
|
+
ErrorId.MISSING_PACKAGE,
|
|
72
|
+
missingPackageMessage(packageName, interfaceName)
|
|
73
|
+
);
|
|
64
74
|
}
|
|
65
75
|
},
|
|
66
76
|
getProperties: (packageName) => {
|
|
@@ -98,6 +108,9 @@ class ReactIntegration {
|
|
|
98
108
|
return pkg;
|
|
99
109
|
}
|
|
100
110
|
}
|
|
111
|
+
function missingPackageMessage(packageName, interfaceName) {
|
|
112
|
+
return `Package '${packageName}' was not found in the application's metadata while it attempted to reference the interface '${interfaceName}'. Check that the dependency is declared correctly in the packages that use '${packageName}'.`;
|
|
113
|
+
}
|
|
101
114
|
|
|
102
115
|
export { ReactIntegration };
|
|
103
116
|
//# sourceMappingURL=ReactIntegration.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"ReactIntegration.js","sources":["ReactIntegration.tsx"],"sourcesContent":["// SPDX-FileCopyrightText: 2023 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nimport { ComponentType, StrictMode } from \"react\";\nimport { createRoot, Root } from \"react-dom/client\";\nimport { Error } from \"@open-pioneer/core\";\nimport { ErrorId } from \"../errors\";\nimport { ServiceLayer } from \"../service-layer/ServiceLayer\";\nimport { PackageContext, PackageContextMethods } from \"@open-pioneer/runtime-react-support\";\nimport { PackageRepr } from \"../service-layer/PackageRepr\";\nimport { InterfaceSpec, renderInterfaceSpec } from \"../service-layer/InterfaceSpec\";\nimport { renderAmbiguousServiceChoices } from \"../service-layer/ServiceLookup\";\nimport { CustomChakraProvider } from \"@open-pioneer/chakra-integration\";\nimport { theme as defaultTrailsTheme } from \"@open-pioneer/base-theme\";\n\nexport interface ReactIntegrationOptions {\n packages: Map<string, PackageRepr>;\n serviceLayer: ServiceLayer;\n rootNode: HTMLDivElement;\n container: Node;\n theme: Record<string, unknown> | undefined;\n}\n\nexport class ReactIntegration {\n private containerNode: Node;\n private theme: Record<string, unknown> | undefined;\n private packages: Map<string, PackageRepr>;\n private serviceLayer: ServiceLayer;\n private root: Root;\n private packageContext: PackageContextMethods;\n\n constructor(options: ReactIntegrationOptions) {\n this.containerNode = options.container;\n this.theme = options.theme;\n this.packages = options.packages;\n this.serviceLayer = options.serviceLayer;\n this.root = createRoot(options.rootNode);\n this.packageContext = {\n getService: (packageName, interfaceName, options) => {\n const spec: InterfaceSpec = { interfaceName, ...options };\n const result = this.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 }\n },\n getServices: (packageName, interfaceName) => {\n const result = this.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 }\n },\n getProperties: (packageName) => {\n return this.getPackage(packageName).properties;\n },\n getIntl: (packageName) => {\n return this.getPackage(packageName).intl;\n }\n };\n }\n\n render(Component: ComponentType) {\n this.root.render(\n <StrictMode>\n <CustomChakraProvider\n container={this.containerNode}\n colorMode=\"light\"\n theme={this.theme ?? defaultTrailsTheme}\n >\n <PackageContext.Provider value={this.packageContext}>\n <Component />\n </PackageContext.Provider>\n </CustomChakraProvider>\n </StrictMode>\n );\n }\n\n destroy() {\n this.root.unmount();\n }\n\n private getPackage(packageName: string): PackageRepr {\n const pkg = this.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"],"names":["options","defaultTrailsTheme"],"mappings":";;;;;;;;;;;AAsBO,MAAM,gBAAiB,CAAA;AAAA,EAClB,aAAA,CAAA;AAAA,EACA,KAAA,CAAA;AAAA,EACA,QAAA,CAAA;AAAA,EACA,YAAA,CAAA;AAAA,EACA,IAAA,CAAA;AAAA,EACA,cAAA,CAAA;AAAA,EAER,YAAY,OAAkC,EAAA;AAC1C,IAAA,IAAA,CAAK,gBAAgB,OAAQ,CAAA,SAAA,CAAA;AAC7B,IAAA,IAAA,CAAK,QAAQ,OAAQ,CAAA,KAAA,CAAA;AACrB,IAAA,IAAA,CAAK,WAAW,OAAQ,CAAA,QAAA,CAAA;AACxB,IAAA,IAAA,CAAK,eAAe,OAAQ,CAAA,YAAA,CAAA;AAC5B,IAAK,IAAA,CAAA,IAAA,GAAO,UAAW,CAAA,OAAA,CAAQ,QAAQ,CAAA,CAAA;AACvC,IAAA,IAAA,CAAK,cAAiB,GAAA;AAAA,MAClB,UAAY,EAAA,CAAC,WAAa,EAAA,aAAA,EAAeA,QAAY,KAAA;AACjD,QAAA,MAAM,IAAsB,GAAA,EAAE,aAAe,EAAA,GAAGA,QAAQ,EAAA,CAAA;AACxD,QAAA,MAAM,MAAS,GAAA,IAAA,CAAK,YAAa,CAAA,UAAA,CAAW,aAAa,IAAI,CAAA,CAAA;AAC7D,QAAI,IAAA,MAAA,CAAO,SAAS,OAAS,EAAA;AACzB,UAAO,OAAA,MAAA,CAAO,MAAM,kBAAmB,EAAA,CAAA;AAAA,SAC3C;AAEA,QAAM,MAAA,YAAA,GAAe,oBAAoB,IAAI,CAAA,CAAA;AAC7C,QAAA,QAAQ,OAAO,IAAM;AAAA,UACjB,KAAK,eAAA;AACD,YAAA,MAAM,IAAI,KAAA;AAAA,cACN,OAAQ,CAAA,mBAAA;AAAA,cACR,CAAA,mBAAA,EAAsB,WAAW,CAAA,wCAAA,EAA2C,YAAY,CAAA,CAAA,CAAA;AAAA,aAC5F,CAAA;AAAA,UACJ,KAAK,YAAA;AACD,YAAA,MAAM,IAAI,KAAA;AAAA,cACN,OAAQ,CAAA,qBAAA;AAAA,cACR,CAAA,SAAA,EAAY,WAAW,CAAA,gDAAA,EAAmD,YAAY,CAAA,sEAAA,CAAA;AAAA,aAE1F,CAAA;AAAA,UACJ,KAAK,WAAa,EAAA;AACd,YAAM,MAAA,eAAA,GAAkB,6BAA8B,CAAA,MAAA,CAAO,OAAO,CAAA,CAAA;AACpE,YAAA,MAAM,IAAI,KAAA;AAAA,cACN,OAAQ,CAAA,oBAAA;AAAA,cACR,CAAsB,mBAAA,EAAA,WAAW,CAAsC,mCAAA,EAAA,YAAY,2BACrD,eAAe,CAAA,CAAA,CAAA;AAAA,aACjD,CAAA;AAAA,WACJ;AAAA,
|
|
1
|
+
{"version":3,"file":"ReactIntegration.js","sources":["ReactIntegration.tsx"],"sourcesContent":["// SPDX-FileCopyrightText: 2023 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nimport { ComponentType, StrictMode } from \"react\";\nimport { createRoot, Root } from \"react-dom/client\";\nimport { Error } from \"@open-pioneer/core\";\nimport { ErrorId } from \"../errors\";\nimport { ServiceLayer } from \"../service-layer/ServiceLayer\";\nimport { PackageContext, PackageContextMethods } from \"@open-pioneer/runtime-react-support\";\nimport { PackageRepr } from \"../service-layer/PackageRepr\";\nimport { InterfaceSpec, renderInterfaceSpec } from \"../service-layer/InterfaceSpec\";\nimport { renderAmbiguousServiceChoices } from \"../service-layer/ServiceLookup\";\nimport { CustomChakraProvider } from \"@open-pioneer/chakra-integration\";\nimport { theme as defaultTrailsTheme } from \"@open-pioneer/base-theme\";\n\nexport interface ReactIntegrationOptions {\n packages: Map<string, PackageRepr>;\n serviceLayer: ServiceLayer;\n rootNode: HTMLDivElement;\n container: Node;\n theme: Record<string, unknown> | undefined;\n}\n\nexport class ReactIntegration {\n private containerNode: Node;\n private theme: Record<string, unknown> | undefined;\n private packages: Map<string, PackageRepr>;\n private serviceLayer: ServiceLayer;\n private root: Root;\n private packageContext: PackageContextMethods;\n\n constructor(options: ReactIntegrationOptions) {\n this.containerNode = options.container;\n this.theme = options.theme;\n this.packages = options.packages;\n this.serviceLayer = options.serviceLayer;\n this.root = createRoot(options.rootNode);\n this.packageContext = {\n getService: (packageName, interfaceName, options) => {\n const spec: InterfaceSpec = { interfaceName, ...options };\n const result = this.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 = this.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 this.getPackage(packageName).properties;\n },\n getIntl: (packageName) => {\n return this.getPackage(packageName).intl;\n }\n };\n }\n\n render(Component: ComponentType) {\n this.root.render(\n <StrictMode>\n <CustomChakraProvider\n container={this.containerNode}\n colorMode=\"light\"\n theme={this.theme ?? defaultTrailsTheme}\n >\n <PackageContext.Provider value={this.packageContext}>\n <Component />\n </PackageContext.Provider>\n </CustomChakraProvider>\n </StrictMode>\n );\n }\n\n destroy() {\n this.root.unmount();\n }\n\n private getPackage(packageName: string): PackageRepr {\n const pkg = this.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\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":["options","defaultTrailsTheme"],"mappings":"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"}
|
|
@@ -2,9 +2,18 @@ import { PackageRepr } from "./PackageRepr";
|
|
|
2
2
|
import { ServiceLookupResult, ServicesLookupResult } from "./ServiceLookup";
|
|
3
3
|
import { InterfaceSpec, ReferenceSpec } from "./InterfaceSpec";
|
|
4
4
|
export type DynamicLookupResult = ServiceLookupResult | UndeclaredDependency;
|
|
5
|
+
/**
|
|
6
|
+
* Returned when a dependency is not declared in the package's metadata.
|
|
7
|
+
*/
|
|
5
8
|
export interface UndeclaredDependency {
|
|
6
9
|
type: "undeclared";
|
|
7
10
|
}
|
|
11
|
+
/**
|
|
12
|
+
* Returned when a package is not found in the application's metadata.
|
|
13
|
+
*/
|
|
14
|
+
export interface UnknownPackage {
|
|
15
|
+
type: "unknown-package";
|
|
16
|
+
}
|
|
8
17
|
export declare class ServiceLayer {
|
|
9
18
|
private allServices;
|
|
10
19
|
private requiredServices;
|
|
@@ -34,7 +43,7 @@ export declare class ServiceLayer {
|
|
|
34
43
|
*/
|
|
35
44
|
getService(packageName: string, spec: InterfaceSpec, options?: {
|
|
36
45
|
ignoreDeclarationCheck?: boolean;
|
|
37
|
-
}): ServiceLookupResult | UndeclaredDependency;
|
|
46
|
+
}): ServiceLookupResult | UndeclaredDependency | UnknownPackage;
|
|
38
47
|
/**
|
|
39
48
|
* Returns all services implementing the given interface.
|
|
40
49
|
* Requires that the dependency on all implementations has been declared in the package.
|
|
@@ -44,7 +53,7 @@ export declare class ServiceLayer {
|
|
|
44
53
|
*
|
|
45
54
|
* @throws if the service layer is not in 'started'.
|
|
46
55
|
*/
|
|
47
|
-
getServices(packageName: string, interfaceName: string): ServicesLookupResult | UndeclaredDependency;
|
|
56
|
+
getServices(packageName: string, interfaceName: string): ServicesLookupResult | UndeclaredDependency | UnknownPackage;
|
|
48
57
|
/**
|
|
49
58
|
* Initializes the given service and its dependencies.
|
|
50
59
|
* Dependencies are initialized before the service that requires them.
|
|
@@ -55,7 +64,8 @@ export declare class ServiceLayer {
|
|
|
55
64
|
* The dependencies are destroyed after the service.
|
|
56
65
|
*/
|
|
57
66
|
private destroyService;
|
|
58
|
-
|
|
67
|
+
/** Undefined -> everything is okay */
|
|
68
|
+
private checkDependency;
|
|
59
69
|
private getReference;
|
|
60
70
|
private getServiceDeps;
|
|
61
71
|
}
|
|
@@ -5,6 +5,8 @@ import { isSingleImplementationSpec, renderInterfaceSpec, isAllImplementationsSp
|
|
|
5
5
|
import { RUNTIME_PACKAGE_NAME } from '../builtin-services/index.js';
|
|
6
6
|
|
|
7
7
|
const LOG = createLogger("runtime:ServiceLayer");
|
|
8
|
+
const UNDECLARED_DEPENDENCY = { type: "undeclared" };
|
|
9
|
+
const UNKNOWN_PACKAGE = { type: "unknown-package" };
|
|
8
10
|
class ServiceLayer {
|
|
9
11
|
// All services in the application.
|
|
10
12
|
allServices;
|
|
@@ -91,8 +93,11 @@ class ServiceLayer {
|
|
|
91
93
|
if (this.state !== "started") {
|
|
92
94
|
throw new Error(ErrorId.INTERNAL, "Service layer is not started.");
|
|
93
95
|
}
|
|
94
|
-
if (!options?.ignoreDeclarationCheck
|
|
95
|
-
|
|
96
|
+
if (!options?.ignoreDeclarationCheck) {
|
|
97
|
+
const checkError = this.checkDependency(packageName, spec);
|
|
98
|
+
if (checkError) {
|
|
99
|
+
return checkError;
|
|
100
|
+
}
|
|
96
101
|
}
|
|
97
102
|
return this.serviceLookup.lookupOne(spec);
|
|
98
103
|
}
|
|
@@ -109,8 +114,9 @@ class ServiceLayer {
|
|
|
109
114
|
if (this.state !== "started") {
|
|
110
115
|
throw new Error(ErrorId.INTERNAL, "Service layer is not started.");
|
|
111
116
|
}
|
|
112
|
-
|
|
113
|
-
|
|
117
|
+
const checkError = this.checkDependency(packageName, { interfaceName, all: true });
|
|
118
|
+
if (checkError) {
|
|
119
|
+
return checkError;
|
|
114
120
|
}
|
|
115
121
|
return this.serviceLookup.lookupAll(interfaceName);
|
|
116
122
|
}
|
|
@@ -163,22 +169,23 @@ class ServiceLayer {
|
|
|
163
169
|
}
|
|
164
170
|
}
|
|
165
171
|
}
|
|
166
|
-
|
|
172
|
+
/** Undefined -> everything is okay */
|
|
173
|
+
checkDependency(packageName, spec) {
|
|
167
174
|
const packageEntry = this.declaredDependencies.get(packageName);
|
|
168
175
|
if (!packageEntry) {
|
|
169
|
-
return
|
|
176
|
+
return UNKNOWN_PACKAGE;
|
|
170
177
|
}
|
|
171
178
|
const interfaceEntry = packageEntry.get(spec.interfaceName);
|
|
172
179
|
if (!interfaceEntry) {
|
|
173
|
-
return
|
|
180
|
+
return UNDECLARED_DEPENDENCY;
|
|
174
181
|
}
|
|
175
182
|
if (isSingleImplementationSpec(spec)) {
|
|
176
183
|
if (spec.qualifier == null) {
|
|
177
|
-
return interfaceEntry.unqualified;
|
|
184
|
+
return interfaceEntry.unqualified ? void 0 : UNDECLARED_DEPENDENCY;
|
|
178
185
|
}
|
|
179
|
-
return interfaceEntry.qualifiers.has(spec.qualifier);
|
|
186
|
+
return interfaceEntry.qualifiers.has(spec.qualifier) ? void 0 : UNDECLARED_DEPENDENCY;
|
|
180
187
|
} else {
|
|
181
|
-
return interfaceEntry.all;
|
|
188
|
+
return interfaceEntry.all ? void 0 : UNDECLARED_DEPENDENCY;
|
|
182
189
|
}
|
|
183
190
|
}
|
|
184
191
|
getReference(ref) {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"ServiceLayer.js","sources":["ServiceLayer.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2023 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nimport { ServiceRepr } from \"./ServiceRepr\";\nimport { createLogger, Error } from \"@open-pioneer/core\";\nimport { ErrorId } from \"../errors\";\nimport {\n ComputedServiceDependencies,\n FrameworkDependency,\n UIDependency,\n verifyDependencies\n} from \"./verifyDependencies\";\nimport { PackageRepr } from \"./PackageRepr\";\nimport { ReadonlyServiceLookup, ServiceLookupResult, ServicesLookupResult } from \"./ServiceLookup\";\nimport {\n InterfaceSpec,\n isAllImplementationsSpec,\n isSingleImplementationSpec,\n ReferenceSpec,\n renderInterfaceSpec\n} from \"./InterfaceSpec\";\nimport { ReferenceMeta } from \"../Service\";\nimport { RUNTIME_PACKAGE_NAME } from \"../builtin-services\";\n\nconst LOG = createLogger(\"runtime:ServiceLayer\");\n\nexport type DynamicLookupResult = ServiceLookupResult | UndeclaredDependency;\n\nexport interface UndeclaredDependency {\n type: \"undeclared\";\n}\n\ninterface DependencyDeclarations {\n all: boolean;\n unqualified: boolean;\n qualifiers: Set<string>;\n}\n\nexport class ServiceLayer {\n // All services in the application.\n private allServices: ServiceRepr[];\n\n // Set of required services. These services and their dependencies will be started.\n private requiredServices: Set<ServiceRepr>;\n\n private serviceLookup: ReadonlyServiceLookup;\n\n // Service id --> Service dependencies\n private serviceDependencies: Map<string, ComputedServiceDependencies>;\n\n // Package name --> Interface name --> Declarations\n private declaredDependencies;\n private state: \"not-started\" | \"started\" | \"destroyed\" = \"not-started\";\n\n /**\n * Constructs a new service layer instance.\n * Requires the application's set of packages (from which services are taken)\n * and an optional set of forced references (interfaces whose implementing services will be started unconditionally).\n *\n * In its current form, the service layer will start only forced references and references needed by the UI (and their dependencies).\n */\n constructor(packages: readonly PackageRepr[], forcedReferences: ReferenceSpec[] = []) {\n const allServices = packages.map((pkg) => pkg.services).flat();\n const uiDependencies = packages\n .map((pkg) =>\n pkg.uiReferences.map<UIDependency>((dep) => {\n return {\n type: \"ui\",\n packageName: pkg.name,\n ...dep\n };\n })\n )\n .flat();\n const requiredReferences = [\n ...forcedReferences.map<FrameworkDependency>((r) => ({\n type: \"framework\",\n ...r\n })),\n ...uiDependencies\n ];\n const { serviceLookup, serviceDependencies } = verifyDependencies({\n services: allServices,\n requiredReferences: requiredReferences\n });\n\n this.allServices = allServices;\n this.requiredServices = getRequiredServices(requiredReferences, serviceLookup);\n this.serviceLookup = serviceLookup;\n this.serviceDependencies = serviceDependencies;\n this.declaredDependencies = buildDependencyIndex(packages);\n }\n\n destroy() {\n for (const service of this.requiredServices) {\n this.destroyService(service);\n }\n this.state = \"destroyed\";\n }\n\n start() {\n if (this.state !== \"not-started\") {\n throw new Error(ErrorId.INTERNAL, \"Service layer was already started.\");\n }\n\n for (const service of this.requiredServices) {\n this.createService(service);\n }\n this.state = \"started\";\n\n // Give warnings for unneeded services during development.\n if (import.meta.env.DEV) {\n const unneededServices = this.allServices\n .filter(\n (service) =>\n service.packageName !== RUNTIME_PACKAGE_NAME &&\n service.state === \"not-constructed\"\n )\n .map((service) => `'${service.id}'`);\n if (unneededServices.length) {\n const services = unneededServices.join(\", \");\n LOG.warn(\n `The following services are contained in the application but were not started: ${services}.`\n );\n }\n }\n }\n\n /**\n * Returns a service implementing the given interface.\n * Checks that the given package actually declared a dependency on that interface\n * to enforce coding guidelines.\n *\n * @param packageName the name of the package requesting the import\n * @param spec the interface specifier\n * @param options advanced options to customize lookup\n * @throws if the service layer is not in 'started' state or if no service implements the interface.\n */\n getService(\n packageName: string,\n spec: InterfaceSpec,\n options?: { ignoreDeclarationCheck?: boolean }\n ): ServiceLookupResult | UndeclaredDependency {\n if (this.state !== \"started\") {\n throw new Error(ErrorId.INTERNAL, \"Service layer is not started.\");\n }\n\n if (!options?.ignoreDeclarationCheck && !this.isDeclaredDependency(packageName, spec)) {\n return { type: \"undeclared\" };\n }\n\n return this.serviceLookup.lookupOne(spec);\n }\n\n /**\n * Returns all services implementing the given interface.\n * Requires that the dependency on all implementations has been declared in the package.\n *\n * @param packageName the name of the package requesting the import\n * @param interfaceName the interface name\n *\n * @throws if the service layer is not in 'started'.\n */\n getServices(\n packageName: string,\n interfaceName: string\n ): ServicesLookupResult | UndeclaredDependency {\n if (this.state !== \"started\") {\n throw new Error(ErrorId.INTERNAL, \"Service layer is not started.\");\n }\n\n if (!this.isDeclaredDependency(packageName, { interfaceName, all: true })) {\n return { type: \"undeclared\" };\n }\n\n return this.serviceLookup.lookupAll(interfaceName);\n }\n\n /**\n * Initializes the given service and its dependencies.\n * Dependencies are initialized before the service that requires them.\n */\n private createService(service: ServiceRepr) {\n if (service.state === \"constructed\") {\n const instance = service.getInstanceOrThrow();\n service.addRef();\n return instance;\n }\n if (service.state === \"constructing\") {\n throw new Error(ErrorId.INTERNAL, \"Cycle during service construction.\");\n }\n if (service.state !== \"not-constructed\") {\n throw new Error(ErrorId.INTERNAL, \"Invalid service state.\");\n }\n\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n const references: Record<string, any> = {};\n const referencesMeta: Record<string, ReferenceMeta | ReferenceMeta[]> = {};\n\n // Sets state to 'constructing' to detect cycles\n service.beforeCreate();\n\n // Initialize dependencies recursively before creating the current service.\n for (const [referenceName, serviceDeps] of Object.entries(this.getServiceDeps(service))) {\n const [referenceValue, referenceMeta] = this.getReference(serviceDeps);\n references[referenceName] = referenceValue;\n referencesMeta[referenceName] = referenceMeta;\n }\n\n // Sets state to 'constructed' to finish the state transition, useCount is 1.\n LOG.debug(`Creating service '${service.id}'.`);\n return service.create({ references, referencesMeta });\n }\n\n /**\n * Destroys the given service and its dependencies.\n * The dependencies are destroyed after the service.\n */\n private destroyService(service: ServiceRepr) {\n if (service.state === \"destroyed\") {\n return;\n }\n\n // Destroy the service before its dependencies (reverse order\n // compared to construction).\n if (service.removeRef() <= 0) {\n LOG.debug(`Destroying service '${service.id}'`);\n service.destroy();\n }\n\n for (const serviceDeps of Object.values(this.getServiceDeps(service))) {\n if (Array.isArray(serviceDeps)) {\n for (const dep of serviceDeps) {\n this.destroyService(dep);\n }\n } else {\n this.destroyService(serviceDeps);\n }\n }\n }\n\n private isDeclaredDependency(packageName: string, spec: ReferenceSpec) {\n const packageEntry = this.declaredDependencies.get(packageName);\n if (!packageEntry) {\n return false;\n }\n const interfaceEntry = packageEntry.get(spec.interfaceName);\n if (!interfaceEntry) {\n return false;\n }\n\n if (isSingleImplementationSpec(spec)) {\n if (spec.qualifier == null) {\n return interfaceEntry.unqualified;\n }\n return interfaceEntry.qualifiers.has(spec.qualifier);\n } else {\n return interfaceEntry.all;\n }\n }\n\n private getReference(ref: ServiceRepr): [unknown, ReferenceMeta];\n private getReference(ref: ServiceRepr[]): [unknown[], ReferenceMeta[]];\n private getReference(\n ref: ServiceRepr | ServiceRepr[]\n ): [unknown, ReferenceMeta] | [unknown[], ReferenceMeta[]];\n private getReference(\n ref: ServiceRepr | ServiceRepr[]\n ): [unknown, ReferenceMeta] | [unknown[], ReferenceMeta[]] {\n if (Array.isArray(ref)) {\n const referenceValues: unknown[] = [];\n const referenceMeta: ReferenceMeta[] = [];\n for (const d of ref) {\n const [value, meta] = this.getReference(d);\n referenceValues.push(value);\n referenceMeta.push(meta);\n }\n return [referenceValues, referenceMeta];\n }\n\n const referenceValue = this.createService(ref);\n const referenceMeta: ReferenceMeta = {\n serviceId: ref.id\n };\n return [referenceValue, referenceMeta];\n }\n\n private getServiceDeps(service: ServiceRepr) {\n const dependencies = this.serviceDependencies.get(service.id);\n if (!dependencies) {\n throw new Error(\n ErrorId.INTERNAL,\n `Failed to find precomputed service dependencies for '${service.id}'.`\n );\n }\n return dependencies;\n }\n}\n\nfunction getRequiredServices(\n requiredReferences: readonly ReferenceSpec[],\n serviceLookup: ReadonlyServiceLookup\n): Set<ServiceRepr> {\n const requiredServices = new Set<ServiceRepr>();\n for (const referenceSpec of requiredReferences) {\n const result = serviceLookup.lookup(referenceSpec);\n if (result.type !== \"found\") {\n // Should be caught by verifier\n throw new Error(\n ErrorId.INTERNAL,\n `Failed to find required reference to ${renderInterfaceSpec(referenceSpec)}.`\n );\n }\n if (Array.isArray(result.value)) {\n for (const service of result.value) {\n requiredServices.add(service);\n }\n } else {\n requiredServices.add(result.value);\n }\n }\n return requiredServices;\n}\n\nfunction buildDependencyIndex(packages: readonly PackageRepr[]) {\n // Register declared UI dependencies.\n // This is needed as a lookup structure to that dynamic service lookups\n // can be validated at runtime.\n const index = new Map<string, Map<string, DependencyDeclarations>>();\n for (const pkg of packages) {\n const packageName = pkg.name;\n const packageEntry = new Map<string, DependencyDeclarations>();\n for (const uiReference of pkg.uiReferences) {\n let interfaceEntry = packageEntry.get(uiReference.interfaceName);\n if (!interfaceEntry) {\n interfaceEntry = {\n all: false,\n unqualified: false,\n qualifiers: new Set<string>()\n };\n packageEntry.set(uiReference.interfaceName, interfaceEntry);\n }\n\n if (isAllImplementationsSpec(uiReference)) {\n interfaceEntry.all = true;\n } else if (isSingleImplementationSpec(uiReference)) {\n if (uiReference.qualifier == null) {\n interfaceEntry.unqualified = true;\n } else {\n interfaceEntry.qualifiers.add(uiReference.qualifier);\n }\n } else {\n throw new Error(ErrorId.INTERNAL, `Unexpected implementation spec.`);\n }\n }\n index.set(packageName, packageEntry);\n }\n return index;\n}\n"],"names":["referenceMeta"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"ServiceLayer.js","sources":["ServiceLayer.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2023 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nimport { ServiceRepr } from \"./ServiceRepr\";\nimport { createLogger, Error } from \"@open-pioneer/core\";\nimport { ErrorId } from \"../errors\";\nimport {\n ComputedServiceDependencies,\n FrameworkDependency,\n UIDependency,\n verifyDependencies\n} from \"./verifyDependencies\";\nimport { PackageRepr } from \"./PackageRepr\";\nimport { ReadonlyServiceLookup, ServiceLookupResult, ServicesLookupResult } from \"./ServiceLookup\";\nimport {\n InterfaceSpec,\n isAllImplementationsSpec,\n isSingleImplementationSpec,\n ReferenceSpec,\n renderInterfaceSpec\n} from \"./InterfaceSpec\";\nimport { ReferenceMeta } from \"../Service\";\nimport { RUNTIME_PACKAGE_NAME } from \"../builtin-services\";\n\nconst LOG = createLogger(\"runtime:ServiceLayer\");\n\nexport type DynamicLookupResult = ServiceLookupResult | UndeclaredDependency;\n\n/**\n * Returned when a dependency is not declared in the package's metadata.\n */\nexport interface UndeclaredDependency {\n type: \"undeclared\";\n}\n\n/**\n * Returned when a package is not found in the application's metadata.\n */\nexport interface UnknownPackage {\n type: \"unknown-package\";\n}\n\nconst UNDECLARED_DEPENDENCY = { type: \"undeclared\" } satisfies UndeclaredDependency;\nconst UNKNOWN_PACKAGE = { type: \"unknown-package\" } satisfies UnknownPackage;\n\ninterface DependencyDeclarations {\n all: boolean;\n unqualified: boolean;\n qualifiers: Set<string>;\n}\n\nexport class ServiceLayer {\n // All services in the application.\n private allServices: ServiceRepr[];\n\n // Set of required services. These services and their dependencies will be started.\n private requiredServices: Set<ServiceRepr>;\n\n private serviceLookup: ReadonlyServiceLookup;\n\n // Service id --> Service dependencies\n private serviceDependencies: Map<string, ComputedServiceDependencies>;\n\n // Package name --> Interface name --> Declarations\n private declaredDependencies;\n private state: \"not-started\" | \"started\" | \"destroyed\" = \"not-started\";\n\n /**\n * Constructs a new service layer instance.\n * Requires the application's set of packages (from which services are taken)\n * and an optional set of forced references (interfaces whose implementing services will be started unconditionally).\n *\n * In its current form, the service layer will start only forced references and references needed by the UI (and their dependencies).\n */\n constructor(packages: readonly PackageRepr[], forcedReferences: ReferenceSpec[] = []) {\n const allServices = packages.map((pkg) => pkg.services).flat();\n const uiDependencies = packages\n .map((pkg) =>\n pkg.uiReferences.map<UIDependency>((dep) => {\n return {\n type: \"ui\",\n packageName: pkg.name,\n ...dep\n };\n })\n )\n .flat();\n const requiredReferences = [\n ...forcedReferences.map<FrameworkDependency>((r) => ({\n type: \"framework\",\n ...r\n })),\n ...uiDependencies\n ];\n const { serviceLookup, serviceDependencies } = verifyDependencies({\n services: allServices,\n requiredReferences: requiredReferences\n });\n\n this.allServices = allServices;\n this.requiredServices = getRequiredServices(requiredReferences, serviceLookup);\n this.serviceLookup = serviceLookup;\n this.serviceDependencies = serviceDependencies;\n this.declaredDependencies = buildDependencyIndex(packages);\n }\n\n destroy() {\n for (const service of this.requiredServices) {\n this.destroyService(service);\n }\n this.state = \"destroyed\";\n }\n\n start() {\n if (this.state !== \"not-started\") {\n throw new Error(ErrorId.INTERNAL, \"Service layer was already started.\");\n }\n\n for (const service of this.requiredServices) {\n this.createService(service);\n }\n this.state = \"started\";\n\n // Give warnings for unneeded services during development.\n if (import.meta.env.DEV) {\n const unneededServices = this.allServices\n .filter(\n (service) =>\n service.packageName !== RUNTIME_PACKAGE_NAME &&\n service.state === \"not-constructed\"\n )\n .map((service) => `'${service.id}'`);\n if (unneededServices.length) {\n const services = unneededServices.join(\", \");\n LOG.warn(\n `The following services are contained in the application but were not started: ${services}.`\n );\n }\n }\n }\n\n /**\n * Returns a service implementing the given interface.\n * Checks that the given package actually declared a dependency on that interface\n * to enforce coding guidelines.\n *\n * @param packageName the name of the package requesting the import\n * @param spec the interface specifier\n * @param options advanced options to customize lookup\n * @throws if the service layer is not in 'started' state or if no service implements the interface.\n */\n getService(\n packageName: string,\n spec: InterfaceSpec,\n options?: { ignoreDeclarationCheck?: boolean }\n ): ServiceLookupResult | UndeclaredDependency | UnknownPackage {\n if (this.state !== \"started\") {\n throw new Error(ErrorId.INTERNAL, \"Service layer is not started.\");\n }\n\n if (!options?.ignoreDeclarationCheck) {\n const checkError = this.checkDependency(packageName, spec);\n if (checkError) {\n return checkError;\n }\n }\n\n return this.serviceLookup.lookupOne(spec);\n }\n\n /**\n * Returns all services implementing the given interface.\n * Requires that the dependency on all implementations has been declared in the package.\n *\n * @param packageName the name of the package requesting the import\n * @param interfaceName the interface name\n *\n * @throws if the service layer is not in 'started'.\n */\n getServices(\n packageName: string,\n interfaceName: string\n ): ServicesLookupResult | UndeclaredDependency | UnknownPackage {\n if (this.state !== \"started\") {\n throw new Error(ErrorId.INTERNAL, \"Service layer is not started.\");\n }\n\n const checkError = this.checkDependency(packageName, { interfaceName, all: true });\n if (checkError) {\n return checkError;\n }\n return this.serviceLookup.lookupAll(interfaceName);\n }\n\n /**\n * Initializes the given service and its dependencies.\n * Dependencies are initialized before the service that requires them.\n */\n private createService(service: ServiceRepr) {\n if (service.state === \"constructed\") {\n const instance = service.getInstanceOrThrow();\n service.addRef();\n return instance;\n }\n if (service.state === \"constructing\") {\n throw new Error(ErrorId.INTERNAL, \"Cycle during service construction.\");\n }\n if (service.state !== \"not-constructed\") {\n throw new Error(ErrorId.INTERNAL, \"Invalid service state.\");\n }\n\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n const references: Record<string, any> = {};\n const referencesMeta: Record<string, ReferenceMeta | ReferenceMeta[]> = {};\n\n // Sets state to 'constructing' to detect cycles\n service.beforeCreate();\n\n // Initialize dependencies recursively before creating the current service.\n for (const [referenceName, serviceDeps] of Object.entries(this.getServiceDeps(service))) {\n const [referenceValue, referenceMeta] = this.getReference(serviceDeps);\n references[referenceName] = referenceValue;\n referencesMeta[referenceName] = referenceMeta;\n }\n\n // Sets state to 'constructed' to finish the state transition, useCount is 1.\n LOG.debug(`Creating service '${service.id}'.`);\n return service.create({ references, referencesMeta });\n }\n\n /**\n * Destroys the given service and its dependencies.\n * The dependencies are destroyed after the service.\n */\n private destroyService(service: ServiceRepr) {\n if (service.state === \"destroyed\") {\n return;\n }\n\n // Destroy the service before its dependencies (reverse order\n // compared to construction).\n if (service.removeRef() <= 0) {\n LOG.debug(`Destroying service '${service.id}'`);\n service.destroy();\n }\n\n for (const serviceDeps of Object.values(this.getServiceDeps(service))) {\n if (Array.isArray(serviceDeps)) {\n for (const dep of serviceDeps) {\n this.destroyService(dep);\n }\n } else {\n this.destroyService(serviceDeps);\n }\n }\n }\n\n /** Undefined -> everything is okay */\n private checkDependency(\n packageName: string,\n spec: ReferenceSpec\n ): UnknownPackage | UndeclaredDependency | undefined {\n const packageEntry = this.declaredDependencies.get(packageName);\n if (!packageEntry) {\n return UNKNOWN_PACKAGE;\n }\n\n const interfaceEntry = packageEntry.get(spec.interfaceName);\n if (!interfaceEntry) {\n return UNDECLARED_DEPENDENCY;\n }\n\n if (isSingleImplementationSpec(spec)) {\n if (spec.qualifier == null) {\n return interfaceEntry.unqualified ? undefined : UNDECLARED_DEPENDENCY;\n }\n return interfaceEntry.qualifiers.has(spec.qualifier)\n ? undefined\n : UNDECLARED_DEPENDENCY;\n } else {\n return interfaceEntry.all ? undefined : UNDECLARED_DEPENDENCY;\n }\n }\n\n private getReference(ref: ServiceRepr): [unknown, ReferenceMeta];\n private getReference(ref: ServiceRepr[]): [unknown[], ReferenceMeta[]];\n private getReference(\n ref: ServiceRepr | ServiceRepr[]\n ): [unknown, ReferenceMeta] | [unknown[], ReferenceMeta[]];\n private getReference(\n ref: ServiceRepr | ServiceRepr[]\n ): [unknown, ReferenceMeta] | [unknown[], ReferenceMeta[]] {\n if (Array.isArray(ref)) {\n const referenceValues: unknown[] = [];\n const referenceMeta: ReferenceMeta[] = [];\n for (const d of ref) {\n const [value, meta] = this.getReference(d);\n referenceValues.push(value);\n referenceMeta.push(meta);\n }\n return [referenceValues, referenceMeta];\n }\n\n const referenceValue = this.createService(ref);\n const referenceMeta: ReferenceMeta = {\n serviceId: ref.id\n };\n return [referenceValue, referenceMeta];\n }\n\n private getServiceDeps(service: ServiceRepr) {\n const dependencies = this.serviceDependencies.get(service.id);\n if (!dependencies) {\n throw new Error(\n ErrorId.INTERNAL,\n `Failed to find precomputed service dependencies for '${service.id}'.`\n );\n }\n return dependencies;\n }\n}\n\nfunction getRequiredServices(\n requiredReferences: readonly ReferenceSpec[],\n serviceLookup: ReadonlyServiceLookup\n): Set<ServiceRepr> {\n const requiredServices = new Set<ServiceRepr>();\n for (const referenceSpec of requiredReferences) {\n const result = serviceLookup.lookup(referenceSpec);\n if (result.type !== \"found\") {\n // Should be caught by verifier\n throw new Error(\n ErrorId.INTERNAL,\n `Failed to find required reference to ${renderInterfaceSpec(referenceSpec)}.`\n );\n }\n if (Array.isArray(result.value)) {\n for (const service of result.value) {\n requiredServices.add(service);\n }\n } else {\n requiredServices.add(result.value);\n }\n }\n return requiredServices;\n}\n\nfunction buildDependencyIndex(packages: readonly PackageRepr[]) {\n // Register declared UI dependencies.\n // This is needed as a lookup structure to that dynamic service lookups\n // can be validated at runtime.\n const index = new Map<string, Map<string, DependencyDeclarations>>();\n for (const pkg of packages) {\n const packageName = pkg.name;\n const packageEntry = new Map<string, DependencyDeclarations>();\n for (const uiReference of pkg.uiReferences) {\n let interfaceEntry = packageEntry.get(uiReference.interfaceName);\n if (!interfaceEntry) {\n interfaceEntry = {\n all: false,\n unqualified: false,\n qualifiers: new Set<string>()\n };\n packageEntry.set(uiReference.interfaceName, interfaceEntry);\n }\n\n if (isAllImplementationsSpec(uiReference)) {\n interfaceEntry.all = true;\n } else if (isSingleImplementationSpec(uiReference)) {\n if (uiReference.qualifier == null) {\n interfaceEntry.unqualified = true;\n } else {\n interfaceEntry.qualifiers.add(uiReference.qualifier);\n }\n } else {\n throw new Error(ErrorId.INTERNAL, `Unexpected implementation spec.`);\n }\n }\n index.set(packageName, packageEntry);\n }\n return index;\n}\n"],"names":["referenceMeta"],"mappings":"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"}
|