fr-spell 1.0.1 → 1.0.2

package/README.cn.md

@@ -113,6 +113,32 @@ npm run help
 
 该命令会输出参数速查说明，覆盖 `lemma`、`nounDerive`、`adjeDerive`、`verbDerive`、`derive` 及 person/mode/tense 可用值。
 
+## 构建浏览器 Bundle
+
+```bash
+npm run build
+```
+
+构建产物：
+
+- `dist/frspell.browser.js`（单个 JS 文件，挂载 `window.FrSpell`）
+- `dist/models/community/*.onnx|*.json`（模型与词表等必需资源）
+
+构建完成后，将整个 `dist` 文件夹复制到前端项目中，然后使用：
+
+```html
+<script src="./dist/frspell.browser.js"></script>
+<script>
+	(async () => {
+		const predictor = await window.FrSpell({
+			modelBasePath: './dist/models/community'
+		});
+		const result = await predictor.lemma('mangeons');
+		console.log(result);
+	})();
+</script>
+```
+
 ## 运行基准测试
 
 1) 先生成检查清单 JSON（每类 100 条）：
@@ -146,20 +172,27 @@ npm run benchmark
 
 结果：
 
-- 由变位预测词元：99/100，准确率 99.00%，平均 16.46 ms
-- 名词派生：99/100，准确率 99.00%，平均 17.33 ms
-- 动词派生：100/100，准确率 100.00%，平均 17.12 ms
-- 形容词派生：100/100，准确率 100.00%，平均 17.34 ms
+- 由变位预测词元：97/100，准确率 97.00%，平均 22.21 ms
+- 名词派生：100/100，准确率 100.00%，平均 23.46 ms
+- 动词派生：100/100，准确率 100.00%，平均 23.18 ms
+- 形容词派生：100/100，准确率 100.00%，平均 23.49 ms
 
 ## 模型体积
 
-- 词元 ONNX 模型：models/small/lemma_type_model.int8.onnx = 0.96 MB
-- 派生 ONNX 模型：models/small/derive_form_model.int8.onnx = 0.91 MB
-- ONNX 总体积：约 1.87 MB
+- 当前默认（community）词元 ONNX 模型：models/community/lemma_type_model.int8.onnx = 1.48 MB
+- 当前默认（community）派生 ONNX 模型：models/community/derive_form_model.int8.onnx = 1.40 MB
+- 当前默认 ONNX 总体积：约 2.88 MB
+
+Mini 版本说明：
+
+- mini 词元 ONNX 模型目标大小：0.96 MB
+- mini 派生 ONNX 模型目标大小：0.91 MB
+- mini ONNX 总体积目标：约 1.87 MB
+- mini 模型版本将很快上线。
 
 ## 为什么它非常适合 Web 前端产品
 
 - 法语关键形态任务具有高准确率
-- 单次请求延迟低（本地基准平均约 16 到 17 ms）
-- ONNX 体积小（总计约 1.87 MB）
+- 单次请求延迟低（最新本地基准平均约 22 到 23 ms）
+- 当前默认 ONNX 体积紧凑（约 2.88 MB），更小的 mini 模型包（约 1.87 MB）即将上线
 - 非常适合为 Web 前端功能提供后端推理能力，例如实时写作辅助、语法提示与词元感知检索

package/README.fr.md

@@ -113,6 +113,32 @@ npm run help
 
 Cette commande affiche un guide rapide des paramètres pour `lemma`, `nounDerive`, `adjeDerive`, `verbDerive` et `derive`, avec les valeurs autorisées de person/mode/tense.
 
+## Construire le bundle navigateur
+
+```bash
+npm run build
+```
+
+Sortie de build :
+
+- `dist/frspell.browser.js` (fichier JS unique, expose `window.FrSpell`)
+- `dist/models/community/*.onnx|*.json` (ressources modèle et vocabulaire requises)
+
+Après le build, copiez tout le dossier `dist` dans votre projet frontend, puis utilisez :
+
+```html
+<script src="./dist/frspell.browser.js"></script>
+<script>
+	(async () => {
+		const predictor = await window.FrSpell({
+			modelBasePath: './dist/models/community'
+		});
+		const result = await predictor.lemma('mangeons');
+		console.log(result);
+	})();
+</script>
+```
+
 ## Exécuter les benchmarks
 
 1) Générer les fichiers JSON de checklist (100 éléments chacun) :
@@ -146,20 +172,27 @@ npm run benchmark
 
 Résultats :
 
-- lemme depuis une conjugaison : 99/100, précision 99.00 %, moyenne 16.46 ms
-- dérivation nominale : 99/100, précision 99.00 %, moyenne 17.33 ms
-- dérivation verbale : 100/100, précision 100.00 %, moyenne 17.12 ms
-- dérivation adjectivale : 100/100, précision 100.00 %, moyenne 17.34 ms
+- lemme depuis une conjugaison : 97/100, précision 97.00 %, moyenne 22.21 ms
+- dérivation nominale : 100/100, précision 100.00 %, moyenne 23.46 ms
+- dérivation verbale : 100/100, précision 100.00 %, moyenne 23.18 ms
+- dérivation adjectivale : 100/100, précision 100.00 %, moyenne 23.49 ms
 
 ## Taille des modèles
 
