fix: 독스트링 중괄호 제거 — Svelte 빌드 파싱 오류 수정

collect/collectAll Returns 독스트링에서 중괄호 표현을 제거하여
generated-reference.md가 Svelte 빌드에서 Expected token } 에러를 발생시키는 문제 해결.

Author: eddmpython

docs/api/generated-reference.md

@@ -140,20 +140,27 @@ dartlab.setup("openai")      # OpenAI API 키 설정
 dartlab.setup("ollama")      # Ollama 설치 안내
 ```
 
-### `dartlab.search(keyword: str)`
+### `dartlab.search(query: str, *, corp: str | None = None, start: str | None = None, end: str | None = None, topK: int = 10)`
 
-종목 검색 (KR + US 통합).
+공시 원문 시맨틱 검색. *(alpha)*
 
 **Args:**
 
-- keyword: 종목명, 종목코드, 또는 ticker. 한글이면 KR, 영문이면 US 자동 감지.
+- query: 검색어 (한국어). "유상증자 결정", "대표이사 변경" 등.
+- corp: 종목 필터 (종목코드 "005930" 또는 회사명 "삼성전자").
+- start: 시작일 (YYYYMMDD).
+- end: 종료일 (YYYYMMDD).
+- topK: 반환 건수 (기본 10).
 
-**Returns:** pl.DataFrame — 검색 결과 (code, name, market 등).
+**Returns:** pl.DataFrame — 검색 결과.
+컬럼: score, rcept_no, corp_name, rcept_dt, report_nm,
+section_title, text, dartUrl
 
 ```python
 import dartlab
-dartlab.search("삼성전자")
-dartlab.search("AAPL")
+dartlab.search("유상증자 결정")
+dartlab.search("대표이사 변경", corp="005930")
+dartlab.search("전환사채", start="20240101", topK=5)
 ```
 
 ### `dartlab.listing(market: str | None = None)`
@@ -182,7 +189,7 @@ dartlab.listing("US")      # US 전체 (향후)
 - categories: 수집 카테고리 ["finance", "docs", "report"]. None이면 전체.
 - incremental: True면 증분 수집 (기본). False면 전체 재수집.
 
-**Returns:** dict — {종목코드: {카테고리: 수집 건수}}.
+**Returns:** dict — 종목코드별 카테고리별 수집 건수.
 
 ```python
 import dartlab
@@ -201,7 +208,7 @@ dartlab.collect("005930", "000660", categories=["finance"])  # 재무만
 - maxWorkers: 병렬 워커 수. None이면 키 수에 따라 자동.
 - incremental: True면 증분 수집. False면 전체 재수집.
 
-**Returns:** dict — {종목코드: {카테고리: 수집 건수}}.
+**Returns:** dict — 종목코드별 카테고리별 수집 건수.
 
 ```python
 import dartlab
@@ -589,15 +596,20 @@ KRX KIND 상장법인 전체 목록.
 
 회사명 → 종목코드. 정확히 일치하는 첫 번째 결과.
 
-### `dartlab.searchName(keyword: str) -> pl.DataFrame`
+### `dartlab.searchName(keyword: str)`
 
-회사명 부분 검색.
+종목명/코드로 종목 찾기 (KR + US).
 
 **Args:**
 
-- keyword: 검색 키워드 (예: "삼성", "반도체").
+- keyword: 종목명, 종목코드, 또는 ticker.
 
-**Returns:** 매칭된 종목 DataFrame (회사명, 종목코드, ...).
+**Returns:** pl.DataFrame — 종목 검색 결과.
+
+```python
+dartlab.searchName("삼성전자")
+dartlab.searchName("AAPL")
+```
 
 ### `dartlab.fuzzySearch(keyword: str, *, maxResults: int = 10) -> pl.DataFrame`
 
@@ -689,10 +701,6 @@ dartlab.capabilities("scan")                 # scan 상세
 dartlab.capabilities(search="재무건전성")     # 질문 기반 검색 → 상위 10개
 ```
 
-### `dartlab.guide`
-
-dartlab 안내 데스크 — 시스템 총괄 관리 엔진.
-
 ---
 
 ## Company

landing/static/api-reference.json

