@ecomcx/ecomweb-editor 1.20.0 → 1.22.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (69) hide show
  1. package/README.md +15 -0
  2. package/package.json +3 -3
  3. package/src/i18n/index.ts +74 -0
  4. package/src/index.ts +3 -1
  5. package/src/legacy/basic.tsx +8 -30
  6. package/src/legacy/dynamic.tsx +15 -39
  7. package/src/locales/en/attrs.ts +72 -0
  8. package/src/locales/en/bindings.ts +26 -0
  9. package/src/locales/en/block-desc.ts +53 -0
  10. package/src/locales/en/block-titles.ts +43 -0
  11. package/src/locales/en/blocks.ts +39 -0
  12. package/src/locales/en/controls.ts +18 -0
  13. package/src/locales/en/hints.ts +142 -0
  14. package/src/locales/en/index.ts +20 -0
  15. package/src/locales/en/layout.ts +37 -0
  16. package/src/locales/en/legacy-basic.ts +54 -0
  17. package/src/locales/en/legacy-dynamic.ts +73 -0
  18. package/src/locales/en/legacy.ts +67 -0
  19. package/src/locales/en/motion.ts +33 -0
  20. package/src/locales/en/pattern-lib.ts +151 -0
  21. package/src/locales/en/patterns.ts +45 -0
  22. package/src/locales/en/shortcuts.ts +19 -0
  23. package/src/locales/en/v2.ts +177 -0
  24. package/src/locales/vi/attrs.ts +72 -0
  25. package/src/locales/vi/bindings.ts +26 -0
  26. package/src/locales/vi/block-desc.ts +53 -0
  27. package/src/locales/vi/block-titles.ts +43 -0
  28. package/src/locales/vi/blocks.ts +39 -0
  29. package/src/locales/vi/controls.ts +18 -0
  30. package/src/locales/vi/hints.ts +142 -0
  31. package/src/locales/vi/index.ts +24 -0
  32. package/src/locales/vi/layout.ts +37 -0
  33. package/src/locales/vi/legacy-basic.ts +54 -0
  34. package/src/locales/vi/legacy-dynamic.ts +73 -0
  35. package/src/locales/vi/legacy.ts +67 -0
  36. package/src/locales/vi/motion.ts +33 -0
  37. package/src/locales/vi/pattern-lib.ts +151 -0
  38. package/src/locales/vi/patterns.ts +45 -0
  39. package/src/locales/vi/shortcuts.ts +19 -0
  40. package/src/locales/vi/v2.ts +177 -0
  41. package/src/shared/animation-store.ts +38 -0
  42. package/src/shared/labels.ts +11 -134
  43. package/src/shared/patterns-kit.ts +7 -0
  44. package/src/shared/patterns-library.ts +152 -0
  45. package/src/shared/patterns.ts +6 -32
  46. package/src/v2/blocks/index.ts +5 -11
  47. package/src/v2/blocks/inline-style.ts +30 -0
  48. package/src/v2/blocks/layout.tsx +84 -14
  49. package/src/v2/blocks/media.tsx +21 -17
  50. package/src/v2/blocks/theme.tsx +43 -22
  51. package/src/v2/canvas/canvas.tsx +9 -1
  52. package/src/v2/core/bindings.ts +9 -8
  53. package/src/v2/core/model.ts +2 -2
  54. package/src/v2/editor.tsx +7 -4
  55. package/src/v2/i18n.ts +14 -0
  56. package/src/v2/index.ts +3 -1
  57. package/src/v2/labels.ts +11 -348
  58. package/src/v2/ui/attr-form.tsx +14 -29
  59. package/src/v2/ui/attr-hints.ts +87 -74
  60. package/src/v2/ui/bindings.tsx +10 -12
  61. package/src/v2/ui/block-descriptions.ts +6 -33
  62. package/src/v2/ui/inserter.tsx +2 -2
  63. package/src/v2/ui/inspector.tsx +7 -5
  64. package/src/v2/ui/layout-panel.tsx +3 -14
  65. package/src/v2/ui/motion-panel.tsx +99 -0
  66. package/src/v2/ui/options.tsx +6 -13
  67. package/src/v2/ui/style-controls.tsx +7 -6
  68. package/src/v2/ui/style-tab.tsx +9 -4
  69. package/src/v2/ui/unit-controls.tsx +6 -5
package/src/v2/editor.tsx CHANGED
@@ -1,7 +1,7 @@
1
1
  import type { RichNode } from "@ecomcx/ecomweb-content";
2
2
  import { normalizeContent } from "@ecomcx/ecomweb-content";
3
3
  import { ListTree, Monitor, Plus, Redo2, Smartphone, Tablet, Undo2, X, PanelRight, ZoomOut } from "lucide-react";
