@nodes-dev/core 0.0.0

package/dist/frontmatter.js

@@ -0,0 +1,103 @@
+import { parseDocument, stringify } from "yaml";
+import { z } from "zod";
+import { ValidationError } from "./errors.js";
+import { makeNode } from "./node.js";
+import { RELATES_TO, fromSerialized, relatesTo, toSerialized } from "./relations.js";
+export function splitFrontmatter(text) {
+    let nl;
+    if (text.startsWith("---\r\n"))
+        nl = "\r\n";
+    else if (text.startsWith("---\n"))
+        nl = "\n";
+    else
+        return [{}, text];
+    const rest = text.slice(3 + nl.length);
+    const sep = `${nl}---${nl}`;
+    const idx = rest.indexOf(sep);
+    if (idx === -1)
+        return [{}, text];
+    const doc = parseDocument(rest.slice(0, idx));
+    if (doc.errors.length > 0) {
+        throw new ValidationError(`invalid frontmatter YAML: ${doc.errors[0].message}`);
+    }
+    const fm = (doc.toJS() ?? {});
+    return [fm, rest.slice(idx + sep.length)];
+}
+export function nodeFromMarkdown(text) {
+    const [fm, body] = splitFrontmatter(text);
+    const missing = ["id", "uid", "kind", "title"].filter((k) => !(k in fm));
+    if (missing.length > 0) {
+        throw new ValidationError(`frontmatter missing required field(s): ${JSON.stringify(missing)}`);
+    }
+    const nodeId = fm.id;
+    // `nodeFromMarkdown` is a boundary parser: every malformed-input path leaves as a typed
+    // kernel error (spec §7), never a raw ZodError or a raw TypeError. Collection fields must be
+    // lists — a scalar or mapping is a ValidationError, not a "not iterable" TypeError. (Python's
+    // node_from_markdown leaks a raw TypeError here; the TS boundary deliberately tightens that.)
+    if (fm.related !== undefined && !Array.isArray(fm.related)) {
+        throw new ValidationError(`'related' must be a list in ${JSON.stringify(nodeId)}`);
+    }
+    if (fm.relations !== undefined && !Array.isArray(fm.relations)) {
+        throw new ValidationError(`'relations' must be a list in ${JSON.stringify(nodeId)}`);
+    }
+    const relations = [];
+    try {
+        for (const ref of fm.related ?? []) {
+            relations.push(relatesTo(nodeId, ref));
+        }
+        for (const raw of fm.relations ?? []) {
+            relations.push(fromSerialized(raw, nodeId));
+        }
+    }
+    catch (e) {
+        if (e instanceof z.ZodError) {
+            throw new ValidationError(`invalid relation in ${JSON.stringify(nodeId)}: ${e.issues.map((i) => i.message).join("; ")}`);
+        }
+        throw e;
+    }
+    const metadata = {};
+    for (const k of ["created", "updated", "version"]) {
+        if (k in fm)
+            metadata[k] = fm[k];
+    }
+    return makeNode({
+        id: nodeId,
+        uid: fm.uid,
+        kind: fm.kind,
+        title: fm.title,
+        body,
+        metadata,
+        relations,
+        facets: fm.facets ?? {},
+        deprecatedIds: fm.deprecated_ids ?? [],
+    });
+}
+function isPlainRelatesTo(rel, nodeId) {
+    return (rel.predicate === RELATES_TO &&
+        rel.source === nodeId &&
+        rel.directed === true &&
+        rel.weight === null &&
+        Object.keys(rel.attrs).length === 0);
+}
+export function nodeToMarkdown(node) {
+    const fm = { id: node.id, uid: node.uid, kind: node.kind, title: node.title };
+    if (node.metadata.created !== null)
+        fm.created = node.metadata.created;
+    if (node.metadata.updated !== null)
+        fm.updated = node.metadata.updated;
+    if (node.metadata.version !== 1)
+        fm.version = node.metadata.version;
+    const related = node.relations.filter((r) => isPlainRelatesTo(r, node.id)).map((r) => r.target);
+    const typed = node.relations.filter((r) => !isPlainRelatesTo(r, node.id)).map((r) => toSerialized(r, node.id));
+    if (related.length > 0)
+        fm.related = related;
+    if (typed.length > 0)
+        fm.relations = typed;
+    if (Object.keys(node.facets).length > 0)
+        fm.facets = node.facets;
+    if (node.deprecatedIds.length > 0)
+        fm.deprecated_ids = node.deprecatedIds;
+    const yamlText = stringify(fm, { sortMapEntries: false }).trimEnd();
+    return `---\n${yamlText}\n---\n${node.body}`;
+}
+//# 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/ids.d.ts

