@mk-kit/ui 0.44.0 → 0.46.0

package/README.md

@@ -2,12 +2,13 @@
 
 **Themable, accessible Angular component library for admin dashboards, back-offices and internal tools.**
 
-175+ standalone components, directives and services — data tables, charts,
+185+ components (225+ selectors with directives and pipes) and 16 services — data tables, charts,
 date & time pickers, editors, kanban, overlays, an app shell — written for
 Angular 22 with signals and `OnPush` from day one. Every visual value is a
 `--mk-*` CSS custom property; light and dark ship out of the box; WCAG 2.1 AA
-is the target, not the marketing. MIT licensed. Zero runtime dependencies
-beyond Angular.
+is the target, not the marketing. MIT licensed. No third-party runtime
+dependencies — only Angular and the sibling `@mk-kit/validators` (the
+identifier checks, 14 kB, tree-shakeable).
 
 - **Docs & live demos:** <https://mk-kit.dev>
 - **API reference:** <https://mk-kit.dev/api> — also as [api.json](https://mk-kit.dev/api.json), [llms.txt](https://mk-kit.dev/llms.txt) and [llms-full.txt](https://mk-kit.dev/llms-full.txt) for tools and AI assistants
@@ -103,10 +104,12 @@ import { MkDatePicker } from '@mk-kit/ui/datetime';
 ```
 
 Available: `core`, `forms`, `datetime`, `table`, `data`, `navigation`,
-`feedback`, `directives`, `dnd`, `media`, `icon`, `button`, `checkbox`, `chip`,
-`context-menu`, `layout`, `chat`, `query-builder`, `dynamic-form`, `rich-text`, `block-editor`,
-plus `testing` (component harnesses for specs — never re-exported from the
-umbrella). `sideEffects: false` throughout.
+`feedback`, `directives`, `dnd`, `media`, `icon`, `icon/extended` (the opt-in
+305-icon set), `button`, `checkbox`, `chip`, `context-menu`, `layout`, `chat`,
+`query-builder`, `dynamic-form`, `rich-text`, `block-editor`, plus `testing`
+(component harnesses for specs) and `locales/pl` (the Polish string pack) —
+the last two are never re-exported from the umbrella. `sideEffects: false`
+throughout.
 
 ## Theming
 
@@ -165,6 +168,15 @@ bootstrapApplication(AppRoot, {
 });
 ```
 
+Complete translations are their own entry points, so an app carries only the
+locales it provides — today Polish:
+
+```ts
+import { provideMkI18nPl } from '@mk-kit/ui/locales/pl';
+
+providers: [provideMkI18nPl({ noData: 'Nic tu nie ma' })]; // overrides merge over the pack
+```
+
 Overrides can be scoped to a component subtree for mixed-locale screens.
 Layout and arrow keys flip under `dir="rtl"`.
 

package/fesm2022/mk-kit-ui-core.mjs

@@ -1724,25 +1724,37 @@ const MK_I18N = new InjectionToken('MK_I18N', {
     factory: () => MK_DEFAULT_I18N,
 });
 /**
- * Provide localised strings (merged over the English defaults) — pass any
- * subset. The nested `dateNames`, `blockEditor` and `validation` groups are
- * merged deeply, so partial overrides of those work too.
+ * Merges `overrides` over a complete string map — shallow for the top level,
+ * deep for the `dateNames`, `blockEditor` and `validation` groups. Exported
+ * so locale packs and tests can build a map without providing it.
+ */
+function mkMergeI18n(base, overrides) {
+    return {
+        ...base,
+        ...overrides,
+        dateNames: { ...base.dateNames, ...overrides.dateNames },
+        blockEditor: { ...base.blockEditor, ...overrides.blockEditor },
+        validation: { ...base.validation, ...overrides.validation },
+    };
+}
+/**
+ * Provide localised strings — pass any subset, merged over `base` (the
+ * English defaults unless given). The nested `dateNames`, `blockEditor` and
+ * `validation` groups are merged deeply, so partial overrides of those work
+ * too.
  *
  * ```ts
  * bootstrapApplication(App, {
  *   providers: [provideMkI18n({ noResults: 'Brak wyników', close: 'Zamknij' })],
  * });
  * ```
+ *
+ * A locale pack is a complete map that serves as the base — either through
+ * its own helper (`provideMkI18nPl(overrides)` from `@mk-kit/ui/locales/pl`)
+ * or explicitly: `provideMkI18n(overrides, MK_PL_I18N)`.
  */
