@nodes-dev/core 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Keith Hughitt
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,33 @@
+# @nodes-dev/core (TypeScript)
+
+TypeScript implementation of Nodes core — behavioral and on-disk-format parity with
+the Python distribution. Core contains the domain-free kernel.
+
+## Scope
+
+Mirrors the current Python kernel: `Node`/`Relation`, ids, errors, frontmatter
+parse/serialize, registry, structural shapes, a slimmed `Store` (pure file mechanics),
+the in-memory structural `Index`, and the `Corpus` coordinator — the primary API for
+mutations (`add`/`get`/`rename`/`delete`), graph queries
+(`outbound`/`inbound`/`neighbors`/`dangling`), membership traversal
+(`members`/`containers`/`descendants`/`ancestors`), BM25F full-text `search`, opt-in
+embedding `similar`/`queryVector`/`similarText`, snapshot persistence (`flushIndex`),
+and corpus checking (`check`). TS-only conveniences (tier 3): `idsByKind`/`allByKind`
+and corpus stat fingerprints.
+
+The portable contract this kernel implements is specified in `../docs/STANDARD.md`
+(spec version 1.2); parity with Python is pinned by the shared `../fixtures/` oracles.
+
+## Conventions
+
+- **camelCase API, snake_case on disk.** The on-disk YAML format is identical to Python's; the only
+  field that differs API-vs-disk is `deprecatedIds` (API) ↔ `deprecated_ids` (file).
+- Dates are `YYYY-MM-DD` strings (never JS `Date`), validated by Zod.
+- Validation failures surface as the kernel error hierarchy (`ValidationError`, `FacetError`, …),
+  never raw Zod errors.
+
+## Scripts
+
+- `npm test` — Vitest suite (includes the cross-language parity checks)
+- `npm run typecheck` — `tsc --noEmit` (the type gate)
+- `npm run check` — Biome lint + format

package/dist/corpus.d.ts

@@ -0,0 +1,61 @@
+import type { Node } from "./node.js";
+import type { Registry } from "./registry.js";
+import { type SearchHit, SearchIndex } from "./search.js";
+import { type Embedder, type SimilarHit, type Vector, VectorCache, VectorIndex } from "./similarity.js";
+import { type ManifestEntry } from "./snapshot.js";
+import { Store } from "./store.js";
+import { Index, type ResolvedEdge } from "./structural-index.js";
+/** One corpus-check finding (reported, never thrown). */
+export interface Finding {
+    readonly severity: "error" | "warning";
+    readonly code: string;
+    readonly ref: string;
+    readonly detail: string;
+    readonly message: string;
+}
+/** Coordinator over a `Store` + an in-memory `Index`. The primary kernel API. */
+export declare class Corpus {
+    readonly store: Store;
+    readonly registry?: Registry;
+    index: Index;
+    searchIndex: SearchIndex;
+    readonly embedder?: Embedder;
+    readonly vectorCache?: VectorCache;
+    vectorIndex?: VectorIndex;
+    manifest: Map<string, ManifestEntry>;
+    constructor(root: string, registry?: Registry, embedder?: Embedder);
+    private relPath;
+    private recordManifest;
+    private fullRebuild;
+    private reconcile;
+    flushIndex(): void;
+    private idFor;
+    private requireUid;
+    add(node: Node): Node;
+    get(ref: string): Node;
+    resolve(ref: string): Node;
+    delete(nodeId: string): void;
+    all(): Node[];
+    idsByKind(kind: string): string[];
+    allByKind(kind: string): Node[];
+    outbound(ref: string): ResolvedEdge[];
+    inbound(ref: string): ResolvedEdge[];
+    dangling(): ResolvedEdge[];
+    neighbors(ref: string): Node[];
+    private sortedLiveIds;
+    members(ref: string): string[];
+    containers(ref: string): string[];
+    descendants(ref: string): string[];
+    ancestors(ref: string): string[];
+    rename(oldId: string, newId: string): Node;
+    /** Report corpus-validity findings; never throws on content. Registry violations
+     * (configured or passed) are errors; unresolved top-level relation targets and
+     * unresolved membership member refs are warnings. Sorted by (ref, code, detail)
+     * — `message` is human-only. */
+    check(registry?: Registry): Finding[];
+    search(query: string, limit?: number): SearchHit[];
+    similar(ref: string, k?: number): SimilarHit[];
+    queryVector(vec: Vector, k?: number): SimilarHit[];
+    similarText(text: string, k?: number): SimilarHit[];
+}
+//# sourceMappingURL=corpus.d.ts.map

