shared-lib-web 0.0.0-stage → 0.0.3
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 +884 -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 +27 -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 +20 -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 +12 -0
- package/dist/components/language-switcher.d.ts.map +1 -0
- package/dist/components/language-switcher.js +61 -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 +21 -0
- package/dist/components/settings-menu.d.ts.map +1 -0
- package/dist/components/settings-menu.js +115 -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 +40 -0
- package/dist/context/use-ui.js.map +1 -0
- package/dist/i18n/browser-language.d.ts +9 -0
- package/dist/i18n/browser-language.d.ts.map +1 -0
- package/dist/i18n/browser-language.js +89 -0
- package/dist/i18n/browser-language.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 +67 -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-groups.d.ts +18 -0
- package/dist/i18n/locale-groups.d.ts.map +1 -0
- package/dist/i18n/locale-groups.js +74 -0
- package/dist/i18n/locale-groups.js.map +1 -0
- package/dist/i18n/locale-service.d.ts +54 -0
- package/dist/i18n/locale-service.d.ts.map +1 -0
- package/dist/i18n/locale-service.js +231 -0
- package/dist/i18n/locale-service.js.map +1 -0
- package/dist/i18n/locale-signal.d.ts +18 -0
- package/dist/i18n/locale-signal.d.ts.map +1 -0
- package/dist/i18n/locale-signal.js +142 -0
- package/dist/i18n/locale-signal.js.map +1 -0
- package/dist/i18n/translator.d.ts +21 -0
- package/dist/i18n/translator.d.ts.map +1 -0
- package/dist/i18n/translator.js +105 -0
- package/dist/i18n/translator.js.map +1 -0
- package/dist/index.d.ts +117 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +130 -0
- package/dist/index.js.map +1 -0
- package/dist/interfaces/app-types.d.ts +143 -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 +319 -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 +29 -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 +30 -0
- package/dist/providers/register-config.js.map +1 -0
- package/dist/providers/shared-web-ui-provider.d.ts +19 -0
- package/dist/providers/shared-web-ui-provider.d.ts.map +1 -0
- package/dist/providers/shared-web-ui-provider.js +53 -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 +66 -0
- package/dist/query/query-param.d.ts.map +1 -0
- package/dist/query/query-param.js +218 -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/api-loader.d.ts +19 -0
- package/dist/state/api-loader.d.ts.map +1 -0
- package/dist/state/api-loader.js +187 -0
- package/dist/state/api-loader.js.map +1 -0
- package/dist/state/auth-service.d.ts +32 -0
- package/dist/state/auth-service.d.ts.map +1 -0
- package/dist/state/auth-service.js +136 -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/company-service.d.ts +16 -0
- package/dist/state/company-service.d.ts.map +1 -0
- package/dist/state/company-service.js +97 -0
- package/dist/state/company-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 +19 -0
- package/dist/state/language-service.d.ts.map +1 -0
- package/dist/state/language-service.js +78 -0
- package/dist/state/language-service.js.map +1 -0
- package/dist/state/layout-choice-service.d.ts +10 -0
- package/dist/state/layout-choice-service.d.ts.map +1 -0
- package/dist/state/layout-choice-service.js +34 -0
- package/dist/state/layout-choice-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 +93 -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 +92 -0
- package/dist/state/signals.d.ts.map +1 -0
- package/dist/state/signals.js +161 -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/custom-themes.d.ts +28 -0
- package/dist/theme/custom-themes.d.ts.map +1 -0
- package/dist/theme/custom-themes.js +218 -0
- package/dist/theme/custom-themes.js.map +1 -0
- package/dist/theme/dark-themes.d.ts +10 -0
- package/dist/theme/dark-themes.d.ts.map +1 -0
- package/dist/theme/dark-themes.js +92 -0
- package/dist/theme/dark-themes.js.map +1 -0
- package/dist/theme/logo.d.ts +7 -0
- package/dist/theme/logo.d.ts.map +1 -0
- package/dist/theme/logo.js +24 -0
- package/dist/theme/logo.js.map +1 -0
- package/dist/theme/theme-service.d.ts +32 -0
- package/dist/theme/theme-service.d.ts.map +1 -0
- package/dist/theme/theme-service.js +123 -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 +77 -0
- package/dist/utils/app-http.d.ts.map +1 -0
- package/dist/utils/app-http.js +331 -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/content-util.d.ts +6 -0
- package/dist/utils/content-util.d.ts.map +1 -0
- package/dist/utils/content-util.js +45 -0
- package/dist/utils/content-util.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/error-util.d.ts +3 -0
- package/dist/utils/error-util.d.ts.map +1 -0
- package/dist/utils/error-util.js +58 -0
- package/dist/utils/error-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/signal-source.d.ts +4 -0
- package/dist/utils/signal-source.d.ts.map +1 -0
- package/dist/utils/signal-source.js +13 -0
- package/dist/utils/signal-source.js.map +1 -0
- package/dist/utils/storage-keys.d.ts +73 -0
- package/dist/utils/storage-keys.d.ts.map +1 -0
- package/dist/utils/storage-keys.js +80 -0
- package/dist/utils/storage-keys.js.map +1 -0
- package/package.json +101 -4
- package/src/components/app-brand.tsx +41 -0
- package/src/components/branch-switcher.tsx +74 -0
- package/src/components/coming-soon.tsx +36 -0
- package/src/components/empty-state.tsx +42 -0
- package/src/components/language-switcher.tsx +96 -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 +250 -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 +43 -0
- package/src/i18n/browser-language.ts +98 -0
- package/src/i18n/default-messages.ts +70 -0
- package/src/i18n/direction.ts +43 -0
- package/src/i18n/locale-groups.ts +87 -0
- package/src/i18n/locale-service.ts +259 -0
- package/src/i18n/locale-signal.ts +173 -0
- package/src/i18n/translator.ts +114 -0
- package/src/index.ts +409 -0
- package/src/interfaces/app-types.ts +160 -0
- package/src/interfaces/toast.ts +12 -0
- package/src/interfaces/ui-config.ts +342 -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 +33 -0
- package/src/providers/register-config.ts +32 -0
- package/src/providers/shared-web-ui-provider.tsx +81 -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 +267 -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/api-loader.ts +205 -0
- package/src/state/auth-service.ts +159 -0
- package/src/state/branch-service.ts +217 -0
- package/src/state/company-service.ts +107 -0
- package/src/state/document-sync.ts +43 -0
- package/src/state/language-service.ts +85 -0
- package/src/state/layout-choice-service.ts +40 -0
- package/src/state/menu-service.ts +67 -0
- package/src/state/navigation-service.ts +160 -0
- package/src/state/preference-sync.ts +101 -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 +215 -0
- package/src/state/toast-service.ts +45 -0
- package/src/styles.css +15 -0
- package/src/theme/custom-themes.ts +236 -0
- package/src/theme/dark-themes.ts +97 -0
- package/src/theme/logo.ts +27 -0
- package/src/theme/org-themes.json +70 -0
- package/src/theme/theme-service.ts +142 -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 +369 -0
- package/src/utils/app-storage.ts +259 -0
- package/src/utils/content-util.ts +49 -0
- package/src/utils/crypto-util.ts +88 -0
- package/src/utils/error-util.ts +64 -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/signal-source.ts +15 -0
- package/src/utils/storage-keys.ts +86 -0
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
// browser-language.ts
|
|
2
|
+
// The languages the user's browser / operating system asks for, and the best match in a language list.
|
|
3
|
+
//
|
|
4
|
+
// navigator.languages = ["fr-CA", "fr", "en-US"] + list en-US, fr-FR, ar-SA -> "fr-FR"
|
|
5
|
+
//
|
|
6
|
+
// Order of the browser codes: navigator.languages, navigator.language, then the Intl locale (system setting).
|
|
7
|
+
// A code matches exactly (case does not matter), else by its base language ("fr-CA" or "fr" -> "fr-FR").
|
|
8
|
+
|
|
9
|
+
import type { LanguageOption } from "../interfaces/ui-config.ts";
|
|
10
|
+
|
|
11
|
+
const CODE_SEPARATOR = "-";
|
|
12
|
+
|
|
13
|
+
/** Adds a code once (codes like "fr_CA" become "fr-CA"). */
|
|
14
|
+
function addCode(codes: string[], code: string | undefined): void {
|
|
15
|
+
if (!code) {
|
|
16
|
+
return;
|
|
17
|
+
}
|
|
18
|
+
const normalizedCode = code.replace("_", CODE_SEPARATOR);
|
|
19
|
+
const isAdded = codes.includes(normalizedCode);
|
|
20
|
+
if (!isAdded) {
|
|
21
|
+
codes.push(normalizedCode);
|
|
22
|
+
}
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
/** The system locale from Intl ("" when it is not available). */
|
|
26
|
+
function readIntlLocale(): string {
|
|
27
|
+
if (typeof Intl === "undefined") {
|
|
28
|
+
return "";
|
|
29
|
+
}
|
|
30
|
+
const dateFormat = new Intl.DateTimeFormat();
|
|
31
|
+
const options = dateFormat.resolvedOptions();
|
|
32
|
+
return options.locale;
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
/** The language codes the browser / system prefers, best first. [] when there is no browser. */
|
|
36
|
+
export function readBrowserLanguageCodes(): string[] {
|
|
37
|
+
const codes: string[] = [];
|
|
38
|
+
if (typeof navigator === "undefined") {
|
|
39
|
+
return codes;
|
|
40
|
+
}
|
|
41
|
+
const preferredCodes = navigator.languages ?? [];
|
|
42
|
+
for (const code of preferredCodes) {
|
|
43
|
+
addCode(codes, code);
|
|
44
|
+
}
|
|
45
|
+
addCode(codes, navigator.language);
|
|
46
|
+
const intlLocale = readIntlLocale();
|
|
47
|
+
addCode(codes, intlLocale);
|
|
48
|
+
return codes;
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
/** The base language of a code: "fr-CA" -> "fr". */
|
|
52
|
+
function toBaseLanguage(code: string): string {
|
|
53
|
+
const parts = code.split(CODE_SEPARATOR);
|
|
54
|
+
const baseLanguage = parts[0] ?? "";
|
|
55
|
+
return baseLanguage.toLowerCase();
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
/** The list code that equals the code (any case). */
|
|
59
|
+
function findExactCode(code: string, languages: LanguageOption[]): string | undefined {
|
|
60
|
+
const lowerCode = code.toLowerCase();
|
|
61
|
+
for (const language of languages) {
|
|
62
|
+
const lowerListCode = language.code.toLowerCase();
|
|
63
|
+
if (lowerListCode === lowerCode) {
|
|
64
|
+
return language.code;
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
return undefined;
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
/** The first list code with the same base language ("fr" -> "fr-FR"). */
|
|
71
|
+
function findBaseLanguageCode(code: string, languages: LanguageOption[]): string | undefined {
|
|
72
|
+
const baseLanguage = toBaseLanguage(code);
|
|
73
|
+
for (const language of languages) {
|
|
74
|
+
const listBaseLanguage = toBaseLanguage(language.code);
|
|
75
|
+
if (listBaseLanguage === baseLanguage) {
|
|
76
|
+
return language.code;
|
|
77
|
+
}
|
|
78
|
+
}
|
|
79
|
+
return undefined;
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
/**
|
|
83
|
+
* The best list code for the browser codes: for each browser code (best first) an exact match, else the same base
|
|
84
|
+
* language. undefined when nothing matches.
|
|
85
|
+
*/
|
|
86
|
+
export function matchLanguageCode(browserCodes: string[], languages: LanguageOption[]): string | undefined {
|
|
87
|
+
for (const browserCode of browserCodes) {
|
|
88
|
+
const exactCode = findExactCode(browserCode, languages);
|
|
89
|
+
if (exactCode) {
|
|
90
|
+
return exactCode;
|
|
91
|
+
}
|
|
92
|
+
const baseLanguageCode = findBaseLanguageCode(browserCode, languages);
|
|
93
|
+
if (baseLanguageCode) {
|
|
94
|
+
return baseLanguageCode;
|
|
95
|
+
}
|
|
96
|
+
}
|
|
97
|
+
return undefined;
|
|
98
|
+
}
|
|
@@ -0,0 +1,70 @@
|
|
|
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
|
+
layout: "Layout",
|
|
49
|
+
appLayout: "App layout",
|
|
50
|
+
asideLayout: "Aside layout",
|
|
51
|
+
scrollToTop: "Scroll to top",
|
|
52
|
+
branch: "Branch",
|
|
53
|
+
openPreview: "Open preview",
|
|
54
|
+
playVideo: "Play video",
|
|
55
|
+
mediaError: "Could not load the file",
|
|
56
|
+
uploadTitle: "Drag & drop your files here",
|
|
57
|
+
uploadSubtitle: "Supports {{types}} files.",
|
|
58
|
+
uploadLimit: "Max file size: {{max}}",
|
|
59
|
+
uploadLimitTotal: "Max {{max}} per file · up to {{total}} total",
|
|
60
|
+
browseFiles: "Browse files",
|
|
61
|
+
selectedFiles: "Selected files: {{count}}",
|
|
62
|
+
removeFile: "Remove file",
|
|
63
|
+
uploadTypeError: "\"{{name}}\" is not an allowed file type. Please upload {{types}}.",
|
|
64
|
+
uploadSizeError: "\"{{name}}\" ({{size}}) is larger than the allowed {{max}}.",
|
|
65
|
+
uploadTotalError: "Total size {{size}} is larger than the allowed {{max}}.",
|
|
66
|
+
},
|
|
67
|
+
};
|
|
68
|
+
|
|
69
|
+
/** dff-util validation and status messages, for example REQUIRED -> "this filed is required". */
|
|
70
|
+
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,87 @@
|
|
|
1
|
+
// locale-groups.ts
|
|
2
|
+
// Locale files split by group: one folder per language, one file per group (the file name is the group).
|
|
3
|
+
//
|
|
4
|
+
// locales/en-US/app.json { "name": "My App" } -> t("app.name")
|
|
5
|
+
// locales/en-US/nav.json { "users": "Users" } -> t("nav.users")
|
|
6
|
+
// locales/en-US/root.json { "REQUIRED": "This field is required" } -> t("REQUIRED") (top-level keys)
|
|
7
|
+
//
|
|
8
|
+
// // config.ts (Vite: import.meta.glob is lazy, only the files of the language in use are downloaded)
|
|
9
|
+
// const localeFiles = import.meta.glob("./locales/*/*.json");
|
|
10
|
+
// loadLocale: loadLocaleGroups.bind(null, localeFiles)
|
|
11
|
+
//
|
|
12
|
+
// Several folders can be merged ({ ...sharedFiles, ...ownFiles }): the same group in two folders is merged,
|
|
13
|
+
// the later file wins per key. Each file is flat, so the "group.key" rule (one sublevel) holds by itself.
|
|
14
|
+
|
|
15
|
+
import type { LocaleMessages, LocaleModule } from "../interfaces/ui-config.ts";
|
|
16
|
+
import { unwrapLocaleModule } from "./locale-service.ts";
|
|
17
|
+
|
|
18
|
+
/** One lazy file loader, as import.meta.glob returns them. */
|
|
19
|
+
export type LocaleFileLoader = () => Promise<unknown>;
|
|
20
|
+
|
|
21
|
+
/** path -> loader, for example the result of import.meta.glob("./locales/*\/*.json"). */
|
|
22
|
+
export type LocaleGroupFiles = Record<string, LocaleFileLoader>;
|
|
23
|
+
|
|
24
|
+
/** The file whose keys stay at the top level (dff-util messages like REQUIRED, or "greeting"). */
|
|
25
|
+
export const ROOT_LOCALE_GROUP = "root";
|
|
26
|
+
|
|
27
|
+
const JSON_EXTENSION = ".json";
|
|
28
|
+
|
|
29
|
+
/** Language code and group of a file path: "./locales/en-US/nav.json" -> { languageCode: "en-US", group: "nav" }. */
|
|
30
|
+
export function readLocaleFilePath(path: string): { languageCode: string; group: string } | undefined {
|
|
31
|
+
const parts = path.split("/");
|
|
32
|
+
const fileName = parts[parts.length - 1] ?? "";
|
|
33
|
+
const languageCode = parts[parts.length - 2] ?? "";
|
|
34
|
+
const isJsonFile = fileName.endsWith(JSON_EXTENSION);
|
|
35
|
+
if (!isJsonFile || languageCode.length === 0) {
|
|
36
|
+
return undefined;
|
|
37
|
+
}
|
|
38
|
+
const groupLength = fileName.length - JSON_EXTENSION.length;
|
|
39
|
+
const group = fileName.slice(0, groupLength);
|
|
40
|
+
return { languageCode: languageCode, group: group };
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
/** Loads one group file and takes the messages out of the JSON module. */
|
|
44
|
+
async function loadGroupFile(loadFile: LocaleFileLoader): Promise<LocaleMessages> {
|
|
45
|
+
const fileModule = await loadFile();
|
|
46
|
+
return unwrapLocaleModule(fileModule as LocaleModule);
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
/** Adds one group file to the messages (the root file goes to the top level). */
|
|
50
|
+
function addGroupMessages(messages: LocaleMessages, group: string, groupMessages: LocaleMessages): void {
|
|
51
|
+
if (group === ROOT_LOCALE_GROUP) {
|
|
52
|
+
Object.assign(messages, groupMessages);
|
|
53
|
+
return;
|
|
54
|
+
}
|
|
55
|
+
const existingGroup = messages[group];
|
|
56
|
+
const isExistingGroup = typeof existingGroup === "object" && existingGroup !== null;
|
|
57
|
+
messages[group] = isExistingGroup ? { ...existingGroup, ...groupMessages } : groupMessages;
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
/**
|
|
61
|
+
* Loads all group files of one language (in parallel) and returns one messages object, ready for loadLocale.
|
|
62
|
+
* Throws when the language has no files, so the next language is tried (browser language -> en-US).
|
|
63
|
+
*/
|
|
64
|
+
export async function loadLocaleGroups(files: LocaleGroupFiles, languageCode: string): Promise<LocaleMessages> {
|
|
65
|
+
const groups: string[] = [];
|
|
66
|
+
const loadings: Array<Promise<LocaleMessages>> = [];
|
|
67
|
+
const entries = Object.entries(files);
|
|
68
|
+
for (const [path, loadFile] of entries) {
|
|
69
|
+
const fileInfo = readLocaleFilePath(path);
|
|
70
|
+
if (fileInfo?.languageCode !== languageCode) {
|
|
71
|
+
continue;
|
|
72
|
+
}
|
|
73
|
+
groups.push(fileInfo.group);
|
|
74
|
+
const loading = loadGroupFile(loadFile);
|
|
75
|
+
loadings.push(loading);
|
|
76
|
+
}
|
|
77
|
+
if (groups.length === 0) {
|
|
78
|
+
throw new Error(`shared-lib-web: no locale files for ${languageCode}`);
|
|
79
|
+
}
|
|
80
|
+
const groupContents = await Promise.all(loadings);
|
|
81
|
+
const messages: LocaleMessages = {};
|
|
82
|
+
for (const [index, group] of groups.entries()) {
|
|
83
|
+
const groupMessages = groupContents[index] ?? {};
|
|
84
|
+
addGroupMessages(messages, group, groupMessages);
|
|
85
|
+
}
|
|
86
|
+
return messages;
|
|
87
|
+
}
|
|
@@ -0,0 +1,259 @@
|
|
|
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
|
+
// First visit (nothing saved): config.defaultLanguage, else the browser / system language (navigator.languages,
|
|
10
|
+
// matched to the list: "fr-CA" -> "fr-FR"), else "en-US".
|
|
11
|
+
|
|
12
|
+
import type { LanguageOption, LocaleMessages, LocaleModule, UiConfig } from "../interfaces/ui-config.ts";
|
|
13
|
+
import {
|
|
14
|
+
fallbackTranslationSignal,
|
|
15
|
+
isTranslationReadySignal,
|
|
16
|
+
languagesSignal,
|
|
17
|
+
localeSignal,
|
|
18
|
+
translationSignal,
|
|
19
|
+
uiConfigSignal,
|
|
20
|
+
} from "../state/signals.ts";
|
|
21
|
+
import { AppStorage } from "../utils/app-storage.ts";
|
|
22
|
+
import { LANG } from "../utils/storage-keys.ts";
|
|
23
|
+
import { matchLanguageCode, readBrowserLanguageCodes } from "./browser-language.ts";
|
|
24
|
+
import { isSignalSource } from "../utils/signal-source.ts";
|
|
25
|
+
import { findLanguageOption } from "./direction.ts";
|
|
26
|
+
import { waitForSignalLocale } from "./locale-signal.ts";
|
|
27
|
+
import { findDeepLocaleKeys } from "./translator.ts";
|
|
28
|
+
|
|
29
|
+
const UI_CONFIG_MISSING = "shared-lib-web: config is missing. Wrap your app in <SharedWebUiProvider config={config}>.";
|
|
30
|
+
|
|
31
|
+
const loadedMessagesCache = new Map<string, LocaleMessages>();
|
|
32
|
+
|
|
33
|
+
/** true when the user picked a language (now or on an earlier visit). Then a backend default does not override it. */
|
|
34
|
+
let isLanguageChosen = false;
|
|
35
|
+
|
|
36
|
+
/** Returns the active config or throws a clear error when SharedWebUiProvider is missing. */
|
|
37
|
+
export function readActiveConfig(): UiConfig {
|
|
38
|
+
const config = uiConfigSignal.value;
|
|
39
|
+
if (!config) {
|
|
40
|
+
throw new Error(UI_CONFIG_MISSING);
|
|
41
|
+
}
|
|
42
|
+
return config;
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
/** Takes the messages out of a JSON module ({ default: {...} }) or returns them as they are. */
|
|
46
|
+
export function unwrapLocaleModule(localeModule: LocaleModule): LocaleMessages {
|
|
47
|
+
const hasDefaultExport = "default" in localeModule && typeof localeModule.default === "object";
|
|
48
|
+
if (hasDefaultExport) {
|
|
49
|
+
const moduleWithDefault = localeModule as { default: LocaleMessages };
|
|
50
|
+
return moduleWithDefault.default;
|
|
51
|
+
}
|
|
52
|
+
return localeModule as LocaleMessages;
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
/** true when the language may be used: it is in the list, or no list is known yet. */
|
|
56
|
+
export function isLanguageAvailable(languageCode: string): boolean {
|
|
57
|
+
const languages = languagesSignal.peek();
|
|
58
|
+
if (languages.length === 0) {
|
|
59
|
+
return true;
|
|
60
|
+
}
|
|
61
|
+
const language = findLanguageOption(languages, languageCode);
|
|
62
|
+
return Boolean(language);
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
/** Loads the locale module of a code: the language's load(), else config.loadLocale(code). undefined = no loader. */
|
|
66
|
+
export function runLocaleLoader(languageCode: string): Promise<LocaleModule> | undefined {
|
|
67
|
+
const languages = languagesSignal.peek();
|
|
68
|
+
const language: LanguageOption | undefined = findLanguageOption(languages, languageCode);
|
|
69
|
+
if (language?.load) {
|
|
70
|
+
return language.load();
|
|
71
|
+
}
|
|
72
|
+
const config = uiConfigSignal.peek();
|
|
73
|
+
const loadLocale = config?.loadLocale;
|
|
74
|
+
if (!loadLocale) {
|
|
75
|
+
return undefined;
|
|
76
|
+
}
|
|
77
|
+
if (isSignalSource(loadLocale)) {
|
|
78
|
+
return waitForSignalLocale(loadLocale, languageCode);
|
|
79
|
+
}
|
|
80
|
+
return loadLocale(languageCode);
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
/** Locale files allow one sublevel ("group.key"); deeper groups are never shown, so say so once per file. */
|
|
84
|
+
function warnAboutDeepKeys(languageCode: string, messages: LocaleMessages): void {
|
|
85
|
+
const deepKeys = findDeepLocaleKeys(messages);
|
|
86
|
+
if (deepKeys.length > 0) {
|
|
87
|
+
const keyList = deepKeys.join(", ");
|
|
88
|
+
console.warn(`shared-lib-web: ${languageCode}.json is deeper than "group.key" (one sublevel); not used: ${keyList}`);
|
|
89
|
+
}
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
/** Loads (or reads from cache) the messages of one language. undefined when it cannot be loaded. */
|
|
93
|
+
export async function loadLocaleMessages(languageCode: string): Promise<LocaleMessages | undefined> {
|
|
94
|
+
const cachedMessages = loadedMessagesCache.get(languageCode);
|
|
95
|
+
if (cachedMessages) {
|
|
96
|
+
return cachedMessages;
|
|
97
|
+
}
|
|
98
|
+
const loading = runLocaleLoader(languageCode);
|
|
99
|
+
if (!loading) {
|
|
100
|
+
return undefined;
|
|
101
|
+
}
|
|
102
|
+
try {
|
|
103
|
+
const localeModule = await loading;
|
|
104
|
+
const messages = unwrapLocaleModule(localeModule);
|
|
105
|
+
warnAboutDeepKeys(languageCode, messages);
|
|
106
|
+
loadedMessagesCache.set(languageCode, messages);
|
|
107
|
+
return messages;
|
|
108
|
+
} catch {
|
|
109
|
+
return undefined;
|
|
110
|
+
}
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
/** Clears the cache (used by tests). */
|
|
114
|
+
export function clearLocaleCache(): void {
|
|
115
|
+
loadedMessagesCache.clear();
|
|
116
|
+
}
|
|
117
|
+
|
|
118
|
+
/** true when the user picked a language (it is not changed to the backend default then). */
|
|
119
|
+
export function readIsLanguageChosen(): boolean {
|
|
120
|
+
return isLanguageChosen;
|
|
121
|
+
}
|
|
122
|
+
|
|
123
|
+
/** Language used when nothing else is set (no defaultLanguage, no browser match). */
|
|
124
|
+
export const DEFAULT_LANGUAGE = "en-US";
|
|
125
|
+
|
|
126
|
+
/**
|
|
127
|
+
* The language for keys missing in the current language, and the last default:
|
|
128
|
+
* config.defaultLanguage, else "en-US".
|
|
129
|
+
*/
|
|
130
|
+
export function readFallbackLanguage(config: UiConfig | null | undefined): string {
|
|
131
|
+
return config?.defaultLanguage || DEFAULT_LANGUAGE;
|
|
132
|
+
}
|
|
133
|
+
|
|
134
|
+
/** The browser / system language that is in the language list (undefined without a list or a match). */
|
|
135
|
+
export function readBrowserLanguage(): string | undefined {
|
|
136
|
+
const languages = languagesSignal.peek();
|
|
137
|
+
if (languages.length === 0) {
|
|
138
|
+
return undefined;
|
|
139
|
+
}
|
|
140
|
+
const browserCodes = readBrowserLanguageCodes();
|
|
141
|
+
return matchLanguageCode(browserCodes, languages);
|
|
142
|
+
}
|
|
143
|
+
|
|
144
|
+
/**
|
|
145
|
+
* The default language: config.defaultLanguage, else the browser / system language (when it is in the list),
|
|
146
|
+
* else "en-US".
|
|
147
|
+
*/
|
|
148
|
+
export function readDefaultLanguage(config: UiConfig | null | undefined): string {
|
|
149
|
+
if (config?.defaultLanguage) {
|
|
150
|
+
return config.defaultLanguage;
|
|
151
|
+
}
|
|
152
|
+
const browserLanguage = readBrowserLanguage();
|
|
153
|
+
return browserLanguage ?? readFallbackLanguage(config);
|
|
154
|
+
}
|
|
155
|
+
|
|
156
|
+
/** Adds a code once. */
|
|
157
|
+
function addCandidate(candidates: string[], code: string | undefined): void {
|
|
158
|
+
if (code && !candidates.includes(code)) {
|
|
159
|
+
candidates.push(code);
|
|
160
|
+
}
|
|
161
|
+
}
|
|
162
|
+
|
|
163
|
+
/**
|
|
164
|
+
* The languages to try on start, in order: the saved one, config.defaultLanguage, the browser / system languages
|
|
165
|
+
* (matched to the list; without a list all of them, a missing locale file is skipped), the fallback, the first listed.
|
|
166
|
+
*/
|
|
167
|
+
export function readStartLanguageCandidates(config: UiConfig): string[] {
|
|
168
|
+
const candidates: string[] = [];
|
|
169
|
+
const storedCode = AppStorage.getText(LANG);
|
|
170
|
+
addCandidate(candidates, storedCode);
|
|
171
|
+
addCandidate(candidates, config.defaultLanguage);
|
|
172
|
+
const languages = languagesSignal.peek();
|
|
173
|
+
const browserCodes = readBrowserLanguageCodes();
|
|
174
|
+
if (languages.length > 0) {
|
|
175
|
+
const browserLanguage = matchLanguageCode(browserCodes, languages);
|
|
176
|
+
addCandidate(candidates, browserLanguage);
|
|
177
|
+
} else {
|
|
178
|
+
for (const browserCode of browserCodes) {
|
|
179
|
+
addCandidate(candidates, browserCode);
|
|
180
|
+
}
|
|
181
|
+
}
|
|
182
|
+
const fallbackLanguage = readFallbackLanguage(config);
|
|
183
|
+
addCandidate(candidates, fallbackLanguage);
|
|
184
|
+
const firstLanguage = languages[0];
|
|
185
|
+
addCandidate(candidates, firstLanguage?.code);
|
|
186
|
+
return candidates;
|
|
187
|
+
}
|
|
188
|
+
|
|
189
|
+
/** Picks the language to start with: the first start candidate that may be used. */
|
|
190
|
+
export function readInitialLanguageCode(config: UiConfig): string {
|
|
191
|
+
const candidates = readStartLanguageCandidates(config);
|
|
192
|
+
for (const candidate of candidates) {
|
|
193
|
+
const isAvailable = isLanguageAvailable(candidate);
|
|
194
|
+
if (isAvailable) {
|
|
195
|
+
return candidate;
|
|
196
|
+
}
|
|
197
|
+
}
|
|
198
|
+
return readFallbackLanguage(config);
|
|
199
|
+
}
|
|
200
|
+
|
|
201
|
+
/** Loads the fallback language messages into fallbackTranslationSignal. */
|
|
202
|
+
export async function loadFallbackMessages(config: UiConfig): Promise<void> {
|
|
203
|
+
const fallbackCode = readFallbackLanguage(config);
|
|
204
|
+
const fallbackMessages = await loadLocaleMessages(fallbackCode);
|
|
205
|
+
if (fallbackMessages) {
|
|
206
|
+
fallbackTranslationSignal.value = fallbackMessages;
|
|
207
|
+
}
|
|
208
|
+
}
|
|
209
|
+
|
|
210
|
+
/**
|
|
211
|
+
* Loads a language and makes it current. Returns false when it is not available or cannot be loaded.
|
|
212
|
+
* shouldSave = true when the user picked it (saved to localStorage).
|
|
213
|
+
*/
|
|
214
|
+
export async function applyLanguage(languageCode: string, shouldSave: boolean): Promise<boolean> {
|
|
215
|
+
const isAvailable = isLanguageAvailable(languageCode);
|
|
216
|
+
if (!isAvailable) {
|
|
217
|
+
return false;
|
|
218
|
+
}
|
|
219
|
+
const messages = await loadLocaleMessages(languageCode);
|
|
220
|
+
if (!messages) {
|
|
221
|
+
return false;
|
|
222
|
+
}
|
|
223
|
+
translationSignal.value = messages;
|
|
224
|
+
localeSignal.value = languageCode;
|
|
225
|
+
isTranslationReadySignal.value = true;
|
|
226
|
+
if (shouldSave) {
|
|
227
|
+
isLanguageChosen = true;
|
|
228
|
+
AppStorage.setData(LANG, languageCode);
|
|
229
|
+
}
|
|
230
|
+
return true;
|
|
231
|
+
}
|
|
232
|
+
|
|
233
|
+
/**
|
|
234
|
+
* Switches the app language (language switcher, settings).
|
|
235
|
+
* Unknown codes are ignored. The choice is saved to localStorage.
|
|
236
|
+
*/
|
|
237
|
+
export async function changeLanguage(languageCode: string): Promise<void> {
|
|
238
|
+
readActiveConfig();
|
|
239
|
+
await applyLanguage(languageCode, true);
|
|
240
|
+
}
|
|
241
|
+
|
|
242
|
+
/**
|
|
243
|
+
* Loads the start language and the fallback language. Called once by TranslationProvider.
|
|
244
|
+
* Tries readStartLanguageCandidates in order; a language whose file cannot be loaded is skipped.
|
|
245
|
+
*/
|
|
246
|
+
export async function initializeLanguage(): Promise<void> {
|
|
247
|
+
const config = readActiveConfig();
|
|
248
|
+
const storedCode = AppStorage.getText(LANG);
|
|
249
|
+
isLanguageChosen = Boolean(storedCode);
|
|
250
|
+
await loadFallbackMessages(config);
|
|
251
|
+
const candidates = readStartLanguageCandidates(config);
|
|
252
|
+
for (const candidate of candidates) {
|
|
253
|
+
const isApplied = await applyLanguage(candidate, false);
|
|
254
|
+
if (isApplied) {
|
|
255
|
+
return;
|
|
256
|
+
}
|
|
257
|
+
}
|
|
258
|
+
isTranslationReadySignal.value = true;
|
|
259
|
+
}
|