@iyulab/enterprise 0.9.1 → 0.10.0

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## 0.10.0
+
+### Changed
+
+- **`ProgressHelper.validateProgress`/`ratioToPercent` now return `number | null` instead of
+  folding a missing input into `0`.** "No value yet" and "0% progress" are different facts and
+  were rendering identically. A call site that already narrows its input to a definite `number`
+  keeps getting a definite `number` back (an overload preserves this); a call site that may pass
+  `null`/`undefined` now has to handle a `null` result explicitly.
+- **`CurrencyHelper.formatCurrency`, `DateHelper.formatDate`/`formatLocalDate`/`formatDateTime`,
+  and `UrgencyHelper.formatDaysRemaining` now render a missing value as an em dash (`—`) instead
+  of a hyphen (`-`).** The two glyphs looked almost identical but meant different things; the
+  empty-value string is now one shared constant (`EMPTY_VALUE_DISPLAY`, exported from
+  `@iyulab/enterprise`) instead of eight independent hardcoded literals across the four helpers.
+
 ## 0.9.1
 
 ### Fixed

package/dist/helpers/ProgressHelper.d.ts

@@ -12,17 +12,23 @@ export declare class ProgressHelper {
         medium?: number;
     }): string;
     /**
-     * Validate and clamp progress to 0-100 range
+     * Validate and clamp progress to 0-100 range.
+     *
+     * Returns `null` for a missing/unparsable input rather than `0` — "no progress value yet"
+     * and "0% progress" are different facts and must not render identically.
      * @param progress - Raw progress value
      * @param round - Whether to round to integer (default: true)
      */
-    static validateProgress(progress: number | null | undefined, round?: boolean): number;
+    static validateProgress(progress: number, round?: boolean): number;
+    static validateProgress(progress: number | null | undefined, round?: boolean): number | null;
     /**
-     * Convert decimal ratio to percentage
+     * Convert decimal ratio to percentage.
+     *
+     * Returns `null` for a missing/unparsable input — see {@link validateProgress}.
      * @param ratio - Decimal ratio (0-1)
      * @param round - Whether to round to integer
      */
-    static ratioToPercent(ratio: number | null | undefined, round?: boolean): number;
+    static ratioToPercent(ratio: number | null | undefined, round?: boolean): number | null;
     /**
      * Get progress label text
      * @param progress - Progress value (0-100)

package/dist/helpers/constants.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Display string for an absent value (`null`/`undefined`/unparsable), shared by every
+ * formatting helper in this package so "no value" renders identically everywhere and
+ * never collides with a real `0`.
+ */
+export declare const EMPTY_VALUE_DISPLAY = "\u2014";

package/dist/helpers/index.d.ts

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

package/dist/index.js

@@ -117,6 +117,14 @@ messages.register("ko", {
 	daysRemaining: "{days}일"
 });
 //#endregion
+//#region src/helpers/constants.ts
+/**
+* Display string for an absent value (`null`/`undefined`/unparsable), shared by every
+* formatting helper in this package so "no value" renders identically everywhere and
+* never collides with a real `0`.
+*/
+var EMPTY_VALUE_DISPLAY = "—";
+//#endregion
 //#region src/helpers/CurrencyHelper.ts
 /**
 * Currency formatting utility class.
@@ -135,7 +143,7 @@ var CurrencyHelper = class {
 	* @param locale - Locale for formatting (default: 'ko-KR')
 	*/
 	static formatCurrency(amount, currency = "KRW", locale = "ko-KR") {
-		if (amount === null || amount === void 0) return "-";
+		if (amount === null || amount === void 0) return "—";
 		return formatCurrency(amount, currency, {
 			minimumFractionDigits: 0,
 			maximumFractionDigits: currency === "KRW" ? 0 : 2
@@ -182,9 +190,9 @@ var DateHelper = class {
 	* @param date - Date to format (Date object or ISO string)
 	*/
 	static formatDate(date) {
-		if (!date) return "-";
+		if (!date) return "—";
 		const d = typeof date === "string" ? new Date(date) : date;
-		if (isNaN(d.getTime())) return "-";
+		if (isNaN(d.getTime())) return "—";
 		return d.toISOString().slice(0, 10);
 	}
 	/**
@@ -194,9 +202,9 @@ var DateHelper = class {
 	* @param options - Intl.DateTimeFormat options
 	*/
 	static formatLocalDate(date, locale = "ko-KR", options) {
-		if (!date) return "-";
+		if (!date) return "—";
 		const d = typeof date === "string" ? new Date(date) : date;
-		if (isNaN(d.getTime())) return "-";
+		if (isNaN(d.getTime())) return "—";
 		return d.toLocaleDateString(locale, options || {
 			year: "numeric",
 			month: "2-digit",
@@ -208,9 +216,9 @@ var DateHelper = class {
 	* @param date - Date to format
 	*/
 	static formatDateTime(date) {
-		if (!date) return "-";
+		if (!date) return "—";
 		const d = typeof date === "string" ? new Date(date) : date;
-		if (isNaN(d.getTime())) return "-";
+		if (isNaN(d.getTime())) return "—";
 		return d.toISOString().slice(0, 16).replace("T", " ");
 	}
 	/**
@@ -299,25 +307,22 @@ var ProgressHelper = class {
 		if (progress >= medium) return "#FF9800";
 		return "#F44336";
 	}
-	/**
-	* Validate and clamp progress to 0-100 range
-	* @param progress - Raw progress value
-	* @param round - Whether to round to integer (default: true)
-	*/
 	static validateProgress(progress, round = true) {
-		if (progress === null || progress === void 0 || isNaN(progress)) return 0;
+		if (progress === null || progress === void 0 || isNaN(progress)) return null;
 		let value = progress;
 		if (value < 0) value = 0;
 		if (value > 100) value = 100;
 		return round ? Math.round(value) : value;
 	}
 	/**
-	* Convert decimal ratio to percentage
+	* Convert decimal ratio to percentage.
+	*
+	* Returns `null` for a missing/unparsable input — see {@link validateProgress}.
 	* @param ratio - Decimal ratio (0-1)
 	* @param round - Whether to round to integer
 	*/
 	static ratioToPercent(ratio, round = true) {
-		if (ratio === null || ratio === void 0 || isNaN(ratio)) return 0;
+		if (ratio === null || ratio === void 0 || isNaN(ratio)) return null;
 		const percent = ratio * 100;
 		return this.validateProgress(percent, round);
 	}
@@ -452,7 +457,7 @@ var UrgencyHelper = class {
 	* @param daysRemaining - Days until deadline
 	*/
 	static formatDaysRemaining(daysRemaining) {
-		if (daysRemaining === null || daysRemaining === void 0) return "-";
+		if (daysRemaining === null || daysRemaining === void 0) return "—";
 		if (daysRemaining < 0) return messages.text("daysOverdue", { days: Math.abs(daysRemaining) });
 		if (daysRemaining === 0) return messages.text("daysToday");
 		return messages.text("daysRemaining", { days: daysRemaining });
@@ -977,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, messages, setPermissions };
+export { ApiConfig, ApiError, CurrencyHelper, DateHelper, EMPTY_VALUE_DISPLAY, FormRow, FormSection, ProgressHelper, UrgencyHelper, clearPermissions, createAuthClient, createODataService, createPermissionStore, defaultPermissionStore, getPermissions, hasAllPermissions, hasAnyPermission, hasPermission, messages, setPermissions };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iyulab/enterprise",
-  "version": "0.9.1",
+  "version": "0.10.0",
   "description": "Enterprise utilities and components for iyulab framework",
   "keywords": [
     "enterprise",