shared-lib-web 0.0.0-stage → 0.0.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/CODING_RULES.md +118 -0
- package/LICENSE +21 -0
- package/README.md +630 -2
- package/dist/components/app-brand.d.ts +9 -0
- package/dist/components/app-brand.d.ts.map +1 -0
- package/dist/components/app-brand.js +23 -0
- package/dist/components/app-brand.js.map +1 -0
- package/dist/components/branch-switcher.d.ts +7 -0
- package/dist/components/branch-switcher.d.ts.map +1 -0
- package/dist/components/branch-switcher.js +37 -0
- package/dist/components/branch-switcher.js.map +1 -0
- package/dist/components/coming-soon.d.ts +6 -0
- package/dist/components/coming-soon.d.ts.map +1 -0
- package/dist/components/coming-soon.js +19 -0
- package/dist/components/coming-soon.js.map +1 -0
- package/dist/components/empty-state.d.ts +15 -0
- package/dist/components/empty-state.d.ts.map +1 -0
- package/dist/components/empty-state.js +14 -0
- package/dist/components/empty-state.js.map +1 -0
- package/dist/components/language-switcher.d.ts +8 -0
- package/dist/components/language-switcher.d.ts.map +1 -0
- package/dist/components/language-switcher.js +48 -0
- package/dist/components/language-switcher.js.map +1 -0
- package/dist/components/page-loader.d.ts +2 -0
- package/dist/components/page-loader.d.ts.map +1 -0
- package/dist/components/page-loader.js +8 -0
- package/dist/components/page-loader.js.map +1 -0
- package/dist/components/page-not-found.d.ts +2 -0
- package/dist/components/page-not-found.d.ts.map +1 -0
- package/dist/components/page-not-found.js +18 -0
- package/dist/components/page-not-found.js.map +1 -0
- package/dist/components/permission-denied.d.ts +2 -0
- package/dist/components/permission-denied.d.ts.map +1 -0
- package/dist/components/permission-denied.js +12 -0
- package/dist/components/permission-denied.js.map +1 -0
- package/dist/components/require-access.d.ts +11 -0
- package/dist/components/require-access.d.ts.map +1 -0
- package/dist/components/require-access.js +15 -0
- package/dist/components/require-access.js.map +1 -0
- package/dist/components/scroll-to-top.d.ts +12 -0
- package/dist/components/scroll-to-top.d.ts.map +1 -0
- package/dist/components/scroll-to-top.js +42 -0
- package/dist/components/scroll-to-top.js.map +1 -0
- package/dist/components/settings-menu.d.ts +17 -0
- package/dist/components/settings-menu.d.ts.map +1 -0
- package/dist/components/settings-menu.js +102 -0
- package/dist/components/settings-menu.js.map +1 -0
- package/dist/components/theme-switcher.d.ts +5 -0
- package/dist/components/theme-switcher.d.ts.map +1 -0
- package/dist/components/theme-switcher.js +33 -0
- package/dist/components/theme-switcher.js.map +1 -0
- package/dist/components/toast-container.d.ts +5 -0
- package/dist/components/toast-container.d.ts.map +1 -0
- package/dist/components/toast-container.js +51 -0
- package/dist/components/toast-container.js.map +1 -0
- package/dist/components/top-progress.d.ts +2 -0
- package/dist/components/top-progress.d.ts.map +1 -0
- package/dist/components/top-progress.js +14 -0
- package/dist/components/top-progress.js.map +1 -0
- package/dist/components/user-menu.d.ts +26 -0
- package/dist/components/user-menu.d.ts.map +1 -0
- package/dist/components/user-menu.js +85 -0
- package/dist/components/user-menu.js.map +1 -0
- package/dist/context/ui-context.d.ts +5 -0
- package/dist/context/ui-context.d.ts.map +1 -0
- package/dist/context/ui-context.js +16 -0
- package/dist/context/ui-context.js.map +1 -0
- package/dist/context/use-ui.d.ts +3 -0
- package/dist/context/use-ui.d.ts.map +1 -0
- package/dist/context/use-ui.js +39 -0
- package/dist/context/use-ui.js.map +1 -0
- package/dist/i18n/default-messages.d.ts +5 -0
- package/dist/i18n/default-messages.d.ts.map +1 -0
- package/dist/i18n/default-messages.js +64 -0
- package/dist/i18n/default-messages.js.map +1 -0
- package/dist/i18n/direction.d.ts +10 -0
- package/dist/i18n/direction.d.ts.map +1 -0
- package/dist/i18n/direction.js +35 -0
- package/dist/i18n/direction.js.map +1 -0
- package/dist/i18n/locale-service.d.ts +36 -0
- package/dist/i18n/locale-service.d.ts.map +1 -0
- package/dist/i18n/locale-service.js +163 -0
- package/dist/i18n/locale-service.js.map +1 -0
- package/dist/i18n/translator.d.ts +14 -0
- package/dist/i18n/translator.d.ts.map +1 -0
- package/dist/i18n/translator.js +81 -0
- package/dist/i18n/translator.js.map +1 -0
- package/dist/index.d.ts +106 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +119 -0
- package/dist/index.js.map +1 -0
- package/dist/interfaces/app-types.d.ts +137 -0
- package/dist/interfaces/app-types.d.ts.map +1 -0
- package/dist/interfaces/app-types.js +5 -0
- package/dist/interfaces/app-types.js.map +1 -0
- package/dist/interfaces/toast.d.ts +9 -0
- package/dist/interfaces/toast.d.ts.map +1 -0
- package/dist/interfaces/toast.js +4 -0
- package/dist/interfaces/toast.js.map +1 -0
- package/dist/interfaces/ui-config.d.ts +172 -0
- package/dist/interfaces/ui-config.d.ts.map +1 -0
- package/dist/interfaces/ui-config.js +6 -0
- package/dist/interfaces/ui-config.js.map +1 -0
- package/dist/interfaces/ui-context.d.ts +37 -0
- package/dist/interfaces/ui-context.d.ts.map +1 -0
- package/dist/interfaces/ui-context.js +4 -0
- package/dist/interfaces/ui-context.js.map +1 -0
- package/dist/layout.d.ts +10 -0
- package/dist/layout.d.ts.map +1 -0
- package/dist/layout.js +22 -0
- package/dist/layout.js.map +1 -0
- package/dist/layouts/app-layout.d.ts +23 -0
- package/dist/layouts/app-layout.d.ts.map +1 -0
- package/dist/layouts/app-layout.js +52 -0
- package/dist/layouts/app-layout.js.map +1 -0
- package/dist/layouts/article-layout.d.ts +7 -0
- package/dist/layouts/article-layout.d.ts.map +1 -0
- package/dist/layouts/article-layout.js +8 -0
- package/dist/layouts/article-layout.js.map +1 -0
- package/dist/layouts/aside-layout.d.ts +27 -0
- package/dist/layouts/aside-layout.d.ts.map +1 -0
- package/dist/layouts/aside-layout.js +70 -0
- package/dist/layouts/aside-layout.js.map +1 -0
- package/dist/layouts/auth-layout.d.ts +7 -0
- package/dist/layouts/auth-layout.d.ts.map +1 -0
- package/dist/layouts/auth-layout.js +20 -0
- package/dist/layouts/auth-layout.js.map +1 -0
- package/dist/layouts/content-layout.d.ts +3 -0
- package/dist/layouts/content-layout.d.ts.map +1 -0
- package/dist/layouts/content-layout.js +10 -0
- package/dist/layouts/content-layout.js.map +1 -0
- package/dist/layouts/float-layout.d.ts +3 -0
- package/dist/layouts/float-layout.d.ts.map +1 -0
- package/dist/layouts/float-layout.js +10 -0
- package/dist/layouts/float-layout.js.map +1 -0
- package/dist/layouts/grid-layout.d.ts +3 -0
- package/dist/layouts/grid-layout.d.ts.map +1 -0
- package/dist/layouts/grid-layout.js +10 -0
- package/dist/layouts/grid-layout.js.map +1 -0
- package/dist/layouts/head-layout.d.ts +16 -0
- package/dist/layouts/head-layout.d.ts.map +1 -0
- package/dist/layouts/head-layout.js +36 -0
- package/dist/layouts/head-layout.js.map +1 -0
- package/dist/layouts/header.d.ts +18 -0
- package/dist/layouts/header.d.ts.map +1 -0
- package/dist/layouts/header.js +26 -0
- package/dist/layouts/header.js.map +1 -0
- package/dist/layouts/layout-constants.d.ts +3 -0
- package/dist/layouts/layout-constants.d.ts.map +1 -0
- package/dist/layouts/layout-constants.js +5 -0
- package/dist/layouts/layout-constants.js.map +1 -0
- package/dist/layouts/mega-menu.d.ts +3 -0
- package/dist/layouts/mega-menu.d.ts.map +1 -0
- package/dist/layouts/mega-menu.js +104 -0
- package/dist/layouts/mega-menu.js.map +1 -0
- package/dist/layouts/navigation.d.ts +11 -0
- package/dist/layouts/navigation.d.ts.map +1 -0
- package/dist/layouts/navigation.js +41 -0
- package/dist/layouts/navigation.js.map +1 -0
- package/dist/layouts/rail-flyout.d.ts +5 -0
- package/dist/layouts/rail-flyout.d.ts.map +1 -0
- package/dist/layouts/rail-flyout.js +49 -0
- package/dist/layouts/rail-flyout.js.map +1 -0
- package/dist/layouts/rail-tooltip.d.ts +8 -0
- package/dist/layouts/rail-tooltip.d.ts.map +1 -0
- package/dist/layouts/rail-tooltip.js +60 -0
- package/dist/layouts/rail-tooltip.js.map +1 -0
- package/dist/layouts/sidebar.d.ts +38 -0
- package/dist/layouts/sidebar.d.ts.map +1 -0
- package/dist/layouts/sidebar.js +137 -0
- package/dist/layouts/sidebar.js.map +1 -0
- package/dist/markdown.d.ts +4 -0
- package/dist/markdown.d.ts.map +1 -0
- package/dist/markdown.js +12 -0
- package/dist/markdown.js.map +1 -0
- package/dist/providers/provider-effects.d.ts +9 -0
- package/dist/providers/provider-effects.d.ts.map +1 -0
- package/dist/providers/provider-effects.js +26 -0
- package/dist/providers/provider-effects.js.map +1 -0
- package/dist/providers/register-config.d.ts +4 -0
- package/dist/providers/register-config.d.ts.map +1 -0
- package/dist/providers/register-config.js +28 -0
- package/dist/providers/register-config.js.map +1 -0
- package/dist/providers/shared-web-ui-provider.d.ts +31 -0
- package/dist/providers/shared-web-ui-provider.d.ts.map +1 -0
- package/dist/providers/shared-web-ui-provider.js +54 -0
- package/dist/providers/shared-web-ui-provider.js.map +1 -0
- package/dist/providers/theme-provider.d.ts +6 -0
- package/dist/providers/theme-provider.d.ts.map +1 -0
- package/dist/providers/theme-provider.js +11 -0
- package/dist/providers/theme-provider.js.map +1 -0
- package/dist/providers/translation-provider.d.ts +8 -0
- package/dist/providers/translation-provider.d.ts.map +1 -0
- package/dist/providers/translation-provider.js +21 -0
- package/dist/providers/translation-provider.js.map +1 -0
- package/dist/query/page-link.d.ts +20 -0
- package/dist/query/page-link.d.ts.map +1 -0
- package/dist/query/page-link.js +53 -0
- package/dist/query/page-link.js.map +1 -0
- package/dist/query/page-path.d.ts +5 -0
- package/dist/query/page-path.d.ts.map +1 -0
- package/dist/query/page-path.js +24 -0
- package/dist/query/page-path.js.map +1 -0
- package/dist/query/query-param.d.ts +63 -0
- package/dist/query/query-param.d.ts.map +1 -0
- package/dist/query/query-param.js +215 -0
- package/dist/query/query-param.js.map +1 -0
- package/dist/query/use-query-param.d.ts +5 -0
- package/dist/query/use-query-param.d.ts.map +1 -0
- package/dist/query/use-query-param.js +21 -0
- package/dist/query/use-query-param.js.map +1 -0
- package/dist/skeleton/skeleton-article.d.ts +2 -0
- package/dist/skeleton/skeleton-article.d.ts.map +1 -0
- package/dist/skeleton/skeleton-article.js +7 -0
- package/dist/skeleton/skeleton-article.js.map +1 -0
- package/dist/skeleton/skeleton-auth-form.d.ts +6 -0
- package/dist/skeleton/skeleton-auth-form.d.ts.map +1 -0
- package/dist/skeleton/skeleton-auth-form.js +9 -0
- package/dist/skeleton/skeleton-auth-form.js.map +1 -0
- package/dist/skeleton/skeleton-cards.d.ts +6 -0
- package/dist/skeleton/skeleton-cards.d.ts.map +1 -0
- package/dist/skeleton/skeleton-cards.js +16 -0
- package/dist/skeleton/skeleton-cards.js.map +1 -0
- package/dist/skeleton/skeleton-chat.d.ts +2 -0
- package/dist/skeleton/skeleton-chat.d.ts.map +1 -0
- package/dist/skeleton/skeleton-chat.js +17 -0
- package/dist/skeleton/skeleton-chat.js.map +1 -0
- package/dist/skeleton/skeleton-dashboard.d.ts +2 -0
- package/dist/skeleton/skeleton-dashboard.d.ts.map +1 -0
- package/dist/skeleton/skeleton-dashboard.js +16 -0
- package/dist/skeleton/skeleton-dashboard.js.map +1 -0
- package/dist/skeleton/skeleton-float.d.ts +2 -0
- package/dist/skeleton/skeleton-float.d.ts.map +1 -0
- package/dist/skeleton/skeleton-float.js +7 -0
- package/dist/skeleton/skeleton-float.js.map +1 -0
- package/dist/skeleton/skeleton-form.d.ts +10 -0
- package/dist/skeleton/skeleton-form.d.ts.map +1 -0
- package/dist/skeleton/skeleton-form.js +16 -0
- package/dist/skeleton/skeleton-form.js.map +1 -0
- package/dist/skeleton/skeleton-menu.d.ts +2 -0
- package/dist/skeleton/skeleton-menu.d.ts.map +1 -0
- package/dist/skeleton/skeleton-menu.js +16 -0
- package/dist/skeleton/skeleton-menu.js.map +1 -0
- package/dist/skeleton/skeleton-page.d.ts +2 -0
- package/dist/skeleton/skeleton-page.d.ts.map +1 -0
- package/dist/skeleton/skeleton-page.js +9 -0
- package/dist/skeleton/skeleton-page.js.map +1 -0
- package/dist/skeleton/skeleton-table.d.ts +2 -0
- package/dist/skeleton/skeleton-table.d.ts.map +1 -0
- package/dist/skeleton/skeleton-table.js +16 -0
- package/dist/skeleton/skeleton-table.js.map +1 -0
- package/dist/state/auth-service.d.ts +28 -0
- package/dist/state/auth-service.d.ts.map +1 -0
- package/dist/state/auth-service.js +92 -0
- package/dist/state/auth-service.js.map +1 -0
- package/dist/state/branch-service.d.ts +42 -0
- package/dist/state/branch-service.d.ts.map +1 -0
- package/dist/state/branch-service.js +193 -0
- package/dist/state/branch-service.js.map +1 -0
- package/dist/state/document-sync.d.ts +7 -0
- package/dist/state/document-sync.d.ts.map +1 -0
- package/dist/state/document-sync.js +39 -0
- package/dist/state/document-sync.js.map +1 -0
- package/dist/state/language-service.d.ts +16 -0
- package/dist/state/language-service.d.ts.map +1 -0
- package/dist/state/language-service.js +73 -0
- package/dist/state/language-service.js.map +1 -0
- package/dist/state/menu-service.d.ts +20 -0
- package/dist/state/menu-service.d.ts.map +1 -0
- package/dist/state/menu-service.js +59 -0
- package/dist/state/menu-service.js.map +1 -0
- package/dist/state/navigation-service.d.ts +37 -0
- package/dist/state/navigation-service.d.ts.map +1 -0
- package/dist/state/navigation-service.js +131 -0
- package/dist/state/navigation-service.js.map +1 -0
- package/dist/state/preference-sync.d.ts +15 -0
- package/dist/state/preference-sync.d.ts.map +1 -0
- package/dist/state/preference-sync.js +85 -0
- package/dist/state/preference-sync.js.map +1 -0
- package/dist/state/progress-service.d.ts +3 -0
- package/dist/state/progress-service.d.ts.map +1 -0
- package/dist/state/progress-service.js +17 -0
- package/dist/state/progress-service.js.map +1 -0
- package/dist/state/screen-access.d.ts +15 -0
- package/dist/state/screen-access.d.ts.map +1 -0
- package/dist/state/screen-access.js +60 -0
- package/dist/state/screen-access.js.map +1 -0
- package/dist/state/sidebar-service.d.ts +8 -0
- package/dist/state/sidebar-service.d.ts.map +1 -0
- package/dist/state/sidebar-service.js +18 -0
- package/dist/state/sidebar-service.js.map +1 -0
- package/dist/state/signals.d.ts +84 -0
- package/dist/state/signals.d.ts.map +1 -0
- package/dist/state/signals.js +137 -0
- package/dist/state/signals.js.map +1 -0
- package/dist/state/toast-service.d.ts +9 -0
- package/dist/state/toast-service.d.ts.map +1 -0
- package/dist/state/toast-service.js +36 -0
- package/dist/state/toast-service.js.map +1 -0
- package/dist/styles.css +15 -0
- package/dist/theme/dark-themes.d.ts +2 -0
- package/dist/theme/dark-themes.d.ts.map +1 -0
- package/dist/theme/dark-themes.js +20 -0
- package/dist/theme/dark-themes.js.map +1 -0
- package/dist/theme/logo.d.ts +4 -0
- package/dist/theme/logo.d.ts.map +1 -0
- package/dist/theme/logo.js +10 -0
- package/dist/theme/logo.js.map +1 -0
- package/dist/theme/theme-service.d.ts +21 -0
- package/dist/theme/theme-service.d.ts.map +1 -0
- package/dist/theme/theme-service.js +69 -0
- package/dist/theme/theme-service.js.map +1 -0
- package/dist/types/class-names.d.ts +9 -0
- package/dist/types/class-names.d.ts.map +1 -0
- package/dist/types/class-names.js +45 -0
- package/dist/types/class-names.js.map +1 -0
- package/dist/types/field-error.d.ts +5 -0
- package/dist/types/field-error.d.ts.map +1 -0
- package/dist/types/field-error.js +16 -0
- package/dist/types/field-error.js.map +1 -0
- package/dist/types/field-props.d.ts +20 -0
- package/dist/types/field-props.d.ts.map +1 -0
- package/dist/types/field-props.js +4 -0
- package/dist/types/field-props.js.map +1 -0
- package/dist/types/field-registry.d.ts +11 -0
- package/dist/types/field-registry.d.ts.map +1 -0
- package/dist/types/field-registry.js +18 -0
- package/dist/types/field-registry.js.map +1 -0
- package/dist/types/field-wrapper.d.ts +13 -0
- package/dist/types/field-wrapper.d.ts.map +1 -0
- package/dist/types/field-wrapper.js +16 -0
- package/dist/types/field-wrapper.js.map +1 -0
- package/dist/types/lang-field.d.ts +15 -0
- package/dist/types/lang-field.d.ts.map +1 -0
- package/dist/types/lang-field.js +68 -0
- package/dist/types/lang-field.js.map +1 -0
- package/dist/types/markdown-color-mode.d.ts +7 -0
- package/dist/types/markdown-color-mode.d.ts.map +1 -0
- package/dist/types/markdown-color-mode.js +11 -0
- package/dist/types/markdown-color-mode.js.map +1 -0
- package/dist/types/media-service.d.ts +24 -0
- package/dist/types/media-service.d.ts.map +1 -0
- package/dist/types/media-service.js +41 -0
- package/dist/types/media-service.js.map +1 -0
- package/dist/types/media-viewer.d.ts +2 -0
- package/dist/types/media-viewer.d.ts.map +1 -0
- package/dist/types/media-viewer.js +23 -0
- package/dist/types/media-viewer.js.map +1 -0
- package/dist/types/type.button.d.ts +36 -0
- package/dist/types/type.button.d.ts.map +1 -0
- package/dist/types/type.button.js +27 -0
- package/dist/types/type.button.js.map +1 -0
- package/dist/types/type.checkbox.d.ts +5 -0
- package/dist/types/type.checkbox.d.ts.map +1 -0
- package/dist/types/type.checkbox.js +26 -0
- package/dist/types/type.checkbox.js.map +1 -0
- package/dist/types/type.confirm.d.ts +19 -0
- package/dist/types/type.confirm.d.ts.map +1 -0
- package/dist/types/type.confirm.js +15 -0
- package/dist/types/type.confirm.js.map +1 -0
- package/dist/types/type.date.d.ts +16 -0
- package/dist/types/type.date.d.ts.map +1 -0
- package/dist/types/type.date.js +65 -0
- package/dist/types/type.date.js.map +1 -0
- package/dist/types/type.drawer.d.ts +20 -0
- package/dist/types/type.drawer.d.ts.map +1 -0
- package/dist/types/type.drawer.js +31 -0
- package/dist/types/type.drawer.js.map +1 -0
- package/dist/types/type.dropdown.d.ts +23 -0
- package/dist/types/type.dropdown.d.ts.map +1 -0
- package/dist/types/type.dropdown.js +34 -0
- package/dist/types/type.dropdown.js.map +1 -0
- package/dist/types/type.filter.d.ts +17 -0
- package/dist/types/type.filter.d.ts.map +1 -0
- package/dist/types/type.filter.js +28 -0
- package/dist/types/type.filter.js.map +1 -0
- package/dist/types/type.icon.d.ts +21 -0
- package/dist/types/type.icon.d.ts.map +1 -0
- package/dist/types/type.icon.js +24 -0
- package/dist/types/type.icon.js.map +1 -0
- package/dist/types/type.image.d.ts +34 -0
- package/dist/types/type.image.d.ts.map +1 -0
- package/dist/types/type.image.js +46 -0
- package/dist/types/type.image.js.map +1 -0
- package/dist/types/type.input.d.ts +13 -0
- package/dist/types/type.input.d.ts.map +1 -0
- package/dist/types/type.input.js +29 -0
- package/dist/types/type.input.js.map +1 -0
- package/dist/types/type.lang-md.d.ts +10 -0
- package/dist/types/type.lang-md.d.ts.map +1 -0
- package/dist/types/type.lang-md.js +56 -0
- package/dist/types/type.lang-md.js.map +1 -0
- package/dist/types/type.lang.d.ts +11 -0
- package/dist/types/type.lang.d.ts.map +1 -0
- package/dist/types/type.lang.js +56 -0
- package/dist/types/type.lang.js.map +1 -0
- package/dist/types/type.list.d.ts +13 -0
- package/dist/types/type.list.d.ts.map +1 -0
- package/dist/types/type.list.js +42 -0
- package/dist/types/type.list.js.map +1 -0
- package/dist/types/type.mdv.d.ts +10 -0
- package/dist/types/type.mdv.d.ts.map +1 -0
- package/dist/types/type.mdv.js +22 -0
- package/dist/types/type.mdv.js.map +1 -0
- package/dist/types/type.mdx.d.ts +10 -0
- package/dist/types/type.mdx.d.ts.map +1 -0
- package/dist/types/type.mdx.js +30 -0
- package/dist/types/type.mdx.js.map +1 -0
- package/dist/types/type.modal.d.ts +18 -0
- package/dist/types/type.modal.d.ts.map +1 -0
- package/dist/types/type.modal.js +30 -0
- package/dist/types/type.modal.js.map +1 -0
- package/dist/types/type.otp.d.ts +8 -0
- package/dist/types/type.otp.d.ts.map +1 -0
- package/dist/types/type.otp.js +48 -0
- package/dist/types/type.otp.js.map +1 -0
- package/dist/types/type.search.d.ts +16 -0
- package/dist/types/type.search.d.ts.map +1 -0
- package/dist/types/type.search.js +48 -0
- package/dist/types/type.search.js.map +1 -0
- package/dist/types/type.select.d.ts +14 -0
- package/dist/types/type.select.d.ts.map +1 -0
- package/dist/types/type.select.js +53 -0
- package/dist/types/type.select.js.map +1 -0
- package/dist/types/type.switch.d.ts +8 -0
- package/dist/types/type.switch.d.ts.map +1 -0
- package/dist/types/type.switch.js +26 -0
- package/dist/types/type.switch.js.map +1 -0
- package/dist/types/type.table.d.ts +28 -0
- package/dist/types/type.table.d.ts.map +1 -0
- package/dist/types/type.table.js +72 -0
- package/dist/types/type.table.js.map +1 -0
- package/dist/types/type.text-area.d.ts +9 -0
- package/dist/types/type.text-area.d.ts.map +1 -0
- package/dist/types/type.text-area.js +26 -0
- package/dist/types/type.text-area.js.map +1 -0
- package/dist/types/type.time.d.ts +9 -0
- package/dist/types/type.time.d.ts.map +1 -0
- package/dist/types/type.time.js +34 -0
- package/dist/types/type.time.js.map +1 -0
- package/dist/types/type.upload.d.ts +45 -0
- package/dist/types/type.upload.d.ts.map +1 -0
- package/dist/types/type.upload.js +90 -0
- package/dist/types/type.upload.js.map +1 -0
- package/dist/types/type.video.d.ts +19 -0
- package/dist/types/type.video.d.ts.map +1 -0
- package/dist/types/type.video.js +33 -0
- package/dist/types/type.video.js.map +1 -0
- package/dist/types/upload-service.d.ts +47 -0
- package/dist/types/upload-service.d.ts.map +1 -0
- package/dist/types/upload-service.js +191 -0
- package/dist/types/upload-service.js.map +1 -0
- package/dist/utils/app-config.d.ts +6 -0
- package/dist/utils/app-config.d.ts.map +1 -0
- package/dist/utils/app-config.js +17 -0
- package/dist/utils/app-config.js.map +1 -0
- package/dist/utils/app-http.d.ts +49 -0
- package/dist/utils/app-http.d.ts.map +1 -0
- package/dist/utils/app-http.js +229 -0
- package/dist/utils/app-http.js.map +1 -0
- package/dist/utils/app-storage.d.ts +56 -0
- package/dist/utils/app-storage.d.ts.map +1 -0
- package/dist/utils/app-storage.js +236 -0
- package/dist/utils/app-storage.js.map +1 -0
- package/dist/utils/crypto-util.d.ts +15 -0
- package/dist/utils/crypto-util.d.ts.map +1 -0
- package/dist/utils/crypto-util.js +76 -0
- package/dist/utils/crypto-util.js.map +1 -0
- package/dist/utils/event-util.d.ts +16 -0
- package/dist/utils/event-util.d.ts.map +1 -0
- package/dist/utils/event-util.js +51 -0
- package/dist/utils/event-util.js.map +1 -0
- package/dist/utils/file-util.d.ts +30 -0
- package/dist/utils/file-util.d.ts.map +1 -0
- package/dist/utils/file-util.js +165 -0
- package/dist/utils/file-util.js.map +1 -0
- package/dist/utils/lang-util.d.ts +12 -0
- package/dist/utils/lang-util.d.ts.map +1 -0
- package/dist/utils/lang-util.js +53 -0
- package/dist/utils/lang-util.js.map +1 -0
- package/dist/utils/language-util.d.ts +21 -0
- package/dist/utils/language-util.d.ts.map +1 -0
- package/dist/utils/language-util.js +96 -0
- package/dist/utils/language-util.js.map +1 -0
- package/dist/utils/leave-guard.d.ts +5 -0
- package/dist/utils/leave-guard.d.ts.map +1 -0
- package/dist/utils/leave-guard.js +24 -0
- package/dist/utils/leave-guard.js.map +1 -0
- package/dist/utils/lucide-icon.d.ts +10 -0
- package/dist/utils/lucide-icon.d.ts.map +1 -0
- package/dist/utils/lucide-icon.js +48 -0
- package/dist/utils/lucide-icon.js.map +1 -0
- package/dist/utils/menu-util.d.ts +33 -0
- package/dist/utils/menu-util.d.ts.map +1 -0
- package/dist/utils/menu-util.js +151 -0
- package/dist/utils/menu-util.js.map +1 -0
- package/dist/utils/option-util.d.ts +21 -0
- package/dist/utils/option-util.d.ts.map +1 -0
- package/dist/utils/option-util.js +101 -0
- package/dist/utils/option-util.js.map +1 -0
- package/dist/utils/session-id.d.ts +5 -0
- package/dist/utils/session-id.d.ts.map +1 -0
- package/dist/utils/session-id.js +44 -0
- package/dist/utils/session-id.js.map +1 -0
- package/dist/utils/shared-regexp.d.ts +31 -0
- package/dist/utils/shared-regexp.d.ts.map +1 -0
- package/dist/utils/shared-regexp.js +17 -0
- package/dist/utils/shared-regexp.js.map +1 -0
- package/dist/utils/storage-keys.d.ts +68 -0
- package/dist/utils/storage-keys.d.ts.map +1 -0
- package/dist/utils/storage-keys.js +75 -0
- package/dist/utils/storage-keys.js.map +1 -0
- package/package.json +101 -4
- package/src/components/app-brand.tsx +37 -0
- package/src/components/branch-switcher.tsx +74 -0
- package/src/components/coming-soon.tsx +35 -0
- package/src/components/empty-state.tsx +42 -0
- package/src/components/language-switcher.tsx +77 -0
- package/src/components/page-loader.tsx +11 -0
- package/src/components/page-not-found.tsx +42 -0
- package/src/components/permission-denied.tsx +21 -0
- package/src/components/require-access.tsx +30 -0
- package/src/components/scroll-to-top.tsx +62 -0
- package/src/components/settings-menu.tsx +224 -0
- package/src/components/theme-switcher.tsx +72 -0
- package/src/components/toast-container.tsx +73 -0
- package/src/components/top-progress.tsx +14 -0
- package/src/components/user-menu.tsx +179 -0
- package/src/context/ui-context.ts +20 -0
- package/src/context/use-ui.ts +42 -0
- package/src/i18n/default-messages.ts +67 -0
- package/src/i18n/direction.ts +43 -0
- package/src/i18n/locale-service.ts +187 -0
- package/src/i18n/translator.ts +88 -0
- package/src/index.ts +341 -0
- package/src/interfaces/app-types.ts +154 -0
- package/src/interfaces/toast.ts +12 -0
- package/src/interfaces/ui-config.ts +189 -0
- package/src/interfaces/ui-context.ts +43 -0
- package/src/layout.ts +29 -0
- package/src/layouts/app-layout.tsx +103 -0
- package/src/layouts/article-layout.tsx +16 -0
- package/src/layouts/aside-layout.tsx +118 -0
- package/src/layouts/auth-layout.tsx +41 -0
- package/src/layouts/content-layout.tsx +11 -0
- package/src/layouts/float-layout.tsx +11 -0
- package/src/layouts/grid-layout.tsx +11 -0
- package/src/layouts/head-layout.tsx +61 -0
- package/src/layouts/header.tsx +74 -0
- package/src/layouts/layout-constants.ts +5 -0
- package/src/layouts/mega-menu.tsx +203 -0
- package/src/layouts/navigation.ts +45 -0
- package/src/layouts/rail-flyout.tsx +77 -0
- package/src/layouts/rail-tooltip.tsx +77 -0
- package/src/layouts/sidebar.tsx +296 -0
- package/src/markdown.ts +12 -0
- package/src/providers/provider-effects.ts +30 -0
- package/src/providers/register-config.ts +30 -0
- package/src/providers/shared-web-ui-provider.tsx +98 -0
- package/src/providers/theme-provider.tsx +15 -0
- package/src/providers/translation-provider.tsx +28 -0
- package/src/query/page-link.tsx +84 -0
- package/src/query/page-path.ts +26 -0
- package/src/query/query-param.ts +263 -0
- package/src/query/use-query-param.ts +23 -0
- package/src/skeleton/skeleton-article.tsx +11 -0
- package/src/skeleton/skeleton-auth-form.tsx +20 -0
- package/src/skeleton/skeleton-cards.tsx +35 -0
- package/src/skeleton/skeleton-chat.tsx +34 -0
- package/src/skeleton/skeleton-dashboard.tsx +34 -0
- package/src/skeleton/skeleton-float.tsx +10 -0
- package/src/skeleton/skeleton-form.tsx +45 -0
- package/src/skeleton/skeleton-menu.tsx +30 -0
- package/src/skeleton/skeleton-page.tsx +18 -0
- package/src/skeleton/skeleton-table.tsx +25 -0
- package/src/state/auth-service.ts +104 -0
- package/src/state/branch-service.ts +217 -0
- package/src/state/document-sync.ts +43 -0
- package/src/state/language-service.ts +80 -0
- package/src/state/menu-service.ts +67 -0
- package/src/state/navigation-service.ts +160 -0
- package/src/state/preference-sync.ts +93 -0
- package/src/state/progress-service.ts +18 -0
- package/src/state/screen-access.ts +70 -0
- package/src/state/sidebar-service.ts +22 -0
- package/src/state/signals.ts +183 -0
- package/src/state/toast-service.ts +45 -0
- package/src/styles.css +15 -0
- package/src/theme/dark-themes.ts +20 -0
- package/src/theme/logo.ts +12 -0
- package/src/theme/theme-service.ts +82 -0
- package/src/types/class-names.ts +53 -0
- package/src/types/field-error.ts +19 -0
- package/src/types/field-props.ts +23 -0
- package/src/types/field-registry.ts +27 -0
- package/src/types/field-wrapper.tsx +42 -0
- package/src/types/lang-field.ts +71 -0
- package/src/types/markdown-color-mode.ts +13 -0
- package/src/types/media-service.ts +61 -0
- package/src/types/media-viewer.tsx +57 -0
- package/src/types/type.button.tsx +108 -0
- package/src/types/type.checkbox.tsx +49 -0
- package/src/types/type.confirm.tsx +50 -0
- package/src/types/type.date.tsx +97 -0
- package/src/types/type.drawer.tsx +86 -0
- package/src/types/type.dropdown.tsx +81 -0
- package/src/types/type.filter.tsx +64 -0
- package/src/types/type.icon.ts +53 -0
- package/src/types/type.image.tsx +115 -0
- package/src/types/type.input.tsx +57 -0
- package/src/types/type.lang-md.tsx +129 -0
- package/src/types/type.lang.tsx +156 -0
- package/src/types/type.list.tsx +97 -0
- package/src/types/type.mdv.tsx +35 -0
- package/src/types/type.mdx.tsx +54 -0
- package/src/types/type.modal.tsx +77 -0
- package/src/types/type.otp.tsx +82 -0
- package/src/types/type.search.tsx +87 -0
- package/src/types/type.select.tsx +87 -0
- package/src/types/type.switch.tsx +52 -0
- package/src/types/type.table.tsx +152 -0
- package/src/types/type.text-area.tsx +51 -0
- package/src/types/type.time.tsx +61 -0
- package/src/types/type.upload.tsx +294 -0
- package/src/types/type.video.tsx +119 -0
- package/src/types/upload-service.ts +229 -0
- package/src/utils/app-config.ts +21 -0
- package/src/utils/app-http.ts +255 -0
- package/src/utils/app-storage.ts +259 -0
- package/src/utils/crypto-util.ts +88 -0
- package/src/utils/event-util.ts +58 -0
- package/src/utils/file-util.ts +186 -0
- package/src/utils/lang-util.ts +60 -0
- package/src/utils/language-util.ts +107 -0
- package/src/utils/leave-guard.ts +26 -0
- package/src/utils/lucide-icon.ts +55 -0
- package/src/utils/menu-util.ts +165 -0
- package/src/utils/option-util.ts +108 -0
- package/src/utils/session-id.ts +48 -0
- package/src/utils/shared-regexp.ts +18 -0
- package/src/utils/storage-keys.ts +80 -0
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
// default-messages.ts
|
|
2
|
+
// English texts the package always knows. They are the LAST fallback,
|
|
3
|
+
// so the shell never shows raw keys even when an app forgets a text.
|
|
4
|
+
//
|
|
5
|
+
// - "ui.*" keys: texts of the shell (header, sidebar, switchers, tables ...)
|
|
6
|
+
// - dff-util ConstKeys (REQUIRED, INVALID_EMAIL, ...): English texts from dff-util ConstMessages
|
|
7
|
+
//
|
|
8
|
+
// Apps translate these keys in their own locale JSON files.
|
|
9
|
+
|
|
10
|
+
import { ConstMessages } from "dff-util";
|
|
11
|
+
import type { LocaleMessages } from "../interfaces/ui-config.ts";
|
|
12
|
+
|
|
13
|
+
export const DEFAULT_UI_MESSAGES: LocaleMessages = {
|
|
14
|
+
ui: {
|
|
15
|
+
language: "Language",
|
|
16
|
+
theme: "Theme",
|
|
17
|
+
lightThemes: "Light themes",
|
|
18
|
+
darkThemes: "Dark themes",
|
|
19
|
+
openMenu: "Open menu",
|
|
20
|
+
home: "Home",
|
|
21
|
+
loading: "Loading...",
|
|
22
|
+
close: "Close",
|
|
23
|
+
noData: "No data found",
|
|
24
|
+
selectOption: "Select an option",
|
|
25
|
+
search: "Search",
|
|
26
|
+
navigation: "Main navigation",
|
|
27
|
+
permissionDenied: "Permission denied",
|
|
28
|
+
permissionDeniedText: "You do not have access to this page. If you believe this is a mistake, contact your administrator.",
|
|
29
|
+
expandMenu: "Expand menu",
|
|
30
|
+
collapseMenu: "Collapse menu",
|
|
31
|
+
account: "Account",
|
|
32
|
+
logout: "Log out",
|
|
33
|
+
confirm: "Confirm",
|
|
34
|
+
cancel: "Cancel",
|
|
35
|
+
translate: "Translate",
|
|
36
|
+
pageNotFound: "Page not found",
|
|
37
|
+
pageNotFoundText: "The page you are looking for does not exist, was removed or was renamed.",
|
|
38
|
+
backToHome: "Back to home",
|
|
39
|
+
goBack: "Go back",
|
|
40
|
+
reloadPage: "Reload page",
|
|
41
|
+
comingSoon: "Coming soon",
|
|
42
|
+
comingSoonText: "We are working on this page. Please check back later.",
|
|
43
|
+
all: "All",
|
|
44
|
+
settings: "Settings",
|
|
45
|
+
sidebar: "Sidebar",
|
|
46
|
+
megaMenu: "Mega menu",
|
|
47
|
+
navigationMode: "Navigation",
|
|
48
|
+
scrollToTop: "Scroll to top",
|
|
49
|
+
branch: "Branch",
|
|
50
|
+
openPreview: "Open preview",
|
|
51
|
+
playVideo: "Play video",
|
|
52
|
+
mediaError: "Could not load the file",
|
|
53
|
+
uploadTitle: "Drag & drop your files here",
|
|
54
|
+
uploadSubtitle: "Supports {{types}} files.",
|
|
55
|
+
uploadLimit: "Max file size: {{max}}",
|
|
56
|
+
uploadLimitTotal: "Max {{max}} per file · up to {{total}} total",
|
|
57
|
+
browseFiles: "Browse files",
|
|
58
|
+
selectedFiles: "Selected files: {{count}}",
|
|
59
|
+
removeFile: "Remove file",
|
|
60
|
+
uploadTypeError: "\"{{name}}\" is not an allowed file type. Please upload {{types}}.",
|
|
61
|
+
uploadSizeError: "\"{{name}}\" ({{size}}) is larger than the allowed {{max}}.",
|
|
62
|
+
uploadTotalError: "Total size {{size}} is larger than the allowed {{max}}.",
|
|
63
|
+
},
|
|
64
|
+
};
|
|
65
|
+
|
|
66
|
+
/** dff-util validation and status messages, for example REQUIRED -> "this filed is required". */
|
|
67
|
+
export const DEFAULT_CONST_MESSAGES: LocaleMessages = ConstMessages;
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
// direction.ts
|
|
2
|
+
// Decides if a language is written right-to-left (rtl) or left-to-right (ltr).
|
|
3
|
+
|
|
4
|
+
import { ConstValue } from "dff-util";
|
|
5
|
+
import type { Direction, LanguageOption } from "../interfaces/ui-config.ts";
|
|
6
|
+
|
|
7
|
+
/** Language codes written from right to left. */
|
|
8
|
+
export const RTL_LANGUAGE_CODES = ["ar", "he", "fa", "ur"];
|
|
9
|
+
|
|
10
|
+
/** Returns the first part of a code: "ar-SA" -> "ar". */
|
|
11
|
+
export function readBaseLanguageCode(languageCode: string): string {
|
|
12
|
+
const codeParts = languageCode.split(ConstValue.HYPHEN);
|
|
13
|
+
const baseCode = codeParts[0] ?? languageCode;
|
|
14
|
+
const lowerCaseCode = baseCode.toLowerCase();
|
|
15
|
+
return lowerCaseCode;
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
/** Finds a language in the config list by its code. */
|
|
19
|
+
export function findLanguageOption(
|
|
20
|
+
languages: LanguageOption[],
|
|
21
|
+
languageCode: string,
|
|
22
|
+
): LanguageOption | undefined {
|
|
23
|
+
for (const language of languages) {
|
|
24
|
+
if (language.code === languageCode) {
|
|
25
|
+
return language;
|
|
26
|
+
}
|
|
27
|
+
}
|
|
28
|
+
return undefined;
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
/** Returns "rtl" or "ltr" for a language code. A direction set in the config always wins. */
|
|
32
|
+
export function resolveDirection(languageCode: string, languages: LanguageOption[]): Direction {
|
|
33
|
+
const language = findLanguageOption(languages, languageCode);
|
|
34
|
+
if (language?.direction) {
|
|
35
|
+
return language.direction;
|
|
36
|
+
}
|
|
37
|
+
const baseCode = readBaseLanguageCode(languageCode);
|
|
38
|
+
const isRtl = RTL_LANGUAGE_CODES.includes(baseCode);
|
|
39
|
+
if (isRtl) {
|
|
40
|
+
return ConstValue.RTL as Direction;
|
|
41
|
+
}
|
|
42
|
+
return ConstValue.LTR as Direction;
|
|
43
|
+
}
|
|
@@ -0,0 +1,187 @@
|
|
|
1
|
+
// locale-service.ts
|
|
2
|
+
// Loads locale JSON files lazily and switches the language.
|
|
3
|
+
//
|
|
4
|
+
// await changeLanguage("ar-SA"); -> loads ar-SA.json, sets <html lang="ar-SA" dir="rtl">, saves to localStorage
|
|
5
|
+
//
|
|
6
|
+
// The loader is the language's own load() or config.loadLocale(code) (locales/{code}.json).
|
|
7
|
+
// The languages are config.languages or the backend list (languagesSignal). Loaded files are cached.
|
|
8
|
+
|
|
9
|
+
import type { LanguageOption, LocaleMessages, LocaleModule, UiConfig } from "../interfaces/ui-config.ts";
|
|
10
|
+
import {
|
|
11
|
+
fallbackTranslationSignal,
|
|
12
|
+
isTranslationReadySignal,
|
|
13
|
+
languagesSignal,
|
|
14
|
+
localeSignal,
|
|
15
|
+
translationSignal,
|
|
16
|
+
uiConfigSignal,
|
|
17
|
+
} from "../state/signals.ts";
|
|
18
|
+
import { AppStorage } from "../utils/app-storage.ts";
|
|
19
|
+
import { LANG } from "../utils/storage-keys.ts";
|
|
20
|
+
import { findLanguageOption } from "./direction.ts";
|
|
21
|
+
|
|
22
|
+
const UI_CONFIG_MISSING = "shared-lib-web: config is missing. Wrap your app in <SharedWebUiProvider config={config}>.";
|
|
23
|
+
|
|
24
|
+
const loadedMessagesCache = new Map<string, LocaleMessages>();
|
|
25
|
+
|
|
26
|
+
/** true when the user picked a language (now or on an earlier visit). Then a backend default does not override it. */
|
|
27
|
+
let isLanguageChosen = false;
|
|
28
|
+
|
|
29
|
+
/** Returns the active config or throws a clear error when SharedWebUiProvider is missing. */
|
|
30
|
+
export function readActiveConfig(): UiConfig {
|
|
31
|
+
const config = uiConfigSignal.value;
|
|
32
|
+
if (!config) {
|
|
33
|
+
throw new Error(UI_CONFIG_MISSING);
|
|
34
|
+
}
|
|
35
|
+
return config;
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
/** Takes the messages out of a JSON module ({ default: {...} }) or returns them as they are. */
|
|
39
|
+
export function unwrapLocaleModule(localeModule: LocaleModule): LocaleMessages {
|
|
40
|
+
const hasDefaultExport = "default" in localeModule && typeof localeModule.default === "object";
|
|
41
|
+
if (hasDefaultExport) {
|
|
42
|
+
const moduleWithDefault = localeModule as { default: LocaleMessages };
|
|
43
|
+
return moduleWithDefault.default;
|
|
44
|
+
}
|
|
45
|
+
return localeModule as LocaleMessages;
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
/** true when the language may be used: it is in the list, or no list is known yet. */
|
|
49
|
+
export function isLanguageAvailable(languageCode: string): boolean {
|
|
50
|
+
const languages = languagesSignal.peek();
|
|
51
|
+
if (languages.length === 0) {
|
|
52
|
+
return true;
|
|
53
|
+
}
|
|
54
|
+
const language = findLanguageOption(languages, languageCode);
|
|
55
|
+
return Boolean(language);
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
/** Loads the locale module of a code: the language's load(), else config.loadLocale(code). undefined = no loader. */
|
|
59
|
+
export function runLocaleLoader(languageCode: string): Promise<LocaleModule> | undefined {
|
|
60
|
+
const languages = languagesSignal.peek();
|
|
61
|
+
const language: LanguageOption | undefined = findLanguageOption(languages, languageCode);
|
|
62
|
+
if (language?.load) {
|
|
63
|
+
return language.load();
|
|
64
|
+
}
|
|
65
|
+
const config = uiConfigSignal.peek();
|
|
66
|
+
const loadLocale = config?.loadLocale;
|
|
67
|
+
if (!loadLocale) {
|
|
68
|
+
return undefined;
|
|
69
|
+
}
|
|
70
|
+
return loadLocale(languageCode);
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
/** Loads (or reads from cache) the messages of one language. undefined when it cannot be loaded. */
|
|
74
|
+
export async function loadLocaleMessages(languageCode: string): Promise<LocaleMessages | undefined> {
|
|
75
|
+
const cachedMessages = loadedMessagesCache.get(languageCode);
|
|
76
|
+
if (cachedMessages) {
|
|
77
|
+
return cachedMessages;
|
|
78
|
+
}
|
|
79
|
+
const loading = runLocaleLoader(languageCode);
|
|
80
|
+
if (!loading) {
|
|
81
|
+
return undefined;
|
|
82
|
+
}
|
|
83
|
+
try {
|
|
84
|
+
const localeModule = await loading;
|
|
85
|
+
const messages = unwrapLocaleModule(localeModule);
|
|
86
|
+
loadedMessagesCache.set(languageCode, messages);
|
|
87
|
+
return messages;
|
|
88
|
+
} catch {
|
|
89
|
+
return undefined;
|
|
90
|
+
}
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
/** Clears the cache (used by tests). */
|
|
94
|
+
export function clearLocaleCache(): void {
|
|
95
|
+
loadedMessagesCache.clear();
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
/** true when the user picked a language (it is not changed to the backend default then). */
|
|
99
|
+
export function readIsLanguageChosen(): boolean {
|
|
100
|
+
return isLanguageChosen;
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
/** Language used when the app sets none (config.defaultLanguage missing). */
|
|
104
|
+
export const DEFAULT_LANGUAGE = "en-US";
|
|
105
|
+
|
|
106
|
+
/** config.defaultLanguage, or "en-US" when it is not set. */
|
|
107
|
+
export function readDefaultLanguage(config: UiConfig | null | undefined): string {
|
|
108
|
+
return config?.defaultLanguage || DEFAULT_LANGUAGE;
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
/** Picks the language to start with: the saved one if it may be used, else the default. */
|
|
112
|
+
export function readInitialLanguageCode(config: UiConfig): string {
|
|
113
|
+
const storedCode = AppStorage.getText(LANG);
|
|
114
|
+
if (storedCode) {
|
|
115
|
+
const isStoredAvailable = isLanguageAvailable(storedCode);
|
|
116
|
+
if (isStoredAvailable) {
|
|
117
|
+
return storedCode;
|
|
118
|
+
}
|
|
119
|
+
}
|
|
120
|
+
const defaultLanguage = readDefaultLanguage(config);
|
|
121
|
+
const isDefaultAvailable = isLanguageAvailable(defaultLanguage);
|
|
122
|
+
if (isDefaultAvailable) {
|
|
123
|
+
return defaultLanguage;
|
|
124
|
+
}
|
|
125
|
+
const languages = languagesSignal.peek();
|
|
126
|
+
const firstLanguage = languages[0];
|
|
127
|
+
return firstLanguage ? firstLanguage.code : defaultLanguage;
|
|
128
|
+
}
|
|
129
|
+
|
|
130
|
+
/** Loads the fallback language messages into fallbackTranslationSignal. */
|
|
131
|
+
export async function loadFallbackMessages(config: UiConfig): Promise<void> {
|
|
132
|
+
const fallbackCode = config.fallbackLanguage ?? readDefaultLanguage(config);
|
|
133
|
+
const fallbackMessages = await loadLocaleMessages(fallbackCode);
|
|
134
|
+
if (fallbackMessages) {
|
|
135
|
+
fallbackTranslationSignal.value = fallbackMessages;
|
|
136
|
+
}
|
|
137
|
+
}
|
|
138
|
+
|
|
139
|
+
/**
|
|
140
|
+
* Loads a language and makes it current. Returns false when it is not available or cannot be loaded.
|
|
141
|
+
* shouldSave = true when the user picked it (saved to localStorage).
|
|
142
|
+
*/
|
|
143
|
+
export async function applyLanguage(languageCode: string, shouldSave: boolean): Promise<boolean> {
|
|
144
|
+
const isAvailable = isLanguageAvailable(languageCode);
|
|
145
|
+
if (!isAvailable) {
|
|
146
|
+
return false;
|
|
147
|
+
}
|
|
148
|
+
const messages = await loadLocaleMessages(languageCode);
|
|
149
|
+
if (!messages) {
|
|
150
|
+
return false;
|
|
151
|
+
}
|
|
152
|
+
translationSignal.value = messages;
|
|
153
|
+
localeSignal.value = languageCode;
|
|
154
|
+
isTranslationReadySignal.value = true;
|
|
155
|
+
if (shouldSave) {
|
|
156
|
+
isLanguageChosen = true;
|
|
157
|
+
AppStorage.setData(LANG, languageCode);
|
|
158
|
+
}
|
|
159
|
+
return true;
|
|
160
|
+
}
|
|
161
|
+
|
|
162
|
+
/**
|
|
163
|
+
* Switches the app language (language switcher, settings).
|
|
164
|
+
* Unknown codes are ignored. The choice is saved to localStorage.
|
|
165
|
+
*/
|
|
166
|
+
export async function changeLanguage(languageCode: string): Promise<void> {
|
|
167
|
+
readActiveConfig();
|
|
168
|
+
await applyLanguage(languageCode, true);
|
|
169
|
+
}
|
|
170
|
+
|
|
171
|
+
/** Loads the saved (or default) language and the fallback language. Called once by TranslationProvider. */
|
|
172
|
+
export async function initializeLanguage(): Promise<void> {
|
|
173
|
+
const config = readActiveConfig();
|
|
174
|
+
const storedCode = AppStorage.getText(LANG);
|
|
175
|
+
isLanguageChosen = Boolean(storedCode);
|
|
176
|
+
await loadFallbackMessages(config);
|
|
177
|
+
const languageCode = readInitialLanguageCode(config);
|
|
178
|
+
const isApplied = await applyLanguage(languageCode, false);
|
|
179
|
+
if (isApplied) {
|
|
180
|
+
return;
|
|
181
|
+
}
|
|
182
|
+
const defaultLanguage = readDefaultLanguage(config);
|
|
183
|
+
const isDefaultApplied = await applyLanguage(defaultLanguage, false);
|
|
184
|
+
if (!isDefaultApplied) {
|
|
185
|
+
isTranslationReadySignal.value = true;
|
|
186
|
+
}
|
|
187
|
+
}
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
// translator.ts
|
|
2
|
+
// A small translation engine (no react-i18next).
|
|
3
|
+
//
|
|
4
|
+
// t("nav.users") -> looks up { "nav": { "users": "..." } }
|
|
5
|
+
// t("greeting", { name: "Asha" }) -> "Hello {{name}}" becomes "Hello Asha"
|
|
6
|
+
//
|
|
7
|
+
// Search order: current language -> fallback language -> package defaults -> the key itself.
|
|
8
|
+
|
|
9
|
+
import { ConstValue } from "dff-util";
|
|
10
|
+
import type { TranslateParams } from "../interfaces/ui-context.ts";
|
|
11
|
+
import type { LocaleMessages } from "../interfaces/ui-config.ts";
|
|
12
|
+
import { fallbackTranslationSignal, translationSignal } from "../state/signals.ts";
|
|
13
|
+
import { DEFAULT_CONST_MESSAGES, DEFAULT_UI_MESSAGES } from "./default-messages.ts";
|
|
14
|
+
|
|
15
|
+
const PLACEHOLDER_PATTERN = /\{\{\s*(\w+)\s*\}\}/g;
|
|
16
|
+
|
|
17
|
+
/** Finds a text in a messages object by a dotted key. Returns undefined when not found. */
|
|
18
|
+
export function lookupMessage(messages: LocaleMessages, key: string): string | undefined {
|
|
19
|
+
const directValue = messages[key];
|
|
20
|
+
if (typeof directValue === "string") {
|
|
21
|
+
return directValue;
|
|
22
|
+
}
|
|
23
|
+
const keyParts = key.split(ConstValue.PERIOD);
|
|
24
|
+
let currentValue: string | LocaleMessages | undefined = messages;
|
|
25
|
+
for (const keyPart of keyParts) {
|
|
26
|
+
const isGroup = typeof currentValue === "object" && currentValue !== null;
|
|
27
|
+
if (!isGroup) {
|
|
28
|
+
return undefined;
|
|
29
|
+
}
|
|
30
|
+
const group = currentValue as LocaleMessages;
|
|
31
|
+
currentValue = group[keyPart];
|
|
32
|
+
}
|
|
33
|
+
if (typeof currentValue === "string") {
|
|
34
|
+
return currentValue;
|
|
35
|
+
}
|
|
36
|
+
return undefined;
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
/** Replaces {{name}} placeholders with values from params. Unknown placeholders stay as they are. */
|
|
40
|
+
export function interpolate(text: string, params: TranslateParams | undefined): string {
|
|
41
|
+
if (!params) {
|
|
42
|
+
return text;
|
|
43
|
+
}
|
|
44
|
+
let result = text;
|
|
45
|
+
const matches = text.matchAll(PLACEHOLDER_PATTERN);
|
|
46
|
+
for (const match of matches) {
|
|
47
|
+
const placeholder = match[0];
|
|
48
|
+
const paramName = match[1] ?? ConstValue.EMPTY;
|
|
49
|
+
const paramValue = params[paramName];
|
|
50
|
+
if (paramValue === undefined) {
|
|
51
|
+
continue;
|
|
52
|
+
}
|
|
53
|
+
const replacement = String(paramValue);
|
|
54
|
+
result = result.replace(placeholder, replacement);
|
|
55
|
+
}
|
|
56
|
+
return result;
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
/** Finds the text for a key in all sources, in order. */
|
|
60
|
+
export function findMessage(key: string): string | undefined {
|
|
61
|
+
const currentMessages = translationSignal.value;
|
|
62
|
+
const currentText = lookupMessage(currentMessages, key);
|
|
63
|
+
if (currentText !== undefined) {
|
|
64
|
+
return currentText;
|
|
65
|
+
}
|
|
66
|
+
const fallbackMessages = fallbackTranslationSignal.value;
|
|
67
|
+
const fallbackText = lookupMessage(fallbackMessages, key);
|
|
68
|
+
if (fallbackText !== undefined) {
|
|
69
|
+
return fallbackText;
|
|
70
|
+
}
|
|
71
|
+
const uiText = lookupMessage(DEFAULT_UI_MESSAGES, key);
|
|
72
|
+
if (uiText !== undefined) {
|
|
73
|
+
return uiText;
|
|
74
|
+
}
|
|
75
|
+
const constText = lookupMessage(DEFAULT_CONST_MESSAGES, key);
|
|
76
|
+
return constText;
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
/**
|
|
80
|
+
* Translates a key into the current language.
|
|
81
|
+
* Returns the key itself when no text exists, so plain text can also be passed.
|
|
82
|
+
*/
|
|
83
|
+
export function translate(key: string, params?: TranslateParams): string {
|
|
84
|
+
const message = findMessage(key);
|
|
85
|
+
const text = message ?? key;
|
|
86
|
+
const finalText = interpolate(text, params);
|
|
87
|
+
return finalText;
|
|
88
|
+
}
|