@mk-kit/ui 0.44.0 → 0.46.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-forms.d.ts

@@ -3059,9 +3059,9 @@ declare class MkCurrencyInput implements ControlValueAccessor, Validator {
 type MkCardBrand = 'visa' | 'mastercard' | 'amex' | 'discover' | 'diners' | 'jcb';
 /** Human-readable names for the recognised brands. */
 declare const MK_CARD_BRAND_NAMES: Record<MkCardBrand, string>;
-/** Detect the card network from the leading digits (IIN ranges). */
+/** Detect the card network from the leading digits — `detectCardBrand` from `@mk-kit/validators`. */
 declare function mkDetectCardBrand(digits: string): MkCardBrand | null;
-/** Luhn (mod 10) checksum over a digit string. */
+/** Luhn (mod 10) checksum over a digit string — `isLuhn` from `@mk-kit/validators`. */
 declare function mkLuhnCheck(digits: string): boolean;
 /**
  * CardNumberInput — a payment-card number field that groups digits with the
@@ -3144,14 +3144,18 @@ declare class MkCardNumberInput implements ControlValueAccessor, Validator {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<MkCardNumberInput, "mk-card-number-input", ["mkCardNumberInput"], { "showBrand": { "alias": "showBrand"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "brandChange": "brandChange"; }, never, never, true, never>;
 }
 
-/** IBAN length per ISO 13616 country code (SEPA + common others). */
-declare const MK_IBAN_LENGTHS: Readonly<Record<string, number>>;
 /**
- * ISO 13616 mod-97 check over a compact (no spaces, uppercase) IBAN.
- * Assumes the shape `CC00…` has already been length-checked by the caller.
+ * IBAN lengths per country — re-exported from `@mk-kit/validators`
+ * (`IBAN_LENGTHS`, the SWIFT registry).
  */
+declare const MK_IBAN_LENGTHS: Readonly<Record<string, number>>;
+/** ISO 7064 MOD 97-10 over a compact (uppercase, no separators) IBAN. */
 declare function mkIbanChecksum(compact: string): boolean;
-/** Full IBAN validity: known country, exact length, mod-97 check. */
+/**
+ * Shape, the registry length for the country and the checksum — delegates
+ * to `isIban` from `@mk-kit/validators`. Unlike that function this one keeps
+ * the input kit's stricter rule that the country must be in the table.
+ */
 declare function mkIbanIsValid(compact: string): boolean;
 /**
  * Reactive-forms validator for an IBAN (any supported country). Empty values
@@ -3259,9 +3263,8 @@ interface MkTaxIdFormat {
     validate?: (compact: string) => boolean;
 }
 /**
- * Polish NIP checksum: the weighted sum of the first nine digits modulo 11 is
- * the tenth (check) digit. A remainder of 10 can never be a digit, so such a
- * number is invalid whatever its last digit.
+ * Polish NIP checksum — delegates to `isNip` from `@mk-kit/validators`
+ * (weights 6-5-7-2-3-4-5-6-7 mod 11; a remainder of 10 is invalid).
  */
 declare function mkNipChecksum(compact: string): boolean;
 /**

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 };