garu-ko 0.2.2 → 0.2.4

package/README.md

@@ -87,13 +87,16 @@ interface Token {
 
 Set `options.topN > 1` to get N-best results as an array. Note: topN > 1 is not yet fully supported and may return fewer results.
 
-### `garu.nouns(text): string[]`
+### `garu.nouns(text, options?): string[]`
 
-Extract nouns (NNG, NNP) from text.
+Extract nouns (NNG, NNP) from text. Set `options.includeSL` to also include foreign tokens (SL) like "AI", "BM25".
 
 ```js
 garu.nouns('인공지능 기술이 발전했다');
 // ["인공", "지능", "기술", "발전"]
+
+garu.nouns('AI 기술이 발전했다', { includeSL: true });
+// ["AI", "기술", "발전"]
 ```
 
 ### `garu.tokenize(text): string[]`

package/dist/index.d.ts

@@ -14,6 +14,9 @@ export interface AnalyzeResult {
 export interface AnalyzeOptions {
     topN?: number;
 }
+export interface NounsOptions {
+    includeSL?: boolean;
+}
 export interface LoadOptions {
     modelData?: ArrayBuffer;
     modelUrl?: string;
@@ -51,8 +54,9 @@ export declare class Garu {
     tokenize(text: string): string[];
     /**
      * Extract nouns (NNG, NNP) from text.
+     * Set `options.includeSL` to also include foreign tokens (SL) like "AI", "BM25".
      */
-    nouns(text: string): string[];
+    nouns(text: string, options?: NounsOptions): string[];
     /**
      * Whether the WASM analyzer is loaded and ready.
      */

package/dist/index.js

@@ -104,8 +104,9 @@ export class Garu {
     }
     /**
      * Extract nouns (NNG, NNP) from text.
+     * Set `options.includeSL` to also include foreign tokens (SL) like "AI", "BM25".
      */
-    nouns(text) {
+    nouns(text, options) {
         if (!this._loaded) {
             throw new Error('Garu instance has been destroyed');
         }
@@ -113,8 +114,9 @@ export class Garu {
             return [];
         }
         const result = this._wasm.analyze(text);
+        const includeSL = options?.includeSL ?? false;
         return result.tokens
-            .filter((t) => t.pos === 'NNG' || t.pos === 'NNP')
+            .filter((t) => t.pos === 'NNG' || t.pos === 'NNP' || (includeSL && t.pos === 'SL'))
             .map((t) => t.text);
     }
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "garu-ko",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "Ultra-lightweight Korean morphological analyzer for the web (1.7MB model, WASM 93KB, F1 95.3%)",
   "type": "module",
   "main": "dist/index.js",