@omnitron-dev/lumen 0.0.0-stage → 0.4.8

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 (192) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +96 -2
  3. package/bin/lumen.js +7 -0
  4. package/dist/ai/index.d.ts +5 -0
  5. package/dist/ai/index.d.ts.map +1 -0
  6. package/dist/ai/index.js +5 -0
  7. package/dist/ai/index.js.map +1 -0
  8. package/dist/ai/llms-full.d.ts +5 -0
  9. package/dist/ai/llms-full.d.ts.map +1 -0
  10. package/dist/ai/llms-full.js +25 -0
  11. package/dist/ai/llms-full.js.map +1 -0
  12. package/dist/ai/llms-txt.d.ts +5 -0
  13. package/dist/ai/llms-txt.d.ts.map +1 -0
  14. package/dist/ai/llms-txt.js +38 -0
  15. package/dist/ai/llms-txt.js.map +1 -0
  16. package/dist/ai/mcp-server.d.ts +6 -0
  17. package/dist/ai/mcp-server.d.ts.map +1 -0
  18. package/dist/ai/mcp-server.js +47 -0
  19. package/dist/ai/mcp-server.js.map +1 -0
  20. package/dist/ai/route-mirrors.d.ts +5 -0
  21. package/dist/ai/route-mirrors.d.ts.map +1 -0
  22. package/dist/ai/route-mirrors.js +21 -0
  23. package/dist/ai/route-mirrors.js.map +1 -0
  24. package/dist/cli/index.d.ts +13 -0
  25. package/dist/cli/index.d.ts.map +1 -0
  26. package/dist/cli/index.js +591 -0
  27. package/dist/cli/index.js.map +1 -0
  28. package/dist/config/define.d.ts +3 -0
  29. package/dist/config/define.d.ts.map +1 -0
  30. package/dist/config/define.js +60 -0
  31. package/dist/config/define.js.map +1 -0
  32. package/dist/config/env.d.ts +2 -0
  33. package/dist/config/env.d.ts.map +1 -0
  34. package/dist/config/env.js +17 -0
  35. package/dist/config/env.js.map +1 -0
  36. package/dist/config/index.d.ts +5 -0
  37. package/dist/config/index.d.ts.map +1 -0
  38. package/dist/config/index.js +5 -0
  39. package/dist/config/index.js.map +1 -0
  40. package/dist/config/loader.d.ts +4 -0
  41. package/dist/config/loader.d.ts.map +1 -0
  42. package/dist/config/loader.js +52 -0
  43. package/dist/config/loader.js.map +1 -0
  44. package/dist/config/schema.d.ts +131 -0
  45. package/dist/config/schema.d.ts.map +1 -0
  46. package/dist/config/schema.js +67 -0
  47. package/dist/config/schema.js.map +1 -0
  48. package/dist/corpus/examples.d.ts +4 -0
  49. package/dist/corpus/examples.d.ts.map +1 -0
  50. package/dist/corpus/examples.js +60 -0
  51. package/dist/corpus/examples.js.map +1 -0
  52. package/dist/corpus/graph.d.ts +26 -0
  53. package/dist/corpus/graph.d.ts.map +1 -0
  54. package/dist/corpus/graph.js +415 -0
  55. package/dist/corpus/graph.js.map +1 -0
  56. package/dist/corpus/index.d.ts +4 -0
  57. package/dist/corpus/index.d.ts.map +1 -0
  58. package/dist/corpus/index.js +4 -0
  59. package/dist/corpus/index.js.map +1 -0
  60. package/dist/corpus/projection.d.ts +16 -0
  61. package/dist/corpus/projection.d.ts.map +1 -0
  62. package/dist/corpus/projection.js +126 -0
  63. package/dist/corpus/projection.js.map +1 -0
  64. package/dist/corpus/routes.d.ts +4 -0
  65. package/dist/corpus/routes.d.ts.map +1 -0
  66. package/dist/corpus/routes.js +28 -0
  67. package/dist/corpus/routes.js.map +1 -0
  68. package/dist/corpus/types.d.ts +52 -0
  69. package/dist/corpus/types.d.ts.map +1 -0
  70. package/dist/corpus/types.js +2 -0
  71. package/dist/corpus/types.js.map +1 -0
  72. package/dist/gates/builtins/anchors.d.ts +3 -0
  73. package/dist/gates/builtins/anchors.d.ts.map +1 -0
  74. package/dist/gates/builtins/anchors.js +86 -0
  75. package/dist/gates/builtins/anchors.js.map +1 -0
  76. package/dist/gates/builtins/defaults.d.ts +3 -0
  77. package/dist/gates/builtins/defaults.d.ts.map +1 -0
  78. package/dist/gates/builtins/defaults.js +438 -0
  79. package/dist/gates/builtins/defaults.js.map +1 -0
  80. package/dist/gates/builtins/examples.d.ts +3 -0
  81. package/dist/gates/builtins/examples.d.ts.map +1 -0
  82. package/dist/gates/builtins/examples.js +27 -0
  83. package/dist/gates/builtins/examples.js.map +1 -0
  84. package/dist/gates/builtins/exports.d.ts +3 -0
  85. package/dist/gates/builtins/exports.d.ts.map +1 -0
  86. package/dist/gates/builtins/exports.js +282 -0
  87. package/dist/gates/builtins/exports.js.map +1 -0
  88. package/dist/gates/builtins/index.d.ts +7 -0
  89. package/dist/gates/builtins/index.d.ts.map +1 -0
  90. package/dist/gates/builtins/index.js +7 -0
  91. package/dist/gates/builtins/index.js.map +1 -0
  92. package/dist/gates/builtins/links.d.ts +3 -0
  93. package/dist/gates/builtins/links.d.ts.map +1 -0
  94. package/dist/gates/builtins/links.js +128 -0
  95. package/dist/gates/builtins/links.js.map +1 -0
  96. package/dist/gates/builtins/math.d.ts +3 -0
  97. package/dist/gates/builtins/math.d.ts.map +1 -0
  98. package/dist/gates/builtins/math.js +48 -0
  99. package/dist/gates/builtins/math.js.map +1 -0
  100. package/dist/gates/define.d.ts +3 -0
  101. package/dist/gates/define.d.ts.map +1 -0
  102. package/dist/gates/define.js +4 -0
  103. package/dist/gates/define.js.map +1 -0
  104. package/dist/gates/index.d.ts +5 -0
  105. package/dist/gates/index.d.ts.map +1 -0
  106. package/dist/gates/index.js +5 -0
  107. package/dist/gates/index.js.map +1 -0
  108. package/dist/gates/runner.d.ts +12 -0
  109. package/dist/gates/runner.d.ts.map +1 -0
  110. package/dist/gates/runner.js +55 -0
  111. package/dist/gates/runner.js.map +1 -0
  112. package/dist/gates/types.d.ts +29 -0
  113. package/dist/gates/types.d.ts.map +1 -0
  114. package/dist/gates/types.js +2 -0
  115. package/dist/gates/types.js.map +1 -0
  116. package/dist/index.d.ts +15 -0
  117. package/dist/index.d.ts.map +1 -0
  118. package/dist/index.js +9 -0
  119. package/dist/index.js.map +1 -0
  120. package/dist/manifest/generator.d.ts +4 -0
  121. package/dist/manifest/generator.d.ts.map +1 -0
  122. package/dist/manifest/generator.js +27 -0
  123. package/dist/manifest/generator.js.map +1 -0
  124. package/dist/manifest/hashing.d.ts +3 -0
  125. package/dist/manifest/hashing.d.ts.map +1 -0
  126. package/dist/manifest/hashing.js +10 -0
  127. package/dist/manifest/hashing.js.map +1 -0
  128. package/dist/manifest/index.d.ts +5 -0
  129. package/dist/manifest/index.d.ts.map +1 -0
  130. package/dist/manifest/index.js +5 -0
  131. package/dist/manifest/index.js.map +1 -0
  132. package/dist/manifest/schema.d.ts +14 -0
  133. package/dist/manifest/schema.d.ts.map +1 -0
  134. package/dist/manifest/schema.js +9 -0
  135. package/dist/manifest/schema.js.map +1 -0
  136. package/dist/manifest/types.d.ts +12 -0
  137. package/dist/manifest/types.d.ts.map +1 -0
  138. package/dist/manifest/types.js +2 -0
  139. package/dist/manifest/types.js.map +1 -0
  140. package/dist/search/index-builder.d.ts +19 -0
  141. package/dist/search/index-builder.d.ts.map +1 -0
  142. package/dist/search/index-builder.js +105 -0
  143. package/dist/search/index-builder.js.map +1 -0
  144. package/dist/search/index.d.ts +3 -0
  145. package/dist/search/index.d.ts.map +1 -0
  146. package/dist/search/index.js +3 -0
  147. package/dist/search/index.js.map +1 -0
  148. package/dist/search/tokenizer.d.ts +2 -0
  149. package/dist/search/tokenizer.d.ts.map +1 -0
  150. package/dist/search/tokenizer.js +12 -0
  151. package/dist/search/tokenizer.js.map +1 -0
  152. package/dist/ssg/assemble-html.d.ts +16 -0
  153. package/dist/ssg/assemble-html.d.ts.map +1 -0
  154. package/dist/ssg/assemble-html.js +38 -0
  155. package/dist/ssg/assemble-html.js.map +1 -0
  156. package/dist/ssg/client-build.d.ts +8 -0
  157. package/dist/ssg/client-build.d.ts.map +1 -0
  158. package/dist/ssg/client-build.js +64 -0
  159. package/dist/ssg/client-build.js.map +1 -0
  160. package/dist/ssg/default-client.d.ts +2 -0
  161. package/dist/ssg/default-client.d.ts.map +1 -0
  162. package/dist/ssg/default-client.js +12 -0
  163. package/dist/ssg/default-client.js.map +1 -0
  164. package/dist/ssg/emotion-extractor.d.ts +10 -0
  165. package/dist/ssg/emotion-extractor.d.ts.map +1 -0
  166. package/dist/ssg/emotion-extractor.js +101 -0
  167. package/dist/ssg/emotion-extractor.js.map +1 -0
  168. package/dist/ssg/file-tree-styles.d.ts +2 -0
  169. package/dist/ssg/file-tree-styles.d.ts.map +1 -0
  170. package/dist/ssg/file-tree-styles.js +21 -0
  171. package/dist/ssg/file-tree-styles.js.map +1 -0
  172. package/dist/ssg/index.d.ts +5 -0
  173. package/dist/ssg/index.d.ts.map +1 -0
  174. package/dist/ssg/index.js +5 -0
  175. package/dist/ssg/index.js.map +1 -0
  176. package/dist/ssg/publish-generation.d.ts +17 -0
  177. package/dist/ssg/publish-generation.d.ts.map +1 -0
  178. package/dist/ssg/publish-generation.js +271 -0
  179. package/dist/ssg/publish-generation.js.map +1 -0
  180. package/dist/ssg/render-html.d.ts +15 -0
  181. package/dist/ssg/render-html.d.ts.map +1 -0
  182. package/dist/ssg/render-html.js +62 -0
  183. package/dist/ssg/render-html.js.map +1 -0
  184. package/dist/ssg/server-build.d.ts +4 -0
  185. package/dist/ssg/server-build.d.ts.map +1 -0
  186. package/dist/ssg/server-build.js +145 -0
  187. package/dist/ssg/server-build.js.map +1 -0
  188. package/dist/ssg/ssg-engine.d.ts +27 -0
  189. package/dist/ssg/ssg-engine.d.ts.map +1 -0
  190. package/dist/ssg/ssg-engine.js +234 -0
  191. package/dist/ssg/ssg-engine.js.map +1 -0
  192. package/package.json +71 -3
