@iyulab/flex-table 0.35.0 → 0.36.0

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## [0.36.0] - 2026-09-17
+
+### Added
+
+- **The table's own chrome text now goes through a locale namespace.** The filter menus, the
+  find-and-replace panel, the column menu and the empty-state message were written in English in the
+  source, so an application translated into another language showed thirty-one English strings in
+  the middle of its own UI — "Contains", "Starts with", "Match case", "Replace all" and the rest.
+  `flexTableLocale` is exported for consumers to register further languages or reword the built-in
+  ones:
+
+  ```ts
+  import { flexTableLocale } from '@iyulab/flex-table';
+  flexTableLocale.register('ja', { contains: '含む', startsWith: '前方一致' });
+  ```
+
+  English and Korean ship with the package; other languages are added the same way. The filter
+  operators `AND` and `OR`, and the glyphs standing in for icons, are deliberately left alone —
+  they read the same in every language and translating them makes them harder to recognise.
+
+### Changed
+
+- The package compiles against `ESNext` rather than `ES2021`, matching every sibling package in the
+  same family.
 ## [0.35.0] - 2026-09-15
 
 ### Changed

package/README.md

@@ -409,6 +409,46 @@ package dependency; CSS custom properties are resolved at render time, not impor
 | ArrowUp / ArrowDown / Home / End (column menu) | Move between menu items |
 | Escape (column menu) | Close the menu and return focus to its button |
 
+## Localization
+
+The text the table draws itself — filter menus, the find-and-replace panel, the column menu, the
+empty-state message — resolves through a locale namespace. English and Korean ship with the package
+and follow whatever locale `@iyulab/components` has active:
+
+```ts
+import { Locale } from '@iyulab/components';
+
+Locale.set('ko');   // the table's own chrome follows
+```
+
+Register another language, or reword the built-in strings, through the exported namespace. Partial
+tables are merged, so you only pass the keys you want to change:
+
+```ts
+import { flexTableLocale, type FlexTableMessageKey } from '@iyulab/flex-table';
+
+flexTableLocale.register('ja', {
+  contains: '含む',
+  startsWith: '前方一致',
+  matchCase: '大文字と小文字を区別',
+});
+
+flexTableLocale.register('en', { replaceAll: 'Replace everything' });  // reword one string
+```
+
+Keys cover the column header and menu (`showHiddenColumns`, `columnMenu`, `cellActions`,
+`noColumnsDefined`), cell comments (`addCommentPlaceholder`, `cancel`, `save`), the filter panel
+(`clear`, `blankCells`, `emptyOnly`, `nonEmptyOnly`, `blankAll`, `all`, `contains`, `startsWith`,
+`endsWith`, `wildcard`, `searchPlaceholder`, `valuePlaceholder`, `fromPlaceholder`,
+`toPlaceholder`) and find-and-replace (`findPlaceholder`, `findPrevious`, `findNext`, `matchCase`,
+`wholeCell`, `closeFind`, `replaceWithPlaceholder`, `replace`, `replaceAll`). `FlexTableMessageKey`
+is exported, so a missing or misspelled key is a type error rather than a string that silently falls
+back to its own name.
+
+The filter operators `AND` and `OR` are not in the table, and neither are the glyphs that stand in
+for icons. They read the same in every language, and translating them makes them harder to
+recognise rather than easier.
+
 ## Accessibility
 
 The baseline is **WCAG 2.2**. The table lists what this package **measures in tests** — it is not a