@@ -201,21 +201,45 @@
   {
     "name": "search",
     "kind": "function",
-    "summary": "종목 검색 (KR + US 통합).",
+    "summary": "공시 원문 시맨틱 검색. *(alpha)*",
     "group": "dartlab",
     "params": [
       {
-        "name": "keyword",
+        "name": "query",
         "type": "str"
+      },
+      {
+        "name": "corp",
+        "type": "str | None",
+        "default": "None",
+        "keyword_only": "true"
+      },
+      {
+        "name": "start",
+        "type": "str | None",
+        "default": "None",
+        "keyword_only": "true"
+      },
+      {
+        "name": "end",
+        "type": "str | None",
+        "default": "None",
+        "keyword_only": "true"
+      },
+      {
+        "name": "topK",
+        "type": "int",
+        "default": "10",
+        "keyword_only": "true"
       }
     ],
-    "args": "keyword: 종목명, 종목코드, 또는 ticker. 한글이면 KR, 영문이면 US 자동 감지.",
-    "returns": "pl.DataFrame — 검색 결과 (code, name, market 등).",
-    "example": "import dartlab\ndartlab.search(\"삼성전자\")\ndartlab.search(\"AAPL\")",
-    "capabilities": "한글 입력 시 DART 종목 검색 (종목명, 종목코드)\n영문 입력 시 EDGAR 종목 검색 (ticker, 회사명)\n부분 일치, 초성 검색 지원 (KR)",
-    "requires": "데이터: listing (자동 다운로드)",
-    "guide": "\"삼성전자 종목코드 뭐야?\" -> search(\"삼성전자\")로 종목코드 확인\n\"애플 티커?\" -> search(\"AAPL\")로 EDGAR 종목 검색\nAPI 키 불필요. listing 데이터만으로 동작.",
-    "seealso": "Company: 종목코드 확인 후 Company 생성하여 상세 분석\nlisting: 전체 상장법인 목록 조회"
+    "args": "query: 검색어 (한국어). \"유상증자 결정\", \"대표이사 변경\" 등.\ncorp: 종목 필터 (종목코드 \"005930\" 또는 회사명 \"삼성전자\").\nstart: 시작일 (YYYYMMDD).\nend: 종료일 (YYYYMMDD).\ntopK: 반환 건수 (기본 10).",
+    "returns": "pl.DataFrame — 검색 결과.\n컬럼: score, rcept_no, corp_name, rcept_dt, report_nm,\nsection_title, text, dartUrl",
+    "example": "import dartlab\ndartlab.search(\"유상증자 결정\")\ndartlab.search(\"대표이사 변경\", corp=\"005930\")\ndartlab.search(\"전환사채\", start=\"20240101\", topK=5)",
+    "capabilities": "전체 공시 원문 시맨틱 검색 (수시공시 포함)\n종목/기간 필터 지원\nDART 공시 뷰어 링크 포함 (dartUrl 컬럼)",
+    "requires": "데이터: vectorIndex (자동 다운로드)\n의존성: pip install dartlab[vector]",
+    "guide": "\"유상증자 한 회사?\" -> search(\"유상증자 결정\")\n\"삼성전자 최근 공시?\" -> search(\"공시\", corp=\"005930\")\n인덱스 없으면 자동 다운로드 (~8MB, 3초)",
+    "seealso": "Company: 종목코드/회사명으로 Company 생성\nlisting: 전체 상장법인 목록"
   },
   {
     "name": "listing",
@@ -262,7 +286,7 @@
     ],
     "returnType": "dict",
     "args": "*codes: 종목코드 1개 이상 (\"005930\", \"000660\").\ncategories: 수집 카테고리 [\"finance\", \"docs\", \"report\"]. None이면 전체.\nincremental: True면 증분 수집 (기본). False면 전체 재수집.",
-    "returns": "dict — {종목코드: {카테고리: 수집 건수}}.",
+    "returns": "dict — 종목코드별 카테고리별 수집 건수.",
     "example": "import dartlab\ndartlab.collect(\"005930\")                              # 삼성전자 전체\ndartlab.collect(\"005930\", \"000660\", categories=[\"finance\"])  # 재무만",
     "capabilities": "종목별 DART 공시 데이터 직접 수집 (finance, docs, report)\n멀티키 병렬 수집 (DART_API_KEYS 쉼표 구분)\n증분 수집 — 이미 있는 데이터는 건너뜀\n카테고리별 선택 수집",
     "requires": "API 키: DART_API_KEY",