package/dist/corpus.d.ts.map

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

package/dist/corpus.js

@@ -0,0 +1,383 @@
+import { CollisionError, EmbedderRequiredError, RefError } from "./errors.js";
+import { nodeFromMarkdown, nodeToMarkdown } from "./frontmatter.js";
+import { NodeId } from "./ids.js";
+import { SearchIndex, compareCodepoints } from "./search.js";
+import { EDGES, KEYS, MEMBERSHIP, ORDER } from "./shapes.js";
+import { VectorCache, VectorIndex } from "./similarity.js";
+import { hashBytes, iterCorpusFiles, loadSnapshot, pathForNodeId, writeSnapshot, } from "./snapshot.js";
+import { Store } from "./store.js";
+import { Index } from "./structural-index.js";
+/** Rewrite every position in `node` that holds `oldId` to `newId` (in place):
+ * top-level relations plus the built-in structural form facets. */
+function rewriteRefs(node, oldId, newId) {
+    for (const rel of node.relations) {
+        if (rel.source === oldId)
+            rel.source = newId;
+        if (rel.target === oldId)
+            rel.target = newId;
+    }
+    const mem = node.facets[MEMBERSHIP];
+    if (mem !== null && typeof mem === "object") {
+        const members = mem.members;
+        if (Array.isArray(members)) {
+            mem.members = members.map((m) => (m === oldId ? newId : m));
+        }
+    }
+    const eg = node.facets[EDGES];
+    if (eg !== null && typeof eg === "object") {
+        const edges = eg.edges;
+        if (Array.isArray(edges)) {
+            for (const edge of edges) {
+                if (edge !== null && typeof edge === "object") {
+                    const e = edge;
+                    if (e.source === oldId)
+                        e.source = newId;
+                    if (e.target === oldId)
+                        e.target = newId;
+                }
+            }
+        }
+    }
+    const od = node.facets[ORDER];
+    if (od !== null && typeof od === "object") {
+        const order = od.order;
+        if (Array.isArray(order)) {
+            od.order = order.map((m) => (m === oldId ? newId : m));
+        }
+    }
+    const ky = node.facets[KEYS];
+    if (ky !== null && typeof ky === "object") {
+        const keys = ky.keys;
+        if (keys !== null && typeof keys === "object") {
+            const km = keys;
+            for (const k of Object.keys(km)) {
+                if (km[k] === oldId)
+                    km[k] = newId;
+            }
+        }
+    }
+}
+/** Coordinator over a `Store` + an in-memory `Index`. The primary kernel API. */
+export class Corpus {
+    store;
+    registry;
+    index;
+    searchIndex;
+    embedder;
+    vectorCache;
+    vectorIndex;
+    manifest;
+    constructor(root, registry, embedder) {
+        this.store = new Store(root);
+        this.registry = registry;
+        this.embedder = embedder;
+        this.vectorCache = embedder !== undefined ? new VectorCache(root) : undefined;
+        this.manifest = new Map();
+        const namespace = embedder !== undefined ? embedder.cacheNamespace : null;
+        const snap = loadSnapshot(this.store.root, namespace);
+        if (snap === null)
+            this.fullRebuild();
+        else
+            this.reconcile(snap);
+    }
+    relPath(nodeId) {
+        return pathForNodeId(nodeId);
+    }
+    recordManifest(node) {
+        const path = this.relPath(node.id);
+        const data = Buffer.from(nodeToMarkdown(node), "utf-8");
+        this.manifest.set(path, { path, sha256: hashBytes(data), uid: node.uid });
+    }
+    fullRebuild() {
+        const nodes = [];
+        const manifest = new Map();
+        for (const f of iterCorpusFiles(this.store.root)) {
+            const node = nodeFromMarkdown(f.data.toString("utf-8"));
+            nodes.push(node);
+            manifest.set(f.path, { path: f.path, sha256: f.sha256, uid: node.uid });
+        }
+        this.index = Index.build(nodes);
+        this.searchIndex = SearchIndex.build(nodes);
+        if (this.embedder !== undefined) {
+            this.vectorIndex = VectorIndex.build(nodes, this.embedder, this.vectorCache);
+        }
+        else {
+            this.vectorIndex = undefined;
+        }
+        this.manifest = manifest;
+    }
+    reconcile(snap) {
+        this.index = snap.index;
+        this.searchIndex = snap.searchIndex;
+        this.vectorIndex = snap.vectorIndex ?? undefined;
+        const old = new Map(snap.manifest.map((m) => [m.path, m]));
+        const newManifest = new Map();
+        const changed = [];
+        const drops = [];
+        const current = new Set();
+        for (const f of iterCorpusFiles(this.store.root)) {
+            current.add(f.path);
+            const prev = old.get(f.path);
+            if (prev !== undefined && prev.sha256 === f.sha256) {
+                newManifest.set(f.path, prev); // unchanged: keep deserialized state, no parse
+                continue;
+            }
+            if (prev !== undefined)
+                drops.push(prev.uid);
+            changed.push({ path: f.path, sha256: f.sha256, node: nodeFromMarkdown(f.data.toString("utf-8")) });
+        }
+        for (const [path, m] of old) {
+            if (!current.has(path))
+                drops.push(m.uid); // deleted on disk
+        }
+        for (const uid of drops) {
+            this.index.remove(uid);
+            this.searchIndex.remove(uid);
+            this.vectorIndex?.remove(uid);
+        }
+        for (const { path, sha256, node } of changed) {
+            // Full build() collision contract: duplicate uid is rejected outright, then assertAddable.
+            if (this.index.byUid.has(node.uid))
+                throw new CollisionError(`duplicate uid ${JSON.stringify(node.uid)} in corpus`);
+            this.index.assertAddable(node);
+            const prepared = this.vectorIndex !== undefined
+                ? this.vectorIndex.prepare(node, this.embedder, this.vectorCache)
+                : undefined;
+            this.index.upsert(node);
+            this.searchIndex.upsert(node);
+            if (this.vectorIndex !== undefined && prepared !== undefined)
+                this.vectorIndex.commit(node, prepared);
+            newManifest.set(path, { path, sha256, uid: node.uid });
+        }
+        this.manifest = newManifest;
+    }
+    flushIndex() {
+        const manifest = [...this.manifest.values()].sort((a, b) => (a.path < b.path ? -1 : a.path > b.path ? 1 : 0));
+        writeSnapshot(this.store.root, manifest, this.index, this.searchIndex, this.vectorIndex);
+    }
+    idFor(uid) {
+        const entry = this.index.byUid.get(uid);
+        if (entry === undefined)
+            throw new RefError(`uid ${JSON.stringify(uid)} not in index`);
+        return entry.id;
+    }
+    requireUid(ref) {
+        const uid = this.index.resolveUid(ref);
+        if (uid === null)
+            throw new RefError(`no node resolves ref ${JSON.stringify(ref)}`);
+        return uid;
+    }
+    add(node) {
+        if (this.registry !== undefined)
+            this.registry.validate(node);
+        this.index.assertAddable(node);
+        const prepared = this.vectorIndex !== undefined
+            ? this.vectorIndex.prepare(node, this.embedder, this.vectorCache)
+            : undefined;
+        this.store.writeFile(node);
+        this.index.upsert(node);
+        this.searchIndex.upsert(node);
+        if (this.vectorIndex !== undefined && prepared !== undefined) {
+            this.vectorIndex.commit(node, prepared);
+        }
+        this.recordManifest(node);
+        return node;
+    }
+    get(ref) {
+        return this.store.readFile(this.idFor(this.requireUid(ref)));
+    }
+    resolve(ref) {
+        return this.get(ref);
+    }
+    delete(nodeId) {
+        const uid = this.index.idToUid.get(nodeId);
+        if (uid === undefined)
+            throw new RefError(`no live node at ${JSON.stringify(nodeId)}`);
+        const path = this.relPath(nodeId);
+        this.store.deleteFile(nodeId);
+        this.index.remove(uid);
+        this.searchIndex.remove(uid);
+        this.vectorIndex?.remove(uid);
+        this.manifest.delete(path);
+    }
+    all() {
+        return this.store.allNodes();
+    }
+    idsByKind(kind) {
+        const ids = [];
+        for (const entry of this.index.byUid.values()) {
+            if (entry.kind === kind)
+                ids.push(entry.id);
+        }
+        return ids.sort();
+    }
+    allByKind(kind) {
+        return this.idsByKind(kind).map((id) => this.store.readFile(id));
+    }
+    outbound(ref) {
+        return this.index.outboundEdges(this.requireUid(ref));
+    }
+    inbound(ref) {
+        return this.index.inboundEdges(this.requireUid(ref));
+    }
+    dangling() {
+        return this.index.danglingEdges();
+    }
+    neighbors(ref) {
+        const uid = this.requireUid(ref);
+        const neighborUids = new Set();
+        for (const edge of this.index.outboundEdges(uid)) {
+            if (edge.targetUid !== null)
+                neighborUids.add(edge.targetUid);
+        }
+        for (const edge of this.index.inboundEdges(uid)) {
+            if (edge.sourceUid !== null)
+                neighborUids.add(edge.sourceUid);
+        }
+        neighborUids.delete(uid);
+        return [...neighborUids].sort().map((u) => this.store.readFile(this.idFor(u)));
+    }
+    sortedLiveIds(uids) {
+        return [...uids].map((u) => this.idFor(u)).sort(compareCodepoints);
+    }
+    members(ref) {
+        return this.sortedLiveIds(this.index.membersOf(this.requireUid(ref)));
+    }
+    containers(ref) {
+        return this.sortedLiveIds(this.index.containersOf(this.requireUid(ref)));
+    }
+    descendants(ref) {
+        return this.sortedLiveIds(this.index.membershipClosure(this.requireUid(ref), "members"));
+    }
+    ancestors(ref) {
+        return this.sortedLiveIds(this.index.membershipClosure(this.requireUid(ref), "containers"));
+    }
+    rename(oldId, newId) {
+        // 1. oldId must be a LIVE id (not unknown, not merely deprecated); then collision-check newId.
+        const uid = this.index.idToUid.get(oldId);
+        if (uid === undefined)
+            throw new RefError(`rename source ${JSON.stringify(oldId)} is not a live id`);
+        if (this.index.resolveUid(newId) !== null) {
+            throw new CollisionError(`target id ${JSON.stringify(newId)} already in use`);
+        }
+        // 2. Snapshot the referrer set BEFORE any index mutation (upsert rewrites inRefs).
+        const referrerUids = new Set();
+        for (const inref of this.index.inRefs.get(oldId) ?? [])
+            referrerUids.add(inref.sourceUid);
+        // 3. Rewrite the renamed node itself (incl. its own oldId refs).
+        const node = this.store.readFile(oldId);
+        const oldPath = this.store.pathFor(oldId);
+        const oldRelPath = this.relPath(oldId);
+        node.id = newId;
+        node.kind = NodeId.parse(newId).kind;
+        if (!node.deprecatedIds.includes(oldId))
+            node.deprecatedIds.push(oldId);
+        rewriteRefs(node, oldId, newId);
+        // 4. Rewrite every OTHER referrer in memory.
+        const referrers = [];
+        for (const referrerUid of referrerUids) {
+            if (referrerUid === uid)
+                continue;
+            const referrer = this.store.readFile(this.idFor(referrerUid));
+            rewriteRefs(referrer, oldId, newId);
+            referrers.push(referrer);
+        }
+        // 5. Validate ALL writes before ANY write (fail-early, no partial rename).
+        if (this.registry !== undefined) {
+            this.registry.validate(node);
+            for (const referrer of referrers)
+                this.registry.validate(referrer);
+        }
+        // 5b. Prepare the renamed node's + referrers' vectors (fail before any disk write).
+        const prepared = this.vectorIndex !== undefined
+            ? this.vectorIndex.prepare(node, this.embedder, this.vectorCache)
+            : undefined;
+        const preparedReferrers = this.vectorIndex !== undefined
+            ? referrers.map((r) => this.vectorIndex.prepare(r, this.embedder, this.vectorCache))
+            : [];
+        // 6. Commit: renamed node first (crash-atomic), then referrers. Each written once.
+        const newPath = this.store.writeFile(node);
+        if (oldPath !== newPath)
+            this.store.deleteFile(oldId);
+        this.index.upsert(node);
+        for (let i = 0; i < referrers.length; i++) {
+            const referrer = referrers[i];
+            this.store.writeFile(referrer);
+            this.index.upsert(referrer);
+            this.searchIndex.upsert(referrer);
+            if (this.vectorIndex !== undefined)
+                this.vectorIndex.commit(referrer, preparedReferrers[i]);
+        }
+        this.searchIndex.upsert(node);
+        if (this.vectorIndex !== undefined && prepared !== undefined) {
+            this.vectorIndex.commit(node, prepared);
+        }
+        // 7. Manifest: remove old path on move; re-record the renamed node and every rewritten referrer.
+        if (oldPath !== newPath)
+            this.manifest.delete(oldRelPath);
+        this.recordManifest(node);
+        for (const referrer of referrers)
+            this.recordManifest(referrer);
+        return node;
+    }
+    /** Report corpus-validity findings; never throws on content. Registry violations
+     * (configured or passed) are errors; unresolved top-level relation targets and
+     * unresolved membership member refs are warnings. Sorted by (ref, code, detail)
+     * — `message` is human-only. */
+    check(registry) {
+        const reg = registry ?? this.registry;
+        const findings = [];
+        if (reg !== undefined) {
+            for (const node of this.store.allNodes()) {
+                for (const v of reg.check(node)) {
+                    findings.push({ severity: "error", code: v.code, ref: node.id, detail: v.detail, message: v.message });
+                }
+            }
+        }
+        for (const edge of this.index.danglingEdges()) {
+            const rel = edge.relation;
+            findings.push({
+                severity: "warning",
+                code: "dangling-ref",
+                ref: rel.source,
+                detail: rel.target,
+                message: `${rel.source}: relation ${JSON.stringify(rel.predicate)} ` +
+                    `targets unresolved ${JSON.stringify(rel.target)}`,
+            });
+        }
+        for (const { sourceUid, ref } of this.index.danglingMembers()) {
+            const containerId = this.idFor(sourceUid);
+            findings.push({
+                severity: "warning",
+                code: "dangling-member",
+                ref: containerId,
+                detail: ref,
+                message: `${containerId}: member ${JSON.stringify(ref)} resolves to no live node`,
+            });
+        }
+        findings.sort((a, b) => compareCodepoints(a.ref, b.ref) || compareCodepoints(a.code, b.code) || compareCodepoints(a.detail, b.detail));
+        return findings;
+    }
+    search(query, limit) {
+        return this.searchIndex.search(query, limit);
+    }
+    similar(ref, k) {
+        if (this.vectorIndex === undefined) {
+            throw new EmbedderRequiredError("similarity requires Corpus(root, registry?, embedder)");
+        }
+        return this.vectorIndex.similar(this.requireUid(ref), k);
+    }
+    queryVector(vec, k) {
+        if (this.vectorIndex === undefined) {
+            throw new EmbedderRequiredError("similarity requires Corpus(root, registry?, embedder)");
+        }
+        return this.vectorIndex.queryVector(vec, k);
+    }
+    similarText(text, k) {
+        if (this.vectorIndex === undefined) {
+            throw new EmbedderRequiredError("similarity requires Corpus(root, registry?, embedder)");
+        }
+        return this.vectorIndex.similarText(text, this.embedder, k);
+    }
+}
+//# sourceMappingURL=corpus.js.map

