@iyulab/enterprise 0.14.0 → 0.16.0

package/dist/index.js

@@ -741,37 +741,42 @@ function createODataService(config) {
 			details
 		};
 	}
-	/** 에러 확인 후 throw. 401 은 onUnauthorized 통지 후 세션 만료 에러로 단락. */
-	async function throwIfError(res) {
+	/**
+	* 에러 확인 후 throw. 401 은 기본적으로 `onUnauthorized` 통지 후 세션 만료 에러로 단락한다.
+	*
+	* ⚠`opts.onUnauthorized === false` 면 그 단락을 건너뛰고 **다른 상태 코드와 똑같이** 다룬다 —
+	* 훅도 부르지 않고 메시지도 덮어쓰지 않는다(`ODataRequestOptions.onUnauthorized` 참조).
+	*/
+	async function throwIfError(res, opts) {
 		if (res.ok) return;
-		if (res.status === 401) {
+		if (res.status === 401 && opts?.onUnauthorized !== false) {
 			config.onUnauthorized?.(401);
 			throw new ApiError(messages.sessionExpired, 401);
 		}
 		const { message, details } = await extractErrorInfo(res);
 		throw new ApiError(message, res.status, details);
 	}
-	async function odataGet(entity, params) {
+	async function odataGet(entity, params, opts) {
 		const u = new URL(odataUrl(entity));
 		if (params) for (const [k, v] of Object.entries(params)) u.searchParams.set(k, v);
 		const res = await client.get(u.toString());
-		await throwIfError(res);
+		await throwIfError(res, opts);
 		const json = await res.json();
 		return json.value ?? json;
 	}
-	async function odataGetById(entity, id) {
+	async function odataGetById(entity, id, opts) {
 		const res = await client.get(`${odataUrl(entity)}(${id})`);
-		await throwIfError(res);
+		await throwIfError(res, opts);
 		return res.json();
 	}
-	async function odataCount(entity, filter) {
+	async function odataCount(entity, filter, opts) {
 		const qs = buildQuery({
 			filter,
 			top: 0,
 			count: true
 		});
 		const res = await client.get(`${odataUrl(entity)}${qs}`);
-		await throwIfError(res);
+		await throwIfError(res, opts);
 		return (await res.json())["@odata.count"] ?? 0;
 	}
 	/**
@@ -797,79 +802,77 @@ function createODataService(config) {
 			throw e;
 		}
 	}
-	async function odataPostQuiet(entity, body) {
+	async function odataPostQuiet(entity, body, opts) {
 		const res = await client.post(odataUrl(entity), normalizeBody(body));
-		await throwIfError(res);
+		await throwIfError(res, opts);
 		return res.json();
 	}
-	async function odataPost(entity, body) {
+	async function odataPost(entity, body, opts) {
 		return notifyingWrite(async () => {
-			const result = await odataPostQuiet(entity, body);
+			const result = await odataPostQuiet(entity, body, opts);
 			notifySuccess?.(messages.saved);
 			return result;
 		});
 	}
-	async function odataPatchQuiet(entity, id, body) {
-		await throwIfError(await client.patch(`${odataUrl(entity)}(${id})`, normalizeBody(body)));
+	async function odataPatchQuiet(entity, id, body, opts) {
+		await throwIfError(await client.patch(`${odataUrl(entity)}(${id})`, normalizeBody(body)), opts);
 	}
-	async function odataPatch(entity, id, body) {
+	async function odataPatch(entity, id, body, opts) {
 		return notifyingWrite(async () => {
-			await odataPatchQuiet(entity, id, body);
+			await odataPatchQuiet(entity, id, body, opts);
 			notifySuccess?.(messages.updated);
 		});
 	}
-	async function odataDeleteQuiet(entity, id) {
-		await throwIfError(await client.delete(`${odataUrl(entity)}(${id})`));
+	async function odataDeleteQuiet(entity, id, opts) {
+		await throwIfError(await client.delete(`${odataUrl(entity)}(${id})`), opts);
 	}
-	async function odataDelete(entity, id) {
+	async function odataDelete(entity, id, opts) {
 		return notifyingWrite(async () => {
-			await odataDeleteQuiet(entity, id);
+			await odataDeleteQuiet(entity, id, opts);
 			notifySuccess?.(messages.deleted);
 		});
 	}
-	async function apiGet(path) {
+	async function apiGet(path, opts) {
 		const [p, ...q] = path.split("?");
 		const url = q.length ? `${apiUrl(p)}?${q.join("?")}` : apiUrl(p);
 		const res = await client.get(url);
-		await throwIfError(res);
+		await throwIfError(res, opts);
 		return parseJsonBody(res);
 	}
-	async function apiPostQuiet(path, body) {
+	async function apiPostQuiet(path, body, opts) {
 		const res = await client.post(apiUrl(path), body ?? {});
-		await throwIfError(res);
+		await throwIfError(res, opts);
 		return parseJsonBody(res);
 	}
-	async function apiPost(path, body) {
-		return notifyingWrite(() => apiPostQuiet(path, body));
+	async function apiPost(path, body, opts) {
+		return notifyingWrite(() => apiPostQuiet(path, body, opts));
 	}
-	async function apiPutQuiet(path, body) {
+	async function apiPutQuiet(path, body, opts) {
 		const res = await client.put(apiUrl(path), body ?? {});
-		await throwIfError(res);
+		await throwIfError(res, opts);
 		return parseJsonBody(res);
 	}
-	async function apiPut(path, body) {
-		return notifyingWrite(() => apiPutQuiet(path, body));
+	async function apiPut(path, body, opts) {
+		return notifyingWrite(() => apiPutQuiet(path, body, opts));
 	}
-	async function apiPatchQuiet(path, body) {
+	async function apiPatchQuiet(path, body, opts) {
 		const res = await client.patch(apiUrl(path), body ?? {});
-		await throwIfError(res);
+		await throwIfError(res, opts);
 		return parseJsonBody(res);
 	}
-	async function apiPatch(path, body) {
-		return notifyingWrite(() => apiPatchQuiet(path, body));
+	async function apiPatch(path, body, opts) {
+		return notifyingWrite(() => apiPatchQuiet(path, body, opts));
 	}
-	async function apiDeleteQuiet(path) {
+	async function apiDeleteQuiet(path, opts) {
 		const res = await client.delete(apiUrl(path));
-		await throwIfError(res);
+		await throwIfError(res, opts);
 		return parseJsonBody(res);
 	}
-	async function apiDelete(path) {
-		return notifyingWrite(() => apiDeleteQuiet(path));
+	async function apiDelete(path, opts) {
+		return notifyingWrite(() => apiDeleteQuiet(path, opts));
 	}
 	async function fetchRaw(url) {
-		const res = await client.get(url);
-		await throwIfError(res);
-		return res;
+		return client.get(url);
 	}
 	return {
 		odataUrl,

package/dist/styles/preset.css

@@ -7,9 +7,11 @@
  * ⚠**`@iyulab/components` 1.21.0 이상이 필요하다.** 이 파일은 값만 정하고, 그 값을 **읽는
  *   쪽은 컴포넌트**다. 1.20.0 이하에는 타입 스케일·반경 상단 축이 아예 없어서 여기 적은
  *   `--u-text-*` 는 **아무도 읽지 않는다** — 에러 없이 절반만 적용된 것처럼 보인다.
- *   `peerDependencies` 에 선언해 두었으나 **optional** 이다(프리셋을 쓰지 않는 소비자는
- *   `components` 자체가 필요 없다). 즉 버전 불일치는 **경고 없이 조용하다** — 프리셋을
- *   로드했는데 글자 크기가 안 바뀌면 먼저 이 버전을 본다.
+ *   ⚠**이 peer 는 optional 이 아니다**(종전 판이 그렇게 적고 있었으나 사실이 아니었다 —
+ *   이 패키지의 **런타임 코드가** `@iyulab/components/dist/utilities/` 의 `Locale`·`format`·`icons`
+ *   를 import 한다). 프리셋을 쓰지 않는 소비자에게도 필요하다.
+ *   ⇒ 버전 불일치는 npm 이 설치 단계에서 말해 준다. 프리셋을 로드했는데 글자 크기가 안 바뀌면
+ *   먼저 이 버전을, 그다음 아래 ⑶의 **로드 순서**를 본다.
  *
  * `@iyulab/components` 가 여는 **토큰 축**에 이유랩의 값을 채운 한 장이다.
  * 축(이름·단 수)은 `components` 소유이고, 이 파일은 **값만** 정한다.
@@ -24,10 +26,25 @@
  *      소비자가 그 선택자와 특이도 싸움을 하게 되고, 그때부터 이 파일은 프리셋이 아니라
  *      또 하나의 프레임워크가 된다. (`tests/preset-contract.test.ts` 가 지킨다.)
  *   ⑶ 🔴**층은 «로드 순서»로 선다.** 세 층이 전부 `:root`(0,1,0)이므로 나중에 로드된
- *      것이 이긴다 — 소비자가 이미 통제하는 축이다.
+ *      것이 이긴다.
  *
  *        기본값(components/styles/light.css)  →  하우스(이 파일)  →  소비자 브랜드
  *
+ *      ⚠**그런데 「기본값」 층은 «런타임에» 붙는다 — `@iyulab/components` 1.43.x 이하에서는
+ *        위 그림이 성립하지 않았다.** `Theme.init()` 이 내장 시트를 `document.head` **끝**에
+ *        `appendChild` 했고, 정적 `import` 로 올라온 이 파일은 번들러가 **파싱 시점에** 넣으므로
+ *        ***언제나 기본값이 이겼다.*** 즉 머리말이 안내한 `import` 한 줄이 **아무 효과가 없었다.**
+ *      ★**1.44.0 부터 `Theme.init()` 이 내장 시트를 «첫 스타일 앞»에 넣는다** — 기본값 층은
+ *        이름 그대로 가장 낮은 층이므로 위치도 바닥이다. ⇒ **그 판부터 `import` 한 줄이 문서대로
+ *        동작한다**(`peerDependencies` 가 그 하한을 선언한다).
+ *      ⚠**1.43.x 이하를 쓰는 소비자가 지금 할 일**: 이 파일을 `?inline` 등으로 문자열로 받아
+ *        `await Theme.init(...)` **뒤에** 직접 `<style>` 로 붙인다. 그 우회는 components 를
+ *        1.44.0 이상으로 올리는 즉시 `import` 한 줄로 줄일 수 있다.
+ *      🔴**이 실패는 조용하다 — 그것이 이 문단이 길어진 이유다.** 오류도 경고도 없고, 두 시트의
+ *        값이 일부만 다르면(실측: 상위 세 단과 반경만 다르고 body·label·caption·overline 은 동일)
+ *        **한 군데도 적용되지 않았는데 적용된 것처럼 보인다.** 프리셋을 로드했는데 글자 크기가
+ *        안 바뀌면 **버전 다음으로 이 순서를 본다.**
+ *
  *      ⚠**종전 판(0.7.0)은 이 자리를 `:where()` 로 감싸 특이도 0 으로 만들었고,
  *        그래서 «한 줄도 적용되지 않았다».** 의도는 옳았다 — *"프리셋이 소비자 브랜드를
  *        덮으면 안 된다"*. 그러나 특이도 0 은 **이겨야 할 상대(기본값)와 지지 말아야 할

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iyulab/enterprise",
-  "version": "0.14.0",
+  "version": "0.16.0",
   "description": "Enterprise utilities and components for iyulab framework",
   "keywords": [
     "enterprise",
@@ -56,6 +56,7 @@
   },
   "devDependencies": {
     "@iyulab/components": "^1.27.0",
+    "@microsoft/api-extractor": "^7.58.8",
     "@types/node": "^26.1.1",
     "@types/react": "^19.2.14",
     "typescript": "^6.0.2",
@@ -65,6 +66,6 @@
   },
   "peerDependencies": {
     "react": ">=18",
-    "@iyulab/components": ">=1.27.0"
+    "@iyulab/components": ">=1.44.0"
   }
 }

package/dist/ApiConfig.d.ts

@@ -1,71 +0,0 @@
-/**
- * API configuration and environment-based endpoint management
- *
- * Supports both development (proxy) and production (same-origin) deployments
- */
-export interface ApiConfigOptions {
-    /** Base URL for all API requests (default: '') */
-    baseUrl?: string;
-    /** OData endpoint prefix (default: '$data') */
-    odataPrefix?: string;
-    /** REST API endpoint prefix (default: 'api') */
-    apiPrefix?: string;
-    /** Force development mode detection */
-    isDevelopment?: boolean;
-}
-export declare class ApiConfig {
-    private static _baseUrl;
-    private static _odataPrefix;
-    private static _apiPrefix;
-    private static _isDevelopment;
-    /**
-     * Initialize API configuration
-     * @param options Configuration options
-     */
-    static initialize(options?: ApiConfigOptions): void;
-    /**
-     * API Base URL (always relative path by default)
-     */
-    static get baseUrl(): string;
-    /**
-     * Manually set Base URL (for testing or custom configurations)
-     */
-    static setBaseUrl(url: string): void;
-    /**
-     * OData endpoint prefix
-     */
-    static get odataPrefix(): string;
-    /**
-     * REST API endpoint prefix
-     */
-    static get apiPrefix(): string;
-    /**
-     * Generate OData endpoint URL
-     * @param entityName Entity name for OData endpoint
-     */
-    static getODataUrl(entityName: string): string;
-    /**
-     * Generate REST API endpoint URL
-     * @param endpoint API endpoint path
-     */
-    static getApiUrl(endpoint: string): string;
-    /**
-     * Generate full URL with query parameters
-     * @param endpoint Endpoint path
-     * @param params Query parameters
-     */
-    static getUrlWithParams(endpoint: string, params: Record<string, string | number | boolean | undefined>): string;
-    /**
-     * Check if running in development environment
-     * Tries to detect from various bundler environments
-     */
-    static get isDevelopment(): boolean;
-    /**
-     * Check if running in production environment
-     */
-    static get isProduction(): boolean;
-    /**
-     * Reset configuration to defaults
-     */
-    static reset(): void;
-}

package/dist/FormRow.d.ts

@@ -1,33 +0,0 @@
-import { CSSProperties, ReactNode } from 'react';
-/**
- * L2 폼 행 — 기본 2열, `full` 이면 1열.
- *
- * 오버라이드 계약(docs/lob-layers.md §2)에 따라 `className`·`style` 을 받아 병합한다.
- * `columns` 는 2열 고정이 맞지 않는 소비자가 **컴포넌트를 복제하지 않고** 조정하는 경로다
- * — 복제가 시작되면 이 계층은 쓰기 전보다 나쁜 상태를 만든다.
- *
- * 🔴**트랙은 `minmax(0, 1fr)` 이지 `1fr` 이 아니다 — 순수 `1fr` 은 «균등» 을 약속하고**
- * **지키지 않는다.** 그리드 아이템의 기본 `min-width: auto` 는 내용의 min-content 아래로
- * 줄어들기를 거부하므로, 한 칸에 긴 내용이 들어오면 그 칸만 부풀고 나머지가 찌그러진다.
- * 실측(400px 컨테이너 · 한 칸에 긴 불가분 문자열): 2열이 **425/8**, 3열이 **425/8/8** 이었고
- * 행 자체가 컨테이너를 넘쳤다. `minmax(0, 1fr)` 은 트랙의 최소를 0 으로 만들어 **자식을**
- * **건드리지 않고** 이를 고친다 — 같은 실측에서 **196/196** · **128/128/128**.
- *
- * ⚠**긴 불가분 내용 자체의 넘침은 별개 축이고 이 컴포넌트의 몫이 아니다.** 칸이 균등해져도
- * 그 안의 긴 문자열은 여전히 자기 칸을 넘는다 — 그것은 셀의 `overflow-wrap` 이 답이다
- * (`@iyulab/components` 의 엘리먼트는 이미 그 값을 갖는다). 같은 실측에서 `overflow-wrap` 을
- * 주면 행의 넘침이 0 이 됐다.
- *
- * 계약은 `tests/form-layout-contract.test.ts` 가 고정한다 — 다만 그 파일은 **«선언» 을 재지**
- * **«배치» 를 재지 않는다**(이 패키지엔 레이아웃을 계산하는 테스트 자리가 없다). 위 수치는
- * 형제 패키지의 브라우저 프로젝트를 계측기로 빌린 일회성 탐침으로 쟀다.
- */
-export declare function FormRow({ children, full, columns, className, style, }: {
-    children: ReactNode;
-    /** 한 행 전체를 한 칸으로 쓴다. `columns` 보다 우선한다. */
-    full?: boolean;
-    /** 열 수. 기본 2. */
-    columns?: number;
-    className?: string;
-    style?: CSSProperties;
-}): import("react").JSX.Element;

package/dist/FormSection.d.ts

@@ -1,26 +0,0 @@
-import { CSSProperties, ReactNode } from 'react';
-/**
- * L2 폼 블록 — 제목이 붙은 필드 묶음.
- *
- * 🔴**제목에 `text-transform: uppercase` 와 `letter-spacing` 을 걸지 않는다**(0.7.0 에서 제거).
- *   ⑴ 한글에는 대문자가 없어 `uppercase` 가 **아무 효과가 없고**, 제목에 영문이 섞이면
- *      그것만 커져 오히려 어수선해진다.
- *   ⑵ 양수 `letter-spacing` 은 **한글 가독성을 떨어뜨린다** — 라틴 소문자 조판 관례를
- *      그대로 옮기면 안 되는 자리다.
- *   ⇒ 위계는 **크기·굵기·색** 세 신호로만 만든다(타입 스케일의 `label` 단).
- *   영문 전용 UI 에서 눈썹 텍스트 느낌이 필요하면 `titleStyle` 로 `--u-text-overline-*`
- *   단을 직접 지정한다 — 그 단은 영문·숫자 라벨을 전제하고 양수 자간을 갖는다.
- *
- * 오버라이드 계약(docs/lob-layers.md §2): 구조는 두고 **children 치환 + prop** 으로 바꾼다.
- * ⚠기본 스타일은 병합 가능한 형태로만 둔다 — 호출자의 `style` 이 뒤에 오므로 필요한
- * 항목만 골라 덮을 수 있다. 인라인으로 굳혀 두면 소비자 CSS 가 이길 수 없어(`!important`
- * 외) 계약이 원천적으로 무효가 된다.
- */
-export declare function FormSection({ title, children, className, style, titleStyle, }: {
-    title: ReactNode;
-    children: ReactNode;
-    className?: string;
-    style?: CSSProperties;
-    /** 제목 줄만 따로 조정할 때. 블록을 통째로 갈아엎지 않기 위한 훅이다. */
-    titleStyle?: CSSProperties;
-}): import("react").JSX.Element;

package/dist/auth/AuthClient.d.ts

@@ -1,46 +0,0 @@
-import { PermissionStore } from './permissions';
-export interface AuthClientMessages {
-    /** 401 로그인 실패 */
-    invalidCredentials: string;
-    /** 기타 로그인 실패(non-401) 폴백 */
-    loginFailed: string;
-    /** 네트워크/예외 */
-    networkError: string;
-}
-export interface LoginResult<TUser> {
-    ok: boolean;
-    user?: TUser;
-    message?: string;
-}
-export interface AuthClientConfig<TUser> {
-    /** 현재 세션 조회 URL (GET) */
-    meUrl: string;
-    /** 로그인 URL (POST, 자격증명을 JSON 바디로) */
-    loginUrl: string;
-    /** 로그아웃 URL (POST) */
-    logoutUrl: string;
-    /** 상대 URL 앞에 붙일 오리진(기본 '' = same-origin). */
-    baseUrl?: string;
-    /** fetch credentials 모드(기본 'same-origin' — 쿠키 세션). */
-    credentials?: RequestCredentials;
-    /** 사용자 대면 문구(로케일). 기본 영어. */
-    messages?: Partial<AuthClientMessages>;
-    /** 로그인 실패(non-401) 응답 바디에서 서버 메시지 추출. 기본: `body.Message ?? body.message`. */
-    extractLoginError?: (body: unknown) => string | undefined;
-    /**
-     * user 에서 권한 코드 배열을 추출. 지정하면 `fetchMe`/`login` 성공 시 권한 store 를 자동 갱신,
-     * `fetchMe`→null / `logout` 시 자동 clear.
-     */
-    getPermissions?: (user: TUser) => string[];
-    /** 권한 자동 갱신 대상 store(기본: `defaultPermissionStore`). */
-    permissionStore?: PermissionStore;
-}
-export interface AuthClient<TUser, TCredentials> {
-    /** 현재 세션 조회. 미인증/세션 만료 시 `null`. 성공 시 권한 store 자동 갱신(getPermissions 지정 시). */
-    fetchMe(): Promise<TUser | null>;
-    /** 로그인. 성공 시 권한 store 자동 갱신(getPermissions 지정 시). */
-    login(credentials: TCredentials): Promise<LoginResult<TUser>>;
-    /** 로그아웃. 권한 store 자동 clear(getPermissions 지정 시). */
-    logout(): Promise<void>;
-}
-export declare function createAuthClient<TUser, TCredentials = Record<string, unknown>>(config: AuthClientConfig<TUser>): AuthClient<TUser, TCredentials>;

package/dist/auth/permissions.d.ts

@@ -1,43 +0,0 @@
-/**
- * 권한 스냅샷 store — 부팅 시점의 현재 사용자 권한 코드 집합을 보관하고
- * `hasPermission`/`hasAny`/`hasAll` 판정을 제공한다. 프레임워크 무관(React·Lit 공통)이며
- * 권한 코드는 **불투명 문자열**로만 다룬다(도메인 의미는 앱이 소유).
- *
- * 부팅 시점 스냅샷 모델 — 권한 변경은 다음 로그인(재-set)까지 반영되지 않는다. 단일 운영자
- * 모델에 충분하며, 실시간 권한 회수/멀티테넌트가 필요하면 `subscribe` 로 반응형 확장 가능.
- */
-export interface PermissionStore {
-    /** 현재 권한 집합을 통째로 교체한다(로그인/세션 조회 성공 시). */
-    set(codes: Iterable<string>): void;
-    /** 현재 권한 집합(읽기 전용). */
-    get(): ReadonlySet<string>;
-    /** 단일 권한 코드 보유 여부. */
-    has(code: string): boolean;
-    /** 주어진 코드 중 하나라도 보유. 빈 목록은 `true`(제약 없음). */
-    hasAny(codes: Iterable<string>): boolean;
-    /** 주어진 코드를 모두 보유. 빈 목록은 `true`. */
-    hasAll(codes: Iterable<string>): boolean;
-    /** 권한을 비운다(로그아웃/세션 만료 시). */
-    clear(): void;
-    /** 권한 변경 구독. 해제 함수를 반환한다. */
-    subscribe(listener: (codes: ReadonlySet<string>) => void): () => void;
-}
-/** 독립적인 권한 store 를 생성한다(테스트 격리·다중 컨텍스트에 유리). */
-export declare function createPermissionStore(initial?: Iterable<string>): PermissionStore;
-/**
- * 기본 싱글톤 권한 store. 앱 전역에서 `hasPermission(code)` 를 어디서나 호출하는
- * 흔한 패턴을 위해 free 함수로 바인딩해 노출한다. 격리가 필요하면 `createPermissionStore()` 를 쓴다.
- */
-export declare const defaultPermissionStore: PermissionStore;
-/** 기본 store 의 권한을 교체한다(부팅 시 `setPermissions(user.Permissions)`). */
-export declare const setPermissions: (codes: Iterable<string>) => void;
-/** 기본 store 의 현재 권한 집합. */
-export declare const getPermissions: () => ReadonlySet<string>;
-/** 기본 store 기준 단일 권한 보유 여부. */
-export declare const hasPermission: (code: string) => boolean;
-/** 기본 store 기준 하나라도 보유. */
-export declare const hasAnyPermission: (codes: Iterable<string>) => boolean;
-/** 기본 store 기준 모두 보유. */
-export declare const hasAllPermissions: (codes: Iterable<string>) => boolean;
-/** 기본 store 권한을 비운다. */
-export declare const clearPermissions: () => void;

package/dist/data/ODataService.d.ts

@@ -1,136 +0,0 @@
-import { HttpResponse } from '@iyulab/http-client';
-/**
- * OData v4 오류 봉투의 `error.details` 항목 — 필드별 검증 실패 상세.
- *
- * 규격(OData JSON Format v4.0)상 각 항목은 `code`/`message` 를 **반드시** 갖고
- * `target`(오류가 난 속성 이름)은 **선택**이다 — 필수로 선언하면 target 을 생략한
- * 서버 응답에서 타입이 거짓말을 하게 된다.
- */
-export interface ApiErrorDetail {
-    code: string;
-    message: string;
-    target?: string;
-}
-/**
- * API 호출 실패 에러 — HTTP status 를 실어 호출부가 상태별 분기(예: 404 도메인 문구)를 할 수 있게 한다.
- * `Error` 를 상속하므로 기존 `e instanceof Error`/`e.message` 소비처는 그대로 동작한다.
- */
-export declare class ApiError extends Error {
-    readonly status: number;
-    /** OData v4 오류 봉투의 `error.details`(필드별 검증 상세) — 서버 응답에 없거나 파싱 실패면 undefined. */
-    readonly details?: ApiErrorDetail[];
-    constructor(message: string, status: number, details?: ApiErrorDetail[]);
-}
-/** 서비스가 토스트/에러에 쓰는 사용자 대면 문구. 기본값은 영어 — 앱이 로케일별로 오버라이드한다. */
-export interface ODataServiceMessages {
-    /** POST 성공 토스트 */
-    saved: string;
-    /** PATCH 성공 토스트 */
-    updated: string;
-    /** DELETE 성공 토스트 */
-    deleted: string;
-    /** 401 세션 만료 시 throw 되는 에러 메시지 */
-    sessionExpired: string;
-    /** status별 매핑이 없을 때의 폴백 */
-    requestFailed: string;
-    /** 서버 raw 메시지가 없거나 너무 길 때 status → 친화 메시지 */
-    http: Record<number, string>;
-}
-export interface ODataServiceConfig {
-    /** 모든 요청의 베이스 URL (예: `window.location.origin`). 슬래시 없이 오리진만. */
-    baseUrl: string;
-    /** OData 엔드포인트 prefix (기본 `$data`) */
-    odataPrefix?: string;
-    /** custom REST 엔드포인트 prefix (기본 `api`) */
-    apiPrefix?: string;
-    /**
-     * 401 응답 시 호출된다(모든 메서드 공통). 세션 만료 리다이렉트는 앱이 결정한다.
-     * 재진입 가드(한 번만 리다이렉트)도 앱 콜백 쪽에서 처리한다 — 라이브러리는 status만 통지.
-     */
-    onUnauthorized?: (status: number) => void;
-    /** 성공/실패 토스트 훅. 생략하면 토스트를 내지 않는다(순수 · 테스트 용이). */
-    notify?: {
-        success?: (message: string) => void;
-        error?: (message: string) => void;
-    };
-    /** 사용자 대면 문구 오버라이드(로케일). 지정한 키만 기본값을 대체한다. */
-    messages?: Partial<ODataServiceMessages>;
-    /**
-     * 에러 메시지 포매팅 오버라이드. 반환값이 있으면 그것을 에러 메시지로 사용한다.
-     * (앱별 정책 — 예: 영문 raw OData 메시지를 로케일 친화 문구로 치환 — 을 여기에 둔다.)
-     */
-    formatError?: (info: {
-        status: number;
-        statusText: string;
-        rawMessage?: string;
-        /** OData v4 `error.details` — 검증을 마친 항목만 실린다(`ApiError.details` 와 같은 값). */
-        details?: ApiErrorDetail[];
-        body?: unknown;
-    }) => string | undefined;
-}
-export interface ODataService {
-    /** 설정된 prefix + baseUrl 로 OData 엔티티 URL 을 만든다(flex-table useODataSource 등에서 사용). */
-    odataUrl(entity: string): string;
-    /** 설정된 prefix + baseUrl 로 REST 엔드포인트 URL 을 만든다. */
-    apiUrl(path: string): string;
-    /** OData GET(목록). `value` 배열을 벗겨 반환한다. */
-    odataGet<T>(entity: string, params?: Record<string, string>): Promise<T[]>;
-    /** OData GET(단건, key). */
-    odataGetById<T>(entity: string, id: string): Promise<T>;
-    /** `$count=true&$top=0` — 데이터 없이 총 건수만. */
-    odataCount(entity: string, filter?: Record<string, unknown>): Promise<number>;
-    /** OData POST(생성) — 토스트 없이 결과만(일괄 처리에서 토스트 폭주 방지). */
-    odataPostQuiet<T>(entity: string, body: Partial<T>): Promise<T>;
-    /** OData POST(생성) — 성공 시 `saved` 토스트. */
-    odataPost<T>(entity: string, body: Partial<T>): Promise<T>;
-    /** OData PATCH(수정) — 토스트 없이 결과만(자식 컬렉션 편집 후 부모의 파생 필드를
-     *  함께 동기화하는 등, 한 사용자 액션이 여러 mutation을 낼 때 토스트 폭주 방지). */
-    odataPatchQuiet<T>(entity: string, id: string, body: Partial<T>): Promise<void>;
-    /** OData PATCH(수정) — 성공 시 `updated` 토스트. */
-    odataPatch<T>(entity: string, id: string, body: Partial<T>): Promise<void>;
-    /** OData DELETE — 토스트 없이(`odataPatchQuiet`와 같은 이유). */
-    odataDeleteQuiet(entity: string, id: string): Promise<void>;
-    /** OData DELETE — 성공 시 `deleted` 토스트. */
-    odataDelete(entity: string, id: string): Promise<void>;
-    /** custom REST GET — 204 등 빈 바디를 안전 파싱. */
-    apiGet<T>(path: string): Promise<T>;
-    /** custom REST POST — 실패 시 `error` 토스트 후 rethrow(401 제외). `body`가 `FormData`
-     *  인스턴스면 그대로(직렬화 없이) 멀티파트로 전송된다 — `@iyulab/http-client`가
-     *  Content-Type을 브라우저 자동 설정에 맡기고 JSON 직렬화 분기를 타지 않는다.
-     *  `apiPut`/`apiPatch`도 동일하게 동작한다. */
-    apiPost<T>(path: string, body?: unknown): Promise<T>;
-    /** custom REST POST — 토스트 없이 결과만(`odataPostQuiet`와 같은 이유: 한 사용자 액션이
-     *  여러 요청을 내거나, 소비자가 자기 래퍼로 이미 통지할 때). */
-    apiPostQuiet<T>(path: string, body?: unknown): Promise<T>;
-    /** custom REST PUT(리소스 전체 교체/생성) — 실패 시 `error` 토스트 후 rethrow(401 제외).
-     *  `body`의 `FormData` 처리는 `apiPost` 참조. */
-    apiPut<T>(path: string, body?: unknown): Promise<T>;
-    /** custom REST PUT — 토스트 없이 결과만. */
-    apiPutQuiet<T>(path: string, body?: unknown): Promise<T>;
-    /** custom REST PATCH — 실패 시 `error` 토스트 후 rethrow(401 제외). `body`의 `FormData`
-     *  처리는 `apiPost` 참조. */
-    apiPatch<T>(path: string, body?: unknown): Promise<T>;
-    /** custom REST PATCH — 토스트 없이 결과만. */
-    apiPatchQuiet<T>(path: string, body?: unknown): Promise<T>;
-    /** custom REST DELETE — 실패 시 `error` 토스트 후 rethrow(401 제외). 대부분 204 No Content. */
-    apiDelete<T = void>(path: string): Promise<T>;
-    /** custom REST DELETE — 토스트 없이 결과만. */
-    apiDeleteQuiet<T = void>(path: string): Promise<T>;
-    /** URL 을 직접 조립한 커스텀 조회(csv-export 등)를 위해 raw 응답을 반환. */
-    fetchRaw(url: string): Promise<HttpResponse>;
-    /**
-     * flex-table `useODataSource` 에 주입할 공용 transport 옵션.
-     * useODataSource 는 자체 fetcher 를 쓰므로 별도로 `onUnauthorized` 를 배선해야 401 처리가 걸린다.
-     */
-    readonly sourceDefaults: {
-        baseUrl: string;
-        onUnauthorized: () => void;
-    };
-    /** `instanceof` 판정을 위해 재노출. (모듈 export `ApiError` 와 동일 클래스) */
-    readonly ApiError: typeof ApiError;
-}
-/**
- * OData v4 + custom REST 서비스를 생성한다.
- * 반환된 서비스는 상태를 공유하지 않는 순수 클로저이므로 여러 개를 만들어도 안전하다(테스트 격리에도 유리).
- */
-export declare function createODataService(config: ODataServiceConfig): ODataService;

package/dist/helpers/CurrencyHelper.d.ts

@@ -1,33 +0,0 @@
-/**
- * Currency formatting utility class.
- *
- * @deprecated The formatting logic now lives in `@iyulab/components`' `formatCurrency`
- * (framework-neutral, lower in the dependency stack so `@iyulab/modern-app` can consume it
- * too). This class is kept as a thin, behavior-preserving wrapper for existing callers —
- * new code should import `formatCurrency`/`formatNumber`/`formatDate` from
- * `@iyulab/components` directly.
- */
-export declare class CurrencyHelper {
-    /**
-     * Format amount as currency string.
-     * @param amount - Amount to format
-     * @param currency - Currency code (default: 'KRW')
-     * @param locale - Locale for formatting (default: 'ko-KR')
-     */
-    static formatCurrency(amount: number | null | undefined, currency?: string, locale?: string): string;
-    /** Format amount as Korean Won (KRW) */
-    static formatKRW(amount: number | null | undefined): string;
-    /** Format amount as US Dollar (USD) */
-    static formatUSD(amount: number | null | undefined): string;
-    /** Format amount as Euro (EUR) */
-    static formatEUR(amount: number | null | undefined): string;
-    /** Format amount as Japanese Yen (JPY) */
-    static formatJPY(amount: number | null | undefined): string;
-    /** Format amount as Chinese Yuan (CNY) */
-    static formatCNY(amount: number | null | undefined): string;
-    /**
-     * Parse currency string to number.
-     * @param value - Currency string to parse
-     */
-    static parseCurrency(value: string): number;
-}