sellmate-design-system-react 9.0.0-beta.8 → 9.0.0-beta.80

package/dist/recipes/AppShell.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 레시피 페이지가 기대는 **앱 셸**의 자리표시.
+ *
+ * 레시피 페이지는 이 파일을 `./AppShell` 로 import 한다 — 소비 앱에서는 그 자리에 AGENTS.md §4-1
+ * 대로 만든 자기 셸(SLayout · SGnb · SPageHeader · SPage)이 온다.
+ *
+ * 페이지 레시피는 **페이지 안**의 골격이라 GNB·레이아웃은 보여 주지 않는다. 셸 조합은
+ * Layout Builder 의 몫이다. 그래서 여기서는 셸 중 페이지가 정하는 부분 — 페이지 헤더와
+ * `SPage`(높이·폭 모드) — 만 세운다. 둘 사이의 중개(헤더 그림자·폭 정렬)는 `SLayout` 이
+ * 쓰는 페이지 열(`SPageColumn`)을 그대로 써서 셸 안에서와 똑같이 동작하게 한다.
+ */
+import type { ReactNode } from 'react';
+import { type SPageContentHeight, type SPageContentWidth, type SPageHeaderProps, type SPagePadding } from 'sellmate-design-system-react';
+export default function AppShell({ children, header, scrollEndSpacing, contentHeight, contentWidth, padding, }: {
+    children: ReactNode;
+    header?: SPageHeaderProps;
+    scrollEndSpacing?: boolean;
+    contentHeight?: SPageContentHeight;
+    contentWidth?: SPageContentWidth;
+    padding?: SPagePadding;
+}): import("react").JSX.Element;

package/dist/recipes/CategoryManagePage.d.ts

@@ -0,0 +1 @@
+export default function CategoryManagePage(): import("react").JSX.Element;

package/dist/recipes/ConsultConsolePage.d.ts

@@ -0,0 +1 @@
+export default function ConsultConsolePage(): import("react").JSX.Element;

package/dist/recipes/ExcelFilePopupPage.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 표를 담은 팝업 — 본문이 아니라 표가 스크롤한다. 툴바·푸터는 늘 보인다.
+ * SPopup 의 본문은 이미 남은 높이를 잡고 있으므로, 본문 루트부터 표까지 세로 축을 잇는다 (§4-2 와 같은 사슬).
+ */
+export default function ExcelFilePopupPage(): import("react").JSX.Element;

package/dist/recipes/LoginPage.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 로그인 전이라 앱 셸이 없다 — AppShell 을 쓰지 않고 회색 바탕 위에 카드 하나만 선다.
+ * 카드는 화면을 잡지 않으므로 바깥 한 겹은 앱이 만든다. 그 한 겹이 하는 일은 셋뿐이다:
+ *   바탕·여백 / items-stretch 로 카드가 높이를 채우게 / justify-center 로 가로 가운데
+ */
+export default function LoginPage(): import("react").JSX.Element;

package/dist/recipes/ProductBulkUploadPage.d.ts

@@ -0,0 +1 @@
+export default function ProductBulkUploadPage(): import("react").JSX.Element;

package/dist/recipes/ProductCreatePage.d.ts

@@ -0,0 +1 @@
+export default function ProductCreatePage(): import("react").JSX.Element;

package/dist/recipes/ProductCreateSectionsPage.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 입력 항목이 많으면 유형별로 SSectionHeaderCard 로 나눈다 (§4-5).
+ * 한 페이지에 섹션 카드가 둘 이상이므로 marker 를 전부 켠다 — 켜거나 끄거나 전부 같게 간다.
+ */
+export default function ProductCreateSectionsPage(): import("react").JSX.Element;

package/dist/recipes/ProductDetailInlineEditPage.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 섹션마다 독립 인라인 폼이 있는 상세 페이지 (§4-4 의 변형).
+ * 섹션 안에서 닫히는 저장·취소는 카드의 button·footerLeft 로 넘긴다 (§3-7-8).
+ *
+ * 이 화면은 섹션마다 스스로 저장하고 끝나 **페이지 전체를 확정하는 액션이 없다** — 그래서 카드 밖
+ * 하단 줄도 두지 않는다. 페이지 단위로 확정·삭제할 것이 있으면 그것만 카드 밖 하단 줄에 둔다
+ * (§4-4 기본형 참조) — 섹션 푸터와 섞지 않는다.
+ */
+export default function ProductDetailInlineEditPage(): import("react").JSX.Element;

package/dist/recipes/ProductDetailPage.d.ts

@@ -0,0 +1 @@
+export default function ProductDetailPage(): import("react").JSX.Element;

package/dist/recipes/ProductListChipFilterPage.d.ts

@@ -0,0 +1 @@
+export default function ProductListChipFilterPage(): import("react").JSX.Element;

package/dist/recipes/ProductListPage.d.ts

@@ -0,0 +1 @@
+export default function ProductListPage(): import("react").JSX.Element;

