likec4 1.51.0 → 1.52.0

package/react/index.d.mts

@@ -9,6 +9,7 @@ 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';
@@ -28,17 +29,20 @@ import { EdgeId as EdgeId_2 } from '@likec4/core';
 import { EdgeProps } from '@xyflow/react';
 import { EffectCallback } from 'react';
 import { ElementKind } from '@likec4/core/types';
+import { ElementProps } from '@mantine/core';
 import { ElementShape as ElementShape_2 } from '@likec4/core/types';
 import { ElementStyle } from '@likec4/core/types';
 import { Except } from 'type-fest';
 import { ExclusiveUnion } from '@likec4/core/types';
 import { ExclusiveUnion as ExclusiveUnion_2 } from '@likec4/core';
 import { FC } from 'react';
+import { ForwardRefComponent } from 'motion/react';
 import { ForwardRefExoticComponent } from 'react';
 import { Fqn } from '@likec4/core/types';
 import { Fqn as Fqn_3 } from '@likec4/core';
 import { FunctionComponent } from 'react';
 import { HTMLAttributes } from 'react';
+import { HTMLMotionProps } from 'motion/react';
 import { IconUrl } from '@likec4/core/types';
 import { JSX } from 'react/jsx-runtime';
 import { JsxStyleProps } from '@likec4/styles/types';
@@ -58,6 +62,7 @@ import { MiniMapNodeProps } from '@xyflow/react';
 import { MotionNodeLayoutOptions } from 'motion/react';
 import { MotionStyle } from 'motion/react';
 import { MouseEvent as MouseEvent_2 } from 'react';
+import { NavigationPanelRecipe } from '@likec4/styles/recipes';
 import { Node as Node_2 } from '@xyflow/react';
 import { NodeChange } from '@xyflow/system';
 import { NodeChange as NodeChange_2 } from '@xyflow/react';
@@ -93,8 +98,11 @@ import { SetRequired } from 'type-fest';
 import { Simplify } from 'type-fest';
 import { SimplifyDeep } from 'type-fest';
 import { StepEdgeId } from '@likec4/core/types';
+import { StyleContextConsumer } from '@likec4/styles/jsx';
+import { StyleContextProvider } from '@likec4/styles/jsx';
 import type * as t from '@likec4/core/types';
 import { UnknownLayouted as UnknownLayouted_2 } from '@likec4/core/types';
+import { UnstyledButtonProps } from '@mantine/core';
 import { ViewChange } from '@likec4/core/types';
 import { ViewId } from '@likec4/core/types';
 import { ViewId as ViewId_3 } from '@likec4/core';
@@ -2962,6 +2970,14 @@ declare interface NavigationHistoryEntry_2 {
     activeWalkthrough?: null | StepEdgeId;
 }
 
+export declare const NavigationPanel: {
+    Root: StyleContextProvider<ForwardRefComponent<"div", HTMLMotionProps<"div">>, NavigationPanelRecipe>;
+    Body: StyleContextConsumer<ForwardRefComponent<"div", HTMLMotionProps<"div">>>;
+    Logo: StyleContextConsumer<ForwardRefExoticComponent<HTMLAttributes<HTMLButtonElement> & RefAttributes<HTMLButtonElement>>>;
+    Label: StyleContextConsumer<ForwardRefComponent<"div", HTMLMotionProps<"div">>>;
+    Dropdown: StyleContextConsumer<ForwardRefComponent<"div", HTMLMotionProps<"div">>>;
+};
+
 declare type NodeId_2 = t.aux.NodeId;
 
 export declare type NodeRenderers = Partial<CamelCasedProperties<Types.NodeRenderers>>;
@@ -3011,6 +3027,12 @@ declare type NoRequiredParams<T extends ParameterizedObject> = T extends any ? u
 
 declare type NormalizeDescriptor<TDescriptor extends string> = TDescriptor extends '*' ? string : TDescriptor extends `${infer TLeading}.*` ? `${TLeading}.${string}` : TDescriptor;
 
+/**
+ * Normalize a raw search string for comparison.
+ * Extracted as a pure function so both XState and standalone adapters can reuse it.
+ */
+export declare function normalizeSearch(value: string): string;
+
 declare type Observer<T> = {
     next?: (value: T) => void;
     error?: (err: unknown) => void;
@@ -3505,7 +3527,7 @@ declare type SearchActorEvent = {
     type: 'pickview.close';
 };
 
-declare interface SearchActorLogic extends StateMachine<SearchContext, SearchActorEvent, {}, any, any, any, any, 'inactive' | 'opened' | 'pickView' | 'waitAnimationEnd', never, never, any, any, any, any> {
+declare interface SearchActorLogic extends StateMachine<SearchContext_2, SearchActorEvent, {}, any, any, any, any, 'inactive' | 'opened' | 'pickView' | 'waitAnimationEnd', never, never, any, any, any, any> {
 }
 
 declare interface SearchActorRef extends ActorRef<SearchActorSnapshot, SearchActorEvent> {
@@ -3513,7 +3535,11 @@ declare interface SearchActorRef extends ActorRef<SearchActorSnapshot, SearchAct
 
 declare type SearchActorSnapshot = SnapshotFrom<SearchActorLogic>;
 
-declare interface SearchContext {
+export declare const searchBodyCss: string;
+
+export declare const SearchContext: Context_4<SearchContextValue | null>;
+
+declare interface SearchContext_2 {
     openedWithSearch: string | null;
     searchValue: string;
     pickViewFor: Fqn | null;
@@ -3523,6 +3549,32 @@ declare interface SearchContext {
     } | null;
 }
 
+export declare interface SearchContextValue {
+    searchValue: string;
+    setSearchValue: (value: string) => void;
+    normalizedSearch: string;
+    navigateTo: (viewId: ViewId, focusOnElement?: Fqn) => void;
+    openPickView: (elementFqn: Fqn) => void;
+    closePickView: () => void;
+    pickViewFor: Fqn | null;
+    close: () => void;
+    currentViewId: string | null;
+    openedWithSearch: string | null;
+}
+
+export declare function SearchControl({ className, ...others }: SearchControlProps): JSX.Element;
+
+declare interface SearchControlProps extends UnstyledButtonProps, ElementProps<'button'> {
+}
+
+export declare const searchDialogCss: string;
+
+/**
+ * The shared search panel content used by both diagram and overview search.
+ * Must be rendered inside a SearchContext.Provider.
+ */
+export declare const SearchPanelContent: MemoExoticComponent<() => JSX.Element>;
+
 export declare function SequenceActorNode(props: Types.NodeProps<'seq-actor'>): JSX.Element;
 
 export declare function sequenceActorNode<A extends Any_5 = Unknown_3>(component: FC<SequenceActorNodeProps<A>>): Types.NodeRenderer<'seq-actor'>;
@@ -4364,6 +4416,8 @@ export declare function useOptionalCurrentViewModel(): CurrentViewModel | null;
  */
 export declare function useOptionalLikeC4Model<A extends t.aux.Any = UnknownLayouted>(): LikeC4Model<A> | null;
 
+export declare function useSearchContext(): SearchContextValue;
+
 /**
  * Differs from useState in that:
  * - it uses custom equal function (shallowEqual by default) to determine whether the state has changed.