@ssot-registry/lineage-graph 0.2.25-dev.5

package/README.md

@@ -0,0 +1,15 @@
+# @ssot-registry/lineage-graph
+
+Portable React viewer for SSOT lineage graph payloads.
+
+```tsx
+import { LineageGraphApp } from "@ssot-registry/lineage-graph";
+
+<LineageGraphApp payload={payload} />;
+```
+
+The package also exports `createStandaloneHtml(payload)`, which is used by the Python `ssot-registry graph lineage` command to emit an offline HTML artifact.
+
+`LineageGraphApp` is the forward path for new integrations. The lower-level
+`LineageGraph` canvas export remains available for compatibility with existing
+callers, but new work should use the workspace app shell.

package/dist/LineageGraph.d.ts

@@ -0,0 +1,2 @@
+export { LineageGraph } from "./components/LineageGraphCanvas";
+export type { LineageGraphHandle, LineageGraphRuntimeState } from "./components/LineageGraphCanvas";

package/dist/LineageGraphApp.d.ts

@@ -0,0 +1 @@
+export { LineageGraphApp } from "./views/LineageGraphAppView";

package/dist/components/ConnectedEdgesPanel.d.ts

@@ -0,0 +1,9 @@
+import React from "react";
+import type { LineageEdge, SelectionState } from "../types";
+export declare function ConnectedEdgesPanel({ connectedEdges, selectedNodeId, centerId, setCenterId, setSelection, }: {
+    connectedEdges: LineageEdge[];
+    selectedNodeId: string | null;
+    centerId: string | null;
+    setCenterId: (id: string | null) => void;
+    setSelection: React.Dispatch<React.SetStateAction<SelectionState>>;
+}): React.ReactElement;

package/dist/components/FamilyFilters.d.ts

@@ -0,0 +1,6 @@
+import React from "react";
+export declare function FamilyFilters({ families, familyVisible, setFamilyVisible, }: {
+    families: string[];
+    familyVisible: Record<string, boolean>;
+    setFamilyVisible: React.Dispatch<React.SetStateAction<Record<string, boolean>>>;
+}): React.ReactElement;

package/dist/components/Legend.d.ts

@@ -0,0 +1,4 @@
+import React from "react";
+export declare function Legend({ families }: {
+    families: string[];
+}): React.ReactElement;

package/dist/components/LineageGraphCanvas.d.ts

@@ -0,0 +1,40 @@
+import React from "react";
+import type { DepthSetting, LayoutMode, LineageEdge, LineagePayload, PositionedNode, RendererMode, SelectionState, ViewportState } from "../types";
+interface InternalOptions {
+    mode: LayoutMode;
+    depth: DepthSetting;
+    nodeLimit: number | "all";
+    edgeType: string;
+    search: string;
+    familyVisible: Record<string, boolean>;
+    centerId: string | null;
+    renderer: "auto" | "webgl" | "canvas";
+    xScale: number;
+    yScale: number;
+    edgeOpacity: number;
+    edgeWidth: number;
+    ribbonCulling: "off" | "light" | "strong";
+    forceCutoff: number;
+    forceStrength: number;
+    repulsionStrength: number;
+    selectedNodeId?: string | null;
+    selectedEdgeIndex?: number | null;
+}
+export interface LineageGraphHandle {
+    fit: () => void;
+    exportPng: () => void;
+    exportSvg: () => void;
+}
+export interface LineageGraphRuntimeState {
+    visibleNodes: PositionedNode[];
+    visibleEdges: LineageEdge[];
+    rendererMode: RendererMode;
+    viewport: ViewportState;
+}
+export declare function LineageGraph({ payload, options, className, onSelectionChange, }: {
+    payload: LineagePayload;
+    options?: Partial<InternalOptions>;
+    className?: string;
+    onSelectionChange?: (selection: SelectionState) => void;
+}): React.ReactElement;
+export {};

package/dist/components/PackageSummary.d.ts

@@ -0,0 +1,6 @@
+import React from "react";
+import type { LineagePayload } from "../types";
+export declare function PackageSummary({ payload, packageText }: {
+    payload: LineagePayload;
+    packageText: string;
+}): React.ReactElement;

package/dist/components/ResultsList.d.ts

