@c4a/extract-mdx 0.0.0-bootstrap.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 context4ai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,29 @@
+# MDX Catalog Bridge for Context
+
+[简体中文](./README.zh-CN.md)
+
+`@c4a/extract-mdx` parses registered MDX sources without compiling or executing them. It catalogs ESM imports/exports, JSX component references, fenced examples, demo/story/sandbox hosts, and links those examples to caller-registered public targets.
+
+```ts
+import { mdxSourcesToEvidenceAdapterResult } from "@c4a/extract-mdx";
+
+const evidence = mdxSourcesToEvidenceAdapterResult(files, {
+  ...invocation,
+  public_targets: [{
+    target_ref: "public-target:button",
+    export_name: "Button",
+    source_module: "@example/ui",
+  }],
+});
+```
+
+Public targets are an input authority, not inferred from uppercase JSX names. Example identities include the complete source path and an ordinal, so equal basenames in different directories cannot collide. Fenced code is retained only by digest; script-language blocks are parsed statically for imports and JSX references. Invalid fenced script receives a warning without making otherwise valid MDX disappear. Invalid MDX makes the whole file `unsupported` and publishes no partial facts.
+
+## Development
+
+```bash
+bun run --filter @c4a/extract-mdx typecheck
+bun run --filter @c4a/extract-mdx lint
+bun run --filter @c4a/extract-mdx test
+bun run --filter @c4a/extract-mdx build
+```

package/README.zh-CN.md

@@ -0,0 +1,16 @@
+# Context MDX 目录桥接
+
+[English](./README.md)
+
+`@c4a/extract-mdx` 静态解析已登记的 MDX source，不编译也不执行。它生成 ESM import/export、JSX component reference、fenced example、demo/story/sandbox host，并把示例关联到调用方已登记的公共目标。
+
+公共目标是输入 authority，解析器不会根据大写 JSX 名称自行创建公开 API。示例 identity 包含完整 source path 和 ordinal，不同目录下的同 basename 文件不会碰撞。代码块正文只保留 digest；脚本语言代码块仅静态提取 import 和 JSX reference。代码块语法错误产生 warning，但不会抹掉其他有效 MDX；MDX 本身语法错误时整文件为 `unsupported`，且不发布部分 facts。
+
+## 开发
+
+```bash
+bun run --filter @c4a/extract-mdx typecheck
+bun run --filter @c4a/extract-mdx lint
+bun run --filter @c4a/extract-mdx test
+bun run --filter @c4a/extract-mdx build
+```