@@ -0,0 +1,10 @@
+---
+'@object-ui/plugin-tree': patch
+---
+
+fix(plugin-tree): the object tree's loading and empty placeholders speak the page's language
+
+Clause-②: no
+Metadata-protocol: none
+
+`object-tree` drew its loading line and its empty line as the English literals `Loading…` and `No records`, so a zh-CN page showed English in the middle of a localized view. Both now read the bundle, `common.loading` and `common.noData`, the same keys the repeater and record-picker elements read for their own placeholders. A zh-CN page now reads 加载中… and 暂无数据, and English reads `Loading…` and `No data` (the empty line used to say `No records`). The `object-tree` contract declares no empty-text key, so there is no authored text to override these.
@@ -35,7 +35,7 @@
  * on PRs that cannot reach `plugin-tree` at all — `expected 1 to be 2`.
  *
  * That wait was `container.querySelector('[data-testid="object-tree"]') ??
- * queryByText('No records')`, and the row count was read the instant it passed.
+ * queryByText('No data')`, and the row count was read the instant it passed.
  * The testid is on the TABLE WRAPPER, so it is a MOUNT signal, not a rows
  * signal — and the rows this file counts arrive at a LATER commit than the
  * table does.
@@ -73,7 +73,7 @@
  *     count alone is also satisfied by a tree that flattens everything.
  *   - the REFUSAL arm cannot wait for an absence, so it takes a SETTLED read
  *     anchored on something that DOES appear in that scenario: the tree's own
- *     "No records" panel, which `ObjectTree` renders only once `loading` has
+ *     "No data" panel, which `ObjectTree` renders only once `loading` has
  *     flipped false. Probed on the `records` fixture the sequence is
  *     `loading → empty-state` with no table at any point, and the panel is
  *     absent while loading — so this arm cannot pass by timing out on an
@@ -173,14 +173,14 @@ function drawnRows(container: HTMLElement): DrawnRow[] {
 }
 
 /**
- * Has the tree drawn its own "No records" panel?
+ * Has the tree drawn its own "No data" panel?
  *
  * ⚠️ `queryAllByText`, not `queryByText`: the singular form THROWS on multiple
  * matches as well as answering `null` on none, so it cannot express "how many"
  * without the throw becoming the result.
  */
 function emptyPanelDrawn(container: HTMLElement): boolean {
-  return within(container).queryAllByText('No records').length > 0;
+  return within(container).queryAllByText('No data').length > 0;
 }
 
 function readSettled(container: HTMLElement): Settled {
@@ -246,14 +246,14 @@ async function settledOn(envelope: Envelope, outcome: Outcome): Promise<Settled>
   if ('refuses' in outcome) {
     // A refusal has no arrival to wait for, so this is a SETTLED read built
     // from the two things that CAN be observed: `find` has answered (above),
-    // and the tree has drawn the "No records" panel — a node it renders only
+    // and the tree has drawn the "No data" panel — a node it renders only
     // after `loading` flips false, so it is a COMPLETION ANCHOR and not the
     // mere passage of time. `act` then flushes what React still had queued; it
     // is the opposite of widening a timeout.
     await waitFor(() =>
       expect(
         emptyPanelDrawn(container),
-        'the tree must have drawn its own "No records" panel before it is read — without that anchor an absence assertion passes by timing out',
+        'the tree must have drawn its own "No data" panel before it is read — without that anchor an absence assertion passes by timing out',
       ).toBe(true),
     );
     await act(async () => {});
@@ -304,12 +304,12 @@ describe('ObjectTree — the find() envelope it reads (objectui#6839)', () => {
   it('does NOT read `records` — not a QueryResult member', async () => {
     // Before the fix these two nodes drew off a key `QueryResult` does not
     // declare, and did so AHEAD of `data`. The tree now settles on its own
-    // "No records" panel — a DIFFERENT node from the table, which is what makes
+    // "No data" panel — a DIFFERENT node from the table, which is what makes
     // this a reading of the refusal rather than of a mount that never happened.
     const settled = await settledOn(asRecords, REFUSES);
     expect(
       settled.emptyPanelDrawn,
-      'the refusal must be OBSERVED: the tree drew its "No records" panel',
+      'the refusal must be OBSERVED: the tree drew its "No data" panel',
     ).toBe(true);
     expect(
       settled.rows,
 
@@ -43,7 +43,7 @@
  *
  * ## The outcome, named — the same one `object-map` and `object-gantt` give
  *
- * A bare array under `data` draws nothing (`No records`) when the node names
+ * A bare array under `data` draws nothing (`No data`) when the node names
  * no object, and the tree queries its `objectName` instead when it does — the
  * ladder falls through to rung 2, then rung 3. In a development build
  * `SchemaRenderer` says so once, naming the key and the spelling that works;
@@ -164,7 +164,7 @@ describe('object-tree honours only the `data` arm its published row declares (ob
     renderNode({ ...BASE, id: 't2', data: AUTHORED }, ds);
 
     expect(await drawn()).toEqual([]);
-    expect(screen.getByText('No records')).toBeTruthy();
+    expect(screen.getByText('No data')).toBeTruthy();
     expect(ds.find).not.toHaveBeenCalled();
     expect(refusalWarningsFor(warn, 'object-tree')).toHaveLength(1);
   });
 
@@ -156,7 +156,7 @@ function snapshot(container: HTMLElement): string {
   if (!container.querySelector('[data-testid="object-tree"]')) {
     const text = container.textContent ?? '';
     if (text.includes('Loading')) return 'loading';
-    if (text.includes('No records')) return 'empty';
+    if (text.includes('No data')) return 'empty';
     return 'nothing';
   }
   return `table:${drawnRows(container).length}rows`;
 
@@ -0,0 +1,103 @@
+/**
+ * ObjectUI
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+/**
+ * `ObjectTree`'s loading and empty placeholders speak the session locale: they
+ * read the bundle's `common.loading` / `common.noData`, the pair the sibling
+ * renderers (`element:repeater`, `element:record_picker`) read for theirs.
+ *
+ * The zh cases are the ones that were red while the two placeholders were the
+ * English literals `Loading…` / `No records`. The en cases pin the English the
+ * `en` pack spells for the same keys.
+ *
+ * The provider-less path (the factory's English defaults table) is held by the
+ * package's other tests, which render without an `I18nProvider` and read the
+ * same English strings.
+ */
+
+import React from 'react';
+import { describe, it, expect, vi, afterEach } from 'vitest';
+import { render, screen, cleanup, waitFor } from '@testing-library/react';
+import '@testing-library/jest-dom';
+import { I18nProvider } from '@object-ui/i18n';
+import { ObjectTree } from './ObjectTree';
+
+/** A data source whose `find` answers `rows`, or never answers when `rows` is null. */
+function makeDataSource(rows: Array<Record<string, unknown>> | null) {
+  return {
+    find: vi.fn(
+      (_object: string, _query?: unknown) =>
+        rows === null
+          ? new Promise<never>(() => {})
+          : Promise.resolve({ data: rows, total: rows.length }),
+    ),
+    findOne: vi.fn(),
+    create: vi.fn(),
+    update: vi.fn(),
+    delete: vi.fn(),
+    getObjectSchema: vi.fn(async (object: string) => ({
+      name: object,
+      fields: { name: { type: 'text' }, parent_id: { type: 'text' } },
+    })),
+  };
+}
+
+function renderTreeIn(language: string, ds: ReturnType<typeof makeDataSource>) {
+  return render(
+    <I18nProvider config={{ defaultLanguage: language, detectBrowserLanguage: false }}>
+      <ObjectTree
+        schema={{
+          type: 'object-tree',
+          objectName: 'category',
+          parentField: 'parent_id',
+          labelField: 'name',
+        } as never}
+        dataSource={ds as never}
+      />
+    </I18nProvider>,
+  );
+}
+
+afterEach(() => {
+  cleanup();
+});
+
+describe('ObjectTree placeholders read the bundle', () => {
+  it('draws the zh loading line while its read is pending', async () => {
+    const ds = makeDataSource(null);
+    renderTreeIn('zh', ds);
+    await waitFor(() => expect(ds.find).toHaveBeenCalled());
+
+    expect(screen.getByText('加载中…')).toBeInTheDocument();
+    expect(screen.queryByText('Loading…')).toBeNull();
+  });
+
+  it('draws the zh empty line for an empty result', async () => {
+    const ds = makeDataSource([]);
+    renderTreeIn('zh', ds);
+
+    expect(await screen.findByText('暂无数据')).toBeInTheDocument();
+    expect(screen.queryByText('No records')).toBeNull();
+    expect(screen.queryByText('No data')).toBeNull();
+  });
+
+  it('draws the en loading line while its read is pending', async () => {
+    const ds = makeDataSource(null);
+    renderTreeIn('en', ds);
+    await waitFor(() => expect(ds.find).toHaveBeenCalled());
+
+    expect(screen.getByText('Loading…')).toBeInTheDocument();
+  });
+
+  it('draws the en empty line for an empty result', async () => {
+    const ds = makeDataSource([]);
+    renderTreeIn('en', ds);
+
+    expect(await screen.findByText('No data')).toBeInTheDocument();
+  });
+});
@@ -109,6 +109,12 @@ const TREE_DEFAULT_TRANSLATIONS: Record<string, string> = {
   // pack. This control is a tree-GRID — a table of rows re-read in place — so
   // it takes the name `ObjectGrid` gives the very same bar.
   'grid.refreshing': 'Refreshing…',
+  // The loading and empty placeholders read the bundle's `common.*` pair, the
+  // keys the sibling renderers (`element:repeater`, `element:record_picker`)
+  // read for theirs, so a zh-CN page never shows English here. The object-tree
+  // contract declares no empty-text key, so nothing authored overrides them.
+  'common.loading': 'Loading…',
+  'common.noData': 'No data',
 };
 
 const useTreeTranslation = createSafeTranslation(
@@ -1157,8 +1163,9 @@ export const ObjectTree: React.FC<ObjectTreeProps> = ({
     onRowClick,
   });
 
-  // Heading of the record-detail overlay rendered at the bottom of this file.
-  // Must stay above the conditional returns below — rules-of-hooks.
+  // The placeholders below and the record-detail overlay heading rendered at
+  // the bottom of this file. Must stay above the conditional returns below —
+  // rules-of-hooks.
   const { t } = useTreeTranslation();
 
   if (error) {
@@ -1181,15 +1188,15 @@ export const ObjectTree: React.FC<ObjectTreeProps> = ({
   if (records === null || (loading && records.length === 0)) {
     return (
       <div className={cn('flex items-center justify-center h-40 text-muted-foreground', className)}>
-        <p>Loading…</p>
+        <p>{t('common.loading')}</p>
       </div>
     );
   }
 
   if (records.length === 0) {
     return (
       <div className={cn('flex items-center justify-center h-40 text-muted-foreground', className)}>
-        <p>No records</p>
+        <p>{t('common.noData')}</p>
       </div>
     );
   }
 
@@ -317,7 +317,7 @@ describe('`object-tree.data` — the members are the `{ provider, … }` configu
     expect(specRow.safeParse({ data }).success, 'the spec row accepts the configuration').toBe(true);
     const ds = mount({ tree: TREE, data });
     expect(await drawn()).toEqual([]);
-    expect(screen.getByText('No records')).toBeInTheDocument();
+    expect(screen.getByText('No data')).toBeInTheDocument();
     expect(ds.find).not.toHaveBeenCalled();
   });
 
@@ -329,7 +329,7 @@ describe('`object-tree.data` — the members are the `{ provider, … }` configu
     expect(specRow.safeParse({ data }).success, 'the spec row refuses the retired provider').toBe(false);
     const ds = mount({ tree: TREE, data });
     expect(await drawn()).toEqual([]);
-    expect(screen.getByText('No records')).toBeInTheDocument();
+    expect(screen.getByText('No data')).toBeInTheDocument();
     expect(ds.find).not.toHaveBeenCalled();
   });
Original file line number	Diff line number	Diff line change
`@@ -156,7 +156,7 @@ function snapshot(container: HTMLElement): string {`
`156`	`156`	`if (!container.querySelector('[data-testid="object-tree"]')) {`
`157`	`157`	`const text = container.textContent ?? '';`
`158`	`158`	`if (text.includes('Loading')) return 'loading';`
`159`		`- if (text.includes('No records')) return 'empty';`
	`159`	`+ if (text.includes('No data')) return 'empty';`
`160`	`160`	`return 'nothing';`
`161`	`161`	`}`
`162`	`162`	return `table:${drawnRows(container).length}rows`;