sellmate-design-system-react 3.2.0 → 3.3.1

package/eslint/lib/table-column.mjs

@@ -4,21 +4,57 @@
  */
 
 /**
- * 오른쪽 정렬 대상 — 숫자가 들어가는 모든 컬럼.
- * 식별자(주문번호·상품코드)도 숫자라 자릿수를 맞춰야 하므로 포함한다.
+ * 오른쪽 정렬·세 자리 콤마 대상 — 값의 "크기"를 비교하는 수량 컬럼.
+ *
+ * 식별자(주문번호·상품코드)는 자릿수가 있어도 대소를 비교하지 않으므로 뺀다.
+ * 우측 정렬의 근거가 "자릿수를 세로로 맞춰 크기를 읽는다"이고,
+ * 송장번호 `123456789` 에 콤마를 넣으면 `123,456,789` 라는 오표시가 된다.
  */
 export const NUMERIC_LABEL =
-  /금액|가격|단가|판매가|원가|비용|수수료|배송비|할인|합계|총액|잔액|포인트|적립|수량|재고|개수|건수|횟수|비율|퍼센트|평점|점수|무게|용량|길이|면적|번호|코드|순번|순위|나이|연차/;
+  /금액|가격|단가|판매가|원가|비용|수수료|배송비|할인|합계|총액|잔액|포인트|적립|수량|재고|개수|건수|횟수|비율|퍼센트|평점|점수|무게|용량|길이|면적|나이|연차/;
 
 /**
- * 하이픈 등 서식이 들어간 문자열 — 숫자가 아니므로 정렬·서식 규칙 모두 대상이 아니다.
- * (전화번호 010-1234-5678, 사업자번호 123-45-67890)
+ * 식별자 — 숫자로 이루어져 있어도 크기 비교 대상이 아니다.
+ * 정렬·서식 규칙 모두에서 뺀다.
+ *
+ * (전화번호 010-1234-5678, 사업자번호 123-45-67890, 송장번호 123456789)
+ *
+ * `주문`·`오더` 같은 도메인 접두어는 넣지 않는다 — `주문 금액`·`오더 합계` 처럼
+ * 실제 수량 컬럼까지 함께 빠진다. 식별자 쪽은 뒤에 붙는 `번호`·`코드` 로 잡힌다.
  */
