@weing-dev/ui-kit-primitive 0.1.2 → 0.3.0

package/dist/components/Icon/context/icon.store.d.ts

@@ -0,0 +1,16 @@
+import { JSX } from 'react';
+import * as DefaultIcons from "../../Icons";
+export type IconComponent = (props: React.SVGProps<SVGSVGElement>) => JSX.Element | React.ReactNode;
+export type IconRegistry = Partial<Record<string, IconComponent>>;
+export type DefaultIconName = keyof typeof DefaultIcons;
+export type IconStoreState = {
+    icons: IconRegistry;
+};
+export type IconStoreActions = {
+    registerIcons: (icons: IconRegistry) => void;
+};
+export type IconStore = IconStoreState & IconStoreActions;
+export type IconStoreConfig = {
+    icons?: IconRegistry;
+};
+export declare const createIconStore: (config?: IconStoreConfig) => import('zustand').UseBoundStore<import('zustand').StoreApi<IconStore>>;

package/dist/components/Icon/context/index.d.ts

@@ -0,0 +1,3 @@
+export { IconStoreContext, useIconStore, type IconStoreApi, } from './icon.context';
+export { default as IconProvider, type IconProviderProps } from './icon.provider';
+export { createIconStore, type IconStore, type IconStoreState, type IconStoreActions, type IconStoreConfig, type DefaultIconName, type IconComponent, type IconRegistry, } from './icon.store';

package/dist/components/Icon/icon.augment.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `@weing-dev/ui-kit-primitive` 모듈 확장 포인트 (Icon name).
+ *
+ * 소비자 프로젝트에서 아래처럼 확장하면 `Icon`/`Button.Icon`의 `name` 자동완성에 반영됩니다.
+ *
+ * declare module "@weing-dev/ui-kit-primitive" {
+ *   interface IconNameOverrides {
+ *     Sigma: true;
+ *   }
+ * }
+ */
+declare module "@weing-dev/ui-kit-primitive" {
+    interface IconNameOverrides {
+    }
+}
+export type __UiKitIconAugmentMarker = true;
+export {};

package/dist/components/Icons/BackButton.d.ts

@@ -0,0 +1,3 @@
+import { SVGProps } from 'react';
+declare const SvgBackButton: (props: SVGProps<SVGSVGElement>) => import("react/jsx-runtime").JSX.Element;
+export default SvgBackButton;

package/dist/components/Icons/FullScreen.d.ts

@@ -0,0 +1,3 @@
+import { SVGProps } from 'react';
+declare const SvgFullScreen: (props: SVGProps<SVGSVGElement>) => import("react/jsx-runtime").JSX.Element;
+export default SvgFullScreen;

package/dist/components/Icons/FullScreenClose.d.ts

@@ -0,0 +1,3 @@
+import { SVGProps } from 'react';
+declare const SvgFullScreenClose: (props: SVGProps<SVGSVGElement>) => import("react/jsx-runtime").JSX.Element;
+export default SvgFullScreenClose;

package/dist/components/Icons/Pause.d.ts

@@ -0,0 +1,3 @@
+import { SVGProps } from 'react';
+declare const SvgPause: (props: SVGProps<SVGSVGElement>) => import("react/jsx-runtime").JSX.Element;
+export default SvgPause;

package/dist/components/Icons/PictureQuality.d.ts

@@ -0,0 +1,3 @@
+import { SVGProps } from 'react';
+declare const SvgPictureQuality: (props: SVGProps<SVGSVGElement>) => import("react/jsx-runtime").JSX.Element;
+export default SvgPictureQuality;

package/dist/components/Icons/Pip.d.ts

@@ -0,0 +1,3 @@
+import { SVGProps } from 'react';
+declare const SvgPip: (props: SVGProps<SVGSVGElement>) => import("react/jsx-runtime").JSX.Element;
+export default SvgPip;

package/dist/components/Icons/PipExit.d.ts

@@ -0,0 +1,3 @@
+import { SVGProps } from 'react';
+declare const SvgPipExit: (props: SVGProps<SVGSVGElement>) => import("react/jsx-runtime").JSX.Element;
+export default SvgPipExit;

package/dist/components/Icons/Play.d.ts

