hap-cli 0.9.12__tar.gz → 0.9.13__tar.gz

{hap_cli-0.9.12 → hap_cli-0.9.13}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hap-cli
-Version: 0.9.12
+Version: 0.9.13
 Summary: CLI harness for Mingdao HAP - Enterprise no-code platform
 Author: hap-cli
 License: Apache-2.0

{hap_cli-0.9.12 → hap_cli-0.9.13}/hap_cli/__init__.py

@@ -3,7 +3,7 @@
 import sys as _sys
 import types as _types
 
-__version__ = "0.9.12"
+__version__ = "0.9.13"
 
 # The command tree used to live in hap_cli/hap_cli.py. A module named
 # after the package it sits in shadows that package: run python with the

{hap_cli-0.9.12 → hap_cli-0.9.13}/hap_cli/core/app_creator/charts.py

@@ -64,8 +64,12 @@ _DISPLAY_SETUP = {
 # render (WO-1) lives in core. This module used to hold its own copy —
 # identical apart from `ignoreToday`, which core now carries too (WO-5).
 from hap_cli.core.chart import DEFAULT_CHART_FILTER as _FILTER
+from hap_cli.core.chart import default_chart_filter
+from hap_cli.i18n import content_default
 
-_SUMMARY = {"controlId": "", "type": 1, "name": "总计", "number": True,
+# ``name`` is left empty: saving the chart fills in the total's label in
+# the CLI's language (core.chart._fill_summary_name).
+_SUMMARY = {"controlId": "", "type": 1, "name": "", "number": True,
             "percent": False, "sum": 0, "contrastSum": 0, "contrastMapSum": 0, "rename": ""}
 
 _EMPTY_XAXES = {
@@ -82,7 +86,8 @@ def _yaxis(metric: dict[str, Any], resolve: Callable[[str], dict[str, Any]]) ->
     field == 'count' -> the special record-count pseudo column."""
     agg = metric.get("aggregate", "sum")
     if metric["field"] == "count":
-        cid, cname, ctype = "record_count", "记录数量", 10000000
+        cid, cname, ctype = ("record_count", content_default("chart.recordCount"),
+                             10000000)
         norm = NORM_TYPE.get(agg, 5)
     else:
         c = resolve(metric["field"])
@@ -183,7 +188,7 @@ def _right_y(metrics: list[dict[str, Any]], report_type_int: int,
     title = ""
     if metrics:
         m0 = metrics[0]
-        title = ("记录数量" if m0["field"] == "count"
+        title = (content_default("chart.recordCount") if m0["field"] == "count"
                  else resolve(m0["field"]).get("controlName") or m0["field"])
     return {
         "reportType": report_type_int,
@@ -238,7 +243,7 @@ def chart_spec(
     # ``limit`` on the chart maps straight to it.
     if chart.get("limit") is not None:
         display["showXAxisCount"] = int(chart["limit"])
-    filt = dict(_FILTER)
+    filt = default_chart_filter()
     if filters:
         filt["filter"] = None  # filters supplied via items below
     spec: dict[str, Any] = {
@@ -250,7 +255,8 @@ def chart_spec(
         "filter": filt,
         "sorts": [], "formulas": [], "summary": dict(_SUMMARY), "style": {},
         "split": {}, "splitId": None, "sourceType": 1, "auth": 1, "isPublic": True,
-        "views": [{"viewId": view_id, "name": "全部", "viewType": 0}],
+        "views": [{"viewId": view_id, "name": content_default("view.all"),
+                   "viewType": 0}],
         "desc": "",
     }
     if is_pivot:

{hap_cli-0.9.12 → hap_cli-0.9.13}/hap_cli/core/app_creator/steps.py

@@ -27,6 +27,7 @@ from hap_cli.core.app_creator import hap
 from hap_cli.core.app_creator import workflow_dsl as WD
 from hap_cli.core.app_creator.errors import PartialStepFailure, ResolveError
 from hap_cli.core.app_creator.store import Store
+from hap_cli.i18n import DEFAULT_VIEW_NAMES
 
 logger = logging.getLogger("hap_app_creator.steps")
 
@@ -822,7 +823,7 @@ def _builtin_all_view_id(wsid: str) -> str:
     views = data if isinstance(data, list) else (
         (data or {}).get("views") or (data or {}).get("data") or [])
     for v in views:
-        if v.get("name") in ("全部", "All") and v.get("viewType", 0) == 0:
+        if v.get("name") in DEFAULT_VIEW_NAMES and v.get("viewType", 0) == 0:
             return v.get("viewId") or v.get("id") or ""
     return ""
 
@@ -1393,7 +1394,7 @@ def _default_view_id(wsid: str) -> str:
     if not views:
         return ""
     for v in views:
-        if v.get("name") == "全部":
+        if v.get("name") in DEFAULT_VIEW_NAMES:
             return v.get("viewId") or v.get("id") or ""
     return views[0].get("viewId") or views[0].get("id") or ""
 

{hap_cli-0.9.12 → hap_cli-0.9.13}/hap_cli/core/app_creator/workflow_dsl.py

@@ -24,6 +24,8 @@ from __future__ import annotations
 import re
 from typing import Any
 
+from hap_cli.i18n import DEFAULT_VIEW_NAMES, content_default
+
 # Field-ref string convention: "工作表名/字段名". System columns and ids pass
 # through verbatim.
 _SYSTEM_FIELDS = {"rowid", "ownerid", "caid", "ctime", "utime", "uaid"}
@@ -249,12 +251,20 @@ def _option_object(control: dict[str, Any], value: Any):
     return [_one(v) for v in value] if isinstance(value, list) else _one(value)
 
 
-# Approval-outcome keys (审批结果) for an approval_block result branch.
+# Approval-outcome keys (审批结果) for an approval_block result branch:
+# what an author may write (key or Chinese label) → the outcome key.
 _APPROVAL_RESULTS = {
-    "PASS": "通过", "通过": "通过",
-    "OVERRULE": "否决", "否决": "否决",
-    "REVOKE": "撤回", "撤回": "撤回",
-    "SUSPEND": "中止", "中止": "中止", "已取消": "中止",
+    "PASS": "PASS", "通过": "PASS",
+    "OVERRULE": "OVERRULE", "否决": "OVERRULE",
+    "REVOKE": "REVOKE", "撤回": "REVOKE",
+    "SUSPEND": "SUSPEND", "中止": "SUSPEND", "已取消": "SUSPEND",
+}
+
+# The label stored beside each key and shown in the branch condition; in
+# the CLI's language, as the editor writes it (ticket 47173).
+_APPROVAL_RESULT_LABELS = {
+    "PASS": "approval.pass", "OVERRULE": "approval.overrule",
+    "REVOKE": "approval.revoke", "SUSPEND": "approval.suspend",
 }
 
 
@@ -262,13 +272,12 @@ def _approval_result_object(value: Any):
     """Map an approval outcome (key or label) to the fixed conditionValues
     option object the result-branch wire wants."""
     def _one(v):
-        label = _APPROVAL_RESULTS.get(v)
-        if label is None:
+        key = _APPROVAL_RESULTS.get(v)
+        if key is None:
             return v
-        key = next(k for k, lab in _APPROVAL_RESULTS.items()
-                   if lab == label and k.isupper())
-        return {"key": key, "value": label, "isDeleted": False,
-                "score": None, "index": None}
+        return {"key": key,
+                "value": content_default(_APPROVAL_RESULT_LABELS[key]),
+                "isDeleted": False, "score": None, "index": None}
     return [_one(v) for v in value] if isinstance(value, list) else _one(value)
 
 
@@ -292,14 +301,14 @@ def _condition_item(d: dict[str, Any], r: _Resolver) -> dict[str, Any]:
     if left_ref == "result":
         new_left = dict(out.get("left") or {})
         new_left["_filedTypeId"] = 11
-        new_left["_filedValue"] = "审批结果"
+        new_left["_filedValue"] = content_default("approval.result")
         new_left["_enumDefault"] = 0
         # The source-node metadata the wire expects (审批结果 lives on the
         # approval_block: nodeType 26, appType 10) rides on left.node.
         node_meta = dict(new_left.get("node") or {})
         node_meta["_nodeType"] = 26
         node_meta["_appType"] = 10
-        node_meta["_nodeName"] = "审批"
+        node_meta["_nodeName"] = content_default("approval.node")
         new_left["node"] = node_meta
         out["left"] = new_left
         right = d.get("right")
@@ -321,7 +330,7 @@ def _condition_item(d: dict[str, Any], r: _Resolver) -> dict[str, Any]:
         type_code = r.formula_types.get(left_node_alias, 6)
         new_left["fieldId"] = _fx_field_for_code(type_code)
         new_left["_filedTypeId"] = type_code
-        new_left["_filedValue"] = "结果"
+        new_left["_filedValue"] = content_default("formula.result")
         new_left["_enumDefault"] = 0
         node_meta = dict(new_left.get("node") or {})
         node_meta["_nodeType"] = 9
@@ -546,7 +555,7 @@ def _default_view_id(wsid: str) -> str:
     vid = ""
     if isinstance(views, list) and views:
         vid = next((v.get("viewId") or v.get("id") for v in views
-                    if v.get("name") == "全部"), None) or \
+                    if v.get("name") in DEFAULT_VIEW_NAMES), None) or \
             views[0].get("viewId") or views[0].get("id") or ""
     _VIEW_CACHE[wsid] = vid
     return vid

{hap_cli-0.9.12 → hap_cli-0.9.13}/hap_cli/core/chart.py

@@ -58,7 +58,10 @@ logger = logging.getLogger("hap_cli.chart")
 # (any non-empty dict) keep it untouched.
 DEFAULT_CHART_FILTER: dict[str, Any] = {
     "filterRangeId": "ctime",
-    "filterRangeName": "创建时间",
+    # The label of filterRangeId. The server re-derives it in the account's
+    # language on save (measured 2026-10-27: a sent value is not kept);
+    # default_chart_filter() still sends one, in the CLI's language.
+    "filterRangeName": "",
     "rangeType": 0,
     "rangeValue": None,
     "today": False,
@@ -114,6 +117,17 @@ _ID_VALUED_CONTROL_TYPES = frozenset({26, 27, 19, 23, 24, 29, 35, 48})
 _VALUELESS_FILTER_TYPES = frozenset({7, 8, 41, 42})
 
 
+def default_chart_filter() -> dict[str, Any]:
+    """A fresh copy of DEFAULT_CHART_FILTER, its range labelled in the
+    CLI's language rather than always in Chinese."""
+    from hap_cli.i18n import content_default
+
+    filter_block = dict(DEFAULT_CHART_FILTER)
+    filter_block["dynamicFilter"] = dict(DEFAULT_CHART_FILTER["dynamicFilter"])
+    filter_block["filterRangeName"] = content_default("chart.createdTime")
+    return filter_block
+
+
 def _summary_label(summary_type: Any) -> str:
     entry = _SUMMARY_TYPE_NAMES.get(summary_type)
     if not entry:
@@ -502,7 +516,7 @@ def save_chart(
     # caller is expected to carry the current filter forward (which
     # :func:`update_chart` does by reading it back).
     if not body.get("filter") and not report_id:
-        body["filter"] = dict(DEFAULT_CHART_FILTER)
+        body["filter"] = default_chart_filter()
     # A chart made from inside a view is scoped to it, so it counts the
     # rows that view shows rather than the whole worksheet (MDPublic
     # src/pages/Statistics/redux/actions.js:74-76). An explicit viewId in

{hap_cli-0.9.12 → hap_cli-0.9.13}/hap_cli/core/record_defaults.py

@@ -438,7 +438,13 @@ def as_text(source: Optional[dict[str, Any]], value: Any,
             return ""
         named = " ".join(p for p in (spot.get("title"), spot.get("address"))
                          if p)
-        return named or f"经度：{spot.get('x')} 纬度：{spot.get('y')}"
+        if named:
+            return named
+        from hap_cli.i18n import content_default
+        return " ".join(
+            content_default(key).replace("%0", str(spot.get(axis)))
+            for key, axis in (("location.longitude", "x"),
+                              ("location.latitude", "y")))
     if kind == 46:
         when = str(value)
         return when[:8] if source.get("unit") == "6" else when[:5]

{hap_cli-0.9.12 → hap_cli-0.9.13}/hap_cli/core/workflow_node_dsl.py

@@ -29,6 +29,8 @@ import logging
 import re
 from typing import Any, Callable, Optional
 
+from hap_cli.i18n import content_default
+
 logger = logging.getLogger("hap_cli.workflow.node_dsl")
 
 
@@ -506,9 +508,10 @@ def _condition_value_entries(
             "actionId": "",
             "appType": 100,
             "controlId": sys_field,
-            "controlName": _SYSTEM_VALUE_NAMES.get(sys_field, "当前时间"),
+            "controlName": content_default(_SYSTEM_VALUE_NAMES.get(
+                sys_field, "workflow.system.nowTime")),
             "nodeId": SYSTEM_NODE_ID,
-            "nodeName": "系统",
+            "nodeName": content_default("workflow.system"),
             "nodeType": 100,
             "sourceType": 0,
         }]
@@ -1156,13 +1159,15 @@ def translate_accounts(
             # node (default the trigger) with the special "uaid" roleId.
             node_id = _resolve_node_id(acc.get("node") or {"nodeAlias": "trigger"}, a2i)
             out.append({"type": 6, "entityId": node_id, "entityName": "",
-                        "roleId": "uaid", "roleTypeId": 0, "roleName": "触发者",
+                        "roleId": "uaid", "roleTypeId": 0,
+                        "roleName": content_default("workflow.system.trigger"),
                         "controlType": 26})
         elif kind == "supervisor":
             # Direct supervisor of the trigger user (roleTypeId 11).
             node_id = _resolve_node_id(acc.get("node") or {"nodeAlias": "trigger"}, a2i)
             out.append({"type": 6, "entityId": node_id, "entityName": "",
-                        "roleId": "uaid", "roleTypeId": 11, "roleName": "触发者",
+                        "roleId": "uaid", "roleTypeId": 11,
+                        "roleName": content_default("workflow.system.trigger"),
                         "controlType": 26})
         elif kind == "field":
             # Recipient = a member/dept/email FIELD on a record. Ground truth
@@ -1321,10 +1326,36 @@ def configure_worksheet_trigger(
     }
     return _fn.save_node(
         session, process_id, trigger_node_id, 0, config,
-        name="工作表事件触发",
+        name=_trigger_name(session, process_id, trigger_node_id, "worksheet"),
     )
 
 
+def _trigger_name(session, process_id: str, trigger_node_id: str,
+                  kind: str) -> str:
+    """The name to save a trigger under: the one it already has.
+
+    saveNode stores whatever ``name`` it is sent and blanks the node when
+    there is none (measured live 2026-10-27), and the editor always sends
+    the node's current name back (MDPublic WorkflowSettings/Detail/Start/
+    index.jsx:277). The server names a new trigger in the account's
+    language, so writing a fixed Chinese name here turned it Chinese in
+    English workspaces (ticket 47173) and undid any rename.
+    """
+    from hap_cli.core import flow_node as _fn
+    try:
+        detail = _fn.get_node_detail(session, process_id, trigger_node_id,
+                                     flow_node_type=0) or {}
+        if isinstance(detail, dict) and isinstance(detail.get("data"), dict):
+            detail = detail["data"]
+        name = (detail.get("name") or "").strip() if isinstance(detail, dict) else ""
+        if name:
+            return name
+    except Exception as exc:                          # noqa: BLE001
+        logger.warning("could not read the name of the trigger of %s; "
+                       "saving it under the default name: %s", process_id, exc)
+    return content_default(f"workflow.trigger.{kind}")
+
+
 def _stored_trigger_config(session, process_id: str,
                            trigger_node_id: str) -> dict[str, Any]:
     """What the trigger already carries, for the keys this call may keep.
@@ -1387,7 +1418,6 @@ def configure_scheduled_trigger(
     frequency = 2 if repeat_type == 5 else repeat_type  # workday → weekly
     cfg = {
         "appType": 5,
-        "name": "定时触发",
         "executeTime": start_time,
         "executeEndTime": end_time,
         "repeatType": repeat_type,
@@ -1400,7 +1430,8 @@ def configure_scheduled_trigger(
         "returns": [],
     }
     return _fn.save_node(
-        session, process_id, trigger_node_id, 0, cfg, name="定时触发",
+        session, process_id, trigger_node_id, 0, cfg,
+        name=_trigger_name(session, process_id, trigger_node_id, "scheduled"),
     )
 
 
@@ -1444,12 +1475,12 @@ def configure_date_trigger(
         "frequency": _DATE_REPEAT.get(repeat, 0),
         "operateCondition": [],
         "triggerId": "2",
-        "name": "按日期字段触发",
         "controls": [],
         "returns": [],
     }
     return _fn.save_node(
-        session, process_id, trigger_node_id, 0, cfg, name="按日期字段触发",
+        session, process_id, trigger_node_id, 0, cfg,
+        name=_trigger_name(session, process_id, trigger_node_id, "date"),
     )
 
 
@@ -1545,7 +1576,8 @@ def configure_pbp_trigger(
         "returns": [],
     }
     return _fn.save_node(
-        session, process_id, trigger_node_id, 0, cfg, name="封装业务流程",
+        session, process_id, trigger_node_id, 0, cfg,
+        name=_trigger_name(session, process_id, trigger_node_id, "pbp"),
     )
 
 
@@ -1662,13 +1694,17 @@ def configure_webhook_trigger(
             detail = detail.get("data", detail)
         return detail.get("controls", []) if isinstance(detail, dict) else []
 
+    # Read once: every save below must carry the trigger's own name.
+    trigger_name = _trigger_name(session, process_id, trigger_node_id,
+                                 "webhook")
+
     def _save(controls: list[dict[str, Any]]) -> None:
         _fn.save_node(
             session, process_id, trigger_node_id, 0,
             {"appType": 7, "assignFieldIds": [], "operateCondition": [],
              "isUpdate": False, "controls": controls, "returnJson": "",
              "returns": [], "hooksBody": False},
-            name="Webhook触发",
+            name=trigger_name,
         )
 
     hook_url = get_webhook_url(session, process_id, trigger_node_id)
@@ -4387,9 +4423,14 @@ _SYSTEM_VALUE_FIELDS = {
 }
 
 # 系统 node field id → its display name (controlName on a conditionValues entry).
+# Written into the step and shown in the editor, so it is localised
+# (hap_cli.i18n.CONTENT_DEFAULTS).
 _SYSTEM_VALUE_NAMES = {
-    "nowTime": "当前时间", "triggertime": "触发时间", "triggeraid": "触发者",
-    "timestamp": "时间戳", "timestampSeconds": "时间戳",
+    "nowTime": "workflow.system.nowTime",
+    "triggertime": "workflow.system.triggerTime",
+    "triggeraid": "workflow.system.trigger",
+    "timestamp": "workflow.system.timestamp",
+    "timestampSeconds": "workflow.system.timestamp",
 }
 
 
@@ -4808,7 +4849,8 @@ def _save_approval_block(session, process_id, node, prev_id, parent_id,
 
     extra = {"parentId": parent_id} if parent_id else None
     add_resp = _fn.add_node(session, process_id, 26, prev_id,
-                            name=node.get("name", "未命名审批流程"),
+                            name=node.get("name") or content_default(
+                                "workflow.unnamedApproval"),
                             app_type=10, extra=extra)
     apr = _added_nodes(add_resp)
     apr_node = apr[0] if apr else {}

{hap_cli-0.9.12 → hap_cli-0.9.13}/hap_cli/core/worksheet_templates.py

@@ -21,6 +21,8 @@ import json
 import uuid
 from typing import Any, Iterable, Optional
 
+from hap_cli.i18n import content_default
+
 # ── Field type enum (mirror of pd-openweb WIDGETS_TO_API_TYPE_ENUM) ──────
 
 TYPE = {
@@ -121,21 +123,20 @@ _DEFAULTS: dict[str, dict[str, Any]] = {
         "advancedSetting": {"analysislink": "1", "sorttype": "en"},
     },
     "MOBILE_PHONE": {
-        "size": 6, "hint": "请填写手机号码",
+        "size": 6,
         # The product seeds a 13-country shortlist for the picker; it has no
         # `defaultarea` key.
         "enumDefault": 0,
         "advancedSetting": {"commcountries": '[{"name":"China (中国)","iso2":"cn","dialCode":"86"},{"name":"Hong Kong (香港)","iso2":"hk","dialCode":"852"},{"name":"Taiwan (台灣)","iso2":"tw","dialCode":"886"},{"name":"Macau (澳門)","iso2":"mo","dialCode":"853"},{"name":"Singapore","iso2":"sg","dialCode":"65"},{"name":"Malaysia","iso2":"my","dialCode":"60"},{"name":"Japan (日本)","iso2":"jp","dialCode":"81"},{"name":"South Korea (대한민국)","iso2":"kr","dialCode":"82"},{"name":"United States","iso2":"us","dialCode":"1"},{"name":"United Kingdom","iso2":"gb","dialCode":"44"},{"name":"France","iso2":"fr","dialCode":"33"},{"name":"Germany (Deutschland)","iso2":"de","dialCode":"49"},{"name":"Russia (Россия)","iso2":"ru","dialCode":"7"}]'},
     },
-    "TELEPHONE": {"size": 6, "hint": "请填写座机号码"},
-    "EMAIL": {"size": 6, "hint": "请填写邮箱地址"},
+    "TELEPHONE": {"size": 6},
+    "EMAIL": {"size": 6},
     "NUMBER": {
-        "size": 6, "dot": 0, "hint": "请填写数值",
+        "size": 6, "dot": 0,
         "advancedSetting": {"showtype": "0", "roundtype": "2", "thousandth": "0"},
     },
     "MONEY": {
         "size": 6, "dot": 2, "enumDefault": 0, "enumDefault2": 2,
-        "hint": "请填写金额",
         "advancedSetting": {
             "currency": '{"currencycode":"CNY","symbol":"¥"}',
             "roundtype": "2", "showformat": "1",
@@ -149,11 +150,11 @@ _DEFAULTS: dict[str, dict[str, Any]] = {
         },
     },
     "DROP_DOWN": {
-        "size": 6, "enumDefault2": 0, "hint": "请选择",
+        "size": 6, "enumDefault2": 0,
         "advancedSetting": {"showtype": "0"},
     },
     "ATTACHMENT": {
-        "size": 12, "enumDefault": 3, "hint": "添加附件",
+        "size": 12, "enumDefault": 3,
         "advancedSetting": {
             "showtype": "1", "covertype": "0", "alldownload": "1",
             "webcompress": "1", "allowupload": "1", "allowdelete": "1",
@@ -161,11 +162,11 @@ _DEFAULTS: dict[str, dict[str, Any]] = {
         },
     },
     "DATE": {
-        "size": 6, "hint": "请选择日期",
+        "size": 6,
         "advancedSetting": {"showtype": "3", "allowtime": ""},
     },
     "DATE_TIME": {
-        "size": 6, "hint": "请选择日期",
+        "size": 6,
         "advancedSetting": {"showtype": "1"},
     },
     "AREA_PROVINCE": {"size": 6, "enumDefault": 0},
@@ -176,7 +177,7 @@ _DEFAULTS: dict[str, dict[str, Any]] = {
     },
     "USER_PICKER": {
         "size": 6, "enumDefault": 0, "enumDefault2": 0, "userPermission": 1,
-        "noticeItem": 0, "hint": "请选择成员",
+        "noticeItem": 0,
         "advancedSetting": {"checkusertype": "1", "usertype": "1"},
     },
     # userPermission 0 = "无" (store data only). MDPublic ae228624ca4
@@ -286,11 +287,10 @@ _DEFAULTS: dict[str, dict[str, Any]] = {
     "OCR": {"size": 6},
     "EMBED": {
         "size": 12, "enumDefault": 1,
-        "hint": "编辑状态下不支持查看",
         "advancedSetting": {"height": "400"},
     },
     "SEARCH_BTN": {
-        "size": 6, "enumDefault": 0, "enumDefault2": 0, "hint": "查询",
+        "size": 6, "enumDefault": 0, "enumDefault2": 0,
     },
     "SEARCH": {"size": 6},
     "RELATION_SEARCH": {
@@ -307,7 +307,7 @@ _DEFAULTS: dict[str, dict[str, Any]] = {
     },
     "RELATION": {"size": 12, "enumDefault": 0},
     "MONEY_CN": {"size": 6},
-    "CRED": {"size": 6, "enumDefault": 1, "hint": "请填写身份证"},
+    "CRED": {"size": 6, "enumDefault": 1},
 }
 
 
@@ -326,6 +326,28 @@ _USES_SOURCE_CONTROL = frozenset({
 })
 
 
+# Placeholder text the product gives a new field (DEFAULT_DATA, MDPublic
+# src/utils/domain/control/widget.js), written through ``_l()`` so it is
+# in the editor's language. Kept out of _DEFAULTS and localised per build
+# (hap_cli.i18n.CONTENT_DEFAULTS): a Chinese literal showed as Chinese
+# placeholder text in English workspaces (ticket 47173).
+_HINT_KEYS: dict[str, str] = {
+    "MOBILE_PHONE": "field.hint.mobilePhone",
+    "TELEPHONE": "field.hint.telephone",
+    "EMAIL": "field.hint.email",
+    "NUMBER": "field.hint.number",
+    "MONEY": "field.hint.money",
+    "DROP_DOWN": "field.hint.select",
+    "ATTACHMENT": "field.hint.attachment",
+    "DATE": "field.hint.date",
+    "DATE_TIME": "field.hint.date",
+    "USER_PICKER": "field.hint.member",
+    "EMBED": "field.hint.embed",
+    "SEARCH_BTN": "field.hint.searchButton",
+    "CRED": "field.hint.idCard",
+}
+
+
 def build_control(
     field_type: str | int,
     name: str,
@@ -444,6 +466,8 @@ def build_control(
         if k == "advancedSetting":
             continue
         ctrl.setdefault(k, v)
+    if type_name in _HINT_KEYS:
+        ctrl["hint"] = content_default(_HINT_KEYS[type_name])
     # advancedSetting merge
     adv = dict(defaults.get("advancedSetting", {}))
     if advanced_setting: