@vegamo/loom 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (196) hide show
  1. package/LICENSE +15 -0
  2. package/README.md +465 -0
  3. package/dist/agents/core/agent.d.ts +65 -0
  4. package/dist/agents/core/agent.d.ts.map +1 -0
  5. package/dist/agents/core/agent.js +277 -0
  6. package/dist/agents/core/agent.js.map +1 -0
  7. package/dist/agents/core/prompt.d.ts +11 -0
  8. package/dist/agents/core/prompt.d.ts.map +1 -0
  9. package/dist/agents/core/prompt.js +117 -0
  10. package/dist/agents/core/prompt.js.map +1 -0
  11. package/dist/agents/core/types.d.ts +49 -0
  12. package/dist/agents/core/types.d.ts.map +1 -0
  13. package/dist/agents/core/types.js +5 -0
  14. package/dist/agents/core/types.js.map +1 -0
  15. package/dist/agents/memory/memory.d.ts +62 -0
  16. package/dist/agents/memory/memory.d.ts.map +1 -0
  17. package/dist/agents/memory/memory.js +113 -0
  18. package/dist/agents/memory/memory.js.map +1 -0
  19. package/dist/agents/memory/types.d.ts +15 -0
  20. package/dist/agents/memory/types.d.ts.map +1 -0
  21. package/dist/agents/memory/types.js +5 -0
  22. package/dist/agents/memory/types.js.map +1 -0
  23. package/dist/index.d.ts +13 -0
  24. package/dist/index.d.ts.map +1 -0
  25. package/dist/index.js +104 -0
  26. package/dist/index.js.map +1 -0
  27. package/dist/llm/client.d.ts +49 -0
  28. package/dist/llm/client.d.ts.map +1 -0
  29. package/dist/llm/client.js +256 -0
  30. package/dist/llm/client.js.map +1 -0
  31. package/dist/llm/config.d.ts +13 -0
  32. package/dist/llm/config.d.ts.map +1 -0
  33. package/dist/llm/config.js +50 -0
  34. package/dist/llm/config.js.map +1 -0
  35. package/dist/llm/types.d.ts +74 -0
  36. package/dist/llm/types.d.ts.map +1 -0
  37. package/dist/llm/types.js +17 -0
  38. package/dist/llm/types.js.map +1 -0
  39. package/dist/mocks/generator.d.ts +10 -0
  40. package/dist/mocks/generator.d.ts.map +1 -0
  41. package/dist/mocks/generator.js +19 -0
  42. package/dist/mocks/generator.js.map +1 -0
  43. package/dist/mocks/router.d.ts +13 -0
  44. package/dist/mocks/router.d.ts.map +1 -0
  45. package/dist/mocks/router.js +44 -0
  46. package/dist/mocks/router.js.map +1 -0
  47. package/dist/mocks/server.d.ts +21 -0
  48. package/dist/mocks/server.d.ts.map +1 -0
  49. package/dist/mocks/server.js +36 -0
  50. package/dist/mocks/server.js.map +1 -0
  51. package/dist/serve.d.ts +17 -0
  52. package/dist/serve.d.ts.map +1 -0
  53. package/dist/serve.js +56 -0
  54. package/dist/serve.js.map +1 -0
  55. package/dist/shared/config-wizard.d.ts +7 -0
  56. package/dist/shared/config-wizard.d.ts.map +1 -0
  57. package/dist/shared/config-wizard.js +84 -0
  58. package/dist/shared/config-wizard.js.map +1 -0
  59. package/dist/shared/config.d.ts +32 -0
  60. package/dist/shared/config.d.ts.map +1 -0
  61. package/dist/shared/config.js +77 -0
  62. package/dist/shared/config.js.map +1 -0
  63. package/dist/shared/entity-utils.d.ts +30 -0
  64. package/dist/shared/entity-utils.d.ts.map +1 -0
  65. package/dist/shared/entity-utils.js +207 -0
  66. package/dist/shared/entity-utils.js.map +1 -0
  67. package/dist/shared/logger.d.ts +13 -0
  68. package/dist/shared/logger.d.ts.map +1 -0
  69. package/dist/shared/logger.js +45 -0
  70. package/dist/shared/logger.js.map +1 -0
  71. package/dist/shared/manifest-utils.d.ts +9 -0
  72. package/dist/shared/manifest-utils.d.ts.map +1 -0
  73. package/dist/shared/manifest-utils.js +110 -0
  74. package/dist/shared/manifest-utils.js.map +1 -0
  75. package/dist/shared/schema-entity-resolver.d.ts +15 -0
  76. package/dist/shared/schema-entity-resolver.d.ts.map +1 -0
  77. package/dist/shared/schema-entity-resolver.js +134 -0
  78. package/dist/shared/schema-entity-resolver.js.map +1 -0
  79. package/dist/shared/schema-utils.d.ts +21 -0
  80. package/dist/shared/schema-utils.d.ts.map +1 -0
  81. package/dist/shared/schema-utils.js +56 -0
  82. package/dist/shared/schema-utils.js.map +1 -0
  83. package/dist/shared/types.d.ts +130 -0
  84. package/dist/shared/types.d.ts.map +1 -0
  85. package/dist/shared/types.js +5 -0
  86. package/dist/shared/types.js.map +1 -0
  87. package/dist/tools/entity-file-ops.d.ts +10 -0
  88. package/dist/tools/entity-file-ops.d.ts.map +1 -0
  89. package/dist/tools/entity-file-ops.js +183 -0
  90. package/dist/tools/entity-file-ops.js.map +1 -0
  91. package/dist/tools/entity-workflow.d.ts +10 -0
  92. package/dist/tools/entity-workflow.d.ts.map +1 -0
  93. package/dist/tools/entity-workflow.js +447 -0
  94. package/dist/tools/entity-workflow.js.map +1 -0
  95. package/dist/tools/file-ops.d.ts +9 -0
  96. package/dist/tools/file-ops.d.ts.map +1 -0
  97. package/dist/tools/file-ops.js +83 -0
  98. package/dist/tools/file-ops.js.map +1 -0
  99. package/dist/tools/registry.d.ts +31 -0
  100. package/dist/tools/registry.d.ts.map +1 -0
  101. package/dist/tools/registry.js +58 -0
  102. package/dist/tools/registry.js.map +1 -0
  103. package/dist/tools/schema-gen.d.ts +8 -0
  104. package/dist/tools/schema-gen.d.ts.map +1 -0
  105. package/dist/tools/schema-gen.js +82 -0
  106. package/dist/tools/schema-gen.js.map +1 -0
  107. package/dist/tools/schema-validate.d.ts +8 -0
  108. package/dist/tools/schema-validate.d.ts.map +1 -0
  109. package/dist/tools/schema-validate.js +79 -0
  110. package/dist/tools/schema-validate.js.map +1 -0
  111. package/dist/tools/types.d.ts +29 -0
  112. package/dist/tools/types.d.ts.map +1 -0
  113. package/dist/tools/types.js +5 -0
  114. package/dist/tools/types.js.map +1 -0
  115. package/dist/tui/app.d.ts +13 -0
  116. package/dist/tui/app.d.ts.map +1 -0
  117. package/dist/tui/app.js +357 -0
  118. package/dist/tui/app.js.map +1 -0
  119. package/dist/tui/components/Chat.d.ts +14 -0
  120. package/dist/tui/components/Chat.d.ts.map +1 -0
  121. package/dist/tui/components/Chat.js +24 -0
  122. package/dist/tui/components/Chat.js.map +1 -0
  123. package/dist/tui/components/Header.d.ts +14 -0
  124. package/dist/tui/components/Header.d.ts.map +1 -0
  125. package/dist/tui/components/Header.js +6 -0
  126. package/dist/tui/components/Header.js.map +1 -0
  127. package/dist/tui/components/Input.d.ts +15 -0
  128. package/dist/tui/components/Input.d.ts.map +1 -0
  129. package/dist/tui/components/Input.js +74 -0
  130. package/dist/tui/components/Input.js.map +1 -0
  131. package/dist/tui/components/SchemaPreview.d.ts +13 -0
  132. package/dist/tui/components/SchemaPreview.d.ts.map +1 -0
  133. package/dist/tui/components/SchemaPreview.js +9 -0
  134. package/dist/tui/components/SchemaPreview.js.map +1 -0
  135. package/dist/tui/components/StatusBar.d.ts +15 -0
  136. package/dist/tui/components/StatusBar.d.ts.map +1 -0
  137. package/dist/tui/components/StatusBar.js +7 -0
  138. package/dist/tui/components/StatusBar.js.map +1 -0
  139. package/dist/tui/hooks/useAgent.d.ts +41 -0
  140. package/dist/tui/hooks/useAgent.d.ts.map +1 -0
  141. package/dist/tui/hooks/useAgent.js +180 -0
  142. package/dist/tui/hooks/useAgent.js.map +1 -0
  143. package/dist/view/frontend/components/App.d.ts +4 -0
  144. package/dist/view/frontend/components/App.d.ts.map +1 -0
  145. package/dist/view/frontend/components/App.js +35 -0
  146. package/dist/view/frontend/components/App.js.map +1 -0
  147. package/dist/view/frontend/components/EndpointDetailPage.d.ts +4 -0
  148. package/dist/view/frontend/components/EndpointDetailPage.d.ts.map +1 -0
  149. package/dist/view/frontend/components/EndpointDetailPage.js +103 -0
  150. package/dist/view/frontend/components/EndpointDetailPage.js.map +1 -0
  151. package/dist/view/frontend/components/HomePage.d.ts +4 -0
  152. package/dist/view/frontend/components/HomePage.d.ts.map +1 -0
  153. package/dist/view/frontend/components/HomePage.js +6 -0
  154. package/dist/view/frontend/components/HomePage.js.map +1 -0
  155. package/dist/view/frontend/components/ModuleDetailPage.d.ts +4 -0
  156. package/dist/view/frontend/components/ModuleDetailPage.d.ts.map +1 -0
  157. package/dist/view/frontend/components/ModuleDetailPage.js +64 -0
  158. package/dist/view/frontend/components/ModuleDetailPage.js.map +1 -0
  159. package/dist/view/frontend/components/ModulesPage.d.ts +4 -0
  160. package/dist/view/frontend/components/ModulesPage.d.ts.map +1 -0
  161. package/dist/view/frontend/components/ModulesPage.js +40 -0
  162. package/dist/view/frontend/components/ModulesPage.js.map +1 -0
  163. package/dist/view/frontend/index.d.ts +2 -0
  164. package/dist/view/frontend/index.d.ts.map +1 -0
  165. package/dist/view/frontend/index.js +15 -0
  166. package/dist/view/frontend/index.js.map +1 -0
  167. package/dist/view/frontend/types.d.ts +35 -0
  168. package/dist/view/frontend/types.d.ts.map +1 -0
  169. package/dist/view/frontend/types.js +2 -0
  170. package/dist/view/frontend/types.js.map +1 -0
  171. package/dist/view/frontend/utils/api.d.ts +5 -0
  172. package/dist/view/frontend/utils/api.d.ts.map +1 -0
  173. package/dist/view/frontend/utils/api.js +28 -0
  174. package/dist/view/frontend/utils/api.js.map +1 -0
  175. package/dist/view/public/bundle.js +104633 -0
  176. package/dist/view/public/bundle.js.map +7 -0
  177. package/dist/view/public/index.html +50 -0
  178. package/dist/view/routes/docs.d.ts +13 -0
  179. package/dist/view/routes/docs.d.ts.map +1 -0
  180. package/dist/view/routes/docs.js +53 -0
  181. package/dist/view/routes/docs.js.map +1 -0
  182. package/dist/view/routes/entities.d.ts +11 -0
  183. package/dist/view/routes/entities.d.ts.map +1 -0
  184. package/dist/view/routes/entities.js +39 -0
  185. package/dist/view/routes/entities.js.map +1 -0
  186. package/dist/view/routes/schema.d.ts +11 -0
  187. package/dist/view/routes/schema.d.ts.map +1 -0
  188. package/dist/view/routes/schema.js +43 -0
  189. package/dist/view/routes/schema.js.map +1 -0
  190. package/dist/view/server.d.ts +20 -0
  191. package/dist/view/server.d.ts.map +1 -0
  192. package/dist/view/server.js +54 -0
  193. package/dist/view/server.js.map +1 -0
  194. package/docgen.config.json +19 -0
  195. package/docgen.config.json.example +19 -0
  196. package/package.json +79 -0