-function provideMkI18n(overrides) {
-    const value = {
-        ...MK_DEFAULT_I18N,
-        ...overrides,
-        dateNames: { ...MK_DEFAULT_DATE_NAMES, ...overrides.dateNames },
-        blockEditor: { ...MK_DEFAULT_I18N.blockEditor, ...overrides.blockEditor },
-        validation: { ...MK_DEFAULT_VALIDATION, ...overrides.validation },
-    };
-    return { provide: MK_I18N, useValue: value };
+function provideMkI18n(overrides, base = MK_DEFAULT_I18N) {
+    return { provide: MK_I18N, useValue: mkMergeI18n(base, overrides) };
 }
 
 /**
@@ -2261,5 +2273,5 @@ function mkQueryToText(group, fields = [], i18n = MK_DEFAULT_I18N) {
  * Generated bundle index. Do not edit.
  */
 
-export { MK_BREAKPOINTS, MK_DEFAULT_BREAKPOINTS, MK_DEFAULT_DATE_NAMES, MK_DEFAULT_I18N, MK_DEFAULT_VALIDATION, MK_I18N, MK_OVERLAY_DATA, MK_QUERY_OPERATORS, MK_QUERY_UNARY, MkAnchoredPanel, MkBreakpointService, MkFieldContext, MkFocusTrap, MkLiveAnnouncer, MkOverlayRef, MkOverlayService, MkThemeService, mkComputeAnchoredPosition, mkCreateQueryGroup, mkCreateQueryRule, mkFirstErrorMessage, mkGetFocusable, mkHighlight, mkHighlightJson, mkInjectFieldTouched, mkIsQueryGroup, mkIsResponsive, mkQueryCompact, mkQueryIsEmpty, mkQueryOperatorLabel, mkQueryOperatorsFor, mkQueryRuleCount, mkQueryRuleIsComplete, mkQueryRuleMatches, mkQueryToPredicate, mkQueryToText, mkSignalErrorMessage, mkSignalErrorsToValidationErrors, mkUniqueId, mkValidatorChange, provideMkI18n };
+export { MK_BREAKPOINTS, MK_DEFAULT_BREAKPOINTS, MK_DEFAULT_DATE_NAMES, MK_DEFAULT_I18N, MK_DEFAULT_VALIDATION, MK_I18N, MK_OVERLAY_DATA, MK_QUERY_OPERATORS, MK_QUERY_UNARY, MkAnchoredPanel, MkBreakpointService, MkFieldContext, MkFocusTrap, MkLiveAnnouncer, MkOverlayRef, MkOverlayService, MkThemeService, mkComputeAnchoredPosition, mkCreateQueryGroup, mkCreateQueryRule, mkFirstErrorMessage, mkGetFocusable, mkHighlight, mkHighlightJson, mkInjectFieldTouched, mkIsQueryGroup, mkIsResponsive, mkMergeI18n, mkQueryCompact, mkQueryIsEmpty, mkQueryOperatorLabel, mkQueryOperatorsFor, mkQueryRuleCount, mkQueryRuleIsComplete, mkQueryRuleMatches, mkQueryToPredicate, mkQueryToText, mkSignalErrorMessage, mkSignalErrorsToValidationErrors, mkUniqueId, mkValidatorChange, provideMkI18n };
 //# sourceMappingURL=mk-kit-ui-core.mjs.map