likec4 1.48.0 → 1.50.0

package/react/{index.d.ts → index.d.mts}

@@ -1,15 +1,14 @@
-import { AdhocViewPredicate } from '@likec4/core/compute-view';
 import { Align } from '@xyflow/react';
 import { Any } from '@likec4/core/types';
 import { AutoLayoutDirection } from '@likec4/core/types';
 import { aux } from '@likec4/core/types';
 import { BBox } from '@likec4/core/types';
-import { BBox as BBox_2 } from '@likec4/core';
+import { BBox as BBox_2 } from '@likec4/core/geometry';
+import { BBox as BBox_3 } from '@likec4/core';
 import { CamelCasedProperties } from 'type-fest';
 import { Color } from '@likec4/core/types';
 import { ComputedNodeStyle } from '@likec4/core/types';
 import { ComputedNodeStyle as ComputedNodeStyle_2 } from '@likec4/core';
-import { Context as Context_4 } from 'react';
 import { ControlButton } from '@xyflow/react';
 import { Controls } from '@xyflow/react';
 import { CSSProperties } from 'react';
@@ -43,7 +42,6 @@ import { HTMLAttributes } from 'react';
 import { IconUrl } from '@likec4/core/types';
 import { JSX } from 'react/jsx-runtime';
 import { JsxStyleProps } from '@likec4/styles/types';
-import { LayoutedElementView } from '@likec4/core/types';
 import { LayoutedProjectsView } from '@likec4/core/compute-view';
 import { LayoutedView } from '@likec4/core/types';
 import { LayoutType } from '@likec4/core/types';
@@ -51,7 +49,6 @@ import { LikeC4Model } from '@likec4/core/model';
 import { LikeC4Project } from '@likec4/core/types';
 import { LikeC4Styles } from '@likec4/core/styles';
 import { LikeC4ViewModel } from '@likec4/core/model';
-import { MantineThemeOverride } from '@mantine/core';
 import { MarkdownOrString } from '@likec4/core/types';
 import { MarkdownOrString as MarkdownOrString_2 } from '@likec4/core';
 import { MemoExoticComponent } from 'react';
@@ -59,6 +56,7 @@ import { MiniMap } from '@xyflow/react';
 import { MiniMapNode } from '@xyflow/react';
 import { MiniMapNodeProps } from '@xyflow/react';
 import { MotionNodeLayoutOptions } from 'motion/react';
+import { MotionStyle } from 'motion/react';
 import { MouseEvent as MouseEvent_2 } from 'react';
 import { Node as Node_2 } from '@xyflow/react';
 import { NodeChange } from '@xyflow/system';
@@ -96,8 +94,7 @@ import { Simplify } from 'type-fest';
 import { SimplifyDeep } from 'type-fest';
 import { StepEdgeId } from '@likec4/core/types';
 import type * as t from '@likec4/core/types';
-import { UnknownLayouted } from '@likec4/core';
-import { UnknownLayouted as UnknownLayouted_3 } from '@likec4/core/types';
+import { UnknownLayouted as UnknownLayouted_2 } from '@likec4/core/types';
 import { ViewChange } from '@likec4/core/types';
 import { ViewId } from '@likec4/core/types';
 import { ViewId as ViewId_3 } from '@likec4/core';
@@ -541,10 +538,6 @@ declare interface ActorSystemInfo {
     actors: Record<string, AnyActorRef>;
 }
 
-export declare type AdhocViewService = {
-    process: (input: CalcAdhocViewInput) => Promise<CalcAdhocViewOutput>;
-};
-
 declare type AlignmentMode = LinearAlignmentMode | GridAlignmentMode;
 
 declare type Any_2 = t.aux.Any;
@@ -664,14 +657,6 @@ export declare interface BaseNodeProps<N extends BaseNode = BaseNode> extends No
 
 export declare type BaseNodePropsWithData<Data extends Record<string, unknown>> = BaseNodeProps<BaseNode<Data>>;
 
