@thanh01.pmt/research-kit 1.0.0 → 1.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 (78) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +213 -0
  3. package/dist/academic/index.cjs +332 -127
  4. package/dist/academic/index.cjs.map +1 -1
  5. package/dist/academic/index.d.cts +3 -3
  6. package/dist/academic/index.d.ts +3 -3
  7. package/dist/academic/index.js +2 -2
  8. package/dist/{catalogBuilder-8A-Dg_A-.d.ts → catalogBuilder-CmmQzUnf.d.ts} +11 -3
  9. package/dist/{catalogBuilder-feU79wQQ.d.cts → catalogBuilder-DgXYxL2F.d.cts} +11 -3
  10. package/dist/chunk-2JEVBCIF.js +3 -0
  11. package/dist/{chunk-KGCDYFFD.js.map → chunk-2JEVBCIF.js.map} +1 -1
  12. package/dist/chunk-2XIEWCUE.js +244 -0
  13. package/dist/chunk-2XIEWCUE.js.map +1 -0
  14. package/dist/chunk-AUGVVZTL.js +514 -0
  15. package/dist/chunk-AUGVVZTL.js.map +1 -0
  16. package/dist/chunk-DOXSPRSP.js +559 -0
  17. package/dist/chunk-DOXSPRSP.js.map +1 -0
  18. package/dist/chunk-GKF3NDEX.js +162 -0
  19. package/dist/chunk-GKF3NDEX.js.map +1 -0
  20. package/dist/chunk-J3VCGH7Z.js +3 -0
  21. package/dist/chunk-J3VCGH7Z.js.map +1 -0
  22. package/dist/{chunk-67V2GJGK.js → chunk-J7XKDMGL.js} +7 -5
  23. package/dist/chunk-J7XKDMGL.js.map +1 -0
  24. package/dist/chunk-KAFQVI2R.js +333 -0
  25. package/dist/chunk-KAFQVI2R.js.map +1 -0
  26. package/dist/chunk-XIF5YNI7.js +799 -0
  27. package/dist/chunk-XIF5YNI7.js.map +1 -0
  28. package/dist/config/index.cjs +5 -3
  29. package/dist/config/index.cjs.map +1 -1
  30. package/dist/config/index.d.cts +1 -1
  31. package/dist/config/index.d.ts +1 -1
  32. package/dist/config/index.js +1 -1
  33. package/dist/evidence/index.cjs +337 -21
  34. package/dist/evidence/index.cjs.map +1 -1
  35. package/dist/evidence/index.d.cts +44 -7
  36. package/dist/evidence/index.d.ts +44 -7
  37. package/dist/evidence/index.js +3 -2
  38. package/dist/harvester/index.cjs +805 -64
  39. package/dist/harvester/index.cjs.map +1 -1
  40. package/dist/harvester/index.d.cts +79 -8
  41. package/dist/harvester/index.d.ts +79 -8
  42. package/dist/harvester/index.js +3 -2
  43. package/dist/{index-BU5n1ip_.d.ts → index-t8pahlJ4.d.cts} +104 -15
  44. package/dist/{index-BU5n1ip_.d.cts → index-t8pahlJ4.d.ts} +104 -15
  45. package/dist/index.cjs +2001 -252
  46. package/dist/index.cjs.map +1 -1
  47. package/dist/index.d.cts +156 -8
  48. package/dist/index.d.ts +156 -8
  49. package/dist/index.js +237 -8
  50. package/dist/index.js.map +1 -1
  51. package/dist/literatureReview-BTPFe7eb.d.cts +64 -0
  52. package/dist/literatureReview-hGbfrBmw.d.ts +64 -0
  53. package/dist/pipeline/index.cjs +1570 -241
  54. package/dist/pipeline/index.cjs.map +1 -1
  55. package/dist/pipeline/index.d.cts +49 -9
  56. package/dist/pipeline/index.d.ts +49 -9
  57. package/dist/pipeline/index.js +5 -4
  58. package/dist/webScraper-BhiQ8s9x.d.ts +68 -0
  59. package/dist/webScraper-D9Ldus9p.d.cts +68 -0
  60. package/package.json +8 -9
  61. package/dist/chunk-47L7ZHMY.js +0 -316
  62. package/dist/chunk-47L7ZHMY.js.map +0 -1
  63. package/dist/chunk-63X2HPCI.js +0 -47
  64. package/dist/chunk-63X2HPCI.js.map +0 -1
  65. package/dist/chunk-67V2GJGK.js.map +0 -1
  66. package/dist/chunk-6Q2XCUG7.js +0 -40
  67. package/dist/chunk-6Q2XCUG7.js.map +0 -1
  68. package/dist/chunk-KGCDYFFD.js +0 -3
  69. package/dist/chunk-MHAYD555.js +0 -239
  70. package/dist/chunk-MHAYD555.js.map +0 -1
  71. package/dist/chunk-MPLDSHFM.js +0 -396
  72. package/dist/chunk-MPLDSHFM.js.map +0 -1
  73. package/dist/chunk-QZNLB5X4.js +0 -65
  74. package/dist/chunk-QZNLB5X4.js.map +0 -1
  75. package/dist/literatureReview-C4AgVljZ.d.ts +0 -43
  76. package/dist/literatureReview-Dlods4Aw.d.cts +0 -43
  77. package/dist/webScraper-pKzdXhfI.d.ts +0 -46
  78. package/dist/webScraper-yBcYOHoL.d.cts +0 -46
