@manta-eu/react 0.1.0

package/dist/graph/createNodeRouter.js

@@ -0,0 +1,143 @@
+import { ProviderAccountEntityType } from "@manta-eu/ldo/manual-schemas";
+import { attio, brand, coresignal, ga4, google, m, meta, schema, slack } from "@manta-eu/ldo/namespaces";
+import { expandPrefix } from "@manta-eu/rdf-lib/namespaces";
+import { AdsDailyReportTemplateView } from "./nodes/AdsDailyReportTemplateView.js";
+import { AttioCallRecordingView } from "./nodes/AttioCallRecordingView.js";
+import { AttioCompanyView } from "./nodes/AttioCompanyView.js";
+import { AttioDealView } from "./nodes/AttioDealView.js";
+import { AttioMeetingView } from "./nodes/AttioMeetingView.js";
+import { AttioNoteView } from "./nodes/AttioNoteView.js";
+import { AttioTaskView } from "./nodes/AttioTaskView.js";
+import { BrandAssetAnalysisActionView } from "./nodes/BrandAssetAnalysisActionView.js";
+import { BrandAssetAnalysisView } from "./nodes/BrandAssetAnalysisView.js";
+import { BrandFacetCheckView } from "./nodes/BrandFacetCheckView.js";
+import { BrandFacetRuleView } from "./nodes/BrandFacetRuleView.js";
+import { BrandFitVerdictView } from "./nodes/BrandFitVerdictView.js";
+import { BrandGuidelinesView } from "./nodes/BrandGuidelinesView.js";
+import { BrandPaletteColorView } from "./nodes/BrandPaletteColorView.js";
+import { CoresignalCompanyView } from "./nodes/CoresignalCompanyView.js";
+import { CoresignalEmployeeView } from "./nodes/CoresignalEmployeeView.js";
+import { CoresignalExperienceView } from "./nodes/CoresignalExperienceView.js";
+import { CoresignalJobView } from "./nodes/CoresignalJobView.js";
+import { CoresignalKeyExecutiveDepartureView } from "./nodes/CoresignalKeyExecutiveDepartureView.js";
+import { Ga4DailyOverviewView } from "./nodes/Ga4DailyOverviewView.js";
+import { Ga4FunnelEventCountView } from "./nodes/Ga4FunnelEventCountView.js";
+import { Ga4TrafficSourceView } from "./nodes/Ga4TrafficSourceView.js";
+import { GoogleAdGroupAdView } from "./nodes/GoogleAdGroupAdView.js";
+import { GoogleAdGroupCriterionView } from "./nodes/GoogleAdGroupCriterionView.js";
+import { GoogleAdGroupView } from "./nodes/GoogleAdGroupView.js";
+import { GoogleCampaignBudgetView } from "./nodes/GoogleCampaignBudgetView.js";
+import { GoogleCampaignCriterionView } from "./nodes/GoogleCampaignCriterionView.js";
+import { GoogleCampaignInsightView } from "./nodes/GoogleCampaignInsightView.js";
+import { GoogleCampaignView } from "./nodes/GoogleCampaignView.js";
+import { GoogleCustomerClientView } from "./nodes/GoogleCustomerClientView.js";
+import { GoogleCustomerView } from "./nodes/GoogleCustomerView.js";
+import { GoogleSearchTermInsightView } from "./nodes/GoogleSearchTermInsightView.js";
+import { LinkedinAdAccountView } from "./nodes/LinkedinAdAccountView.js";
+import { MetaAdAccountActivityView } from "./nodes/MetaAdAccountActivityView.js";
+import { MetaAdAccountView } from "./nodes/MetaAdAccountView.js";
+import { MetaAdImageView } from "./nodes/MetaAdImageView.js";
+import { MetaAdSetView } from "./nodes/MetaAdSetView.js";
+import { MetaAdView } from "./nodes/MetaAdView.js";
+import { MetaCampaignView } from "./nodes/MetaCampaignView.js";
+import { MetaInsightView } from "./nodes/MetaInsightView.js";
+import { RenderedTemplateView } from "./nodes/RenderedTemplateView.js";
+import { SchemaActionView } from "./nodes/SchemaActionView.js";
+import { ShopifyShopView } from "./nodes/ShopifyShopView.js";
+import { SlackChannelView } from "./nodes/SlackChannelView.js";
+import { SlackMessageView } from "./nodes/SlackMessageView.js";
+import { SlackUserView } from "./nodes/SlackUserView.js";
+import { SlackWorkspaceView } from "./nodes/SlackWorkspaceView.js";
+const actionShapeNodeEntries = [
+    [expandPrefix(":AdsDailyReportTemplateShape"), AdsDailyReportTemplateView],
+    [expandPrefix("slack:MessageShape"), SlackMessageView],
+    [expandPrefix("brand:AssetAnalysisShape"), BrandAssetAnalysisActionView],
+];
+const typedNodeEntries = [
+    [meta.AdImage, MetaAdImageView],
+    [meta.Ad, MetaAdView],
+    [meta.AdSet, MetaAdSetView],
+    [meta.Campaign, MetaCampaignView],
+    [meta.Insight, MetaInsightView],
+    [google.Campaign, GoogleCampaignView],
+    [google.AdGroup, GoogleAdGroupView],
+    [google.AdGroupAd, GoogleAdGroupAdView],
+    [google.AdGroupCriterion, GoogleAdGroupCriterionView],
+    [google.CampaignBudget, GoogleCampaignBudgetView],
+    [google.CampaignCriterion, GoogleCampaignCriterionView],
+    [google.CampaignInsight, GoogleCampaignInsightView],
+    [google.SearchTermInsight, GoogleSearchTermInsightView],
+    // Connected-account provider entities (MNT-506)
+    [meta.AdAccount, MetaAdAccountView],
+    [ProviderAccountEntityType.GOOGLE_CUSTOMER, GoogleCustomerView],
+    [google.CustomerClient, GoogleCustomerClientView],
+    [ProviderAccountEntityType.LINKEDIN_AD_ACCOUNT, LinkedinAdAccountView],
+    [ProviderAccountEntityType.SHOPIFY_SHOP, ShopifyShopView],
+    [ProviderAccountEntityType.SLACK_WORKSPACE, SlackWorkspaceView],
+    [schema.Action, SchemaActionView],
+    [coresignal.Employee, CoresignalEmployeeView],
+    [coresignal.Company, CoresignalCompanyView],
+    [coresignal.Job, CoresignalJobView],
+    [coresignal.Experience, CoresignalExperienceView],
+    [coresignal.KeyExecutiveDeparture, CoresignalKeyExecutiveDepartureView],
+    [ga4.TrafficSource, Ga4TrafficSourceView],
+    [ga4.DailyOverview, Ga4DailyOverviewView],
+    [ga4.FunnelEventCount, Ga4FunnelEventCountView],
+    [attio.Company, AttioCompanyView],
+    [attio.Deal, AttioDealView],
+    [attio.Note, AttioNoteView],
+    [attio.CallRecording, AttioCallRecordingView],
+    [attio.Meeting, AttioMeetingView],
+    [attio.Task, AttioTaskView],
+    [slack.Channel, SlackChannelView],
+    [slack.User, SlackUserView],
+    [meta.AdAccountActivity, MetaAdAccountActivityView],
+    [m.RenderedTemplate, RenderedTemplateView],
+    [m.AdsDailyReportTemplate, AdsDailyReportTemplateView],
+    // Asserted by a Datalog rule, not by a node shape, so codegen emits no class term for it.
+    [expandPrefix("brand:AssetAnalysis"), BrandAssetAnalysisView],
+    [brand.BrandGuidelines, BrandGuidelinesView],
+    [brand.BrandFacetRule, BrandFacetRuleView],
+    [brand.BrandFitVerdict, BrandFitVerdictView],
+    [brand.FacetCheck, BrandFacetCheckView],
+    [brand.PaletteColor, BrandPaletteColorView],
+];
+export const typedEntityTypeIris = new Set(typedNodeEntries.map(([type]) => type));
+// Views that re-present a change's full content (property-table cards), so the activity viewer can
+// drop its raw Changes rows beneath them. Lens-backed summary cards (Meta/Google/Attio) stay out:
+// they show current state, not the change. Registering a new full-property view? Add it here too.
+export const diffSubsumingViewIris = new Set([
+    expandPrefix("brand:AssetAnalysisShape"),
+    expandPrefix("brand:AssetAnalysis"),
+    brand.BrandGuidelines,
+    brand.BrandFacetRule,
+    brand.BrandFitVerdict,
+    brand.FacetCheck,
+    brand.PaletteColor,
+]);
+export const typedActionShapeIris = new Set(actionShapeNodeEntries.map(([iri]) => iri));
+function resolveByType(typeMap, actionShapeMap, entityType, actionShape) {
+    if (actionShape) {
+        const byActionShape = actionShapeMap[actionShape] ?? actionShapeMap[expandPrefix(actionShape)];
+        if (byActionShape)
+            return byActionShape;
+    }
+    if (!entityType)
+        return undefined;
+    return typeMap[entityType] ?? typeMap[expandPrefix(entityType)];
+}
+export function createNodeRouter(opts) {
+    const { wrap, fallback } = opts;
+    const viewMap = Object.fromEntries(typedNodeEntries);
+    const actionShapeViewMap = Object.fromEntries(actionShapeNodeEntries);
+    const nodeMap = Object.fromEntries(typedNodeEntries.map(([type, View]) => [type, wrap(View)]));
+    const actionShapeNodeMap = Object.fromEntries(actionShapeNodeEntries.map(([iri, View]) => [iri, wrap(View)]));
+    return {
+        getEntityView(entityType, actionShape) {
+            return resolveByType(viewMap, actionShapeViewMap, entityType, actionShape);
+        },
+        getNodeComponent(entityType, actionShape) {
+            return resolveByType(nodeMap, actionShapeNodeMap, entityType, actionShape) ?? fallback;
+        },
+    };
+}

