ChatConnectionState

Feedback & Status

전송 연결 상태를 알리는 배너.

Usage

소켓·SSE 연결이 끊기거나 재연결될 때 상태 배너로 알릴 때 사용한다.

import

import { ChatConnectionState } from '@mildang/design-system/unofficial/Chat';

예제를 복사해 쓸 때 필요한 준비

• @mildang/styled-system 은 이 저장소에서 Panda 가 생성하는 산출물이다. 저장소 안에서는 turbo run ship 이후 쓸 수 있고, 패키지 소비자는 자기 Panda 산출물이나 다른 레이아웃 수단으로 바꿔야 한다.

API Reference

ChatConnectionState Props

Prop

Type

Default

phase

필수

"online" | "dropped" | "reconnecting" | "resumed"

지정 안 함

attempt

number

지정 안 함

labels

Partial<ChatConnectionStateLabels>

지정 안 함

onRetry

() => void

지정 안 함

resumedTokens

number

지정 안 함

같은 패밀리

@mildang/design-system/unofficial/Chat 에서 같이 내보내는 컴포넌트다.

ChatAgentStatus

에이전트의 현재 작업 상태를 알리는 한 줄 표시.

ChatConfidenceMarker

답변 신뢰도를 등급으로 표시하는 마커.

ChatContextDisplay

컨텍스트 사용량을 게이지로 보여주는 표시.

ChatJobProgress

가중치 기반 다단계 작업 진행률 표시.

ChatLoadingState

앱이 tick을 넘겨 구동하는 생성 대기 애니메이션.

ChatMessageTiming

메시지 생성 소요·속도를 값만 그리는 계측 표시.

ChatTypingIndicator

점 3개로 답변 작성 중임을 알리는 인디케이터.

MessageError

메시지 오류 상태를 알리는 배너.

TextShimmer

텍스트 위로 하이라이트가 흐르는 로딩 라벨.

예제

연결 끊김

코드

Open in Playground

import type { ComponentProps } from 'react';
import { ChatConnectionState } from '@mildang/design-system/unofficial/Chat';
type Props = ComponentProps<typeof ChatConnectionState>;
const DEFAULT_ARGS: Props = { phase: 'dropped', onRetry: () => {} };
export default function ConnectionStateDroppedExample(props: Partial<Props> = {}) { return <ChatConnectionState {...DEFAULT_ARGS} {...props} />; }

재연결 중

코드

Open in Playground

import type { ComponentProps } from 'react';
import { ChatConnectionState } from '@mildang/design-system/unofficial/Chat';
type Props = ComponentProps<typeof ChatConnectionState>;
const DEFAULT_ARGS: Props = { phase: 'reconnecting', attempt: 3 };
export default function ConnectionStateReconnectingExample(props: Partial<Props> = {}) { return <ChatConnectionState {...DEFAULT_ARGS} {...props} />; }

재개됨

코드

Open in Playground

import type { ComponentProps } from 'react';
import { ChatConnectionState } from '@mildang/design-system/unofficial/Chat';
type Props = ComponentProps<typeof ChatConnectionState>;
const DEFAULT_ARGS: Props = { phase: 'resumed', resumedTokens: 1284 };
export default function ConnectionStateResumedExample(props: Partial<Props> = {}) { return <ChatConnectionState {...DEFAULT_ARGS} {...props} />; }

정상 연결

phase가 online이면 아무것도 렌더하지 않는 원본 동작을 보여주는 예시다.

코드

Open in Playground

import { css } from '@mildang/styled-system/css';
import { ChatConnectionState } from '@mildang/design-system/unofficial/Chat';

const ConnectionStateOnlineExample = () => (
    <div className={css({ display: 'flex', flexDirection: 'column', gap: '16' })}>
      <div
        className={css({
          borderWidth: '1px',
          borderStyle: 'dashed',
          borderColor: 'neutral.border.base',
          borderRadius: 'lg',
          padding: '12',
          textStyle: 'chat-small-text-R',
          color: 'neutral.text.lowest',
        })}
      >
        phase=&quot;online&quot; → 렌더 없음
        <ChatConnectionState phase="online" />
      </div>

      <ChatConnectionState
        phase="reconnecting"
        attempt={2}
        labels={{
          reconnecting: 'Reconnecting',
          attempt: (attempt) => `attempt ${attempt}`,
        }}
      />
    </div>
  );

export default ConnectionStateOnlineExample;