@@ -0,0 +1,64 @@
1
+ import { C as CourseResearchContext, A as AcademicPaper, L as LlmTextFn } from './index-t8pahlJ4.cjs';
2
+
3
+ interface CS2023KnowledgeArea {
4
+ code: string;
5
+ name: string;
6
+ description: string;
7
+ coreTopics: string[];
8
+ }
9
+ interface CSTAK12Strand {
10
+ code: 'CS' | 'NI' | 'DA' | 'AP' | 'IC';
11
+ name: string;
12
+ nameVi: string;
13
+ description: string;
14
+ subconcepts: string[];
15
+ }
16
+ declare const CSTA_K12_STRANDS: Record<string, CSTAK12Strand>;
17
+ declare const CS2023_KNOWLEDGE_AREAS: Record<string, CS2023KnowledgeArea>;
18
+ interface TaxonomyMappingResult {
19
+ area: CS2023KnowledgeArea;
20
+ k12Strand: CSTAK12Strand;
21
+ matchConfidence: number;
22
+ }
23
+ /**
24
+ * Maps a course topic or syllabus keyword (English or Vietnamese) to both IEEE/ACM CS2023 Knowledge Areas
25
+ * and CSTA K-12 CS Strands.
26
+ */
27
+ declare function mapTopicToCS2023(topic: string, context?: CourseResearchContext): TaxonomyMappingResult;
28
+
29
+ interface SotaComparisonRow {
30
+ approach: string;
31
+ sourcePaper: string;
32
+ keyStrengths: string;
33
+ limitations: string;
34
+ relevanceToCourse: string;
35
+ }
36
+ interface LiteratureReviewReport {
37
+ topic: string;
38
+ cs2023Area?: CS2023KnowledgeArea;
39
+ k12Strand?: CSTAK12Strand;
40
+ totalPapersFound: number;
41
+ papers: AcademicPaper[];
42
+ sotaMatrix: SotaComparisonRow[];
43
+ keyTheoreticalFoundations: string[];
44
+ openResearchQuestions: string[];
45
+ markdownReport: string;
46
+ bibtex: string;
47
+ }
48
+ /**
49
+ * Synthesizes academic literature, SOTA matrices, and course theoretical foundations from real retrieved papers
50
+ * and matched CS2023 / CSTA K-12 areas (Zero hardcoded concurrency strings).
51
+ */
52
+ declare class LiteratureReviewSynthesizer {
53
+ synthesize(topic: string, papers: AcademicPaper[], cs2023Area?: CS2023KnowledgeArea, k12Strand?: CSTAK12Strand): LiteratureReviewReport;
54
+ /**
55
+ * Optional LLM semantic synthesis of dynamic open research questions and pedagogical takeaways
56
+ * based on the retrieved academic literature.
57
+ */
58
+ synthesizeWithLlm(topic: string, papers: AcademicPaper[], cs2023Area?: CS2023KnowledgeArea, k12Strand?: CSTAK12Strand, options?: {
59
+ llm?: LlmTextFn;
60
+ context?: CourseResearchContext;
61
+ }): Promise<LiteratureReviewReport>;
62
+ }
63
+
64
+ export { type CS2023KnowledgeArea as C, type LiteratureReviewReport as L, type SotaComparisonRow as S, type TaxonomyMappingResult as T, type CSTAK12Strand as a, CSTA_K12_STRANDS as b, CS2023_KNOWLEDGE_AREAS as c, LiteratureReviewSynthesizer as d, mapTopicToCS2023 as m };
@@ -0,0 +1,64 @@
1
+ import { C as CourseResearchContext, A as AcademicPaper, L as LlmTextFn } from './index-t8pahlJ4.js';
2
+
3
+ interface CS2023KnowledgeArea {
4
+ code: string;
5
+ name: string;
6
+ description: string;
7
+ coreTopics: string[];
8
+ }
9
+ interface CSTAK12Strand {
10
+ code: 'CS' | 'NI' | 'DA' | 'AP' | 'IC';
11
+ name: string;
12
+ nameVi: string;
13
+ description: string;
14
+ subconcepts: string[];
15
+ }
16
+ declare const CSTA_K12_STRANDS: Record<string, CSTAK12Strand>;
17
+ declare const CS2023_KNOWLEDGE_AREAS: Record<string, CS2023KnowledgeArea>;
18
+ interface TaxonomyMappingResult {
19
+ area: CS2023KnowledgeArea;
20
+ k12Strand: CSTAK12Strand;
21
+ matchConfidence: number;
22
+ }
23
+ /**
24
+ * Maps a course topic or syllabus keyword (English or Vietnamese) to both IEEE/ACM CS2023 Knowledge Areas
25
+ * and CSTA K-12 CS Strands.
26
+ */
27
+ declare function mapTopicToCS2023(topic: string, context?: CourseResearchContext): TaxonomyMappingResult;
28
+
29
+ interface SotaComparisonRow {
30
+ approach: string;
31
+ sourcePaper: string;
32
+ keyStrengths: string;
33
+ limitations: string;
34
+ relevanceToCourse: string;
35
+ }
36
+ interface LiteratureReviewReport {
37
+ topic: string;
38
+ cs2023Area?: CS2023KnowledgeArea;
39
+ k12Strand?: CSTAK12Strand;
40
+ totalPapersFound: number;
41
+ papers: AcademicPaper[];
42
+ sotaMatrix: SotaComparisonRow[];
43
+ keyTheoreticalFoundations: string[];
44
+ openResearchQuestions: string[];
45
+ markdownReport: string;
46
+ bibtex: string;
47
+ }
48
+ /**
49
+ * Synthesizes academic literature, SOTA matrices, and course theoretical foundations from real retrieved papers
50
+ * and matched CS2023 / CSTA K-12 areas (Zero hardcoded concurrency strings).
51
+ */
52
+ declare class LiteratureReviewSynthesizer {
53
+ synthesize(topic: string, papers: AcademicPaper[], cs2023Area?: CS2023KnowledgeArea, k12Strand?: CSTAK12Strand): LiteratureReviewReport;
54
+ /**
55
+ * Optional LLM semantic synthesis of dynamic open research questions and pedagogical takeaways
56
+ * based on the retrieved academic literature.
57
+ */
58
+ synthesizeWithLlm(topic: string, papers: AcademicPaper[], cs2023Area?: CS2023KnowledgeArea, k12Strand?: CSTAK12Strand, options?: {
59
+ llm?: LlmTextFn;
60
+ context?: CourseResearchContext;
61
+ }): Promise<LiteratureReviewReport>;
62
+ }
63
+
64
+ export { type CS2023KnowledgeArea as C, type LiteratureReviewReport as L, type SotaComparisonRow as S, type TaxonomyMappingResult as T, type CSTAK12Strand as a, CSTA_K12_STRANDS as b, CS2023_KNOWLEDGE_AREAS as c, LiteratureReviewSynthesizer as d, mapTopicToCS2023 as m };