@prozorro/prozorro-ui 0.0.48-beta → 0.1.0-beta

package/dist/services/PzMessages/PzMessages.d.ts

@@ -0,0 +1,21 @@
+import { PzMessageParams, PzMessagePath, PzMessagesInput, PzMessagesTree } from './types';
+/**
+ * Override library texts globally. Deep-merges the partial `input` over any
+ * previous overrides, so only the provided keys change.
+ */
+export declare const setMessages: (input: PzMessagesInput) => void;
+/**
+ * Resolve a message by dotted path. Priority: app-level override, then the
+ * built-in default. Optional `params` fill `{key}` placeholders.
+ *
+ * Intended as the level-2/3 fallback behind a component prop, e.g.
+ * `props.popupText ?? getMessage("actions.pzCopyToClipboard.popupText")`.
+ */
+export declare const getMessage: (path: PzMessagePath, params?: PzMessageParams) => string;
+/** Returns a snapshot of the effective tree (defaults deep-merged with overrides). */
+export declare const getMessages: () => PzMessagesTree;
+/**
+ * Clear overrides. With no argument, removes all overrides (revert to defaults).
+ * With a dotted `path`, removes only that override subtree/leaf.
+ */
+export declare const resetMessages: (path?: PzMessagePath) => void;

package/dist/services/PzMessages/constants.d.ts

@@ -0,0 +1,11 @@
+import { PzMessagesTree } from './types';
+/**
+ * Built-in default texts — the lowest-priority layer. Overridden globally by
+ * {@link setMessages} and per-instance by component props.
+ *
+ * NOTE: upload texts are duplicated here (rather than imported from
+ * `components/Form/shared/configs.ts`) on purpose — `services → components`
+ * imports are forbidden by the dependency-direction rule. These strings are
+ * the single source of truth; the Form components read them via `getMessage`.
+ */
+export declare const DEFAULT_MESSAGES: PzMessagesTree;

package/dist/services/PzMessages/index.d.ts

@@ -0,0 +1,2 @@
+export { setMessages, getMessage, getMessages, resetMessages } from './PzMessages';
+export type * from './types';

package/dist/services/PzMessages/types.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Full shape of the library message tree. Every leaf is a user-facing string.
+ * Grouped by the same taxonomy as the component folders / story titles
+ * (actions, data, display, form, navigation, popups, text).
+ */
+export interface PzMessagesTree {
+    actions: {
+        pzCopyToClipboard: {
+            popupText: string;
+            label: string;
+        };
+    };
+    data: {
+        pzTable: {
+            defaultValue: string;
+        };
+    };
+    display: {
+        pzLoader: {
+            label: string;
+        };
+    };
+    form: {
+        pzMultiSelect: {
+            selectedLabel: string;
+        };
+        pzFileInput: {
+            buttonLabel: string;
+            helperText: string;
+            removeButtonLabel: string;
+            invalidExtensionMessage: string;
+            fileTooLargeMessage: string;
+        };
+        pzImageInput: {
+            buttonLabel: string;
+            helperText: string;
+            editButtonLabel: string;
+            invalidExtensionMessage: string;
+            fileTooLargeMessage: string;
+            invalidDimensionsMessage: string;
+        };
+    };
+    navigation: {
+        pzPagination: {
+            prevLabel: string;
+            nextLabel: string;
+            dots: string;
+        };
+        pzBreadcrumb: {
+            home: string;
+        };
+    };
+    popups: {
+        pzModal: {
+            closeLabel: string;
+        };
+        pzInfoHint: {
+            label: string;
+        };
+    };
+    text: {
+        pzTextClamp: {
+            expandLabel: string;
+            collapseLabel: string;
+        };
+        pzArrayClamp: {
+            expandLabel: string;
+            collapseLabel: string;
+        };
+    };
+}
+/**
+ * Recursively makes every property of `T` optional. Used for the `setMessages`
+ * input so consumers may override only the keys they care about.
+ */
+export type PzMessagesDeepPartial<T> = {
+    [K in keyof T]?: T[K] extends object ? PzMessagesDeepPartial<T[K]> : T[K];
+};
+/**
+ * Accepted input for {@link setMessages} — a deep-partial of the message tree.
+ */
+export type PzMessagesInput = PzMessagesDeepPartial<PzMessagesTree>;
+/**
+ * Union of every dotted leaf path in the message tree
+ * (e.g. "actions.pzCopyToClipboard.popupText"). Powers autocomplete and
+ * compile-time validation of {@link getMessage} / {@link resetMessages} keys.
+ */
+export type PzMessagePath<T = PzMessagesTree> = {
+    [K in keyof T & string]: T[K] extends string ? K : `${K}.${PzMessagePath<T[K]>}`;
+}[keyof T & string];
+/**
+ * Interpolation params for `{key}` placeholders inside a message
+ * (e.g. "{count} обрано").
+ */
+export type PzMessageParams = Record<string, string | number>;