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.
Files changed (59) hide show
  1. package/LICENSE +203 -0
  2. package/README.md +40 -4
  3. package/dist/analyze.d.ts +6 -0
  4. package/dist/analyze.d.ts.map +1 -0
  5. package/dist/analyze.js +218 -0
  6. package/dist/analyze.js.map +1 -0
  7. package/dist/changes.d.ts +6 -0
  8. package/dist/changes.d.ts.map +1 -0
  9. package/dist/changes.js +81 -0
  10. package/dist/changes.js.map +1 -0
  11. package/dist/conformance.d.ts +5 -0
  12. package/dist/conformance.d.ts.map +1 -0
  13. package/dist/conformance.js +103 -0
  14. package/dist/conformance.js.map +1 -0
  15. package/dist/derive.d.ts +7 -0
  16. package/dist/derive.d.ts.map +1 -0
  17. package/dist/derive.js +199 -0
  18. package/dist/derive.js.map +1 -0
  19. package/dist/diagnostics.d.ts +4 -0
  20. package/dist/diagnostics.d.ts.map +1 -0
  21. package/dist/diagnostics.js +19 -0
  22. package/dist/diagnostics.js.map +1 -0
  23. package/dist/diff.d.ts +2 -0
  24. package/dist/diff.d.ts.map +1 -0
  25. package/dist/diff.js +76 -0
  26. package/dist/diff.js.map +1 -0
  27. package/dist/frontmatter.d.ts +12 -0
  28. package/dist/frontmatter.d.ts.map +1 -0
  29. package/dist/frontmatter.js +110 -0
  30. package/dist/frontmatter.js.map +1 -0
  31. package/dist/graph.d.ts +3 -0
  32. package/dist/graph.d.ts.map +1 -0
  33. package/dist/graph.js +42 -0
  34. package/dist/graph.js.map +1 -0
  35. package/dist/index.d.ts +11 -0
  36. package/dist/index.d.ts.map +1 -0
  37. package/dist/index.js +8 -0
  38. package/dist/index.js.map +1 -0
  39. package/dist/links.d.ts +10 -0
  40. package/dist/links.d.ts.map +1 -0
  41. package/dist/links.js +104 -0
  42. package/dist/links.js.map +1 -0
  43. package/dist/markdown.d.ts +18 -0
  44. package/dist/markdown.d.ts.map +1 -0
  45. package/dist/markdown.js +22 -0
  46. package/dist/markdown.js.map +1 -0
  47. package/dist/paths.d.ts +35 -0
  48. package/dist/paths.d.ts.map +1 -0
  49. package/dist/paths.js +103 -0
  50. package/dist/paths.js.map +1 -0
  51. package/dist/search.d.ts +5 -0
  52. package/dist/search.d.ts.map +1 -0
  53. package/dist/search.js +122 -0
  54. package/dist/search.js.map +1 -0
  55. package/dist/types.d.ts +44 -0
  56. package/dist/types.d.ts.map +1 -0
  57. package/dist/types.js +2 -0
  58. package/dist/types.js.map +1 -0
  59. 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":"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"}
@@ -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,2 @@
1
+ export declare function unifiedDiff(before: string, after: string, path: string): string;
2
+ //# sourceMappingURL=diff.d.ts.map
@@ -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
@@ -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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"}
@@ -0,0 +1,3 @@
1
+ import type { AnalyzedDocument, BundleGraph } from "okf-contracts";
2
+ export declare function buildGraph(documents: readonly AnalyzedDocument[]): BundleGraph;
3
+ //# sourceMappingURL=graph.d.ts.map
@@ -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"}