package/dist/graph/custom-nodes.d.ts

@@ -0,0 +1,11 @@
+import { type EdgeProps } from "@xyflow/react";
+import type { RDFEdge } from "./graph-utils.js";
+export declare const LabeledEdge: import("react").NamedExoticComponent<EdgeProps<RDFEdge>>;
+export declare const nodeTypes: {
+    readonly rdfNode: import("react").NamedExoticComponent<import("@xyflow/react").NodeProps<import("./types.js").RDFNode>>;
+    readonly typeSummaryNode: import("react").NamedExoticComponent<import("@xyflow/react").NodeProps<import("./types.js").RDFNode>>;
+};
+export declare const edgeTypes: {
+    readonly labeledEdge: import("react").NamedExoticComponent<EdgeProps<RDFEdge>>;
+};
+//# sourceMappingURL=custom-nodes.d.ts.map

package/dist/graph/custom-nodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-nodes.d.ts","sourceRoot":"","sources":["../../src/graph/custom-nodes.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA8C,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAE3F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAQ7C,eAAO,MAAM,WAAW,0DA6DtB,CAAC;AAEH,eAAO,MAAM,SAAS;;;CAGZ,CAAC;AAEX,eAAO,MAAM,SAAS;;CAEZ,CAAC"}

package/dist/graph/custom-nodes.js

