@@ -0,0 +1,15 @@
+---
+'@object-ui/app-shell': patch
+---
+
+feat(studio): a Chinese display name derives its identifier by pinyin at every Studio create door
+
+Clause-②: no
+Metadata-protocol: none
+
+A Chinese-speaking administrator names things in Chinese, and every Studio create door used to keep only Latin letters, so `维修中心` derived no identifier and the door waited for a hand-typed English one. Now each door that derives a machine name from a display name turns each Chinese word into its toneless pinyin first, then applies the rule it always applied: `维修中心` gives `weixiu_zhongxin` (a package id `com.<org>.weixiu-zhongxin` with the namespace `weixiu_zhongxin`), `客户等级` gives `kehu_dengji`. The derived identifier is shown and stays editable; the namespace prefix, the `__c` suffix of a customization pair and the taken-name refusal are unchanged.
+
+- **Doors.** New package, the new-item dialog (objects and the other Studio items), Add field (the name the popover previews is the name the field is created under), the generic create form, New view, the object, report and dataset designers' Name, a fresh field's API name in the field inspector, and a picklist option's value (a Chinese option label used to derive an empty value, and the option was silently never saved).
+- **Words, not syllables.** Word boundaries come from the browser's `Intl.Segmenter`, and a polyphone reads by its word (`银行` → `yinhang`, `行动` → `xingdong`). Without `Intl.Segmenter`, each character's reading is joined by `_` (`ke_hu_deng_ji`).
+- **Bundle.** The dictionary (`pinyin-pro`, the library the server's pinyin search already uses) is a lazy chunk, fetched the first time a door sees a Chinese character; until it lands the door keeps Create off without a "not derived" line, and if it cannot be fetched the door falls back to that line and a hand-typed identifier, as before.
+- **Japanese.** Text with kana is left alone, so a Japanese name still asks for the identifier.
@@ -95,6 +95,7 @@
     "@sentry/react": "^10.70.0",
     "jsonc-parser": "^3.3.1",
     "lucide-react": "^1.43.0",
+    "pinyin-pro": "^3.29.4",
     "qrcode": "^1.5.4",
     "sonner": "^2.0.8",
     "zod": "^4.6.5"
 
@@ -0,0 +1,39 @@
+// Copyright (c) 2026 ObjectStack. Licensed under the Apache-2.0 license.
+
+/**
+ * objectstack#29690 — the new-view dialog fills its machine name from a
+ * Chinese display label through the same pinyin rule as every Studio create
+ * door (`romanizeHan`), and the name stays editable. A Japanese label still
+ * derives nothing, so the dialog keeps asking for the key as before.
+ */
+
+import '@testing-library/jest-dom/vitest';
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { cleanup, fireEvent, render, screen } from '@testing-library/react';
+import { CreateViewDialog } from './CreateViewDialog';
+// The pinyin dictionary, resident before any case, as it is once a Console
+// door has fetched it.
+import { loadHanRomanizer } from './metadata-admin/romanizeHan';
+await loadHanRomanizer();
+
+afterEach(cleanup);
+
+const label = () => screen.getByTestId('create-view-name-input') as HTMLInputElement;
+const machineName = () => screen.getByTestId('create-view-machine-name-input') as HTMLInputElement;
+
+describe('CreateViewDialog — a Chinese label derives the view name by pinyin (objectstack#29690)', () => {
+  it('fills kehu_liebiao from 客户列表, and a typed name stops following the label', () => {
+    render(<CreateViewDialog open onOpenChange={() => {}} onCreate={vi.fn()} />);
+    fireEvent.change(label(), { target: { value: '客户列表' } });
+    expect(machineName().value).toBe('kehu_liebiao');
+    fireEvent.change(machineName(), { target: { value: 'customer_list' } });
+    fireEvent.change(label(), { target: { value: '重点客户列表' } });
+    expect(machineName().value).toBe('customer_list');
+  });
+
+  it('CONTROL — a Japanese label derives nothing and the name is asked for', () => {
+    render(<CreateViewDialog open onOpenChange={() => {}} onCreate={vi.fn()} />);
+    fireEvent.change(label(), { target: { value: 'カスタマー' } });
+    expect(machineName().value).toBe('');
+  });
+});
@@ -12,9 +12,10 @@
  * gates it.
  * Step 3: The user enters a display label (required, defaults to "Grid 1" etc.)
  * and a machine `name` (the metadata key). The name auto-fills from the label
- * via `slugify`; for non-Latin (CJK/…) labels slugify yields nothing, so the
- * field is left empty and the user must type a key before Create enables
- * (#2767 P5 — no more silent random names).
+ * via `slugify`, a Chinese label through its pinyin first (`romanizeHan`:
+ * `客户等级` → `kehu_dengji`); for a label that still yields nothing (a
+ * Japanese one, say) the field is left empty and the user must type a key
+ * before Create enables (#2767 P5 — no more silent random names).
  *
  * On submit, calls `onCreate({ type, label, name, [type]: {...picked config} })`
  * and waits for it: the dialog closes only when the save resolves `true`, and
@@ -49,6 +50,7 @@ import {
 import { useObjectTranslation } from '@object-ui/i18n';
 import type { ListViewVisualization } from '@object-ui/core';
 import { slugify } from './metadata-admin/createDerive.js';
+import { romanizeHan, useHanRomanizer } from './metadata-admin/romanizeHan.js';
 import { datasetOptionLabel, useObjectDatasetBinding } from './studio-design/objectDatasets.js';
 import {
   deriveFieldOptions,
@@ -518,12 +520,15 @@ export function CreateViewDialog({
     }
   }, [selectedType, touched, types, existingSet]);
 
-  // Derive the machine name from the label until the user edits it. slugify
-  // returns '' for non-Latin labels, so the field stays empty and the user is
-  // prompted to fill it in (rather than a silent random key — #2767 P5).
+  // Derive the machine name from the label until the user edits it. A Chinese
+  // label derives through its pinyin, re-deriving when the dictionary lands
+  // (`romanizerVersion`); a label that still yields '' leaves the field empty
+  // and the user is prompted to fill it in (rather than a silent random key —
+  // #2767 P5).
+  const romanizerVersion = useHanRomanizer(label);
   useEffect(() => {
-    if (!nameTouched) setName(slugify(label));
-  }, [label, nameTouched]);
+    if (!nameTouched) setName(slugify(romanizeHan(label)));
+  }, [label, nameTouched, romanizerVersion]);
 
   // Required fields for the currently selected type
   const requiredFields = REQUIRED_FIELDS_BY_TYPE[selectedType] ?? [];
 
@@ -152,17 +152,18 @@ describe('Create stays disabled until the id, name, namespace and version valida
 
   it('a name that derives no id disables Create and the id says why', () => {
     const f = openCreate();
-    fireEvent.change(f.name(), { target: { value: '工单中心' } });
+    // A Japanese name: a Chinese one derives through its pinyin (objectstack#29690).
+    fireEvent.change(f.name(), { target: { value: 'チケットセンター' } });
     expect(f.id().value).toBe('');
     expect(f.submit()).toBeDisabled();
     expect(screen.getByTestId('package-form-id-missing')).toBeInTheDocument();
   });
 
   // objectui#13389 — the line names the cause, and the "filled in from the
   // display name" mark does not sit over an empty box.
-  it('a name with no Latin letters says the id could not be made from it, with no filled-in mark', () => {
+  it('a name that yields no id segment says the id could not be made from it, with no filled-in mark', () => {
     const f = openCreate();
-    fireEvent.change(f.name(), { target: { value: '体验评审' } });
+    fireEvent.change(f.name(), { target: { value: 'レビュー' } });
     expect(screen.getByTestId('package-form-id-missing')).toHaveTextContent(
       tFormat('engine.packages.idRule.notDerived', 'en-US', { example: 'com.acme.crm' }),
     );
 
@@ -27,6 +27,10 @@ import { t } from './i18n';
 // Resident before any case, so the zh rows below read synchronously.
 import { loadStudioCatalogue } from '@object-ui/i18n/namespaces/studio';
 await loadStudioCatalogue('zh');
+// The pinyin dictionary a Chinese name derives through, resident before any
+// case, as it is once a Console door has fetched it (objectstack#29690).
+import { loadHanRomanizer } from './romanizeHan';
+await loadHanRomanizer();
 
 let localeFixture: 'en-US' | 'zh-CN' = 'en-US';
 vi.mock('./i18n', async (importOriginal) => ({
@@ -124,9 +128,11 @@ describe('New package — the id follows the display name (objectui#11792)', ()
     expect(f.ns().value).toBe('tickets');
   });
 
+  // objectstack#29690 — a Chinese name derives (last block); a Japanese one
+  // is the name that still yields no segment.
   it('leaves the id empty when the name yields no id segment, and does not submit', () => {
     const f = openCreate();
-    fireEvent.change(f.name(), { target: { value: '报修中心' } });
+    fireEvent.change(f.name(), { target: { value: 'サポートセンター' } });
     expect(f.id().value).toBe('');
     expect(f.submit()).toBeDisabled();
   });
@@ -214,3 +220,34 @@ describe('Edit and view keep the spec form’s id field (objectui#11792)', () =>
     expect(Object.keys(JSON.parse(calls[0].init.body as string)).sort()).toEqual(['description', 'name', 'version']);
   });
 });
+
+describe('New package — a Chinese name derives the id and namespace by pinyin (objectstack#29690)', () => {
+  it('fills com.<org>.<pinyin> and the namespace from it, and Create posts them', async () => {
+    orgFixture = { id: 'org_1', name: 'Acme Inc', slug: 'acme' };
+    localeFixture = 'zh-CN';
+    const f = openCreate();
+    fireEvent.change(f.name(), { target: { value: '维修中心' } });
+    expect(f.id().value).toBe('com.acme.weixiu-zhongxin');
+    expect(isSpecId(f.id().value)).toBe(true);
+    expect(f.ns().value).toBe('weixiu_zhongxin');
+    expect(screen.queryByTestId('package-form-id-missing')).toBeNull();
+    fireEvent.click(f.submit());
+    await waitFor(() => expect(f.onSaved).toHaveBeenCalledTimes(1));
+    expect(JSON.parse(calls[0].init.body as string).manifest).toMatchObject({
+      id: 'com.acme.weixiu-zhongxin',
+      name: '维修中心',
+      namespace: 'weixiu_zhongxin',
+    });
+  });
+
+  it('the derived id stays editable, and an edited one stops following the name', () => {
+    localeFixture = 'zh-CN';
+    const f = openCreate();
+    fireEvent.change(f.name(), { target: { value: '客户等级' } });
+    expect(f.id().value).toBe('com.kehu-dengji');
+    fireEvent.change(f.id(), { target: { value: 'com.example.tiers' } });
+    fireEvent.change(f.name(), { target: { value: '客户等级管理' } });
+    expect(f.id().value).toBe('com.example.tiers');
+    expect(f.ns().value).toBe('tiers');
+  });
+});
@@ -153,7 +153,8 @@ describe('the first step asks only for a name (objectstack#27833)', () => {
 
   it('a name that derives no id opens Advanced by itself, at the line that says why', () => {
     const f = openCreate();
-    fireEvent.change(f.name(), { target: { value: '工单中心' } });
+    // A Japanese name: a Chinese one derives through its pinyin (objectstack#29690).
+    fireEvent.change(f.name(), { target: { value: 'チケットセンター' } });
 
     expect(f.submit()).toBeDisabled();
     expect(f.toggle()).toHaveAttribute('aria-expanded', 'true');
 
@@ -60,6 +60,7 @@ import { SchemaForm, type SchemaFormIssue } from './SchemaForm.js';
 import type { FormFieldSpec, FormViewSpec } from './form-spec.js';
 import { getPackageSchema, getPackageForm } from './package-schema.js';
 import { PackageDependenciesEditor, type DependencyMap } from './PackageDependenciesEditor.js';
+import { romanizeHan, romanizerPending, useHanRomanizer } from './romanizeHan.js';
 import { readEnvelopeFailureText } from '../../utils/apiErrorEnvelope.js';
 
 const API = '/api/v1/packages';
@@ -222,9 +223,13 @@ function toIdSegment(raw: string): string {
  * The candidate is checked against the spec before it is offered, so a
  * derivation never puts an id in the field that the dialog itself refuses.
  * `null` when the name yields no segment at all.
+ *
+ * A Chinese name derives through its pinyin (`romanizeHan`): `维修中心` gives
+ * the segment `weixiu-zhongxin`, so `com.<org>.weixiu-zhongxin`, and the
+ * namespace follows that id as it follows any other.
  */
 function deriveCreatePackageId(name: string, orgSlug: string | null | undefined): string | null {
-  const nameSegment = toIdSegment(name);
+  const nameSegment = toIdSegment(romanizeHan(name));
   if (!nameSegment) return null;
   const orgSegment = orgSlug ? toIdSegment(orgSlug) : '';
   const candidate = ['com', orgSegment, nameSegment].filter(Boolean).join('.');
@@ -481,9 +486,13 @@ export function PackageFormDialog({
     });
   }, []);
 
+  // The pinyin dictionary a Chinese name derives through loads on first use;
+  // the version it hands back moves when it lands, re-deriving below.
+  const romanizerVersion = useHanRomanizer(String(draft.name ?? ''));
+
   // The active organization can arrive after the author has typed the name
-  // (the session's organization list loads on its own schedule); an id still
-  // following the name picks the segment up then.
+  // (the session's organization list loads on its own schedule), and so can
+  // the pinyin dictionary; an id still following the name picks either up then.
   React.useEffect(() => {
     if (!open || !createMode) return;
     setForm((prev) => {
@@ -495,7 +504,7 @@ export function PackageFormDialog({
       const namespace = t.namespace ? was.namespace : (deriveNamespaceFromPackageId(id) ?? '');
       return { draft: { ...was, id, namespace }, touched: t };
     });
-  }, [open, createMode, orgSlug]);
+  }, [open, createMode, orgSlug, romanizerVersion]);
 
   // The help line SchemaForm would have shown under the id: the localized row
   // when there is one, else the spec's own `.describe()` (see package-schema).
@@ -531,17 +540,25 @@ export function PackageFormDialog({
   // (a CJK-only name), an id that derived no namespace, or the author
   // clearing the field.
   const idStr = String(draft.id ?? '').trim();
-  const idMissing = createMode && !idStr && (touched.id || nameOk);
-  // objectui#13389 — the display name is there but holds no Latin letter to
-  // make an id from (a Chinese name, say): say that, rather than the "filled
-  // in from the display name" line over an empty box.
+  // A Chinese name whose pinyin dictionary is still loading: its id is about
+  // to be derived, so no row may say it is missing yet.
+  const idPending = createMode && !touched.id && romanizerPending(String(draft.name ?? ''));
+  const idMissing = createMode && !idStr && (touched.id || nameOk) && !idPending;
+  // objectui#13389 — the display name is there but yields nothing to make an
+  // id from (a Japanese name, say): say that, rather than the "filled in from
+  // the display name" line over an empty box.
   const idNotDerived =
-    createMode && !touched.id && !idStr && nameOk && !toIdSegment(String(draft.name ?? ''));
+    createMode &&
+    !touched.id &&
+    !idStr &&
+    nameOk &&
+    !idPending &&
+    !toIdSegment(romanizeHan(String(draft.name ?? '')));
   const nsMissing =
     createMode && !String(draft.namespace ?? '').trim() && (touched.namespace || !!idStr);
   // objectstack#27833 — once a name is in, every other create gate is a row
   // behind Advanced (id, namespace, version), so a failing one opens it.
-  const advancedNeeded = createMode && nameOk && !(idOk && nsOk && versionOk);
+  const advancedNeeded = createMode && nameOk && !idPending && !(idOk && nsOk && versionOk);
   const showAdvanced = advancedOpen || advancedNeeded;
 
   const createForms = React.useMemo(
 
@@ -4,8 +4,9 @@
  * objectstack#28369 — the create form's summary banner states Name's identifier
  * errors in the reader's locale, and wraps them instead of cutting them.
  *
- * A zh-CN administrator who types an all-Chinese label into a new permission
- * set leaves Name empty, and `SnakeCaseIdentifierSchema` refuses it twice
+ * A zh-CN administrator who types a label that derives no identifier into a
+ * new permission set (a Japanese one: since objectstack#29690 a Chinese label
+ * derives its name by pinyin) leaves Name empty, and `SnakeCaseIdentifierSchema` refuses it twice
  * (`.min(2)` and `.regex`). Those messages are the spec's, in English, and stay
  * so; the Console picks the reader's-locale text by the issue's code and
  * pattern, never by reading the English:
@@ -116,15 +117,15 @@ afterEach(() => {
   cleanup();
 });
 
-/** Opens a new permission set and types an all-Chinese label; Name stays empty. */
-async function bannerLinesForChineseLabel(): Promise<HTMLElement[]> {
+/** Opens a new permission set and types a Japanese label; Name stays empty. */
+async function bannerLinesForUnderivableLabel(): Promise<HTMLElement[]> {
   render(
     <MemoryRouter initialEntries={['/metadata/permission/new']}>
       <MetadataResourceEditPage type="permission" name="" createMode />
     </MemoryRouter>,
   );
   const labelBox = (await screen.findByRole('textbox', { name: /^(Label|标签)/ }, { timeout: 8000 })) as HTMLInputElement;
-  fireEvent.change(labelBox, { target: { value: '销售运营' } });
+  fireEvent.change(labelBox, { target: { value: 'セールス' } });
   const banner = await screen.findByTestId('metadata-validation-banner', {}, { timeout: 8000 });
   await waitFor(() => expect(banner.querySelectorAll('[data-testid="metadata-diagnostics-item"]').length).toBeGreaterThanOrEqual(2));
   return Array.from(banner.querySelectorAll<HTMLElement>('[data-testid="metadata-diagnostics-item"]'));
@@ -139,21 +140,21 @@ describe('the create banner states identifier issues in the reader’s locale (o
   });
 
   it('(a) zh-CN: both Name lines are Chinese, and no line carries the spec’s English', async () => {
-    const lines = (await bannerLinesForChineseLabel()).map((li) => li.textContent ?? '');
+    const lines = (await bannerLinesForUnderivableLabel()).map((li) => li.textContent ?? '');
     expect(lines.some((l) => l.includes(ZH_TOO_SHORT))).toBe(true);
     expect(lines.some((l) => l.includes(ZH_SNAKE))).toBe(true);
     for (const en of SNAKE_EN) expect(lines.some((l) => l.includes(en))).toBe(false);
   });
 
   it('(b) CONTROL en-US: the banner shows the spec’s own sentences', async () => {
     localeFixture = 'en-US';
-    const lines = (await bannerLinesForChineseLabel()).map((li) => li.textContent ?? '');
+    const lines = (await bannerLinesForUnderivableLabel()).map((li) => li.textContent ?? '');
     for (const en of SNAKE_EN) expect(lines.some((l) => l.includes(en))).toBe(true);
     expect(lines.some((l) => l.includes(ZH_SNAKE))).toBe(false);
   });
 
   it('(c) the banner lines wrap instead of cutting the message', async () => {
-    const lines = await bannerLinesForChineseLabel();
+    const lines = await bannerLinesForUnderivableLabel();
     for (const li of lines) {
       expect(li.className.split(/\s+/)).not.toContain('truncate');
       expect(li.className.split(/\s+/)).toContain('whitespace-normal');