@@ -302,7 +326,7 @@
     ],
     "returnType": "dict",
     "args": "categories: 수집 카테고리 [\"finance\", \"docs\", \"report\"]. None이면 전체.\nmode: \"new\" (미수집만, 기본) 또는 \"all\" (전체 재수집).\nmaxWorkers: 병렬 워커 수. None이면 키 수에 따라 자동.\nincremental: True면 증분 수집. False면 전체 재수집.",
-    "returns": "dict — {종목코드: {카테고리: 수집 건수}}.",
+    "returns": "dict — 종목코드별 카테고리별 수집 건수.",
     "example": "import dartlab\ndartlab.collectAll()                          # 전체 미수집 종목\ndartlab.collectAll(categories=[\"finance\"])    # 재무만\ndartlab.collectAll(mode=\"all\")                # 기수집 포함 전체",
     "capabilities": "전체 상장종목 DART 공시 데이터 일괄 수집\n미수집 종목만 선별 수집 (mode=\"new\") 또는 전체 재수집 (mode=\"all\")\n멀티키 병렬 수집 (DART_API_KEYS 쉼표 구분)\n카테고리별 선택 (finance, docs, report)",
     "requires": "API 키: DART_API_KEY",
@@ -857,17 +881,17 @@
   {
     "name": "searchName",
     "kind": "function",
-    "summary": "회사명 부분 검색.",
+    "summary": "종목명/코드로 종목 찾기 (KR + US).",
     "group": "dartlab",
     "params": [
       {
         "name": "keyword",
         "type": "str"
       }
     ],
-    "returnType": "pl.DataFrame",
-    "args": "keyword: 검색 키워드 (예: \"삼성\", \"반도체\").",
-    "returns": "매칭된 종목 DataFrame (회사명, 종목코드, ...)."
+    "args": "keyword: 종목명, 종목코드, 또는 ticker.",
+    "returns": "pl.DataFrame — 종목 검색 결과.",
+    "example": "dartlab.searchName(\"삼성전자\")\ndartlab.searchName(\"AAPL\")"
   },
   {
     "name": "fuzzySearch",
@@ -975,12 +999,6 @@
     "guide": "\"dartlab 뭐 할 수 있어?\" -> capabilities()\n\"분석 기능 뭐 있어?\" -> capabilities(\"analysis\")\n\"scan 어떻게 써?\" -> capabilities(\"scan\")\n\"재무건전성 관련 API?\" -> capabilities(search=\"재무건전성\")",
     "seealso": "ask: AI 질문 (capabilities로 기능 파악 후 ask로 분석)\nsetup: AI provider 설정 (capabilities 확인 후 설정)"
   },
-  {
-    "name": "guide",
-    "kind": "module",
-    "summary": "dartlab 안내 데스크 — 시스템 총괄 관리 엔진.",
-    "group": "dartlab"
-  },
   {
     "name": "Company.BS",
     "kind": "property",
@@ -1988,7 +2006,7 @@
     "example": "c = Company(\"005930\")\nc.sections  # 전체 sections 지도",
     "capabilities": "topic × period 수평화 통합 DataFrame\ndocs/finance/report 3-source 병합\nshow(topic)/trace(topic)/diff() 의 근간 데이터",
     "requires": "데이터: docs (필수), finance/report (선택, 자동 다운로드)",
-    "guide": "\"이 회사 전체 데이터 지도\" → c.sections\n\"어떤 topic이 있어?\" → c.sections 또는 c.topics",
+    "guide": "\"이 회사 전체 데이터 지도\" → c.sections\n\"어떤 topic이 있어?\" → c.topics (경량)",
     "seealso": "topics: sections 기반 topic 요약 (더 간결)\nshow: 특정 topic 데이터 조회\nindex: 전체 구조 메타데이터 목차"
   },
   {

src/dartlab/__init__.py

@@ -226,7 +226,7 @@ def collect(
         incremental: True면 증분 수집 (기본). False면 전체 재수집.
 
     Returns:
-        dict — {종목코드: {카테고리: 수집 건수}}.
+        dict — 종목코드별 카테고리별 수집 건수.
 
     Example::
 
@@ -273,7 +273,7 @@ def collectAll(
         incremental: True면 증분 수집. False면 전체 재수집.
 
     Returns:
-        dict — {종목코드: {카테고리: 수집 건수}}.
+        dict — 종목코드별 카테고리별 수집 건수.
 
     Example::