okf-core 0.0.0-bootstrap → 1.0.0-rc.2

package/dist/conformance.js

@@ -0,0 +1,103 @@
+import { diagnostic } from "./diagnostics.js";
+import { validDate } from "./derive.js";
+import { markdownBlocks, markdownHeadings } from "./markdown.js";
+import { isSafeMarkdownPath } from "./paths.js";
+export function documentKind(path) {
+    const name = path.split("/").at(-1);
+    return name === "index.md" ? "index" : name === "log.md" ? "log" : "concept";
+}
+export function coreDiagnostics(path, kind, parsed) {
+    const result = [];
+    if (!isSafeMarkdownPath(path)) {
+        result.push(diagnostic("core", "error", "core.bundle.path.invalid", path, "document path must be a confined bundle-relative .md path"));
+    }
+    if (kind === "concept") {
+        if (!parsed.hadFrontmatter) {
+            result.push(diagnostic("core", "error", "core.concept.frontmatter.missing", path, "concept must begin with YAML frontmatter"));
+            return result;
+        }
+        if (parsed.error !== null || parsed.snapshot === null) {
+            const jsonBoundary = parsed.errorKind === "json";
+            result.push(diagnostic("core", "error", jsonBoundary ? "core.concept.frontmatter.non-json" : "core.concept.frontmatter.invalid-yaml", path, jsonBoundary
+                ? `okf.inspect.v1 cannot represent concept frontmatter: ${parsed.error ?? "unknown error"}`
+                : `concept frontmatter is not a parseable YAML mapping: ${parsed.error ?? "unknown error"}`));
+            return result;
+        }
+        const type = parsed.snapshot.metadata["type"];
+        if (typeof type !== "string" || !type.trim()) {
+            result.push(diagnostic("core", "error", "core.concept.type.missing", path, "concept type must be a non-empty string"));
+        }
+        return result;
+    }
+    if (parsed.hadFrontmatter && parsed.error !== null) {
+        const jsonBoundary = parsed.errorKind === "json";
+        result.push(diagnostic("core", "error", jsonBoundary ? `core.${kind}.frontmatter.non-json` : `core.${kind}.frontmatter.invalid-yaml`, path, jsonBoundary
+            ? `okf.inspect.v1 cannot represent ${kind} frontmatter: ${parsed.error}`
+            : `${kind} frontmatter is not a parseable YAML mapping: ${parsed.error}`));
+    }
+    if (kind === "index") {
+        if (path === "index.md") {
+            if (parsed.snapshot !== null) {
+                const keys = Object.keys(parsed.snapshot.metadata);
+                if (keys.some((key) => key !== "okf_version")) {
+                    result.push(diagnostic("core", "error", "core.index.frontmatter.keys", path, "root index frontmatter supports only okf_version"));
+                }
+            }
+        }
+        else if (parsed.hadFrontmatter) {
+            result.push(diagnostic("core", "error", "core.index.frontmatter.nested", path, "nested index.md must not contain frontmatter"));
+        }
+        if (markdownHeadings(parsed.body).length === 0) {
+            result.push(diagnostic("core", "error", "core.index.heading.missing", path, "index must contain a Markdown heading"));
+        }
+        return result;
+    }
+    if (parsed.hadFrontmatter) {
+        result.push(diagnostic("core", "error", "core.log.frontmatter.forbidden", path, "log.md must not contain frontmatter"));
+    }
+    const blocks = markdownBlocks(parsed.body);
+    const headings = blocks.flatMap((block) => block.type === "heading" ? [block] : []);
+    if (headings.length === 0) {
+        result.push(diagnostic("core", "error", "core.log.heading.missing", path, "log must contain a Markdown heading"));
+    }
+    const dateHeadings = headings.filter((heading) => heading.depth === 2);
+    if (dateHeadings.length === 0) {
+        result.push(diagnostic("core", "error", "core.log.date-group.missing", path, "log must contain at least one level-two YYYY-MM-DD date group"));
+    }
+    const validDates = [];
+    for (const heading of dateHeadings) {
+        const value = heading.text.trim();
+        if (!validDate(value)) {
+            result.push(diagnostic("core", "error", "core.log.heading.date", path, `log date heading must be YYYY-MM-DD: ${value}`));
+        }
+        else {
+            validDates.push(value);
+        }
+    }
+    for (const [blockIndex, block] of blocks.entries()) {
+        if (block.type !== "heading" || block.depth !== 2) {
+            continue;
+        }
+        let groupEnd = blocks.length;
+        for (let candidateIndex = blockIndex + 1; candidateIndex < blocks.length; candidateIndex += 1) {
+            const candidate = blocks[candidateIndex];
+            if (candidate.type === "heading" && candidate.depth === 2) {
+                groupEnd = candidateIndex;
+                break;
+            }
+        }
+        if (!blocks.slice(blockIndex + 1, groupEnd).some((candidate) => candidate.type === "list")) {
+            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()}`));
+        }
+    }
+    for (let index = 1; index < validDates.length; index += 1) {
+        const previous = validDates[index - 1];
+        const current = validDates[index];
+        if (current > previous) {
+            result.push(diagnostic("core", "error", "core.log.heading.order", path, `log date groups must be newest first: ${current} follows ${previous}`));
+            break;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=conformance.js.map

package/dist/conformance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conformance.js","sourceRoot":"","sources":["../src/conformance.ts"],"names":[],"mappings":"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"}

package/dist/derive.d.ts

@@ -0,0 +1,14 @@
+import type { AnalyzedDocument, DerivedDocumentFields, Diagnostic, DocumentExtensions } from "okf-contracts";
+export declare function validDate(value: string): boolean;
+export declare function deriveDocumentFields(metadata: Readonly<Record<string, unknown>>, body: string, path: string, knownPaths: ReadonlySet<string>, nonDocumentPaths: ReadonlySet<string>, today: string | null): {
+    readonly derived: DerivedDocumentFields;
+    readonly guidance: readonly Diagnostic[];
+};
+/**
+ * Project the derived fields `okf.inspect.v1` cannot carry. `okf_type` is the document's OKF
+ * type under the name a catalog predicate matches on, and the usage windows frame every
+ * `usage_count` the analysis already reports. Both are derived from the same frontmatter the
+ * analysis read, so a consumer reads them here instead of re-deriving them itself.
+ */
+export declare function documentExtensions(document: AnalyzedDocument): DocumentExtensions;
+//# sourceMappingURL=derive.d.ts.map

package/dist/derive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive.d.ts","sourceRoot":"","sources":["../src/derive.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAEhB,qBAAqB,EACrB,UAAU,EACV,kBAAkB,EAGnB,MAAM,eAAe,CAAC;AA+BvB,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAUhD;AAqXD,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,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAAC,EACrC,KAAK,EAAE,MAAM,GAAG,IAAI,GACnB;IAAE,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,UAAU,EAAE,CAAA;CAAE,CAkDvF;AA+ED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,kBAAkB,CAiBjF"}

package/dist/derive.js

@@ -0,0 +1,356 @@
+import { diagnostic } from "./diagnostics.js";
+import { markdownHeadings } from "./markdown.js";
+import { resolveWithinBundle } from "./paths.js";
+const DATE = /^(\d{4})-(\d{2})-(\d{2})$/;
+const DATETIME = /^(\d{4}-\d{2}-\d{2})T(\d{2}):(\d{2}):(\d{2})(?:\.\d+)?(?:Z|([+-])(\d{2}):(\d{2}))$/;
+const ACTOR = /^(?:human:[^\s/:]+|process:[^\s/:]+|[^\s/:]+\/[^\s/:]+)$/;
+const VALID_STATUSES = new Set(["draft", "stable", "deprecated"]);
+/**
+ * Tags that mark a page as perishable, so it should say when it goes stale. Edit this set to
+ * match what a bundle actually tags; it only catches pages someone remembered to tag.
+ */
+const PERISHABLE_TAGS = new Set([
+    "pricing",
+    "vendor-limits",
+    "product-version",
+    "agreement",
+    "engagement-terms",
+]);
+const SCHEME = /^[A-Za-z][A-Za-z0-9+.-]*:/;
+function nonempty(value) {
+    return typeof value === "string" && value.trim() ? value.trim() : null;
+}
+function mapping(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export function validDate(value) {
+    const match = DATE.exec(value);
+    if (!match) {
+        return false;
+    }
+    const year = Number(match[1]);
+    const month = Number(match[2]);
+    const day = Number(match[3]);
+    const date = new Date(Date.UTC(year, month - 1, day));
+    return date.getUTCFullYear() === year && date.getUTCMonth() === month - 1 && date.getUTCDate() === day;
+}
+function validRecordedAt(value) {
+    if (typeof value !== "string") {
+        return false;
+    }
+    if (validDate(value)) {
+        return true;
+    }
+    const match = DATETIME.exec(value);
+    if (!match || !validDate(match[1])) {
+        return false;
+    }
+    const hour = Number(match[2]);
+    const minute = Number(match[3]);
+    const second = Number(match[4]);
+    const offsetHour = match[6] === undefined ? 0 : Number(match[6]);
+    const offsetMinute = match[7] === undefined ? 0 : Number(match[7]);
+    return hour <= 23 && minute <= 59 && second <= 59 && offsetHour <= 23 && offsetMinute <= 59;
+}
+function validActor(value) {
+    return typeof value === "string" && ACTOR.test(value);
+}
+function trustTier(metadata) {
+    const value = metadata["verified"];
+    const entries = Array.isArray(value) ? value : value && typeof value === "object" ? [value] : [];
+    let machine = false;
+    for (const entry of entries) {
+        if (!mapping(entry)) {
+            continue;
+        }
+        const actor = nonempty(entry["by"]);
+        if (actor?.startsWith("human:")) {
+            return "human-reviewed";
+        }
+        if (actor) {
+            machine = true;
+        }
+    }
+    return machine ? "machine-confirmed" : "unverified";
+}
+/** The `sources` entries `sourceFields` keeps; anything else never reaches `derived.sources`. */
+function isUsableSourceEntry(entry) {
+    return mapping(entry) && nonempty(entry["resource"]) !== null;
+}
+function sourceFields(value, path, knownPaths, guidance) {
+    if (value === undefined || value === null) {
+        return [];
+    }
+    if (!Array.isArray(value)) {
+        guidance.push(diagnostic("guidance", "warning", "guidance.sources.type", path, "sources should be a list"));
+        return [];
+    }
+    const result = [];
+    value.forEach((entry, index) => {
+        if (!mapping(entry)) {
+            guidance.push(diagnostic("guidance", "warning", "guidance.source.mapping", path, `sources[${index}] should be a mapping`));
+            return;
+        }
+        const resource = nonempty(entry["resource"]);
+        if (!resource) {
+            guidance.push(diagnostic("guidance", "warning", "guidance.source.resource", path, `sources[${index}].resource should be a non-empty string`));
+            return;
+        }
+        checkUsageWindow(entry["usage_window"], path, `sources[${index}].usage_window`, "guidance.source.usage-window", guidance);
+        let resolvedPath = null;
+        let exists = null;
+        const looksLocal = resource.startsWith("/") || resource.startsWith("./") || resource.startsWith("../") || resource.endsWith(".md");
+        if (!SCHEME.test(resource) && looksLocal) {
+            const resolution = resolveWithinBundle(path, resource);
+            if (resolution.kind === "escape") {
+                guidance.push(diagnostic("guidance", "warning", "guidance.source.escape", path, `sources[${index}].resource escapes the bundle: ${resource}`));
+            }
+            else if (resolution.kind === "internal") {
+                resolvedPath = resolution.path;
+                exists = knownPaths.has(resolution.path);
+                if (!exists) {
+                    guidance.push(diagnostic("guidance", "warning", "guidance.source.broken", path, `sources[${index}].resource does not resolve: ${resource}`));
+                }
+            }
+        }
+        result.push({
+            id: nonempty(entry["id"]),
+            resource,
+            title: nonempty(entry["title"]),
+            author: nonempty(entry["author"]),
+            usageCount: typeof entry["usage_count"] === "number" ? entry["usage_count"] : null,
+            lastModified: nonempty(entry["last_modified"]),
+            resolvedPath,
+            exists,
+        });
+    });
+    return result;
+}
+function checkTrustAndLifecycle(metadata, path, guidance) {
+    const generated = metadata["generated"];
+    if (generated !== undefined) {
+        if (!mapping(generated)) {
+            guidance.push(diagnostic("guidance", "warning", "guidance.generated.type", path, "generated should be a mapping"));
+        }
+        else {
+            if (!validActor(generated["by"])) {
+                guidance.push(diagnostic("guidance", "warning", "guidance.generated.by", path, "generated.by should use <producer>/<version>, human:<id>, or process:<id>"));
+            }
+            if (generated["at"] !== undefined && !validRecordedAt(generated["at"])) {
+                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"));
+            }
+        }
+    }
+    const verified = metadata["verified"];
+    if (verified !== undefined) {
+        const entries = Array.isArray(verified)
+            ? verified
+            : typeof verified === "object" && verified !== null
+                ? [verified]
+                : null;
+        if (entries === null) {
+            guidance.push(diagnostic("guidance", "warning", "guidance.verified.type", path, "verified should be a mapping or list"));
+        }
+        else {
+            entries.forEach((entry, index) => {
+                if (!mapping(entry)) {
+                    guidance.push(diagnostic("guidance", "warning", "guidance.verified.event", path, `verified[${index}] should be a mapping`));
+                    return;
+                }
+                if (!validActor(entry["by"])) {
+                    guidance.push(diagnostic("guidance", "warning", "guidance.verified.by", path, `verified[${index}].by should use <producer>/<version>, human:<id>, or process:<id>`));
+                }
+                if (!validRecordedAt(entry["at"])) {
+                    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`));
+                }
+            });
+        }
+    }
+    const status = metadata["status"];
+    if (status !== undefined && (typeof status !== "string" || !VALID_STATUSES.has(status))) {
+        guidance.push(diagnostic("guidance", "warning", "guidance.status.value", path, "status should be draft, stable, or deprecated"));
+    }
+    const staleAfter = metadata["stale_after"];
+    if (staleAfter !== undefined && (typeof staleAfter !== "string" || !validDate(staleAfter))) {
+        guidance.push(diagnostic("guidance", "warning", "guidance.stale-after.date", path, "stale_after should be YYYY-MM-DD"));
+    }
+    if (metadata["type"] === "Attested Computation" && !nonempty(metadata["runtime"])) {
+        guidance.push(diagnostic("guidance", "warning", "guidance.attested.runtime", path, "Attested Computation concepts should declare runtime"));
+    }
+    checkUsageWindow(metadata["usage_window"], path, "usage_window", "guidance.usage-window", guidance);
+    checkAttestationContract(metadata, path, guidance);
+}
+/** `usage_window` frames every `usage_count`, so a malformed one makes those counts unreadable. */
+function checkUsageWindow(value, path, label, code, guidance) {
+    if (value === undefined) {
+        return;
+    }
+    if (!mapping(value)) {
+        guidance.push(diagnostic("guidance", "warning", `${code}.type`, path, `${label} should be a mapping`));
+        return;
+    }
+    for (const key of ["from", "to"]) {
+        const bound = value[key];
+        if (bound !== undefined && (typeof bound !== "string" || !validDate(bound))) {
+            guidance.push(diagnostic("guidance", "warning", `${code}.${key}`, path, `${label}.${key} should be YYYY-MM-DD`));
+        }
+    }
+}
+/**
+ * The contract fields of an Attested Computation. `runtime` is checked above; these are the
+ * fields that say how to run the computation and what evidence the attester inspects.
+ */
+function checkAttestationContract(metadata, path, guidance) {
+    const parameters = metadata["parameters"];
+    if (parameters !== undefined) {
+        if (!Array.isArray(parameters)) {
+            guidance.push(diagnostic("guidance", "warning", "guidance.parameters.type", path, "parameters should be a list"));
+        }
+        else {
+            parameters.forEach((entry, index) => {
+                if (!mapping(entry) || !nonempty(entry["name"])) {
+                    guidance.push(diagnostic("guidance", "warning", "guidance.parameter.name", path, `parameters[${index}] should be a mapping with a non-empty name`));
+                }
+            });
+        }
+    }
+    const executor = metadata["executor"];
+    if (executor !== undefined) {
+        if (!mapping(executor)) {
+            guidance.push(diagnostic("guidance", "warning", "guidance.executor.type", path, "executor should be a mapping"));
+        }
+        else {
+            if (!nonempty(executor["resource"])) {
+                guidance.push(diagnostic("guidance", "warning", "guidance.executor.resource", path, "executor.resource should be a non-empty string"));
+            }
+            const receipt = executor["receipt"];
+            if (receipt !== undefined
+                && (!Array.isArray(receipt) || receipt.some((field) => !nonempty(field)))) {
+                guidance.push(diagnostic("guidance", "warning", "guidance.executor.receipt", path, "executor.receipt should be a list of non-empty strings"));
+            }
+        }
+    }
+    const attester = metadata["attester"];
+    if (attester !== undefined) {
+        if (!mapping(attester)) {
+            guidance.push(diagnostic("guidance", "warning", "guidance.attester.type", path, "attester should be a mapping"));
+        }
+        else if (!nonempty(attester["resource"])) {
+            guidance.push(diagnostic("guidance", "warning", "guidance.attester.resource", path, "attester.resource should be a non-empty string"));
+        }
+    }
+}
+export function deriveDocumentFields(metadata, body, path, knownPaths, nonDocumentPaths, today) {
+    const guidance = [];
+    checkTrustAndLifecycle(metadata, path, guidance);
+    checkContractPaths(metadata, path, knownPaths, nonDocumentPaths, guidance);
+    const tagsValue = metadata["tags"];
+    let tags = [];
+    if (tagsValue !== undefined) {
+        if (!Array.isArray(tagsValue) || tagsValue.some((tag) => typeof tag !== "string")) {
+            guidance.push(diagnostic("guidance", "warning", "guidance.tags.type", path, "tags should be a list of strings"));
+        }
+        else {
+            tags = tagsValue.map((tag) => tag.trim()).filter(Boolean);
+        }
+    }
+    const staleAfter = nonempty(metadata["stale_after"]);
+    if (staleAfter === null) {
+        const perishable = [...new Set(tags.filter((tag) => PERISHABLE_TAGS.has(tag)))].sort();
+        if (perishable.length > 0) {
+            guidance.push(diagnostic("guidance", "warning", "guidance.stale-after.perishable", path, `tags ${perishable.join(", ")} perish, so stale_after should be set`));
+        }
+    }
+    const validStaleAfter = staleAfter !== null && validDate(staleAfter) ? staleAfter : null;
+    const validToday = today !== null && validDate(today) ? today : null;
+    const statusValue = nonempty(metadata["status"]);
+    const heading = markdownHeadings(body).find(({ depth }) => depth === 1)?.text.trim();
+    const filename = path.split("/").at(-1)?.replace(/\.md$/i, "") ?? path;
+    return {
+        derived: {
+            title: nonempty(metadata["title"]) ?? heading ?? filename,
+            type: nonempty(metadata["type"]),
+            description: nonempty(metadata["description"]),
+            status: statusValue ?? "stable",
+            trustTier: trustTier(metadata),
+            stale: validStaleAfter !== null && validToday !== null ? validToday >= validStaleAfter : null,
+            staleAfter: validStaleAfter,
+            tags,
+            sources: sourceFields(metadata["sources"], path, knownPaths, guidance),
+        },
+        guidance,
+    };
+}
+/** Like `mapping`, but yields the record so its keys can be read. */
+function asMapping(value) {
+    return mapping(value) ? value : null;
+}
+/**
+ * Resolve the path-valued fields of an Attested Computation. The spec lists `computation`,
+ * `executor.resource` and `attester.resource` alongside `sources[].resource` as fields that
+ * name a file, but only source resources were resolved, so a broken executor path passed
+ * without comment.
+ *
+ * These three name a file rather than a page: a `computation` is a query, an `attester.resource`
+ * is a script. So a target counts as resolved when it is either a loaded document or a bundle
+ * file the loader saw without parsing. `sources[].resource` is deliberately not treated this
+ * way — a source naming an unwritten `.md` page is the corpus's to-do list, and keeps reporting.
+ */
+function checkContractPaths(metadata, path, knownPaths, nonDocumentPaths, guidance) {
+    const executor = asMapping(metadata["executor"]);
+    const attester = asMapping(metadata["attester"]);
+    const candidates = [
+        ["computation", metadata["computation"]],
+        ["executor.resource", executor?.["resource"]],
+        ["attester.resource", attester?.["resource"]],
+    ];
+    for (const [label, value] of candidates) {
+        const target = nonempty(value);
+        if (target === null || SCHEME.test(target)) {
+            continue;
+        }
+        const resolution = resolveWithinBundle(path, target);
+        if (resolution.kind === "escape") {
+            guidance.push(diagnostic("guidance", "warning", "guidance.contract.escape", path, `${label} escapes the bundle: ${target}`));
+        }
+        else if (resolution.kind === "internal"
+            && !knownPaths.has(resolution.path)
+            && !nonDocumentPaths.has(resolution.path)) {
+            guidance.push(diagnostic("guidance", "warning", "guidance.contract.broken", path, `${label} does not resolve: ${target}`));
+        }
+    }
+}
+function usageWindowOf(value) {
+    const record = asMapping(value);
+    if (record === null) {
+        return null;
+    }
+    const from = nonempty(record["from"]);
+    const to = nonempty(record["to"]);
+    return from === null && to === null ? null : { from, to };
+}
+/**
+ * Project the derived fields `okf.inspect.v1` cannot carry. `okf_type` is the document's OKF
+ * type under the name a catalog predicate matches on, and the usage windows frame every
+ * `usage_count` the analysis already reports. Both are derived from the same frontmatter the
+ * analysis read, so a consumer reads them here instead of re-deriving them itself.
+ */
+export function documentExtensions(document) {
+    const metadata = document.metadata;
+    const sourceUsageWindows = [];
+    const sources = metadata["sources"];
+    if (Array.isArray(sources)) {
+        for (const entry of sources) {
+            if (isUsableSourceEntry(entry)) {
+                sourceUsageWindows.push(usageWindowOf(entry["usage_window"]));
+            }
+        }
+    }
+    return {
+        path: document.path,
+        okf_type: nonempty(metadata["type"]),
+        usageWindow: usageWindowOf(metadata["usage_window"]),
+        sourceUsageWindows,
+    };
+}
+//# sourceMappingURL=derive.js.map