@@ -0,0 +1,3 @@
+import { SVGProps } from 'react';
+declare const SvgPlay: (props: SVGProps<SVGSVGElement>) => import("react/jsx-runtime").JSX.Element;
+export default SvgPlay;

package/dist/components/Icons/PlaybackSpeed.d.ts

@@ -0,0 +1,3 @@
+import { SVGProps } from 'react';
+declare const SvgPlaybackSpeed: (props: SVGProps<SVGSVGElement>) => import("react/jsx-runtime").JSX.Element;
+export default SvgPlaybackSpeed;

package/dist/components/Icons/Share.d.ts

@@ -0,0 +1,3 @@
+import { SVGProps } from 'react';
+declare const SvgShare: (props: SVGProps<SVGSVGElement>) => import("react/jsx-runtime").JSX.Element;
+export default SvgShare;

package/dist/components/Icons/SubtitleFilled.d.ts

@@ -0,0 +1,3 @@
+import { SVGProps } from 'react';
+declare const SvgSubtitleFilled: (props: SVGProps<SVGSVGElement>) => import("react/jsx-runtime").JSX.Element;
+export default SvgSubtitleFilled;

package/dist/components/Icons/SubtitleOutlined.d.ts

@@ -0,0 +1,3 @@
+import { SVGProps } from 'react';
+declare const SvgSubtitleOutlined: (props: SVGProps<SVGSVGElement>) => import("react/jsx-runtime").JSX.Element;
+export default SvgSubtitleOutlined;

package/dist/components/Icons/VolumeOff.d.ts

@@ -0,0 +1,3 @@
+import { SVGProps } from 'react';
+declare const SvgVolumeOff: (props: SVGProps<SVGSVGElement>) => import("react/jsx-runtime").JSX.Element;
+export default SvgVolumeOff;

package/dist/components/Icons/VolumeUp.d.ts

@@ -0,0 +1,3 @@
+import { SVGProps } from 'react';
+declare const SvgVolumeUp: (props: SVGProps<SVGSVGElement>) => import("react/jsx-runtime").JSX.Element;
+export default SvgVolumeUp;

package/dist/components/Icons/index.d.ts

@@ -8,6 +8,7 @@ export { default as ArrowUp } from './ArrowUp';
 export { default as ArrowDropDown } from './ArrowDropDown';
 export { default as ArticleOutlined } from './ArticleOutlined';
 export { default as AttachFile } from './AttachFile';
+export { default as BackButton } from './BackButton';
 export { default as CalendarMonth } from './CalendarMonth';
 export { default as CalendarToday } from './CalendarToday';
 export { default as CancleFilled } from './CancleFilled';
@@ -47,6 +48,8 @@ export { default as FileUpload } from './FileUpload';
 export { default as FilecheckInactive } from './FilecheckInactive';
 export { default as FileDownloadDoneFilled } from './FileDownloadDoneFilled';
 export { default as FileDownloadOutlined } from './FileDownloadOutlined';
+export { default as FullScreen } from './FullScreen';
+export { default as FullScreenClose } from './FullScreenClose';
 export { default as GoBefore } from './GoBefore';
 export { default as GoNext } from './GoNext';
 export { default as HamburgerMenu } from './HamburgerMenu';
@@ -74,6 +77,7 @@ export { default as OrderApprove } from './OrderApprove';
 export { default as OrderInactive } from './OrderInactive';
 export { default as OrderPlay } from './OrderPlay';
 export { default as Outward } from './Outward';
+export { default as Pause } from './Pause';
 export { default as PayApprove } from './PayApprove';
 export { default as PayInactive } from './PayInactive';
 export { default as Payment } from './Payment';
@@ -81,6 +85,11 @@ export { default as PersonAddAlt } from './PersonAddAlt';
 export { default as Personcard } from './Personcard';
 export { default as PersonFilled } from './PersonFilled';
 export { default as PersonOutline } from './PersonOutline';
+export { default as PictureQuality } from './PictureQuality';
+export { default as Pip } from './Pip';
+export { default as PipExit } from './PipExit';
+export { default as Play } from './Play';
+export { default as PlaybackSpeed } from './PlaybackSpeed';
 export { default as PrintInactive } from './PrintInactive';
 export { default as PrintPlay } from './PrintPlay';
 export { default as Product } from './Product';
