okf-core 0.0.0-bootstrap → 1.0.0-rc.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.
- package/LICENSE +203 -0
- package/README.md +40 -4
- package/dist/analyze.d.ts +6 -0
- package/dist/analyze.d.ts.map +1 -0
- package/dist/analyze.js +218 -0
- package/dist/analyze.js.map +1 -0
- package/dist/changes.d.ts +6 -0
- package/dist/changes.d.ts.map +1 -0
- package/dist/changes.js +81 -0
- package/dist/changes.js.map +1 -0
- package/dist/conformance.d.ts +5 -0
- package/dist/conformance.d.ts.map +1 -0
- package/dist/conformance.js +103 -0
- package/dist/conformance.js.map +1 -0
- package/dist/derive.d.ts +7 -0
- package/dist/derive.d.ts.map +1 -0
- package/dist/derive.js +199 -0
- package/dist/derive.js.map +1 -0
- package/dist/diagnostics.d.ts +4 -0
- package/dist/diagnostics.d.ts.map +1 -0
- package/dist/diagnostics.js +19 -0
- package/dist/diagnostics.js.map +1 -0
- package/dist/diff.d.ts +2 -0
- package/dist/diff.d.ts.map +1 -0
- package/dist/diff.js +76 -0
- package/dist/diff.js.map +1 -0
- package/dist/frontmatter.d.ts +12 -0
- package/dist/frontmatter.d.ts.map +1 -0
- package/dist/frontmatter.js +110 -0
- package/dist/frontmatter.js.map +1 -0
- package/dist/graph.d.ts +3 -0
- package/dist/graph.d.ts.map +1 -0
- package/dist/graph.js +42 -0
- package/dist/graph.js.map +1 -0
- package/dist/index.d.ts +11 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +8 -0
- package/dist/index.js.map +1 -0
- package/dist/links.d.ts +10 -0
- package/dist/links.d.ts.map +1 -0
- package/dist/links.js +104 -0
- package/dist/links.js.map +1 -0
- package/dist/markdown.d.ts +18 -0
- package/dist/markdown.d.ts.map +1 -0
- package/dist/markdown.js +22 -0
- package/dist/markdown.js.map +1 -0
- package/dist/paths.d.ts +35 -0
- package/dist/paths.d.ts.map +1 -0
- package/dist/paths.js +103 -0
- package/dist/paths.js.map +1 -0
- package/dist/search.d.ts +5 -0
- package/dist/search.d.ts.map +1 -0
- package/dist/search.js +122 -0
- package/dist/search.js.map +1 -0
- package/dist/types.d.ts +44 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +2 -0
- package/dist/types.js.map +1 -0
- package/package.json +31 -5
|
@@ -0,0 +1,103 @@
|
|
|
1
|
+
import { diagnostic } from "./diagnostics.js";
|
|
2
|
+
import { validDate } from "./derive.js";
|
|
3
|
+
import { markdownBlocks, markdownHeadings } from "./markdown.js";
|
|
4
|
+
import { isSafeMarkdownPath } from "./paths.js";
|
|
5
|
+
export function documentKind(path) {
|
|
6
|
+
const name = path.split("/").at(-1);
|
|
7
|
+
return name === "index.md" ? "index" : name === "log.md" ? "log" : "concept";
|
|
8
|
+
}
|
|
9
|
+
export function coreDiagnostics(path, kind, parsed) {
|
|
10
|
+
const result = [];
|
|
11
|
+
if (!isSafeMarkdownPath(path)) {
|
|
12
|
+
result.push(diagnostic("core", "error", "core.bundle.path.invalid", path, "document path must be a confined bundle-relative .md path"));
|
|
13
|
+
}
|
|
14
|
+
if (kind === "concept") {
|
|
15
|
+
if (!parsed.hadFrontmatter) {
|
|
16
|
+
result.push(diagnostic("core", "error", "core.concept.frontmatter.missing", path, "concept must begin with YAML frontmatter"));
|
|
17
|
+
return result;
|
|
18
|
+
}
|
|
19
|
+
if (parsed.error !== null || parsed.snapshot === null) {
|
|
20
|
+
const jsonBoundary = parsed.errorKind === "json";
|
|
21
|
+
result.push(diagnostic("core", "error", jsonBoundary ? "core.concept.frontmatter.non-json" : "core.concept.frontmatter.invalid-yaml", path, jsonBoundary
|
|
22
|
+
? `okf.inspect.v1 cannot represent concept frontmatter: ${parsed.error ?? "unknown error"}`
|
|
23
|
+
: `concept frontmatter is not a parseable YAML mapping: ${parsed.error ?? "unknown error"}`));
|
|
24
|
+
return result;
|
|
25
|
+
}
|
|
26
|
+
const type = parsed.snapshot.metadata["type"];
|
|
27
|
+
if (typeof type !== "string" || !type.trim()) {
|
|
28
|
+
result.push(diagnostic("core", "error", "core.concept.type.missing", path, "concept type must be a non-empty string"));
|
|
29
|
+
}
|
|
30
|
+
return result;
|
|
31
|
+
}
|
|
32
|
+
if (parsed.hadFrontmatter && parsed.error !== null) {
|
|
33
|
+
const jsonBoundary = parsed.errorKind === "json";
|
|
34
|
+
result.push(diagnostic("core", "error", jsonBoundary ? `core.${kind}.frontmatter.non-json` : `core.${kind}.frontmatter.invalid-yaml`, path, jsonBoundary
|
|
35
|
+
? `okf.inspect.v1 cannot represent ${kind} frontmatter: ${parsed.error}`
|
|
36
|
+
: `${kind} frontmatter is not a parseable YAML mapping: ${parsed.error}`));
|
|
37
|
+
}
|
|
38
|
+
if (kind === "index") {
|
|
39
|
+
if (path === "index.md") {
|
|
40
|
+
if (parsed.snapshot !== null) {
|
|
41
|
+
const keys = Object.keys(parsed.snapshot.metadata);
|
|
42
|
+
if (keys.some((key) => key !== "okf_version")) {
|
|
43
|
+
result.push(diagnostic("core", "error", "core.index.frontmatter.keys", path, "root index frontmatter supports only okf_version"));
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
else if (parsed.hadFrontmatter) {
|
|
48
|
+
result.push(diagnostic("core", "error", "core.index.frontmatter.nested", path, "nested index.md must not contain frontmatter"));
|
|
49
|
+
}
|
|
50
|
+
if (markdownHeadings(parsed.body).length === 0) {
|
|
51
|
+
result.push(diagnostic("core", "error", "core.index.heading.missing", path, "index must contain a Markdown heading"));
|
|
52
|
+
}
|
|
53
|
+
return result;
|
|
54
|
+
}
|
|
55
|
+
if (parsed.hadFrontmatter) {
|
|
56
|
+
result.push(diagnostic("core", "error", "core.log.frontmatter.forbidden", path, "log.md must not contain frontmatter"));
|
|
57
|
+
}
|
|
58
|
+
const blocks = markdownBlocks(parsed.body);
|
|
59
|
+
const headings = blocks.flatMap((block) => block.type === "heading" ? [block] : []);
|
|
60
|
+
if (headings.length === 0) {
|
|
61
|
+
result.push(diagnostic("core", "error", "core.log.heading.missing", path, "log must contain a Markdown heading"));
|
|
62
|
+
}
|
|
63
|
+
const dateHeadings = headings.filter((heading) => heading.depth === 2);
|
|
64
|
+
if (dateHeadings.length === 0) {
|
|
65
|
+
result.push(diagnostic("core", "error", "core.log.date-group.missing", path, "log must contain at least one level-two YYYY-MM-DD date group"));
|
|
66
|
+
}
|
|
67
|
+
const validDates = [];
|
|
68
|
+
for (const heading of dateHeadings) {
|
|
69
|
+
const value = heading.text.trim();
|
|
70
|
+
if (!validDate(value)) {
|
|
71
|
+
result.push(diagnostic("core", "error", "core.log.heading.date", path, `log date heading must be YYYY-MM-DD: ${value}`));
|
|
72
|
+
}
|
|
73
|
+
else {
|
|
74
|
+
validDates.push(value);
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
for (const [blockIndex, block] of blocks.entries()) {
|
|
78
|
+
if (block.type !== "heading" || block.depth !== 2) {
|
|
79
|
+
continue;
|
|
80
|
+
}
|
|
81
|
+
let groupEnd = blocks.length;
|
|
82
|
+
for (let candidateIndex = blockIndex + 1; candidateIndex < blocks.length; candidateIndex += 1) {
|
|
83
|
+
const candidate = blocks[candidateIndex];
|
|
84
|
+
if (candidate.type === "heading" && candidate.depth === 2) {
|
|
85
|
+
groupEnd = candidateIndex;
|
|
86
|
+
break;
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
if (!blocks.slice(blockIndex + 1, groupEnd).some((candidate) => candidate.type === "list")) {
|
|
90
|
+
result.push(diagnostic("core", "error", "core.log.date-group.list", path, `log date group must contain a top-level list of entries: ${block.text.trim()}`));
|
|
91
|
+
}
|
|
92
|
+
}
|
|
93
|
+
for (let index = 1; index < validDates.length; index += 1) {
|
|
94
|
+
const previous = validDates[index - 1];
|
|
95
|
+
const current = validDates[index];
|
|
96
|
+
if (current > previous) {
|
|
97
|
+
result.push(diagnostic("core", "error", "core.log.heading.order", path, `log date groups must be newest first: ${current} follows ${previous}`));
|
|
98
|
+
break;
|
|
99
|
+
}
|
|
100
|
+
}
|
|
101
|
+
return result;
|
|
102
|
+
}
|
|
103
|
+
//# sourceMappingURL=conformance.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"conformance.js","sourceRoot":"","sources":["../src/conformance.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACpC,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,IAAY,EACZ,IAAkB,EAClB,MAA8B;IAE9B,MAAM,MAAM,GAAiB,EAAE,CAAC;IAChC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CACT,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,0BAA0B,EAAE,IAAI,EAAE,2DAA2D,CAAC,CAC3H,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;YAC3B,MAAM,CAAC,IAAI,CACT,UAAU,CACR,MAAM,EACN,OAAO,EACP,kCAAkC,EAClC,IAAI,EACJ,0CAA0C,CAC3C,CACF,CAAC;YACF,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI,IAAI,MAAM,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtD,MAAM,YAAY,GAAG,MAAM,CAAC,SAAS,KAAK,MAAM,CAAC;YACjD,MAAM,CAAC,IAAI,CACT,UAAU,CACR,MAAM,EACN,OAAO,EACP,YAAY,CAAC,CAAC,CAAC,mCAAmC,CAAC,CAAC,CAAC,uCAAuC,EAC5F,IAAI,EACJ,YAAY;gBACV,CAAC,CAAC,wDAAwD,MAAM,CAAC,KAAK,IAAI,eAAe,EAAE;gBAC3F,CAAC,CAAC,wDAAwD,MAAM,CAAC,KAAK,IAAI,eAAe,EAAE,CAC9F,CACF,CAAC;YACF,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC9C,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YAC7C,MAAM,CAAC,IAAI,CACT,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,2BAA2B,EAAE,IAAI,EAAE,yCAAyC,CAAC,CAC1G,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,MAAM,CAAC,cAAc,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QACnD,MAAM,YAAY,GAAG,MAAM,CAAC,SAAS,KAAK,MAAM,CAAC;QACjD,MAAM,CAAC,IAAI,CACT,UAAU,CACR,MAAM,EACN,OAAO,EACP,YAAY,CAAC,CAAC,CAAC,QAAQ,IAAI,uBAAuB,CAAC,CAAC,CAAC,QAAQ,IAAI,2BAA2B,EAC5F,IAAI,EACJ,YAAY;YACV,CAAC,CAAC,mCAAmC,IAAI,iBAAiB,MAAM,CAAC,KAAK,EAAE;YACxE,CAAC,CAAC,GAAG,IAAI,iDAAiD,MAAM,CAAC,KAAK,EAAE,CAC3E,CACF,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACrB,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;YACxB,IAAI,MAAM,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;gBAC7B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBACnD,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,aAAa,CAAC,EAAE,CAAC;oBAC9C,MAAM,CAAC,IAAI,CACT,UAAU,CACR,MAAM,EACN,OAAO,EACP,6BAA6B,EAC7B,IAAI,EACJ,kDAAkD,CACnD,CACF,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;aAAM,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;YACjC,MAAM,CAAC,IAAI,CACT,UAAU,CACR,MAAM,EACN,OAAO,EACP,+BAA+B,EAC/B,IAAI,EACJ,8CAA8C,CAC/C,CACF,CAAC;QACJ,CAAC;QACD,IAAI,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/C,MAAM,CAAC,IAAI,CACT,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,4BAA4B,EAAE,IAAI,EAAE,uCAAuC,CAAC,CACzG,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;QAC1B,MAAM,CAAC,IAAI,CACT,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,gCAAgC,EAAE,IAAI,EAAE,qCAAqC,CAAC,CAC3G,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACpF,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,0BAA0B,EAAE,IAAI,EAAE,qCAAqC,CAAC,CAAC,CAAC;IACpH,CAAC;IACD,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC;IACvE,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CACT,UAAU,CACR,MAAM,EACN,OAAO,EACP,6BAA6B,EAC7B,IAAI,EACJ,+DAA+D,CAChE,CACF,CAAC;IACJ,CAAC;IACD,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,KAAK,MAAM,OAAO,IAAI,YAAY,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAClC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YACtB,MAAM,CAAC,IAAI,CACT,UAAU,CACR,MAAM,EACN,OAAO,EACP,uBAAuB,EACvB,IAAI,EACJ,wCAAwC,KAAK,EAAE,CAChD,CACF,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IACD,KAAK,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;QACnD,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;YAClD,SAAS;QACX,CAAC;QACD,IAAI,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC;QAC7B,KAAK,IAAI,cAAc,GAAG,UAAU,GAAG,CAAC,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,IAAI,CAAC,EAAE,CAAC;YAC9F,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAE,CAAC;YAC1C,IAAI,SAAS,CAAC,IAAI,KAAK,SAAS,IAAI,SAAS,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;gBAC1D,QAAQ,GAAG,cAAc,CAAC;gBAC1B,MAAM;YACR,CAAC;QACH,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,MAAM,CAAC,EAAE,CAAC;YAC3F,MAAM,CAAC,IAAI,CACT,UAAU,CACR,MAAM,EACN,OAAO,EACP,0BAA0B,EAC1B,IAAI,EACJ,4DAA4D,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAChF,CACF,CAAC;QACJ,CAAC;IACH,CAAC;IACD,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,UAAU,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC1D,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,GAAG,CAAC,CAAE,CAAC;QACxC,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAE,CAAC;QACnC,IAAI,OAAO,GAAG,QAAQ,EAAE,CAAC;YACvB,MAAM,CAAC,IAAI,CACT,UAAU,CACR,MAAM,EACN,OAAO,EACP,wBAAwB,EACxB,IAAI,EACJ,yCAAyC,OAAO,YAAY,QAAQ,EAAE,CACvE,CACF,CAAC;YACF,MAAM;QACR,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}
|
package/dist/derive.d.ts
ADDED
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
import type { DerivedDocumentFields, Diagnostic } from "okf-contracts";
|
|
2
|
+
export declare function validDate(value: string): boolean;
|
|
3
|
+
export declare function deriveDocumentFields(metadata: Readonly<Record<string, unknown>>, body: string, path: string, knownPaths: ReadonlySet<string>, today: string | null): {
|
|
4
|
+
readonly derived: DerivedDocumentFields;
|
|
5
|
+
readonly guidance: readonly Diagnostic[];
|
|
6
|
+
};
|
|
7
|
+
//# sourceMappingURL=derive.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"derive.d.ts","sourceRoot":"","sources":["../src/derive.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,qBAAqB,EACrB,UAAU,EAEX,MAAM,eAAe,CAAC;AAoBvB,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAUhD;AA6OD,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC3C,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,EAC/B,KAAK,EAAE,MAAM,GAAG,IAAI,GACnB;IAAE,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,UAAU,EAAE,CAAA;CAAE,CAmCvF"}
|
package/dist/derive.js
ADDED
|
@@ -0,0 +1,199 @@
|
|
|
1
|
+
import { diagnostic } from "./diagnostics.js";
|
|
2
|
+
import { markdownHeadings } from "./markdown.js";
|
|
3
|
+
import { resolveWithinBundle } from "./paths.js";
|
|
4
|
+
const DATE = /^(\d{4})-(\d{2})-(\d{2})$/;
|
|
5
|
+
const DATETIME = /^(\d{4}-\d{2}-\d{2})T(\d{2}):(\d{2}):(\d{2})(?:\.\d+)?(?:Z|([+-])(\d{2}):(\d{2}))$/;
|
|
6
|
+
const ACTOR = /^(?:human:[^\s/:]+|process:[^\s/:]+|[^\s/:]+\/[^\s/:]+)$/;
|
|
7
|
+
const VALID_STATUSES = new Set(["draft", "stable", "deprecated"]);
|
|
8
|
+
const SCHEME = /^[A-Za-z][A-Za-z0-9+.-]*:/;
|
|
9
|
+
function nonempty(value) {
|
|
10
|
+
return typeof value === "string" && value.trim() ? value.trim() : null;
|
|
11
|
+
}
|
|
12
|
+
function mapping(value) {
|
|
13
|
+
return typeof value === "object" && value !== null && !Array.isArray(value);
|
|
14
|
+
}
|
|
15
|
+
export function validDate(value) {
|
|
16
|
+
const match = DATE.exec(value);
|
|
17
|
+
if (!match) {
|
|
18
|
+
return false;
|
|
19
|
+
}
|
|
20
|
+
const year = Number(match[1]);
|
|
21
|
+
const month = Number(match[2]);
|
|
22
|
+
const day = Number(match[3]);
|
|
23
|
+
const date = new Date(Date.UTC(year, month - 1, day));
|
|
24
|
+
return date.getUTCFullYear() === year && date.getUTCMonth() === month - 1 && date.getUTCDate() === day;
|
|
25
|
+
}
|
|
26
|
+
function validRecordedAt(value) {
|
|
27
|
+
if (typeof value !== "string") {
|
|
28
|
+
return false;
|
|
29
|
+
}
|
|
30
|
+
if (validDate(value)) {
|
|
31
|
+
return true;
|
|
32
|
+
}
|
|
33
|
+
const match = DATETIME.exec(value);
|
|
34
|
+
if (!match || !validDate(match[1])) {
|
|
35
|
+
return false;
|
|
36
|
+
}
|
|
37
|
+
const hour = Number(match[2]);
|
|
38
|
+
const minute = Number(match[3]);
|
|
39
|
+
const second = Number(match[4]);
|
|
40
|
+
const offsetHour = match[6] === undefined ? 0 : Number(match[6]);
|
|
41
|
+
const offsetMinute = match[7] === undefined ? 0 : Number(match[7]);
|
|
42
|
+
return hour <= 23 && minute <= 59 && second <= 59 && offsetHour <= 23 && offsetMinute <= 59;
|
|
43
|
+
}
|
|
44
|
+
function validActor(value) {
|
|
45
|
+
return typeof value === "string" && ACTOR.test(value);
|
|
46
|
+
}
|
|
47
|
+
function trustTier(metadata) {
|
|
48
|
+
const value = metadata["verified"];
|
|
49
|
+
const entries = Array.isArray(value) ? value : value && typeof value === "object" ? [value] : [];
|
|
50
|
+
let machine = false;
|
|
51
|
+
for (const entry of entries) {
|
|
52
|
+
if (!mapping(entry)) {
|
|
53
|
+
continue;
|
|
54
|
+
}
|
|
55
|
+
const actor = nonempty(entry["by"]);
|
|
56
|
+
if (actor?.startsWith("human:")) {
|
|
57
|
+
return "human-reviewed";
|
|
58
|
+
}
|
|
59
|
+
if (actor) {
|
|
60
|
+
machine = true;
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
return machine ? "machine-confirmed" : "unverified";
|
|
64
|
+
}
|
|
65
|
+
function sourceFields(value, path, knownPaths, guidance) {
|
|
66
|
+
if (value === undefined || value === null) {
|
|
67
|
+
return [];
|
|
68
|
+
}
|
|
69
|
+
if (!Array.isArray(value)) {
|
|
70
|
+
guidance.push(diagnostic("guidance", "warning", "guidance.sources.type", path, "sources should be a list"));
|
|
71
|
+
return [];
|
|
72
|
+
}
|
|
73
|
+
const result = [];
|
|
74
|
+
value.forEach((entry, index) => {
|
|
75
|
+
if (!mapping(entry)) {
|
|
76
|
+
guidance.push(diagnostic("guidance", "warning", "guidance.source.mapping", path, `sources[${index}] should be a mapping`));
|
|
77
|
+
return;
|
|
78
|
+
}
|
|
79
|
+
const resource = nonempty(entry["resource"]);
|
|
80
|
+
if (!resource) {
|
|
81
|
+
guidance.push(diagnostic("guidance", "warning", "guidance.source.resource", path, `sources[${index}].resource should be a non-empty string`));
|
|
82
|
+
return;
|
|
83
|
+
}
|
|
84
|
+
let resolvedPath = null;
|
|
85
|
+
let exists = null;
|
|
86
|
+
const looksLocal = resource.startsWith("/") || resource.startsWith("./") || resource.startsWith("../") || resource.endsWith(".md");
|
|
87
|
+
if (!SCHEME.test(resource) && looksLocal) {
|
|
88
|
+
const resolution = resolveWithinBundle(path, resource);
|
|
89
|
+
if (resolution.kind === "escape") {
|
|
90
|
+
guidance.push(diagnostic("guidance", "warning", "guidance.source.escape", path, `sources[${index}].resource escapes the bundle: ${resource}`));
|
|
91
|
+
}
|
|
92
|
+
else if (resolution.kind === "internal") {
|
|
93
|
+
resolvedPath = resolution.path;
|
|
94
|
+
exists = knownPaths.has(resolution.path);
|
|
95
|
+
if (!exists) {
|
|
96
|
+
guidance.push(diagnostic("guidance", "warning", "guidance.source.broken", path, `sources[${index}].resource does not resolve: ${resource}`));
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
}
|
|
100
|
+
result.push({
|
|
101
|
+
id: nonempty(entry["id"]),
|
|
102
|
+
resource,
|
|
103
|
+
title: nonempty(entry["title"]),
|
|
104
|
+
author: nonempty(entry["author"]),
|
|
105
|
+
usageCount: typeof entry["usage_count"] === "number" ? entry["usage_count"] : null,
|
|
106
|
+
lastModified: nonempty(entry["last_modified"]),
|
|
107
|
+
resolvedPath,
|
|
108
|
+
exists,
|
|
109
|
+
});
|
|
110
|
+
});
|
|
111
|
+
return result;
|
|
112
|
+
}
|
|
113
|
+
function checkTrustAndLifecycle(metadata, path, guidance) {
|
|
114
|
+
const generated = metadata["generated"];
|
|
115
|
+
if (generated !== undefined) {
|
|
116
|
+
if (!mapping(generated)) {
|
|
117
|
+
guidance.push(diagnostic("guidance", "warning", "guidance.generated.type", path, "generated should be a mapping"));
|
|
118
|
+
}
|
|
119
|
+
else {
|
|
120
|
+
if (!validActor(generated["by"])) {
|
|
121
|
+
guidance.push(diagnostic("guidance", "warning", "guidance.generated.by", path, "generated.by should use <producer>/<version>, human:<id>, or process:<id>"));
|
|
122
|
+
}
|
|
123
|
+
if (generated["at"] !== undefined && !validRecordedAt(generated["at"])) {
|
|
124
|
+
guidance.push(diagnostic("guidance", "warning", "guidance.generated.at", path, "generated.at should be an ISO 8601 datetime with an explicit offset; YYYY-MM-DD is accepted for compatibility"));
|
|
125
|
+
}
|
|
126
|
+
}
|
|
127
|
+
}
|
|
128
|
+
const verified = metadata["verified"];
|
|
129
|
+
if (verified !== undefined) {
|
|
130
|
+
const entries = Array.isArray(verified)
|
|
131
|
+
? verified
|
|
132
|
+
: typeof verified === "object" && verified !== null
|
|
133
|
+
? [verified]
|
|
134
|
+
: null;
|
|
135
|
+
if (entries === null) {
|
|
136
|
+
guidance.push(diagnostic("guidance", "warning", "guidance.verified.type", path, "verified should be a mapping or list"));
|
|
137
|
+
}
|
|
138
|
+
else {
|
|
139
|
+
entries.forEach((entry, index) => {
|
|
140
|
+
if (!mapping(entry)) {
|
|
141
|
+
guidance.push(diagnostic("guidance", "warning", "guidance.verified.event", path, `verified[${index}] should be a mapping`));
|
|
142
|
+
return;
|
|
143
|
+
}
|
|
144
|
+
if (!validActor(entry["by"])) {
|
|
145
|
+
guidance.push(diagnostic("guidance", "warning", "guidance.verified.by", path, `verified[${index}].by should use <producer>/<version>, human:<id>, or process:<id>`));
|
|
146
|
+
}
|
|
147
|
+
if (!validRecordedAt(entry["at"])) {
|
|
148
|
+
guidance.push(diagnostic("guidance", "warning", "guidance.verified.at", path, `verified[${index}].at should be an ISO 8601 datetime with an explicit offset; YYYY-MM-DD is accepted for compatibility`));
|
|
149
|
+
}
|
|
150
|
+
});
|
|
151
|
+
}
|
|
152
|
+
}
|
|
153
|
+
const status = metadata["status"];
|
|
154
|
+
if (status !== undefined && (typeof status !== "string" || !VALID_STATUSES.has(status))) {
|
|
155
|
+
guidance.push(diagnostic("guidance", "warning", "guidance.status.value", path, "status should be draft, stable, or deprecated"));
|
|
156
|
+
}
|
|
157
|
+
const staleAfter = metadata["stale_after"];
|
|
158
|
+
if (staleAfter !== undefined && (typeof staleAfter !== "string" || !validDate(staleAfter))) {
|
|
159
|
+
guidance.push(diagnostic("guidance", "warning", "guidance.stale-after.date", path, "stale_after should be YYYY-MM-DD"));
|
|
160
|
+
}
|
|
161
|
+
if (metadata["type"] === "Attested Computation" && !nonempty(metadata["runtime"])) {
|
|
162
|
+
guidance.push(diagnostic("guidance", "warning", "guidance.attested.runtime", path, "Attested Computation concepts should declare runtime"));
|
|
163
|
+
}
|
|
164
|
+
}
|
|
165
|
+
export function deriveDocumentFields(metadata, body, path, knownPaths, today) {
|
|
166
|
+
const guidance = [];
|
|
167
|
+
checkTrustAndLifecycle(metadata, path, guidance);
|
|
168
|
+
const tagsValue = metadata["tags"];
|
|
169
|
+
let tags = [];
|
|
170
|
+
if (tagsValue !== undefined) {
|
|
171
|
+
if (!Array.isArray(tagsValue) || tagsValue.some((tag) => typeof tag !== "string")) {
|
|
172
|
+
guidance.push(diagnostic("guidance", "warning", "guidance.tags.type", path, "tags should be a list of strings"));
|
|
173
|
+
}
|
|
174
|
+
else {
|
|
175
|
+
tags = tagsValue.map((tag) => tag.trim()).filter(Boolean);
|
|
176
|
+
}
|
|
177
|
+
}
|
|
178
|
+
const staleAfter = nonempty(metadata["stale_after"]);
|
|
179
|
+
const validStaleAfter = staleAfter !== null && validDate(staleAfter) ? staleAfter : null;
|
|
180
|
+
const validToday = today !== null && validDate(today) ? today : null;
|
|
181
|
+
const statusValue = nonempty(metadata["status"]);
|
|
182
|
+
const heading = markdownHeadings(body).find(({ depth }) => depth === 1)?.text.trim();
|
|
183
|
+
const filename = path.split("/").at(-1)?.replace(/\.md$/i, "") ?? path;
|
|
184
|
+
return {
|
|
185
|
+
derived: {
|
|
186
|
+
title: nonempty(metadata["title"]) ?? heading ?? filename,
|
|
187
|
+
type: nonempty(metadata["type"]),
|
|
188
|
+
description: nonempty(metadata["description"]),
|
|
189
|
+
status: statusValue ?? "stable",
|
|
190
|
+
trustTier: trustTier(metadata),
|
|
191
|
+
stale: validStaleAfter !== null && validToday !== null ? validToday >= validStaleAfter : null,
|
|
192
|
+
staleAfter: validStaleAfter,
|
|
193
|
+
tags,
|
|
194
|
+
sources: sourceFields(metadata["sources"], path, knownPaths, guidance),
|
|
195
|
+
},
|
|
196
|
+
guidance,
|
|
197
|
+
};
|
|
198
|
+
}
|
|
199
|
+
//# sourceMappingURL=derive.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"derive.js","sourceRoot":"","sources":["../src/derive.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import type { Diagnostic } from "okf-contracts";
|
|
2
|
+
export declare function diagnostic(family: Diagnostic["family"], severity: Diagnostic["severity"], code: string, path: string, message: string, range?: Diagnostic["range"]): Diagnostic;
|
|
3
|
+
export declare function compareDiagnostics(left: Diagnostic, right: Diagnostic): number;
|
|
4
|
+
//# sourceMappingURL=diagnostics.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAIhD,wBAAgB,UAAU,CACxB,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,EAC5B,QAAQ,EAAE,UAAU,CAAC,UAAU,CAAC,EAChC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,GAC1B,UAAU,CASZ;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,CAQ9E"}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
import { byCodePoint } from "./paths.js";
|
|
2
|
+
export function diagnostic(family, severity, code, path, message, range) {
|
|
3
|
+
return {
|
|
4
|
+
family,
|
|
5
|
+
severity,
|
|
6
|
+
code,
|
|
7
|
+
path,
|
|
8
|
+
message,
|
|
9
|
+
...(range === undefined ? {} : { range }),
|
|
10
|
+
};
|
|
11
|
+
}
|
|
12
|
+
export function compareDiagnostics(left, right) {
|
|
13
|
+
return (byCodePoint(left.path, right.path) ||
|
|
14
|
+
byCodePoint(left.family, right.family) ||
|
|
15
|
+
byCodePoint(left.code, right.code) ||
|
|
16
|
+
(left.range?.start.offset ?? -1) - (right.range?.start.offset ?? -1) ||
|
|
17
|
+
byCodePoint(left.message, right.message));
|
|
18
|
+
}
|
|
19
|
+
//# sourceMappingURL=diagnostics.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,MAAM,UAAU,UAAU,CACxB,MAA4B,EAC5B,QAAgC,EAChC,IAAY,EACZ,IAAY,EACZ,OAAe,EACf,KAA2B;IAE3B,OAAO;QACL,MAAM;QACN,QAAQ;QACR,IAAI;QACJ,IAAI;QACJ,OAAO;QACP,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;KAC1C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAgB,EAAE,KAAiB;IACpE,OAAO,CACL,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC;QAClC,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC;QACtC,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC;QAClC,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;QACpE,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CACzC,CAAC;AACJ,CAAC"}
|
package/dist/diff.d.ts
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../src/diff.ts"],"names":[],"mappings":"AA4CA,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CA4B/E"}
|
package/dist/diff.js
ADDED
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
const MAX_LINES = 5_000;
|
|
2
|
+
const CONTEXT = 3;
|
|
3
|
+
function commonSubsequence(before, after) {
|
|
4
|
+
const table = Array.from({ length: before.length + 1 }, () => new Array(after.length + 1).fill(0));
|
|
5
|
+
for (let i = before.length - 1; i >= 0; i -= 1) {
|
|
6
|
+
for (let j = after.length - 1; j >= 0; j -= 1) {
|
|
7
|
+
const row = table[i];
|
|
8
|
+
row[j] =
|
|
9
|
+
before[i] === after[j]
|
|
10
|
+
? (table[i + 1][j + 1] ?? 0) + 1
|
|
11
|
+
: Math.max(table[i + 1][j] ?? 0, row[j + 1] ?? 0);
|
|
12
|
+
}
|
|
13
|
+
}
|
|
14
|
+
return table;
|
|
15
|
+
}
|
|
16
|
+
function operations(before, after) {
|
|
17
|
+
const table = commonSubsequence(before, after);
|
|
18
|
+
const result = [];
|
|
19
|
+
let i = 0;
|
|
20
|
+
let j = 0;
|
|
21
|
+
while (i < before.length && j < after.length) {
|
|
22
|
+
if (before[i] === after[j]) {
|
|
23
|
+
result.push({ sign: " ", text: before[i] });
|
|
24
|
+
i += 1;
|
|
25
|
+
j += 1;
|
|
26
|
+
}
|
|
27
|
+
else if ((table[i + 1][j] ?? 0) >= (table[i][j + 1] ?? 0)) {
|
|
28
|
+
result.push({ sign: "-", text: before[i] });
|
|
29
|
+
i += 1;
|
|
30
|
+
}
|
|
31
|
+
else {
|
|
32
|
+
result.push({ sign: "+", text: after[j] });
|
|
33
|
+
j += 1;
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
for (; i < before.length; i += 1)
|
|
37
|
+
result.push({ sign: "-", text: before[i] });
|
|
38
|
+
for (; j < after.length; j += 1)
|
|
39
|
+
result.push({ sign: "+", text: after[j] });
|
|
40
|
+
return result;
|
|
41
|
+
}
|
|
42
|
+
export function unifiedDiff(before, after, path) {
|
|
43
|
+
if (before === after)
|
|
44
|
+
return "";
|
|
45
|
+
const beforeLines = before.split("\n");
|
|
46
|
+
const afterLines = after.split("\n");
|
|
47
|
+
if (beforeLines.length > MAX_LINES || afterLines.length > MAX_LINES) {
|
|
48
|
+
return `--- a/${path}\n+++ b/${path}\n@@ file too large to diff @@\n`;
|
|
49
|
+
}
|
|
50
|
+
const ops = operations(beforeLines, afterLines);
|
|
51
|
+
const keep = new Array(ops.length).fill(false);
|
|
52
|
+
ops.forEach((operation, index) => {
|
|
53
|
+
if (operation.sign === " ")
|
|
54
|
+
return;
|
|
55
|
+
for (let offset = -CONTEXT; offset <= CONTEXT; offset += 1) {
|
|
56
|
+
const current = index + offset;
|
|
57
|
+
if (current >= 0 && current < ops.length)
|
|
58
|
+
keep[current] = true;
|
|
59
|
+
}
|
|
60
|
+
});
|
|
61
|
+
const body = [];
|
|
62
|
+
let elided = false;
|
|
63
|
+
ops.forEach((operation, index) => {
|
|
64
|
+
if (keep[index]) {
|
|
65
|
+
if (elided)
|
|
66
|
+
body.push("@@");
|
|
67
|
+
elided = false;
|
|
68
|
+
body.push(`${operation.sign}${operation.text}`);
|
|
69
|
+
}
|
|
70
|
+
else {
|
|
71
|
+
elided = true;
|
|
72
|
+
}
|
|
73
|
+
});
|
|
74
|
+
return [`--- a/${path}`, `+++ b/${path}`, ...body, ""].join("\n");
|
|
75
|
+
}
|
|
76
|
+
//# sourceMappingURL=diff.js.map
|
package/dist/diff.js.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"diff.js","sourceRoot":"","sources":["../src/diff.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import type { FrontmatterSnapshot } from "okf-contracts";
|
|
2
|
+
export interface FrontmatterParseResult {
|
|
3
|
+
readonly snapshot: FrontmatterSnapshot | null;
|
|
4
|
+
readonly body: string;
|
|
5
|
+
readonly bodyStartLine: number;
|
|
6
|
+
readonly error: string | null;
|
|
7
|
+
readonly errorKind: "yaml" | "json" | null;
|
|
8
|
+
readonly hadFrontmatter: boolean;
|
|
9
|
+
}
|
|
10
|
+
/** Parse YAML 1.2 while retaining exact source bytes for lossless round-tripping. */
|
|
11
|
+
export declare function parseFrontmatter(content: string): FrontmatterParseResult;
|
|
12
|
+
//# sourceMappingURL=frontmatter.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../src/frontmatter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAyB,MAAM,eAAe,CAAC;AAIhF,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;CAClC;AA0CD,qFAAqF;AACrF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,sBAAsB,CAyExE"}
|
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
import { parseDocument } from "yaml";
|
|
2
|
+
const FRONTMATTER = /^\uFEFF?---[ \t]*\r?\n([\s\S]*?)\r?\n---[ \t]*(?:\r?\n|$)/;
|
|
3
|
+
function plainMapping(value) {
|
|
4
|
+
return typeof value === "object" && value !== null && !Array.isArray(value);
|
|
5
|
+
}
|
|
6
|
+
function jsonSafe(value, ancestors = new Set()) {
|
|
7
|
+
if (value === null || typeof value === "string" || typeof value === "boolean") {
|
|
8
|
+
return value;
|
|
9
|
+
}
|
|
10
|
+
if (typeof value === "number") {
|
|
11
|
+
if (!Number.isFinite(value)) {
|
|
12
|
+
throw new Error("frontmatter numbers must be finite");
|
|
13
|
+
}
|
|
14
|
+
return value;
|
|
15
|
+
}
|
|
16
|
+
if (typeof value !== "object") {
|
|
17
|
+
throw new Error(`frontmatter value is not JSON-safe: ${typeof value}`);
|
|
18
|
+
}
|
|
19
|
+
if (ancestors.has(value)) {
|
|
20
|
+
throw new Error("frontmatter contains a cyclic YAML alias");
|
|
21
|
+
}
|
|
22
|
+
ancestors.add(value);
|
|
23
|
+
try {
|
|
24
|
+
if (Array.isArray(value)) {
|
|
25
|
+
return value.map((entry) => jsonSafe(entry, ancestors));
|
|
26
|
+
}
|
|
27
|
+
const prototype = Object.getPrototypeOf(value);
|
|
28
|
+
if (prototype !== Object.prototype && prototype !== null) {
|
|
29
|
+
throw new Error("frontmatter contains a non-JSON YAML value");
|
|
30
|
+
}
|
|
31
|
+
return Object.fromEntries(Object.entries(value).map(([key, entry]) => [key, jsonSafe(entry, ancestors)]));
|
|
32
|
+
}
|
|
33
|
+
finally {
|
|
34
|
+
ancestors.delete(value);
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
/** Parse YAML 1.2 while retaining exact source bytes for lossless round-tripping. */
|
|
38
|
+
export function parseFrontmatter(content) {
|
|
39
|
+
const match = FRONTMATTER.exec(content);
|
|
40
|
+
if (!match) {
|
|
41
|
+
return {
|
|
42
|
+
snapshot: null,
|
|
43
|
+
body: content,
|
|
44
|
+
bodyStartLine: 1,
|
|
45
|
+
error: null,
|
|
46
|
+
errorKind: null,
|
|
47
|
+
hadFrontmatter: false,
|
|
48
|
+
};
|
|
49
|
+
}
|
|
50
|
+
const raw = match[0];
|
|
51
|
+
const yaml = match[1] ?? "";
|
|
52
|
+
const parsed = parseDocument(yaml, { keepSourceTokens: true, prettyErrors: false });
|
|
53
|
+
if (parsed.errors.length > 0) {
|
|
54
|
+
return {
|
|
55
|
+
snapshot: null,
|
|
56
|
+
body: content.slice(raw.length),
|
|
57
|
+
bodyStartLine: 1 + (raw.match(/\n/g)?.length ?? 0),
|
|
58
|
+
error: parsed.errors.map((error) => error.message).join("; "),
|
|
59
|
+
errorKind: "yaml",
|
|
60
|
+
hadFrontmatter: true,
|
|
61
|
+
};
|
|
62
|
+
}
|
|
63
|
+
let value;
|
|
64
|
+
try {
|
|
65
|
+
value = parsed.toJS({ maxAliasCount: 100 });
|
|
66
|
+
}
|
|
67
|
+
catch (error) {
|
|
68
|
+
return {
|
|
69
|
+
snapshot: null,
|
|
70
|
+
body: content.slice(raw.length),
|
|
71
|
+
bodyStartLine: 1 + (raw.match(/\n/g)?.length ?? 0),
|
|
72
|
+
error: error instanceof Error ? error.message : "YAML conversion failed",
|
|
73
|
+
errorKind: "yaml",
|
|
74
|
+
hadFrontmatter: true,
|
|
75
|
+
};
|
|
76
|
+
}
|
|
77
|
+
if (!plainMapping(value)) {
|
|
78
|
+
return {
|
|
79
|
+
snapshot: null,
|
|
80
|
+
body: content.slice(raw.length),
|
|
81
|
+
bodyStartLine: 1 + (raw.match(/\n/g)?.length ?? 0),
|
|
82
|
+
error: "frontmatter must be a YAML mapping",
|
|
83
|
+
errorKind: "yaml",
|
|
84
|
+
hadFrontmatter: true,
|
|
85
|
+
};
|
|
86
|
+
}
|
|
87
|
+
let metadata;
|
|
88
|
+
try {
|
|
89
|
+
metadata = jsonSafe(value);
|
|
90
|
+
}
|
|
91
|
+
catch (error) {
|
|
92
|
+
return {
|
|
93
|
+
snapshot: null,
|
|
94
|
+
body: content.slice(raw.length),
|
|
95
|
+
bodyStartLine: 1 + (raw.match(/\n/g)?.length ?? 0),
|
|
96
|
+
error: error instanceof Error ? error.message : "frontmatter is not JSON-safe",
|
|
97
|
+
errorKind: "json",
|
|
98
|
+
hadFrontmatter: true,
|
|
99
|
+
};
|
|
100
|
+
}
|
|
101
|
+
return {
|
|
102
|
+
snapshot: { raw, yaml, metadata },
|
|
103
|
+
body: content.slice(raw.length),
|
|
104
|
+
bodyStartLine: 1 + (raw.match(/\n/g)?.length ?? 0),
|
|
105
|
+
error: null,
|
|
106
|
+
errorKind: null,
|
|
107
|
+
hadFrontmatter: true,
|
|
108
|
+
};
|
|
109
|
+
}
|
|
110
|
+
//# sourceMappingURL=frontmatter.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../src/frontmatter.ts"],"names":[],"mappings":"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"}
|
package/dist/graph.d.ts
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../src/graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,WAAW,EAGZ,MAAM,eAAe,CAAC;AAIvB,wBAAgB,UAAU,CAAC,SAAS,EAAE,SAAS,gBAAgB,EAAE,GAAG,WAAW,CA4C9E"}
|