package/dist/view/public/index.html ADDED
@@ -0,0 +1,50 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="UTF-8" />
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
6
+ <title>Loom - API Documentation Viewer</title>
7
+ <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/normalize/8.0.1/normalize.min.css" />
8
+ <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.4.0/css/all.min.css" />
9
+ <style>
10
+ * { box-sizing: border-box; }
11
+ body { margin: 0; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; background: #f8f9fa; }
12
+ #root { min-height: 100vh; }
13
+ .loading { padding: 2rem; text-align: center; color: #666; }
14
+ </style>
15
+ </head>
16
+ <body>
17
+ <div id="root">
18
+ <div class="loading">
19
+ <i class="fas fa-spinner fa-spin"></i> Loading Loom...
20
+ </div>
21
+ </div>
22
+ <script>
23
+ // Polyfill for global and process objects required by @stoplight/ui-kit and its dependencies
24
+ // Define global for browser environment (Node.js global variable)
25
+ if (typeof global === 'undefined') {
26
+ if (typeof globalThis !== 'undefined') {
27
+ var global = globalThis;
28
+ } else if (typeof window !== 'undefined') {
29
+ var global = window;
30
+ } else if (typeof self !== 'undefined') {
31
+ var global = self;
32
+ } else {
33
+ var global = {};
34
+ }
35
+ }
36
+
37
+ // Polyfill for process object
38
+ window.process = window.process || { env: {} };
39
+ window.process.env.NODE_ENV = window.process.env.NODE_ENV || 'development';
40
+ window.process.env.BLUEPRINT_NAMESPACE = window.process.env.BLUEPRINT_NAMESPACE || null;
41
+
42
+ // Make process globally available
43
+ if (typeof globalThis !== 'undefined') globalThis.process = window.process;
44
+ if (typeof self !== 'undefined') self.process = window.process;
45
+ if (typeof window !== 'undefined') window.process = window.process;
46
+ if (typeof global !== 'undefined') global.process = window.process;
47
+ </script>
48
+ <script src="/bundle.js"></script>
49
+ </body>
50
+ </html>
package/dist/view/routes/docs.d.ts ADDED
@@ -0,0 +1,13 @@
1
+ /**
2
+ * Docs API 路由
3
+ *
4
+ * 将 JSON Schema 渲染为结构化的 API 文档数据
5
+ *
6
+ * GET /api/docs — 获取所有 API 文档概览
7
+ * GET /api/docs/:name — 获取指定 schema 的完整 API 文档
8
+ */
9
+ import type { FastifyInstance } from 'fastify';
10
+ export declare function docsRoutes(fastify: FastifyInstance, opts: {
11
+ docsDir: string;
12
+ }): Promise<void>;
13
+ //# sourceMappingURL=docs.d.ts.map
package/dist/view/routes/docs.d.ts.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../../src/view/routes/docs.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAK/C,wBAAsB,UAAU,CAC9B,OAAO,EAAE,eAAe,EACxB,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GACxB,OAAO,CAAC,IAAI,CAAC,CA8Cf"}
package/dist/view/routes/docs.js ADDED
@@ -0,0 +1,53 @@
1
+ /**
2
+ * Docs API 路由
3
+ *
4
+ * 将 JSON Schema 渲染为结构化的 API 文档数据
5
+ *
6
+ * GET /api/docs — 获取所有 API 文档概览
7
+ * GET /api/docs/:name — 获取指定 schema 的完整 API 文档
8
+ */
9
+ import { listSchemaFiles, readSchemaFile } from '../../shared/schema-utils.js';
10
+ import { resolveDocumentEntityRefs } from '../../shared/schema-entity-resolver.js';
11
+ import path from 'node:path';
12
+ export async function docsRoutes(fastify, opts) {
13
+ const { docsDir } = opts;
14
+ /** API 文档概览 — 列出所有模块及其 endpoint 摘要 */
15
+ fastify.get('/api/docs', async () => {
16
+ const files = listSchemaFiles(docsDir);
17
+ return {
18
+ modules: files.map((f) => {
19
+ const doc = readSchemaFile(f.filepath);
20
+ return {
21
+ filename: f.filename,
22
+ title: doc.title,
23
+ description: doc.description,
24
+ endpoints: doc.endpoints.map((ep) => ({
25
+ method: ep.method,
26
+ path: ep.path,
27
+ summary: ep.summary,
28
+ })),
29
+ };
30
+ }),
31
+ };
32
+ });
33
+ /** 指定 schema 的完整 API 文档 */
34
+ fastify.get('/api/docs/:name', async (request, reply) => {
35
+ const { name } = request.params;
36
+ const filepath = path.join(docsDir, name);
37
+ try {
38
+ const doc = readSchemaFile(filepath);
39
+ const resolved = resolveDocumentEntityRefs(doc, docsDir);
40
+ return {
41
+ title: resolved.doc.title,
42
+ description: resolved.doc.description,
43
+ version: resolved.doc.version,
44
+ endpoints: resolved.doc.endpoints,
45
+ entityResolveIssues: resolved.issues,
46
+ };
47
+ }
48
+ catch {
49
+ return reply.status(404).send({ error: `Document "${name}" not found` });
50
+ }
51
+ });
52
+ }
53
+ //# sourceMappingURL=docs.js.map
package/dist/view/routes/docs.js.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"docs.js","sourceRoot":"","sources":["../../../src/view/routes/docs.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC/E,OAAO,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AACnF,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,OAAwB,EACxB,IAAyB;IAEzB,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAEzB,sCAAsC;IACtC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,IAAI,EAAE;QAClC,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;QAEvC,OAAO;YACL,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBACvB,MAAM,GAAG,GAAG,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;gBACvC,OAAO;oBACL,QAAQ,EAAE,CAAC,CAAC,QAAQ;oBACpB,KAAK,EAAE,GAAG,CAAC,KAAK;oBAChB,WAAW,EAAE,GAAG,CAAC,WAAW;oBAC5B,SAAS,EAAE,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;wBACpC,MAAM,EAAE,EAAE,CAAC,MAAM;wBACjB,IAAI,EAAE,EAAE,CAAC,IAAI;wBACb,OAAO,EAAE,EAAE,CAAC,OAAO;qBACpB,CAAC,CAAC;iBACJ,CAAC;YACJ,CAAC,CAAC;SACH,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,2BAA2B;IAC3B,OAAO,CAAC,GAAG,CACT,iBAAiB,EACjB,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QACvB,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAE1C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;YACrC,MAAM,QAAQ,GAAG,yBAAyB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YACzD,OAAO;gBACL,KAAK,EAAE,QAAQ,CAAC,GAAG,CAAC,KAAK;gBACzB,WAAW,EAAE,QAAQ,CAAC,GAAG,CAAC,WAAW;gBACrC,OAAO,EAAE,QAAQ,CAAC,GAAG,CAAC,OAAO;gBAC7B,SAAS,EAAE,QAAQ,CAAC,GAAG,CAAC,SAAS;gBACjC,mBAAmB,EAAE,QAAQ,CAAC,MAAM;aACrC,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,aAAa,IAAI,aAAa,EAAE,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
package/dist/view/routes/entities.d.ts ADDED
@@ -0,0 +1,11 @@
1
+ /**
2
+ * Entity API 路由
3
+ *
4
+ * GET /api/entities — 列出所有 entity 文件
5
+ * GET /api/entities/:name — 获取指定 entity 文件内容
6
+ */
7
+ import type { FastifyInstance } from 'fastify';
8
+ export declare function entityRoutes(fastify: FastifyInstance, opts: {
9
+ docsDir: string;
10
+ }): Promise<void>;
11
+ //# sourceMappingURL=entities.d.ts.map
package/dist/view/routes/entities.d.ts.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../../../src/view/routes/entities.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAG/C,wBAAsB,YAAY,CAChC,OAAO,EAAE,eAAe,EACxB,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GACxB,OAAO,CAAC,IAAI,CAAC,CAmCf"}
package/dist/view/routes/entities.js ADDED
@@ -0,0 +1,39 @@
1
+ /**
2
+ * Entity API 路由
3
+ *
4
+ * GET /api/entities — 列出所有 entity 文件
5
+ * GET /api/entities/:name — 获取指定 entity 文件内容
6
+ */
7
+ import { listEntityFiles, readEntityFile } from '../../shared/entity-utils.js';
8
+ export async function entityRoutes(fastify, opts) {
9
+ const { docsDir } = opts;
10
+ /** 列出所有 entity 文件 */
11
+ fastify.get('/api/entities', async () => {
12
+ const files = listEntityFiles(docsDir);
13
+ return {
14
+ count: files.length,
15
+ entities: files.map((file) => ({
16
+ filename: file.filename,
17
+ title: file.title,
18
+ description: file.description,
19
+ fieldCount: file.fieldCount,
20
+ updatedAt: file.updatedAt.toISOString(),
21
+ })),
22
+ };
23
+ });
24
+ /** 获取指定 entity 文件内容 */
25
+ fastify.get('/api/entities/:name', async (request, reply) => {
26
+ const { name } = request.params;
27
+ try {
28
+ const entity = readEntityFile(docsDir, name);
29
+ return {
30
+ filename: name,
31
+ entity,
32
+ };
33
+ }
34
+ catch {
35
+ return reply.status(404).send({ error: `Entity "${name}" not found` });
36
+ }
37
+ });
38
+ }
39
+ //# sourceMappingURL=entities.js.map
package/dist/view/routes/entities.js.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"entities.js","sourceRoot":"","sources":["../../../src/view/routes/entities.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE/E,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAAwB,EACxB,IAAyB;IAEzB,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAEzB,qBAAqB;IACrB,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,KAAK,IAAI,EAAE;QACtC,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;QACvC,OAAO;YACL,KAAK,EAAE,KAAK,CAAC,MAAM;YACnB,QAAQ,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE;aACxC,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,uBAAuB;IACvB,OAAO,CAAC,GAAG,CACT,qBAAqB,EACrB,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QACvB,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QAEhC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAC7C,OAAO;gBACL,QAAQ,EAAE,IAAI;gBACd,MAAM;aACP,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,WAAW,IAAI,aAAa,EAAE,CAAC,CAAC;QACzE,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
package/dist/view/routes/schema.d.ts ADDED
@@ -0,0 +1,11 @@
1
+ /**
2
+ * Schema API 路由
3
+ *
4
+ * GET /api/schemas — 列出所有 schema 文件
5
+ * GET /api/schemas/:name — 获取指定 schema 文件内容
6
+ */
7
+ import type { FastifyInstance } from 'fastify';
8
+ export declare function schemaRoutes(fastify: FastifyInstance, opts: {
9
+ docsDir: string;
10
+ }): Promise<void>;
11
+ //# sourceMappingURL=schema.d.ts.map
package/dist/view/routes/schema.d.ts.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/view/routes/schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAK/C,wBAAsB,YAAY,CAChC,OAAO,EAAE,eAAe,EACxB,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GACxB,OAAO,CAAC,IAAI,CAAC,CAqCf"}
package/dist/view/routes/schema.js ADDED
@@ -0,0 +1,43 @@
1
+ /**
2
+ * Schema API 路由
3
+ *
4
+ * GET /api/schemas — 列出所有 schema 文件
5
+ * GET /api/schemas/:name — 获取指定 schema 文件内容
6
+ */
7
+ import { listSchemaFiles, readSchemaFile } from '../../shared/schema-utils.js';
8
+ import { resolveDocumentEntityRefs } from '../../shared/schema-entity-resolver.js';
9
+ import path from 'node:path';
10
+ export async function schemaRoutes(fastify, opts) {
11
+ const { docsDir } = opts;
12
+ /** 列出所有 schema 文件 */
13
+ fastify.get('/api/schemas', async () => {
14
+ const files = listSchemaFiles(docsDir);
15
+ return {
16
+ count: files.length,
17
+ schemas: files.map((f) => ({
18
+ filename: f.filename,
19
+ title: f.title,
20
+ description: f.description,
21
+ endpointCount: f.endpointCount,
22
+ updatedAt: f.updatedAt.toISOString(),
23
+ })),
24
+ };
25
+ });
26
+ /** 获取指定 schema 文件内容 */
27
+ fastify.get('/api/schemas/:name', async (request, reply) => {
28
+ const { name } = request.params;
29
+ const filepath = path.join(docsDir, name);
30
+ try {
31
+ const doc = readSchemaFile(filepath);
32
+ const resolved = resolveDocumentEntityRefs(doc, docsDir);
33
+ return {
34
+ ...resolved.doc,
35
+ entityResolveIssues: resolved.issues,
36
+ };
37
+ }
38
+ catch {
39
+ return reply.status(404).send({ error: `Schema "${name}" not found` });
40
+ }
41
+ });
42
+ }
43
+ //# sourceMappingURL=schema.js.map
package/dist/view/routes/schema.js.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/view/routes/schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC/E,OAAO,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AACnF,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAAwB,EACxB,IAAyB;IAEzB,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAEzB,qBAAqB;IACrB,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,KAAK,IAAI,EAAE;QACrC,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;QACvC,OAAO;YACL,KAAK,EAAE,KAAK,CAAC,MAAM;YACnB,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACzB,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,WAAW,EAAE,CAAC,CAAC,WAAW;gBAC1B,aAAa,EAAE,CAAC,CAAC,aAAa;gBAC9B,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE;aACrC,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,uBAAuB;IACvB,OAAO,CAAC,GAAG,CACT,oBAAoB,EACpB,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QACvB,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAE1C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;YACrC,MAAM,QAAQ,GAAG,yBAAyB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YACzD,OAAO;gBACL,GAAG,QAAQ,CAAC,GAAG;gBACf,mBAAmB,EAAE,QAAQ,CAAC,MAAM;aACrC,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,WAAW,IAAI,aAAa,EAAE,CAAC,CAAC;QACzE,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
package/dist/view/server.d.ts ADDED
@@ -0,0 +1,20 @@
1
+ /**
2
+ * Web Viewer — Fastify 服务
3
+ *
4
+ * 提供 API 文档查看界面和 schema 数据接口
5
+ */
6
+ import type { FastifyInstance } from 'fastify';
7
+ export interface ViewServerOptions {
8
+ port: number;
9
+ host?: string;
10
+ docsDir: string;
11
+ silent?: boolean;
12
+ }
13
+ export interface ViewServerHandle {
14
+ app: FastifyInstance;
15
+ host: string;
16
+ port: number;
17
+ close: () => Promise<void>;
18
+ }
19
+ export declare function startViewServer(options: ViewServerOptions): Promise<ViewServerHandle>;
20
+ //# sourceMappingURL=server.d.ts.map
package/dist/view/server.d.ts.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/view/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAY/C,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,eAAe,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA8C3F"}
package/dist/view/server.js ADDED
@@ -0,0 +1,54 @@
1
+ /**
2
+ * Web Viewer — Fastify 服务
3
+ *
4
+ * 提供 API 文档查看界面和 schema 数据接口
5
+ */
6
+ import Fastify from 'fastify';
7
+ import fastifyStatic from '@fastify/static';
8
+ import fastifyCors from '@fastify/cors';
9
+ import path from 'node:path';
10
+ import { fileURLToPath } from 'node:url';
11
+ import { schemaRoutes } from './routes/schema.js';
12
+ import { docsRoutes } from './routes/docs.js';
13
+ import { entityRoutes } from './routes/entities.js';
14
+ import { logger } from '../shared/logger.js';
15
+ const __dirname = path.dirname(fileURLToPath(import.meta.url));
16
+ export async function startViewServer(options) {
17
+ const { port, host = '0.0.0.0', docsDir, silent = false } = options;
18
+ const app = Fastify({ logger: false });
19
+ // CORS
20
+ await app.register(fastifyCors, { origin: true });
21
+ // 静态文件 (前端页面)
22
+ await app.register(fastifyStatic, {
23
+ root: path.join(__dirname, 'public'),
24
+ prefix: '/',
25
+ });
26
+ // API 路由
27
+ await app.register(schemaRoutes, { docsDir });
28
+ await app.register(docsRoutes, { docsDir });
29
+ await app.register(entityRoutes, { docsDir });
30
+ // SPA fallback: BrowserRouter 刷新子路径时统一回退到 index.html
31
+ app.setNotFoundHandler((request, reply) => {
32
+ const requestPath = request.url.split('?')[0] || '/';
33
+ const isApiPath = requestPath === '/api' || requestPath.startsWith('/api/');
34
+ const isNavigationRequest = request.method === 'GET' || request.method === 'HEAD';
35
+ if (isNavigationRequest && !isApiPath) {
36
+ return reply.type('text/html').sendFile('index.html');
37
+ }
38
+ return reply.code(404).send({ message: 'Not Found' });
39
+ });
40
+ await app.listen({ port, host });
41
+ if (!silent) {
42
+ logger.success(`Web Viewer running at http://localhost:${port}`);
43
+ logger.info(`Serving docs from: ${docsDir}`);
44
+ }
45
+ return {
46
+ app,
47
+ host,
48
+ port,
49
+ close: async () => {
50
+ await app.close();
51
+ },
52
+ };
53
+ }
54
+ //# sourceMappingURL=server.js.map
package/dist/view/server.js.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/view/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,OAAO,MAAM,SAAS,CAAC;AAE9B,OAAO,aAAa,MAAM,iBAAiB,CAAC;AAC5C,OAAO,WAAW,MAAM,eAAe,CAAC;AACxC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAgB/D,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAA0B;IAC9D,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IAEpE,MAAM,GAAG,GAAG,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAEvC,OAAO;IACP,MAAM,GAAG,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAElD,cAAc;IACd,MAAM,GAAG,CAAC,QAAQ,CAAC,aAAa,EAAE;QAChC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC;QACpC,MAAM,EAAE,GAAG;KACZ,CAAC,CAAC;IAEH,SAAS;IACT,MAAM,GAAG,CAAC,QAAQ,CAAC,YAAY,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAC9C,MAAM,GAAG,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAC5C,MAAM,GAAG,CAAC,QAAQ,CAAC,YAAY,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAE9C,qDAAqD;IACrD,GAAG,CAAC,kBAAkB,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE;QACxC,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;QACrD,MAAM,SAAS,GAAG,WAAW,KAAK,MAAM,IAAI,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAC5E,MAAM,mBAAmB,GAAG,OAAO,CAAC,MAAM,KAAK,KAAK,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,CAAC;QAElF,IAAI,mBAAmB,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,OAAO,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QACxD,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,MAAM,GAAG,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACjC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,CAAC,OAAO,CAAC,0CAA0C,IAAI,EAAE,CAAC,CAAC;QACjE,MAAM,CAAC,IAAI,CAAC,sBAAsB,OAAO,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO;QACL,GAAG;QACH,IAAI;QACJ,IAAI;QACJ,KAAK,EAAE,KAAK,IAAI,EAAE;YAChB,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC;KACF,CAAC;AACJ,CAAC"}
package/docgen.config.json ADDED
@@ -0,0 +1,19 @@
1
+ {
2
+ "outDir": "docs",
3
+ "llm": {
4
+ "provider": "deepseek",
5
+ "model": "deepseek-chat",
6
+ "baseURL": "https://api.deepseek.com/v1",
7
+ "apiKey": "sk-772b03dca032458aa18bbe3702a88644",
8
+ "temperature": 0.7,
9
+ "maxTokens": 2000
10
+ },
11
+ "serve": {
12
+ "port": 3000,
13
+ "host": "0.0.0.0"
14
+ },
15
+ "mock": {
16
+ "port": 3001,
17
+ "host": "0.0.0.0"
18
+ }
19
+ }
package/docgen.config.json.example ADDED
@@ -0,0 +1,19 @@
1
+ {
2
+ "outDir": "docs",
3
+ "llm": {
4
+ "provider": "deepseek",
5
+ "model": "deepseek-chat",
6
+ "baseURL": "https://api.deepseek.com/v1",
7
+ "apiKey": "${DEEPSEEK_API_KEY}",
8
+ "temperature": 0.7,
9
+ "maxTokens": 2000
10
+ },
11
+ "serve": {
12
+ "port": 3000,
13
+ "host": "0.0.0.0"
14
+ },
15
+ "mock": {
16
+ "port": 3001,
17
+ "host": "0.0.0.0"
18
+ }
19
+ }
package/package.json ADDED
@@ -0,0 +1,79 @@
1
+ {
2
+ "name": "@vegamo/loom",
3
+ "version": "0.1.1",
4
+ "description": "AI-powered JSON Schema document generator with TUI, web viewer and mock server",
5
+ "type": "module",
6
+ "main": "dist/index.js",
7
+ "types": "dist/index.d.ts",
8
+ "bin": {
9
+ "loom": "dist/index.js"
10
+ },
11
+ "scripts": {
12
+ "dev": "tsx src/index.ts",
13
+ "build": "tsc",
14
+ "start": "node dist/index.js",
15
+ "test": "echo \"Error: no test specified\" && exit 1",
16
+ "build:view": "node scripts/build-view.mjs",
17
+ "dev:view": "NODE_ENV=development node scripts/build-view.mjs --watch",
18
+ "copy:view": "mkdir -p dist/view && cp -r src/view/public dist/view/ 2>/dev/null || true",
19
+ "postbuild": "npm run copy:view",
20
+ "build:all": "npm run build && npm run build:view",
21
+ "prepare": "npm run build:all",
22
+ "prepack": "npm run build:all"
23
+ },
24
+ "keywords": [
25
+ "json-schema",
26
+ "api-docs",
27
+ "mock-server",
28
+ "ai-agent",
29
+ "cli"
30
+ ],
31
+ "author": "",
32
+ "license": "ISC",
33
+ "engines": {
34
+ "node": ">=18.0.0"
35
+ },
36
+ "overrides": {
37
+ "glob": "^9.0.0",
38
+ "rimraf": "^4.0.0",
39
+ "inflight": "^1.0.7",
40
+ "urix": "^0.1.1",
41
+ "source-map-url": "^0.4.2",
42
+ "resolve-url": "^0.2.2",
43
+ "source-map-resolve": "^0.6.0",
44
+ "fsevents": "^2.3.3",
45
+ "coffee-script": "^1.12.7",
46
+ "mecano": "^1.0.0"
47
+ },
48
+ "dependencies": {
49
+ "@fastify/cors": "^11.2.0",
50
+ "@fastify/static": "^9.0.0",
51
+ "@stoplight/json-schema-viewer": "^2.0.0",
52
+ "@stoplight/markdown-viewer": "^3.8.1",
53
+ "@stoplight/tree-list": "^4.12.1",
54
+ "@stoplight/ui-kit": "^2.17.2",
55
+ "ajv": "^8.18.0",
56
+ "chalk": "^5.6.2",
57
+ "commander": "^14.0.3",
58
+ "dotenv": "^17.3.1",
59
+ "fastify": "^5.8.2",
60
+ "ink": "^6.8.0",
61
+ "ink-spinner": "^5.0.0",
62
+ "ink-text-input": "^6.0.0",
63
+ "mobx": "^6.15.0",
64
+ "mobx-react-lite": "^4.1.1",
65
+ "mock-json-schema": "^1.1.2",
66
+ "openai": "^6.32.0",
67
+ "react": "^19.2.4",
68
+ "react-dom": "^19.2.4",
69
+ "react-router-dom": "^7.13.1"
70
+ },
71
+ "devDependencies": {
72
+ "@types/node": "^25.5.0",
73
+ "@types/react": "^19.2.14",
74
+ "@types/react-dom": "^19.2.3",
75
+ "esbuild": "^0.27.4",
76
+ "tsx": "^4.21.0",
77
+ "typescript": "^5.9.3"
78
+ }
79
+ }