@tldiagram/core-ui 1.95.0 → 2.0.0

package/dist/api/client.d.ts

@@ -1,9 +1,125 @@
-import type { Connector, DependencyConnector, DependencyElement, ElementPlacement, ExploreData, LibraryElement, PlacedElement, Tag, View, ViewConnector, ViewLayer, ViewPlacement, ViewTreeNode } from '../types';
+import type { Connector, DependencyConnector, DependencyElement, ElementPlacement, ExploreData, LibraryElement, PlacedElement, Tag, View, ViewConnector, ViewLayer, ViewPlacement, ViewTreeNode, VisibilityOverride } from '../types';
 import { PlanElement, PlanConnector } from '@buf/tldiagramcom_diagram.bufbuild_es/diag/v1/workspace_service_pb';
 export interface DependenciesResponse {
     elements: DependencyElement[];
     connectors: DependencyConnector[];
+    totalCount?: number;
 }
+export interface WatchRepository {
+    id: number;
+    remote_url: string | null;
+    repo_root: string;
+    display_name: string;
+    branch: string | null;
+    head_commit: string | null;
+    identity_status: string;
+}
+export interface WatchLock {
+    id: number;
+    repository_id: number;
+    pid: number;
+    started_at: string;
+    heartbeat_at: string;
+    status: 'active' | 'paused' | 'stopping' | 'stale' | 'released' | string;
+}
+export interface WatchStatus {
+    active: boolean;
+    repository?: WatchRepository;
+    lock?: WatchLock;
+    connected_clients?: number;
+}
+export interface WatchRepresentationSummary {
+    repository_id: number;
+    raw_graph_hash?: string;
+    filter_settings_hash?: string;
+    representation_hash?: string;
+    last_status?: string;
+    last_started_at?: string;
+    last_finished_at?: string;
+    elements_created: number;
+    elements_updated: number;
+    connectors_created: number;
+    connectors_updated: number;
+    views_created: number;
+    diffs?: WatchDiff[];
+}
+export interface WatchContextActionResponse {
+    repository_id: number;
+    action: 'show' | 'hide' | 'clean' | string;
+    policies_created: number;
+    policies_updated: number;
+    policies_deactivated: number;
+    owners_affected: number;
+    tier_before: number;
+    tier_after: number;
+    max_tier: number;
+    elements_added: number;
+    connectors_added: number;
+    views_added: number;
+    elements_removed: number;
+    connectors_removed: number;
+    views_removed: number;
+    representation: {
+        repository_id: number;
+        representation_run_id: number;
+        filter_run_id: number;
+        raw_graph_hash: string;
+        filter_settings_hash: string;
+        representation_hash: string;
+    };
+    summary: WatchRepresentationSummary;
+}
+export interface WatchEvent {
+    type: string;
+    repository_id?: number;
+    message?: string;
+    at: string;
+    data?: unknown;
+    phase?: string;
+    watcher_mode?: string;
+    languages?: string[];
+    changed_files?: number;
+    warnings?: string[];
+}
+export interface WatchVersion {
+    id: number;
+    repository_id: number;
+    commit_hash: string;
+    commit_message?: string;
+    parent_commit_hash?: string;
+    branch?: string;
+    representation_hash: string;
+    workspace_version_id?: number;
+    created_at: string;
+}
+export interface WatchDiff {
+    id: number;
+    version_id: number;
+    owner_type: string;
+    owner_key: string;
+    change_type: string;
+    before_hash?: string;
+    after_hash?: string;
+    resource_type?: string;
+    resource_id?: number;
+    language?: string;
+    summary?: string;
+    added_lines?: number;
+    removed_lines?: number;
+}
+export interface WorkspaceVersion {
+    id: string;
+    version_id: string;
+    source: string;
+    parent_version_id?: string;
+    view_count: number;
+    element_count: number;
+    connector_count: number;
+    description?: string;
+    workspace_hash?: string;
+    created_at: string;
+}
+export type SourceEditor = 'zed' | 'vscode';
 export declare const api: {
     system: {
         ready: () => Promise<{
@@ -32,12 +148,24 @@ export declare const api: {
         create: (data: Partial<LibraryElement>) => Promise<LibraryElement>;
         update: (id: number, data: Partial<LibraryElement>) => Promise<LibraryElement>;
         delete: (_orgId: string, id: number) => Promise<void>;
+        merge: (sourceId: number, survivorId: number, resolved: Partial<{
+            kind: string | null;
+            description: string | null;
+            repo: string | null;
+            branch: string | null;
+            file_path: string | null;
+            language: string | null;
+        }>) => Promise<{
+            survivor: LibraryElement;
+            deleted_id: number;
+        }>;
         placements: (id: number) => Promise<ViewPlacement[]>;
     };
     workspace: {
         orgs: {
             tagColors: {
-                list: () => Promise<Tag[]>;
+                list: () => Promise<Record<string, Tag>>;
+                update: (name: string, color: string, description?: string | null) => Promise<void>;
             };
         };
         elements: {
@@ -75,6 +203,17 @@ export declare const api: {
                 limit?: number;
                 offset?: number;
             }) => Promise<ViewTreeNode[]>;
+            treeAround: (viewId: number, opts?: {
+                ancestorLevels?: number;
+                descendantLevels?: number;
+            }) => Promise<ViewTreeNode[]>;
+            gridData: () => Promise<{
+                views: ViewTreeNode[];
+                content: Record<number, {
+                    placements: PlacedElement[];
+                    connectors: Connector[];
+                }>;
+            }>;
             get: (id: number) => Promise<ViewTreeNode>;
             create: (data: {
                 name: string;
@@ -87,6 +226,17 @@ export declare const api: {
             }) => Promise<View>;
             rename: (id: number, name: string) => Promise<View>;
             setLevel: (id: number, level: number) => Promise<void>;
+            density: {
+                get: (id: number) => Promise<number>;
+                set: (id: number, densityLevel: number) => Promise<number>;
+            };
+            visibilityOverrides: {
+                list: (id: number) => Promise<VisibilityOverride[]>;
+                set: (id: number, resourceType: VisibilityOverride["resource_type"], resourceId: number, levelDelta: number) => Promise<VisibilityOverride>;
+                promote: (id: number, resourceType: VisibilityOverride["resource_type"], resourceId: number) => Promise<VisibilityOverride>;
+                demote: (id: number, resourceType: VisibilityOverride["resource_type"], resourceId: number) => Promise<VisibilityOverride>;
+                reset: (id: number, resourceType: VisibilityOverride["resource_type"], resourceId: number) => Promise<void>;
+            };
             delete: (_orgId: string, id: number) => Promise<void>;
             thumbnail: (id: number) => Promise<string | null>;
             placements: {
@@ -136,7 +286,11 @@ export declare const api: {
         };
     };
     dependencies: {
-        list: () => Promise<DependenciesResponse>;
+        list: (params?: {
+            limit?: number;
+            offset?: number;
+            search?: string;
+        }) => Promise<DependenciesResponse>;
     };
     explore: {
         load: () => Promise<ExploreData & {
@@ -160,4 +314,31 @@ export declare const api: {
             warnings: string[];
         }>;
     };
+    versions: {
+        list: (limit?: number) => Promise<WorkspaceVersion[]>;
+    };
+    watch: {
+        status: () => Promise<WatchStatus>;
+        websocketUrl: () => string;
+        repositories: () => Promise<WatchRepository[]>;
+        versions: (repositoryId: number) => Promise<WatchVersion[]>;
+        diffs: (versionId: number, filters?: {
+            owner_type?: string;
+            change_type?: string;
+            resource_type?: string;
+            language?: string;
+        }) => Promise<WatchDiff[]>;
+        cleanContext: (repositoryId: number, input: {
+            resource_type: "element" | "view";
+            resource_id: number;
+        }) => Promise<WatchContextActionResponse>;
+    };
+    editor: {
+        open: (input: {
+            editor: SourceEditor;
+            repo?: string | null;
+            file_path: string;
+            line?: number | null;
+        }) => Promise<void>;
+    };
 };

package/dist/components/ConnectorPanel.d.ts

@@ -8,6 +8,10 @@ export interface ConnectorPanelProps extends ConnectorPanelSlots {
     onSave: (connector: Connector) => void;
     autoSave?: boolean;
     onDelete: (edgeId: number) => void;
+    visibilityOverrideDelta?: number;
+    onPromoteVisibility?: (id: number) => Promise<void> | void;
+    onDemoteVisibility?: (id: number) => Promise<void> | void;
+    onResetVisibility?: (id: number) => Promise<void> | void;
     hasBackdrop?: boolean;
 }
 /**
@@ -16,6 +20,6 @@ export interface ConnectorPanelProps extends ConnectorPanelSlots {
  * Location: Right side of the screen on desktop. Overlays screen on mobile.
  * Aliases: Connector Properties, Connector Details.
  */
-declare function ConnectorPanel({ isOpen, onClose, connector, orgId, onSave, autoSave, onDelete, hasBackdrop, connectorPanelAfterContentSlot }: ConnectorPanelProps): import("react/jsx-runtime").JSX.Element;
+declare function ConnectorPanel({ isOpen, onClose, connector, orgId, onSave, autoSave, onDelete, visibilityOverrideDelta, onPromoteVisibility, onDemoteVisibility, onResetVisibility, hasBackdrop, connectorPanelAfterContentSlot }: ConnectorPanelProps): import("react/jsx-runtime").JSX.Element;
 declare const _default: import("react").MemoExoticComponent<typeof ConnectorPanel>;
 export default _default;

package/dist/components/CrossBranchControls.d.ts

@@ -1,9 +1,10 @@
-import type { CrossBranchContextSettings } from '../crossBranch/types';
+import type { CrossBranchConnectorPriority, CrossBranchContextSettings } from '../crossBranch/types';
 interface Props {
     settings: CrossBranchContextSettings;
     onEnabledChange: (enabled: boolean) => void;
-    onDepthChange: (depth: number) => void;
+    onBudgetChange: (budget: number) => void;
+    onPriorityChange: (priority: CrossBranchConnectorPriority) => void;
     label?: string;
 }
-export default function CrossBranchControls({ settings, onEnabledChange, onDepthChange, label, }: Props): import("react/jsx-runtime").JSX.Element;
+export default function CrossBranchControls({ settings, onEnabledChange, onBudgetChange, onPriorityChange, label, }: Props): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/ElementNode.d.ts

@@ -39,6 +39,11 @@ interface NodeData extends PlacedElement {
         selected: boolean;
     }[];
     isConnectorHighlighted?: boolean;
+    versionChangeType?: 'added' | 'updated' | 'deleted' | 'initialized';
+    versionLineDelta?: {
+        added: number;
+        removed: number;
+    };
 }
 interface Props {
     data: NodeData;

package/dist/components/ElementPanel.d.ts

@@ -8,6 +8,11 @@ export interface ElementPanelProps extends ElementPanelSlots {
     autoSave?: boolean;
     onDelete?: (id: number) => void;
     onPermanentDelete?: (id: number) => void;
+    onMerge?: (id: number) => void;
+    visibilityOverrideDelta?: number;
+    onPromoteVisibility?: (id: number) => Promise<void> | void;
+    onDemoteVisibility?: (id: number) => Promise<void> | void;
+    onResetVisibility?: (id: number) => Promise<void> | void;
     orgId?: string;
     links?: ViewConnector[];
     parentLinks?: ViewConnector[];
@@ -20,6 +25,6 @@ export interface ElementPanelProps extends ElementPanelSlots {
  * Location: Right side of the screen on desktop. Overlays screen on mobile.
  * Aliases: Element Properties, Element Details.
  */
-declare function ElementPanel({ isOpen, onClose, element, onSave, autoSave, onDelete, onPermanentDelete, orgId, links, parentLinks, hasBackdrop, availableTags, elementPanelAfterContentSlot }: ElementPanelProps): import("react/jsx-runtime").JSX.Element;
+declare function ElementPanel({ isOpen, onClose, element, onSave, autoSave, onDelete, onPermanentDelete, onMerge, visibilityOverrideDelta, onPromoteVisibility, onDemoteVisibility, onResetVisibility, orgId, links, parentLinks, hasBackdrop, availableTags, elementPanelAfterContentSlot }: ElementPanelProps): import("react/jsx-runtime").JSX.Element;
 declare const _default: import("react").MemoExoticComponent<typeof ElementPanel>;
 export default _default;

package/dist/components/LayoutSection.d.ts

@@ -2,6 +2,7 @@ import type { ViewTreeNode } from '../types';
 interface Props {
     view: ViewTreeNode | null;
     canEdit: boolean;
+    onUnsupportedMutation?: () => void;
 }
-export default function LayoutSection({ view, canEdit }: Props): import("react/jsx-runtime").JSX.Element;
+export default function LayoutSection({ view, canEdit, onUnsupportedMutation }: Props): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/MergeDialog.d.ts

@@ -0,0 +1,16 @@
+import type { LibraryElement } from '../types';
+interface MergeDialogProps {
+    isOpen: boolean;
+    onClose: () => void;
+    source: LibraryElement | null;
+    onMerge: (survivorId: number, resolved: {
+        kind: string | null;
+        description: string | null;
+        repo: string | null;
+        branch: string | null;
+        file_path: string | null;
+        language: string | null;
+    }) => Promise<void>;
+}
+export default function MergeDialog({ isOpen, onClose, source, onMerge }: MergeDialogProps): import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/components/MiniZoomOnboarding.d.ts

@@ -1,5 +1,6 @@
 interface Props {
     isVisible: boolean;
+    onClose?: () => void;
 }
-export default function MiniZoomOnboarding({ isVisible }: Props): import("react/jsx-runtime").JSX.Element;
+export default function MiniZoomOnboarding({ isVisible, onClose }: Props): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/NodeContainer.d.ts

@@ -4,5 +4,7 @@ export interface ElementContainerProps extends BoxProps {
     isSource?: boolean;
     isTarget?: boolean;
     isConnectorHighlighted?: boolean;
+    hasStack?: boolean;
+    kind?: string | null;
 }
 export declare const ElementContainer: import("react").MemoExoticComponent<import("@chakra-ui/react").ComponentWithAs<"div", ElementContainerProps>>;

package/dist/components/ProxyConnectorPanel.d.ts

@@ -1,9 +1,12 @@
 import type { ProxyConnectorDetails } from '../crossBranch/types';
+import type { Connector } from '../types';
 interface Props {
     isOpen: boolean;
     onClose: () => void;
     details: ProxyConnectorDetails | null;
     hasBackdrop?: boolean;
+    onEdit?: (connector: Connector) => void;
+    onDelete?: (connectorId: number, ownerViewId: number) => void;
 }
-export default function ProxyConnectorPanel({ isOpen, onClose, details, hasBackdrop, }: Props): import("react/jsx-runtime").JSX.Element;
+export default function ProxyConnectorPanel({ isOpen, onClose, details, hasBackdrop, onEdit, onDelete, }: Props): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/ViewExplorer/index.d.ts

@@ -19,7 +19,7 @@ interface Props {
     tagColors: Record<string, Tag>;
     selectedElement?: LibraryElement | null;
     onUpdateTags?: (elementId: number, tags: string[]) => Promise<void>;
-    onCreateTag: (tag: string, color?: string) => Promise<void>;
+    onCreateTag: (tag: string, color?: string, description?: string) => Promise<void>;
     layers: ViewLayer[];
     onHoverLayer: (tags: string[] | null, color?: string | null) => void;
     onCreateLayer: (name: string, tags: string[], color: string) => Promise<void>;

package/dist/components/ViewFloatingMenu-vscode.d.ts

@@ -12,6 +12,11 @@ interface ViewFloatingMenuProps {
     onImport: () => void;
     onExport: () => void;
     onShare: () => void;
+    canUndo?: boolean;
+    canRedo?: boolean;
+    undoRedoDisabled?: boolean;
+    onUndo?: () => void;
+    onRedo?: () => void;
     isFreePlan: boolean;
     canUpgrade?: boolean;
     activeTags?: string[];

package/dist/components/ViewFloatingMenu.d.ts

@@ -16,6 +16,13 @@ export interface ViewFloatingMenuProps extends ViewFloatingMenuSlots {
     onShare?: () => void;
     focusMode: boolean;
     onFocusModeChange: (enabled: boolean) => void;
+    densityLevel?: number;
+    onDensityLevelChange?: (level: number) => void;
+    canUndo?: boolean;
+    canRedo?: boolean;
+    undoRedoDisabled?: boolean;
+    onUndo?: () => void;
+    onRedo?: () => void;
     allTags: string[];
     layers: ViewLayer[];
     tagColors: Record<string, Tag>;
@@ -36,6 +43,6 @@ export interface ViewFloatingMenuProps extends ViewFloatingMenuSlots {
  * Location: Floating at the bottom center of the editor.
  * Aliases: Bottom bar, Action bar.
  */
-declare function ViewFloatingMenu({ handleAddElementAtCenter, drawingMode, setDrawingMode, hasDrawingPaths, drawingVisible, setDrawingVisible, extrasOpen, setExtrasOpen, disableImportExport, onImport, onExport, focusMode, onFocusModeChange, allTags, layers, tagColors, hiddenTags, toggleTagVisibility, toggleLayerVisibility, tagCounts, layerElementCounts, setHighlightedTags, setHighlightColor, shareSlot, toolbarSlot, hideFocusView, hideExpandExtras, }: ViewFloatingMenuProps): import("react/jsx-runtime").JSX.Element;
+declare function ViewFloatingMenu({ handleAddElementAtCenter, drawingMode, setDrawingMode, hasDrawingPaths, drawingVisible, setDrawingVisible, extrasOpen, setExtrasOpen, disableImportExport, onImport, onExport, focusMode, onFocusModeChange, densityLevel, onDensityLevelChange, canUndo, canRedo, undoRedoDisabled, onUndo, onRedo, allTags, layers, tagColors, hiddenTags, toggleTagVisibility, toggleLayerVisibility, tagCounts, layerElementCounts, setHighlightedTags, setHighlightColor, shareSlot, toolbarSlot, hideFocusView, hideExpandExtras, }: ViewFloatingMenuProps): import("react/jsx-runtime").JSX.Element;
 declare const _default: React.MemoExoticComponent<typeof ViewFloatingMenu>;
 export default _default;

package/dist/components/ViewGridNode.d.ts

@@ -6,6 +6,9 @@ export interface ViewGridNodeData {
         nodes: number;
         edges: number;
     };
+    kind?: 'view' | 'cluster';
+    collapsedCount?: number;
+    dimmed?: boolean;
     focused: boolean;
     canEdit: boolean;
     isEditing: boolean;

package/dist/components/ViewPanel.d.ts

@@ -5,6 +5,7 @@ interface Props {
     view: ViewTreeNode | null;
     canEdit?: boolean;
     onSave: (updated: ViewTreeNode) => void;
+    onUnsupportedMutation?: () => void;
     hasBackdrop?: boolean;
 }
 /**
@@ -13,6 +14,6 @@ interface Props {
  * Location: Right side of the screen on desktop. Overlays screen on mobile.
  * Aliases: View Properties, View Settings.
  */
-declare function ViewPanel({ isOpen, onClose, view, canEdit: canEditProp, onSave, hasBackdrop }: Props): import("react/jsx-runtime").JSX.Element;
+declare function ViewPanel({ isOpen, onClose, view, canEdit: canEditProp, onSave, onUnsupportedMutation, hasBackdrop }: Props): import("react/jsx-runtime").JSX.Element;
 declare const _default: import("react").MemoExoticComponent<typeof ViewPanel>;
 export default _default;

package/dist/components/WorkspacePanel.d.ts

@@ -0,0 +1,2 @@
+export declare const WATCH_REPRESENTATION_UPDATED_EVENT = "tld:watch-representation-updated";
+export default function WorkspacePanel(): import("react/jsx-runtime").JSX.Element;

package/dist/components/ZUI/ZUICanvas.d.ts

@@ -1,8 +1,10 @@
 import type { ExploreData } from '../../types';
 import type { CrossBranchContextSettings } from '../../crossBranch/types';
+import type { WorkspaceVersionFollowTarget, WorkspaceVersionPreview } from '../../context/WorkspaceVersionContext';
 export interface ZUICanvasHandle {
     fitView(): void;
     focusDiagram(viewId: number): boolean;
+    focusElement(viewId: number, elementId: number): boolean;
     setCameraFrame(frame: ZUICameraFrame): boolean;
 }
 export interface ZUICameraFrame {
@@ -14,9 +16,12 @@ interface Props {
     onReady?: () => void;
     onZoom?: () => void;
     onPan?: () => void;
+    initialCameraFrame?: ZUICameraFrame;
     highlightedTags?: string[];
     highlightColor?: string;
     hiddenTags?: string[];
+    versionPreview?: WorkspaceVersionPreview | null;
+    versionFollowTarget?: WorkspaceVersionFollowTarget | null;
     crossBranchSettings: CrossBranchContextSettings;
     hoverLocked?: boolean;
 }

package/dist/components/ZUI/focus.d.ts

@@ -0,0 +1,32 @@
+import type { DiagramGroupLayout, LayoutNode, ZUIViewState } from './types';
+interface Rect {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+export interface ZUIFocusTarget {
+    id: string;
+    label: string;
+    type: 'group' | 'node';
+    isCircular?: boolean;
+    absX: number;
+    absY: number;
+    absW: number;
+    absH: number;
+    absScale: number;
+    node?: LayoutNode;
+    contentRect?: Rect;
+}
+export interface ZUIFocusViewportOptions {
+    preferContent?: boolean;
+    minTargetScreenW?: number;
+    minChildScreenW?: number;
+    keepParentVisible?: boolean;
+}
+export declare function findDiagramFocusTarget(groups: DiagramGroupLayout[], viewId: number): ZUIFocusTarget | null;
+export declare function findElementFocusTarget(groups: DiagramGroupLayout[], viewId: number, elementId: number): ZUIFocusTarget | null;
+export declare function viewportForFocusTarget(target: ZUIFocusTarget, canvasW: number, canvasH: number, maxZoom: number, padding: number, options?: ZUIFocusViewportOptions): ZUIViewState | null;
+export declare function viewportForDiagramFocusTarget(target: ZUIFocusTarget, canvasW: number, canvasH: number, maxZoom: number, isMobileLayout: boolean): ZUIViewState | null;
+export declare function viewportForElementFocusTarget(target: ZUIFocusTarget, canvasW: number, canvasH: number, maxZoom: number, isMobileLayout: boolean): ZUIViewState | null;
+export {};

package/dist/components/ZUI/focus.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/ZUI/layout.d.ts

@@ -1,7 +1,7 @@
 import type { ZUILayout } from './types';
 import type { ExploreData } from '../../types';
-export declare const NODE_W = 200;
-export declare const NODE_H = 100;
+export declare const NODE_W = 180;
+export declare const NODE_H = 85;
 /**
  * Compute the full world-space layout for all diagrams in `data`.
  * Root diagrams are placed side-by-side horizontally.

package/dist/components/ZUI/proxy.d.ts

@@ -1,4 +1,4 @@
-import { type ZUIResolvedConnector } from '../../crossBranch/resolve';
+import { type ZUIHiddenProxyBadge, type ZUIViewportBounds, type ZUIProxyResolution, type ZUIResolvedConnector } from '../../crossBranch/resolve';
 import type { WorkspaceGraphSnapshot } from '../../crossBranch/types';
 import type { LayoutNode, ZUIViewState, HoveredItem } from './types';
 import { type ScreenRect } from './renderer';
@@ -20,6 +20,22 @@ export declare function collectVisibleNodeAnchors(groups: Array<{
     visibleAnchors: Map<number, VisibleNodeAnchor>;
     byNodeId: Map<string, VisibleNodeAnchor>;
 };
-export declare function buildVisibleProxyConnectors(snapshot: WorkspaceGraphSnapshot | null, visibleAnchors: Map<number, VisibleNodeAnchor>, settings: CrossBranchContextSettings): ZUIResolvedConnector[];
-export declare function drawVisibleProxyConnectors(ctx: CanvasRenderingContext2D, connectors: ZUIResolvedConnector[], visibleAnchorsByNodeId: Map<string, VisibleNodeAnchor>, zoom: number, labelBg: string, occupiedLabelRects: ScreenRect[]): void;
-export declare function findHoveredProxyConnector(worldX: number, worldY: number, connectors: ZUIResolvedConnector[], visibleAnchorsByNodeId: Map<string, VisibleNodeAnchor>, view: ZUIViewState): HoveredItem | null;
+interface IndexedProxyConnector {
+    connector: ZUIResolvedConnector;
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+    midX: number;
+    midY: number;
+}
+export interface ProxyConnectorSpatialIndex {
+    cellSize: number;
+    cells: Map<string, IndexedProxyConnector[]>;
+}
+export declare function buildProxyConnectorSpatialIndex(connectors: ZUIResolvedConnector[], visibleAnchorsByNodeId: Map<string, VisibleNodeAnchor>): ProxyConnectorSpatialIndex;
+export declare function buildVisibleProxyConnectors(snapshot: WorkspaceGraphSnapshot | null, visibleAnchors: Map<number, VisibleNodeAnchor>, settings: CrossBranchContextSettings, viewport?: ZUIViewportBounds | null): ZUIProxyResolution;
+export declare function drawVisibleProxyConnectors(ctx: CanvasRenderingContext2D, connectors: ZUIResolvedConnector[], visibleAnchorsByNodeId: Map<string, VisibleNodeAnchor>, zoom: number, labelBg: string, accent: string, occupiedLabelRects: ScreenRect[]): void;
+export declare function drawVisibleDirectProxyBadges(ctx: CanvasRenderingContext2D, badges: ZUIHiddenProxyBadge[], visibleAnchorsByNodeId: Map<string, VisibleNodeAnchor>, zoom: number, labelBg: string, occupiedLabelRects: ScreenRect[]): void;
+export declare function findHoveredProxyConnector(worldX: number, worldY: number, index: ProxyConnectorSpatialIndex, view: ZUIViewState): HoveredItem | null;
+export {};

package/dist/components/ZUI/renderer.d.ts

@@ -1,4 +1,4 @@
-import type { DiagramGroupLayout, ZUIViewState } from './types';
+import type { DiagramGroupLayout, LayoutNode, ZUIViewState } from './types';
 export declare function getExpandThresholds(canvasW: number): {
     start: number;
     end: number;
@@ -13,6 +13,25 @@ export declare function setOnImageLoadCallback(cb: (() => void) | null): void;
 export declare function setHighlightedTags(tags: Set<string>): void;
 export declare function setHighlightColor(color: string): void;
 export declare function setHiddenTags(tags: Set<string>): void;
+export declare function setVersionDiff(elementChanges: Map<number, string>, connectorChanges: Map<number, string>, elementLineDeltas?: Map<number, {
+    added: number;
+    removed: number;
+}>): void;
+export declare function viewOriginX(view: ZUIViewState): number;
+export declare function viewOriginY(view: ZUIViewState): number;
+export declare function worldToScreenX(worldX: number, view: ZUIViewState): number;
+export declare function worldToScreenY(worldY: number, view: ZUIViewState): number;
+export declare function screenToWorldX(screenX: number, view: ZUIViewState): number;
+export declare function screenToWorldY(screenY: number, view: ZUIViewState): number;
+export declare function rawCameraView(view: ZUIViewState): ZUIViewState;
+export interface ZUITransitionRebase {
+    preserveChildAlphaNodeIds: Set<string>;
+}
+export declare function transitionT(screenW: number, start: number, end: number): number;
+export declare function buildCameraTransitionRebase(groups: DiagramGroupLayout[], view: ZUIViewState, canvasW: number, canvasH: number, thresholds: {
+    start: number;
+    end: number;
+}): ZUITransitionRebase;
 export declare function pickEdgeLabelPosition(matrix: DOMMatrix, midX: number, midY: number, textW: number, textH: number, dx: number, dy: number, occupiedLabelRects: ScreenRect[]): {
     x: number;
     y: number;
@@ -21,6 +40,20 @@ export declare function pickEdgeLabelPosition(matrix: DOMMatrix, midX: number, m
 export declare function isVisible(worldX: number, worldY: number, worldW: number, worldH: number, view: ZUIViewState, canvasW: number, canvasH: number): boolean;
 /** Is the rect (in world space) FULLY visible on screen? */
 export declare function isFullyVisible(worldX: number, worldY: number, worldW: number, worldH: number, view: ZUIViewState, canvasW: number, canvasH: number): boolean;
+export interface ZUICameraRebase {
+    originX: number;
+    originY: number;
+    view: ZUIViewState;
+}
+export declare function getCameraRebase(view: ZUIViewState, canvasW: number, canvasH: number): ZUICameraRebase;
+interface FocusedFlattenedLayer {
+    nodes: LayoutNode[];
+    view: ZUIViewState;
+}
+export declare function findFocusedFlattenedLayerForTest(groups: DiagramGroupLayout[], view: ZUIViewState, canvasW: number, canvasH: number, thresholds: {
+    start: number;
+    end: number;
+}, rebase: ZUICameraRebase): FocusedFlattenedLayer | null;
 /**
  * Render a complete frame onto `ctx`.
  * Call this from a `requestAnimationFrame` loop.
@@ -28,3 +61,4 @@ export declare function isFullyVisible(worldX: number, worldY: number, worldW: n
  * `canvasW/canvasH` are CSS-pixel dimensions (the transform handles HiDPI).
  */
 export declare function renderFrame(ctx: CanvasRenderingContext2D, groups: DiagramGroupLayout[], view: ZUIViewState, canvasW: number, canvasH: number): ScreenRect[];
+export {};

package/dist/components/ZUI/types.d.ts

@@ -7,6 +7,10 @@ export interface ZUIViewState {
     y: number;
     /** Current zoom multiplier (1 = 1 world-pixel per screen-pixel). */
     zoom: number;
+    /** World-space X rendered at the local camera origin. Keeps x screen-sized at deep zoom. */
+    originX?: number;
+    /** World-space Y rendered at the local camera origin. Keeps y screen-sized at deep zoom. */
+    originY?: number;
 }
 /**
  * A node in the global world-space layout.
@@ -58,6 +62,7 @@ export interface LayoutNode {
     /** BBox minY used to align children to top-left of node. */
     childOffsetY: number;
     edgesOut: Array<{
+        id: number;
         /** LayoutNode id of the target. */
         targetId: string;
         label: string;
@@ -89,6 +94,7 @@ export interface DiagramGroupLayout {
     nodes: LayoutNode[];
     /** Edges whose both endpoints are in this diagram. */
     edges: Array<{
+        id: number;
         sourceId: string;
         targetId: string;
         label: string;

package/dist/components/ZUI/useZUIInteraction.d.ts

@@ -1,4 +1,5 @@
 import type { BBox, DiagramGroupLayout, ZUIViewState, HoveredItem } from './types';
+export declare function constrainViewState(view: ZUIViewState, canvasW: number, canvasH: number, bbox: BBox): ZUIViewState;
 export declare function calculateMaxZoom(groups: DiagramGroupLayout[], canvasW: number): number;
 export interface ZUIInteraction {
     viewState: ZUIViewState;