@robosystems/report-components 0.1.0 → 0.1.2

package/README.md

@@ -2,7 +2,7 @@
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-A source-agnostic React library for rendering XBRL-grade financial statements. The same components render financial statements from **any** source — a live general ledger, a graph database (entity graph or the SEC repository), or a static `holon.trig` file — because the render logic is source-independent. The only thing that varies is a thin **data adapter** that turns its source into a normalized report model; the components handle the presentation-order walk, calculation-subtotal footing, and Information-Block table projection identically for every adapter.
+A source-agnostic React library for rendering XBRL-grade financial statements. The same components render financial statements from **any** source — a static `holon.jsonld` file (a report's canonical dataset-form holon), a live general ledger, or a graph database (entity graph or the SEC repository) — because the render logic is source-independent. The only thing that varies is a thin **data adapter** that turns its source into a normalized report model; the components handle the presentation-order walk, calculation-subtotal footing, and Information-Block table projection identically for every adapter.
 
 React and react-dom are peer dependencies, and the components are plain React (no framework-specific imports) so the same package feeds a Next.js app or a lightweight Vite app.
 
@@ -14,17 +14,17 @@ npm install @robosystems/report-components
 
 ## Usage
 
-Render a statement by feeding a component a normalized report model produced by an adapter. The package ships two read-only reference adapters (a `holon.trig` file adapter via N3.js, and a cypher/GraphQL adapter) under `@robosystems/report-components/adapters`:
+Render a statement by feeding `ReportView` a normalized report model produced by an adapter. The package ships read-only reference adapters under `@robosystems/report-components/adapters`: `parseJsonld` (the canonical `holon.jsonld`, via the `jsonld` processor) and `cypherAdapter` (a live graph over GraphQL).
 
 ```tsx
-import { FinancialStatement } from '@robosystems/report-components'
-import { createTrigFileAdapter } from '@robosystems/report-components/adapters'
+import { ReportView } from '@robosystems/report-components'
+import { parseJsonld } from '@robosystems/report-components/adapters'
 
-const adapter = createTrigFileAdapter({ source: trigText })
-const report = await adapter.load()
+// `holonText` is a report's dataset-form holon.jsonld (scene / boundary / projection)
+const report = await parseJsonld(holonText)
 
 export function Report() {
-  return <FinancialStatement report={report} />
+  return <ReportView report={report} />
 }
 ```
 

package/dist/adapters/index.d.ts

@@ -1,5 +1,2 @@
-export { cypherAdapter } from './cypher';
-export type { CypherAdapterConfig } from './cypher';
-export { parseTrig, trigFileAdapter } from './trig';
-export type { ReportAdapter } from './types';
-//# sourceMappingURL=index.d.ts.map
+export { b as CypherAdapterConfig, R as ReportAdapter, i as cypherAdapter, j as jsonldFileAdapter, p as parseJsonld, k as parseStore, l as parseTrig, t as trigFileAdapter } from '../index-DlTmV_mJ.js';
+import 'n3';

package/dist/adapters/index.js

@@ -1,3 +1,3 @@
-export { cypherAdapter } from './cypher';
-export { parseTrig, trigFileAdapter } from './trig';
+export { cypherAdapter, jsonldFileAdapter, parseJsonld, parseStore, parseTrig, trigFileAdapter } from '../chunk-FNRQJVAH.js';
+//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAA"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/chunk-FNRQJVAH.js

@@ -0,0 +1,284 @@
+import { DataFactory, Parser, Store } from 'n3';
+import jsonld from 'jsonld';
+
+// src/constants.ts
+var NS = {
+  rdf: "http://www.w3.org/1999/02/22-rdf-syntax-ns#",
+  rs: "https://robosystems.ai/vocab/",
+  rsgaap: "https://robosystems.ai/taxonomy/rs-gaap/v1/",
+  skos: "http://www.w3.org/2004/02/skos/core#",
+  xlink: "http://www.w3.org/1999/xlink#",
+  xbrli: "http://www.xbrl.org/2003/instance#",
+  link: "http://www.xbrl.org/2003/linkbase#",
+  iso4217: "http://www.xbrl.org/2003/iso4217#"
+};
+var IRI = {
+  type: NS.rdf + "type",
+  // rs: classes
+  Report: NS.rs + "Report",
+  Fact: NS.rs + "Fact",
+  InformationBlock: NS.rs + "InformationBlock",
+  Structure: NS.rs + "Structure",
+  Association: NS.rs + "Association",
+  Element: NS.rs + "Element",
+  Period: NS.rs + "Period",
+  Unit: NS.rs + "Unit",
+  Entity: NS.rs + "Entity",
+  // rs: predicates
+  element: NS.rs + "element",
+  period: NS.rs + "period",
+  unit: NS.rs + "unit",
+  entity: NS.rs + "entity",
+  factSet: NS.rs + "factSet",
+  numericValue: NS.rs + "numericValue",
+  decimals: NS.rs + "decimals",
+  blockType: NS.rs + "blockType",
+  associationType: NS.rs + "associationType",
+  hasAssociation: NS.rs + "hasAssociation",
+  roleUri: NS.rs + "roleUri",
+  structureName: NS.rs + "structureName",
+  abstract: NS.rs + "abstract",
+  monetary: NS.rs + "monetary",
+  legalName: NS.rs + "legalName",
+  country: NS.rs + "country",
+  // skos:
+  prefLabel: NS.skos + "prefLabel",
+  // xlink:
+  from: NS.xlink + "from",
+  to: NS.xlink + "to",
+  role: NS.xlink + "role",
+  // xbrli:
+  instant: NS.xbrli + "instant",
+  startDate: NS.xbrli + "startDate",
+  endDate: NS.xbrli + "endDate",
+  periodType: NS.xbrli + "periodType",
+  balance: NS.xbrli + "balance",
+  measure: NS.xbrli + "measure",
+  // link:
+  order: NS.link + "order",
+  weight: NS.link + "weight"
+};
+var PREFIXES = [
+  ["rs-gaap", NS.rsgaap],
+  ["disclosures", "https://robosystems.ai/taxonomy/rs-gaap/disclosures/v1/"],
+  ["us-gaap", "http://fasb.org/us-gaap/"],
+  ["dei", "http://xbrl.sec.gov/dei/"],
+  ["rs", NS.rs],
+  ["skos", NS.skos],
+  ["xbrli", NS.xbrli],
+  ["xlink", NS.xlink],
+  ["link", NS.link],
+  ["iso4217", NS.iso4217]
+];
+function qname(iri) {
+  for (const [prefix, ns] of PREFIXES) {
+    if (iri.startsWith(ns)) {
+      return `${prefix}:${iri.slice(ns.length)}`;
+    }
+  }
+  const slash = iri.lastIndexOf("/");
+  const hash = iri.lastIndexOf("#");
+  return iri.slice(Math.max(slash, hash) + 1);
+}
+function humanize(iri) {
+  const local = qname(iri).split(":").pop() ?? iri;
+  return local.replace(/(?<=[a-z0-9])(?=[A-Z])|(?<=[A-Z])(?=[A-Z][a-z])/g, " ");
+}
+var BLOCK_ORDER = {
+  balance_sheet: 0,
+  income_statement: 1,
+  cash_flow_statement: 2,
+  equity_statement: 3
+};
+var BLOCK_TITLES = {
+  balance_sheet: "Balance Sheet",
+  income_statement: "Income Statement",
+  cash_flow_statement: "Cash Flow Statement",
+  equity_statement: "Statement of Changes in Equity"
+};
+
+// src/adapters/cypher.ts
+function cypherAdapter(config) {
+  return {
+    source: `cypher:${config.graphId}/${config.reportId}`,
+    load: async () => {
+      throw new Error(
+        "The cypher adapter is not implemented yet (phase 2 / Mode B \u2014 live SEC graph)."
+      );
+    }
+  };
+}
+var { namedNode } = DataFactory;
+function makeReaders(store) {
+  const objects = (s, p) => store.getObjects(namedNode(s), namedNode(p), null);
+  const firstValue = (s, p) => {
+    const os = objects(s, p);
+    return os.length ? os[0].value : null;
+  };
+  const subjectsOfType = (type) => store.getSubjects(namedNode(IRI.type), namedNode(type), null).map((t) => t.value);
+  return { objects, firstValue, subjectsOfType };
+}
+function toNumber(raw) {
+  if (raw === null || raw === "") return null;
+  const n = Number(raw);
+  return Number.isNaN(n) ? null : n;
+}
+function parseStore(store) {
+  const { objects, firstValue, subjectsOfType } = makeReaders(store);
+  const elements = {};
+  for (const id of subjectsOfType(IRI.Element)) {
+    const balance = firstValue(id, IRI.balance);
+    const periodType = firstValue(id, IRI.periodType);
+    elements[id] = {
+      id,
+      qname: qname(id),
+      label: firstValue(id, IRI.prefLabel) ?? humanize(id),
+      balance: balance === "debit" || balance === "credit" ? balance : null,
+      periodType: periodType === "instant" || periodType === "duration" ? periodType : null,
+      abstract: firstValue(id, IRI.abstract) === "true",
+      monetary: firstValue(id, IRI.monetary) === "true"
+    };
+  }
+  const periods = {};
+  for (const id of subjectsOfType(IRI.Period)) {
+    const declared = firstValue(id, IRI.periodType);
+    const instant = firstValue(id, IRI.instant);
+    const startDate = firstValue(id, IRI.startDate);
+    const endDate = firstValue(id, IRI.endDate);
+    const type = declared === "instant" ? "instant" : declared === "duration" ? "duration" : instant ? "instant" : "duration";
+    const end = (type === "instant" ? instant : endDate) ?? instant ?? endDate ?? "";
+    periods[id] = { id, type, instant, startDate, endDate, end };
+  }
+  const units = {};
+  for (const id of subjectsOfType(IRI.Unit)) {
+    const measureTerm = objects(id, IRI.measure)[0];
+    const measure = measureTerm ? qname(measureTerm.value) : "unknown";
+    units[id] = {
+      id,
+      measure,
+      label: measure.includes(":") ? measure.split(":").pop() : measure
+    };
+  }
+  let entity = null;
+  const entityIds = subjectsOfType(IRI.Entity);
+  if (entityIds.length) {
+    const id = entityIds[0];
+    entity = {
+      id,
+      name: firstValue(id, IRI.prefLabel) ?? firstValue(id, IRI.legalName) ?? "Entity",
+      legalName: firstValue(id, IRI.legalName),
+      country: firstValue(id, IRI.country)
+    };
+  }
+  const facts = [];
+  for (const id of subjectsOfType(IRI.Fact)) {
+    facts.push({
+      id,
+      element: firstValue(id, IRI.element) ?? "",
+      period: firstValue(id, IRI.period) ?? "",
+      unit: firstValue(id, IRI.unit),
+      entity: firstValue(id, IRI.entity),
+      factSet: firstValue(id, IRI.factSet),
+      value: toNumber(firstValue(id, IRI.numericValue)),
+      decimals: firstValue(id, IRI.decimals)
+    });
+  }
+  const informationBlocks = [];
+  for (const id of subjectsOfType(IRI.InformationBlock)) {
+    informationBlocks.push({
+      id,
+      blockType: firstValue(id, IRI.blockType) ?? "",
+      factSet: firstValue(id, IRI.factSet),
+      label: firstValue(id, IRI.prefLabel)
+    });
+  }
+  const structures = [];
+  const assocStructure = /* @__PURE__ */ new Map();
+  for (const id of subjectsOfType(IRI.Structure)) {
+    structures.push({
+      id,
+      blockType: firstValue(id, IRI.blockType) ?? "",
+      roleUri: firstValue(id, IRI.roleUri),
+      structureName: firstValue(id, IRI.structureName)
+    });
+    for (const assoc of objects(id, IRI.hasAssociation)) {
+      assocStructure.set(assoc.value, id);
+    }
+  }
+  const calcAssociations = [];
+  const presAssociations = [];
+  for (const id of subjectsOfType(IRI.Association)) {
+    const parent = firstValue(id, IRI.from);
+    const child = firstValue(id, IRI.to);
+    if (!parent || !child) continue;
+    const type = firstValue(id, IRI.associationType);
+    const order = toNumber(firstValue(id, IRI.order)) ?? 0;
+    const role = firstValue(id, IRI.role);
+    const structure = assocStructure.get(id) ?? null;
+    if (type === "calculation") {
+      calcAssociations.push({
+        parent,
+        child,
+        weight: toNumber(firstValue(id, IRI.weight)) ?? 1,
+        order,
+        role,
+        structure
+      });
+    } else if (type === "presentation") {
+      presAssociations.push({ parent, child, order, role, structure });
+    }
+  }
+  let reportIri = null;
+  for (const graph of store.getGraphs(null, null, null)) {
+    const hash = graph.value.indexOf("#");
+    if (hash > 0) {
+      reportIri = graph.value.slice(0, hash);
+      break;
+    }
+  }
+  if (!reportIri) {
+    const reports = subjectsOfType(IRI.Report);
+    reportIri = reports.length ? reports[0] : null;
+  }
+  const reportId = reportIri ? reportIri.split("/").pop() ?? null : null;
+  return {
+    reportId,
+    reportIri,
+    entity,
+    informationBlocks,
+    structures,
+    facts,
+    elements,
+    periods,
+    units,
+    calcAssociations,
+    presAssociations
+  };
+}
+function parseTrig(trig) {
+  const parser = new Parser({ format: "application/trig" });
+  const store = new Store(parser.parse(trig));
+  return parseStore(store);
+}
+function trigFileAdapter(trig, source = "holon.trig") {
+  return {
+    source,
+    load: async () => parseTrig(trig)
+  };
+}
+async function parseJsonld(doc) {
+  const json = typeof doc === "string" ? JSON.parse(doc) : doc;
+  const nquads = await jsonld.toRDF(json, { format: "application/n-quads" });
+  const store = new Store(new Parser({ format: "application/n-quads" }).parse(nquads));
+  return parseStore(store);
+}
+function jsonldFileAdapter(doc, source = "holon.jsonld") {
+  return {
+    source,
+    load: () => parseJsonld(doc)
+  };
+}
+
+export { BLOCK_ORDER, BLOCK_TITLES, NS, cypherAdapter, humanize, jsonldFileAdapter, parseJsonld, parseStore, parseTrig, qname, trigFileAdapter };
+//# sourceMappingURL=chunk-FNRQJVAH.js.map
+//# sourceMappingURL=chunk-FNRQJVAH.js.map

package/dist/chunk-FNRQJVAH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/constants.ts","../src/adapters/cypher.ts","../src/adapters/trig.ts","../src/adapters/jsonld.ts"],"names":["Store","Parser"],"mappings":"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","file":"chunk-FNRQJVAH.js","sourcesContent":["/**\n * RDF vocabulary and display helpers shared across adapters and projection.\n *\n * A `holon.trig` mixes several vocabularies: `rs:` for structure, `skos:` for\n * human labels, and the XBRL family (`xlink:` / `xbrli:` / `link:`) for the\n * networks. These constants are the single source of truth for the full IRIs.\n */\n\nexport const NS = {\n  rdf: 'http://www.w3.org/1999/02/22-rdf-syntax-ns#',\n  rs: 'https://robosystems.ai/vocab/',\n  rsgaap: 'https://robosystems.ai/taxonomy/rs-gaap/v1/',\n  skos: 'http://www.w3.org/2004/02/skos/core#',\n  xlink: 'http://www.w3.org/1999/xlink#',\n  xbrli: 'http://www.xbrl.org/2003/instance#',\n  link: 'http://www.xbrl.org/2003/linkbase#',\n  iso4217: 'http://www.xbrl.org/2003/iso4217#',\n} as const\n\n/** Frequently-referenced full IRIs, pre-concatenated for terseness. */\nexport const IRI = {\n  type: NS.rdf + 'type',\n  // rs: classes\n  Report: NS.rs + 'Report',\n  Fact: NS.rs + 'Fact',\n  InformationBlock: NS.rs + 'InformationBlock',\n  Structure: NS.rs + 'Structure',\n  Association: NS.rs + 'Association',\n  Element: NS.rs + 'Element',\n  Period: NS.rs + 'Period',\n  Unit: NS.rs + 'Unit',\n  Entity: NS.rs + 'Entity',\n  // rs: predicates\n  element: NS.rs + 'element',\n  period: NS.rs + 'period',\n  unit: NS.rs + 'unit',\n  entity: NS.rs + 'entity',\n  factSet: NS.rs + 'factSet',\n  numericValue: NS.rs + 'numericValue',\n  decimals: NS.rs + 'decimals',\n  blockType: NS.rs + 'blockType',\n  associationType: NS.rs + 'associationType',\n  hasAssociation: NS.rs + 'hasAssociation',\n  roleUri: NS.rs + 'roleUri',\n  structureName: NS.rs + 'structureName',\n  abstract: NS.rs + 'abstract',\n  monetary: NS.rs + 'monetary',\n  legalName: NS.rs + 'legalName',\n  country: NS.rs + 'country',\n  // skos:\n  prefLabel: NS.skos + 'prefLabel',\n  // xlink:\n  from: NS.xlink + 'from',\n  to: NS.xlink + 'to',\n  role: NS.xlink + 'role',\n  // xbrli:\n  instant: NS.xbrli + 'instant',\n  startDate: NS.xbrli + 'startDate',\n  endDate: NS.xbrli + 'endDate',\n  periodType: NS.xbrli + 'periodType',\n  balance: NS.xbrli + 'balance',\n  measure: NS.xbrli + 'measure',\n  // link:\n  order: NS.link + 'order',\n  weight: NS.link + 'weight',\n} as const\n\n/**\n * Prefixes for compacting concept IRIs to `prefix:Local`. Order matters — the\n * most specific namespace must come first so `rs-gaap:` wins over `rs:`.\n */\nconst PREFIXES: ReadonlyArray<readonly [string, string]> = [\n  ['rs-gaap', NS.rsgaap],\n  ['disclosures', 'https://robosystems.ai/taxonomy/rs-gaap/disclosures/v1/'],\n  ['us-gaap', 'http://fasb.org/us-gaap/'],\n  ['dei', 'http://xbrl.sec.gov/dei/'],\n  ['rs', NS.rs],\n  ['skos', NS.skos],\n  ['xbrli', NS.xbrli],\n  ['xlink', NS.xlink],\n  ['link', NS.link],\n  ['iso4217', NS.iso4217],\n]\n\n/** Compact a concept IRI to `prefix:Local` (e.g. `rs-gaap:Assets`). */\nexport function qname(iri: string): string {\n  for (const [prefix, ns] of PREFIXES) {\n    if (iri.startsWith(ns)) {\n      return `${prefix}:${iri.slice(ns.length)}`\n    }\n  }\n  const slash = iri.lastIndexOf('/')\n  const hash = iri.lastIndexOf('#')\n  return iri.slice(Math.max(slash, hash) + 1)\n}\n\n/**\n * Readable concept name from a local name when no `skos:prefLabel` is present —\n * splits CamelCase into words (`AssetsCurrent` → `Assets Current`). A graceful\n * fallback for bundles that predate label emit.\n */\nexport function humanize(iri: string): string {\n  const local = qname(iri).split(':').pop() ?? iri\n  return local.replace(/(?<=[a-z0-9])(?=[A-Z])|(?<=[A-Z])(?=[A-Z][a-z])/g, ' ')\n}\n\n/** Stable display order for the canonical statement blocks; others fall after. */\nexport const BLOCK_ORDER: Record<string, number> = {\n  balance_sheet: 0,\n  income_statement: 1,\n  cash_flow_statement: 2,\n  equity_statement: 3,\n}\n\n/** Friendly section headings keyed by block type. */\nexport const BLOCK_TITLES: Record<string, string> = {\n  balance_sheet: 'Balance Sheet',\n  income_statement: 'Income Statement',\n  cash_flow_statement: 'Cash Flow Statement',\n  equity_statement: 'Statement of Changes in Equity',\n}\n","/**\n * The cypher / GraphQL adapter — a live graph database (an entity graph **or**\n * the SEC repository) read read-only with an API key. One adapter for both:\n * only the endpoint / `graphId` differ.\n *\n * Phase 2 (Mode B). Stubbed for now so the seam and the `./adapters` export\n * surface are in place; the holon-viewer's SEC mode will drive its build-out.\n */\nimport type { ReportAdapter } from './types'\n\nexport interface CypherAdapterConfig {\n  /** GraphQL / cypher endpoint base URL. */\n  endpoint: string\n  /** User-supplied API key (sent client-side; never app-managed). */\n  apiKey: string\n  /** Target graph — an entity graph id or the SEC repository id. */\n  graphId: string\n  /** The report to materialize. */\n  reportId: string\n}\n\nexport function cypherAdapter(config: CypherAdapterConfig): ReportAdapter {\n  return {\n    source: `cypher:${config.graphId}/${config.reportId}`,\n    load: async () => {\n      throw new Error(\n        'The cypher adapter is not implemented yet (phase 2 / Mode B — live SEC graph).'\n      )\n    },\n  }\n}\n","/**\n * The `holon.trig` file adapter — offline, no backend, no auth.\n *\n * Parses TriG (three named graphs: `#scene`, `#boundary`, `#projection`) with\n * N3.js into a quad store, then traverses the store to emit a `NormalizedReport`.\n * The three graphs are queried as a union (graph = `null`) — exactly the join\n * the DataBook converter does on the flat graph. No SPARQL engine is required;\n * only store traversal.\n */\nimport { DataFactory, Parser, Store } from 'n3'\nimport { IRI, humanize, qname } from '../constants'\nimport type {\n  CalcAssociation,\n  ElementInfo,\n  EntityInfo,\n  Fact,\n  InformationBlock,\n  NormalizedReport,\n  PeriodInfo,\n  PeriodType,\n  PresAssociation,\n  StructureInfo,\n  UnitInfo,\n} from '../model'\nimport type { ReportAdapter } from './types'\n\nconst { namedNode } = DataFactory\n\nfunction makeReaders(store: Store) {\n  const objects = (s: string, p: string) => store.getObjects(namedNode(s), namedNode(p), null)\n  const firstValue = (s: string, p: string): string | null => {\n    const os = objects(s, p)\n    return os.length ? os[0].value : null\n  }\n  const subjectsOfType = (type: string): string[] =>\n    store.getSubjects(namedNode(IRI.type), namedNode(type), null).map((t) => t.value)\n  return { objects, firstValue, subjectsOfType }\n}\n\nfunction toNumber(raw: string | null): number | null {\n  if (raw === null || raw === '') return null\n  const n = Number(raw)\n  return Number.isNaN(n) ? null : n\n}\n\n/**\n * Traverse a populated quad `Store` into the normalized report model.\n *\n * The store is read as a **union** across its graphs (`graph = null`) — the\n * scene/boundary/projection partition is a publication concern, not a rendering\n * one, so the join is identical whether the quads arrived from a TriG holon, a\n * dataset-form JSON-LD holon, or a flat graph. Shared by `parseTrig` and\n * `parseJsonld`; the only per-syntax code is how the store gets filled.\n */\nexport function parseStore(store: Store): NormalizedReport {\n  const { objects, firstValue, subjectsOfType } = makeReaders(store)\n\n  // ── Elements ──\n  const elements: Record<string, ElementInfo> = {}\n  for (const id of subjectsOfType(IRI.Element)) {\n    const balance = firstValue(id, IRI.balance)\n    const periodType = firstValue(id, IRI.periodType)\n    elements[id] = {\n      id,\n      qname: qname(id),\n      label: firstValue(id, IRI.prefLabel) ?? humanize(id),\n      balance: balance === 'debit' || balance === 'credit' ? balance : null,\n      periodType: periodType === 'instant' || periodType === 'duration' ? periodType : null,\n      abstract: firstValue(id, IRI.abstract) === 'true',\n      monetary: firstValue(id, IRI.monetary) === 'true',\n    }\n  }\n\n  // ── Periods ──\n  const periods: Record<string, PeriodInfo> = {}\n  for (const id of subjectsOfType(IRI.Period)) {\n    const declared = firstValue(id, IRI.periodType)\n    const instant = firstValue(id, IRI.instant)\n    const startDate = firstValue(id, IRI.startDate)\n    const endDate = firstValue(id, IRI.endDate)\n    const type: PeriodType =\n      declared === 'instant'\n        ? 'instant'\n        : declared === 'duration'\n          ? 'duration'\n          : instant\n            ? 'instant'\n            : 'duration'\n    const end = (type === 'instant' ? instant : endDate) ?? instant ?? endDate ?? ''\n    periods[id] = { id, type, instant, startDate, endDate, end }\n  }\n\n  // ── Units ──\n  const units: Record<string, UnitInfo> = {}\n  for (const id of subjectsOfType(IRI.Unit)) {\n    const measureTerm = objects(id, IRI.measure)[0]\n    const measure = measureTerm ? qname(measureTerm.value) : 'unknown'\n    units[id] = {\n      id,\n      measure,\n      label: measure.includes(':') ? (measure.split(':').pop() as string) : measure,\n    }\n  }\n\n  // ── Entity ──\n  let entity: EntityInfo | null = null\n  const entityIds = subjectsOfType(IRI.Entity)\n  if (entityIds.length) {\n    const id = entityIds[0]\n    entity = {\n      id,\n      name: firstValue(id, IRI.prefLabel) ?? firstValue(id, IRI.legalName) ?? 'Entity',\n      legalName: firstValue(id, IRI.legalName),\n      country: firstValue(id, IRI.country),\n    }\n  }\n\n  // ── Facts ──\n  const facts: Fact[] = []\n  for (const id of subjectsOfType(IRI.Fact)) {\n    facts.push({\n      id,\n      element: firstValue(id, IRI.element) ?? '',\n      period: firstValue(id, IRI.period) ?? '',\n      unit: firstValue(id, IRI.unit),\n      entity: firstValue(id, IRI.entity),\n      factSet: firstValue(id, IRI.factSet),\n      value: toNumber(firstValue(id, IRI.numericValue)),\n      decimals: firstValue(id, IRI.decimals),\n    })\n  }\n\n  // ── Information Blocks ──\n  const informationBlocks: InformationBlock[] = []\n  for (const id of subjectsOfType(IRI.InformationBlock)) {\n    informationBlocks.push({\n      id,\n      blockType: firstValue(id, IRI.blockType) ?? '',\n      factSet: firstValue(id, IRI.factSet),\n      label: firstValue(id, IRI.prefLabel),\n    })\n  }\n\n  // ── Structures + association → structure membership ──\n  const structures: StructureInfo[] = []\n  const assocStructure = new Map<string, string>()\n  for (const id of subjectsOfType(IRI.Structure)) {\n    structures.push({\n      id,\n      blockType: firstValue(id, IRI.blockType) ?? '',\n      roleUri: firstValue(id, IRI.roleUri),\n      structureName: firstValue(id, IRI.structureName),\n    })\n    for (const assoc of objects(id, IRI.hasAssociation)) {\n      assocStructure.set(assoc.value, id)\n    }\n  }\n\n  // ── Associations ──\n  const calcAssociations: CalcAssociation[] = []\n  const presAssociations: PresAssociation[] = []\n  for (const id of subjectsOfType(IRI.Association)) {\n    const parent = firstValue(id, IRI.from)\n    const child = firstValue(id, IRI.to)\n    if (!parent || !child) continue\n    const type = firstValue(id, IRI.associationType)\n    const order = toNumber(firstValue(id, IRI.order)) ?? 0\n    const role = firstValue(id, IRI.role)\n    const structure = assocStructure.get(id) ?? null\n    if (type === 'calculation') {\n      calcAssociations.push({\n        parent,\n        child,\n        weight: toNumber(firstValue(id, IRI.weight)) ?? 1,\n        order,\n        role,\n        structure,\n      })\n    } else if (type === 'presentation') {\n      presAssociations.push({ parent, child, order, role, structure })\n    }\n  }\n\n  // ── Report IRI / id ──\n  // Prefer the named-graph name (`<report>#scene` → `<report>`) — present in a\n  // holon (TriG or dataset-form JSON-LD). Fall back to the `rs:Report` subject\n  // so a flat, single-graph document still resolves its identity.\n  let reportIri: string | null = null\n  for (const graph of store.getGraphs(null, null, null)) {\n    const hash = graph.value.indexOf('#')\n    if (hash > 0) {\n      reportIri = graph.value.slice(0, hash)\n      break\n    }\n  }\n  if (!reportIri) {\n    const reports = subjectsOfType(IRI.Report)\n    reportIri = reports.length ? reports[0] : null\n  }\n  const reportId = reportIri ? (reportIri.split('/').pop() ?? null) : null\n\n  return {\n    reportId,\n    reportIri,\n    entity,\n    informationBlocks,\n    structures,\n    facts,\n    elements,\n    periods,\n    units,\n    calcAssociations,\n    presAssociations,\n  }\n}\n\n/** Parse a `holon.trig` document into the normalized report model. */\nexport function parseTrig(trig: string): NormalizedReport {\n  const parser = new Parser({ format: 'application/trig' })\n  const store = new Store(parser.parse(trig))\n  return parseStore(store)\n}\n\n/** A `ReportAdapter` over an in-memory `holon.trig` document. */\nexport function trigFileAdapter(trig: string, source = 'holon.trig'): ReportAdapter {\n  return {\n    source,\n    load: async () => parseTrig(trig),\n  }\n}\n","/**\n * The `holon.jsonld` adapter — offline, no backend, no auth.\n *\n * The canonical, API-native holon: **dataset-form JSON-LD** carrying the three\n * named graphs (`#scene`, `#boundary`, `#projection`) as `@id` + nested\n * `@graph`. JSON is native to the RoboSystems JSON API, so this is the default\n * export; TriG remains an optional RDF export handled by `trig.ts`.\n *\n * N3.js parses TriG/N-Quads but not JSON-LD, so this adapter uses the `jsonld`\n * processor to expand the document to N-Quads (which preserves the named-graph\n * labels), parses those into the same N3 quad `Store`, and delegates to the\n * shared `parseStore` traversal — identical to the trig path from there on.\n */\nimport type { JsonLdDocument } from 'jsonld'\nimport jsonld from 'jsonld'\nimport { Parser, Store } from 'n3'\nimport type { NormalizedReport } from '../model'\nimport { parseStore } from './trig'\nimport type { ReportAdapter } from './types'\n\n/** Parse a `holon.jsonld` document (string or parsed object) into the model. */\nexport async function parseJsonld(doc: string | object): Promise<NormalizedReport> {\n  const json = (typeof doc === 'string' ? JSON.parse(doc) : doc) as JsonLdDocument\n  // `toRDF` with the n-quads format returns a serialized string; each quad\n  // carries its graph label, so the holon's named graphs survive the expansion.\n  const nquads = (await jsonld.toRDF(json, { format: 'application/n-quads' })) as string\n  const store = new Store(new Parser({ format: 'application/n-quads' }).parse(nquads))\n  return parseStore(store)\n}\n\n/** A `ReportAdapter` over an in-memory `holon.jsonld` document. */\nexport function jsonldFileAdapter(doc: string | object, source = 'holon.jsonld'): ReportAdapter {\n  return {\n    source,\n    load: () => parseJsonld(doc),\n  }\n}\n"]}

package/dist/{model.d.ts → index-DlTmV_mJ.d.ts}

@@ -1,3 +1,5 @@
+import { Store } from 'n3';
+
 /**
  * The normalized report model — the load-bearing seam of the library.
  *
@@ -11,10 +13,10 @@
  * subtotals, the table layout. That work is identical for every adapter, which
  * is what makes the rendering source-agnostic.
  */
-export type PeriodType = 'instant' | 'duration';
-export type BalanceType = 'debit' | 'credit';
+type PeriodType = 'instant' | 'duration';
+type BalanceType = 'debit' | 'credit';
 /** A reportable concept (a taxonomy element). */
-export interface ElementInfo {
+interface ElementInfo {
     /** Full element IRI — the join key used everywhere. */
     id: string;
     /** Compacted name, e.g. `rs-gaap:Assets`. */
@@ -27,7 +29,7 @@ export interface ElementInfo {
     monetary: boolean;
 }
 /** A reporting period — an instant (balance sheet) or a duration (flows). */
-export interface PeriodInfo {
+interface PeriodInfo {
     id: string;
     type: PeriodType;
     instant: string | null;
@@ -37,7 +39,7 @@ export interface PeriodInfo {
     end: string;
 }
 /** A unit of measure, e.g. USD. */
-export interface UnitInfo {
+interface UnitInfo {
     id: string;
     /** Compacted measure, e.g. `iso4217:USD`. */
     measure: string;
@@ -45,14 +47,14 @@ export interface UnitInfo {
     label: string;
 }
 /** The reporting entity. */
-export interface EntityInfo {
+interface EntityInfo {
     id: string;
     name: string;
     legalName: string | null;
     country: string | null;
 }
 /** A single reported value. */
-export interface Fact {
+interface Fact {
     id: string;
     /** Element IRI. */
     element: string;
@@ -68,7 +70,7 @@ export interface Fact {
     decimals: string | null;
 }
 /** A calculation arc: `parent` (subtotal) rolls up `child * weight`. */
-export interface CalcAssociation {
+interface CalcAssociation {
     parent: string;
     child: string;
     weight: number;
@@ -77,7 +79,7 @@ export interface CalcAssociation {
     structure: string | null;
 }
 /** A presentation arc: `parent` shows `child` at the given order. */
-export interface PresAssociation {
+interface PresAssociation {
     parent: string;
     child: string;
     order: number;
@@ -85,21 +87,21 @@ export interface PresAssociation {
     structure: string | null;
 }
 /** A network root — groups associations under one role / block type. */
-export interface StructureInfo {
+interface StructureInfo {
     id: string;
     blockType: string;
     roleUri: string | null;
     structureName: string | null;
 }
 /** An Information Block — groups a statement's facts via a shared `factSet`. */
-export interface InformationBlock {
+interface InformationBlock {
     id: string;
     blockType: string;
     factSet: string | null;
     label: string | null;
 }
 /** The full normalized report — the adapter's output and projection's input. */
-export interface NormalizedReport {
+interface NormalizedReport {
     reportId: string | null;
     reportIri: string | null;
     entity: EntityInfo | null;
@@ -113,7 +115,7 @@ export interface NormalizedReport {
     presAssociations: PresAssociation[];
 }
 /** A statement column, keyed by the period end date facts are matched against. */
-export interface StatementColumn {
+interface StatementColumn {
     /** The period end date used to match facts into this column. */
     key: string;
     /** Human header label. */
@@ -122,12 +124,12 @@ export interface StatementColumn {
     period: PeriodInfo;
 }
 /** One value in a row, plus the fact behind it (for inspection / footing). */
-export interface RowCell {
+interface RowCell {
     value: number | null;
     fact: Fact | null;
 }
 /** A rendered statement line. */
-export interface StatementRow {
+interface StatementRow {
     element: ElementInfo;
     /** Tree depth — drives indentation. */
     depth: number;
@@ -136,7 +138,7 @@ export interface StatementRow {
     cells: RowCell[];
 }
 /** A fully reconstructed statement, ready to render. */
-export interface Statement {
+interface Statement {
     ib: InformationBlock;
     blockType: string;
     /** Friendly heading, e.g. "Balance Sheet". */
@@ -145,4 +147,72 @@ export interface Statement {
     columns: StatementColumn[];
     rows: StatementRow[];
 }
-//# sourceMappingURL=model.d.ts.map
+
+/**
+ * The adapter seam. An adapter turns one source into a `NormalizedReport`; the
+ * projection + components do the rest, identically for every source.
+ *
+ * The package ships two read-only reference adapters — `trig` (offline file via
+ * N3.js) and `cypher` (a live graph database). A consuming app with operational
+ * needs (a live ledger it also edits) supplies its own adapter in-app.
+ */
+
+interface ReportAdapter {
+    /** A short, human-readable description of the source (for the UI). */
+    readonly source: string;
+    /** Produce the normalized report model. */
+    load(): Promise<NormalizedReport>;
+}
+
+/**
+ * The cypher / GraphQL adapter — a live graph database (an entity graph **or**
+ * the SEC repository) read read-only with an API key. One adapter for both:
+ * only the endpoint / `graphId` differ.
+ *
+ * Phase 2 (Mode B). Stubbed for now so the seam and the `./adapters` export
+ * surface are in place; the holon-viewer's SEC mode will drive its build-out.
+ */
+
+interface CypherAdapterConfig {
+    /** GraphQL / cypher endpoint base URL. */
+    endpoint: string;
+    /** User-supplied API key (sent client-side; never app-managed). */
+    apiKey: string;
+    /** Target graph — an entity graph id or the SEC repository id. */
+    graphId: string;
+    /** The report to materialize. */
+    reportId: string;
+}
+declare function cypherAdapter(config: CypherAdapterConfig): ReportAdapter;
+
+/** Parse a `holon.jsonld` document (string or parsed object) into the model. */
+declare function parseJsonld(doc: string | object): Promise<NormalizedReport>;
+/** A `ReportAdapter` over an in-memory `holon.jsonld` document. */
+declare function jsonldFileAdapter(doc: string | object, source?: string): ReportAdapter;
+
+/**
+ * The `holon.trig` file adapter — offline, no backend, no auth.
+ *
+ * Parses TriG (three named graphs: `#scene`, `#boundary`, `#projection`) with
+ * N3.js into a quad store, then traverses the store to emit a `NormalizedReport`.
+ * The three graphs are queried as a union (graph = `null`) — exactly the join
+ * the DataBook converter does on the flat graph. No SPARQL engine is required;
+ * only store traversal.
+ */
+
+/**
+ * Traverse a populated quad `Store` into the normalized report model.
+ *
+ * The store is read as a **union** across its graphs (`graph = null`) — the
+ * scene/boundary/projection partition is a publication concern, not a rendering
+ * one, so the join is identical whether the quads arrived from a TriG holon, a
+ * dataset-form JSON-LD holon, or a flat graph. Shared by `parseTrig` and
+ * `parseJsonld`; the only per-syntax code is how the store gets filled.
+ */
+declare function parseStore(store: Store): NormalizedReport;
+/** Parse a `holon.trig` document into the normalized report model. */
+declare function parseTrig(trig: string): NormalizedReport;
+/** A `ReportAdapter` over an in-memory `holon.trig` document. */
+declare function trigFileAdapter(trig: string, source?: string): ReportAdapter;
+
+export { type BalanceType as B, type CalcAssociation as C, type ElementInfo as E, type Fact as F, type InformationBlock as I, type NormalizedReport as N, type PeriodInfo as P, type ReportAdapter as R, type Statement as S, type UnitInfo as U, type StatementRow as a, type CypherAdapterConfig as b, type EntityInfo as c, type PeriodType as d, type PresAssociation as e, type RowCell as f, type StatementColumn as g, type StructureInfo as h, cypherAdapter as i, jsonldFileAdapter as j, parseStore as k, parseTrig as l, parseJsonld as p, trigFileAdapter as t };