@mk-kit/ui 0.44.0 → 0.45.0

package/types/mk-kit-ui-core.d.ts

@@ -1212,21 +1212,37 @@ declare const MK_DEFAULT_I18N: MkI18nStrings;
  */
 declare const MK_I18N: InjectionToken<MkI18nStrings>;
 /**
- * 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.
+ * Any subset of {@link MkI18nStrings}; the nested `dateNames`, `blockEditor`
+ * and `validation` groups may be partial too (they are merged deeply).
+ */
+type MkI18nOverrides = Partial<Omit<MkI18nStrings, 'dateNames' | 'blockEditor' | 'validation'>> & {
+    dateNames?: Partial<MkDateNames>;
+    blockEditor?: Partial<MkBlockEditorStrings>;
+    validation?: Partial<MkValidationStrings>;
+};
+/**
+ * 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.
+ */
+declare function mkMergeI18n(base: MkI18nStrings, overrides: MkI18nOverrides): MkI18nStrings;
+/**
+ * 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)`.
  */
-declare function provideMkI18n(overrides: Partial<Omit<MkI18nStrings, 'dateNames' | 'blockEditor' | 'validation'>> & {
-    dateNames?: Partial<MkDateNames>;
-    blockEditor?: Partial<MkBlockEditorStrings>;
-    validation?: Partial<MkValidationStrings>;
-}): Provider;
+declare function provideMkI18n(overrides: MkI18nOverrides, base?: MkI18nStrings): Provider;
 
 /**
  * Field context — the contract a field wrapper (`mk-form-field`) exposes to
@@ -1473,5 +1489,5 @@ declare function mkQueryOperatorLabel(op: MkQueryOperator, i18n?: MkI18nStrings)
  */
 declare function mkQueryToText(group: MkQueryGroup, fields?: readonly MkQueryField[], i18n?: MkI18nStrings): string;
 
-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 type { MkAnchoredPosition, MkAnchoredPositionOptions, MkAriaLivePoliteness, MkBlockEditorStrings, MkBreakpoint, MkBreakpoints, MkCodeLanguage, MkContrastPreference, MkDateNames, MkDensity, MkErrorMessages, MkI18nStrings, MkOverlayConfig, MkPlacement, MkQueryCombinator, MkQueryField, MkQueryFieldOption, MkQueryGroup, MkQueryNode, MkQueryOperator, MkQueryRule, MkQueryValueType, MkResolvedContrast, MkResolvedTheme, MkResponsive, MkSignalValidationError, MkSize$1 as MkSize, MkSortAnnounceDirection, MkThemePreference, MkTone, MkValidationStrings, MkValidatorChangeRef, MkVariant };
+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 };
+export type { MkAnchoredPosition, MkAnchoredPositionOptions, MkAriaLivePoliteness, MkBlockEditorStrings, MkBreakpoint, MkBreakpoints, MkCodeLanguage, MkContrastPreference, MkDateNames, MkDensity, MkErrorMessages, MkI18nOverrides, MkI18nStrings, MkOverlayConfig, MkPlacement, MkQueryCombinator, MkQueryField, MkQueryFieldOption, MkQueryGroup, MkQueryNode, MkQueryOperator, MkQueryRule, MkQueryValueType, MkResolvedContrast, MkResolvedTheme, MkResponsive, MkSignalValidationError, MkSize$1 as MkSize, MkSortAnnounceDirection, MkThemePreference, MkTone, MkValidationStrings, MkValidatorChangeRef, MkVariant };

package/types/mk-kit-ui-locales-pl.d.ts

@@ -0,0 +1,42 @@
+import { Provider } from '@angular/core';
+import { MkBlockEditorStrings, MkDateNames, MkI18nStrings, MkValidationStrings, MkI18nOverrides } from '@mk-kit/ui/core';
+
+/**
+ * Picks the Polish plural form for a count: `one` for 1, `few` for 2–4
+ * (except 12–14), `many` otherwise — CLDR's `pl` rules for integers, which is
+ * all the library's counts ever are.
+ *
+ * ```ts
+ * mkPluralPl(1, 'wynik', 'wyniki', 'wyników');  // 'wynik'
+ * mkPluralPl(3, 'wynik', 'wyniki', 'wyników');  // 'wyniki'
+ * mkPluralPl(12, 'wynik', 'wyniki', 'wyników'); // 'wyników'
+ * ```
+ */
+declare function mkPluralPl(count: number, one: string, few: string, many: string): string;
+/** Polish month and weekday names (Sunday-first, lowercase as in `Intl`). */
+declare const MK_PL_DATE_NAMES: MkDateNames;
+/** Polish validation messages rendered by `mk-form-field`. */
+declare const MK_PL_VALIDATION: MkValidationStrings;
+/** Polish strings of the block editor's chrome. */
+declare const MK_PL_BLOCK_EDITOR: MkBlockEditorStrings;
+/**
+ * The complete Polish string map — every key of {@link MkI18nStrings},
+ * `locale: 'pl-PL'` and `currency: 'PLN'` for the formatting pipes.
+ * Provide it whole with {@link provideMkI18nPl}, or pass it as the base of
+ * `provideMkI18n(overrides, MK_PL_I18N)`.
+ */
+declare const MK_PL_I18N: MkI18nStrings;
+/**
+ * Provides the Polish strings — {@link MK_PL_I18N} with any `overrides`
+ * merged on top (deep for `dateNames`, `blockEditor` and `validation`, like
+ * `provideMkI18n`).
+ *
+ * ```ts
+ * bootstrapApplication(App, {
+ *   providers: [provideMkI18nPl({ noData: 'Nic tu nie ma' })],
+ * });
+ * ```
+ */
+declare function provideMkI18nPl(overrides?: MkI18nOverrides): Provider;
+
+export { MK_PL_BLOCK_EDITOR, MK_PL_DATE_NAMES, MK_PL_I18N, MK_PL_VALIDATION, mkPluralPl, provideMkI18nPl };