@@ -0,0 +1,49 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { BaseEdge, EdgeLabelRenderer, getBezierPath } from "@xyflow/react";
+import { memo, useMemo } from "react";
+import { DynamicNode } from "./special-nodes/DynamicNode.js";
+import { TypeSummaryNode } from "./special-nodes/TypeSummaryNode.js";
+import { useGraphTheme } from "./themes.js";
+import { cn } from "#style";
+const parallelEdgeLabelSpacingPx = 22;
+export const LabeledEdge = memo(function LabeledEdge(props) {
+    const { sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, data, style, markerEnd } = props;
+    const theme = useGraphTheme();
+    const [edgePath, labelX, labelY] = getBezierPath({
+        sourceX,
+        sourceY,
+        sourcePosition,
+        targetX,
+        targetY,
+        targetPosition,
+    });
+    const label = data?.label;
+    const relationshipType = data?.relationshipType;
+    const edgeIndex = data?.edgeIndex ?? 0;
+    const siblingCount = data?.edgeSiblingCount ?? 0;
+    const strokeColor = relationshipType ? theme.edge.relationship[relationshipType] : theme.edge.default;
+    const edgeStyle = useMemo(() => ({ ...style, stroke: strokeColor, strokeWidth: 1.5 }), [style, strokeColor]);
+    const labelStyle = useMemo(() => {
+        let adjustedX = labelX;
+        let adjustedY = labelY;
+        if (siblingCount > 1) {
+            const angle = Math.atan2(targetY - sourceY, targetX - sourceX);
+            const perpX = -Math.sin(angle);
+            const perpY = Math.cos(angle);
+            const offset = (edgeIndex - (siblingCount - 1) / 2) * parallelEdgeLabelSpacingPx;
+            adjustedX = labelX + perpX * offset;
+            adjustedY = labelY + perpY * offset;
+        }
+        return {
+            transform: `translate(-50%, -50%) translate(${adjustedX}px, ${adjustedY}px)`,
+        };
+    }, [labelX, labelY, edgeIndex, siblingCount, sourceX, sourceY, targetX, targetY]);
+    return (_jsxs(_Fragment, { children: [_jsx(BaseEdge, { path: edgePath, markerEnd: markerEnd, style: edgeStyle }), label && (_jsx(EdgeLabelRenderer, { children: _jsx("div", { className: cn("absolute px-1.5 py-[1px] rounded-[4px] typography-tiny", "bg-background/95", "text-muted-foreground", "border border-default-border/80", "pointer-events-none shadow-[0_1px_2px_rgba(0,0,0,0.05)]"), style: labelStyle, children: label }) }))] }));
+});
+export const nodeTypes = {
+    rdfNode: DynamicNode,
+    typeSummaryNode: TypeSummaryNode,
+};
+export const edgeTypes = {
+    labeledEdge: LabeledEdge,
+};

