@mk-kit/ui 0.55.1 → 0.57.0

package/types/mk-kit-ui-translate-editor.d.ts

@@ -0,0 +1,76 @@
+import * as _angular_core from '@angular/core';
+import * as _mk_kit_ui_core from '@mk-kit/ui/core';
+import { MkTableColumn } from '@mk-kit/ui/table';
+import { MkFlatTranslations } from '@mk-kit/ui/translate';
+
+/** One edit made in the editor. `value: null` clears the override. */
+interface MkTranslationChange {
+    locale: string;
+    key: string;
+    value: string | null;
+    /** The text shown before the edit (override, or the base string). */
+    previous: string | null;
+}
+/** A row of the editor: the key plus the effective text per locale. */
+interface MkTranslationRow {
+    key: string;
+    [locale: string]: string;
+}
+type Filter = 'all' | 'overridden' | `missing:${string}`;
+/**
+ * Translation editor — keys as rows, locales as columns, click a cell to
+ * edit. The base strings are your bundled files; edits are **overrides**
+ * kept apart from them, so a rebuild never loses them and a cell can be
+ * restored to the file text. Search by key or text, filter to the keys a
+ * locale is missing or the ones already edited, export the grid as CSV.
+ * Persistence is yours: every edit is emitted as `changed`, feed the result
+ * back through `overrides`.
+ *
+ * ```html
+ * <mk-translation-editor
+ *   [locales]="['pl', 'en', 'ru']"
+ *   [base]="base()"
+ *   [overrides]="overrides()"
+ *   (changed)="save($event)" />
+ * ```
+ */
+declare class MkTranslationEditor {
+    protected readonly i18n: _mk_kit_ui_core.MkI18nStrings;
+    /** Locale codes, in column order. The first one is the reference language. */
+    readonly locales: _angular_core.InputSignal<string[]>;
+    /** Bundled strings per locale, flat (`'a.b.c': 'text'`) or nested. */
+    readonly base: _angular_core.InputSignal<Record<string, MkFlatTranslations>>;
+    /** Edits per locale, flat. Missing locales are fine. */
+    readonly overrides: _angular_core.InputSignal<Record<string, MkFlatTranslations>>;
+    /** Show but do not edit. */
+    readonly readonly: _angular_core.InputSignal<boolean>;
+    /** File name of the CSV export. */
+    readonly exportFilename: _angular_core.InputSignal<string>;
+    /** An edit or a restore; persist it and update `overrides`. */
+    readonly changed: _angular_core.OutputEmitterRef<MkTranslationChange>;
+    protected readonly query: _angular_core.WritableSignal<string>;
+    protected readonly filter: _angular_core.WritableSignal<Filter>;
+    /** Every key any locale knows, sorted. */
+    protected readonly keys: _angular_core.Signal<string[]>;
+    /** Per-locale counts shown as filter chips. */
+    protected readonly stats: _angular_core.Signal<{
+        locale: string;
+        missing: number;
+        overridden: number;
+    }[]>;
+    protected readonly overriddenTotal: _angular_core.Signal<number>;
+    protected readonly rows: _angular_core.Signal<MkTranslationRow[]>;
+    protected readonly columns: _angular_core.Signal<MkTableColumn<MkTranslationRow>[]>;
+    protected effective(locale: string, key: string): string | null;
+    protected hasOverride(locale: string, key: string): boolean;
+    protected isMissing(locale: string, key: string): boolean;
+    protected onSaved(locale: string, key: string, value: string): void;
+    protected reset(locale: string, key: string): void;
+    protected setFilter(next: string): void;
+    protected exportCsv(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MkTranslationEditor, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MkTranslationEditor, "mk-translation-editor", never, { "locales": { "alias": "locales"; "required": true; "isSignal": true; }; "base": { "alias": "base"; "required": true; "isSignal": true; }; "overrides": { "alias": "overrides"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "exportFilename": { "alias": "exportFilename"; "required": false; "isSignal": true; }; }, { "changed": "changed"; }, never, never, true, never>;
+}
+
+export { MkTranslationEditor };
+export type { MkTranslationChange, MkTranslationRow };

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

@@ -15,6 +15,7 @@ export * from '@mk-kit/ui/status';
 export * from '@mk-kit/ui/data';
 export * from '@mk-kit/ui/kanban';
 export * from '@mk-kit/ui/translate';
+export * from '@mk-kit/ui/attention';
 export * from '@mk-kit/ui/feedback';
 export * from '@mk-kit/ui/rich-text';
 export * from '@mk-kit/ui/block-editor';