@iyulab/enterprise 0.7.0 → 0.8.0

package/dist/helpers/index.d.ts

@@ -2,6 +2,7 @@
  * @iyulab/enterprise Helpers
  * Reusable utility classes for enterprise applications
  */
+export * from './messages';
 export * from './CurrencyHelper';
 export * from './DateHelper';
 export * from './ProgressHelper';

package/dist/helpers/messages.d.ts

@@ -0,0 +1,25 @@
+/**
+ * `@iyulab/enterprise` 의 화면 문자열 — **영어 기본 + 로케일 레지스트리**.
+ *
+ * ## 왜 이 파일이 생겼나
+ *
+ * 헬퍼들이 라벨을 **한국어 리터럴로** 들고 있었다(실측 14건). 이 리포는 이미 로케일 표준을
+ * 채택했지만(영어 기본 + 레지스트리) **강제하는 장치가 없어서** 채택 이후에 들어온 코드가
+ * 한국어 기본값을 갖고 있었다.
+ *
+ * ⚠**「의견 있음」이 정당화하는 것은 스타일 값의 의견이지 언어가 아니다**(2026-08-04 결정).
+ *
+ * ## 왜 자체 레지스트리를 만들지 않았나
+ *
+ * `@iyulab/components` 의 `Locale.namespace()`(1.23.0~)를 쓴다. 자체 구현은 이 조직의
+ * **네 번째 레지스트리**가 됐을 것이고, 그러면 소비자가 앱 하나에서 로케일을 **두 번**
+ * 전환해야 한다. `Locale.set()` 한 번으로 검증 메시지·이 라벨이 함께 따라온다.
+ *
+ * ## 동작 변화
+ *
+ * ⚠기본 로케일은 브라우저 언어에서 감지된다 — **한국어 브라우저는 종전과 같은 문구**를 본다
+ * (`ko-KR` → `ko`). 그 밖의 환경은 한국어 대신 **영어**를 본다. 그것이 이 이주의 목적이다.
+ */
+export type EnterpriseMessageKey = 'progressNotStarted' | 'progressEarly' | 'progressInProgress' | 'progressPastMid' | 'progressAlmost' | 'progressDone' | 'urgencyOverdue' | 'urgencyCritical' | 'urgencyUrgent' | 'urgencySoon' | 'urgencyNormal' | 'daysOverdue' | 'daysToday' | 'daysRemaining';
+/** 이 패키지의 문자열 묶음. 소비자는 `messages.register(locale, table)` 로 덮거나 언어를 더한다. */
+export declare const messages: any;

package/dist/index.js

@@ -1,4 +1,5 @@
 import { jsx, jsxs } from "react/jsx-runtime";
+import { Locale } from "@iyulab/components";
 import { HttpClient } from "@iyulab/http-client";
 import buildQuery from "odata-query";
 //#region src/FormSection.tsx
@@ -79,6 +80,42 @@ function FormRow({ children, full, columns = 2, className, style }) {
 	});
 }
 //#endregion
