Enhance ffi-js docs with config details and examples (#163)

* docs: Enhance ffl-js doc with comprehensive configuration details

* docs: Add Bun runtime example for ffl-js docs

Author: Alice39s

packages/ffi-js/README.md

@@ -37,6 +37,8 @@ export CN_FONT_SPLIT_GH_HOST=https://ik.imagekit.io/github
 pnpm i cn-font-split
 ```
 
+### Nodejs 版本
+
 ```js
 import fs from 'fs';
 import { fontSplit } from 'cn-font-split';
@@ -51,6 +53,20 @@ await fontSplit({
 console.timeEnd('node');
 ```
 
+### Bun 版本
+
+```js
+import { fontSplit } from 'cn-font-split/dist/bun/index.js';
+const inputBuffer = Bun.file('../demo/public/SmileySans-Oblique.ttf').bytes(),
+
+console.time('bun');
+await fontSplit({
+    input: inputBuffer,
+    outDir: './dist/font',
+});
+console.timeEnd('bun');
+```
+
 ### 控制生成产物
 
 ```ts
@@ -67,23 +83,52 @@ await fontSplit({
 });
 ```
 
-### 精细化分包控制
+### 完整的可传入参数
+
+只有 `input` 和 `outDir` 是必须的参数，其他参数均为可选参数，没有特殊需求不建议修改。
 
 ```ts
 import { fontSplit } from 'cn-font-split';
 await fontSplit({
-    input: inputBuffer,
-    outDir: './dist/font',
-    subsets: [
-        [65,66,67], // 第一个分包
-        [102,103,104], // 第二个分包
-    ],
-    languageAreas: false, // 语言区域优化
-    autoSubset: false, // 超过指定大小是否自动包
-    fontFeature: false, // 是否支持字体特性
-    reduceMins: false,  // 是否减少碎片分包的出现
-    renameOutputFont: '[hash:6].[ext]', // 重命名输出字体
-    silent: true, // 不打印任何数据
+    input: inputBuffer,         // 输入的字体缓冲区
+    outDir: './dist/font',      // 输出目录
+    
+    // subsets: [                // 手动分包范围，一般而言不需要手动配置
+    //   [65,66,67],             // 第一个分包，对照: 65(A)、66(B)、67(C)
+    //   [102,103,104],          // 第二个分包，对照: 102(f)、103(g)、104(h)
+    // ],
+
+    // css: {                        // CSS 输出产物配置，一般而言不需要手动配置
+    //  fontFamily: 'Test Sans',     // 输出 css 产物的 font-family 名称
+    //  fontWeight: '400',           // 字重: 400 (常规)、700(粗体), 详细可见 https://developer.mozilla.org/en-US/docs/Web/CSS/font-weight
+    //  fontStyle: 'normal',         // 字体样式: normal (常规)、italic (斜体)。可见 https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/font-style
+    //  fontDisplay: 'swap',         // 字体显示策略，推荐 swap。可见 https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/font-display
+    //  localFamily: ['Test Sans'],  // 本地字体族名称。可见 https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face
+    //  commentUnicodes: false,      // 在 CSS 中添加 Unicode 码点注释
+    //  compress: true               // 压缩生成的 CSS 产物
+    // },
+
+    // languageAreas: false,       // 是否启用语言区域优化，将同一语言的字符分到一起
+    // autoSubset: true,           // 当分包超过指定大小时是否自动拆分
+    // fontFeature: true,          // 是否保留字体特性（如 Code 字体的连字、字距调整等）
+    // reduceMins: true,           // 是否减少碎片分包，合并小分包以减少请求数，一般不需要修改
+
+    previewImage: {
+        name: 'preview', // 预览图片的文件名
+        text: '中文网字计划\nThe Chinese Web Font Project', // 预览图片的文本内容
+    },
+
+    // chunkSize: 70 * 1024,           // 单个分片目标大小
+    // chunkSizeTolerance: 1 * 1024,   // 分片容差，一般不需要修改
+    // maxAllowSubsetsCount: 10,       // 最大允许分包数量，可能会和 chunkSize 冲突
+    
+    testHtml: true,             // 是否生成测试 HTML 文件
+    reporter: true,             // 是否生成 reporter.bin 文件
+
+    // 自定义分包输出的文件名为 6 位短哈希，或者使用自增索引: '[index].[ext]'
+    renameOutputFont: '[hash:6].[ext]', 
+    // 不在控制台打印多余的日志信息
+    silent: true,
 })
 ```