likec4 1.59.2 → 1.59.3

package/react/index.d.mts

@@ -1240,6 +1240,33 @@ export declare class DiagramApi<A extends Any_3 = Unknown_2> {
     toggleSequenceFlow(flowId: t.StepPath): void;
 }
 
+/**
+ * Manual-layout actions exposed by {@link useDiagramCompareLayout}.
+ */
+export declare type DiagramCompareLayoutOps = {
+    /**
+     * Toggles the compare mode on or off.
+     */
+    toggleCompare: (force?: 'on' | 'off') => void;
+    /**
+     * Switches the layout type between 'auto' and 'manual'.
+     */
+    switchLayout: (layoutType: t.LayoutType) => void;
+    /**
+     * Merges the latest layout into the manual layout.
+     */
+    applyLatestToManual: () => void;
+    /**
+     * Resets the manual layout to its default state.
+     */
+    resetManualLayout: () => void;
+};
+
+/**
+ * Current manual-layout comparison state exposed by {@link useDiagramCompareLayout}.
+ */
+export declare type DiagramCompareLayoutState = ReturnType<typeof selectCompareLayoutState>;
+
 export declare function DiagramContext({ input }: {
     input: Input_4;
 }): DiagramContext;
@@ -1835,6 +1862,7 @@ declare namespace EditorCalls {
         type Output = {
             requested: t.ViewChange[];
             applied: t.ViewChange[];
+            waitForViewSync: boolean;
         };
     }
 }
@@ -3044,8 +3072,27 @@ export declare interface LikeC4EditorCallbacks {
     fetchView(viewId: t.ViewId, layout?: t.LayoutType): t.LayoutedView | Promise<t.LayoutedView>;
     /**
      * Callback invoked when the view changes.
+     *
+     * Return `{ waitForViewSync: false }` when the integration applies the
+     * change locally and will not publish a refreshed view. When changes are
+     * batched, the editor waits if any callback invocation expects a refresh.
+     */
+    handleChange(viewId: t.ViewId, change: t.ViewChange): void | LikeC4EditorChangeResult | Promise<void | LikeC4EditorChangeResult>;
+}
+
+/**
+ * Result of applying a change from the LikeC4 Editor.
+ */
+export declare interface LikeC4EditorChangeResult {
+    /**
+     * Whether applying the change will publish a refreshed view to the diagram
+     * that the editor should wait for.
+     *
+     * Returning no result from `handleChange` defaults this to `true`,
+     * preserving the existing behavior for integrations that persist changes
+     * through an external model service.
      */
-    handleChange(viewId: t.ViewId, change: t.ViewChange): void | Promise<void>;
+    waitForViewSync: boolean;
 }
 
 /**
@@ -4173,6 +4220,24 @@ selector: (snapshot: A) => B,
 compare: (a: B, b: B) => boolean
 ];
 
+declare const selectCompareLayoutState: ({ context }: DiagramActorSnapshot) => {
+    isEnabled: false;
+    hasEditor: false;
+    isEditable: false;
+    isActive: false;
+    drifts: null;
+    canApplyLatest: boolean;
+    layout: t.LayoutType;
+} | {
+    isEnabled: true;
+    hasEditor: boolean;
+    isEditable: boolean;
+    isActive: boolean;
+    drifts: readonly [t.LayoutedViewDriftReason, ...t.LayoutedViewDriftReason[]];
+    canApplyLatest: boolean;
+    layout: t.LayoutType;
+};
+
 export declare const selectDiagramContext: <T>(select: (state: DiagramContext) => T, compare?: ((old: NoInfer<T>, next: NoInfer<T>) => boolean) | undefined) => SelectAndCompare< MachineSnapshot<DiagramContext, DiagramEvents, {
     overlays: OverlaysActorRef | undefined;
     search: SearchActorRef | undefined;
@@ -5038,6 +5103,16 @@ export declare function useDiagram(): DiagramApi;
 
 export declare const useDiagramActorRef: () => DiagramActorRef;
 
+/**
+ * Controls LikeC4's manual-layout comparison from custom diagram children.
+ *
+ * The hook must be called by a component rendered inside {@link LikeC4Diagram}.
+ */
+export declare function useDiagramCompareLayout(): [
+DiagramCompareLayoutState,
+DiagramCompareLayoutOps
+];
+
 /**
  * Read diagram context
  * @deprecated use {@link useDiagramSelector}