package/dist/corpus.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,20 @@
+export declare class NodesError extends Error {
+    constructor(message?: string);
+}
+export declare class IdError extends NodesError {
+}
+export declare class RefError extends NodesError {
+}
+export declare class CollisionError extends NodesError {
+}
+export declare class UnknownKindError extends NodesError {
+}
+export declare class FacetError extends NodesError {
+}
+export declare class InvariantError extends NodesError {
+}
+export declare class ValidationError extends NodesError {
+}
+export declare class EmbedderRequiredError extends NodesError {
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,UAAW,SAAQ,KAAK;gBACvB,OAAO,CAAC,EAAE,MAAM;CAI7B;AAED,qBAAa,OAAQ,SAAQ,UAAU;CAAG;AAC1C,qBAAa,QAAS,SAAQ,UAAU;CAAG;AAC3C,qBAAa,cAAe,SAAQ,UAAU;CAAG;AACjD,qBAAa,gBAAiB,SAAQ,UAAU;CAAG;AACnD,qBAAa,UAAW,SAAQ,UAAU;CAAG;AAC7C,qBAAa,cAAe,SAAQ,UAAU;CAAG;AACjD,qBAAa,eAAgB,SAAQ,UAAU;CAAG;AAClD,qBAAa,qBAAsB,SAAQ,UAAU;CAAG"}

package/dist/errors.js

@@ -0,0 +1,23 @@
+export class NodesError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = new.target.name;
+    }
+}
+export class IdError extends NodesError {
+}
+export class RefError extends NodesError {
+}
+export class CollisionError extends NodesError {
+}
+export class UnknownKindError extends NodesError {
+}
+export class FacetError extends NodesError {
+}
+export class InvariantError extends NodesError {
+}
+export class ValidationError extends NodesError {
+}
+export class EmbedderRequiredError extends NodesError {
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,UAAW,SAAQ,KAAK;IACnC,YAAY,OAAgB;QAC1B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,OAAQ,SAAQ,UAAU;CAAG;AAC1C,MAAM,OAAO,QAAS,SAAQ,UAAU;CAAG;AAC3C,MAAM,OAAO,cAAe,SAAQ,UAAU;CAAG;AACjD,MAAM,OAAO,gBAAiB,SAAQ,UAAU;CAAG;AACnD,MAAM,OAAO,UAAW,SAAQ,UAAU;CAAG;AAC7C,MAAM,OAAO,cAAe,SAAQ,UAAU;CAAG;AACjD,MAAM,OAAO,eAAgB,SAAQ,UAAU;CAAG;AAClD,MAAM,OAAO,qBAAsB,SAAQ,UAAU;CAAG"}

package/dist/frontmatter.d.ts

@@ -0,0 +1,5 @@
+import { type Node } from "./node.js";
+export declare function splitFrontmatter(text: string): [Record<string, unknown>, string];
+export declare function nodeFromMarkdown(text: string): Node;
+export declare function nodeToMarkdown(node: Node): string;
+//# 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":"AAGA,OAAO,EAAE,KAAK,IAAI,EAAY,MAAM,WAAW,CAAC;AAGhD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,CAiBhF;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAmDnD;AAYD,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAejD"}