@@ -89,13 +98,18 @@ export { default as Search } from './Search';
 export { default as Search2 } from './Search2';
 export { default as SettingFilled } from './SettingFilled';
 export { default as Settings } from './Settings';
+export { default as Share } from './Share';
 export { default as ShippingDone } from './ShippingDone';
+export { default as SubtitleFilled } from './SubtitleFilled';
+export { default as SubtitleOutlined } from './SubtitleOutlined';
 export { default as SupportAgent } from './SupportAgent';
 export { default as SwapVert } from './SwapVert';
 export { default as Task } from './Task';
 export { default as TrashOutlined } from './TrashOutlined';
 export { default as Upload } from './Upload';
 export { default as User } from './User';
+export { default as VolumeOff } from './VolumeOff';
+export { default as VolumeUp } from './VolumeUp';
 export { default as WarningFilled } from './WarningFilled';
 export { default as Warning } from './Warning';
 export { default as WarningAmber } from './WarningAmber';

package/dist/components/LNB/LNB.d.ts

@@ -5,7 +5,7 @@ type LNBLogoProps = React.PropsWithChildren<{
     className?: string;
     src: string;
 }>;
-declare const Logo: React.MemoExoticComponent<(props: LNBLogoProps) => import("react/jsx-runtime").JSX.Element>;
+declare const Logo: (props: LNBLogoProps) => import("react/jsx-runtime").JSX.Element;
 type LNBItemProps = React.PropsWithChildren<{
     className?: string;
     label: string;
@@ -18,12 +18,12 @@ type LNBItemProps = React.PropsWithChildren<{
     isOpen?: boolean;
     isActive?: boolean;
 }>;
-declare const Item: React.MemoExoticComponent<(props: LNBItemProps) => import("react/jsx-runtime").JSX.Element>;
+declare const Item: (props: LNBItemProps) => import("react/jsx-runtime").JSX.Element;
 type LNBListProps = React.PropsWithChildren<{
     className?: string;
 }>;
-declare const List: React.MemoExoticComponent<(props: LNBListProps) => import("react/jsx-runtime").JSX.Element>;
-declare const Root: React.MemoExoticComponent<(props: LNBProviderProps) => import("react/jsx-runtime").JSX.Element>;
+declare const List: (props: LNBListProps) => import("react/jsx-runtime").JSX.Element;
+declare const Root: (props: LNBProviderProps) => import("react/jsx-runtime").JSX.Element;
 export type Navigation<T = never> = {
     label: string;
     subtitle?: string;

package/dist/components/Label/Label.d.ts

@@ -6,5 +6,5 @@ interface LabelRootProps {
     size?: "medium" | "small" | "xSmall";
     onClick?: () => void;
 }
-declare const _default: React.MemoExoticComponent<(props: LabelRootProps & React.ComponentProps<"div">) => import("react/jsx-runtime").JSX.Element>;
-export default _default;
+declare const Label: (props: LabelRootProps & React.ComponentProps<"div">) => import("react/jsx-runtime").JSX.Element;
+export default Label;

package/dist/components/List/List.d.ts

@@ -1,7 +1,7 @@
 import { default as React } from 'react';
 import { Icon } from '../Icon/Icon';
 type TextProps = {
-    value: string;
+    value?: string;
 } & React.JSX.IntrinsicElements["div"];
 type BaseListProps = {
     label: TextProps;
@@ -17,6 +17,6 @@ type ListProps = ({
     title?: TextProps;
     icon?: never;
 } & BaseListProps);
+declare const List: (props: ListProps) => import("react/jsx-runtime").JSX.Element;
 export type { ListProps };
-declare const _default: React.MemoExoticComponent<(props: ListProps) => import("react/jsx-runtime").JSX.Element>;
-export default _default;
+export default List;

package/dist/components/Pagination/Pagination.d.ts

@@ -1,13 +1,13 @@
 import { default as React } from 'react';
 import { PaginationContextType } from './Pagination.context';
-declare const Next: React.MemoExoticComponent<() => import("react/jsx-runtime").JSX.Element>;
-declare const Prev: React.MemoExoticComponent<() => import("react/jsx-runtime").JSX.Element>;
+declare const Next: () => import("react/jsx-runtime").JSX.Element;
+declare const Prev: () => import("react/jsx-runtime").JSX.Element;
 type PageItemProps = {
     active: boolean;
     onClick: (page: number) => void;
     page: number;
 };
-declare const PageItem: React.MemoExoticComponent<(props: PageItemProps) => import("react/jsx-runtime").JSX.Element>;
+declare const PageItem: (props: PageItemProps) => import("react/jsx-runtime").JSX.Element;
 type PageListProps = {
     itemAs?: ({ page, active, onClick, }: {
         page: number;
@@ -15,9 +15,9 @@ type PageListProps = {
         onClick: (page: number) => void;
     }) => React.ReactNode;
 };
-declare const PageList: React.MemoExoticComponent<(props: PageListProps) => import("react/jsx-runtime").JSX.Element | null>;
+declare const PageList: (props: PageListProps) => import("react/jsx-runtime").JSX.Element | null;
 type RootProps = {} & Omit<PaginationContextType, "currentPage">;
-declare const Root: React.MemoExoticComponent<(props: React.PropsWithChildren<RootProps>) => import("react/jsx-runtime").JSX.Element>;
+declare const Root: (props: React.PropsWithChildren<RootProps>) => import("react/jsx-runtime").JSX.Element;
 interface IPagination {
     Root: typeof Root;
     Next: typeof Next;

package/dist/components/Tab/Tab.d.ts

@@ -5,15 +5,15 @@ type PanelProps = React.PropsWithChildren<{
     id?: string;
     index: number;
 }>;
-declare const Panel: React.MemoExoticComponent<(props: PanelProps) => import("react/jsx-runtime").JSX.Element>;
+declare const Panel: (props: PanelProps) => import("react/jsx-runtime").JSX.Element;
 type PanelsProps = React.PropsWithChildren<{
     className?: string;
 }>;
-declare const Panels: React.MemoExoticComponent<(props: PanelsProps) => import("react/jsx-runtime").JSX.Element>;
+declare const Panels: (props: PanelsProps) => import("react/jsx-runtime").JSX.Element;
 type TabListProps = React.PropsWithChildren<{
     className?: string;
 }>;
-declare const List: React.MemoExoticComponent<(props: TabListProps) => import("react/jsx-runtime").JSX.Element>;
+declare const List: (props: TabListProps) => import("react/jsx-runtime").JSX.Element;
 type TabProps = React.PropsWithChildren<{
     className?: string;
     id?: string;
@@ -21,8 +21,8 @@ type TabProps = React.PropsWithChildren<{
     onClick?: (...args: any) => void;
     isActive?: boolean;
 }>;
-declare const Item: React.MemoExoticComponent<(props: TabProps) => import("react/jsx-runtime").JSX.Element>;
-declare const Root: React.MemoExoticComponent<(props: TabsProviderProps) => import("react/jsx-runtime").JSX.Element>;
+declare const Item: (props: TabProps) => import("react/jsx-runtime").JSX.Element;
+declare const Root: (props: TabsProviderProps) => import("react/jsx-runtime").JSX.Element;
 interface ITab {
     Root: typeof Root;
     List: typeof List;

package/dist/components/Table/Table.d.ts

@@ -2,22 +2,22 @@ import { default as React } from 'react';
 import { TableProviderProps } from './Table.context';
 import { useRowResize } from './Table.hook';
 type TableRowProps = React.PropsWithChildren<React.JSX.IntrinsicElements["tr"]>;
-declare const Row: React.MemoExoticComponent<(props: TableRowProps) => import("react/jsx-runtime").JSX.Element>;
+declare const Row: (props: TableRowProps) => import("react/jsx-runtime").JSX.Element;
 type TableCellProps = React.PropsWithChildren<{
     size?: number;
     isSelected?: boolean;
 } & React.JSX.IntrinsicElements["td"]>;
-declare const Cell: React.MemoExoticComponent<(props: TableCellProps) => import("react/jsx-runtime").JSX.Element>;
+declare const Cell: (props: TableCellProps) => import("react/jsx-runtime").JSX.Element;
 type TableBodyProps = React.PropsWithChildren<React.JSX.IntrinsicElements["tbody"]>;
-declare const Body: React.MemoExoticComponent<(props: TableBodyProps) => import("react/jsx-runtime").JSX.Element>;
+declare const Body: (props: TableBodyProps) => import("react/jsx-runtime").JSX.Element;
 type TableHeaderCellProps = React.PropsWithChildren<{
     size?: number;
 } & React.JSX.IntrinsicElements["th"]>;
-declare const HeaderCell: React.MemoExoticComponent<(props: TableHeaderCellProps) => import("react/jsx-runtime").JSX.Element>;
+declare const HeaderCell: (props: TableHeaderCellProps) => import("react/jsx-runtime").JSX.Element;
 type TableHeaderProps = React.PropsWithChildren<React.JSX.IntrinsicElements["thead"]>;
-declare const Header: React.MemoExoticComponent<(props: TableHeaderProps) => import("react/jsx-runtime").JSX.Element>;
+declare const Header: (props: TableHeaderProps) => import("react/jsx-runtime").JSX.Element;
 type TableRootProps = TableProviderProps & React.JSX.IntrinsicElements["table"];
-declare const Root: React.MemoExoticComponent<(props: TableRootProps) => import("react/jsx-runtime").JSX.Element>;
+declare const Root: (props: TableRootProps) => import("react/jsx-runtime").JSX.Element;
 interface ITable {
     Root: typeof Root;
     Header: typeof Header;

package/dist/components/TimeInput/TimeInput.d.ts

@@ -4,13 +4,13 @@ type InputProps = {
     index: number;
     placeholder: string;
 } & React.JSX.IntrinsicElements["input"];
-declare const Input: React.MemoExoticComponent<(props: InputProps) => import("react/jsx-runtime").JSX.Element>;
+declare const Input: (props: InputProps) => import("react/jsx-runtime").JSX.Element;
 type TimeRangeProps = React.PropsWithChildren<React.JSX.IntrinsicElements["div"]>;
-declare const TimeRange: React.MemoExoticComponent<(props: TimeRangeProps) => import("react/jsx-runtime").JSX.Element>;
+declare const TimeRange: (props: TimeRangeProps) => import("react/jsx-runtime").JSX.Element;
 type ColonProps = React.JSX.IntrinsicElements["span"];
-declare const Colon: React.MemoExoticComponent<(props: ColonProps) => import("react/jsx-runtime").JSX.Element>;
+declare const Colon: (props: ColonProps) => import("react/jsx-runtime").JSX.Element;
 type SeparatorProps = React.JSX.IntrinsicElements["span"];
-declare const Separator: React.MemoExoticComponent<(props: SeparatorProps) => import("react/jsx-runtime").JSX.Element>;
+declare const Separator: (props: SeparatorProps) => import("react/jsx-runtime").JSX.Element;
 type HelperTextProps = React.PropsWithChildren<{
     className?: string;
     warningColor?: string;
@@ -21,18 +21,18 @@ type HelperTextProps = React.PropsWithChildren<{
     size?: number;
     iconVisible?: boolean;
 }>;
-declare const HelperText: React.MemoExoticComponent<(props: HelperTextProps) => import("react/jsx-runtime").JSX.Element | null>;
+declare const HelperText: (props: HelperTextProps) => import("react/jsx-runtime").JSX.Element | null;
 type InputWrapperProps = React.PropsWithChildren<React.JSX.IntrinsicElements["div"]>;
-declare const InputWrapper: React.MemoExoticComponent<(props: InputWrapperProps) => import("react/jsx-runtime").JSX.Element>;
+declare const InputWrapper: (props: InputWrapperProps) => import("react/jsx-runtime").JSX.Element;
 type LabelProps = React.PropsWithChildren<{
     className?: string;
     focusedColor?: string;
 }>;
-declare const Label: React.MemoExoticComponent<(props: LabelProps) => import("react/jsx-runtime").JSX.Element>;
+declare const Label: (props: LabelProps) => import("react/jsx-runtime").JSX.Element;
 type RootProps = React.PropsWithChildren<Omit<TimeInputContextType, "inputRefs" | "handleChange" | "handleBlur" | "handleKeyDown"> & {
     className?: string;
 }>;
-declare const Root: React.MemoExoticComponent<(props: RootProps) => import("react/jsx-runtime").JSX.Element>;
+declare const Root: (props: RootProps) => import("react/jsx-runtime").JSX.Element;
 interface ITimeInput {
     Root: typeof Root;
     Label: typeof Label;

package/dist/components/VideoPlayer/VideoPlayer.d.ts

@@ -0,0 +1,125 @@
+import { default as React } from 'react';
+import { VideoOverlay, Loading, Error, Frame, Player, Thumbnail, Widgets } from './components';
+import { VideoPlayerStoreContext, VideoPlayerImageContext, DefaultImage, VideoPlayerProvider, useVideoPlayerStore, useVideoPlayerShallow, useVideoPlayerImage, createVideoPlayerStore, resolveVideoPlayerStoreConfig, VideoPlayerImageComponent, VideoPlayerProviderProps } from './context';
+import { VIDEO_PLAYER_DEFAULTS } from './videoPlayer.constants';
+import { convertSrtToVtt, isSrtSubtitleSource, parseWebVttToCues } from './VideoPlayer.utils';
+/**
+ * `VideoPlayer.Root` props. `VideoPlayerProviderProps`와 같으나 `children`은 선택이고,
+ * 썸네일에 쓸 커스텀 이미지 컴포넌트를 `Image`로 넘길 수 있다.
+ */
+export type RootProps = Omit<VideoPlayerProviderProps, "children"> & {
+    children?: React.ReactNode;
+    /** 썸네일·포스터 렌더에 사용. 미지정 시 HTML `img` 기본 구현 */
+    Image?: VideoPlayerImageComponent;
+};
+declare const Root: {
+    (props: RootProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+/**
+ * `VideoPlayer` 기본 export 객체의 타입.
+ * 컴파운드 컴포넌트, 훅, Context, 스토어 팩토리, 기본 상수, 자막 유틸을 한곳에서 접근한다.
+ */
+interface IVideoPlayer {
+    /**
+     * 플레이어 루트. 스토어(Provider)·레이아웃·자막·이벤트 등 초기 설정을 넘기고, 하위에 `Frame`·`Player`·`Overlay`를 조립한다.
+     * `children`만 비우면 UI가 렌더되지 않는다.
+     */
+    Root: typeof Root;
+    /**
+     * 플레이어 영역 래퍼. Root의 `width`/`height`를 CSS 변수로 반영한다.
+     */
+    Frame: typeof Frame;
+    /**
+     * `<video>`와 Video.js 인스턴스를 마운트한다. 소스·옵션·이벤트는 스토어(Root가 넣은 값)를 읽는다.
+     */
+    Player: typeof Player;
+    /**
+     * 재생 전·`currentTime === 0`일 때만 보이는 포스터(썸네일) 레이어. Root의 `Image` 슬롯으로 그린다.
+     */
+    Thumbnail: typeof Thumbnail;
+    /**
+     * 오버레이 루트. children은 렌더 프롭으로 `onMouseMove`·`showControls` 등을 받는다. `Overlay.Grid`와 9개 슬롯을 제공한다.
+     */
+    Overlay: typeof VideoOverlay;
+    /**
+     * 로딩 오버레이. 스토어 `isLoading`이 true일 때만 표시된다.
+     */
+    Loading: typeof Loading;
+    /**
+     * 에러 오버레이. 스토어 `hasError`가 true일 때만 표시된다.
+     */
+    Error: typeof Error;
+    /**
+     * 컨트롤 위젯 묶음 (`Button`, `ProgressBar`, `VolumeControl`, `SpeedControl`, `Time`).
+     */
+    Widgets: typeof Widgets;
+    /**
+     * Zustand 스토어에서 값을 구독한다. 반드시 Provider(`Root` 또는 `VideoPlayerProvider`) 하위에서 호출한다.
+     */
+    useVideoPlayerStore: typeof useVideoPlayerStore;
+    /**
+     * 스토어에서 여러 필드를 얕게(shallow) 골라온다. 키 배열 또는 selector 함수를 넘길 수 있다.
+     */
+    useVideoPlayerShallow: typeof useVideoPlayerShallow;
+    /**
+     * Root에 주입한 `Image` 컴포넌트 타입을 반환한다. `Thumbnail`이 이 구현으로 렌더된다.
+     */
+    useVideoPlayerImage: typeof useVideoPlayerImage;
+    /**
+     * VideoPlayer Zustand 스토어용 React Context.
+     */
+    VideoPlayerStoreContext: typeof VideoPlayerStoreContext;
+    /**
+     * 썸네일용 이미지 컴포넌트를 담는 Context.
+     */
+    VideoPlayerImageContext: typeof VideoPlayerImageContext;
+    /**
+     * 스토어 Provider. `Root` 없이 커스텀 트리에 직접 감쌀 때 사용한다.
+     */
+    VideoPlayerProvider: typeof VideoPlayerProvider;
+    /**
+     * Zustand 스토어 인스턴스를 생성한다. 고급 통합·테스트용.
+     */
+    createVideoPlayerStore: typeof createVideoPlayerStore;
+    /**
+     * `storeConfig` 부분 객체를 패키지 기본값과 병합해 완전한 설정 객체로 만든다.
+     */
+    resolveVideoPlayerStoreConfig: typeof resolveVideoPlayerStoreConfig;
+    /**
+     * 레이아웃·오버레이·볼륨·배속·문구·aria·아이콘 이름 등 패키지 기본 상수.
+     */
+    VIDEO_PLAYER_DEFAULTS: typeof VIDEO_PLAYER_DEFAULTS;
+    /**
+     * 기본 썸네일 이미지 구현(HTML `<img>`). Root `Image` 미지정 시 사용된다.
+     */
+    DefaultImage: typeof DefaultImage;
+    /**
+     * SRT 자막 텍스트를 WebVTT 텍스트로 변환한다.
+     *
+     * - 줄바꿈을 `\n`으로 정규화
+     * - 타임스탬프 구분자 `,`를 `.`으로 변환
+     * - 가능한 경우 cue id/설정 정보를 보존
+     *
+     * @param srt - 원본 SRT 문자열
+     * @returns `WEBVTT` 헤더가 포함된 VTT 문자열
+     */
+    convertSrtToVtt: typeof convertSrtToVtt;
+    /**
+     * 자막 URL/경로가 SRT 파일인지 판별한다.
+     *
+     * @param src - 자막 리소스 경로 또는 URL
+     * @returns `.srt` 확장자면 `true`
+     */
+    isSrtSubtitleSource: typeof isSrtSubtitleSource;
+    /**
+     * WebVTT 문자열을 파싱해 cue 배열로 반환한다 (간단한 파서; 복잡한 설정 라인은 무시).
+     *
+     * @param input - 전체 WebVTT 문자열
+     * @returns `{ start, end, text }[]` (초 단위 구간)
+     */
+    parseWebVttToCues: typeof parseWebVttToCues;
+}
+export type { IVideoPlayer, RootProps as VideoPlayerRootProps };
+declare const VideoPlayer: IVideoPlayer;
+export default VideoPlayer;

package/dist/components/VideoPlayer/VideoPlayer.utils.d.ts

@@ -0,0 +1,45 @@
+import { VideoJsPlayer, VideoPlayerState } from './context/videoPlayer.types';
+/**
+ * Video.js HTML5 tech에서 루트 `<video>` 요소를 가져온다.
+ */
+export declare const getHtmlVideoElementFromVideoJs: (player: VideoJsPlayer) => HTMLVideoElement | null;
+/** WebVTT cue 한 개 (초 단위 구간) */
+export type VttCue = {
+    start: number;
+    end: number;
+    text: string;
+};
+/**
+ * WebVTT 문자열을 파싱해 cue 배열로 반환한다 (간단한 파서; 복잡한 설정 라인은 무시).
+ */
+export declare const parseWebVttToCues: (input: string) => VttCue[];
+/**
+ * SRT 자막 텍스트를 WebVTT 텍스트로 변환한다.
+ *
+ * - 줄바꿈을 `\n`으로 정규화
+ * - 타임스탬프 구분자 `,`를 `.`으로 변환
+ * - 가능한 경우 cue id/설정 정보를 보존
+ *
+ * @param srt - 원본 SRT 문자열
+ * @returns `WEBVTT` 헤더가 포함된 VTT 문자열
+ */
+export declare const convertSrtToVtt: (srt: string) => string;
+/**
+ * 자막 URL/경로가 SRT 파일인지 판별한다.
+ *
+ * @param src - 자막 리소스 경로 또는 URL
+ * @returns `.srt` 확장자면 `true`
+ */
+export declare const isSrtSubtitleSource: (src: string) => boolean;
+/**
+ * SRT 문자열을 VTT Blob URL로 변환해 브라우저 `track.src`에 바로 연결할 수 있게 만든다.
+ *
+ * @param srt - 원본 SRT 문자열
+ * @returns `URL.revokeObjectURL`로 해제가 필요한 Blob URL
+ */
+export declare const createVttBlobUrlFromSrt: (srt: string) => string;
+/**
+ * 스토어에 반영되는 `src` / `sources` 업데이트가 실제 미디어 소스 전환인지 판별한다.
+ * (썸네일만 바뀐 경우는 false)
+ */
+export declare const isMediaSourceChange: (previous: Pick<VideoPlayerState, "src" | "sources">, updates: Partial<VideoPlayerState>) => boolean;

package/dist/components/VideoPlayer/components/Error/Error.d.ts

@@ -0,0 +1,15 @@
+import { default as React } from 'react';
+type ErrorAsProps = {
+    defaultClassName: string;
+    errorTitle: string;
+    errorDescription: string;
+    errorRetry: string;
+    onRetry: () => void;
+};
+type ErrorProps = {
+    className?: string;
+    onRetry?: () => void;
+    as?: (props: ErrorAsProps) => React.ReactNode;
+};
+declare const Error: (props: ErrorProps) => import("react/jsx-runtime").JSX.Element | null;
+export default Error;

package/dist/components/VideoPlayer/components/Error/index.d.ts

@@ -0,0 +1 @@
+export { default } from './Error';

package/dist/components/VideoPlayer/components/Frame/Frame.d.ts

@@ -0,0 +1,6 @@
+import { default as React } from 'react';
+export type FrameProps = {
+    className?: string;
+} & React.JSX.IntrinsicElements["div"];
+declare const Frame: (props: FrameProps) => import("react/jsx-runtime").JSX.Element;
+export default Frame;

package/dist/components/VideoPlayer/components/Frame/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from './Frame';
+export type { FrameProps } from './Frame';

package/dist/components/VideoPlayer/components/Loading/Loading.d.ts

@@ -0,0 +1,11 @@
+import { default as React } from 'react';
+type LoadingAsProps = {
+    defaultClassName: string;
+    loadingText: string;
+};
+type LoadingProps = {
+    className?: string;
+    as?: (props: LoadingAsProps) => React.ReactNode;
+};
+declare const Loading: (props: LoadingProps) => import("react/jsx-runtime").JSX.Element | null;
+export default Loading;

package/dist/components/VideoPlayer/components/Loading/index.d.ts

@@ -0,0 +1 @@
+export { default } from './Loading';

package/dist/components/VideoPlayer/components/Player/Player.d.ts

@@ -0,0 +1,6 @@
+import { default as React } from 'react';
+export type PlayerProps = {
+    className?: string;
+} & React.JSX.IntrinsicElements["video"];
+declare const Player: (props: PlayerProps) => import("react/jsx-runtime").JSX.Element;
+export default Player;

package/dist/components/VideoPlayer/components/Player/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from './Player';
+export type { PlayerProps } from './Player';

package/dist/components/VideoPlayer/components/Thumbnail/Thumbnail.d.ts

@@ -0,0 +1,8 @@
+import { default as React } from 'react';
+export type ThumbnailProps = {
+    src: string;
+    alt?: string;
+    className?: string;
+} & React.JSX.IntrinsicElements["div"];
+declare const Thumbnail: (props: ThumbnailProps) => import("react/jsx-runtime").JSX.Element | null;
+export default Thumbnail;

package/dist/components/VideoPlayer/components/Thumbnail/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from './Thumbnail';
+export type { ThumbnailProps } from './Thumbnail';