-declare type CalcAdhocViewInput = {
-    predicates: AdhocViewPredicate[];
-};
-
-declare type CalcAdhocViewOutput = {
-    view: LayoutedElementView;
-};
-
 declare interface Clock {
     setTimeout(fn: (...args: any[]) => void, timeout: number): any;
     clearTimeout(id: any): void;
@@ -844,7 +829,7 @@ declare type Context_3 = Readonly<{
     };
     xynodes: RelationshipDetailsTypes.Node[];
     xyedges: RelationshipDetailsTypes.Edge[];
-    bounds: BBox_2;
+    bounds: BBox_3;
 }>;
 
 declare type ContextFactory<TContext extends MachineContext, TActor extends ProvidedActor, TInput, TEvent extends EventObject = EventObject> = ({ spawn, input, self }: {
@@ -857,16 +842,9 @@ declare type ContextFactory<TContext extends MachineContext, TActor extends Prov
 
 export declare function createLikeC4Editor(callbacks: LikeC4EditorCallbacks): LikeC4EditorCallbacks;
 
-export declare type CurrentViewModel = LikeC4ViewModel<UnknownLayouted_2, DiagramView<UnknownLayouted_2>>;
+export declare type CurrentViewModel = LikeC4ViewModel<UnknownLayouted, LayoutedView<UnknownLayouted>>;
 
 declare type Data = {
-    shape: ElementShape_2;
-    width: number;
-    height: number;
-    style?: ComputedNodeStyle;
-};
-
-declare type Data_2 = {
     tags: readonly string[] | null | undefined;
     width: number;
 };
@@ -1048,6 +1026,17 @@ export declare interface DiagramApi<A extends Any_3 = Unknown_2> {
     openRelationshipDetails(...params: [edgeId: EdgeId_3] | [source: Fqn_4<A>, target: Fqn_4<A>]): void;
     updateNodeData(nodeId: NodeId_2, data: PartialDeep<Types.NodeData>): void;
     updateEdgeData(edgeId: EdgeId_3, data: PartialDeep<Types.EdgeData>): void;
+    highlightNode(nodeId: NodeId_2): void;
+    highlightEdge(edgeId: EdgeId_3): void;
+    unhighlightAll(): void;
+    /**
+     * Center viewport on a given node
+     */
+    centerViewportOnNode(target: NodeId_2): void;
+    /**
+     * Center viewport on a given edge (centering on edge means including both source and target nodes in view)
+     */
+    centerViewportOnEdge(target: EdgeId_3): void;
     /**
      * Start editing, either node or edge
      */
@@ -1199,9 +1188,11 @@ export declare type DiagramEmittedEvents = {
 };
 
 declare type DiagramEventHandlersContext = RequiredOrNull<LikeC4DiagramEventHandlers> & {
-    handlersRef: RefObject<Required<LikeC4DiagramEventHandlers>>;
+    handlersRef: DiagramEventHandlersRef;
 };
 
+declare type DiagramEventHandlersRef = RefObject<Required<LikeC4DiagramEventHandlers>>;
+
 export declare type DiagramEvents = HotKeyEvent | MediaPrintEvent | {
     type: 'xyflow.init';
     instance: XYFlowInstance;
@@ -1250,6 +1241,14 @@ export declare type DiagramEvents = HotKeyEvent | MediaPrintEvent | {
     type: 'xyflow.setViewport';
     duration?: number;
     viewport: Viewport;
+} | {
+    type: 'xyflow.centerViewport';
+    nodeId: NodeId;
+    duration?: number;
+} | {
+    type: 'xyflow.centerViewport';
+    edgeId: EdgeId;
+    duration?: number;
 } | {
     type: 'update.nodeData';
     nodeId: NodeId;
@@ -1273,7 +1272,7 @@ export declare type DiagramEvents = HotKeyEvent | MediaPrintEvent | {
     bounds: BBox_2;
 } | {
     type: 'update.inputs';
-    inputs: Partial<Omit<Input, 'view' | 'xystore' | 'dynamicViewVariant'>>;
+    inputs: Partial<Omit<Input, 'view' | 'xystore' | 'dynamicViewVariant' | 'features'>>;
 } | {
     type: 'update.features';
     features: EnabledFeatures;
@@ -1330,6 +1329,14 @@ export declare type DiagramEvents = HotKeyEvent | MediaPrintEvent | {
     direction: 'next' | 'previous';
 } | {
     type: 'walkthrough.end';
+} | {
+    type: 'highlight.node';
+    nodeId: NodeId;
+} | {
+    type: 'highlight.edge';
+    edgeId: EdgeId;
+} | {
+    type: 'unhighlight.all';
 } | {
     type: 'notations.highlight';
     notation: NodeNotation;
@@ -1692,7 +1699,7 @@ export declare const ElementNodeContainer: ForwardRefExoticComponent<{
     [key: `data-${string}`]: string | undefined;
     nodeProps: BaseNodePropsWithData<RequiredData_4>;
     className?: string | undefined;
-    style?: CSSProperties | undefined;
+    style?: MotionStyle | undefined;
 } & MotionNodeLayoutOptions & {
     children?: ReactNode | undefined;
 } & RefAttributes<HTMLDivElement>>;
@@ -1702,16 +1709,16 @@ export declare type ElementNodeProps<A extends Any_5 = Unknown_3> = {
     nodeModel: NodeModel.WithElement<A>;
 };
 
-export declare function ElementShape({ data, width, height, showSeletionOutline }: ElementShapeProps): JSX.Element;
+export declare function ElementShape({ data, width, height, showSelectionOutline }: ElementShapeProps): JSX.Element;
 
 declare type ElementShapeProps = {
-    data: Data;
+    data: RequiredData_5;
     width?: number | undefined;
     height?: number | undefined;
     /**
      * @default true
      */
-    showSeletionOutline?: boolean | undefined;
+    showSelectionOutline?: boolean | undefined;
 };
 
 export declare const ElementTag: ForwardRefExoticComponent<{
@@ -1721,7 +1728,7 @@ export declare const ElementTag: ForwardRefExoticComponent<{
 
 export declare const ElementTags: MemoExoticComponent<({ id, data: { tags, width, hovered }, onTagClick, onTagMouseEnter, onTagMouseLeave }: ElementTagsProps) => JSX.Element | null>;
 
-declare type ElementTagsProps = BaseNodePropsWithData<Data_2> & {
+declare type ElementTagsProps = BaseNodePropsWithData<Data> & {
     onTagClick?: (tag: `#${string}`) => void;
     onTagMouseEnter?: (tag: `#${string}`) => void;
     onTagMouseLeave?: (tag: `#${string}`) => void;
@@ -1815,7 +1822,7 @@ declare type Events_2 = {
 } | {
     type: 'fitDiagram';
     duration?: number;
-    bounds?: BBox_2;
+    bounds?: BBox_3;
 } | {
     type: 'navigate.to';
     subject: Fqn_3;
@@ -1879,7 +1886,7 @@ declare type Events_3 = {
 } | {
     type: 'fitDiagram';
     duration?: number;
-    bounds?: BBox_2;
+    bounds?: BBox_3;
 } | {
     type: 'navigate.to';
     params: {
@@ -1905,7 +1912,7 @@ declare type ExtractEvent<TEvent extends EventObject, TDescriptor extends EventD
 
 export declare type FeatureName = typeof FeatureNames[number];
 
-declare const FeatureNames: readonly ["Controls", "Editor", "ReadOnly", "FocusMode", "NavigateTo", "ElementDetails", "RelationshipDetails", "RelationshipBrowser", "Search", "NavigationButtons", "Notations", "DynamicViewWalkthrough", "FitView", "CompareWithLatest", "Vscode", "ElementTags"];
+declare const FeatureNames: readonly ["Controls", "Editor", "ReadOnly", "FocusMode", "NavigateTo", "ElementDetails", "RelationshipDetails", "RelationshipBrowser", "Search", "NavigationButtons", "Notations", "DynamicViewWalkthrough", "FitView", "CompareWithLatest", "Notes", "Vscode", "ElementTags"];
 
 declare type Fqn_2<A> = t.aux.Fqn<A>;
 
@@ -1915,10 +1922,8 @@ export declare const FramerMotionConfig: ({ reducedMotion, children, }: PropsWit
     /**
      * If true, will respect the device prefersReducedMotion setting by switching
      * transform animations off.
-     *
-     * @public
      */
-    reducedMotion?: "always" | "never" | "user";
+    reducedMotion?: "always" | "never" | "user" | undefined;
 }>) => JSX.Element;
 
 declare type GetConcreteByKey<T, TKey extends keyof T, TValue extends T[TKey]> = T & Record<TKey, TValue>;
@@ -2035,6 +2040,7 @@ declare interface Input {
     fitViewPadding: ViewPaddings;
     where: WhereOperator | null;
     dynamicViewVariant?: DynamicViewDisplayVariant | undefined;
+    features?: EnabledFeatures;
 }
 
 declare type Input_2 = {
@@ -2213,10 +2219,6 @@ declare namespace LayoutResult {
     };
 }
 
-export declare function LikeC4AdHocViewEditor({ service }: {
-    service: AdhocViewService;
-}): JSX.Element;
-
 export declare interface LikeC4BrowserProps {
     /**
      * Background pattern for the browser view.
@@ -2291,6 +2293,12 @@ export declare interface LikeC4BrowserProps {
      * @default true
      */
     enableCompareWithLatest?: boolean | undefined;
+    /**
+     * Display element notes, if they are present in the view
+     *
+     * @default true
+     */
+    enableNotes?: boolean | undefined;
     /**
      * Improve performance by hiding certain elements and reducing visual effects (disable mix-blend, shadows, animations)
      *
@@ -2317,7 +2325,7 @@ export declare type LikeC4ColorScheme = 'light' | 'dark';
  *
  * Use {@link ReactLikeC4} or {@link LikeC4View} for ready-to-use component
  */
-export declare function LikeC4Diagram<A extends Any = Any>({ onCanvasClick, onCanvasContextMenu, onCanvasDblClick, onEdgeClick, onEdgeContextMenu, onNavigateTo, onNodeClick, onNodeContextMenu, onOpenSource, onLogoClick, onLayoutTypeChange, onInitialized, view, className, controls, fitView, fitViewPadding: _fitViewPadding, pannable, zoomable, background, enableElementTags, enableFocusMode, enableElementDetails, enableRelationshipDetails, enableRelationshipBrowser, enableCompareWithLatest, nodesSelectable, enableNotations, showNavigationButtons, enableDynamicViewWalkthrough, dynamicViewVariant, enableSearch, initialWidth, initialHeight, reduceGraphics, renderIcon, where, reactFlowProps, renderNodes, children, }: LikeC4DiagramProps<A>): JSX.Element;
+export declare function LikeC4Diagram<A extends Any = Any>({ onCanvasClick, onCanvasContextMenu, onCanvasDblClick, onEdgeClick, onEdgeContextMenu, onNavigateTo, onNodeClick, onNodeContextMenu, onOpenSource, onLogoClick, onLayoutTypeChange, onInitialized, view, className, controls, fitView, fitViewPadding: _fitViewPadding, pannable, zoomable, background, enableElementTags, enableFocusMode, enableElementDetails, enableRelationshipDetails, enableRelationshipBrowser, enableCompareWithLatest, nodesSelectable, enableNotations, showNavigationButtons, enableDynamicViewWalkthrough, dynamicViewVariant, enableSearch, enableNotes, initialWidth, initialHeight, reduceGraphics, renderIcon, where, reactFlowProps, renderNodes, children, }: LikeC4DiagramProps<A>): JSX.Element;
 
 export declare interface LikeC4DiagramEventHandlers<A extends Any_2 = Unknown> {
     onNavigateTo?: OnNavigateTo<A> | null | undefined;
@@ -2469,6 +2477,12 @@ export declare interface LikeC4DiagramProperties<A extends Any_2 = Unknown> {
      * @default false
      */
     enableElementTags?: boolean | undefined;
+    /**
+     * Display element notes, if they are present in the view
+     *
+     * @default true
+     */
+    enableNotes?: boolean | undefined;
     /**
      * Improve performance by hiding certain elements and reducing visual effects (disable mix-blend, shadows, animations)
      * Enable it if you have a large or static view
@@ -2480,6 +2494,8 @@ export declare interface LikeC4DiagramProperties<A extends Any_2 = Unknown> {
     /**
      * Render icon for an element, bundled or remote
      * By default, if icon is http:// or https://, it will be rendered as an image
+     *
+     * Consider using `IconRendererProvider`
      */
     renderIcon?: ElementIconRenderer | undefined;
     /**
@@ -2545,10 +2561,10 @@ export declare type LikeC4EditorProviderProps = PropsWithChildren<{
 /**
  * Ensures LikeC4Model context
  */
-export declare function LikeC4ModelProvider<A extends aux.Any = aux.Unknown>({ children, likec4model, }: PropsWithChildren<LikeC4ModelProviderProps<A>>): JSX.Element;
+export declare function LikeC4ModelProvider({ children, likec4model, }: PropsWithChildren<LikeC4ModelProviderProps>): JSX.Element;
 
-export declare interface LikeC4ModelProviderProps<A extends aux.Any = aux.Unknown> {
-    likec4model: LikeC4Model<A>;
+export declare interface LikeC4ModelProviderProps {
+    likec4model: LikeC4Model<any>;
 }
 
 declare type LikeC4ProjectsContext = {
@@ -2556,11 +2572,9 @@ declare type LikeC4ProjectsContext = {
     onProjectChange: (id: ProjectId) => void;
 };
 
-declare const LikeC4ProjectsContext: Context_4<LikeC4ProjectsContext | null>;
-
 export declare function LikeC4ProjectsOverview({ view, className, onNavigateToProject, ...props }: LikeC4ProjectsOverviewProps): JSX.Element;
 
-export declare type LikeC4ProjectsOverviewProps = Simplify<Omit<ProjectsOverviewProps, 'id'> & {
+export declare type LikeC4ProjectsOverviewProps = Simplify<ProjectsOverviewProps & {
     className?: string;
     onSelectProject?: ProjectsOverviewProps['onNavigateToProject'];
 }>;
@@ -2590,7 +2604,7 @@ export declare interface LikeC4ProjectsProviderProps {
  *
  * Component is wrapped in ShadowRoot to isolate styles.
  */
-export declare function LikeC4View<A extends t.aux.Any = t.aux.UnknownLayouted>({ viewId, className, pannable, zoomable, keepAspectRatio, colorScheme, injectFontCss, controls, layoutType: initialLayoutType, background, browser, showNavigationButtons, enableNotations, enableFocusMode, enableDynamicViewWalkthrough, enableElementDetails, enableRelationshipDetails, enableRelationshipBrowser, reduceGraphics, mantineTheme, styleNonce, style, reactFlowProps, renderNodes, children, ...props }: LikeC4ViewProps<A>): JSX.Element;
+export declare function LikeC4View<A extends t.aux.Any = t.aux.UnknownLayouted>({ viewId, className, pannable, zoomable, keepAspectRatio, colorScheme, injectFontCss, controls, layoutType: initialLayoutType, background, browser, showNavigationButtons, enableNotations, enableFocusMode, enableDynamicViewWalkthrough, enableElementDetails, enableRelationshipDetails, enableRelationshipBrowser, enableNotes, reduceGraphics, mantineTheme, styleNonce, style, reactFlowProps, renderNodes, children, ...props }: LikeC4ViewProps<A>): JSX.Element;
 
 export declare interface LikeC4ViewProps<A extends t.aux.Any = t.aux.UnknownLayouted> {
     /**
@@ -2727,6 +2741,12 @@ export declare interface LikeC4ViewProps<A extends t.aux.Any = t.aux.UnknownLayo
      * @default enableRelationshipDetails
      */
     enableRelationshipBrowser?: boolean | undefined;
+    /**
+     * Display element notes, if they are present in the view
+     *
+     * @default false
+     */
+    enableNotes?: boolean | undefined;
     /**
      * Improve performance by hiding certain elements and reducing visual effects (disable mix-blend, shadows, animations)
      *
@@ -3002,7 +3022,7 @@ declare type Observer<T> = {
  */
 export declare type OnCanvasClick = (event: MouseEvent_2) => void;
 
-declare type OnCanvasContextMenu = (event: MouseEvent_2 | MouseEvent) => void;
+declare type OnCanvasContextMenu = (event: MouseEvent_2) => void;
 
 export declare type OnEdgeClick<A extends Any_2 = Unknown> = (edge: DiagramEdge<A>, event: MouseEvent_2) => void;
 
@@ -3177,7 +3197,7 @@ declare type PickEmittedEvent<T> = T extends DiagramEmittedEvents['type'] ? Diag
  * Picks appropriate bounds from the view,
  * depending on its type and dynamic variant
  */
-export declare function pickViewBounds(view: LayoutedView, dynamicVariant?: DynamicViewDisplayVariant): BBox;
+export declare function pickViewBounds(view: LayoutedView, dynamicVariant?: DynamicViewDisplayVariant): BBox_2;
 
 /**
  * PortalToContainer is used to render elements outside the LikeC4DiagramXYFlow, but inside the container.
@@ -3422,6 +3442,13 @@ declare type RequiredData_4 = {
     style?: ComputedNodeStyle;
 };
 
+declare type RequiredData_5 = {
+    shape: ElementShape_2;
+    width: number;
+    height: number;
+    style?: ComputedNodeStyle;
+};
+
 declare type RequiredLogicInput<TLogic extends AnyActorLogic> = undefined extends InputFrom<TLogic> ? never : 'input';
 
 declare type RequiredOrNull<T> = {
@@ -3468,11 +3495,17 @@ declare type SearchActorEvent = {
 } | {
     type: 'pickview.open';
     elementFqn: Fqn;
+} | {
+    type: 'navigate.to';
+    viewId: ViewId;
+    focusOnElement?: Fqn | undefined;
+} | {
+    type: 'animation.presence.end';
 } | {
     type: 'pickview.close';
 };
 
-declare interface SearchActorLogic extends StateMachine<SearchContext, SearchActorEvent, {}, any, any, any, any, 'inactive' | 'opened' | 'pickView', never, never, any, any, any, any> {
+declare interface SearchActorLogic extends StateMachine<SearchContext, SearchActorEvent, {}, any, any, any, any, 'inactive' | 'opened' | 'pickView' | 'waitAnimationEnd', never, never, any, any, any, any> {
 }
 
 declare interface SearchActorRef extends ActorRef<SearchActorSnapshot, SearchActorEvent> {
@@ -3484,6 +3517,10 @@ declare interface SearchContext {
     openedWithSearch: string | null;
     searchValue: string;
     pickViewFor: Fqn | null;
+    navigateTo: {
+        viewId: ViewId;
+        focusOnElement?: Fqn | undefined;
+    } | null;
 }
 
 export declare function SequenceActorNode(props: Types.NodeProps<'seq-actor'>): JSX.Element;
@@ -3519,7 +3556,11 @@ declare const ShadowRoot_2: ForwardRefExoticComponent<HTMLAttributes<HTMLDivElem
         width: number;
         height: number;
     };
-    theme?: MantineThemeOverride | undefined;
+    /**
+     * Mantine theme override to apply within the shadow root
+     * @see https://mantine.dev/theming/mantine-provider/#theme-prop
+     */
+    theme?: any;
 } & RefAttributes<HTMLDivElement>>;
 export { ShadowRoot_2 as ShadowRoot }
 
@@ -4060,7 +4101,7 @@ declare type TransitionsConfig<TContext extends MachineContext, TEvent extends E
 declare type TransitionTarget = SingleOrArray<string>;
 
 export declare namespace Types {
-    export type LeafNodeData = Simplify<BaseNodeData & NonOptional<Pick<DiagramNode, 'id' | 'title' | 'technology' | 'description' | 'color' | 'shape' | 'width' | 'level' | 'height' | 'style' | 'tags' | 'x' | 'y'>> & {
+    export type LeafNodeData = Simplify<BaseNodeData & NonOptional<Pick<DiagramNode, 'id' | 'title' | 'technology' | 'description' | 'notes' | 'color' | 'shape' | 'width' | 'level' | 'height' | 'style' | 'tags' | 'x' | 'y'>> & {
         /**
          * View layout direction, used by DefaultHandles to position node handles
          */
@@ -4109,7 +4150,7 @@ export declare namespace Types {
     export type SequenceParallelAreaData = Simplify<LeafNodeData & {
         parallelPrefix: string;
     }>;
-    export type CompoundNodeData = Simplify<BaseNodeData & NonOptional<Pick<DiagramNode, 'id' | 'title' | 'color' | 'shape' | 'style' | 'tags' | 'x' | 'y'>> & {
+    export type CompoundNodeData = Simplify<BaseNodeData & NonOptional<Pick<DiagramNode, 'id' | 'title' | 'notes' | 'color' | 'shape' | 'style' | 'tags' | 'x' | 'y'>> & {
         /**
          * View layout direction, used by DefaultHandles to position node handles
          */
@@ -4225,12 +4266,12 @@ declare type UnknownGuard = UnknownReferencedGuard | UnknownInlineGuard;
 
 declare type UnknownInlineGuard = Guard<MachineContext, EventObject, undefined, ParameterizedObject>;
 
-declare type UnknownLayouted_2 = t.aux.UnknownLayouted;
+declare type UnknownLayouted = t.aux.UnknownLayouted;
 
 declare type UnknownReferencedGuard = Guard<MachineContext, EventObject, ParameterizedObject['params'], ParameterizedObject>;
 
 /**
- * @returns The callback to change current project.
+ * @returns The callback to change current project, or a no-op if no LikeC4ProjectsProvider is found.
  */
 export declare function useChangeLikeC4Project(): (id: ProjectId) => void;
 
@@ -4254,7 +4295,7 @@ export declare function useCurrentViewId(): ViewId;
  */
 export declare function useCurrentViewModel(): CurrentViewModel;
 
-export declare function useDiagram(): DiagramApi< UnknownLayouted>;
+export declare function useDiagram(): DiagramApi;
 
 export declare function useDiagramActorRef(): DiagramActorRef;
 
@@ -4272,11 +4313,16 @@ export declare function useEnabledFeatures(): EnabledFeatures;
  */
 export declare function useHasProjects(): boolean;
 
+/**
+ * @returns The LikeC4Model from context.
+ * @throws If no LikeC4ModelProvider is found.
+ */
 export declare function useLikeC4Model<A extends Any_4 = t.aux.UnknownLayouted>(): LikeC4Model<A>;
 
 /**
  * Returns current LikeC4 project.
- * Requires both LikeC4ModelProvider and LikeC4ProjectsProvider in the tree.*
+ * Requires LikeC4ModelProvider in the tree.
+ * Falls back to model's project if LikeC4ProjectsProvider is not available.
  */
 export declare function useLikeC4Project(): LikeC4Project;
 
@@ -4290,9 +4336,6 @@ export declare function useLikeC4ProjectId(): ProjectId;
  */
 export declare function useLikeC4Projects(): ReadonlyArray<LikeC4Project>;
 
-/**
- * @returns The callback to change current project.
- */
 export declare function useLikeC4ProjectsContext(): LikeC4ProjectsContext;
 
 export declare function useLikeC4Specification(): t.Specification<t.aux.UnknownLayouted>;
@@ -4314,13 +4357,12 @@ export declare function useOnDiagramEvent<T extends DiagramEmittedEvents['type']
     once?: boolean;
 }): void;
 
-/**
- * Returns the current view model from the context, or null if no view model is found.
- * @see useCurrentViewModel
- */
 export declare function useOptionalCurrentViewModel(): CurrentViewModel | null;
 
-export declare function useOptionalLikeC4Model<A extends Any_4 = t.aux.UnknownLayouted>(): LikeC4Model<A> | null;
+/**
+ * @returns The LikeC4Model from context, or null if no LikeC4ModelProvider is found.
+ */
+export declare function useOptionalLikeC4Model<A extends t.aux.Any = UnknownLayouted>(): LikeC4Model<A> | null;
 
 /**
  * Differs from useState in that:
@@ -4389,7 +4431,7 @@ declare type ViewId_4<A> = t.aux.ViewId<A>;
  */
 export declare type ViewPadding = PaddingWithUnit | ViewPaddings;
 
-declare type ViewPaddings = {
+export declare type ViewPaddings = {
     top?: PaddingWithUnit;
     right?: PaddingWithUnit;
     bottom?: PaddingWithUnit;