@@ -0,0 +1,11 @@
+export type Ref = string;
+export declare class NodeId {
+    readonly kind: string;
+    readonly slug: string;
+    constructor(kind: string, slug: string);
+    static isValidKind(kind: string): boolean;
+    static isValidSlug(slug: string): boolean;
+    static parse(raw: string): NodeId;
+    toString(): string;
+}
+//# sourceMappingURL=ids.d.ts.map

package/dist/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../src/ids.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC;AAKzB,qBAAa,MAAM;IAEf,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM;gBADZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM;IAGvB,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIzC,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIzC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAgBjC,QAAQ,IAAI,MAAM;CAGnB"}

package/dist/ids.js

@@ -0,0 +1,36 @@
+import { IdError } from "./errors.js";
+const KIND_RE = /^[a-z][a-z0-9-]*$/;
+const SLUG_RE = /^[A-Za-z0-9][A-Za-z0-9:_.-]*$/;
+export class NodeId {
+    kind;
+    slug;
+    constructor(kind, slug) {
+        this.kind = kind;
+        this.slug = slug;
+    }
+    static isValidKind(kind) {
+        return KIND_RE.test(kind);
+    }
+    static isValidSlug(slug) {
+        return SLUG_RE.test(slug);
+    }
+    static parse(raw) {
+        const idx = raw.indexOf(":");
+        if (idx === -1) {
+            throw new IdError(`id must be 'kind:slug', got ${JSON.stringify(raw)}`);
+        }
+        const kind = raw.slice(0, idx);
+        const slug = raw.slice(idx + 1);
+        if (!NodeId.isValidKind(kind)) {
+            throw new IdError(`invalid kind ${JSON.stringify(kind)} in id ${JSON.stringify(raw)}`);
+        }
+        if (!NodeId.isValidSlug(slug)) {
+            throw new IdError(`invalid slug ${JSON.stringify(slug)} in id ${JSON.stringify(raw)}`);
+        }
+        return new NodeId(kind, slug);
+    }
+    toString() {
+        return `${this.kind}:${this.slug}`;
+    }
+}
+//# sourceMappingURL=ids.js.map

