@designbasekorea/ui-wc 0.8.12 → 0.9.0

package/dist/esm/ui-contracts/dist/components.d.d.ts

@@ -0,0 +1,76 @@
+import { SizeSML, FeedbackTone } from './primitives.d.js';
+
+/**
+ * 컴포넌트별 API 계약.
+ *
+ * 웹(@designbasekorea/ui-wc)과 React Native(@designbasekorea/ui-native)가
+ * 공유하는 컴포넌트의 variant/size/type 값은 전부 여기서 나온다.
+ * 한쪽에만 있는 컴포넌트(db-code-block, db-animation-background 등)는
+ * 여기에 넣지 않는다 — 공유하지 않는 것을 계약에 넣으면 계약이 죽는다.
+ *
+ * 값을 바꾸면 양쪽 구현이 동시에 타입 에러를 낸다. 그게 이 파일의 목적이다.
+ */
+
+declare const BADGE_VARIANTS: readonly ["primary", "secondary", "info", "success", "warning", "danger"];
+type BadgeVariant = (typeof BADGE_VARIANTS)[number];
+/**
+ * 표시 형태. 웹은 이 축을 `style` 이라고 불렀지만 `type` 으로 통일한다.
+ * (`style` 은 RN 에서 사실상 예약어이고, 나머지 컴포넌트도 `type` 을 쓴다)
+ */
+declare const BADGE_TYPES: readonly ["dot", "number", "text", "outlined"];
+type BadgeType = (typeof BADGE_TYPES)[number];
+type ToastVariant = 'default' | FeedbackTone;
+/**
+ * 웹 `toast()` 헬퍼가 이미 배포한 값 그대로다.
+ * RN 은 화면이 좁아 좌/중앙/우 차이가 작지만, 같은 이름을 받아야 코드가 옮겨진다.
+ */
+declare const TOAST_POSITIONS: readonly ["top-left", "top-center", "top-right", "bottom-left", "bottom-center", "bottom-right"];
+type ToastPosition = (typeof TOAST_POSITIONS)[number];
+declare const NAVIGATION_RAIL_LABEL_DISPLAYS: readonly ["tooltip", "always"];
+type NavigationRailLabelDisplay = (typeof NAVIGATION_RAIL_LABEL_DISPLAYS)[number];
+declare const CHAT_MESSAGE_ROLES: readonly ["user", "assistant", "system"];
+declare const AI_GLOW_VARIANTS: readonly ["aurora", "brand"];
+declare const AI_GLOW_STATES: readonly ["thinking", "working", "listening"];
+declare const AI_GLOW_SIZES: readonly ["s", "m", "l"];
+declare const CHAT_ORB_SIZES: readonly ["xs", "s", "m", "l", "xl"];
+declare const CHAT_ORB_VARIANTS: readonly ["aurora", "ocean", "emerald", "violet", "mono"];
+declare const CHAT_ORB_STATES: readonly ["idle", "thinking", "listening"];
+declare const CHAT_ORB_THEMES: readonly ["auto", "light", "dark"];
+declare const CHAT_WIDGET_VIEWS: readonly ["home", "messages", "conversation", "help", "article"];
+declare const CHAT_WIDGET_POSITIONS: readonly ["bottom-right", "bottom-left"];
+declare const DOWNLOAD_PROGRESS_STATUSES: readonly ["downloading", "paused", "error", "complete"];
+declare const DOWNLOAD_PROGRESS_POSITIONS: readonly ["bottom-right", "bottom-left", "bottom-center", "top-right", "top-left", "top-center"];
+declare const EMAIL_VERIFY_SIZES: readonly ["s", "m", "l"];
+declare const OTP_INPUT_SIZES: readonly ["s", "m", "l"];
+declare const PHONE_VERIFY_SIZES: readonly ["s", "m", "l"];
+declare const SIDEBAR_ACCORDION_MODES: readonly ["single", "multiple"];
+declare const TIME_PICKER_FORMATS: readonly ["12h", "24h", "12h-with-seconds", "24h-with-seconds"];
+declare const TWO_FACTOR_SIZES: readonly ["s", "m", "l"];
+type BentoGridSize = SizeSML;
+declare const BENTO_GRID_COLUMNS: readonly ["1", "2", "3", "4"];
+type BentoGridColumns = (typeof BENTO_GRID_COLUMNS)[number];
+declare const BENTO_CARD_VARIANTS: readonly ["default", "flat", "elevated"];
+type BentoCardVariant = (typeof BENTO_CARD_VARIANTS)[number];
+type BentoCardSize = SizeSML;
+declare const BENTO_CARD_IMAGE_POSITIONS: readonly ["top", "cover"];
+type BentoCardImagePosition = (typeof BENTO_CARD_IMAGE_POSITIONS)[number];
+declare const TWEET_CARD_VARIANTS: readonly ["default", "flat", "outlined"];
+type TweetCardVariant = (typeof TWEET_CARD_VARIANTS)[number];
+type TweetCardSize = SizeSML;
+declare const PROGRESSIVE_BLUR_POSITIONS: readonly ["top", "bottom", "both", "left", "right"];
+type ProgressiveBlurPosition = (typeof PROGRESSIVE_BLUR_POSITIONS)[number];
+type ProgressiveBlurSize = SizeSML;
+declare const BORDER_BEAM_VARIANTS: readonly ["default", "rainbow", "glow"];
+type BorderBeamVariant = (typeof BORDER_BEAM_VARIANTS)[number];
+declare const CONFETTI_MODES: readonly ["cannon", "fireworks", "stars", "pride", "snow"];
+type ConfettiMode = (typeof CONFETTI_MODES)[number];
+declare const CONFETTI_TRIGGERS: readonly ["manual", "auto", "click"];
+type ConfettiTrigger = (typeof CONFETTI_TRIGGERS)[number];
+declare const CONFETTI_SHAPES: readonly ["mix", "square", "circle", "star"];
+type ConfettiShape = (typeof CONFETTI_SHAPES)[number];
+declare const GLYPH_MATRIX_PRESETS: readonly ["code", "matrix", "binary", "dots", "alphanumeric"];
+type GlyphMatrixPreset = (typeof GLYPH_MATRIX_PRESETS)[number];
+type GlyphMatrixSize = SizeSML;
+
+export { AI_GLOW_SIZES, AI_GLOW_STATES, AI_GLOW_VARIANTS, BADGE_TYPES, BADGE_VARIANTS, BENTO_CARD_IMAGE_POSITIONS, BENTO_CARD_VARIANTS, BENTO_GRID_COLUMNS, BORDER_BEAM_VARIANTS, CHAT_MESSAGE_ROLES, CHAT_ORB_SIZES, CHAT_ORB_STATES, CHAT_ORB_THEMES, CHAT_ORB_VARIANTS, CHAT_WIDGET_POSITIONS, CHAT_WIDGET_VIEWS, CONFETTI_MODES, CONFETTI_SHAPES, CONFETTI_TRIGGERS, DOWNLOAD_PROGRESS_POSITIONS, DOWNLOAD_PROGRESS_STATUSES, EMAIL_VERIFY_SIZES, GLYPH_MATRIX_PRESETS, NAVIGATION_RAIL_LABEL_DISPLAYS, OTP_INPUT_SIZES, PHONE_VERIFY_SIZES, PROGRESSIVE_BLUR_POSITIONS, SIDEBAR_ACCORDION_MODES, TIME_PICKER_FORMATS, TOAST_POSITIONS, TWEET_CARD_VARIANTS, TWO_FACTOR_SIZES };
+export type { BadgeType, BadgeVariant, BentoCardImagePosition, BentoCardSize, BentoCardVariant, BentoGridColumns, BentoGridSize, BorderBeamVariant, ConfettiMode, ConfettiShape, ConfettiTrigger, GlyphMatrixPreset, GlyphMatrixSize, NavigationRailLabelDisplay, ProgressiveBlurPosition, ProgressiveBlurSize, ToastPosition, ToastVariant, TweetCardSize, TweetCardVariant };

