@hstm-labs/forge-spec-parser 0.1.2

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 (70) hide show
  1. package/README.md +53 -0
  2. package/dist/default-registry.d.ts +19 -0
  3. package/dist/default-registry.d.ts.map +1 -0
  4. package/dist/default-registry.js +28 -0
  5. package/dist/default-registry.js.map +1 -0
  6. package/dist/detect.d.ts +16 -0
  7. package/dist/detect.d.ts.map +1 -0
  8. package/dist/detect.js +32 -0
  9. package/dist/detect.js.map +1 -0
  10. package/dist/index.d.ts +18 -0
  11. package/dist/index.d.ts.map +1 -0
  12. package/dist/index.js +23 -0
  13. package/dist/index.js.map +1 -0
  14. package/dist/loader.d.ts +31 -0
  15. package/dist/loader.d.ts.map +1 -0
  16. package/dist/loader.js +45 -0
  17. package/dist/loader.js.map +1 -0
  18. package/dist/parser-plugin.d.ts +23 -0
  19. package/dist/parser-plugin.d.ts.map +1 -0
  20. package/dist/parser-plugin.js +8 -0
  21. package/dist/parser-plugin.js.map +1 -0
  22. package/dist/parsers/json-parser.d.ts +35 -0
  23. package/dist/parsers/json-parser.d.ts.map +1 -0
  24. package/dist/parsers/json-parser.js +46 -0
  25. package/dist/parsers/json-parser.js.map +1 -0
  26. package/dist/parsers/markdown-parser.d.ts +41 -0
  27. package/dist/parsers/markdown-parser.d.ts.map +1 -0
  28. package/dist/parsers/markdown-parser.js +606 -0
  29. package/dist/parsers/markdown-parser.js.map +1 -0
  30. package/dist/parsers/structured-mapper.d.ts +22 -0
  31. package/dist/parsers/structured-mapper.d.ts.map +1 -0
  32. package/dist/parsers/structured-mapper.js +214 -0
  33. package/dist/parsers/structured-mapper.js.map +1 -0
  34. package/dist/parsers/yaml-parser.d.ts +35 -0
  35. package/dist/parsers/yaml-parser.d.ts.map +1 -0
  36. package/dist/parsers/yaml-parser.js +47 -0
  37. package/dist/parsers/yaml-parser.js.map +1 -0
  38. package/dist/registry.d.ts +57 -0
  39. package/dist/registry.d.ts.map +1 -0
  40. package/dist/registry.js +80 -0
  41. package/dist/registry.js.map +1 -0
  42. package/dist/types.d.ts +85 -0
  43. package/dist/types.d.ts.map +1 -0
  44. package/dist/types.js +8 -0
  45. package/dist/types.js.map +1 -0
  46. package/dist/validate-stage.d.ts +18 -0
  47. package/dist/validate-stage.d.ts.map +1 -0
  48. package/dist/validate-stage.js +24 -0
  49. package/dist/validate-stage.js.map +1 -0
  50. package/dist/validation-types.d.ts +46 -0
  51. package/dist/validation-types.d.ts.map +1 -0
  52. package/dist/validation-types.js +9 -0
  53. package/dist/validation-types.js.map +1 -0
  54. package/dist/validators/completeness-checker.d.ts +29 -0
  55. package/dist/validators/completeness-checker.d.ts.map +1 -0
  56. package/dist/validators/completeness-checker.js +127 -0
  57. package/dist/validators/completeness-checker.js.map +1 -0
  58. package/dist/validators/cross-reference-validator.d.ts +17 -0
  59. package/dist/validators/cross-reference-validator.d.ts.map +1 -0
  60. package/dist/validators/cross-reference-validator.js +150 -0
  61. package/dist/validators/cross-reference-validator.js.map +1 -0
  62. package/dist/validators/schema-validator.d.ts +16 -0
  63. package/dist/validators/schema-validator.d.ts.map +1 -0
  64. package/dist/validators/schema-validator.js +146 -0
  65. package/dist/validators/schema-validator.js.map +1 -0
  66. package/dist/validators/spec-validator.d.ts +15 -0
  67. package/dist/validators/spec-validator.d.ts.map +1 -0
  68. package/dist/validators/spec-validator.js +52 -0
  69. package/dist/validators/spec-validator.js.map +1 -0
  70. package/package.json +29 -0