-- modèle ONNX lemme : models/small/lemma_type_model.int8.onnx = 0.96 MB
-- modèle ONNX dérivation : models/small/derive_form_model.int8.onnx = 0.91 MB
-- taille totale ONNX : environ 1.87 MB
+- modèle ONNX lemme par défaut (community) : models/community/lemma_type_model.int8.onnx = 1.48 MB
+- modèle ONNX dérivation par défaut (community) : models/community/derive_form_model.int8.onnx = 1.40 MB
+- taille ONNX totale par défaut actuelle : environ 2.88 MB
+
+Note sur la version mini :
+
+- taille cible du modèle lemme mini : 0.96 MB
+- taille cible du modèle dérivation mini : 0.91 MB
+- taille ONNX totale cible de la version mini : environ 1.87 MB
+- le package de modèles mini sera publié prochainement.
 
 ## Pourquoi c'est idéal pour des produits web frontend
 
 - excellente précision sur les tâches clés de morphologie française
-- faible latence par requête (environ 16 à 17 ms en moyenne sur benchmark local)
-- empreinte ONNX très compacte (environ 1.87 MB au total)
+- faible latence par requête (environ 22 à 23 ms en moyenne sur le dernier benchmark local)
+- empreinte ONNX par défaut toujours compacte (environ 2.88 MB au total), avec un package mini plus léger (environ 1.87 MB) à venir
 - parfait pour alimenter des fonctionnalités frontend via une inférence backend : assistance à l'écriture en temps réel, suggestions grammaticales et recherche basée sur le lemme

package/README.md

@@ -113,6 +113,32 @@ npm run help
 
 This prints a quick parameter reference for `lemma`, `nounDerive`, `adjeDerive`, `verbDerive`, and `derive`, including allowed person/mode/tense values.
 
+## Build Browser Bundle
+
+```bash
+npm run build
+```
+
+Build output:
+
+- `dist/frspell.browser.js` (single JS bundle, attach `window.FrSpell`)
+- `dist/models/community/*.onnx|*.json` (required model and vocab assets)
+
+After build, copy the whole `dist` folder into your frontend project, then use:
+
+```html
+<script src="./dist/frspell.browser.js"></script>
+<script>
+	(async () => {
+		const predictor = await window.FrSpell({
+			modelBasePath: './dist/models/community'
+		});
+		const result = await predictor.lemma('mangeons');
+		console.log(result);
+	})();
+</script>
+```
+
 ## Run Benchmark
 
 1) Prepare checklist JSON files (100 items each):
@@ -146,20 +172,27 @@ npm run benchmark
 
 Results:
 
-- lemma from conjugation: 99/100, accuracy 99.00%, average 16.46 ms
-- noun derive: 99/100, accuracy 99.00%, average 17.33 ms
-- verb derive: 100/100, accuracy 100.00%, average 17.12 ms
-- adjective derive: 100/100, accuracy 100.00%, average 17.34 ms
+- lemma from conjugation: 97/100, accuracy 97.00%, average 22.21 ms
+- noun derive: 100/100, accuracy 100.00%, average 23.46 ms
+- verb derive: 100/100, accuracy 100.00%, average 23.18 ms
+- adjective derive: 100/100, accuracy 100.00%, average 23.49 ms
 
 ## Model Size
 
-- lemma ONNX model: models/small/lemma_type_model.int8.onnx = 0.96 MB
-- derive ONNX model: models/small/derive_form_model.int8.onnx = 0.91 MB
-- total ONNX model size: about 1.87 MB
+- current default (community) lemma ONNX model: models/community/lemma_type_model.int8.onnx = 1.48 MB
+- current default (community) derive ONNX model: models/community/derive_form_model.int8.onnx = 1.40 MB
+- current default total ONNX model size: about 2.88 MB
+
+Mini version note:
+
+- mini lemma ONNX model target: 0.96 MB
+- mini derive ONNX model target: 0.91 MB
+- mini total ONNX model target: about 1.87 MB
+- the mini model package is planned to be published soon.
 
 ## Why It Is Great For Web Frontend Products
 
 - high accuracy for key French morphology tasks
-- low per-request latency (about 16 to 17 ms average in local benchmark)
-- very small ONNX footprint (about 1.87 MB total)
+- low per-request latency (about 22 to 23 ms average in latest local benchmark)
+- current default ONNX footprint is compact (about 2.88 MB total), with a smaller mini model package (about 1.87 MB) coming soon
 - ideal for backend inference powering web frontend features such as live writing assistance, grammar hints, and lemma-aware search