package/dist/graph/detail-views.d.ts

@@ -0,0 +1,11 @@
+import type { ComponentType } from "react";
+export type DetailView = ComponentType<{
+    iri: string;
+}>;
+export type PluralView = ComponentType<{
+    iris: string[];
+}>;
+export declare const detailViewTypeIris: string[];
+export declare function findDetailViewForTypes(rdfTypes: readonly string[]): DetailView | undefined;
+export declare function findPluralViewForTypes(rdfTypes: readonly string[]): PluralView | undefined;
+//# sourceMappingURL=detail-views.d.ts.map

package/dist/graph/detail-views.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detail-views.d.ts","sourceRoot":"","sources":["../../src/graph/detail-views.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAO3C,MAAM,MAAM,UAAU,GAAG,aAAa,CAAC;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AACxD,MAAM,MAAM,UAAU,GAAG,aAAa,CAAC;IAAE,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAAC;AAY3D,eAAO,MAAM,kBAAkB,UAAgD,CAAC;AAehF,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,GAAG,SAAS,CAE1F;AAkBD,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,GAAG,SAAS,CAQ1F"}

package/dist/graph/detail-views.js

@@ -0,0 +1,48 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { google, meta } from "@manta-eu/ldo/namespaces";
+import { expandPrefix } from "@manta-eu/rdf-lib/namespaces";
+import { GoogleAdGroupAdDisplay } from "../ad-preview/GoogleAdGroupAdDisplay.js";
+import { GoogleAdGroupAdPluralDisplay } from "../ad-preview/GoogleAdGroupAdPluralDisplay.js";
+import { MetaAdDisplay } from "../ad-preview/MetaAdDisplay.js";
+import { MetaAdPluralDisplay } from "../ad-preview/MetaAdPluralDisplay.js";
+import { EntityStripDisplay } from "./EntityStripDisplay.js";
+const detailViewEntries = [
+    [meta.Ad, MetaAdDisplay],
+    [google.AdGroupAd, GoogleAdGroupAdDisplay],
+];
+const pluralViewEntries = [
+    [meta.Ad, MetaAdPluralDisplay],
+    [google.AdGroupAd, GoogleAdGroupAdPluralDisplay],
+];
+export const detailViewTypeIris = detailViewEntries.map(([typeIri]) => typeIri);
+const detailViewMap = new Map(detailViewEntries);
+const pluralViewMap = new Map(pluralViewEntries);
+function findForTypes(views, rdfTypes) {
+    for (const rdfType of rdfTypes) {
+        const view = views.get(rdfType) ?? views.get(expandPrefix(rdfType));
+        if (view)
+            return view;
+    }
+    return undefined;
+}
+export function findDetailViewForTypes(rdfTypes) {
+    return findForTypes(detailViewMap, rdfTypes);
+}
+const stripViews = new WeakMap();
+function stripViewFor(View) {
+    const cached = stripViews.get(View);
+    if (cached)
+        return cached;
+    const strip = function EntityStrip(props) {
+        return _jsx(EntityStripDisplay, { iris: props.iris, View: View });
+    };
+    stripViews.set(View, strip);
+    return strip;
+}
+export function findPluralViewForTypes(rdfTypes) {
+    const override = findForTypes(pluralViewMap, rdfTypes);
+    if (override)
+        return override;
+    const View = findForTypes(detailViewMap, rdfTypes);
+    return View ? stripViewFor(View) : undefined;
+}