+//#region src/helpers/messages.ts
+/** 이 패키지의 문자열 묶음. 소비자는 `messages.register(locale, table)` 로 덮거나 언어를 더한다. */
+var messages = Locale.namespace("@iyulab/enterprise");
+messages.register("en", {
+	progressNotStarted: "Not started",
+	progressEarly: "Early stage",
+	progressInProgress: "In progress",
+	progressPastMid: "Past halfway",
+	progressAlmost: "Almost done",
+	progressDone: "Done",
+	urgencyOverdue: "Overdue",
+	urgencyCritical: "Critical",
+	urgencyUrgent: "Urgent",
+	urgencySoon: "Due soon",
+	urgencyNormal: "On track",
+	daysOverdue: "{days} days overdue",
+	daysToday: "Today",
+	daysRemaining: "{days} days left"
+});
+messages.register("ko", {
+	progressNotStarted: "시작 전",
+	progressEarly: "초기 단계",
+	progressInProgress: "진행 중",
+	progressPastMid: "중반 이상",
+	progressAlmost: "거의 완료",
+	progressDone: "완료",
+	urgencyOverdue: "지연",
+	urgencyCritical: "매우 급함",
+	urgencyUrgent: "급함",
+	urgencySoon: "곧 도래",
+	urgencyNormal: "여유",
+	daysOverdue: "{days}일 지연",
+	daysToday: "오늘",
+	daysRemaining: "{days}일"
+});
+//#endregion
 //#region src/helpers/CurrencyHelper.ts
 /**
 * Currency formatting utility class
@@ -295,12 +332,12 @@ var ProgressHelper = class {
 	*/
 	static getProgressLabel(progress) {
 		const validated = this.validateProgress(progress);
-		if (validated === 0) return "시작 전";
-		if (validated < 25) return "초기 단계";
-		if (validated < 50) return "진행 중";
-		if (validated < 75) return "중반 이상";
-		if (validated < 100) return "거의 완료";
-		return "완료";
+		if (validated === 0) return messages.text("progressNotStarted");
+		if (validated < 25) return messages.text("progressEarly");
+		if (validated < 50) return messages.text("progressInProgress");
+		if (validated < 75) return messages.text("progressPastMid");
+		if (validated < 100) return messages.text("progressAlmost");
+		return messages.text("progressDone");
 	}
 	/**
 	* Calculate progress from current and total values
@@ -373,11 +410,11 @@ var UrgencyHelper = class {
 	*/
 	static getUrgencyText(daysRemaining, config, labels) {
 		const defaultLabels = {
-			overdue: "지연",
-			critical: "매우 급함",
-			urgent: "급함",
-			soon: "곧 도래",
-			normal: "여유"
+			overdue: messages.text("urgencyOverdue"),
+			critical: messages.text("urgencyCritical"),
+			urgent: messages.text("urgencyUrgent"),
+			soon: messages.text("urgencySoon"),
+			normal: messages.text("urgencyNormal")
 		};
 		const level = this.getUrgencyLevel(daysRemaining, config);
 		return labels?.[level] || defaultLabels[level];
@@ -421,9 +458,9 @@ var UrgencyHelper = class {
 	*/
 	static formatDaysRemaining(daysRemaining) {
 		if (daysRemaining === null || daysRemaining === void 0) return "-";
-		if (daysRemaining < 0) return `${Math.abs(daysRemaining)}일 지연`;
-		if (daysRemaining === 0) return "오늘";
-		return `${daysRemaining}일`;
+		if (daysRemaining < 0) return messages.text("daysOverdue", { days: Math.abs(daysRemaining) });
+		if (daysRemaining === 0) return messages.text("daysToday");
+		return messages.text("daysRemaining", { days: daysRemaining });
 	}
 	/**
 	* Check if deadline is overdue
@@ -945,4 +982,4 @@ function createAuthClient(config) {
 	};
 }
 //#endregion
-export { ApiConfig, ApiError, CurrencyHelper, DateHelper, FormRow, FormSection, ProgressHelper, UrgencyHelper, clearPermissions, createAuthClient, createODataService, createPermissionStore, defaultPermissionStore, getPermissions, hasAllPermissions, hasAnyPermission, hasPermission, setPermissions };
+export { ApiConfig, ApiError, CurrencyHelper, DateHelper, FormRow, FormSection, ProgressHelper, UrgencyHelper, clearPermissions, createAuthClient, createODataService, createPermissionStore, defaultPermissionStore, getPermissions, hasAllPermissions, hasAnyPermission, hasPermission, messages, setPermissions };

package/dist/styles/preset.css

@@ -23,11 +23,19 @@
  *   ⑵ **`--u-*` 값만 덮는다.** 새 클래스·새 선택자를 만들지 않는다. 만들기 시작하면
  *      소비자가 그 선택자와 특이도 싸움을 하게 되고, 그때부터 이 파일은 프리셋이 아니라
  *      또 하나의 프레임워크가 된다. (`tests/preset-contract.test.ts` 가 지킨다.)
- *   ⑶ 🔴**소비자가 항상 이긴다.** 아래 선택자는 `:where()` 로 감싸 **특이도 0** 이다 —
- *      소비앱의 평범한 `:root { … }` 한 줄이 **로드 순서와 무관하게** 이 값을 덮는다.
- *      ★종전에 소비앱들이 `:root:not([theme="dark"])` 같은 **특이도 방어**를 쓰고 있었는데,
- *      그것은 업스트림이 `:root` 로 선언해 "뒤에 온 쪽이 이기는" 상황을 만들었기 때문이다.
- *      특이도 0 으로 선언하면 그 방어가 통째로 필요 없어진다.
+ *   ⑶ 🔴**층은 «로드 순서»로 선다.** 세 층이 전부 `:root`(0,1,0)이므로 나중에 로드된
+ *      것이 이긴다 — 소비자가 이미 통제하는 축이다.
+ *
+ *        기본값(components/styles/light.css)  →  하우스(이 파일)  →  소비자 브랜드
+ *
+ *      ⚠**종전 판(0.7.0)은 이 자리를 `:where()` 로 감싸 특이도 0 으로 만들었고,
+ *        그래서 «한 줄도 적용되지 않았다».** 의도는 옳았다 — *"프리셋이 소비자 브랜드를
+ *        덮으면 안 된다"*. 그러나 특이도 0 은 **이겨야 할 상대(기본값)와 지지 말아야 할
+ *        상대(브랜드)를 구분하지 못한다.** 기본 시트가 같은 토큰을 `:root` 로 선언하므로
+ *        구조적으로 졌다. 실측: 이 파일의 40선언 중 **기본 시트에 없는 것이 0개** —
+ *        `:where()` 가 이길 수 있는 자리가 하나도 없었다.
+ *      ★그리고 **그 실패는 조용했다.** 오류도 경고도 없고, 소비자에게는
+ *        *"프리셋 값이 우리 값과 우연히 같았나 보다"* 로 보인다.
  *
  * ──────────────────────────────────────────────────────────────────────────
  * 이 프리셋이 정하는 것 / 정하지 않는 것
@@ -39,7 +47,7 @@
  *   안 정한다 **브랜드 색** — 그것은 소비앱의 몫이다. 프리셋은 브랜드를 갖지 않는다.
  * ========================================================================== */
 
-:where(:root) {
+:root {
   /* ==========================================================================
      타이포 — LOB 밀도
      ★업무 화면은 한 화면에 담기는 정보량이 곧 생산성이다. 중립 기본값보다 한 단씩
@@ -120,7 +128,7 @@
  * ★어두운 배경 위의 검은 그림자는 보이지 않는다. 알파를 라이트보다 크게 잡되,
  *   깊이의 대부분은 표면 밝기 차(`--u-bg-color-raised` 등, `components` 소유)가 낸다.
  */
-:where(:root[theme='dark']) {
+:root[theme='dark'] {
   --u-shadow-color-weaker:   rgba(0, 0, 0, 0.20);
   --u-shadow-color-weak:     rgba(0, 0, 0, 0.28);
   --u-shadow-color-normal:   rgba(0, 0, 0, 0.36);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iyulab/enterprise",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Enterprise utilities and components for iyulab framework",
   "keywords": [
     "enterprise",
@@ -45,7 +45,7 @@
   },
   "peerDependencies": {
     "react": ">=18",
-    "@iyulab/components": ">=1.21.0"
+    "@iyulab/components": ">=1.23.0"
   },
   "peerDependenciesMeta": {
     "@iyulab/components": {