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

package/dist/diff.js.map

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

package/dist/frontmatter.d.ts

@@ -0,0 +1,12 @@
+import type { FrontmatterSnapshot } from "okf-contracts";
+export interface FrontmatterParseResult {
+    readonly snapshot: FrontmatterSnapshot | null;
+    readonly body: string;
+    readonly bodyStartLine: number;
+    readonly error: string | null;
+    readonly errorKind: "yaml" | "json" | null;
+    readonly hadFrontmatter: boolean;
+}
+/** Parse YAML 1.2 while retaining exact source bytes for lossless round-tripping. */
+export declare function parseFrontmatter(content: string): FrontmatterParseResult;
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/frontmatter.d.ts.map

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

package/dist/frontmatter.js

@@ -0,0 +1,110 @@
+import { parseDocument } from "yaml";
+const FRONTMATTER = /^\uFEFF?---[ \t]*\r?\n([\s\S]*?)\r?\n---[ \t]*(?:\r?\n|$)/;
+function plainMapping(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function jsonSafe(value, ancestors = new Set()) {
+    if (value === null || typeof value === "string" || typeof value === "boolean") {
+        return value;
+    }
+    if (typeof value === "number") {
+        if (!Number.isFinite(value)) {
+            throw new Error("frontmatter numbers must be finite");
+        }
+        return value;
+    }
+    if (typeof value !== "object") {
+        throw new Error(`frontmatter value is not JSON-safe: ${typeof value}`);
+    }
+    if (ancestors.has(value)) {
+        throw new Error("frontmatter contains a cyclic YAML alias");
+    }
+    ancestors.add(value);
+    try {
+        if (Array.isArray(value)) {
+            return value.map((entry) => jsonSafe(entry, ancestors));
+        }
+        const prototype = Object.getPrototypeOf(value);
+        if (prototype !== Object.prototype && prototype !== null) {
+            throw new Error("frontmatter contains a non-JSON YAML value");
+        }
+        return Object.fromEntries(Object.entries(value).map(([key, entry]) => [key, jsonSafe(entry, ancestors)]));
+    }
+    finally {
+        ancestors.delete(value);
+    }
+}
+/** Parse YAML 1.2 while retaining exact source bytes for lossless round-tripping. */
+export function parseFrontmatter(content) {
+    const match = FRONTMATTER.exec(content);
+    if (!match) {
+        return {
+            snapshot: null,
+            body: content,
+            bodyStartLine: 1,
+            error: null,
+            errorKind: null,
+            hadFrontmatter: false,
+        };
+    }
+    const raw = match[0];
+    const yaml = match[1] ?? "";
+    const parsed = parseDocument(yaml, { keepSourceTokens: true, prettyErrors: false });
+    if (parsed.errors.length > 0) {
+        return {
+            snapshot: null,
+            body: content.slice(raw.length),
+            bodyStartLine: 1 + (raw.match(/\n/g)?.length ?? 0),
+            error: parsed.errors.map((error) => error.message).join("; "),
+            errorKind: "yaml",
+            hadFrontmatter: true,
+        };
+    }
+    let value;
+    try {
+        value = parsed.toJS({ maxAliasCount: 100 });
+    }
+    catch (error) {
+        return {
+            snapshot: null,
+            body: content.slice(raw.length),
+            bodyStartLine: 1 + (raw.match(/\n/g)?.length ?? 0),
+            error: error instanceof Error ? error.message : "YAML conversion failed",
+            errorKind: "yaml",
+            hadFrontmatter: true,
+        };
+    }
+    if (!plainMapping(value)) {
+        return {
+            snapshot: null,
+            body: content.slice(raw.length),
+            bodyStartLine: 1 + (raw.match(/\n/g)?.length ?? 0),
+            error: "frontmatter must be a YAML mapping",
+            errorKind: "yaml",
+            hadFrontmatter: true,
+        };
+    }
+    let metadata;
+    try {
+        metadata = jsonSafe(value);
+    }
+    catch (error) {
+        return {
+            snapshot: null,
+            body: content.slice(raw.length),
+            bodyStartLine: 1 + (raw.match(/\n/g)?.length ?? 0),
+            error: error instanceof Error ? error.message : "frontmatter is not JSON-safe",
+            errorKind: "json",
+            hadFrontmatter: true,
+        };
+    }
+    return {
+        snapshot: { raw, yaml, metadata },
+        body: content.slice(raw.length),
+        bodyStartLine: 1 + (raw.match(/\n/g)?.length ?? 0),
+        error: null,
+        errorKind: null,
+        hadFrontmatter: true,
+    };
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/frontmatter.js.map

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

package/dist/graph.d.ts

@@ -0,0 +1,3 @@
+import type { AnalyzedDocument, BundleGraph } from "okf-contracts";
+export declare function buildGraph(documents: readonly AnalyzedDocument[]): BundleGraph;
+//# sourceMappingURL=graph.d.ts.map

package/dist/graph.d.ts.map

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

package/dist/graph.js

@@ -0,0 +1,42 @@
+import { byCodePoint } from "./paths.js";
+export function buildGraph(documents) {
+    const concepts = documents
+        .filter((document) => document.kind === "concept")
+        .sort((left, right) => byCodePoint(left.path, right.path));
+    const known = new Set(concepts.map((document) => document.path));
+    const nodes = concepts.map((document) => ({
+        id: document.path,
+        path: document.path,
+        title: document.derived.title,
+        type: document.derived.type ?? "Concept",
+        description: document.derived.description,
+        status: document.derived.status,
+        trustTier: document.derived.trustTier,
+        stale: document.derived.stale,
+        tags: document.derived.tags,
+    }));
+    const relations = new Map();
+    for (const document of concepts) {
+        for (const link of document.links) {
+            if (link.kind !== "internal" || link.resolvedPath === null || !known.has(link.resolvedPath)) {
+                continue;
+            }
+            const key = `${document.path}\u0000${link.resolvedPath}\u0000link`;
+            relations.set(key, { source: document.path, target: link.resolvedPath, relation: "link" });
+        }
+        for (const source of document.derived.sources) {
+            if (source.resolvedPath === null || !known.has(source.resolvedPath)) {
+                continue;
+            }
+            const key = `${document.path}\u0000${source.resolvedPath}\u0000source`;
+            relations.set(key, { source: document.path, target: source.resolvedPath, relation: "source" });
+        }
+    }
+    const edges = [...relations.values()]
+        .sort((left, right) => byCodePoint(left.source, right.source) ||
+        byCodePoint(left.target, right.target) ||
+        byCodePoint(left.relation, right.relation))
+        .map((edge, index) => ({ id: `e${index}`, ...edge }));
+    return { nodes, edges };
+}
+//# sourceMappingURL=graph.js.map

package/dist/graph.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export { analyzeBundle, parseBundleDocument } from "./analyze.js";
+export { canonicalChangeJson, parseChange } from "./changes.js";
+export { documentExtensions } from "./derive.js";
+export { buildGraph } from "./graph.js";
+export { extractMarkdownLinks } from "./links.js";
+export type { ExtractLinksOptions } from "./links.js";
+export { listBundleEntries } from "./listing.js";
+export type { BundleListingEntry, BundleListingEntryType } from "./listing.js";
+export { byCodePoint, canonicalizeBundlePath, canonicalizeOperationPath, InvalidBundlePathError, resolveWithinBundle, validateBundlePath, } from "./paths.js";
+export type { PathResolution } from "./paths.js";
+export { queryTerms, searchBundle } from "./search.js";
+export { unifiedDiff } from "./diff.js";
+export type { AnalyzeBundleOptions, ParsedDocumentResult, ParseDocumentOptions, ProfileDiagnostic, SearchPassage, SearchResult, ValidationProfile, ValidationProfileContext, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,YAAY,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAC/E,OAAO,EACL,WAAW,EACX,sBAAsB,EACtB,yBAAyB,EACzB,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,YAAY,EACV,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+export { analyzeBundle, parseBundleDocument } from "./analyze.js";
+export { canonicalChangeJson, parseChange } from "./changes.js";
+export { documentExtensions } from "./derive.js";
+export { buildGraph } from "./graph.js";
+export { extractMarkdownLinks } from "./links.js";
+export { listBundleEntries } from "./listing.js";
+export { byCodePoint, canonicalizeBundlePath, canonicalizeOperationPath, InvalidBundlePathError, resolveWithinBundle, validateBundlePath, } from "./paths.js";
+export { queryTerms, searchBundle } from "./search.js";
+export { unifiedDiff } from "./diff.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAElD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,EACL,WAAW,EACX,sBAAsB,EACtB,yBAAyB,EACzB,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC"}

package/dist/links.d.ts

@@ -0,0 +1,10 @@
+import type { AnalyzedLink } from "okf-contracts";
+export interface ExtractLinksOptions {
+    readonly sourcePath: string;
+    readonly knownPaths?: ReadonlySet<string>;
+    readonly lineOffset?: number;
+    readonly offsetOffset?: number;
+}
+/** Extract CommonMark links, including reference links, from the Markdown AST. */
+export declare function extractMarkdownLinks(markdown: string, options: ExtractLinksOptions): readonly AnalyzedLink[];
+//# sourceMappingURL=links.d.ts.map

package/dist/links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"links.d.ts","sourceRoot":"","sources":["../src/links.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAe,MAAM,eAAe,CAAC;AAoB/D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AA2CD,kFAAkF;AAClF,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,mBAAmB,GAC3B,SAAS,YAAY,EAAE,CAgEzB"}

package/dist/links.js

@@ -0,0 +1,104 @@
+import { fromMarkdown } from "mdast-util-from-markdown";
+import { resolveWithinBundle } from "./paths.js";
+function normalizeIdentifier(value) {
+    return value.trim().replace(/\s+/g, " ").toLowerCase();
+}
+function textOf(node) {
+    if (node.type === "text" || node.type === "inlineCode") {
+        return node.value ?? "";
+    }
+    if (node.type === "image") {
+        return node.alt ?? "";
+    }
+    return (node.children ?? []).map(textOf).join("");
+}
+function rangeOf(node, lineOffset, offsetOffset) {
+    const start = node.position?.start;
+    const end = node.position?.end;
+    if (start?.line === undefined ||
+        start.column === undefined ||
+        start.offset === undefined ||
+        end?.line === undefined ||
+        end.column === undefined ||
+        end.offset === undefined) {
+        return null;
+    }
+    return {
+        start: {
+            line: start.line + lineOffset,
+            column: start.column,
+            offset: start.offset + offsetOffset,
+        },
+        end: {
+            line: end.line + lineOffset,
+            column: end.column,
+            offset: end.offset + offsetOffset,
+        },
+    };
+}
+/** Extract CommonMark links, including reference links, from the Markdown AST. */
+export function extractMarkdownLinks(markdown, options) {
+    const root = fromMarkdown(markdown);
+    const definitions = new Map();
+    const collectDefinitions = (node) => {
+        if (node.type === "definition" && node.identifier && typeof node.url === "string") {
+            definitions.set(normalizeIdentifier(node.identifier), node.url);
+        }
+        for (const child of node.children ?? []) {
+            collectDefinitions(child);
+        }
+    };
+    collectDefinitions(root);
+    const result = [];
+    const visit = (node) => {
+        let href = null;
+        if (node.type === "link" && typeof node.url === "string") {
+            href = node.url;
+        }
+        else if (node.type === "linkReference" && node.identifier) {
+            href = definitions.get(normalizeIdentifier(node.identifier)) ?? null;
+        }
+        if (href !== null) {
+            const resolution = resolveWithinBundle(options.sourcePath, href);
+            const base = {
+                href,
+                text: textOf(node),
+                range: rangeOf(node, options.lineOffset ?? 0, options.offsetOffset ?? 0),
+            };
+            if (resolution.kind === "internal") {
+                result.push({
+                    ...base,
+                    kind: "internal",
+                    resolvedPath: resolution.path,
+                    fragment: resolution.fragment,
+                    exists: options.knownPaths?.has(resolution.path) ?? null,
+                });
+            }
+            else if (resolution.kind === "fragment") {
+                result.push({
+                    ...base,
+                    kind: "fragment",
+                    resolvedPath: options.sourcePath,
+                    fragment: resolution.fragment,
+                    exists: true,
+                });
+            }
+            else {
+                result.push({
+                    ...base,
+                    kind: resolution.kind,
+                    resolvedPath: null,
+                    fragment: null,
+                    exists: null,
+                });
+            }
+            return;
+        }
+        for (const child of node.children ?? []) {
+            visit(child);
+        }
+    };
+    visit(root);
+    return result;
+}
+//# sourceMappingURL=links.js.map

package/dist/links.js.map

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

package/dist/listing.d.ts

@@ -0,0 +1,15 @@
+export type BundleListingEntryType = "directory" | "markdown";
+export interface BundleListingEntry {
+    readonly path: string;
+    readonly type: BundleListingEntryType;
+}
+/**
+ * Fold a bundle's document paths into the entries one `list` call returns.
+ *
+ * Every adapter answers `list` from the paths it already knows, so the depth and prefix
+ * policy lives here rather than in each adapter: R2 and the filesystem must not disagree
+ * about what `depth: 2` means. `requested` is `.` for the bundle root, otherwise a confined
+ * bundle-relative directory path.
+ */
+export declare function listBundleEntries(documentPaths: readonly string[], requested: string, depth: number): BundleListingEntry[];
+//# sourceMappingURL=listing.d.ts.map

package/dist/listing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listing.d.ts","sourceRoot":"","sources":["../src/listing.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,sBAAsB,GAAG,WAAW,GAAG,UAAU,CAAC;AAE9D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;CACvC;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,SAAS,MAAM,EAAE,EAChC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,kBAAkB,EAAE,CAwBtB"}

package/dist/listing.js

@@ -0,0 +1,38 @@
+import { byCodePoint, InvalidBundlePathError, validateBundlePath } from "./paths.js";
+/**
+ * Fold a bundle's document paths into the entries one `list` call returns.
+ *
+ * Every adapter answers `list` from the paths it already knows, so the depth and prefix
+ * policy lives here rather than in each adapter: R2 and the filesystem must not disagree
+ * about what `depth: 2` means. `requested` is `.` for the bundle root, otherwise a confined
+ * bundle-relative directory path.
+ */
+export function listBundleEntries(documentPaths, requested, depth) {
+    let confined = "";
+    if (requested !== ".") {
+        try {
+            confined = validateBundlePath(requested);
+        }
+        catch {
+            throw new InvalidBundlePathError(`list path is not confined: ${requested}`);
+        }
+    }
+    const prefix = confined ? `${confined}/` : "";
+    const entries = new Map();
+    for (const documentPath of documentPaths) {
+        if (!documentPath.startsWith(prefix))
+            continue;
+        const relative = documentPath.slice(prefix.length);
+        const parts = relative.split("/");
+        if (parts.length - 1 <= depth)
+            entries.set(documentPath, "markdown");
+        const directories = parts.slice(0, -1);
+        for (let index = 0; index < Math.min(directories.length, depth); index += 1) {
+            entries.set(`${prefix}${directories.slice(0, index + 1).join("/")}`, "directory");
+        }
+    }
+    return [...entries]
+        .map(([path, type]) => ({ path, type }))
+        .sort((left, right) => byCodePoint(left.path, right.path));
+}
+//# sourceMappingURL=listing.js.map

package/dist/listing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listing.js","sourceRoot":"","sources":["../src/listing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AASrF;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,aAAgC,EAChC,SAAiB,EACjB,KAAa;IAEb,IAAI,QAAQ,GAAG,EAAE,CAAC;IAClB,IAAI,SAAS,KAAK,GAAG,EAAE,CAAC;QACtB,IAAI,CAAC;YACH,QAAQ,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,sBAAsB,CAAC,8BAA8B,SAAS,EAAE,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;IACD,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkC,CAAC;IAC1D,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE,CAAC;QACzC,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,SAAS;QAC/C,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACnD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK;YAAE,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QACrE,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACvC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YAC5E,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;QACpF,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,OAAO,CAAC;SAChB,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;SACvC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AAC/D,CAAC"}

package/dist/markdown.d.ts

@@ -0,0 +1,18 @@
+export interface MarkdownHeading {
+    readonly depth: number;
+    readonly text: string;
+}
+export type MarkdownBlock = {
+    readonly type: "heading";
+    readonly depth: number;
+    readonly text: string;
+} | {
+    readonly type: "list";
+} | {
+    readonly type: "other";
+};
+/** Return actual top-level CommonMark blocks, excluding syntax nested in code. */
+export declare function markdownBlocks(markdown: string): readonly MarkdownBlock[];
+/** Return actual CommonMark heading blocks, excluding fenced and indented code. */
+export declare function markdownHeadings(markdown: string): readonly MarkdownHeading[];
+//# sourceMappingURL=markdown.d.ts.map

package/dist/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../src/markdown.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,aAAa,GACrB;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC3E;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAS/B,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,aAAa,EAAE,CAQzE;AAED,mFAAmF;AACnF,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,eAAe,EAAE,CAE7E"}

package/dist/markdown.js

@@ -0,0 +1,22 @@
+import { fromMarkdown } from "mdast-util-from-markdown";
+function nodeText(node) {
+    if (node.type === "text" || node.type === "inlineCode") {
+        return node.value ?? "";
+    }
+    return (node.children ?? []).map(nodeText).join("");
+}
+/** Return actual top-level CommonMark blocks, excluding syntax nested in code. */
+export function markdownBlocks(markdown) {
+    const root = fromMarkdown(markdown);
+    return (root.children ?? []).map((node) => {
+        if (node.type === "heading" && typeof node.depth === "number") {
+            return { type: "heading", depth: node.depth, text: nodeText(node) };
+        }
+        return node.type === "list" ? { type: "list" } : { type: "other" };
+    });
+}
+/** Return actual CommonMark heading blocks, excluding fenced and indented code. */
+export function markdownHeadings(markdown) {
+    return markdownBlocks(markdown).flatMap((block) => block.type === "heading" ? [block] : []);
+}
+//# sourceMappingURL=markdown.js.map

package/dist/markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../src/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAmBxD,SAAS,QAAQ,CAAC,IAAe;IAC/B,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QACvD,OAAO,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;IAC1B,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACtD,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,MAAM,IAAI,GAAc,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC/C,OAAO,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAiB,EAAE;QACvD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9D,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACtE,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IACrE,CAAC,CAAC,CAAC;AACL,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,OAAO,cAAc,CAAC,QAAQ,CAAC,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;AAC9F,CAAC"}

package/dist/paths.d.ts

@@ -0,0 +1,35 @@
+export declare class InvalidBundlePathError extends Error {
+    constructor(message: string);
+}
+export type PathResolution = {
+    readonly kind: "fragment";
+    readonly fragment: string;
+} | {
+    readonly kind: "external";
+} | {
+    readonly kind: "escape";
+} | {
+    readonly kind: "invalid";
+} | {
+    readonly kind: "internal";
+    readonly path: string;
+    readonly fragment: string | null;
+};
+/** Code-point ordering is stable across runtimes and locales. */
+export declare function byCodePoint(left: string, right: string): number;
+/**
+ * Validate one confined Bundle-relative path and return its exact authored bytes.
+ *
+ * Unicode and whitespace are storage-key data, so this function never trims or
+ * normalizes them. Storage adapters decide separately whether a particular
+ * operation requires a `.md` suffix.
+ */
+export declare function validateBundlePath(value: string): string;
+/** Alias that emphasizes that the validated storage key is the canonical value. */
+export declare function canonicalizeBundlePath(value: string): string;
+/** Validate a change target, preserving its exact key and requiring the OKF suffix. */
+export declare function canonicalizeOperationPath(value: string): string;
+export declare function isSafeMarkdownPath(path: string): boolean;
+/** Resolve an authored Markdown destination without ever addressing outside one bundle. */
+export declare function resolveWithinBundle(source: string, href: string): PathResolution;
+//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAGA,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED,MAAM,MAAM,cAAc,GACtB;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACxD;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE,GAC7B;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAC3B;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AAE3F,iEAAiE;AACjE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAexD;AAED,mFAAmF;AACnF,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,uFAAuF;AACvF,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM/D;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAMxD;AAED,2FAA2F;AAC3F,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,CA8ChF"}

package/dist/paths.js

@@ -0,0 +1,103 @@
+const SCHEME = /^[A-Za-z][A-Za-z0-9+.-]*:/;
+const WINDOWS_ABSOLUTE = /^[A-Za-z]:\//;
+export class InvalidBundlePathError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "InvalidBundlePathError";
+    }
+}
+/** Code-point ordering is stable across runtimes and locales. */
+export function byCodePoint(left, right) {
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+/**
+ * Validate one confined Bundle-relative path and return its exact authored bytes.
+ *
+ * Unicode and whitespace are storage-key data, so this function never trims or
+ * normalizes them. Storage adapters decide separately whether a particular
+ * operation requires a `.md` suffix.
+ */
+export function validateBundlePath(value) {
+    if (typeof value !== "string" || value.length === 0) {
+        throw new InvalidBundlePathError("bundle path must not be empty");
+    }
+    if (value.includes("\0") || value.includes("\\")) {
+        throw new InvalidBundlePathError(`unsafe bundle path: ${value}`);
+    }
+    if (value.startsWith("/") || WINDOWS_ABSOLUTE.test(value)) {
+        throw new InvalidBundlePathError(`bundle path must be relative: ${value}`);
+    }
+    const segments = value.split("/");
+    if (segments.some((segment) => segment === "" || segment === "." || segment === "..")) {
+        throw new InvalidBundlePathError(`unsafe bundle path: ${value}`);
+    }
+    return value;
+}
+/** Alias that emphasizes that the validated storage key is the canonical value. */
+export function canonicalizeBundlePath(value) {
+    return validateBundlePath(value);
+}
+/** Validate a change target, preserving its exact key and requiring the OKF suffix. */
+export function canonicalizeOperationPath(value) {
+    const path = validateBundlePath(value);
+    if (!path.endsWith(".md")) {
+        throw new InvalidBundlePathError(`OKF operation path must end in .md: ${path}`);
+    }
+    return path;
+}
+export function isSafeMarkdownPath(path) {
+    try {
+        return canonicalizeOperationPath(path) === path;
+    }
+    catch {
+        return false;
+    }
+}
+/** Resolve an authored Markdown destination without ever addressing outside one bundle. */
+export function resolveWithinBundle(source, href) {
+    let value = href.trim();
+    if (!value) {
+        return { kind: "invalid" };
+    }
+    try {
+        value = decodeURIComponent(value);
+    }
+    catch {
+        return { kind: "invalid" };
+    }
+    if (value.startsWith("#")) {
+        return { kind: "fragment", fragment: value.slice(1) };
+    }
+    if (SCHEME.test(value) || value.startsWith("//")) {
+        return { kind: "external" };
+    }
+    const hash = value.indexOf("#");
+    const query = value.indexOf("?");
+    const end = [hash, query].filter((index) => index >= 0).reduce((a, b) => Math.min(a, b), value.length);
+    const clean = value.slice(0, end);
+    const fragment = hash >= 0 ? value.slice(hash + 1) : null;
+    if (!clean) {
+        return fragment === null ? { kind: "invalid" } : { kind: "fragment", fragment };
+    }
+    const base = clean.startsWith("/") ? [] : source.split("/").slice(0, -1);
+    const resolved = [];
+    for (const segment of [...base, ...clean.replace(/^\/+/, "").split("/")]) {
+        if (!segment || segment === ".") {
+            continue;
+        }
+        if (segment === "..") {
+            if (resolved.length === 0) {
+                return { kind: "escape" };
+            }
+            resolved.pop();
+            continue;
+        }
+        if (segment.includes("\\")) {
+            return { kind: "invalid" };
+        }
+        resolved.push(segment);
+    }
+    const path = resolved.join("/");
+    return path ? { kind: "internal", path, fragment } : { kind: "invalid" };
+}
+//# sourceMappingURL=paths.js.map