4
- import { useEffect, useMemo, useRef, useState, type ReactNode } from "react";
4
+ import { useEffect, useMemo, useRef, useState, useSyncExternalStore, type ReactNode } from "react";
5
5
  import { coreBlockTypes, registerCoreBlocks } from "./blocks";
6
6
  import { registeredPatterns, syncPluginBlocks } from "./blocks/compat";
7
7
  import { registerCorePatterns } from "../shared/patterns";
@@ -10,7 +10,8 @@ import { Canvas, type Device } from "./canvas/canvas";
10
10
  import { EditorContext, EditorUi, useEditor, useEditorState, useUiTick, type EditorContextValue } from "./context";
11
11
  import type { EditorHost } from "./core/host";
12
12
  import { InserterPanel, InserterPopover } from "./ui/inserter";
13
- import { enV2, viV2, type V2Labels } from "./labels";
13
+ import { labelsV2, type V2Labels } from "./labels";
14
+ import { localesVersion, onLocalesChange } from "../i18n";
14
15
  import { blocksFromDoc, docFromBlocks, type BNode } from "./core/model";
15
16
  import { BlockTypeRegistry } from "./core/registry";
16
17
  import { Inspector } from "./ui/inspector";
@@ -50,7 +51,8 @@ export interface EditorProviderProps {
50
51
  title?: string;
51
52
  host?: EditorHost;
52
53
  labels?: Partial<V2Labels>;
53
- lang?: "vi" | "en";
54
+ /** Mã ngôn ngữ giao diện: "vi", "en" hoặc ngôn ngữ đã đăng ký bằng registerLocale. Mặc định "vi". */
55
+ lang?: string;
54
56
  registry?: BlockTypeRegistry;
55
57
  /** Cho chèn khối giao diện (tên website, menu, danh sách bài, phần dùng chung). */
56
58
  dynamicBlocks?: boolean;
@@ -69,7 +71,8 @@ export interface EditorProviderProps {
69
71
  }
70
72
 
71
73
  export function EditorProvider({ store: given, value, kind, title, host = {}, labels, lang, registry: givenRegistry, dynamicBlocks, frame, prefsStorage, prefs: givenPrefs, onChange, children }: EditorProviderProps) {
72
- const base = lang === "en" ? enV2 : viV2;
74
+ const localeTick = useSyncExternalStore(onLocalesChange, localesVersion, localesVersion);
75
+ const base = useMemo(() => labelsV2(lang), [lang, localeTick]);
73
76
  const allLabels = useMemo(() => ({ ...base, ...labels }), [base, labels]);
74
77
  const registry = useMemo(() => {
75
78
  if (givenRegistry) return givenRegistry;
package/src/v2/i18n.ts ADDED
@@ -0,0 +1,14 @@
1
+ import { useSyncExternalStore } from "react";
2
+ import { localesVersion, msgs, onLocalesChange } from "../i18n";
3
+ import type { vi } from "../locales/vi";
4
+ import { useEditor } from "./context";
5
+
6
+ /**
7
+ * Chữ của một nhóm theo ngôn ngữ của trình soạn (`labels.lang`): `const t = useMsgs("motion"); t.title`.
8
+ * Tự vẽ lại khi có ngôn ngữ / bản dịch mới được đăng ký lúc đang chạy (registerLocale).
9
+ */
10
+ export function useMsgs<K extends keyof typeof vi>(ns: K): (typeof vi)[K] {
11
+ const { labels } = useEditor();
12
+ useSyncExternalStore(onLocalesChange, localesVersion, localesVersion);
13
+ return msgs(ns, labels.lang);
14
+ }
package/src/v2/index.ts CHANGED
@@ -20,9 +20,11 @@ export { blocksFromDoc, docFromBlocks, fromRich, toRich, makeBlock, cloneBlock,
20
20
  export { findBlock, flatten, mapBlock, insertBlocks, removeBlocks, moveBlocks } from "./core/ops";
21
21
  export { canContain, fixTree, setStructureRule, type StructureRule } from "./core/structure";
22
22
  export { htmlToRich, textToRich, richToHtml, BLOCKS_MIME } from "./core/clipboard";
23
- export { viV2, enV2, type V2Labels } from "./labels";
23
+ export { viV2, enV2, labelsV2, type V2Labels } from "./labels";
24
+ export { registerLocale, availableLocales, type Messages } from "../i18n";
24
25
  export type { EditorHost, DocumentHost, DynamicData, DynamicPost, QueryArgs, Choice, ChoiceKind, NestedDocRef, LoadedDoc, SavedContent } from "./core/host";
25
26
  export { MoreMenu, PreferencesModal, ShortcutsModal, CodeEditor, Breadcrumbs } from "./ui/options";
26
27
  export { PrefsStore, localPrefsStorage, usePrefs, DEFAULT_PREFS, type EditorPrefs, type PrefsStorage } from "./prefs";
27
28
  export { DocTitle } from "./ui/doc-title";
28
29
  export { registerBindingSource, unregisterBindingSource, bindingSources, BindingsPanel, BoundText, useBindingPreview, CORE_BINDABLE, type EditorBindingSource, type Binding } from "./ui/bindings";
30
+ export { storeAnimation as registerAnimation, dropAnimation as unregisterAnimation, pluginAnimations, type MotionEffect } from "../shared/animation-store";
package/src/v2/labels.ts CHANGED
@@ -1,349 +1,12 @@
1
- /** Chữ giao diện của trình soạn v2 (ứng dụng truyền bộ khác qua `labels`). */
2
- export const viV2 = {
3
- lang: "vi" as "vi" | "en",
4
- editor: "Trình soạn nội dung",
5
- canvas: "Khung soạn",
6
- typeSlash: "Gõ / để chọn khối",
7
- emptyDoc: "Bắt đầu viết hoặc gõ / để chèn khối",
8
- addBlock: "Thêm khối",
9
- search: "Tìm khối",
10
- noResults: "Không tìm thấy khối",
11
- blocks: "Khối",
12
- patterns: "Mẫu",
13
- moveUp: "Lên",
14
- moveDown: "Xuống",
15
- drag: "Kéo để di chuyển",
16
- selectParent: "Chọn khối cha",
17
- duplicate: "Nhân bản",
18
- remove: "Xoá",
19
- insertBefore: "Thêm khối phía trên",
20
- insertAfter: "Thêm khối phía dưới",
21
- group: "Gom vào nhóm",
22
- ungroup: "Bỏ nhóm",
23
- copy: "Sao chép",
24
- more: "Thêm",
25
- transform: "Đổi loại khối",
26
- bold: "Đậm",
27
- italic: "Nghiêng",
28
- underline: "Gạch chân",
29
- strike: "Gạch ngang",
30
- subscript: "Chữ nhỏ ở dưới",
31
- superscript: "Chữ nhỏ ở trên",
32
- highlight: "Làm nổi bật",
33
- moreFormats: "Định dạng khác",
34
- code: "Mã",
35
- link: "Liên kết",
36
- unlink: "Bỏ liên kết",
37
- linkUrl: "Địa chỉ liên kết",
38
- openNewTab: "Mở tab mới",
39
- apply: "Áp dụng",
40
- cancel: "Huỷ",
41
- alignLeft: "Căn trái",
42
- alignCenter: "Căn giữa",
43
- alignRight: "Căn phải",
44
- undo: "Hoàn tác",
45
- redo: "Làm lại",
46
- listView: "Cây khối",
47
- settings: "Cài đặt",
48
- noSelection: "Chọn một khối để chỉnh",
49
- editOriginal: "Chỉnh sửa bản gốc",
50
- back: "Quay lại",
51
- loading: "Đang tải…",
52
- loadFailed: "Không tải được",
53
- missingPart: "Phần dùng chung không tồn tại",
54
- readOnly: "Chỉ xem",
55
- save: "Lưu",
56
- saving: "Đang lưu…",
57
- saved: "Đã lưu",
58
- unsaved: "Có thay đổi chưa lưu",
59
- unknownBlock: "Khối chưa hỗ trợ (dữ liệu được giữ nguyên)",
60
- paragraph: "Đoạn văn",
61
- heading: "Tiêu đề",
62
- list: "Danh sách",
63
- orderedList: "Danh sách số",
64
- quote: "Trích dẫn",
65
- codeBlock: "Mã nguồn",
66
- preformatted: "Định dạng sẵn",
67
- separator: "Đường kẻ",
68
- image: "Ảnh",
69
- groupBlock: "Nhóm",
70
- row: "Hàng ngang",
71
- stack: "Xếp dọc",
72
- grid: "Lưới",
73
- columns: "Cột",
74
- column: "Cột",
75
- buttons: "Nút",
76
- button: "Nút",
77
- spacer: "Khoảng trống",
78
- callout: "Hộp lưu ý",
79
- details: "Chi tiết",
80
- table: "Bảng",
81
- templatePart: "Phần dùng chung",
82
- syncedPattern: "Mẫu đồng bộ",
83
- pullquote: "Trích dẫn nổi bật",
84
- cover: "Ảnh bìa",
85
- html: "HTML tuỳ chỉnh",
86
- embed: "Nhúng",
87
- chooseImage: "Chọn ảnh",
88
- imageUrl: "Địa chỉ ảnh",
89
- upload: "Tải lên",
90
- browseAll: "Xem tất cả",
91
- mediaLibrary: "Thư viện",
92
- insertFromUrl: "Chèn từ URL",
93
- uploading: "Đang tải lên…",
94
- dropHint: { image: "Kéo thả ảnh vào đây, tải lên hoặc chọn từ thư viện.", gallery: "Kéo thả nhiều ảnh vào đây, tải lên hoặc chọn từ thư viện.", video: "Kéo thả video, tải lên, chọn từ thư viện hoặc dán địa chỉ.", audio: "Kéo thả tệp âm thanh, tải lên, chọn từ thư viện hoặc dán địa chỉ.", file: "Kéo thả tệp, tải lên hoặc chọn từ thư viện." } as Record<string, string>,
95
- caption: "Chú thích",
96
- buttonText: "Chữ trên nút",
97
- addColumn: "Thêm cột",
98
- catText: "Chữ",
99
- catMedia: "Media",
100
- catDesign: "Thiết kế",
101
- catWidgets: "Tiện ích",
102
- catTheme: "Giao diện",
103
- catEmbed: "Nhúng",
104
- catOther: "Khác",
105
- level: "Cấp",
106
- textAlign: "Căn chữ",
107
- tableTools: "Bảng",
108
- rowBefore: "Thêm hàng phía trên",
109
- rowAfter: "Thêm hàng phía dưới",
110
- colBefore: "Thêm cột bên trái",
111
- colAfter: "Thêm cột bên phải",
112
- deleteRow: "Xoá hàng",
113
- deleteColumn: "Xoá cột",
114
- mergeRight: "Gộp với ô bên phải",
115
- mergeDown: "Gộp với ô bên dưới",
116
- splitCell: "Tách ô",
117
- toolbarHint: "Chọn một khối để hiện công cụ của khối ở đây",
118
- listEmpty: "Chưa có khối nào. Thêm khối bằng nút + hoặc gõ / trong khung soạn.",
119
- headerRow: "Hàng tiêu đề",
120
- removeColumn: "Bớt cột",
121
- addButton: "Thêm nút",
122
- resize: "Kéo để đổi độ rộng",
123
- showTemplate: "Hiện template",
124
- zoomOut: "Thu nhỏ để sắp xếp",
125
- zoomOutHint: "Bấm chọn một phần để kéo, di chuyển, xoá; bấm đúp để sửa",
126
- options: "Tuỳ chọn",
127
- view: "Xem",
128
- fixedToolbar: "Thanh công cụ cố định",
129
- fixedToolbarHint: "Thanh công cụ khối nằm cố định dưới thanh trên cùng",
130
- distractionFree: "Không phân tâm",
131
- distractionFreeHint: "Chỉ còn nội dung, ẩn các bảng bên",
132
- spotlight: "Làm nổi khối đang sửa",
133
- spotlightHint: "Làm mờ các khối khác",
134
- fullscreen: "Toàn màn hình",
135
- fullscreenHint: "Che menu quản trị, trình soạn chiếm cả màn hình",
136
- editorMode: "Trình soạn",
137
- visualEditor: "Soạn trực quan",
138
- codeEditor: "Soạn mã",
139
- codeEditorHint: "Sửa thẳng nội dung dạng JSON (định dạng lưu)",
140
- invalidCode: "Nội dung không hợp lệ",
141
- exitCode: "Quay về soạn trực quan",
142
- tools: "Công cụ",
143
- shortcuts: "Phím tắt",
144
- copyAll: "Chép toàn bộ nội dung",
145
- copiedAll: "Đã chép toàn bộ nội dung",
146
- preferences: "Tuỳ chọn trình soạn",
147
- general: "Chung",
148
- appearance: "Giao diện",
149
- accessibility: "Trợ năng",
150
- showListView: "Luôn mở cây khối",
151
- showListViewHint: "Mở sẵn cây khối khi vào trình soạn",
152
- showBreadcrumbs: "Hiện đường dẫn khối",
153
- showBreadcrumbsHint: "Thanh ở đáy cho biết khối đang chọn nằm trong khối nào",
154
- keepCaret: "Giữ con trỏ trong khối",
155
- keepCaretHint: "Phím mũi tên không nhảy sang khối khác ở đầu / cuối khối",
156
- iconLabels: "Hiện chữ trên nút",
157
- iconLabelsHint: "Nút trên thanh công cụ hiện chữ thay vì chỉ biểu tượng",
158
- mostUsed: "Hiện khối dùng nhiều",
159
- mostUsedHint: "Mục \"Dùng nhiều\" ở đầu thư viện khối",
160
- blockVisibility: "Khối hiện trong thư viện",
161
- blockVisibilityHint: "Bỏ chọn để ẩn khỏi thư viện khối và menu \"/\" (nội dung có sẵn vẫn hiện)",
162
- mostUsedTitle: "Dùng nhiều",
163
- close: "Đóng",
164
- documentRoot: "Tài liệu",
165
- createPattern: "Tạo mẫu",
166
- lock: "Khoá…",
167
- locked: "Đang khoá",
168
- lockTitle: "Khoá khối",
169
- lockMove: "Không cho di chuyển",
170
- lockRemove: "Không cho xoá",
171
- lockInner: "Khoá bố cục bên trong (không thêm / xoá / di chuyển khối con)",
172
- lockContentOnly: "Chỉ cho sửa nội dung bên trong (không đổi bố cục, kiểu dáng)",
173
- apply2: "Xong",
174
- };
175
- export type V2Labels = typeof viV2;
1
+ import { messages } from "../i18n";
2
+ import type { vi } from "../locales/vi";
176
3
 
177
- export const enV2: V2Labels = {
178
- lang: "en",
179
- editor: "Content editor",
180
- canvas: "Editor canvas",
181
- typeSlash: "Type / to choose a block",
182
- emptyDoc: "Start writing or type / to insert a block",
183
- addBlock: "Add block",
184
- search: "Search blocks",
185
- noResults: "No blocks found",
186
- blocks: "Blocks",
187
- patterns: "Patterns",
188
- moveUp: "Move up",
189
- moveDown: "Move down",
190
- drag: "Drag to move",
191
- selectParent: "Select parent block",
192
- duplicate: "Duplicate",
193
- remove: "Delete",
194
- insertBefore: "Add block before",
195
- insertAfter: "Add block after",
196
- group: "Group",
197
- ungroup: "Ungroup",
198
- copy: "Copy",
199
- more: "More",
200
- transform: "Transform",
201
- bold: "Bold",
202
- italic: "Italic",
203
- underline: "Underline",
204
- strike: "Strikethrough",
205
- subscript: "Subscript",
206
- superscript: "Superscript",
207
- highlight: "Highlight",
208
- moreFormats: "More formatting",
209
- code: "Code",
210
- link: "Link",
211
- unlink: "Remove link",
212
- linkUrl: "Link URL",
213
- openNewTab: "Open in new tab",
214
- apply: "Apply",
215
- cancel: "Cancel",
216
- alignLeft: "Align left",
217
- alignCenter: "Align center",
218
- alignRight: "Align right",
219
- undo: "Undo",
220
- redo: "Redo",
221
- listView: "List view",
222
- settings: "Settings",
223
- noSelection: "Select a block to edit",
224
- editOriginal: "Edit original",
225
- back: "Back",
226
- loading: "Loading…",
227
- loadFailed: "Failed to load",
228
- missingPart: "Template part not found",
229
- readOnly: "Read only",
230
- save: "Save",
231
- saving: "Saving…",
232
- saved: "Saved",
233
- unsaved: "Unsaved changes",
234
- unknownBlock: "Unsupported block (data is preserved)",
235
- paragraph: "Paragraph",
236
- heading: "Heading",
237
- list: "List",
238
- orderedList: "Numbered list",
239
- quote: "Quote",
240
- codeBlock: "Code",
241
- preformatted: "Preformatted",
242
- separator: "Separator",
243
- image: "Image",
244
- groupBlock: "Group",
245
- row: "Row",
246
- stack: "Stack",
247
- grid: "Grid",
248
- columns: "Columns",
249
- column: "Column",
250
- buttons: "Buttons",
251
- button: "Button",
252
- spacer: "Spacer",
253
- callout: "Callout",
254
- details: "Details",
255
- table: "Table",
256
- templatePart: "Template part",
257
- syncedPattern: "Synced pattern",
258
- pullquote: "Pullquote",
259
- cover: "Cover",
260
- html: "Custom HTML",
261
- embed: "Embed",
262
- chooseImage: "Choose image",
263
- imageUrl: "Image URL",
264
- upload: "Upload",
265
- browseAll: "Browse all",
266
- mediaLibrary: "Media library",
267
- insertFromUrl: "Insert from URL",
268
- uploading: "Uploading…",
269
- dropHint: { image: "Drop an image here, upload one, or pick from your library.", gallery: "Drop images here, upload, or pick from your library.", video: "Drop a video, upload, pick from your library, or paste a URL.", audio: "Drop an audio file, upload, pick from your library, or paste a URL.", file: "Drop a file, upload, or pick from your library." } as Record<string, string>,
270
- caption: "Caption",
271
- buttonText: "Button text",
272
- addColumn: "Add column",
273
- catText: "Text",
274
- catMedia: "Media",
275
- catDesign: "Design",
276
- catWidgets: "Widgets",
277
- catTheme: "Theme",
278
- catEmbed: "Embeds",
279
- catOther: "Other",
280
- level: "Level",
281
- textAlign: "Text align",
282
- tableTools: "Table",
283
- rowBefore: "Insert row before",
284
- rowAfter: "Insert row after",
285
- colBefore: "Insert column before",
286
- colAfter: "Insert column after",
287
- deleteRow: "Delete row",
288
- deleteColumn: "Delete column",
289
- mergeRight: "Merge with cell on the right",
290
- mergeDown: "Merge with cell below",
291
- splitCell: "Split cell",
292
- toolbarHint: "Select a block to show its tools here",
293
- listEmpty: "No blocks yet. Add one with the + button or type / in the canvas.",
294
- headerRow: "Header row",
295
- removeColumn: "Remove column",
296
- addButton: "Add button",
297
- resize: "Drag to resize",
298
- showTemplate: "Show template",
299
- zoomOut: "Zoom out",
300
- zoomOutHint: "Click a section to drag, move or delete it; double-click to edit",
301
- options: "Options",
302
- view: "View",
303
- fixedToolbar: "Top toolbar",
304
- fixedToolbarHint: "Block toolbar fixed below the top bar",
305
- distractionFree: "Distraction free",
306
- distractionFreeHint: "Only the content, side panels hidden",
307
- spotlight: "Spotlight",
308
- spotlightHint: "Dim every other block",
309
- fullscreen: "Fullscreen",
310
- fullscreenHint: "Hide the admin menu, the editor fills the screen",
311
- editorMode: "Editor",
312
- visualEditor: "Visual editor",
313
- codeEditor: "Code editor",
314
- codeEditorHint: "Edit the content directly as JSON (storage format)",
315
- invalidCode: "Invalid content",
316
- exitCode: "Back to visual editor",
317
- tools: "Tools",
318
- shortcuts: "Keyboard shortcuts",
319
- copyAll: "Copy all content",
320
- copiedAll: "All content copied",
321
- preferences: "Editor preferences",
322
- general: "General",
323
- appearance: "Appearance",
324
- accessibility: "Accessibility",
325
- showListView: "Always open list view",
326
- showListViewHint: "Open the list view when the editor loads",
327
- showBreadcrumbs: "Show block breadcrumbs",
328
- showBreadcrumbsHint: "A bar at the bottom shows where the selected block sits",
329
- keepCaret: "Keep caret inside block",
330
- keepCaretHint: "Arrow keys do not move to another block at its edges",
331
- iconLabels: "Show button text labels",
332
- iconLabelsHint: "Toolbar buttons show text instead of icons only",
333
- mostUsed: "Show most used blocks",
334
- mostUsedHint: "A \"Most used\" section at the top of the block library",
335
- blockVisibility: "Blocks shown in the library",
336
- blockVisibilityHint: "Uncheck to hide from the block library and the \"/\" menu (existing content still renders)",
337
- mostUsedTitle: "Most used",
338
- close: "Close",
339
- documentRoot: "Document",
340
- createPattern: "Create pattern",
341
- lock: "Lock…",
342
- locked: "Locked",
343
- lockTitle: "Lock block",
344
- lockMove: "Disable movement",
345
- lockRemove: "Prevent removal",
346
- lockInner: "Lock the layout inside (no adding / removing / moving inner blocks)",
347
- lockContentOnly: "Allow editing content only inside (layout and styles fixed)",
348
- apply2: "Done",
349
- };
4
+ /** Chữ giao diện của trình soạn v2 (nhóm "v2" trong src/locales) + mã ngôn ngữ đang dùng. */
5
+ export type V2Labels = (typeof vi)["v2"] & { lang: string };
6
+
7
+ /** Chữ của một ngôn ngữ (khoá thiếu rơi về ngôn ngữ gốc rồi tiếng Anh). */
8
+ export const labelsV2 = (lang?: string | null): V2Labels => ({ ...messages("v2", lang), lang: (lang ?? "vi").toLowerCase() }) as V2Labels;
9
+
10
+ /** Giữ tên cũ cho ứng dụng đang dùng: `labels={enV2}`. */
11
+ export const viV2 = labelsV2("vi");
12
+ export const enV2 = labelsV2("en");
@@ -3,34 +3,19 @@ import { useEffect, useState, type ReactNode } from "react";
3
3
  import { useEditor } from "../context";
4
4
  import type { Choice, ChoiceKind } from "../core/host";
5
5
  import type { BlockType } from "../core/registry";
6
- import { DEFAULT_IMAGE_SIZES, hintOf, optionLabel, type AttrHint } from "./attr-hints";
6
+ import { messages } from "../../i18n";
7
+ import { DEFAULT_IMAGE_SIZES, hintOf, hintText, imageSizeLabel, optionLabel, type AttrHint } from "./attr-hints";
7
8
  import { ColorInput } from "./color-field";
8
9
 
9
10
  export const cx = (...c: unknown[]) => c.filter((x): x is string => typeof x === "string" && x !== "").join(" ");
10
11
 
11
- export const ATTR_LABELS: Record<string, [string, string]> = {
12
- level: ["Cấp tiêu đề", "Level"], textAlign: ["Căn chữ", "Text align"], start: ["Bắt đầu từ", "Start at"], language: ["Ngôn ngữ", "Language"],
13
- src: ["Ảnh / tệp", "Media"], alt: ["Mô tả ảnh (alt)", "Alt text"], title: ["Tiêu đề", "Title"], caption: ["Chú thích", "Caption"], width: ["Rộng", "Width"],
14
- height: ["Cao", "Height"], align: ["Căn", "Align"], size: ["Cỡ", "Size"], href: ["Liên kết", "Link"], target: ["Mở ở", "Open in"], rel: ["rel", "rel"],
15
- variant: ["Kiểu", "Variant"], text: ["Chữ", "Text"], background: ["Màu nền", "Background"], textColor: ["Màu chữ", "Text color"], padding: ["Đệm", "Padding"],
16
- verticalAlign: ["Căn dọc", "Vertical align"], stack: ["Xếp chồng trên điện thoại", "Stack on mobile"], tone: ["Loại", "Tone"], summary: ["Tóm tắt", "Summary"],
17
- open: ["Mở sẵn", "Open by default"], overlay: ["Màu phủ", "Overlay"], opacity: ["Độ mờ phủ", "Overlay opacity"], minHeight: ["Cao tối thiểu", "Min height"],
18
- contentAlign: ["Vị trí chữ", "Content position"], fixed: ["Cố định khi cuộn", "Fixed background"], position: ["Vị trí ảnh", "Media position"],
19
- columns: ["Số cột", "Columns"], footer: ["Hàng cuối là chân bảng", "Footer row"], html: ["HTML", "HTML"], url: ["Địa chỉ", "URL"], links: ["Liên kết", "Links"],
20
- showLabels: ["Hiện tên", "Show labels"], maxLevel: ["Cấp tối đa", "Max level"], location: ["Vị trí menu", "Menu location"], orientation: ["Hướng", "Orientation"],
21
- mobile: ["Nút menu điện thoại", "Mobile toggle"], placeholder: ["Chữ gợi ý", "Placeholder"], buttonText: ["Chữ trên nút", "Button text"], link: ["Có liên kết", "Link"],
22
- moreText: ["Chữ “đọc tiếp”", "Read more text"], aspect: ["Tỉ lệ khung", "Aspect ratio"], avatar: ["Ảnh đại diện", "Avatar"], taxonomy: ["Phân loại", "Taxonomy"],
23
- separator: ["Dấu ngăn", "Separator"], inherit: ["Theo trang đang xem", "Inherit query"], postType: ["Loại bài", "Post type"], perPage: ["Số bài", "Per page"],
24
- category: ["Chuyên mục", "Category"], tag: ["Thẻ", "Tag"], orderBy: ["Sắp xếp theo", "Order by"], order: ["Thứ tự", "Order"], layout: ["Bố cục", "Layout"],
25
- slug: ["Phần (slug)", "Part (slug)"], tagName: ["Thẻ HTML", "HTML tag"], checked: ["Đã xong", "Done"], poster: ["Ảnh xem trước", "Poster"], download: ["Cho tải về", "Download"],
26
- embed: ["Xem ngay trên trang", "Embed"], prefix: ["Hiện “Chuyên mục:” / “Thẻ:” phía trước", "Show “Category:” / “Tag:” prefix"],
27
- showHome: ["Có “Trang chủ”", "Show home"], showCurrent: ["Có trang hiện tại", "Show current page"], showTitle: ["Hiện tiêu đề bài", "Show post titles"], anchor: ["Neo (id)", "Anchor"], className: ["Class CSS", "CSS class"],
28
- };
12
+ /** Tên thuộc tính theo ngôn ngữ (chữ: src/locales/<ngôn ngữ>/attrs.ts, khoá = tên thuộc tính). */
13
+ export const attrName = (name: string, lang: string): string | undefined => { const v = messages("attrs", lang)[name]; return typeof v === "string" ? v : undefined; };
29
14
  /** Thuộc tính sửa ở chỗ khác (thanh công cụ, trên khung soạn) hoặc dữ liệu kỹ thuật. */
30
15
  const HIDDEN_ATTRS = new Set(["style", "blockStyle", "anchor", "className", "mediaId", "srcset", "webpSrcset", "images", "links", "colwidth", "colspan", "rowspan", "_v", "id"]); // gộp ô: dùng lệnh Gộp / Tách của công cụ bảng (sửa số tay làm lệch bảng)
31
16
 
32
- const attrLabel = (name: string, spec: BlockAttrSpec, lang: "vi" | "en", translate?: (s: string) => string) =>
33
- spec.label ? (translate ? translate(spec.label) : spec.label) : ATTR_LABELS[name]?.[lang === "vi" ? 0 : 1] ?? name;
17
+ const attrLabel = (name: string, spec: BlockAttrSpec, lang: string, translate?: (s: string) => string) =>
18
+ spec.label ? (translate ? translate(spec.label) : spec.label) : attrName(name, lang) ?? name;
34
19
 
35
20
  function controlOf(spec: BlockAttrSpec): NonNullable<BlockAttrSpec["control"]> {
36
21
  if (spec.control) return spec.control;
@@ -58,7 +43,7 @@ function useChoices(kind: ChoiceKind | undefined, args: Record<string, string> |
58
43
  useEffect(() => {
59
44
  if (!kind) return;
60
45
  let alive = true;
61
- const fallback = kind === "imageSize" ? DEFAULT_IMAGE_SIZES.map(([v, vi, en]) => ({ value: String(v), label: labels.lang === "vi" ? vi : en })) : null;
46
+ const fallback = kind === "imageSize" ? DEFAULT_IMAGE_SIZES.map((v) => ({ value: String(v), label: imageSizeLabel(String(v), labels.lang) })) : null;
62
47
  if (!host.choices) { setState({ key, list: fallback }); return; }
63
48
  Promise.resolve(host.choices(kind, args)).then((list) => { if (alive) setState({ key, list: list?.length || !fallback ? list : fallback }); }, () => { if (alive) setState({ key, list: fallback }); });
64
49
  return () => { alive = false; };
@@ -83,12 +68,11 @@ function ChoiceField({ hint, attrs, value, set, label }: { hint: AttrHint; attrs
83
68
  const list = useChoices(hint.choice?.kind, hint.choice?.args?.(attrs));
84
69
  const v = value == null ? "" : String(value);
85
70
  if (list === null) return <input className="ecx-input" aria-label={label} value={v} onChange={(e) => set(e.target.value)} />;
86
- const vi = labels.lang === "vi";
87
71
  return (
88
72
  <select className="ecx-input" aria-label={label} value={v} disabled={list === undefined} onChange={(e) => set(e.target.value || undefined)}>
89
- <option value="">{list === undefined ? (vi ? "Đang tải…" : "Loading…") : vi ? "— Chọn —" : "— Select —"}</option>
73
+ <option value="">{list === undefined ? labels.choiceLoading : labels.choiceSelect}</option>
90
74
  {list?.map((c) => <option key={c.value} value={c.value}>{c.label}</option>)}
91
- {v && list && !list.some((c) => c.value === v) && <option value={v}>{v} {vi ? "(không còn)" : "(missing)"}</option>}
75
+ {v && list && !list.some((c) => c.value === v) && <option value={v}>{v} {labels.choiceMissing}</option>}
92
76
  </select>
93
77
  );
94
78
  }
@@ -104,20 +88,21 @@ export function AttrForm({ type, attrs, onChange }: { type: BlockType; attrs: Re
104
88
  return (
105
89
  <div className="ecx-form">
106
90
  {entries.map(([k, spec, hint]) => {
107
- const label = hint.label ? hint.label[lang === "vi" ? 0 : 1] : attrLabel(k, spec, lang, host.translate);
91
+ const label = hintText(hint, "label", lang) ?? attrLabel(k, spec, lang, host.translate);
108
92
  const value = attrs[k] ?? spec.default;
109
93
  const set = (v: unknown) => onChange({ [k]: v === "" || v === spec.default ? undefined : v });
110
- const help = hint.help && <span className="ecx-field-help">{hint.help[lang === "vi" ? 0 : 1]}</span>;
94
+ const helpText = hintText(hint, "help", lang);
95
+ const help = helpText && <span className="ecx-field-help">{helpText}</span>;
111
96
  const num = spec.type === "integer" || spec.type === "number";
112
97
  const opts = (): Array<[string, string]> => hint.options
113
- ? hint.options.map(([v, vi, en]) => [String(v), lang === "vi" ? vi : en])
98
+ ? hint.options.map((v) => [String(v), optionLabel(hint, v, lang)])
114
99
  : (spec.enum ?? []).map((v, i) => [String(v), spec.enumLabels?.[i] ? (host.translate?.(spec.enumLabels[i]) ?? spec.enumLabels[i]) : optionLabel(hint, v, lang)]);
115
100
  const parse = (v: string) => (v === "" ? undefined : num ? Number(v) : v);
116
101
  switch (hint.control ?? controlOf(spec)) {
117
102
  case "checkbox":
118
103
  return <div key={k}><label className="ecx-check"><input type="checkbox" checked={!!value} onChange={(e) => set(e.target.checked)} /> {label}</label>{help}</div>;
119
104
  case "newTab":
120
- return <label key={k} className="ecx-check"><input type="checkbox" checked={value === "_blank"} onChange={(e) => set(e.target.checked ? "_blank" : undefined)} /> {lang === "vi" ? "Mở trong tab mới" : "Open in new tab"}</label>;
105
+ return <label key={k} className="ecx-check"><input type="checkbox" checked={value === "_blank"} onChange={(e) => set(e.target.checked ? "_blank" : undefined)} /> {labels.openInNewTab}</label>;
121
106
  case "segmented":
122
107
  return <Field key={k} label={label} group><SegText label={label} value={value == null ? undefined : String(value)} options={opts()} onChange={(v) => set(v === undefined ? undefined : parse(v))} />{help}</Field>;
123
108
  case "select":