package/dist/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../src/ids.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAItC,MAAM,OAAO,GAAG,mBAAmB,CAAC;AACpC,MAAM,OAAO,GAAG,+BAA+B,CAAC;AAEhD,MAAM,OAAO,MAAM;IAEN;IACA;IAFX,YACW,IAAY,EACZ,IAAY;QADZ,SAAI,GAAJ,IAAI,CAAQ;QACZ,SAAI,GAAJ,IAAI,CAAQ;IACpB,CAAC;IAEJ,MAAM,CAAC,WAAW,CAAC,IAAY;QAC7B,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,IAAY;QAC7B,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,GAAW;QACtB,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;YACf,MAAM,IAAI,OAAO,CAAC,+BAA+B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC1E,CAAC;QACD,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAC/B,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;QAChC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,OAAO,CAAC,gBAAgB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACzF,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,OAAO,CAAC,gBAAgB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACzF,CAAC;QACD,OAAO,IAAI,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,QAAQ;QACN,OAAO,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;IACrC,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export { CollisionError, EmbedderRequiredError, FacetError, IdError, InvariantError, NodesError, RefError, UnknownKindError, ValidationError, } from "./errors.js";
+export { NodeId, type Ref } from "./ids.js";
+export { RELATES_TO, RelationSchema, type Relation, fromSerialized, relatesTo, tagToRelation, toSerialized, } from "./relations.js";
+export { NodeMetadataSchema, NodeSchema, type Node, type NodeInput, type NodeMetadata, makeNode, newUid, } from "./node.js";
+export { nodeFromMarkdown, nodeToMarkdown, splitFrontmatter } from "./frontmatter.js";
+export { type Invariant, type KindSpec, type ShapeSpec, type Violation, Registry } from "./registry.js";
+export { EDGES, EdgesSchema, KEYS, KeysSchema, MEMBERSHIP, MembershipSchema, ORDER, OrderSchema, edgesOf, keysOf, membershipOf, orderOf, registerBuiltinShapes, requireAcyclic, requireEdgeEndpointsAreMembers, requireKeyValuesAreMembers, requireOrderIsPermutation, requireSingleParent, requireUniqueMembers, } from "./shapes.js";
+export type { Edges, Keys, Membership, Order } from "./shapes.js";
+export { Store } from "./store.js";
+export { Corpus, type Finding } from "./corpus.js";
+export { type CorpusFile, type CorpusFileStat, type CorpusFingerprint, type ManifestEntry, type Snapshot, SNAPSHOT_LANG, SNAPSHOT_SCHEMA_VERSION, hashBytes, iterCorpusFiles, listCorpusFileStats, loadSnapshot, pathForNodeId, readCorpusFingerprint, readJson, sameCorpusFingerprint, snapshotPath, writeJsonAtomic, writeSnapshot, } from "./snapshot.js";
+export { Index, type InRef, type IndexEntry, type OutRef, type ResolvedEdge, type Role, } from "./structural-index.js";
+export { scoreKey } from "./ranking.js";
+export { SearchIndex, type SearchHit, type SearchSnapshot, tokenize } from "./search.js";
+export { type Embedder, type SimilarHit, type Vector, type VectorSnapshot, VectorCache, VectorIndex, embedText, textHash, validateNamespace, validateTextHash, } from "./similarity.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,EACL,cAAc,EACd,qBAAqB,EACrB,UAAU,EACV,OAAO,EACP,cAAc,EACd,UAAU,EACV,QAAQ,EACR,gBAAgB,EAChB,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,MAAM,EAAE,KAAK,GAAG,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EACL,UAAU,EACV,cAAc,EACd,KAAK,QAAQ,EACb,cAAc,EACd,SAAS,EACT,aAAa,EACb,YAAY,GACb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,kBAAkB,EAClB,UAAU,EACV,KAAK,IAAI,EACT,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,QAAQ,EACR,MAAM,GACP,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACtF,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACxG,OAAO,EACL,KAAK,EACL,WAAW,EACX,IAAI,EACJ,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,KAAK,EACL,WAAW,EACX,OAAO,EACP,MAAM,EACN,YAAY,EACZ,OAAO,EACP,qBAAqB,EACrB,cAAc,EACd,8BAA8B,EAC9B,0BAA0B,EAC1B,yBAAyB,EACzB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EACL,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,QAAQ,EACb,aAAa,EACb,uBAAuB,EACvB,SAAS,EACT,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,aAAa,EACb,qBAAqB,EACrB,QAAQ,EACR,qBAAqB,EACrB,YAAY,EACZ,eAAe,EACf,aAAa,GACd,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,KAAK,EACL,KAAK,KAAK,EACV,KAAK,UAAU,EACf,KAAK,MAAM,EACX,KAAK,YAAY,EACjB,KAAK,IAAI,GACV,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,cAAc,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACzF,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,MAAM,EACX,KAAK,cAAc,EACnB,WAAW,EACX,WAAW,EACX,SAAS,EACT,QAAQ,EACR,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+export { CollisionError, EmbedderRequiredError, FacetError, IdError, InvariantError, NodesError, RefError, UnknownKindError, ValidationError, } from "./errors.js";
+export { NodeId } from "./ids.js";
+export { RELATES_TO, RelationSchema, fromSerialized, relatesTo, tagToRelation, toSerialized, } from "./relations.js";
+export { NodeMetadataSchema, NodeSchema, makeNode, newUid, } from "./node.js";
+export { nodeFromMarkdown, nodeToMarkdown, splitFrontmatter } from "./frontmatter.js";
+export { Registry } from "./registry.js";
+export { EDGES, EdgesSchema, KEYS, KeysSchema, MEMBERSHIP, MembershipSchema, ORDER, OrderSchema, edgesOf, keysOf, membershipOf, orderOf, registerBuiltinShapes, requireAcyclic, requireEdgeEndpointsAreMembers, requireKeyValuesAreMembers, requireOrderIsPermutation, requireSingleParent, requireUniqueMembers, } from "./shapes.js";
+export { Store } from "./store.js";
+export { Corpus } from "./corpus.js";
+export { SNAPSHOT_LANG, SNAPSHOT_SCHEMA_VERSION, hashBytes, iterCorpusFiles, listCorpusFileStats, loadSnapshot, pathForNodeId, readCorpusFingerprint, readJson, sameCorpusFingerprint, snapshotPath, writeJsonAtomic, writeSnapshot, } from "./snapshot.js";
+export { Index, } from "./structural-index.js";
+export { scoreKey } from "./ranking.js";
+export { SearchIndex, tokenize } from "./search.js";
+export { VectorCache, VectorIndex, embedText, textHash, validateNamespace, validateTextHash, } from "./similarity.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,EACL,cAAc,EACd,qBAAqB,EACrB,UAAU,EACV,OAAO,EACP,cAAc,EACd,UAAU,EACV,QAAQ,EACR,gBAAgB,EAChB,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,MAAM,EAAY,MAAM,UAAU,CAAC;AAC5C,OAAO,EACL,UAAU,EACV,cAAc,EAEd,cAAc,EACd,SAAS,EACT,aAAa,EACb,YAAY,GACb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,kBAAkB,EAClB,UAAU,EAIV,QAAQ,EACR,MAAM,GACP,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACtF,OAAO,EAAiE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACxG,OAAO,EACL,KAAK,EACL,WAAW,EACX,IAAI,EACJ,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,KAAK,EACL,WAAW,EACX,OAAO,EACP,MAAM,EACN,YAAY,EACZ,OAAO,EACP,qBAAqB,EACrB,cAAc,EACd,8BAA8B,EAC9B,0BAA0B,EAC1B,yBAAyB,EACzB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,MAAM,EAAgB,MAAM,aAAa,CAAC;AACnD,OAAO,EAML,aAAa,EACb,uBAAuB,EACvB,SAAS,EACT,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,aAAa,EACb,qBAAqB,EACrB,QAAQ,EACR,qBAAqB,EACrB,YAAY,EACZ,eAAe,EACf,aAAa,GACd,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,KAAK,GAMN,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,WAAW,EAAuC,QAAQ,EAAE,MAAM,aAAa,CAAC;AACzF,OAAO,EAKL,WAAW,EACX,WAAW,EACX,SAAS,EACT,QAAQ,EACR,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC"}