package/dist/recipes/ProductOverlayPage.d.ts

@@ -0,0 +1 @@
+export default function ProductOverlayPage(): import("react").JSX.Element;

package/dist/recipes/SalesDashboardPage.d.ts

@@ -0,0 +1 @@
+export default function SalesDashboardPage(): import("react").JSX.Element;

package/dist/recipes/SettingsPage.d.ts

@@ -0,0 +1 @@
+export default function SettingsPage(): import("react").JSX.Element;

package/dist/recipes/StoreSetupPage.d.ts

@@ -0,0 +1 @@
+export default function StoreSetupPage(): import("react").JSX.Element;

package/dist/recipes/TransferOrderPopupPage.d.ts

@@ -0,0 +1,2 @@
+export declare function openTransferOrderPopup(orderId: string): void;
+export default function TransferOrderPopupPage(): import("react").JSX.Element;

package/dist/recipes/api.d.ts

@@ -0,0 +1,220 @@
+import type { SDateRangeValue, STableSort } from 'sellmate-design-system-react';
+export type ProductStatus = 'selling' | 'stopped';
+export interface Product {
+    id: number;
+    name: string;
+    category: string;
+    stock: number;
+    price: number;
+    status: ProductStatus;
+    createdAt: string;
+    [key: string]: unknown;
+}
+export declare const STATUS_OPTIONS: {
+    label: string;
+    value: string;
+}[];
+export declare const CATEGORY_OPTIONS: {
+    label: string;
+    value: string;
+}[];
+export interface ProductQuery {
+    status?: string;
+    category?: string;
+    keywords?: string[];
+    /** 등록일 범위 [start, end] — 날짜 피커가 지워지면 null 이 온다 */
+    period?: SDateRangeValue;
+    sort?: STableSort | null;
+    page: number;
+    rowsPerPage: number;
+}
+export declare function useProductList(query: ProductQuery): {
+    rows: Product[];
+    total: number;
+    lastPage: number;
+    loading: boolean;
+};
+export declare function removeProducts(ids: number[]): Promise<void>;
+export declare function saveProduct(values: Record<string, unknown>): Promise<void>;
+/** 상세 화면이 받는 값 — 표시용 문자열로 이미 다듬어져 온다고 본다 */
+export declare function useProduct(id: number): {
+    id: number;
+    name: string;
+    code: string;
+    createdAt: string;
+    category: string;
+    status: ProductStatus;
+    price: string;
+    cost: string;
+    receiver: string;
+    phone: string;
+    address: string;
+};
+export declare const ORDER_TABS: {
+    label: string;
+    value: string;
+}[];
+/** 이동 오더 한 건의 품목·이력 */
+export declare function useTransferOrder(orderId: string): {
+    orderId: string;
+    from: string;
+    to: string;
+    requestedAt: string;
+    items: {
+        id: number;
+        sku: string;
+        name: string;
+        qty: number;
+    }[];
+    history: {
+        id: number;
+        at: string;
+        action: string;
+        by: string;
+    }[];
+};
+export declare function applyExcelFiles(ids: number[]): Promise<void>;
+/** 업로드한 엑셀 파일 목록 */
+export declare function useExcelFiles(query: {
+    keyword?: string;
+    page: number;
+    rowsPerPage: number;
+}): {
+    rows: {
+        id: number;
+        fileName: string;
+        uploadedAt: string;
+        rows: number;
+    }[];
+    total: number;
+    lastPage: number;
+};
+/** 대시보드 지표 — 조회 기간(`period`)을 받아 요약 값·차트 데이터를 한 번에 돌려준다 */
+export declare function useSalesDashboard(query: {
+    period: SDateRangeValue;
+    channel?: string;
+}): {
+    summary: {
+        value: number;
+        label: string;
+        unit: string;
+        change: number;
+    }[];
+    daily: {
+        categories: string[];
+        dates: string[];
+        data: number[];
+    };
+    channelShare: {
+        name: string;
+        value: number;
+    }[];
+    topProducts: {
+        categories: string[];
+        data: number[];
+    };
+};
+export declare const CHANNEL_OPTIONS: {
+    label: string;
+    value: string;
+}[];
+/** 카테고리 트리 — 대분류 아래 중분류가 달린다 */
+export interface Category {
+    id: string;
+    name: string;
+    code: string;
+    productCount: number;
+    children?: Category[];
+}
+export declare function useCategoryTree(): Category[];
+/** 고른 카테고리 하나 — 상위 이름을 경로로 붙여 돌려준다 */
+export declare function useCategory(id: string): {
+    path: string;
+    useYn: string;
+    memo: string;
+    id: string;
+    name: string;
+    code: string;
+    productCount: number;
+    children?: Category[];
+} | undefined;
+export declare function saveCategory(values: Record<string, unknown>): Promise<void>;
+export declare function removeCategory(id: string): Promise<void>;
+export declare const SETTINGS_TABS: {
+    label: string;
+    value: string;
+}[];
+/** 환경 설정 — 탭마다 따로 읽고 따로 저장한다 */
+export declare function useSettings(tab: string): Record<string, unknown>;
+export declare function saveSettings(tab: string, values: Record<string, unknown>): Promise<void>;
+/** 엑셀 일괄 등록 — 올린 파일을 검증한 결과 */
+export interface UploadRow {
+    id: number;
+    row: number;
+    name: string;
+    price: number;
+    error?: string;
+    [key: string]: unknown;
+}
+export declare function validateUpload(values: Record<string, unknown>): Promise<UploadRow[]>;
+export declare function downloadErrorRows(rows: UploadRow[]): Promise<void>;
+export declare function commitUpload(rows: UploadRow[]): Promise<number>;
+/** 초기 설정 — 단계마다 따로 저장하고, 저장한 단계는 완료로 남는다 */
+export declare const SETUP_STEPS: {
+    label: string;
+    value: string;
+    group: string;
+}[];
+/**
+ * 서버가 아는 단계별 상태 — 완료한 단계와 다시 확인해야 하는 단계.
+ * 오류는 완료한 단계에도 남을 수 있다 (연동은 끝냈지만 인증이 만료된 판매처 등).
+ */
+export declare function useSetupStatus(): {
+    completed: string[];
+    error: string[];
+};
+export declare function useSetupStep(step: string): Record<string, unknown>;
+export declare function saveSetupStep(step: string, values: Record<string, unknown>): Promise<void>;
+/** 상담 — 왼쪽 목록의 한 건 */
+export interface Consult {
+    id: string;
+    customer: string;
+    topic: string;
+    lastMessage: string;
+    status: 'waiting' | 'active' | 'closed';
+}
+export declare const CONSULTS: Consult[];
+/** 대화 한 줄 — 사람이 보낸 메시지이거나, 대화 중간에 시스템이 알리는 사실이다 */
+export type ChatEntry = {
+    kind: 'message';
+    id: string;
+    direction: 'incoming' | 'outgoing';
+    /** YYYY-MM-DD — 날짜가 바뀌는 자리에 구분선을 끼운다 */
+    date: string;
+    time: string;
+    text?: string;
+    variant?: 'default' | 'template';
+    read?: boolean;
+    file?: {
+        name: string;
+        size: number;
+    };
+} | {
+    kind: 'system';
+    id: string;
+    date: string;
+    text: string;
+};
+export declare function useConsultMessages(consultId: string): ChatEntry[];
+/** 답변 템플릿 — 분류마다 여러 개 */
+export declare const REPLY_TEMPLATES: {
+    id: string;
+    name: string;
+    items: {
+        id: string;
+        title: string;
+        body: string;
+    }[];
+}[];
+export declare function sendChatMessage(consultId: string, text: string): Promise<void>;
+export declare function closeConsult(consultId: string): Promise<void>;