@@ -0,0 +1,8 @@
+import React from "react";
+import type { LineageNode, SelectionState } from "../types";
+export declare function ResultsList({ nodes, search, selection, setSelection, }: {
+    nodes: LineageNode[];
+    search: string;
+    selection: SelectionState;
+    setSelection: React.Dispatch<React.SetStateAction<SelectionState>>;
+}): React.ReactElement;

package/dist/components/SelectedNodePanel.d.ts

@@ -0,0 +1,8 @@
+import React from "react";
+import type { LineageNode, SelectionState } from "../types";
+export declare function SelectedNodePanel({ selectedNode, centerId, setCenterId, setSelection, }: {
+    selectedNode?: LineageNode;
+    centerId: string | null;
+    setCenterId: (id: string | null) => void;
+    setSelection: React.Dispatch<React.SetStateAction<SelectionState>>;
+}): React.ReactElement;

package/dist/components/ViewControls.d.ts

@@ -0,0 +1,33 @@
+import React from "react";
+import type { DepthSetting, LayoutMode } from "../types";
+interface ViewControlsProps {
+    mode: LayoutMode;
+    setMode: (mode: LayoutMode) => void;
+    depth: DepthSetting;
+    setDepth: (depth: DepthSetting) => void;
+    nodeLimit: number | "all";
+    setNodeLimit: (limit: number | "all") => void;
+    edgeType: string;
+    setEdgeType: (edgeType: string) => void;
+    edgeTypes: string[];
+    search: string;
+    setSearch: (search: string) => void;
+    xScaleExponent: number;
+    setXScaleExponent: (value: number) => void;
+    yScaleExponent: number;
+    setYScaleExponent: (value: number) => void;
+    edgeOpacity: number;
+    setEdgeOpacity: (value: number) => void;
+    edgeWidth: number;
+    setEdgeWidth: (value: number) => void;
+    ribbonCulling: "off" | "light" | "strong";
+    setRibbonCulling: (value: "off" | "light" | "strong") => void;
+    forceCutoff: number;
+    setForceCutoff: (value: number) => void;
+    forceStrength: number;
+    setForceStrength: (value: number) => void;
+    repulsionStrength: number;
+    setRepulsionStrength: (value: number) => void;
+}
+export declare function ViewControls(props: ViewControlsProps): React.ReactElement;
+export {};

package/dist/constants.d.ts

@@ -0,0 +1,6 @@
+import type { LineageFamily } from "./types";
+export declare const FAMILY_COLORS: Record<string, string>;
+export declare const FAMILY_RANKS: Record<string, number>;
+export declare function familyColor(family: LineageFamily): string;
+export declare function familyRank(family: LineageFamily): number;
+export declare function familyClassName(family: LineageFamily): string;

package/dist/html.d.ts

@@ -0,0 +1,2 @@
+import type { LineagePayload, StandaloneHtmlOptions } from "./types";
+export declare function createStandaloneHtml(payload: LineagePayload, options?: StandaloneHtmlOptions): string;

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { LineageGraph } from "./LineageGraph";
+export { LineageGraphApp } from "./LineageGraphApp";
+export { createStandaloneHtml } from "./html";
+export { applyForceLayoutStep, applyLineageLayout, normalizeNodes, resolveDepth } from "./layout";
+export type { DepthSetting, LayoutMode, LineageEdge, LineageFamily, LineageGraphProps, LineageNode, LineagePayload, PositionedNode, RendererMode, RendererOptions, RendererPreference, SelectionState, StandaloneHtmlOptions, ViewportState, } from "./types";

package/dist/layout.d.ts

@@ -0,0 +1,12 @@
+import type { DepthSetting, LineageEdge, LineageNode, PositionedNode } from "./types";
+export interface ForceLayoutOptions {
+    springStrength?: number;
+    repulsionStrength?: number;
+}
+export declare function normalizeNodes(nodes: LineageNode[]): PositionedNode[];
+export declare function resolveDepth(edges: LineageEdge[], seeds: string[], depth: DepthSetting, edgeType?: string): {
+    ids: Set<string>;
+    edges: LineageEdge[];
+};
+export declare function applyLineageLayout(nodes: PositionedNode[], xScale: number, yScale: number): PositionedNode[];
+export declare function applyForceLayoutStep(nodes: PositionedNode[], edges: LineageEdge[], iterations?: number, options?: ForceLayoutOptions): PositionedNode[];