elementary-assertions 1.0.1

package/src/core/tokens.js

@@ -0,0 +1,53 @@
+const { deepCloneJson } = require('./determinism');
+
+function buildTokenIndex(seed) {
+  if (!Array.isArray(seed.tokens) || seed.tokens.length === 0) throw new Error('relations seed missing tokens');
+  const byId = new Map();
+  for (const t of seed.tokens) {
+    if (!t || typeof t.id !== 'string') throw new Error('token missing id');
+    if (typeof t.segment_id !== 'string') throw new Error(`token ${t.id} missing segment_id`);
+    if (!t.span || typeof t.span.start !== 'number' || typeof t.span.end !== 'number') {
+      throw new Error(`token ${t.id} missing span`);
+    }
+    if (typeof t.i !== 'number') throw new Error(`token ${t.id} missing i`);
+    if (!t.pos || typeof t.pos.tag !== 'string') throw new Error(`token ${t.id} missing pos.tag`);
+    byId.set(t.id, t);
+  }
+  return byId;
+}
+
+
+function getTokenWikipediaEvidence(token) {
+  if (!token || !token.lexicon || typeof token.lexicon !== 'object') return null;
+  const ev = token.lexicon.wikipedia_title_index;
+  if (!ev || typeof ev !== 'object') return null;
+  return deepCloneJson(ev);
+}
+
+function buildTokenWikiById(relationsSeed) {
+  const out = new Map();
+  const tokens = Array.isArray(relationsSeed && relationsSeed.tokens) ? relationsSeed.tokens : [];
+  for (const token of tokens) {
+    if (!token || typeof token.id !== 'string') continue;
+    const ev = getTokenWikipediaEvidence(token);
+    if (!ev) continue;
+    out.set(token.id, ev);
+  }
+  return out;
+}
+
+function getTokenMetadataProjection(token) {
+  const out = {};
+  if (token && typeof token.normalized === 'string') out.normalized = token.normalized;
+  if (token && token.flags && typeof token.flags === 'object') out.flags = deepCloneJson(token.flags);
+  if (token && token.joiner && typeof token.joiner === 'object') out.joiner = deepCloneJson(token.joiner);
+  return out;
+}
+
+
+module.exports = {
+  buildTokenIndex,
+  getTokenWikipediaEvidence,
+  buildTokenWikiById,
+  getTokenMetadataProjection,
+};

package/src/core/upstream.js

@@ -0,0 +1,31 @@
+function annotationHasSource(annotation, name) {
+  return Array.isArray(annotation && annotation.sources) && annotation.sources.some((s) => s && s.name === name);
+}
+
+function collectStep11Relations(relationsSeed, tokenById) {
+  const out = [];
+  const annotations = Array.isArray(relationsSeed && relationsSeed.annotations) ? relationsSeed.annotations : [];
+  for (const annotation of annotations) {
+    if (!annotation || annotation.kind !== "dependency" || annotation.status !== "accepted") continue;
+    if (!annotationHasSource(annotation, "relation-extraction")) continue;
+    if (!annotation.head || typeof annotation.head.id !== "string" || !tokenById.has(annotation.head.id)) continue;
+    if (!annotation.dep || typeof annotation.dep.id !== "string" || !tokenById.has(annotation.dep.id)) continue;
+    out.push({
+      id: typeof annotation.id === "string" ? annotation.id : "",
+      label: String(annotation.label || ""),
+      head_token_id: annotation.head.id,
+      dep_token_id: annotation.dep.id,
+      evidence:
+        (Array.isArray(annotation.sources)
+          ? annotation.sources.find((src) => src && src.name === "relation-extraction")
+          : null
+        )?.evidence || {},
+    });
+  }
+  return out;
+}
+
+module.exports = {
+  annotationHasSource,
+  collectStep11Relations,
+};

package/src/index.js

@@ -0,0 +1,6 @@
+const { runFromRelations, runElementaryAssertions } = require("./run");
+
+module.exports = {
+  runFromRelations,
+  runElementaryAssertions,
+};

package/src/render/index.js

@@ -0,0 +1,5 @@
+const { renderElementaryAssertions } = require("./render");
+
+module.exports = {
+  renderElementaryAssertions,
+};

package/src/render/layouts/compact.js

@@ -0,0 +1,10 @@
+function renderCompact(doc) {
+  const lines = [];
+  for (const a of doc.assertions || []) {
+    const pred = (a.predicate && a.predicate.mention_id) || "<pred>";
+    lines.push(`${a.id}: ${pred}`);
+  }
+  return lines.join("\n") + (lines.length > 0 ? "\n" : "");
+}
+
+module.exports = { renderCompact };

package/src/render/layouts/meaning.js

@@ -0,0 +1,7 @@
+const { renderCompact } = require("./compact");
+
+function renderMeaning(doc) {
+  return renderCompact(doc);
+}
+
+module.exports = { renderMeaning };

package/src/render/layouts/readable.js

@@ -0,0 +1,7 @@
+const { renderCompact } = require("./compact");
+
+function renderReadable(doc) {
+  return renderCompact(doc);
+}
+
+module.exports = { renderReadable };

package/src/render/layouts/table.js

@@ -0,0 +1,7 @@
+const { renderCompact } = require("./compact");
+
+function renderTable(doc) {
+  return renderCompact(doc);
+}
+
+module.exports = { renderTable };