package/dist/derive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive.js","sourceRoot":"","sources":["../src/derive.ts"],"names":[],"mappings":"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"}

package/dist/diagnostics.d.ts

@@ -0,0 +1,4 @@
+import type { Diagnostic } from "okf-contracts";
+export declare function diagnostic(family: Diagnostic["family"], severity: Diagnostic["severity"], code: string, path: string, message: string, range?: Diagnostic["range"]): Diagnostic;
+export declare function compareDiagnostics(left: Diagnostic, right: Diagnostic): number;
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/diagnostics.d.ts.map

@@ -0,0 +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"}

package/dist/diagnostics.js

@@ -0,0 +1,19 @@
+import { byCodePoint } from "./paths.js";
+export function diagnostic(family, severity, code, path, message, range) {
+    return {
+        family,
+        severity,
+        code,
+        path,
+        message,
+        ...(range === undefined ? {} : { range }),
+    };
+}
+export function compareDiagnostics(left, right) {
+    return (byCodePoint(left.path, right.path) ||
+        byCodePoint(left.family, right.family) ||
+        byCodePoint(left.code, right.code) ||
+        (left.range?.start.offset ?? -1) - (right.range?.start.offset ?? -1) ||
+        byCodePoint(left.message, right.message));
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/diagnostics.js.map

@@ -0,0 +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

@@ -0,0 +1,2 @@
+export declare function unifiedDiff(before: string, after: string, path: string): string;
+//# sourceMappingURL=diff.d.ts.map

package/dist/diff.d.ts.map

@@ -0,0 +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

@@ -0,0 +1,76 @@
+const MAX_LINES = 5_000;
+const CONTEXT = 3;
+function commonSubsequence(before, after) {
+    const table = Array.from({ length: before.length + 1 }, () => new Array(after.length + 1).fill(0));
+    for (let i = before.length - 1; i >= 0; i -= 1) {
+        for (let j = after.length - 1; j >= 0; j -= 1) {
+            const row = table[i];
+            row[j] =
+                before[i] === after[j]
+                    ? (table[i + 1][j + 1] ?? 0) + 1
+                    : Math.max(table[i + 1][j] ?? 0, row[j + 1] ?? 0);
+        }
+    }
+    return table;
+}
+function operations(before, after) {
+    const table = commonSubsequence(before, after);
+    const result = [];
+    let i = 0;
+    let j = 0;
+    while (i < before.length && j < after.length) {
+        if (before[i] === after[j]) {
+            result.push({ sign: " ", text: before[i] });
+            i += 1;
+            j += 1;
+        }
+        else if ((table[i + 1][j] ?? 0) >= (table[i][j + 1] ?? 0)) {
+            result.push({ sign: "-", text: before[i] });
+            i += 1;
+        }
+        else {
+            result.push({ sign: "+", text: after[j] });
+            j += 1;
+        }
+    }
+    for (; i < before.length; i += 1)
+        result.push({ sign: "-", text: before[i] });
+    for (; j < after.length; j += 1)
+        result.push({ sign: "+", text: after[j] });
+    return result;
+}
+export function unifiedDiff(before, after, path) {
+    if (before === after)
+        return "";
+    const beforeLines = before.split("\n");
+    const afterLines = after.split("\n");
+    if (beforeLines.length > MAX_LINES || afterLines.length > MAX_LINES) {
+        return `--- a/${path}\n+++ b/${path}\n@@ file too large to diff @@\n`;
+    }
+    const ops = operations(beforeLines, afterLines);
+    const keep = new Array(ops.length).fill(false);
+    ops.forEach((operation, index) => {
+        if (operation.sign === " ")
+            return;
+        for (let offset = -CONTEXT; offset <= CONTEXT; offset += 1) {
+            const current = index + offset;
+            if (current >= 0 && current < ops.length)
+                keep[current] = true;
+        }
+    });
+    const body = [];
+    let elided = false;
+    ops.forEach((operation, index) => {
+        if (keep[index]) {
+            if (elided)
+                body.push("@@");
+            elided = false;
+            body.push(`${operation.sign}${operation.text}`);
+        }
+        else {
+            elided = true;
+        }
+    });
+    return [`--- a/${path}`, `+++ b/${path}`, ...body, ""].join("\n");
+}
+//# sourceMappingURL=diff.js.map