@lightningjs/blits 1.30.1 → 1.30.2
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/.editorconfig +7 -7
- package/.eslintignore +1 -1
- package/.eslintrc.cjs +65 -65
- package/.github/workflows/comment-lint-results.yml +124 -124
- package/.github/workflows/comment-test-results.yml +108 -108
- package/.github/workflows/deploy-docs.yml +27 -27
- package/.github/workflows/run-blits-tests.yml +141 -141
- package/.github/workflows/run-lint.yml +127 -127
- package/.husky/pre-commit +1 -1
- package/.vscode/extensions.json +7 -7
- package/.vscode/settings.json +9 -9
- package/CHANGELOG.md +1019 -1012
- package/COPYING +1 -0
- package/LICENSE +202 -202
- package/NOTICE +12 -12
- package/README.md +33 -33
- package/bin/index.js +8 -8
- package/blits.d.ts +6 -6
- package/docs/README.md +19 -19
- package/docs/_sidebar.md +37 -37
- package/docs/built-in/directives.md +50 -50
- package/docs/built-in/for-loop.md +203 -203
- package/docs/built-in/layout.md +168 -168
- package/docs/components/component_state.md +90 -90
- package/docs/components/computed_properties.md +45 -45
- package/docs/components/lifecycle_events.md +42 -42
- package/docs/components/methods.md +45 -45
- package/docs/components/props.md +56 -56
- package/docs/components/user_input.md +186 -186
- package/docs/components/utility_methods.md +320 -320
- package/docs/components/watchers.md +34 -34
- package/docs/essentials/application_root.md +19 -19
- package/docs/essentials/components.md +68 -68
- package/docs/essentials/displaying_images.md +67 -67
- package/docs/essentials/displaying_text.md +135 -135
- package/docs/essentials/element_attributes.md +195 -195
- package/docs/essentials/settings.md +117 -117
- package/docs/essentials/template_syntax.md +83 -83
- package/docs/getting_started/file_structure.md +58 -58
- package/docs/getting_started/getting_started.md +45 -45
- package/docs/getting_started/intro.md +20 -20
- package/docs/index.html +47 -47
- package/docs/performance/lazy-loading.md +161 -161
- package/docs/plugins/global_app_state.md +98 -98
- package/docs/plugins/language.md +172 -172
- package/docs/plugins/text-to-speech-announcer.md +119 -119
- package/docs/plugins/theme.md +176 -176
- package/docs/router/basics.md +175 -175
- package/docs/router/hooks.md +70 -70
- package/docs/router/transitions.md +146 -146
- package/docs/sidebar.json +171 -171
- package/docs/transitions_animations/transitions.md +150 -150
- package/index.d.ts +1099 -1099
- package/index.js +28 -28
- package/jsconfig.json +12 -12
- package/package.json +56 -56
- package/public/assets/fps_sprite.base64.js +1 -1
- package/scripts/postpublish.js +59 -59
- package/scripts/prepublishOnly.js +84 -84
- package/scripts/prepush.js +78 -78
- package/src/announcer/announcer.js +162 -162
- package/src/announcer/speechSynthesis.js +107 -107
- package/src/application.js +100 -100
- package/src/component/base/announcer.js +27 -27
- package/src/component/base/events.js +69 -69
- package/src/component/base/index.js +33 -33
- package/src/component/base/methods.js +244 -244
- package/src/component/base/router.js +41 -41
- package/src/component/base/timeouts_intervals.js +99 -99
- package/src/component/base/utils.js +72 -72
- package/src/component/setup/computed.js +48 -48
- package/src/component/setup/index.js +62 -62
- package/src/component/setup/input.js +30 -30
- package/src/component/setup/methods.js +37 -37
- package/src/component/setup/props.js +62 -62
- package/src/component/setup/props.test.js +238 -238
- package/src/component/setup/routes.js +42 -42
- package/src/component/setup/state.js +59 -59
- package/src/component/setup/watch.js +35 -35
- package/src/component.js +437 -437
- package/src/component.test.js +388 -388
- package/src/components/Circle.js +73 -73
- package/src/components/Circle.orig.js +31 -31
- package/src/components/FPScounter.js +1510 -1510
- package/src/components/FPScounter.orig.js +121 -121
- package/src/components/RouterView.js +81 -81
- package/src/components/RouterView.orig.js +54 -54
- package/src/components/Sprite.js +94 -94
- package/src/components/Sprite.orig.js +58 -58
- package/src/components/index.js +28 -28
- package/src/components/index.orig.js +28 -28
- package/src/constants.js +21 -21
- package/src/engine.js +1 -1
- package/src/engines/L3/element.js +744 -744
- package/src/engines/L3/element.test.js +579 -579
- package/src/engines/L3/fontLoader.js +38 -38
- package/src/engines/L3/index.js +7 -7
- package/src/engines/L3/launch.js +123 -123
- package/src/engines/L3/shaderLoader.js +12 -12
- package/src/engines/index.js +1 -1
- package/src/focus.js +90 -90
- package/src/helpers/deepEqualArray.js +50 -50
- package/src/helpers/deepEqualArray.test.js +127 -127
- package/src/helpers/fetchJson.js +34 -34
- package/src/helpers/sequence.js +26 -26
- package/src/launch.js +123 -123
- package/src/lib/blitsfileconverter/blitsfileconverter.js +52 -52
- package/src/lib/codegenerator/generator.js +788 -788
- package/src/lib/codegenerator/generator.test.js +3801 -3801
- package/src/lib/colors/colors.js +92 -92
- package/src/lib/colors/colors.test.js +290 -290
- package/src/lib/colors/htmlColors.js +168 -168
- package/src/lib/componentId.js +49 -49
- package/src/lib/componentId.test.js +84 -84
- package/src/lib/eventListeners.js +123 -123
- package/src/lib/eventListeners.test.js +236 -236
- package/src/lib/hooks.js +59 -59
- package/src/lib/lifecycle.js +85 -85
- package/src/lib/log.js +117 -117
- package/src/lib/precompiler/precompiler.js +73 -73
- package/src/lib/reactivity/effect.js +93 -93
- package/src/lib/reactivity/effect.test.js +35 -35
- package/src/lib/reactivity/reactive.js +208 -208
- package/src/lib/reactivity/reactive.test.js +27 -27
- package/src/lib/reactivityguard/computedprops.js +218 -218
- package/src/lib/symbols.js +108 -108
- package/src/lib/templateparser/parser.js +386 -386
- package/src/lib/templateparser/parser.test.js +1411 -1411
- package/src/lib/utils.js +27 -27
- package/src/plugin.js +27 -27
- package/src/plugins/appstate.js +26 -26
- package/src/plugins/index.js +20 -20
- package/src/plugins/language.js +152 -152
- package/src/plugins/log.js +25 -25
- package/src/plugins/theme.js +94 -94
- package/src/router/router.js +514 -514
- package/src/router/router.test.js +473 -473
- package/src/router/transitions/fadeIn.js +27 -27
- package/src/router/transitions/fadeInOut.js +33 -33
- package/src/router/transitions/index.js +21 -21
- package/src/router/transitions/slideIn.js +28 -28
- package/src/router/transitions/slideInOut.js +33 -33
- package/src/settings.js +40 -40
- package/vite/blitsFileConverter.js +67 -67
- package/vite/index.js +28 -28
- package/vite/msdfGenerator.js +269 -269
- package/vite/preCompiler.js +42 -42
- package/vite/reactivityGuard.js +45 -45
- package/vscode/data/template-attributes.json +589 -589
package/src/lib/utils.js
CHANGED
|
@@ -1,27 +1,27 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* A mapping of common screen resolution names to their scale factors relative to 1080p (Full HD).
|
|
3
|
-
*
|
|
4
|
-
* @type {Object<string|number, number>}
|
|
5
|
-
* @property {number} hd - 0.666... (720p)
|
|
6
|
-
* @property {number} '720p' - 0.666... (720p)
|
|
7
|
-
* @property {number} 720 - 0.666... (720p)
|
|
8
|
-
* @property {number} fhd - 1 (Full HD)
|
|
9
|
-
* @property {number} fullhd - 1 (Full HD)
|
|
10
|
-
* @property {number} '1080p' - 1 (Full HD)
|
|
11
|
-
* @property {number} 1080 - 1 (Full HD)
|
|
12
|
-
* @property {number} '4k' - 2 (2160p)
|
|
13
|
-
* @property {number} '2160p' - 2 (2160p)
|
|
14
|
-
* @property {number} 2160 - 2 (2160p)
|
|
15
|
-
*/
|
|
16
|
-
export const screenResolutions = {
|
|
17
|
-
hd: 0.66666667,
|
|
18
|
-
'720p': 0.66666667,
|
|
19
|
-
720: 0.66666667,
|
|
20
|
-
fhd: 1,
|
|
21
|
-
fullhd: 1,
|
|
22
|
-
'1080p': 1,
|
|
23
|
-
1080: 1,
|
|
24
|
-
'4k': 2,
|
|
25
|
-
'2160p': 2,
|
|
26
|
-
2160: 2,
|
|
27
|
-
}
|
|
1
|
+
/**
|
|
2
|
+
* A mapping of common screen resolution names to their scale factors relative to 1080p (Full HD).
|
|
3
|
+
*
|
|
4
|
+
* @type {Object<string|number, number>}
|
|
5
|
+
* @property {number} hd - 0.666... (720p)
|
|
6
|
+
* @property {number} '720p' - 0.666... (720p)
|
|
7
|
+
* @property {number} 720 - 0.666... (720p)
|
|
8
|
+
* @property {number} fhd - 1 (Full HD)
|
|
9
|
+
* @property {number} fullhd - 1 (Full HD)
|
|
10
|
+
* @property {number} '1080p' - 1 (Full HD)
|
|
11
|
+
* @property {number} 1080 - 1 (Full HD)
|
|
12
|
+
* @property {number} '4k' - 2 (2160p)
|
|
13
|
+
* @property {number} '2160p' - 2 (2160p)
|
|
14
|
+
* @property {number} 2160 - 2 (2160p)
|
|
15
|
+
*/
|
|
16
|
+
export const screenResolutions = {
|
|
17
|
+
hd: 0.66666667,
|
|
18
|
+
'720p': 0.66666667,
|
|
19
|
+
720: 0.66666667,
|
|
20
|
+
fhd: 1,
|
|
21
|
+
fullhd: 1,
|
|
22
|
+
'1080p': 1,
|
|
23
|
+
1080: 1,
|
|
24
|
+
'4k': 2,
|
|
25
|
+
'2160p': 2,
|
|
26
|
+
2160: 2,
|
|
27
|
+
}
|
package/src/plugin.js
CHANGED
|
@@ -1,27 +1,27 @@
|
|
|
1
|
-
import log from './plugins/log.js'
|
|
2
|
-
|
|
3
|
-
export const plugins = {
|
|
4
|
-
// log plugin added by default
|
|
5
|
-
log,
|
|
6
|
-
}
|
|
7
|
-
|
|
8
|
-
const registerPlugin = (plugin, nameOrOptions = '', options = {}) => {
|
|
9
|
-
// map name and options depending on the arguments provided
|
|
10
|
-
let name = undefined
|
|
11
|
-
if (typeof nameOrOptions === 'object') {
|
|
12
|
-
options = nameOrOptions
|
|
13
|
-
} else {
|
|
14
|
-
name = nameOrOptions
|
|
15
|
-
}
|
|
16
|
-
|
|
17
|
-
if (typeof plugin === 'function') {
|
|
18
|
-
if (name === undefined) {
|
|
19
|
-
throw Error('Error registering plugin: name is required for plugin')
|
|
20
|
-
}
|
|
21
|
-
plugins[name] = { plugin, options }
|
|
22
|
-
} else if (plugin.plugin) {
|
|
23
|
-
registerPlugin(plugin.plugin, name || plugin.name, options)
|
|
24
|
-
}
|
|
25
|
-
}
|
|
26
|
-
|
|
27
|
-
export default registerPlugin
|
|
1
|
+
import log from './plugins/log.js'
|
|
2
|
+
|
|
3
|
+
export const plugins = {
|
|
4
|
+
// log plugin added by default
|
|
5
|
+
log,
|
|
6
|
+
}
|
|
7
|
+
|
|
8
|
+
const registerPlugin = (plugin, nameOrOptions = '', options = {}) => {
|
|
9
|
+
// map name and options depending on the arguments provided
|
|
10
|
+
let name = undefined
|
|
11
|
+
if (typeof nameOrOptions === 'object') {
|
|
12
|
+
options = nameOrOptions
|
|
13
|
+
} else {
|
|
14
|
+
name = nameOrOptions
|
|
15
|
+
}
|
|
16
|
+
|
|
17
|
+
if (typeof plugin === 'function') {
|
|
18
|
+
if (name === undefined) {
|
|
19
|
+
throw Error('Error registering plugin: name is required for plugin')
|
|
20
|
+
}
|
|
21
|
+
plugins[name] = { plugin, options }
|
|
22
|
+
} else if (plugin.plugin) {
|
|
23
|
+
registerPlugin(plugin.plugin, name || plugin.name, options)
|
|
24
|
+
}
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
export default registerPlugin
|
package/src/plugins/appstate.js
CHANGED
|
@@ -1,26 +1,26 @@
|
|
|
1
|
-
/*
|
|
2
|
-
* Copyright 2024 Comcast Cable Communications Management, LLC
|
|
3
|
-
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
4
|
-
* you may not use this file except in compliance with the License.
|
|
5
|
-
* You may obtain a copy of the License at
|
|
6
|
-
*
|
|
7
|
-
* http://www.apache.org/licenses/LICENSE-2.0
|
|
8
|
-
*
|
|
9
|
-
* Unless required by applicable law or agreed to in writing, software
|
|
10
|
-
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
11
|
-
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
12
|
-
* See the License for the specific language governing permissions and
|
|
13
|
-
* limitations under the License.
|
|
14
|
-
*
|
|
15
|
-
* SPDX-License-Identifier: Apache-2.0
|
|
16
|
-
*/
|
|
17
|
-
|
|
18
|
-
import { reactive } from '../lib/reactivity/reactive'
|
|
19
|
-
import Settings from '../settings.js'
|
|
20
|
-
|
|
21
|
-
export default {
|
|
22
|
-
name: 'appState',
|
|
23
|
-
plugin(state = {}) {
|
|
24
|
-
return reactive(state, Settings.get('reactivityMode'), true)
|
|
25
|
-
},
|
|
26
|
-
}
|
|
1
|
+
/*
|
|
2
|
+
* Copyright 2024 Comcast Cable Communications Management, LLC
|
|
3
|
+
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
4
|
+
* you may not use this file except in compliance with the License.
|
|
5
|
+
* You may obtain a copy of the License at
|
|
6
|
+
*
|
|
7
|
+
* http://www.apache.org/licenses/LICENSE-2.0
|
|
8
|
+
*
|
|
9
|
+
* Unless required by applicable law or agreed to in writing, software
|
|
10
|
+
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
11
|
+
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
12
|
+
* See the License for the specific language governing permissions and
|
|
13
|
+
* limitations under the License.
|
|
14
|
+
*
|
|
15
|
+
* SPDX-License-Identifier: Apache-2.0
|
|
16
|
+
*/
|
|
17
|
+
|
|
18
|
+
import { reactive } from '../lib/reactivity/reactive'
|
|
19
|
+
import Settings from '../settings.js'
|
|
20
|
+
|
|
21
|
+
export default {
|
|
22
|
+
name: 'appState',
|
|
23
|
+
plugin(state = {}) {
|
|
24
|
+
return reactive(state, Settings.get('reactivityMode'), true)
|
|
25
|
+
},
|
|
26
|
+
}
|
package/src/plugins/index.js
CHANGED
|
@@ -1,20 +1,20 @@
|
|
|
1
|
-
/*
|
|
2
|
-
* Copyright 2024 Comcast Cable Communications Management, LLC
|
|
3
|
-
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
4
|
-
* you may not use this file except in compliance with the License.
|
|
5
|
-
* You may obtain a copy of the License at
|
|
6
|
-
*
|
|
7
|
-
* http://www.apache.org/licenses/LICENSE-2.0
|
|
8
|
-
*
|
|
9
|
-
* Unless required by applicable law or agreed to in writing, software
|
|
10
|
-
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
11
|
-
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
12
|
-
* See the License for the specific language governing permissions and
|
|
13
|
-
* limitations under the License.
|
|
14
|
-
*
|
|
15
|
-
* SPDX-License-Identifier: Apache-2.0
|
|
16
|
-
*/
|
|
17
|
-
|
|
18
|
-
export { default as language } from './language.js'
|
|
19
|
-
export { default as theme } from './theme.js'
|
|
20
|
-
export { default as appState } from './appstate.js'
|
|
1
|
+
/*
|
|
2
|
+
* Copyright 2024 Comcast Cable Communications Management, LLC
|
|
3
|
+
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
4
|
+
* you may not use this file except in compliance with the License.
|
|
5
|
+
* You may obtain a copy of the License at
|
|
6
|
+
*
|
|
7
|
+
* http://www.apache.org/licenses/LICENSE-2.0
|
|
8
|
+
*
|
|
9
|
+
* Unless required by applicable law or agreed to in writing, software
|
|
10
|
+
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
11
|
+
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
12
|
+
* See the License for the specific language governing permissions and
|
|
13
|
+
* limitations under the License.
|
|
14
|
+
*
|
|
15
|
+
* SPDX-License-Identifier: Apache-2.0
|
|
16
|
+
*/
|
|
17
|
+
|
|
18
|
+
export { default as language } from './language.js'
|
|
19
|
+
export { default as theme } from './theme.js'
|
|
20
|
+
export { default as appState } from './appstate.js'
|
package/src/plugins/language.js
CHANGED
|
@@ -1,152 +1,152 @@
|
|
|
1
|
-
/*
|
|
2
|
-
* Copyright 2024 Comcast Cable Communications Management, LLC
|
|
3
|
-
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
4
|
-
* you may not use this file except in compliance with the License.
|
|
5
|
-
* You may obtain a copy of the License at
|
|
6
|
-
*
|
|
7
|
-
* http://www.apache.org/licenses/LICENSE-2.0
|
|
8
|
-
*
|
|
9
|
-
* Unless required by applicable law or agreed to in writing, software
|
|
10
|
-
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
11
|
-
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
12
|
-
* See the License for the specific language governing permissions and
|
|
13
|
-
* limitations under the License.
|
|
14
|
-
*
|
|
15
|
-
* SPDX-License-Identifier: Apache-2.0
|
|
16
|
-
*/
|
|
17
|
-
|
|
18
|
-
import fetchJson from '../helpers/fetchJson'
|
|
19
|
-
import { Log } from '../lib/log'
|
|
20
|
-
import { reactive } from '../lib/reactivity/reactive'
|
|
21
|
-
|
|
22
|
-
import Settings from '../settings.js'
|
|
23
|
-
|
|
24
|
-
export default {
|
|
25
|
-
name: 'language',
|
|
26
|
-
plugin(options = {}) {
|
|
27
|
-
let translations = {}
|
|
28
|
-
let dictionary = {}
|
|
29
|
-
|
|
30
|
-
const state = reactive(
|
|
31
|
-
{
|
|
32
|
-
language: '',
|
|
33
|
-
loaded: 0,
|
|
34
|
-
},
|
|
35
|
-
Settings.get('reactivityMode'),
|
|
36
|
-
true
|
|
37
|
-
)
|
|
38
|
-
|
|
39
|
-
const setLanguage = (language) => {
|
|
40
|
-
const warningMsg =
|
|
41
|
-
Object.keys(translations).length === 0
|
|
42
|
-
? 'No translations loaded. Please load a file with translations or specify a translations object manually'
|
|
43
|
-
: language in translations === false
|
|
44
|
-
? `Language ${language} not available in the loaded translations`
|
|
45
|
-
: false
|
|
46
|
-
if (warningMsg) {
|
|
47
|
-
Log.warn(warningMsg)
|
|
48
|
-
// set the current language in the reactive state
|
|
49
|
-
state.language = language
|
|
50
|
-
} else {
|
|
51
|
-
setDict(language).then(() => {
|
|
52
|
-
state.language = language
|
|
53
|
-
})
|
|
54
|
-
}
|
|
55
|
-
}
|
|
56
|
-
|
|
57
|
-
const setDict = (language) => {
|
|
58
|
-
return new Promise((resolve) => {
|
|
59
|
-
const translationObj = translations[language]
|
|
60
|
-
if (typeof translationObj === 'object') {
|
|
61
|
-
dictionary = translationObj
|
|
62
|
-
resolve()
|
|
63
|
-
} else if (typeof translationObj === 'string') {
|
|
64
|
-
fetchJson(translationObj)
|
|
65
|
-
.then((result) => {
|
|
66
|
-
// save the translations for this language (to prevent loading twice)
|
|
67
|
-
translations[language] = result
|
|
68
|
-
// define the dictionary
|
|
69
|
-
dictionary = result
|
|
70
|
-
resolve()
|
|
71
|
-
})
|
|
72
|
-
.catch((e) => {
|
|
73
|
-
Log.error(e)
|
|
74
|
-
})
|
|
75
|
-
}
|
|
76
|
-
})
|
|
77
|
-
}
|
|
78
|
-
|
|
79
|
-
const loadLanguageFile = (filePath) => {
|
|
80
|
-
return fetchJson(filePath)
|
|
81
|
-
.then((result) => {
|
|
82
|
-
setTranslations(result)
|
|
83
|
-
})
|
|
84
|
-
.catch((e) => {
|
|
85
|
-
Log.error(e)
|
|
86
|
-
})
|
|
87
|
-
}
|
|
88
|
-
|
|
89
|
-
const setTranslations = (translationsObject) => {
|
|
90
|
-
translations = translationsObject
|
|
91
|
-
setDict(state.language).then(() => {
|
|
92
|
-
state.loaded++
|
|
93
|
-
})
|
|
94
|
-
}
|
|
95
|
-
|
|
96
|
-
if ('file' in options) {
|
|
97
|
-
loadLanguageFile(options.file).then(() => {
|
|
98
|
-
if ('language' in options) {
|
|
99
|
-
setLanguage(options.language)
|
|
100
|
-
}
|
|
101
|
-
})
|
|
102
|
-
} else if ('language' in options) {
|
|
103
|
-
setLanguage(options.language)
|
|
104
|
-
}
|
|
105
|
-
|
|
106
|
-
// Public API language plugin
|
|
107
|
-
return {
|
|
108
|
-
translate(key) {
|
|
109
|
-
// reference state.language, to trigger reactive effects for
|
|
110
|
-
// translate functions when language is modified
|
|
111
|
-
state.language
|
|
112
|
-
|
|
113
|
-
// reference state.loaded, to trigger reactive effects for
|
|
114
|
-
// translate functions when language is modified
|
|
115
|
-
state.loaded
|
|
116
|
-
|
|
117
|
-
let replacements = [...arguments].slice(1)
|
|
118
|
-
|
|
119
|
-
// no replacements so just translated string
|
|
120
|
-
if (replacements.length === 0) {
|
|
121
|
-
return (dictionary && dictionary[key]) || key
|
|
122
|
-
} else {
|
|
123
|
-
if (replacements.length === 1 && typeof replacements[0] === 'object') {
|
|
124
|
-
replacements = replacements.pop()
|
|
125
|
-
}
|
|
126
|
-
|
|
127
|
-
return Object.keys(
|
|
128
|
-
// maps array input to an object {0: 'item1', 1: 'item2'}
|
|
129
|
-
Array.isArray(replacements) ? Object.assign({}, replacements) : replacements
|
|
130
|
-
).reduce((text, replacementKey) => {
|
|
131
|
-
return text.replace(
|
|
132
|
-
new RegExp('{\\s?' + replacementKey + '\\s?}', 'g'),
|
|
133
|
-
replacements[replacementKey]
|
|
134
|
-
)
|
|
135
|
-
}, (dictionary && dictionary[key]) || key)
|
|
136
|
-
}
|
|
137
|
-
},
|
|
138
|
-
get language() {
|
|
139
|
-
return state.language
|
|
140
|
-
},
|
|
141
|
-
set(language) {
|
|
142
|
-
setLanguage(language)
|
|
143
|
-
},
|
|
144
|
-
translations(translationsObject) {
|
|
145
|
-
setTranslations(translationsObject)
|
|
146
|
-
},
|
|
147
|
-
load(file) {
|
|
148
|
-
return loadLanguageFile(file)
|
|
149
|
-
},
|
|
150
|
-
}
|
|
151
|
-
},
|
|
152
|
-
}
|
|
1
|
+
/*
|
|
2
|
+
* Copyright 2024 Comcast Cable Communications Management, LLC
|
|
3
|
+
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
4
|
+
* you may not use this file except in compliance with the License.
|
|
5
|
+
* You may obtain a copy of the License at
|
|
6
|
+
*
|
|
7
|
+
* http://www.apache.org/licenses/LICENSE-2.0
|
|
8
|
+
*
|
|
9
|
+
* Unless required by applicable law or agreed to in writing, software
|
|
10
|
+
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
11
|
+
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
12
|
+
* See the License for the specific language governing permissions and
|
|
13
|
+
* limitations under the License.
|
|
14
|
+
*
|
|
15
|
+
* SPDX-License-Identifier: Apache-2.0
|
|
16
|
+
*/
|
|
17
|
+
|
|
18
|
+
import fetchJson from '../helpers/fetchJson'
|
|
19
|
+
import { Log } from '../lib/log'
|
|
20
|
+
import { reactive } from '../lib/reactivity/reactive'
|
|
21
|
+
|
|
22
|
+
import Settings from '../settings.js'
|
|
23
|
+
|
|
24
|
+
export default {
|
|
25
|
+
name: 'language',
|
|
26
|
+
plugin(options = {}) {
|
|
27
|
+
let translations = {}
|
|
28
|
+
let dictionary = {}
|
|
29
|
+
|
|
30
|
+
const state = reactive(
|
|
31
|
+
{
|
|
32
|
+
language: '',
|
|
33
|
+
loaded: 0,
|
|
34
|
+
},
|
|
35
|
+
Settings.get('reactivityMode'),
|
|
36
|
+
true
|
|
37
|
+
)
|
|
38
|
+
|
|
39
|
+
const setLanguage = (language) => {
|
|
40
|
+
const warningMsg =
|
|
41
|
+
Object.keys(translations).length === 0
|
|
42
|
+
? 'No translations loaded. Please load a file with translations or specify a translations object manually'
|
|
43
|
+
: language in translations === false
|
|
44
|
+
? `Language ${language} not available in the loaded translations`
|
|
45
|
+
: false
|
|
46
|
+
if (warningMsg) {
|
|
47
|
+
Log.warn(warningMsg)
|
|
48
|
+
// set the current language in the reactive state
|
|
49
|
+
state.language = language
|
|
50
|
+
} else {
|
|
51
|
+
setDict(language).then(() => {
|
|
52
|
+
state.language = language
|
|
53
|
+
})
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
const setDict = (language) => {
|
|
58
|
+
return new Promise((resolve) => {
|
|
59
|
+
const translationObj = translations[language]
|
|
60
|
+
if (typeof translationObj === 'object') {
|
|
61
|
+
dictionary = translationObj
|
|
62
|
+
resolve()
|
|
63
|
+
} else if (typeof translationObj === 'string') {
|
|
64
|
+
fetchJson(translationObj)
|
|
65
|
+
.then((result) => {
|
|
66
|
+
// save the translations for this language (to prevent loading twice)
|
|
67
|
+
translations[language] = result
|
|
68
|
+
// define the dictionary
|
|
69
|
+
dictionary = result
|
|
70
|
+
resolve()
|
|
71
|
+
})
|
|
72
|
+
.catch((e) => {
|
|
73
|
+
Log.error(e)
|
|
74
|
+
})
|
|
75
|
+
}
|
|
76
|
+
})
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
const loadLanguageFile = (filePath) => {
|
|
80
|
+
return fetchJson(filePath)
|
|
81
|
+
.then((result) => {
|
|
82
|
+
setTranslations(result)
|
|
83
|
+
})
|
|
84
|
+
.catch((e) => {
|
|
85
|
+
Log.error(e)
|
|
86
|
+
})
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
const setTranslations = (translationsObject) => {
|
|
90
|
+
translations = translationsObject
|
|
91
|
+
setDict(state.language).then(() => {
|
|
92
|
+
state.loaded++
|
|
93
|
+
})
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
if ('file' in options) {
|
|
97
|
+
loadLanguageFile(options.file).then(() => {
|
|
98
|
+
if ('language' in options) {
|
|
99
|
+
setLanguage(options.language)
|
|
100
|
+
}
|
|
101
|
+
})
|
|
102
|
+
} else if ('language' in options) {
|
|
103
|
+
setLanguage(options.language)
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
// Public API language plugin
|
|
107
|
+
return {
|
|
108
|
+
translate(key) {
|
|
109
|
+
// reference state.language, to trigger reactive effects for
|
|
110
|
+
// translate functions when language is modified
|
|
111
|
+
state.language
|
|
112
|
+
|
|
113
|
+
// reference state.loaded, to trigger reactive effects for
|
|
114
|
+
// translate functions when language is modified
|
|
115
|
+
state.loaded
|
|
116
|
+
|
|
117
|
+
let replacements = [...arguments].slice(1)
|
|
118
|
+
|
|
119
|
+
// no replacements so just translated string
|
|
120
|
+
if (replacements.length === 0) {
|
|
121
|
+
return (dictionary && dictionary[key]) || key
|
|
122
|
+
} else {
|
|
123
|
+
if (replacements.length === 1 && typeof replacements[0] === 'object') {
|
|
124
|
+
replacements = replacements.pop()
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
return Object.keys(
|
|
128
|
+
// maps array input to an object {0: 'item1', 1: 'item2'}
|
|
129
|
+
Array.isArray(replacements) ? Object.assign({}, replacements) : replacements
|
|
130
|
+
).reduce((text, replacementKey) => {
|
|
131
|
+
return text.replace(
|
|
132
|
+
new RegExp('{\\s?' + replacementKey + '\\s?}', 'g'),
|
|
133
|
+
replacements[replacementKey]
|
|
134
|
+
)
|
|
135
|
+
}, (dictionary && dictionary[key]) || key)
|
|
136
|
+
}
|
|
137
|
+
},
|
|
138
|
+
get language() {
|
|
139
|
+
return state.language
|
|
140
|
+
},
|
|
141
|
+
set(language) {
|
|
142
|
+
setLanguage(language)
|
|
143
|
+
},
|
|
144
|
+
translations(translationsObject) {
|
|
145
|
+
setTranslations(translationsObject)
|
|
146
|
+
},
|
|
147
|
+
load(file) {
|
|
148
|
+
return loadLanguageFile(file)
|
|
149
|
+
},
|
|
150
|
+
}
|
|
151
|
+
},
|
|
152
|
+
}
|
package/src/plugins/log.js
CHANGED
|
@@ -1,25 +1,25 @@
|
|
|
1
|
-
/*
|
|
2
|
-
* Copyright 2024 Comcast Cable Communications Management, LLC
|
|
3
|
-
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
4
|
-
* you may not use this file except in compliance with the License.
|
|
5
|
-
* You may obtain a copy of the License at
|
|
6
|
-
*
|
|
7
|
-
* http://www.apache.org/licenses/LICENSE-2.0
|
|
8
|
-
*
|
|
9
|
-
* Unless required by applicable law or agreed to in writing, software
|
|
10
|
-
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
11
|
-
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
12
|
-
* See the License for the specific language governing permissions and
|
|
13
|
-
* limitations under the License.
|
|
14
|
-
*
|
|
15
|
-
* SPDX-License-Identifier: Apache-2.0
|
|
16
|
-
*/
|
|
17
|
-
|
|
18
|
-
import { default as log } from '../lib/log.js'
|
|
19
|
-
|
|
20
|
-
export default {
|
|
21
|
-
name: 'log',
|
|
22
|
-
plugin() {
|
|
23
|
-
return log('App')
|
|
24
|
-
},
|
|
25
|
-
}
|
|
1
|
+
/*
|
|
2
|
+
* Copyright 2024 Comcast Cable Communications Management, LLC
|
|
3
|
+
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
4
|
+
* you may not use this file except in compliance with the License.
|
|
5
|
+
* You may obtain a copy of the License at
|
|
6
|
+
*
|
|
7
|
+
* http://www.apache.org/licenses/LICENSE-2.0
|
|
8
|
+
*
|
|
9
|
+
* Unless required by applicable law or agreed to in writing, software
|
|
10
|
+
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
11
|
+
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
12
|
+
* See the License for the specific language governing permissions and
|
|
13
|
+
* limitations under the License.
|
|
14
|
+
*
|
|
15
|
+
* SPDX-License-Identifier: Apache-2.0
|
|
16
|
+
*/
|
|
17
|
+
|
|
18
|
+
import { default as log } from '../lib/log.js'
|
|
19
|
+
|
|
20
|
+
export default {
|
|
21
|
+
name: 'log',
|
|
22
|
+
plugin() {
|
|
23
|
+
return log('App')
|
|
24
|
+
},
|
|
25
|
+
}
|