package/dist/graph/ego-graph.d.ts

@@ -0,0 +1,19 @@
+import { type JsonLdGraphDocument, type JsonLdNode } from "@manta-eu/rdf-lib/jsonld";
+import Graph from "graphology";
+import type { SampleInstance } from "./types.js";
+export type TypeEnrichment = {
+    sampleInstances: SampleInstance[];
+    allInstances: SampleInstance[];
+    isInEgoChain: boolean;
+};
+export declare function extractNodeDisplayData(jsonLdNode: JsonLdNode): {
+    label: string;
+    properties: Array<{
+        key: string;
+        value: string;
+    }>;
+};
+export declare function buildGraphologyGraph(jsonLd: JsonLdGraphDocument): Graph;
+export declare function findRepresentativeChain(graph: Graph): Set<string>;
+export declare function computeSummaryEnrichment(jsonLd: JsonLdGraphDocument): Map<string, TypeEnrichment>;
+//# sourceMappingURL=ego-graph.d.ts.map

package/dist/graph/ego-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ego-graph.d.ts","sourceRoot":"","sources":["../../src/graph/ego-graph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,mBAAmB,EAAE,KAAK,UAAU,EAA8B,MAAM,0BAA0B,CAAC;AACjH,OAAO,KAAK,MAAM,YAAY,CAAC;AAG/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,MAAM,MAAM,cAAc,GAAG;IAC3B,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,YAAY,EAAE,cAAc,EAAE,CAAC;IAC/B,YAAY,EAAE,OAAO,CAAC;CACvB,CAAC;AASF,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,UAAU,GAAG;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnD,CA2EA;AA0CD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,mBAAmB,GAAG,KAAK,CAwDvE;AAmCD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,CAyBjE;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,mBAAmB,GAAG,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CA0DjG"}

package/dist/graph/ego-graph.js