package/dist/recipes/recipe-story.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 레시피 스토리가 함께 쓰는 틀.
+ *
+ * 레시피 파일은 소비 앱의 한 라우트라서, 앱 진입점이 주는 두 가지를 여기서 대신 준다 —
+ * 뷰포트 높이(`h-screen`, §4-1)와 `SModal.*` 가 그려질 `SModalOutlet`.
+ */
+import type { Decorator } from '@storybook/react-vite';
+export declare const recipeDecorator: Decorator;
+/**
+ * `Recipes/…` 스토리 meta 의 `parameters.docs`. 설명은 레시피마다 다르므로 받는다.
+ *
+ * ⚠️ meta 의 `parameters` 자체는 **객체 리터럴**로 쓰고 이 함수는 그 안의 `docs` 에만 쓴다 —
+ * `parameters: recipeParameters(…)` 처럼 통째로 함수 결과를 넘기면 Storybook 의 CSF 변환이
+ * 그 자리를 덮어써 `layout: 'fullscreen'` 이 사라진다(캔버스에 16px 여백이 생겨 h-screen 화면이 잘린다).
+ */
+export declare function recipeDocs(description: string): {
+    description: {
+        component: string;
+    };
+    story: {
+        inline: boolean;
+        height: string;
+    };
+};
+/** 각 예시의 "Show code" 에 레시피 파일 원문을 싣는다 */
+export declare const showCode: (code: string) => {
+    docs: {
+        source: {
+            code: string;
+            language: string;
+        };
+    };
+};

package/dist/recipes/router.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 레시피가 기대는 **앱 쪽 라우터**의 자리표시.
+ *
+ * 레시피 페이지는 이 모듈을 `./router` 로 import 한다 — 소비 앱에서는 그 자리에
+ * 쓰는 라우터(react-router·Next 등)의 이동 함수와 경로 파라미터가 온다. 여기서는 아무 데도 가지 않는다.
+ */
+export declare function useNavigate(): (path: string | -1) => void;
+/** 현재 경로의 파라미터 — 레시피에서는 고정값을 돌려준다 */
+export declare function useParams(): Record<string, string>;