package/dist/esm/ui-contracts/dist/primitives.d.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 여러 컴포넌트가 공유하는 기본 스케일.
+ *
+ * 개별 컴포넌트가 자기만의 s/m/l 을 따로 선언하면 한쪽에서 값이 추가될 때
+ * 다른 쪽이 조용히 뒤처진다. 스케일은 여기서만 정의한다.
+ */
+/** 표준 3단계 스케일 — 대부분의 컨트롤(Button, Input, Checkbox 등)이 사용한다 */
+declare const SIZE_SML: readonly ["s", "m", "l"];
+type SizeSML = (typeof SIZE_SML)[number];
+/**
+ * 피드백 톤.
+ *
+ * ⚠️ `error` 가 아니라 `danger` 다. 디자인 토큰은 내부적으로 `feedback.error` 라는
+ * 키를 쓰지만, 컴포넌트 공개 API 는 danger 로 통일한다. 토큰 키와 API 이름이
+ * 다른 것은 의도된 것이며, 매핑은 각 구현체가 담당한다.
+ */
+declare const FEEDBACK_TONES: readonly ["info", "success", "warning", "danger"];
+type FeedbackTone = (typeof FEEDBACK_TONES)[number];
+
+export { FEEDBACK_TONES, SIZE_SML };
+export type { FeedbackTone, SizeSML };