@@ -0,0 +1,52 @@
1
+ /**
2
+ * Main specification validator — orchestrates all validators and produces
3
+ * a complete {@link ValidationReport}.
4
+ */
5
+ import { validateSchema } from './schema-validator.js';
6
+ import { checkCompleteness } from './completeness-checker.js';
7
+ import { validateCrossReferences } from './cross-reference-validator.js';
8
+ /**
9
+ * Validate a parsed specification across all dimensions: schema,
10
+ * completeness, and cross-references.
11
+ *
12
+ * @param spec - The parsed specification to validate
13
+ * @returns A complete validation report
14
+ */
15
+ export function validateSpec(spec) {
16
+ // Run all validators
17
+ const schemaFindings = validateSchema(spec);
18
+ const completenessResult = checkCompleteness(spec);
19
+ const crossRefFindings = validateCrossReferences(spec);
20
+ // Aggregate findings
21
+ const findings = [
22
+ ...schemaFindings,
23
+ ...completenessResult.findings,
24
+ ...crossRefFindings,
25
+ ];
26
+ // Build summary
27
+ let errors = 0;
28
+ let warnings = 0;
29
+ let info = 0;
30
+ for (const f of findings) {
31
+ switch (f.severity) {
32
+ case 'error':
33
+ errors++;
34
+ break;
35
+ case 'warning':
36
+ warnings++;
37
+ break;
38
+ case 'info':
39
+ info++;
40
+ break;
41
+ }
42
+ }
43
+ return {
44
+ specPath: spec.metadata.sourcePath,
45
+ valid: errors === 0,
46
+ completenessScore: completenessResult.score,
47
+ findings,
48
+ summary: { errors, warnings, info },
49
+ checkedAt: new Date().toISOString(),
50
+ };
51
+ }
52
+ //# sourceMappingURL=spec-validator.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"spec-validator.js","sourceRoot":"","sources":["../../src/validators/spec-validator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAEzE;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAyB;IAEzB,qBAAqB;IACrB,MAAM,cAAc,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,kBAAkB,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACnD,MAAM,gBAAgB,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC;IAEvD,qBAAqB;IACrB,MAAM,QAAQ,GAAG;QACf,GAAG,cAAc;QACjB,GAAG,kBAAkB,CAAC,QAAQ;QAC9B,GAAG,gBAAgB;KACpB,CAAC;IAEF,gBAAgB;IAChB,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC;YACnB,KAAK,OAAO;gBACV,MAAM,EAAE,CAAC;gBACT,MAAM;YACR,KAAK,SAAS;gBACZ,QAAQ,EAAE,CAAC;gBACX,MAAM;YACR,KAAK,MAAM;gBACT,IAAI,EAAE,CAAC;gBACP,MAAM;QACV,CAAC;IACH,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU;QAClC,KAAK,EAAE,MAAM,KAAK,CAAC;QACnB,iBAAiB,EAAE,kBAAkB,CAAC,KAAK;QAC3C,QAAQ;QACR,OAAO,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE;QACnC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC"}
package/package.json ADDED
@@ -0,0 +1,29 @@
1
+ {
2
+ "name": "@hstm-labs/forge-spec-parser",
3
+ "version": "0.1.2",
4
+ "type": "module",
5
+ "main": "dist/index.js",
6
+ "types": "dist/index.d.ts",
7
+ "files": [
8
+ "dist"
9
+ ],
10
+ "publishConfig": {
11
+ "access": "public"
12
+ },
13
+ "scripts": {
14
+ "build": "tsc",
15
+ "test": "vitest run",
16
+ "prepublishOnly": "npm run build"
17
+ },
18
+ "dependencies": {
19
+ "@hstm-labs/forge-common": "0.1.2",
20
+ "remark-frontmatter": "^5.0.0",
21
+ "remark-gfm": "^4.0.1",
22
+ "remark-parse": "^11.0.0",
23
+ "unified": "^11.0.5",
24
+ "yaml": "^2.8.2"
25
+ },
26
+ "devDependencies": {
27
+ "@types/node": "^25.2.3"
28
+ }
29
+ }