diff --git a/packages/docs/en/.vitepress/theme/components/basic-params-table.vue b/packages/docs/en/.vitepress/theme/components/basic-params-table.vue
index 3b4fecd9..402044e1 100644
--- a/packages/docs/en/.vitepress/theme/components/basic-params-table.vue
+++ b/packages/docs/en/.vitepress/theme/components/basic-params-table.vue
@@ -348,18 +348,20 @@ pinyin('赵钱孙李额', { pattern: 'first', toneType: 'none', type: 'array' })
option: 'toneSandhi',
type: 'boolean',
description:
- 'whether to apply smart tone change to 一 and 不, reference 维基百科',
+ 'whether to apply smart tone change to 一 and 不, reference 维基百科, and to two consecutive third-tone syllables (e.g. 你好 → ní hǎo), reference Wikipedia',
default: 'true',
children: [
{
value: 'true',
desc: 'apply',
- example: `pinyin('一旦被发现', { toneSandhi: true }); // 'yí dàn bèi fā xiàn'`,
+ example: `pinyin('一旦被发现', { toneSandhi: true }); // 'yí dàn bèi fā xiàn'
+pinyin('你好', { toneSandhi: true }); // 'ní hǎo'`,
},
{
value: 'false',
desc: 'not apply',
- example: `pinyin('一旦被发现', { toneSandhi: false }); // 'yī dàn bèi fā xiàn'`,
+ example: `pinyin('一旦被发现', { toneSandhi: false }); // 'yī dàn bèi fā xiàn'
+pinyin('你好', { toneSandhi: false }); // 'nǐ hǎo'`,
},
],
},
diff --git a/packages/docs/zh/.vitepress/theme/components/basic-params-table.vue b/packages/docs/zh/.vitepress/theme/components/basic-params-table.vue
index 4151acaf..b4439ad3 100644
--- a/packages/docs/zh/.vitepress/theme/components/basic-params-table.vue
+++ b/packages/docs/zh/.vitepress/theme/components/basic-params-table.vue
@@ -346,18 +346,20 @@ pinyin('赵钱孙李额', { pattern: 'first', toneType: 'none', type: 'array' })
option: 'toneSandhi',
type: 'boolean',
description:
- '是否对一和不应用智能变调,参考维基百科',
+ '是否应用智能变调,包括一和不(参考维基百科),以及两个连续三声的变调(如 你好 → ní hǎo,参考Wikipedia)',
default: 'true',
children: [
{
value: 'true',
desc: '应用',
- example: `pinyin('一旦被发现', { toneSandhi: true }); // 'yí dàn bèi fā xiàn'`,
+ example: `pinyin('一旦被发现', { toneSandhi: true }); // 'yí dàn bèi fā xiàn'
+pinyin('你好', { toneSandhi: true }); // 'ní hǎo'`,
},
{
value: 'false',
desc: '不应用',
- example: `pinyin('一旦被发现', { toneSandhi: false }); // 'yī dàn bèi fā xiàn'`,
+ example: `pinyin('一旦被发现', { toneSandhi: false }); // 'yī dàn bèi fā xiàn'
+pinyin('你好', { toneSandhi: false }); // 'nǐ hǎo'`,
},
],
},
diff --git a/packages/pinyin-pro/lib/core/pinyin/index.ts b/packages/pinyin-pro/lib/core/pinyin/index.ts
index 64dc5c95..9624564e 100644
--- a/packages/pinyin-pro/lib/core/pinyin/index.ts
+++ b/packages/pinyin-pro/lib/core/pinyin/index.ts
@@ -34,7 +34,7 @@ export interface BasicOptions e