sellmate-design-system-react 9.0.0-beta.7 → 9.0.0-beta.71

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/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/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/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,91 @@
+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;
+};

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>;