-export const IDENTIFIER_ONLY = /전화|휴대폰|연락처|사업자|주민|계좌|우편/;
+export const IDENTIFIER_ONLY =
+  /전화|휴대폰|연락처|사업자|주민|계좌|우편|번호|코드|순번|순위|송장|운송장|전표|슬립|정산서|바코드|SKU|사번|일련/;
+
+/**
+ * 일자·일시 — 서식이 정해진 값이라 우측 정렬도 세 자리 콤마도 대상이 아니다 (§3-4 중앙 정렬).
+ * `format` 에 `Number(` 가 섞여도 숫자로 되살아나지 않게 따로 뺀다.
+ */
+export const DATE_LABEL = /일자|일시|날짜|기간|시각|등록일|수정일|생성일|만료일/;
+
+/**
+ * 상태·구분 컬럼 — 수량 어휘를 부분 문자열로 포함해도 값은 숫자가 아니다.
+ * (`비용 입력 여부` 가 `비용` 에 걸리는 것을 막는다)
+ */
+export const NON_NUMERIC_SUFFIX = /(여부|유무|상태|구분|타입|종류|명|이름)$/;
 
 /** format 본문에 숫자 서식이 있으면 숫자 컬럼으로 본다 */
 export const NUMERIC_FORMAT = /toLocaleString|toFixed|Number\s*\(|parseInt|parseFloat/;
 
+/**
+ * 셀을 우측 정렬하는 클래스.
+ * `align` 은 헤더·셀에 공통 적용되므로 "헤더 가운데 + 셀 우측" 은 `tdClass` 로만 표현된다.
+ */
+export const CELL_RIGHT_CLASS = /\btext-right\b/;
+
+/**
+ * 수량 판정에서 아예 빼야 하는 라벨인지 — 식별자·일자·상태/구분 컬럼.
+ * 라벨 분기·format 분기보다 먼저 확인해야 한다.
+ * (`사업자번호` 처럼 식별자여도 format 에 `Number(` 가 있으면 숫자로 되돌아간다)
+ */
+export function isNonQuantityLabel(label) {
+  return IDENTIFIER_ONLY.test(label) || DATE_LABEL.test(label) || NON_NUMERIC_SUFFIX.test(label);
+}
+
 /** 객체 리터럴에서 프로퍼티 노드를 이름으로 찾는다 */
 export function prop(objectNode, name) {
   return objectNode.properties.find(

package/eslint/rules/require-locale-number.mjs

@@ -1,14 +1,15 @@
 /**
  * 숫자 컬럼은 예외 없이 `toLocaleString()` 으로 세 자리 콤마를 넣도록 강제한다.
  *
- * 전화번호·사업자번호처럼 하이픈이 들어가는 값은 숫자가 아니라 서식이 정해진
- * 문자열이므로 대상에서 뺀다. 그 밖에 예외가 필요하면 `allow` 로 컬럼을 지정한다.
+ * 전화번호·송장번호처럼 식별자로 쓰이는 값은 크기를 비교하는 숫자가 아니라
+ * 서식이 정해진 문자열이므로 대상에서 뺀다 (§5 체크리스트 "번호·코드는 제외").
+ * 그 밖에 예외가 필요하면 `allow` 로 컬럼을 지정한다.
  *
  * AGENTS.md §1-4 / §3-4.
  */
 import {
   NUMERIC_LABEL,
-  IDENTIFIER_ONLY,
+  isNonQuantityLabel,
   prop,
   asColumn,
 } from "../lib/table-column.mjs";
@@ -48,11 +49,12 @@ export default {
         const { labelProp, label, columnName } = column;
         if (columnName && allow.has(columnName)) return;
 
-        // 숫자 컬럼이면 모두 대상 — 하이픈 서식 문자열(전화번호 등)만 뺀다
-        if (!NUMERIC_LABEL.test(label) || IDENTIFIER_ONLY.test(label)) return;
+        // 수량 컬럼이면 모두 대상 — 식별자(전화번호·송장번호)와 상태 컬럼은 뺀다
+        if (!NUMERIC_LABEL.test(label) || isNonQuantityLabel(label)) return;
 
-        // render 로 셀을 직접 그리는 경우는 이 규칙이 판단하지 않는다
-        if (prop(node, "render")) return;
+        // render / renderCell 로 셀을 직접 그리는 경우는 이 규칙이 판단하지 않는다
+        // (renderCell 은 3.x STable 의 `<td>` 커스텀 렌더 — 2.2.0 에서 추가됐다)
+        if (prop(node, "render") || prop(node, "renderCell")) return;
 
         const unit = /금액|가격|단가|판매가|원가|비용|수수료|배송비|할인|합계|총액|잔액/.test(label)
           ? "원"

package/eslint/rules/table-numeric-align.mjs

@@ -3,6 +3,7 @@
  *
  * 자릿수가 세로로 맞아야 값의 크기를 비교할 수 있으므로,
  * 금액·수량·개수처럼 숫자가 들어가는 컬럼은 예외 없이 오른쪽 정렬한다.
+ * 크기를 비교하지 않는 식별자(주문번호·상품코드)는 대상이 아니다.
  *
  * 대상은 `name` · `label` · `field` 를 모두 가진 객체 리터럴(= STableColumn 형태)뿐이라
  * 일반 객체를 오탐하지 않는다.
@@ -12,8 +13,9 @@
 
 import {
   NUMERIC_LABEL,
-  IDENTIFIER_ONLY,
   NUMERIC_FORMAT,
+  CELL_RIGHT_CLASS,
+  isNonQuantityLabel,
   prop,
   literalString,
   asColumn,
@@ -53,13 +55,18 @@ export default {
         const { labelProp, label, columnName } = column;
         if (columnName && allow.has(columnName)) return;
 
+        // 식별자(송장번호)·상태 컬럼(비용 입력 여부)은 크기를 비교하지 않는다.
+        // label·format 두 분기보다 먼저 빼야 format 의 `Number(` 로 되살아나지 않는다.
+        if (isNonQuantityLabel(label)) return;
+
+        // render/renderCell 로 셀을 직접 그리면 라벨만으로 숫자 여부를 알 수 없다
+        // (`정산서 번호` → 링크, `순번` → 핀 아이콘). 실제 숫자 서식이 있을 때만 숫자로 본다.
+        const renderProp = prop(node, "renderCell") ?? prop(node, "render");
+        if (renderProp && !NUMERIC_FORMAT.test(context.sourceCode.getText(renderProp))) return;
+
         // 숫자 판정 — label 키워드 또는 format 의 숫자 서식
         let reason = "";
-        let numeric = false;
-
-        if (NUMERIC_LABEL.test(label) && !IDENTIFIER_ONLY.test(label)) {
-          numeric = true;
-        }
+        let numeric = NUMERIC_LABEL.test(label);
 
         const formatProp = prop(node, "format");
         if (formatProp) {
@@ -75,6 +82,10 @@ export default {
         const alignProp = prop(node, "align");
         if (literalString(alignProp) === "right") return;
 
+        // align 은 헤더·셀 공통이라 "헤더 가운데 + 셀 우측" 은 tdClass 로만 표현된다
+        const tdClassProp = prop(node, "tdClass");
+        if (tdClassProp && CELL_RIGHT_CLASS.test(context.sourceCode.getText(tdClassProp))) return;
+
         context.report({
           node: alignProp ?? labelProp,
           messageId: "needsRight",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sellmate-design-system-react",
-  "version": "3.2.0",
+  "version": "3.3.1",
   "description": "Sellmate Design System — React (TypeScript + Tailwind v4) port",
   "license": "UNLICENSED",
   "keywords": [