@@ -0,0 +1,284 @@
+import { getNodeTypes, isJsonLdNode } from "@manta-eu/rdf-lib/jsonld";
+import Graph from "graphology";
+import { humanizePredicateName, shortenUri } from "./graph-utils.js";
+import { readVocabValue } from "./nodes/typed-node-helpers.js";
+const labelPredicateSuffixes = ["label", "name", "title", "displayname"];
+function isLabelPredicate(predicate) {
+    const lower = predicate.toLowerCase();
+    return labelPredicateSuffixes.some((suffix) => lower.endsWith(suffix));
+}
+export function extractNodeDisplayData(jsonLdNode) {
+    const id = jsonLdNode["@id"] ?? "";
+    const types = getNodeTypes(jsonLdNode);
+    const type = types[0];
+    let label;
+    const properties = [];
+    for (const [predicate, value] of Object.entries(jsonLdNode)) {
+        if (predicate.startsWith("@"))
+            continue;
+        if (predicate === "rdf:type" || predicate === "http://www.w3.org/1999/02/22-rdf-syntax-ns#type")
+            continue;
+        if (isLabelPredicate(predicate)) {
+            const labelValue = extractStringValue(value);
+            if (labelValue && !label) {
+                label = labelValue;
+            }
+            continue;
+        }
+        if (isJsonLdNode(value) && value["@id"])
+            continue;
+        if (Array.isArray(value) && value.length > 0 && isJsonLdNode(value[0]) && value[0]["@id"])
+            continue;
+        const stringValue = extractLiteralValue(value);
+        if (stringValue !== undefined) {
+            properties.push({ key: humanizePredicateName(predicate), value: stringValue });
+        }
+    }
+    if (!label) {
+        const rankValue = readVocabValue(jsonLdNode, "rank") ?? jsonLdNode["rank"];
+        if (rankValue !== undefined && rankValue !== null) {
+            label = `#${rankValue}`;
+        }
+    }
+    if (!label) {
+        for (const [key, value] of Object.entries(jsonLdNode)) {
+            if (key.startsWith("@"))
+                continue;
+            if (isLabelPredicate(key) && typeof value === "string") {
+                label = value;
+                break;
+            }
+        }
+    }
+    if (!label) {
+        const nameVal = jsonLdNode["schema:name"] ?? jsonLdNode[":originalFilename"] ?? jsonLdNode[":name"];
+        if (typeof nameVal === "string")
+            label = nameVal;
+    }
+    if (!label) {
+        let localName;
+        try {
+            localName = decodeURIComponent(shortenUri(id)).replace(/^[:#]/, "");
+        }
+        catch {
+            localName = shortenUri(id).replace(/^[:#]/, "");
+        }
+        if (type) {
+            const typeName = shortenUri(type)
+                .replace(/^[:#]/, "")
+                .replace(/([a-z])([A-Z])/g, "$1 $2");
+            const idSuffix = localName.replace(new RegExp(`^${typeName.replace(/\s/g, "")}[_-]?`), "");
+            if (idSuffix && idSuffix !== localName && idSuffix.length > 6) {
+                label = `${typeName} ${idSuffix.slice(0, 8)}...`;
+            }
+            else {
+                label = typeName;
+            }
+        }
+        else {
+            label = localName.length > 40 ? `${localName.slice(0, 35)}...` : localName;
+        }
+    }
+    return { label, properties };
+}
+function extractStringValue(value) {
+    if (typeof value === "string")
+        return value;
+    if (isJsonLdNode(value) && typeof value["@value"] === "string")
+        return value["@value"];
+    if (Array.isArray(value) && value.length > 0) {
+        const first = value[0];
+        if (typeof first === "string")
+            return first;
+        if (isJsonLdNode(first) && typeof first["@value"] === "string")
+            return first["@value"];
+    }
+    return undefined;
+}
+function extractLiteralValue(value) {
+    if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+        return String(value);
+    }
+    if (isJsonLdNode(value) && value["@value"] !== undefined) {
+        const v = value["@value"];
+        if (typeof v === "string" || typeof v === "number" || typeof v === "boolean")
+            return String(v);
+    }
+    if (Array.isArray(value)) {
+        const parts = value
+            .filter((v) => typeof v === "string" || typeof v === "number" || typeof v === "boolean")
+            .map((v) => String(v));
+        if (parts.length > 0)
+            return parts.join(" | ");
+    }
+    return undefined;
+}
+function normalizeNodeId(rawId) {
+    if (rawId === null || rawId === undefined)
+        return null;
+    if (typeof rawId === "string") {
+        const normalized = rawId.trim();
+        return normalized.length > 0 ? normalized : null;
+    }
+    if (typeof rawId === "number" || typeof rawId === "boolean" || typeof rawId === "bigint") {
+        return String(rawId);
+    }
+    return null;
+}
+export function buildGraphologyGraph(jsonLd) {
+    const graph = new Graph({ type: "directed" });
+    for (const node of jsonLd["@graph"]) {
+        const id = normalizeNodeId(node["@id"]);
+        if (!id)
+            continue;
+        const types = getNodeTypes(node);
+        const nextType = types[0] ?? "unknown";
+        if (!graph.hasNode(id)) {
+            try {
+                graph.addNode(id, { type: nextType });
+            }
+            catch (error) {
+                if (error instanceof Error && error.message.includes("already exist in the graph")) {
+                    continue;
+                }
+                throw error;
+            }
+            continue;
+        }
+        const currentType = graph.getNodeAttribute(id, "type");
+        if ((currentType === undefined || currentType === "unknown") && nextType !== "unknown") {
+            graph.setNodeAttribute(id, "type", nextType);
+        }
+    }
+    for (const node of jsonLd["@graph"]) {
+        const id = normalizeNodeId(node["@id"]);
+        if (!id)
+            continue;
+        for (const [predicate, value] of Object.entries(node)) {
+            if (predicate.startsWith("@"))
+                continue;
+            const targets = [];
+            const singleTargetId = isJsonLdNode(value) ? normalizeNodeId(value["@id"]) : null;
+            if (singleTargetId && graph.hasNode(singleTargetId)) {
+                targets.push(singleTargetId);
+            }
+            else if (Array.isArray(value)) {
+                for (const item of value) {
+                    const itemTargetId = isJsonLdNode(item) ? normalizeNodeId(item["@id"]) : null;
+                    if (itemTargetId && graph.hasNode(itemTargetId)) {
+                        targets.push(itemTargetId);
+                    }
+                }
+            }
+            for (const targetId of targets) {
+                if (!graph.hasEdge(id, targetId)) {
+                    graph.addEdge(id, targetId, { predicate });
+                }
+            }
+        }
+    }
+    return graph;
+}
+function greedyTypePath(graph, start) {
+    const chain = [];
+    const visited = new Set();
+    const seenTypes = new Set();
+    let current = start;
+    while (current !== undefined) {
+        visited.add(current);
+        chain.push(current);
+        seenTypes.add(graph.getNodeAttribute(current, "type"));
+        let bestNext;
+        let bestIsNewType = false;
+        graph.forEachOutNeighbor(current, (neighbor) => {
+            if (visited.has(neighbor))
+                return;
+            const neighborType = graph.getNodeAttribute(neighbor, "type");
+            const isNewType = !seenTypes.has(neighborType);
+            if (isNewType && !bestIsNewType) {
+                bestIsNewType = true;
+                bestNext = neighbor;
+            }
+            else if (!bestIsNewType && bestNext === undefined) {
+                bestNext = neighbor;
+            }
+        });
+        current = bestNext;
+    }
+    return chain;
+}
+export function findRepresentativeChain(graph) {
+    if (graph.order === 0)
+        return new Set();
+    const sources = [];
+    graph.forEachNode((nodeId) => {
+        if (graph.inDegree(nodeId) === 0) {
+            sources.push(nodeId);
+        }
+    });
+    const candidates = sources.length > 0 ? sources : graph.nodes().slice(0, 1);
+    let bestChain = [];
+    let bestTypeCount = 0;
+    for (const start of candidates.slice(0, 50)) {
+        const chain = greedyTypePath(graph, start);
+        const typeCount = new Set(chain.map((n) => graph.getNodeAttribute(n, "type"))).size;
+        if (typeCount > bestTypeCount) {
+            bestTypeCount = typeCount;
+            bestChain = chain;
+        }
+    }
+    return new Set(bestChain);
+}
+export function computeSummaryEnrichment(jsonLd) {
+    const result = new Map();
+    const graph = buildGraphologyGraph(jsonLd);
+    const chainNodeIds = findRepresentativeChain(graph);
+    const nodesByType = new Map();
+    for (const node of jsonLd["@graph"]) {
+        const id = normalizeNodeId(node["@id"]);
+        if (!id)
+            continue;
+        const types = getNodeTypes(node);
+        const primaryType = types[0] ?? "unknown";
+        const group = nodesByType.get(primaryType) ?? new Map();
+        const existing = group.get(id);
+        if (!existing) {
+            group.set(id, node);
+        }
+        else {
+            group.set(id, { ...existing, ...node, "@id": id });
+        }
+        nodesByType.set(primaryType, group);
+    }
+    const chainTypes = new Set();
+    for (const nodeId of chainNodeIds) {
+        if (graph.hasNode(nodeId)) {
+            chainTypes.add(graph.getNodeAttribute(nodeId, "type"));
+        }
+    }
+    for (const [type, nodeMap] of nodesByType) {
+        const nodes = Array.from(nodeMap.values());
+        const chainNodes = nodes.filter((n) => n["@id"] && chainNodeIds.has(n["@id"]));
+        const nonChainNodes = nodes.filter((n) => !n["@id"] || !chainNodeIds.has(n["@id"]));
+        const prioritized = [...chainNodes, ...nonChainNodes];
+        const allInstances = prioritized.map((node) => {
+            const { label, properties } = extractNodeDisplayData(node);
+            return {
+                id: node["@id"] ?? "",
+                label,
+                type,
+                properties,
+            };
+        });
+        const sampleInstances = allInstances.slice(0, 3).map((inst) => ({
+            ...inst,
+            properties: inst.properties.slice(0, 2),
+        }));
+        result.set(type, {
+            sampleInstances,
+            allInstances,
+            isInEgoChain: chainTypes.has(type),
+        });
+    }
+    return result;
+}

package/dist/graph/graph-layout.d.ts

@@ -0,0 +1,18 @@
+import type { RDFEdge } from "./graph-utils.js";
+import { RelationshipType } from "./themes.js";
+import type { LayoutDirection, RDFNode } from "./types.js";
+export type NodeDimensions = {
+    width: number;
+    height: number;
+};
+export type LayoutOptions = {
+    nodeDimensions?: NodeDimensions;
+    ranksep?: number;
+    nodesep?: number;
+};
+export declare function detectRelationshipType(sourceType?: string, targetType?: string): RelationshipType;
+export declare function getNodeDimensions(entityType?: string): NodeDimensions;
+export declare function applyDagreLayout(nodes: RDFNode[], edges: RDFEdge[], direction?: LayoutDirection, options?: LayoutOptions): RDFNode[];
+export declare function computeEdgeSiblingIndices(edges: RDFEdge[]): void;
+export declare function computeHubThreshold(connectionCounts: Map<string, number>): number;
+//# sourceMappingURL=graph-layout.d.ts.map

package/dist/graph/graph-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-layout.d.ts","sourceRoot":"","sources":["../../src/graph/graph-layout.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAiC,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC3E,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAQxD,MAAM,MAAM,cAAc,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/D,MAAM,MAAM,aAAa,GAAG;IAC1B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAUF,wBAAgB,sBAAsB,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAgBjG;AAED,wBAAgB,iBAAiB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,cAAc,CAOrE;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,EAAE,EAChB,KAAK,EAAE,OAAO,EAAE,EAChB,SAAS,GAAE,eAAsB,EACjC,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,EAAE,CAgDX;AA0ID,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAiBhE;AAED,wBAAgB,mBAAmB,CAAC,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAMjF"}