@c4a/extract-ts 0.6.2 → 0.6.4

package/README.md

@@ -11,6 +11,34 @@ packages.
 
 **Depends on:** `@c4a/extract`, `web-tree-sitter`
 
+## React Router structural facts
+
+Projects that use `extractCustom()` can reuse `extractReactRouterRoutes()` to
+index JSX `<Route>` declarations and route-object arrays. It reports paths,
+components, redirects, conditions, import sources, notes, and source locations
+without classifying product meaning:
+
+```ts
+import { extractReactRouterRoutes } from "@c4a/extract-ts";
+
+const routes = extractReactRouterRoutes(source, "src/router.tsx", {
+  routeIdPrefix: "web",
+  mountPath: "/web",
+});
+```
+
+## TypeScript module export facts
+
+`extractTypeScriptModuleExports()` reads one TypeScript or TSX module and
+returns deterministic named exports, wildcard export targets, and all
+re-export targets. It does not resolve files or infer product meaning:
+
+```ts
+import { extractTypeScriptModuleExports } from "@c4a/extract-ts";
+
+const exports = extractTypeScriptModuleExports(source, "src/index.ts");
+```
+
 ## Current Extraction Coverage
 
 ### Entry Detection

package/README.zh-CN.md

@@ -0,0 +1,32 @@
+# @c4a/extract-ts
+
+Context 的 TypeScript/TSX 结构提取包。它实现 `@c4a/extract` 的插件协议，
+也是 SDK `extractTs({ source, collection: "codegraph" })` 阶段使用的默认
+提取器。
+
+除 TypeScript 符号、导出和 AST 关系外，包还提供可独立使用的 React Router
+结构提取：
+
+```ts
+import { extractReactRouterRoutes } from "@c4a/extract-ts";
+
+const routes = extractReactRouterRoutes(source, "src/router.tsx", {
+  routeIdPrefix: "web",
+  mountPath: "/web",
+});
+```
+
+该函数读取 JSX `<Route>` 和 route object 数组，返回路径、组件、重定向、
+条件、导入来源、注释及源码位置，不判断业务含义。项目可以在
+`extractCustom()` 中将这些结构事实映射为自己的候选。
+
+包还提供单文件导出面读取：
+
+```ts
+import { extractTypeScriptModuleExports } from "@c4a/extract-ts";
+
+const exports = extractTypeScriptModuleExports(source, "src/index.ts");
+```
+
+返回结果包含具名导出、通配导出目标和全部 re-export 目标。函数不解析文件、
+不追踪依赖，也不判断业务含义，适合由定制提取流程继续映射为领域事实。