@wipco/sdui 0.1.0

package/dist/rich.d.ts

@@ -0,0 +1,122 @@
+import React__default from 'react';
+export { D as DatePicker, b as DatePickerProps, a as DateRangePicker, c as DateRangePickerProps, d as DateRangeValue } from './DatePicker-CTDcFR7V.js';
+
+/**
+ * Chart — 선언형 recharts 래퍼 (ERP `app/components/widgets/Chart.tsx` 이식).
+ *
+ * bar / line / composed / donut / pie 다섯 계열을 하나의 JSON 직렬화 가능한
+ * 프롭 계약으로 덮는다. 색은 WIPCO 시리즈 토큰(--wp-series-1..8)을 고정 순서로
+ * 배정하고, 툴팁·범례·축은 wp-* 토큰으로 칠한다.
+ *
+ * recharts는 optional peerDependency다 — 설치돼 있지 않으면 안내 플레이스홀더가
+ * 나오고 렌더는 계속된다. 그래서 이 파일은 recharts를 정적으로 import하지 않는다.
+ */
+
+type ChartType = 'bar' | 'line' | 'composed' | 'donut' | 'pie';
+type ChartValueFormat = 'number' | 'currency' | 'percent';
+interface ChartSeries {
+    /** 데이터 레코드에서 읽을 키. */
+    key: string;
+    /** 범례·툴팁에 보일 이름. 없으면 key 그대로. */
+    label?: string;
+    /** CSS 색상 또는 "1"~"8" (→ 시리즈 토큰 N번). 없으면 순서대로 자동 배정. */
+    color?: string;
+    /** composed 전용: 이 시리즈를 어떤 마크로 그릴지. 기본 'bar'. */
+    kind?: 'bar' | 'line' | 'dashed-line';
+    /** 같은 문자열끼리 막대를 쌓는다 (stackId). */
+    stack?: string;
+}
+interface ChartProps {
+    type: ChartType;
+    data: Array<Record<string, unknown>>;
+    /** x축(카테고리) 키. pie/donut에서는 조각 이름 키(기본 'name'). */
+    xKey?: string;
+    series: ChartSeries[];
+    /** 차트 영역 높이(px). 기본 300. */
+    height?: number;
+    /** 값 포맷. currency는 억/만 축약(1.2억, 3,400만). 기본 'number'. */
+    valueFormat?: ChartValueFormat;
+    /** 범례 표시 여부. 기본 true (단일 시리즈 카르테시안 차트는 생략). */
+    legend?: boolean;
+    /** donut 중앙 오버레이 텍스트. */
+    donutCenter?: {
+        label?: string;
+        value?: string;
+    };
+    /** 데이터가 없을 때 보여줄 문구. */
+    emptyText?: string;
+}
+declare function Chart({ type, data, xKey, series, height, valueFormat, legend, donutCenter, emptyText, }: ChartProps): React__default.JSX.Element;
+
+/**
+ * MapPreview — OpenLayers 기반 위치 미리보기 지도 (ERP `app/components/widgets/MapPreview.tsx` 이식).
+ *
+ * 다이얼로그 연계용 소형 위젯. 마커 좌표(WGS84 lat/lng)를 벡터 포인트로 표시하고,
+ * 마커가 3개 이하이면 라벨을 항상 노출, 그 이상이면 호버 시 노출한다.
+ * interactive=false면 정적 미리보기로 상호작용을 잠근다.
+ * 마커 색은 컨테이너에서 --wp-* 토큰을 런타임에 해석해 쓴다(OL 캔버스는 CSS 변수를
+ * 못 읽으므로 해석 실패 시에만 리터럴 폴백). OSM 타일은 네트워크가 필요하다 —
+ * 오프라인에서는 빈 타일로 보인다.
+ *
+ * ol은 optional peerDependency다 — 설치돼 있지 않으면 안내 플레이스홀더가 나오고
+ * 렌더는 계속된다. 그래서 이 파일은 ol을 정적으로 import하지 않는다.
+ */
+
+type MapPreviewTone = 'brand' | 'danger' | 'info';
+interface MapPreviewMarker {
+    lat: number;
+    lng: number;
+    label?: string;
+    tone?: MapPreviewTone;
+}
+interface MapPreviewProps {
+    /** 표시할 위치 목록(WGS84). */
+    markers: MapPreviewMarker[];
+    /** 지도 중심. 생략 시 마커 전체가 보이도록 맞춘다. */
+    center?: {
+        lat: number;
+        lng: number;
+    };
+    /** 줌 레벨. 생략 시 단일 마커 15, 다수 마커는 fit 결과. */
+    zoom?: number;
+    /** 지도 높이(px). 기본 280. */
+    height?: number;
+    /** false면 정적 미리보기(팬/줌/호버 잠금). 기본 true. */
+    interactive?: boolean;
+}
+declare function MapPreview({ markers, center, zoom, height, interactive, }: MapPreviewProps): React__default.JSX.Element;
+
+/**
+ * @wipco/sdui/rich — 무거운 외부 의존성이 붙는 위젯 진입점.
+ *
+ * core(`@wipco/sdui`)는 의존성이 react뿐이어야 한다. 차트(recharts)·지도(ol)처럼
+ * 큰 라이브러리가 필요한 위젯은 여기로 분리해서, core만 쓰는 소비자가 그 라이브러리를
+ * 받지 않게 한다. 두 라이브러리는 optional peerDependency이며, 설치돼 있지 않아도
+ * 각 위젯이 안내 플레이스홀더로 떨어질 뿐 렌더는 죽지 않는다.
+ *
+ * 어휘에 얹는 법:
+ *
+ * ```tsx
+ * import { createRegistry } from '@wipco/sdui';
+ * import { richComponents } from '@wipco/sdui/rich';
+ *
+ * <SduiRenderer page={spec} registry={createRegistry(richComponents)} />
+ * ```
+ *
+ * core의 `registry.tsx`에서 직접 import하면 안 된다 — 그 순간 core 번들이
+ * recharts/ol을 끌고 오게 되어 분리한 의미가 없어진다.
+ */
+
+/**
+ * `createRegistry(richComponents)`로 어휘에 얹는 컴포넌트 묶음.
+ * 타입 표기 대신 satisfies인 이유는 registry.tsx와 같다 — 키 리터럴을 남겨야
+ * `SduiRichComponentName`이 메타데이터 대조에 쓸 어휘 목록이 된다.
+ */
+declare const richComponents: {
+    Chart: typeof Chart;
+    MapPreview: typeof MapPreview;
+};
+/** rich 어휘의 컴포넌트 이름 union — `@wipco/sdui/meta`의 richComponentMeta 키. */
+type SduiRichComponentName = keyof typeof richComponents;
+
+export { Chart, type ChartProps, type ChartSeries, type ChartType, type ChartValueFormat, MapPreview, type MapPreviewMarker, type MapPreviewProps, type MapPreviewTone, type SduiRichComponentName, richComponents };