package/dist/node.d.ts

@@ -0,0 +1,106 @@
+import { z } from "zod";
+export declare function newUid(): string;
+export declare const NodeMetadataSchema: z.ZodObject<{
+    created: z.ZodDefault<z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>>;
+    updated: z.ZodDefault<z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>>;
+    version: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    created: string | null;
+    updated: string | null;
+    version: number;
+}, {
+    created?: string | null | undefined;
+    updated?: string | null | undefined;
+    version?: number | undefined;
+}>;
+export type NodeMetadata = z.infer<typeof NodeMetadataSchema>;
+export declare const NodeSchema: z.ZodObject<{
+    id: z.ZodString;
+    uid: z.ZodDefault<z.ZodString>;
+    kind: z.ZodString;
+    title: z.ZodString;
+    body: z.ZodDefault<z.ZodString>;
+    metadata: z.ZodEffects<z.ZodObject<{
+        created: z.ZodDefault<z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>>;
+        updated: z.ZodDefault<z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>>;
+        version: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        created: string | null;
+        updated: string | null;
+        version: number;
+    }, {
+        created?: string | null | undefined;
+        updated?: string | null | undefined;
+        version?: number | undefined;
+    }>, {
+        created: string | null;
+        updated: string | null;
+        version: number;
+    }, unknown>;
+    relations: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        source: z.ZodString;
+        predicate: z.ZodString;
+        target: z.ZodString;
+        directed: z.ZodDefault<z.ZodBoolean>;
+        weight: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        attrs: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        source: string;
+        predicate: string;
+        target: string;
+        directed: boolean;
+        weight: number | null;
+        attrs: Record<string, unknown>;
+    }, {
+        source: string;
+        predicate: string;
+        target: string;
+        directed?: boolean | undefined;
+        weight?: number | null | undefined;
+        attrs?: Record<string, unknown> | undefined;
+    }>, "many">>;
+    facets: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    deprecatedIds: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    uid: string;
+    kind: string;
+    title: string;
+    body: string;
+    metadata: {
+        created: string | null;
+        updated: string | null;
+        version: number;
+    };
+    relations: {
+        source: string;
+        predicate: string;
+        target: string;
+        directed: boolean;
+        weight: number | null;
+        attrs: Record<string, unknown>;
+    }[];
+    facets: Record<string, Record<string, unknown>>;
+    deprecatedIds: string[];
+}, {
+    id: string;
+    kind: string;
+    title: string;
+    uid?: string | undefined;
+    body?: string | undefined;
+    metadata?: unknown;
+    relations?: {
+        source: string;
+        predicate: string;
+        target: string;
+        directed?: boolean | undefined;
+        weight?: number | null | undefined;
+        attrs?: Record<string, unknown> | undefined;
+    }[] | undefined;
+    facets?: Record<string, Record<string, unknown>> | undefined;
+    deprecatedIds?: string[] | undefined;
+}>;
+export type Node = z.infer<typeof NodeSchema>;
+export type NodeInput = z.input<typeof NodeSchema>;
+export declare function makeNode(input: NodeInput): Node;
+//# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,wBAAgB,MAAM,IAAI,MAAM,CAE/B;AAkBD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;EAI7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUrB,CAAC;AAEH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAC9C,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEnD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAqB/C"}