@@ -0,0 +1 @@
1
+ {"version":3,"file":"routes.js","sourceRoot":"","sources":["../../src/corpus/routes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAElC,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,OAAO,CAAC,KAAK,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC;AACpD,CAAC;AAGD,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,IACE,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;QACtB,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC;QACtB,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;QACpB,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EACnD,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,2BAA2B,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACtE,CAAC;IACD,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QAClF,MAAM,IAAI,KAAK,CAAC,sCAAsC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,YAAoB,EAAE,WAAoC;IACtF,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;IAC7E,MAAM,IAAI,GAAG,OAAO,WAAW,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACvF,MAAM,KAAK,GAAG,IAAI;QAChB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YACpB,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE;QAC/C,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,EAAE,CAAC;IAC7C,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC"}
@@ -0,0 +1,52 @@
1
+ import type { LumenDocumentAst } from '@omnitron-dev/lumen-ast';
2
+ export type MathEnvType = 'axiom' | 'theorem' | 'definition' | 'lemma' | 'proposition' | 'corollary' | 'proof' | 'remark' | 'example' | 'hypothesis';
3
+ export interface CorpusMathObject {
4
+ id: string;
5
+ type: MathEnvType | string;
6
+ title?: string;
7
+ docId?: string;
8
+ number?: string;
9
+ status?: 'verified' | 'draft' | 'unverified';
10
+ dependsOn?: string[];
11
+ proves?: string[];
12
+ }
13
+ export interface CorpusHeader {
14
+ id: string;
15
+ title: string;
16
+ depth: number;
17
+ }
18
+ export interface CorpusDocumentRelations {
19
+ dependsOn?: string[];
20
+ proves?: string[];
21
+ seeAlso?: string[];
22
+ relatesTo?: string[];
23
+ }
24
+ export interface CorpusDocument {
25
+ id: string;
26
+ path: string;
27
+ title: string;
28
+ locale?: string;
29
+ hash: string;
30
+ anchors: string[];
31
+ mathObjects: CorpusMathObject[];
32
+ backlinks: string[];
33
+ relations?: CorpusDocumentRelations;
34
+ ast?: LumenDocumentAst;
35
+ routePath?: string;
36
+ frontmatter?: Record<string, unknown>;
37
+ headers?: CorpusHeader[];
38
+ }
39
+ export interface AnchorResolutionResult {
40
+ resolved: boolean;
41
+ targetDocId?: string;
42
+ anchor?: string;
43
+ }
44
+ export interface LinkResolutionResult {
45
+ resolved: boolean;
46
+ targetDocId?: string;
47
+ }
48
+ export interface OutdatedTranslation {
49
+ locale: string;
50
+ canonicalId: string;
51
+ }
52
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/corpus/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,MAAM,WAAW,GACnB,OAAO,GACP,SAAS,GACT,YAAY,GACZ,OAAO,GACP,aAAa,GACb,WAAW,GACX,OAAO,GACP,QAAQ,GACR,SAAS,GACT,YAAY,CAAC;AAEjB,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,GAAG,MAAM,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,YAAY,CAAC;IAC7C,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAChC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,CAAC,EAAE,uBAAuB,CAAC;IACpC,GAAG,CAAC,EAAE,gBAAgB,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/corpus/types.ts"],"names":[],"mappings":""}
@@ -0,0 +1,3 @@
1
+ import type { CorpusGate } from '../types.js';
2
+ export declare const anchorsGate: CorpusGate;
3
+ //# sourceMappingURL=anchors.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"anchors.d.ts","sourceRoot":"","sources":["../../../src/gates/builtins/anchors.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAgD,MAAM,aAAa,CAAC;AAoB5F,eAAO,MAAM,WAAW,EAAE,UAkFzB,CAAC"}
@@ -0,0 +1,86 @@
1
+ function walkAstNodes(nodes, visitor) {
2
+ for (const node of nodes) {
3
+ visitor(node);
4
+ if (Array.isArray(node.children) && node.children.length > 0) {
5
+ walkAstNodes(node.children, visitor);
6
+ }
7
+ }
8
+ }
9
+ function isExternalHref(href) {
10
+ const trimmed = href.trim();
11
+ return (trimmed.startsWith('//') ||
12
+ trimmed === '#unsafe-url' ||
13
+ /^(?:https?:|mailto:|tel:|javascript:|vbscript:|data:)/i.test(trimmed));
14
+ }
15
+ export const anchorsGate = {
16
+ name: 'anchorsGate',
17
+ description: 'Verifies heading anchor uniqueness, valid slug syntax, and anchor target existence',
18
+ run(context) {
19
+ const diagnostics = [];
20
+ for (const doc of context.documents) {
21
+ const seenAnchors = new Map();
22
+ for (const anchor of doc.anchors ?? []) {
23
+ const count = (seenAnchors.get(anchor) ?? 0) + 1;
24
+ seenAnchors.set(anchor, count);
25
+ if (count > 1) {
26
+ diagnostics.push({
27
+ code: 'LUMEN_DUPLICATE_ANCHOR',
28
+ message: `Duplicate heading anchor "${anchor}" found in document "${doc.id}"`,
29
+ file: doc.path,
30
+ severity: 'error',
31
+ suggestedFix: `{#${anchor}-${count - 1}}`,
32
+ });
33
+ }
34
+ if (/[^\p{L}\p{N}\-_]/u.test(anchor)) {
35
+ const normalized = anchor
36
+ .toLowerCase()
37
+ .replace(/[^\p{L}\p{N}\-_]+/gu, '-')
38
+ .replace(/^-+|-+$/g, '');
39
+ diagnostics.push({
40
+ code: 'LUMEN_INVALID_HEADING_SLUG',
41
+ message: `Heading anchor "${anchor}" contains reserved or invalid characters`,
42
+ file: doc.path,
43
+ severity: 'warning',
44
+ suggestedFix: normalized ? `{#${normalized}}` : undefined,
45
+ });
46
+ }
47
+ }
48
+ const checkedRefs = new Set();
49
+ const verifyAnchorRef = (ref, line) => {
50
+ const trimmed = ref.trim();
51
+ if (!trimmed || !trimmed.includes('#') || isExternalHref(trimmed) || checkedRefs.has(trimmed)) {
52
+ return;
53
+ }
54
+ checkedRefs.add(trimmed);
55
+ const res = context.graph.resolveAnchor(trimmed, doc.id);
56
+ if (!res.resolved) {
57
+ diagnostics.push({
58
+ code: 'ERR_BROKEN_ANCHOR',
59
+ message: `Anchor ${trimmed} does not resolve`,
60
+ file: doc.path,
61
+ ...(line !== undefined ? { line } : {}),
62
+ severity: 'error',
63
+ });
64
+ }
65
+ };
66
+ if (doc.relations?.seeAlso) {
67
+ for (const ref of doc.relations.seeAlso) {
68
+ verifyAnchorRef(ref);
69
+ }
70
+ }
71
+ if (doc.ast?.children) {
72
+ walkAstNodes(doc.ast.children, (node) => {
73
+ if (node.type === 'link' && typeof node.url === 'string' && node.url.includes('#')) {
74
+ verifyAnchorRef(node.url, node.position?.start?.line);
75
+ }
76
+ });
77
+ }
78
+ }
79
+ return {
80
+ name: 'anchorsGate',
81
+ passed: diagnostics.filter((d) => d.severity === 'error').length === 0,
82
+ diagnostics,
83
+ };
84
+ },
85
+ };
86
+ //# sourceMappingURL=anchors.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"anchors.js","sourceRoot":"","sources":["../../../src/gates/builtins/anchors.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ import type { CorpusGate } from '../types.js';
2
+ export declare const codeDefaultsGate: CorpusGate;
3
+ //# sourceMappingURL=defaults.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../../src/gates/builtins/defaults.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAgD,MAAM,aAAa,CAAC;AAiW5F,eAAO,MAAM,gBAAgB,EAAE,UAuK9B,CAAC"}
@@ -0,0 +1,438 @@
1
+ import { existsSync, readFileSync, statSync } from 'node:fs';
2
+ import { dirname, resolve } from 'node:path';
3
+ import ts from 'typescript';
4
+ const TWOSLASH_BOOLEAN_FLAGS = new Set([
5
+ 'strict',
6
+ 'noimplicitany',
7
+ 'esmoduleinterop',
8
+ 'skiplibcheck',
9
+ 'allowjs',
10
+ 'checkjs',
11
+ 'isolatedmodules',
12
+ 'noemit',
13
+ ]);
14
+ const CODE_BLOCK_TS_LANGS = new Set([
15
+ '',
16
+ 'ts',
17
+ 'tsx',
18
+ 'typescript',
19
+ 'js',
20
+ 'jsx',
21
+ 'javascript',
22
+ 'mts',
23
+ 'cts',
24
+ 'mjs',
25
+ 'cjs',
26
+ ]);
27
+ function walkNodes(nodes, visitor) {
28
+ for (const node of nodes) {
29
+ visitor(node);
30
+ if (Array.isArray(node.children) && node.children.length > 0) {
31
+ walkNodes(node.children, visitor);
32
+ }
33
+ }
34
+ }
35
+ function cleanLiteral(val) {
36
+ let out = val.trim();
37
+ if (out.length >= 2) {
38
+ const first = out[0];
39
+ const last = out[out.length - 1];
40
+ if ((first === "'" && last === "'") || (first === '"' && last === '"') || (first === '`' && last === '`')) {
41
+ out = out.slice(1, -1).trim();
42
+ }
43
+ }
44
+ return out;
45
+ }
46
+ function formatAstInitializer(expr, sf) {
47
+ if (ts.isStringLiteral(expr) || ts.isNoSubstitutionTemplateLiteral(expr)) {
48
+ return expr.text;
49
+ }
50
+ if (ts.isNumericLiteral(expr)) {
51
+ return expr.text;
52
+ }
53
+ if (expr.kind === ts.SyntaxKind.TrueKeyword) {
54
+ return 'true';
55
+ }
56
+ if (expr.kind === ts.SyntaxKind.FalseKeyword) {
57
+ return 'false';
58
+ }
59
+ if (expr.kind === ts.SyntaxKind.NullKeyword) {
60
+ return 'null';
61
+ }
62
+ if (ts.isPrefixUnaryExpression(expr) &&
63
+ expr.operator === ts.SyntaxKind.MinusToken &&
64
+ ts.isNumericLiteral(expr.operand)) {
65
+ return `-${expr.operand.text}`;
66
+ }
67
+ return cleanLiteral(expr.getText(sf));
68
+ }
69
+ function extractJsDocCommentText(comment) {
70
+ if (!comment)
71
+ return '';
72
+ if (typeof comment === 'string')
73
+ return comment;
74
+ return comment.map((part) => part.text).join('');
75
+ }
76
+ function extractFirstLineLiteral(raw) {
77
+ const nlIdx = raw.indexOf('\n');
78
+ const firstLine = (nlIdx === -1 ? raw : raw.slice(0, nlIdx)).replace(/\r$/, '').trim();
79
+ return cleanLiteral(firstLine);
80
+ }
81
+ function extractBracketedParamDefault(tagText) {
82
+ const openIdx = tagText.indexOf('[');
83
+ if (openIdx === -1)
84
+ return null;
85
+ const closeIdx = tagText.indexOf(']', openIdx + 1);
86
+ if (closeIdx === -1)
87
+ return null;
88
+ const inside = tagText.slice(openIdx + 1, closeIdx).trim();
89
+ if (!inside)
90
+ return null;
91
+ const eqIdx = inside.indexOf('=');
92
+ if (eqIdx === -1) {
93
+ return { name: inside };
94
+ }
95
+ const name = inside.slice(0, eqIdx).trim();
96
+ const defaultVal = cleanLiteral(inside.slice(eqIdx + 1));
97
+ return name ? { name, defaultVal } : null;
98
+ }
99
+ function parseTwoslashDirective(line) {
100
+ const trimmed = line.trim();
101
+ if (!trimmed.startsWith('//'))
102
+ return null;
103
+ const afterSlashes = trimmed.slice(2).trimStart();
104
+ if (!afterSlashes.startsWith('@'))
105
+ return null;
106
+ let idx = 1;
107
+ while (idx < afterSlashes.length) {
108
+ const ch = afterSlashes.charCodeAt(idx);
109
+ const isNameChar = (ch >= 48 && ch <= 57) || (ch >= 65 && ch <= 90) || (ch >= 97 && ch <= 122) || ch === 95 || ch === 45;
110
+ if (!isNameChar)
111
+ break;
112
+ idx += 1;
113
+ }
114
+ const rawName = afterSlashes.slice(1, idx);
115
+ if (!rawName || idx >= afterSlashes.length)
116
+ return null;
117
+ const sep = afterSlashes[idx];
118
+ if (sep !== ':' && sep !== ' ' && sep !== '\t')
119
+ return null;
120
+ const rest = sep === ':' ? afterSlashes.slice(idx + 1) : afterSlashes.slice(idx);
121
+ return {
122
+ rawName,
123
+ rawValue: rest.trim(),
124
+ };
125
+ }
126
+ function inspectTypeScriptSourceForDefaults(sourceText, virtualFileName, reportFilePath, baseLineOffset, diagnostics, collectedDefaultsOut) {
127
+ const sf = ts.createSourceFile(virtualFileName, sourceText, ts.ScriptTarget.Latest, true, ts.ScriptKind.TSX);
128
+ const getLineNumber = (node) => {
129
+ const pos = sf.getLineAndCharacterOfPosition(node.getStart(sf));
130
+ return baseLineOffset + pos.line;
131
+ };
132
+ const extractFunctionParameters = (params) => {
133
+ const paramMap = new Map();
134
+ for (const param of params) {
135
+ if (ts.isIdentifier(param.name) && param.initializer) {
136
+ const name = param.name.text;
137
+ const val = formatAstInitializer(param.initializer, sf);
138
+ paramMap.set(name, { codeDefault: val, line: getLineNumber(param) });
139
+ collectedDefaultsOut.set(name, val);
140
+ }
141
+ else if (ts.isObjectBindingPattern(param.name)) {
142
+ for (const elem of param.name.elements) {
143
+ const propName = elem.propertyName ? elem.propertyName.getText(sf) : elem.name.getText(sf);
144
+ if (propName && elem.initializer) {
145
+ const val = formatAstInitializer(elem.initializer, sf);
146
+ paramMap.set(propName, { codeDefault: val, line: getLineNumber(elem) });
147
+ collectedDefaultsOut.set(propName, val);
148
+ }
149
+ }
150
+ }
151
+ if (ts.isIdentifier(param.name) && param.initializer) {
152
+ const inlineTags = ts.getJSDocTags(param);
153
+ for (const tag of inlineTags) {
154
+ const tagName = tag.tagName.text.toLowerCase();
155
+ if (tagName === 'default' || tagName === 'defaultvalue') {
156
+ const docDefault = extractFirstLineLiteral(extractJsDocCommentText(tag.comment));
157
+ const codeDefault = formatAstInitializer(param.initializer, sf);
158
+ if (docDefault && codeDefault && docDefault !== codeDefault) {
159
+ diagnostics.push({
160
+ code: 'LUMEN_CODE_DEFAULT_MISMATCH',
161
+ message: `Documented default "${docDefault}" for parameter "${param.name.text}" does not match code definition "${codeDefault}"`,
162
+ file: reportFilePath,
163
+ line: getLineNumber(param),
164
+ severity: 'error',
165
+ suggestedFix: codeDefault,
166
+ });
167
+ }
168
+ }
169
+ }
170
+ }
171
+ }
172
+ return paramMap;
173
+ };
174
+ const verifyCallableNode = (fnNode, jsdocHost) => {
175
+ const paramDefaults = extractFunctionParameters(fnNode.parameters);
176
+ if (paramDefaults.size === 0)
177
+ return;
178
+ const tags = ts.getJSDocTags(jsdocHost);
179
+ if (tags.length === 0)
180
+ return;
181
+ const documentedParamDefaults = new Map();
182
+ const paramNamesInJsDoc = [];
183
+ let hostLevelDefault;
184
+ for (const tag of tags) {
185
+ const tagName = tag.tagName.text.toLowerCase();
186
+ if (ts.isJSDocParameterTag(tag)) {
187
+ const pName = tag.name.getText(sf).trim();
188
+ if (pName) {
189
+ paramNamesInJsDoc.push(pName);
190
+ }
191
+ if (tag.isBracketed) {
192
+ const bracketed = extractBracketedParamDefault(tag.getText(sf));
193
+ if (bracketed?.name && bracketed.defaultVal !== undefined) {
194
+ documentedParamDefaults.set(bracketed.name, bracketed.defaultVal);
195
+ }
196
+ }
197
+ }
198
+ else if (tagName === 'default' || tagName === 'defaultvalue') {
199
+ const parsed = extractFirstLineLiteral(extractJsDocCommentText(tag.comment));
200
+ if (parsed !== '') {
201
+ hostLevelDefault = parsed;
202
+ }
203
+ }
204
+ }
205
+ if (hostLevelDefault !== undefined) {
206
+ const targetParam = paramNamesInJsDoc.find((name) => paramDefaults.has(name) && !documentedParamDefaults.has(name)) ??
207
+ (paramDefaults.size === 1 ? Array.from(paramDefaults.keys())[0] : undefined);
208
+ if (targetParam) {
209
+ documentedParamDefaults.set(targetParam, hostLevelDefault);
210
+ }
211
+ }
212
+ for (const [paramName, docDefault] of documentedParamDefaults.entries()) {
213
+ const actual = paramDefaults.get(paramName);
214
+ if (actual && actual.codeDefault && docDefault !== actual.codeDefault) {
215
+ diagnostics.push({
216
+ code: 'LUMEN_CODE_DEFAULT_MISMATCH',
217
+ message: `Documented default "${docDefault}" for parameter "${paramName}" does not match code definition "${actual.codeDefault}"`,
218
+ file: reportFilePath,
219
+ line: actual.line,
220
+ severity: 'error',
221
+ suggestedFix: actual.codeDefault,
222
+ });
223
+ }
224
+ }
225
+ };
226
+ const visit = (node) => {
227
+ if (ts.isFunctionDeclaration(node) || ts.isMethodDeclaration(node) || ts.isConstructorDeclaration(node)) {
228
+ verifyCallableNode(node, node);
229
+ }
230
+ else if (ts.isVariableStatement(node)) {
231
+ for (const decl of node.declarationList.declarations) {
232
+ if (decl.initializer && (ts.isArrowFunction(decl.initializer) || ts.isFunctionExpression(decl.initializer))) {
233
+ verifyCallableNode(decl.initializer, node);
234
+ }
235
+ }
236
+ }
237
+ else if (ts.isPropertyDeclaration(node) && node.initializer) {
238
+ const propName = node.name.getText(sf);
239
+ const codeDefault = formatAstInitializer(node.initializer, sf);
240
+ collectedDefaultsOut.set(propName, codeDefault);
241
+ for (const tag of ts.getJSDocTags(node)) {
242
+ const tagName = tag.tagName.text.toLowerCase();
243
+ if (tagName === 'default' || tagName === 'defaultvalue') {
244
+ const docDefault = extractFirstLineLiteral(extractJsDocCommentText(tag.comment));
245
+ if (docDefault && codeDefault && docDefault !== codeDefault) {
246
+ diagnostics.push({
247
+ code: 'LUMEN_CODE_DEFAULT_MISMATCH',
248
+ message: `Documented default "${docDefault}" for property "${propName}" does not match code definition "${codeDefault}"`,
249
+ file: reportFilePath,
250
+ line: getLineNumber(node),
251
+ severity: 'error',
252
+ suggestedFix: codeDefault,
253
+ });
254
+ }
255
+ }
256
+ }
257
+ }
258
+ ts.forEachChild(node, visit);
259
+ };
260
+ visit(sf);
261
+ }
262
+ function resolveReferencedSourceFiles(docPath, frontmatter, config) {
263
+ const rawRefs = [];
264
+ if (typeof frontmatter?.['sourceFile'] === 'string') {
265
+ rawRefs.push(frontmatter['sourceFile']);
266
+ }
267
+ if (Array.isArray(frontmatter?.['sourceFiles'])) {
268
+ for (const item of frontmatter['sourceFiles']) {
269
+ if (typeof item === 'string')
270
+ rawRefs.push(item);
271
+ }
272
+ }
273
+ const cfgRecord = config && typeof config === 'object' ? config : undefined;
274
+ if (typeof cfgRecord?.['sourceFile'] === 'string') {
275
+ rawRefs.push(cfgRecord['sourceFile']);
276
+ }
277
+ if (Array.isArray(cfgRecord?.['sourceFiles'])) {
278
+ for (const item of cfgRecord['sourceFiles']) {
279
+ if (typeof item === 'string')
280
+ rawRefs.push(item);
281
+ }
282
+ }
283
+ const resolvedFiles = new Set();
284
+ const docDir = docPath ? dirname(resolve(process.cwd(), docPath)) : process.cwd();
285
+ for (const raw of rawRefs) {
286
+ const trimmed = raw.trim();
287
+ if (!trimmed)
288
+ continue;
289
+ const candidates = [resolve(process.cwd(), trimmed), resolve(docDir, trimmed)];
290
+ for (const candidate of candidates) {
291
+ if (existsSync(candidate) && statSync(candidate).isFile()) {
292
+ resolvedFiles.add(candidate);
293
+ break;
294
+ }
295
+ }
296
+ }
297
+ return Array.from(resolvedFiles);
298
+ }
299
+ function isTsCompatibleCodeBlock(lang) {
300
+ if (!lang)
301
+ return true;
302
+ const primary = (lang.trim().split(/\s+/)[0] ?? '').toLowerCase();
303
+ return CODE_BLOCK_TS_LANGS.has(primary);
304
+ }
305
+ export const codeDefaultsGate = {
306
+ name: 'codeDefaultsGate',
307
+ description: 'Verifies documented component and function parameter defaults against TypeScript AST definitions',
308
+ run(context) {
309
+ const diagnostics = [];
310
+ for (const doc of context.documents) {
311
+ const referencedFiles = resolveReferencedSourceFiles(doc.path, doc.frontmatter, context.config);
312
+ const externalSourceDefaults = new Map();
313
+ for (const sourceFilePath of referencedFiles) {
314
+ try {
315
+ const sourceText = readFileSync(sourceFilePath, 'utf8');
316
+ inspectTypeScriptSourceForDefaults(sourceText, sourceFilePath, doc.path, 1, diagnostics, externalSourceDefaults);
317
+ }
318
+ catch {
319
+ }
320
+ }
321
+ if (!doc.ast?.children)
322
+ continue;
323
+ const inlineCodeDefaults = new Map();
324
+ walkNodes(doc.ast.children, (node) => {
325
+ if (node.type === 'codeBlock' && typeof node.value === 'string') {
326
+ const code = node.value;
327
+ const blockStartLine = node.position?.start?.line ?? 1;
328
+ if (isTsCompatibleCodeBlock(node.lang)) {
329
+ inspectTypeScriptSourceForDefaults(code, `${doc.path || 'snippet'}.tsx`, doc.path, blockStartLine, diagnostics, inlineCodeDefaults);
330
+ }
331
+ if (node.lang?.includes('twoslash') || node.meta?.includes('twoslash')) {
332
+ const lines = code.split('\n');
333
+ for (const line of lines) {
334
+ const parsedOpt = parseTwoslashDirective(line);
335
+ if (parsedOpt) {
336
+ const optName = parsedOpt.rawName.toLowerCase();
337
+ const optVal = parsedOpt.rawValue.toLowerCase();
338
+ if (TWOSLASH_BOOLEAN_FLAGS.has(optName) && optVal !== 'true' && optVal !== 'false') {
339
+ diagnostics.push({
340
+ code: 'LUMEN_INVALID_TWOSLASH_OPTION',
341
+ message: `Invalid boolean value "${parsedOpt.rawValue}" for Twoslash compiler option "@${parsedOpt.rawName}"`,
342
+ file: doc.path,
343
+ severity: 'warning',
344
+ suggestedFix: `// @${parsedOpt.rawName}: true`,
345
+ });
346
+ }
347
+ }
348
+ }
349
+ }
350
+ }
351
+ if (node.type === 'jsxWidget' && node.props && typeof node.props === 'object') {
352
+ const propsObj = node.props;
353
+ const rawItems = propsObj['items'] ??
354
+ propsObj['properties'] ??
355
+ propsObj['rows'] ??
356
+ propsObj['props'] ??
357
+ (propsObj['name'] && (propsObj['default'] !== undefined || propsObj['defaultValue'] !== undefined)
358
+ ? [propsObj]
359
+ : []);
360
+ if (Array.isArray(rawItems)) {
361
+ for (const item of rawItems) {
362
+ if (item && typeof item === 'object') {
363
+ const propRecord = item;
364
+ const propName = String(propRecord['name'] ?? propRecord['prop'] ?? propRecord['parameter'] ?? '');
365
+ const propType = String(propRecord['type'] ?? propRecord['propType'] ?? '').toLowerCase();
366
+ const defVal = propRecord['default'] !== undefined ? propRecord['default'] : propRecord['defaultValue'];
367
+ if (propName && defVal !== undefined) {
368
+ if (propType) {
369
+ if (propType === 'boolean' || propType === 'bool') {
370
+ const isValidBool = defVal === true || defVal === false || defVal === 'true' || defVal === 'false';
371
+ if (!isValidBool) {
372
+ diagnostics.push({
373
+ code: 'LUMEN_INVALID_PROP_DEFAULT',
374
+ message: `Documented default value "${String(defVal)}" does not conform to declared type "${propType}" for prop "${propName}"`,
375
+ file: doc.path,
376
+ severity: 'error',
377
+ });
378
+ }
379
+ }
380
+ if (propType === 'number' || propType === 'integer' || propType === 'int' || propType === 'float') {
381
+ const num = typeof defVal === 'number' ? defVal : Number(String(defVal).trim());
382
+ if (Number.isNaN(num)) {
383
+ diagnostics.push({
384
+ code: 'LUMEN_INVALID_PROP_DEFAULT',
385
+ message: `Documented default value "${String(defVal)}" does not conform to declared type "${propType}" for prop "${propName}"`,
386
+ file: doc.path,
387
+ severity: 'error',
388
+ });
389
+ }
390
+ }
391
+ }
392
+ const expectedCodeDefault = externalSourceDefaults.get(propName);
393
+ if (expectedCodeDefault !== undefined) {
394
+ const normalizedDocDefault = cleanLiteral(String(defVal));
395
+ if (normalizedDocDefault !== expectedCodeDefault) {
396
+ diagnostics.push({
397
+ code: 'LUMEN_CODE_DEFAULT_MISMATCH',
398
+ message: `Documented default "${normalizedDocDefault}" for prop "${propName}" does not match code definition "${expectedCodeDefault}"`,
399
+ file: doc.path,
400
+ line: node.position?.start?.line,
401
+ severity: 'error',
402
+ suggestedFix: expectedCodeDefault,
403
+ });
404
+ }
405
+ }
406
+ }
407
+ }
408
+ }
409
+ }
410
+ }
411
+ });
412
+ const fmDefaults = doc.frontmatter?.['documentedDefaults'];
413
+ if (fmDefaults && typeof fmDefaults === 'object' && !Array.isArray(fmDefaults)) {
414
+ for (const [paramName, rawDocDefault] of Object.entries(fmDefaults)) {
415
+ const expectedCodeDefault = externalSourceDefaults.get(paramName) ?? inlineCodeDefaults.get(paramName);
416
+ if (expectedCodeDefault !== undefined && rawDocDefault !== undefined) {
417
+ const normalizedDocDefault = cleanLiteral(String(rawDocDefault));
418
+ if (normalizedDocDefault !== expectedCodeDefault) {
419
+ diagnostics.push({
420
+ code: 'LUMEN_CODE_DEFAULT_MISMATCH',
421
+ message: `Documented default "${normalizedDocDefault}" for parameter "${paramName}" does not match code definition "${expectedCodeDefault}"`,
422
+ file: doc.path,
423
+ severity: 'error',
424
+ suggestedFix: expectedCodeDefault,
425
+ });
426
+ }
427
+ }
428
+ }
429
+ }
430
+ }
431
+ return {
432
+ name: 'codeDefaultsGate',
433
+ passed: diagnostics.filter((d) => d.severity === 'error').length === 0,
434
+ diagnostics,
435
+ };
436
+ },
437
+ };
438
+ //# sourceMappingURL=defaults.js.map