package/dist/node.js

@@ -0,0 +1,66 @@
+import { randomUUID } from "node:crypto";
+import { z } from "zod";
+import { IdError, ValidationError } from "./errors.js";
+import { NodeId } from "./ids.js";
+import { RelationSchema } from "./relations.js";
+export function newUid() {
+    return randomUUID().replace(/-/g, "");
+}
+const DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+const DAYS_IN_MONTH = [31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
+const dateStr = z
+    .string()
+    .regex(DATE_RE, "expected a YYYY-MM-DD date string")
+    .refine((s) => {
+    // Real-calendar validity via explicit arithmetic — full parity with Python's `date`
+    // (MINYEAR=1, rejects 2026-99-99 / 2026-02-30 / non-leap 02-29, accepts 0001-0099).
+    // Deliberately avoids JS `Date`, which maps years 0-99 onto 1900-1999.
+    const [y, m, d] = s.split("-").map(Number);
+    if (y < 1 || m < 1 || m > 12 || d < 1)
+        return false;
+    const leap = (y % 4 === 0 && y % 100 !== 0) || y % 400 === 0;
+    const maxDay = m === 2 && leap ? 29 : DAYS_IN_MONTH[m - 1];
+    return d <= maxDay;
+}, "not a valid calendar date");
+export const NodeMetadataSchema = z.object({
+    created: dateStr.nullable().default(null),
+    updated: dateStr.nullable().default(null),
+    version: z.number().int().default(1),
+});
+export const NodeSchema = z.object({
+    id: z.string(),
+    uid: z.string().default(() => newUid()),
+    kind: z.string(),
+    title: z.string(),
+    body: z.string().default(""),
+    metadata: z.preprocess((v) => v ?? {}, NodeMetadataSchema),
+    relations: z.array(RelationSchema).default([]),
+    facets: z.record(z.record(z.unknown())).default({}),
+    deprecatedIds: z.array(z.string()).default([]),
+});
+export function makeNode(input) {
+    let node;
+    try {
+        node = NodeSchema.parse(input);
+    }
+    catch (e) {
+        if (e instanceof z.ZodError) {
+            throw new ValidationError(e.issues.map((i) => i.message).join("; "));
+        }
+        throw e;
+    }
+    let parsed;
+    try {
+        parsed = NodeId.parse(node.id);
+    }
+    catch (e) {
+        if (e instanceof IdError)
+            throw new ValidationError(e.message);
+        throw e;
+    }
+    if (parsed.kind !== node.kind) {
+        throw new ValidationError(`id kind ${JSON.stringify(parsed.kind)} != kind field ${JSON.stringify(node.kind)}`);
+    }
+    return node;
+}
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

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

package/dist/ranking.d.ts

@@ -0,0 +1,7 @@
+/** Half-up rounding to 6 decimal places — the shared ranking/parity key. Used by both the
+ * full-text search index and the similarity index, so it lives here rather than in either
+ * (neither derived-index facet imports the other). Floor-based half-up is identical in
+ * TypeScript and Python (`Math.floor` / `math.floor` agree on negative operands), so it is
+ * correct over BM25 (non-negative) and cosine (`[-1, 1]`) scores alike. */
+export declare function scoreKey(score: number): number;
+//# sourceMappingURL=ranking.d.ts.map

package/dist/ranking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranking.d.ts","sourceRoot":"","sources":["../src/ranking.ts"],"names":[],"mappings":"AAAA;;;;2EAI2E;AAC3E,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE9C"}

package/dist/ranking.js

@@ -0,0 +1,9 @@
+/** Half-up rounding to 6 decimal places — the shared ranking/parity key. Used by both the
+ * full-text search index and the similarity index, so it lives here rather than in either
+ * (neither derived-index facet imports the other). Floor-based half-up is identical in
+ * TypeScript and Python (`Math.floor` / `math.floor` agree on negative operands), so it is
+ * correct over BM25 (non-negative) and cosine (`[-1, 1]`) scores alike. */
+export function scoreKey(score) {
+    return Math.floor(score * 1_000_000 + 0.5) / 1_000_000;
+}
+//# sourceMappingURL=ranking.js.map

package/dist/ranking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranking.js","sourceRoot":"","sources":["../src/ranking.ts"],"names":[],"mappings":"AAAA;;;;2EAI2E;AAC3E,MAAM,UAAU,QAAQ,CAAC,KAAa;IACpC,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,SAAS,GAAG,GAAG,CAAC,GAAG,SAAS,CAAC;AACzD,CAAC"}

package/dist/registry.d.ts

@@ -0,0 +1,36 @@
+import type { Node } from "./node.js";
+export type Invariant = (node: Node) => void;
+export interface ShapeSpec {
+    name: string;
+    requiredFacets?: Set<string>;
+    optionalFacets?: Set<string>;
+    invariants?: Invariant[];
+}
+export interface KindSpec {
+    name: string;
+    shape?: string;
+    requiredFacets?: Set<string>;
+    optionalFacets?: Set<string>;
+    invariants?: Invariant[];
+}
+/** One structured validation finding from `Registry.check` (never thrown). */
+export interface Violation {
+    readonly code: string;
+    readonly detail: string;
+    readonly message: string;
+}
+export declare class Registry {
+    private specs;
+    private shapes;
+    registerShape(spec: ShapeSpec): void;
+    isShape(name: string): boolean;
+    register(spec: KindSpec): void;
+    isRegistered(kind: string): boolean;
+    get(kind: string): KindSpec;
+    private compose;
+    validate(node: Node): void;
+    /** Collect ALL violations of `node` with machine-stable codes; never throws on
+     * content. Non-kernel exceptions from invariants are programmer bugs and propagate. */
+    check(node: Node): Violation[];
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGtC,MAAM,MAAM,SAAS,GAAG,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;AAE7C,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;CAC1B;AAED,8EAA8E;AAC9E,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,QAAQ;IACnB,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,MAAM,CAAgC;IAE9C,aAAa,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAOpC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI9B,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;IAY9B,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAInC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ;IAQ3B,OAAO,CAAC,OAAO;IAoBf,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAgB1B;2FACuF;IACvF,KAAK,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,EAAE;CA8C/B"}

package/dist/registry.js

@@ -0,0 +1,123 @@
+import { FacetError, InvariantError, UnknownKindError, ValidationError } from "./errors.js";
+import { compareCodepoints } from "./search.js";
+export class Registry {
+    specs = new Map();
+    shapes = new Map();
+    registerShape(spec) {
+        if (this.shapes.has(spec.name)) {
+            throw new ValidationError(`shape ${JSON.stringify(spec.name)} is already registered`);
+        }
+        this.shapes.set(spec.name, spec);
+    }
+    isShape(name) {
+        return this.shapes.has(name);
+    }
+    register(spec) {
+        if (this.specs.has(spec.name)) {
+            throw new ValidationError(`kind ${JSON.stringify(spec.name)} is already registered`);
+        }
+        if (spec.shape !== undefined && !this.shapes.has(spec.shape)) {
+            throw new UnknownKindError(`kind ${JSON.stringify(spec.name)} adopts unknown shape ${JSON.stringify(spec.shape)}`);
+        }
+        this.specs.set(spec.name, spec);
+    }
+    isRegistered(kind) {
+        return this.specs.has(kind);
+    }
+    get(kind) {
+        const spec = this.specs.get(kind);
+        if (spec === undefined) {
+            throw new UnknownKindError(`kind ${JSON.stringify(kind)} is not registered`);
+        }
+        return spec;
+    }
+    compose(spec, kind) {
+        const required = new Set(spec.requiredFacets ?? []);
+        const optional = new Set(spec.optionalFacets ?? []);
+        const invariants = [];
+        if (spec.shape !== undefined) {
+            const shape = this.shapes.get(spec.shape);
+            if (shape === undefined) {
+                throw new UnknownKindError(`kind ${JSON.stringify(kind)} adopts unknown shape ${JSON.stringify(spec.shape)}`);
+            }
+            for (const f of shape.requiredFacets ?? [])
+                required.add(f);
+            for (const f of shape.optionalFacets ?? [])
+                optional.add(f);
+            for (const inv of shape.invariants ?? [])
+                invariants.push(inv);
+        }
+        for (const inv of spec.invariants ?? [])
+            invariants.push(inv);
+        return { required, optional, invariants };
+    }
+    validate(node) {
+        const spec = this.get(node.kind);
+        const { required, optional, invariants } = this.compose(spec, node.kind);
+        const present = new Set(Object.keys(node.facets));
+        const missing = [...required].filter((f) => !present.has(f)).sort();
+        if (missing.length > 0) {
+            throw new FacetError(`${node.id}: missing required facets ${JSON.stringify(missing)}`);
+        }
+        const allowed = new Set([...required, ...optional]);
+        const unexpected = [...present].filter((f) => !allowed.has(f)).sort();
+        if (unexpected.length > 0) {
+            throw new FacetError(`${node.id}: unexpected facets ${JSON.stringify(unexpected)}`);
+        }
+        for (const invariant of invariants)
+            invariant(node);
+    }
+    /** Collect ALL violations of `node` with machine-stable codes; never throws on
+     * content. Non-kernel exceptions from invariants are programmer bugs and propagate. */
+    check(node) {
+        const spec = this.specs.get(node.kind);
+        if (spec === undefined) {
+            return [
+                {
+                    code: "unknown-kind",
+                    detail: node.kind,
+                    message: `${node.id}: kind ${JSON.stringify(node.kind)} is not registered`,
+                },
+            ];
+        }
+        const { required, optional, invariants } = this.compose(spec, node.kind);
+        const present = new Set(Object.keys(node.facets));
+        const violations = [];
+        for (const name of [...required].filter((f) => !present.has(f)).sort(compareCodepoints)) {
+            violations.push({
+                code: "facet-missing",
+                detail: name,
+                message: `${node.id}: missing required facet ${JSON.stringify(name)}`,
+            });
+        }
+        const allowed = new Set([...required, ...optional]);
+        for (const name of [...present].filter((f) => !allowed.has(f)).sort(compareCodepoints)) {
+            violations.push({
+                code: "facet-unexpected",
+                detail: name,
+                message: `${node.id}: unexpected facet ${JSON.stringify(name)}`,
+            });
+        }
+        // Invariants presuppose their facets; running them anyway would duplicate reports.
+        if (violations.length > 0)
+            return violations;
+        for (const invariant of invariants) {
+            try {
+                invariant(node);
+            }
+            catch (exc) {
+                if (exc instanceof FacetError) {
+                    violations.push({ code: "facet-invalid", detail: "", message: exc.message });
+                }
+                else if (exc instanceof InvariantError) {
+                    violations.push({ code: "invariant-violated", detail: "", message: exc.message });
+                }
+                else {
+                    throw exc;
+                }
+            }
+        }
+        return violations;
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE5F,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AA0BhD,MAAM,OAAO,QAAQ;IACX,KAAK,GAAG,IAAI,GAAG,EAAoB,CAAC;IACpC,MAAM,GAAG,IAAI,GAAG,EAAqB,CAAC;IAE9C,aAAa,CAAC,IAAe;QAC3B,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,eAAe,CAAC,SAAS,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QACxF,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,OAAO,CAAC,IAAY;QAClB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,QAAQ,CAAC,IAAc;QACrB,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,eAAe,CAAC,QAAQ,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QACvF,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7D,MAAM,IAAI,gBAAgB,CACxB,QAAQ,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,yBAAyB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CACvF,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,YAAY,CAAC,IAAY;QACvB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,GAAG,CAAC,IAAY;QACd,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM,IAAI,gBAAgB,CAAC,QAAQ,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QAC/E,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,OAAO,CACb,IAAc,EACd,IAAY;QAEZ,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC;QACpD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC;QACpD,MAAM,UAAU,GAAgB,EAAE,CAAC;QACnC,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,MAAM,IAAI,gBAAgB,CAAC,QAAQ,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,yBAAyB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAChH,CAAC;YACD,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,cAAc,IAAI,EAAE;gBAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAC5D,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,cAAc,IAAI,EAAE;gBAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAC5D,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,UAAU,IAAI,EAAE;gBAAE,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjE,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,UAAU,IAAI,EAAE;YAAE,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC9D,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;IAC5C,CAAC;IAED,QAAQ,CAAC,IAAU;QACjB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACzE,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QAClD,MAAM,OAAO,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACpE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,UAAU,CAAC,GAAG,IAAI,CAAC,EAAE,6BAA6B,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACzF,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,QAAQ,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC;QACpD,MAAM,UAAU,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACtE,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,UAAU,CAAC,GAAG,IAAI,CAAC,EAAE,uBAAuB,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QACtF,CAAC;QACD,KAAK,MAAM,SAAS,IAAI,UAAU;YAAE,SAAS,CAAC,IAAI,CAAC,CAAC;IACtD,CAAC;IAED;2FACuF;IACvF,KAAK,CAAC,IAAU;QACd,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO;gBACL;oBACE,IAAI,EAAE,cAAc;oBACpB,MAAM,EAAE,IAAI,CAAC,IAAI;oBACjB,OAAO,EAAE,GAAG,IAAI,CAAC,EAAE,UAAU,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,oBAAoB;iBAC3E;aACF,CAAC;QACJ,CAAC;QACD,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACzE,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QAClD,MAAM,UAAU,GAAgB,EAAE,CAAC;QACnC,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,EAAE,CAAC;YACxF,UAAU,CAAC,IAAI,CAAC;gBACd,IAAI,EAAE,eAAe;gBACrB,MAAM,EAAE,IAAI;gBACZ,OAAO,EAAE,GAAG,IAAI,CAAC,EAAE,4BAA4B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE;aACtE,CAAC,CAAC;QACL,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,QAAQ,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC;QACpD,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,EAAE,CAAC;YACvF,UAAU,CAAC,IAAI,CAAC;gBACd,IAAI,EAAE,kBAAkB;gBACxB,MAAM,EAAE,IAAI;gBACZ,OAAO,EAAE,GAAG,IAAI,CAAC,EAAE,sBAAsB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE;aAChE,CAAC,CAAC;QACL,CAAC;QACD,mFAAmF;QACnF,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,UAAU,CAAC;QAC7C,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,IAAI,CAAC;gBACH,SAAS,CAAC,IAAI,CAAC,CAAC;YAClB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,GAAG,YAAY,UAAU,EAAE,CAAC;oBAC9B,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC/E,CAAC;qBAAM,IAAI,GAAG,YAAY,cAAc,EAAE,CAAC;oBACzC,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;gBACpF,CAAC;qBAAM,CAAC;oBACN,MAAM,GAAG,CAAC;gBACZ,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;CACF"}

package/dist/relations.d.ts

@@ -0,0 +1,30 @@
+import { z } from "zod";
+export declare const RELATES_TO = "relatesTo";
+export declare const RelationSchema: z.ZodObject<{
+    source: z.ZodString;
+    predicate: z.ZodString;
+    target: z.ZodString;
+    directed: z.ZodDefault<z.ZodBoolean>;
+    weight: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    attrs: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    source: string;
+    predicate: string;
+    target: string;
+    directed: boolean;
+    weight: number | null;
+    attrs: Record<string, unknown>;
+}, {
+    source: string;
+    predicate: string;
+    target: string;
+    directed?: boolean | undefined;
+    weight?: number | null | undefined;
+    attrs?: Record<string, unknown> | undefined;
+}>;
+export type Relation = z.infer<typeof RelationSchema>;
+export declare function fromSerialized(data: Record<string, unknown>, containerId: string): Relation;
+export declare function toSerialized(rel: Relation, containerId: string): Record<string, unknown>;
+export declare function relatesTo(source: string, target: string): Relation;
+export declare function tagToRelation(source: string, tag: string, aliasMap: Record<string, string>): Relation;
+//# sourceMappingURL=relations.d.ts.map

package/dist/relations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relations.d.ts","sourceRoot":"","sources":["../src/relations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,UAAU,cAAc,CAAC;AAEtC,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;EAOzB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAKtD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,EAAE,MAAM,GAAG,QAAQ,CAG3F;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASxF;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,CAElE;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,QAAQ,CAOrG"}