@ehfuse/mui-form-controls 3.5.6 → 3.5.7

package/dist/property/PropertyText.d.ts

@@ -13,6 +13,18 @@ import type { SxProps, Theme } from "@mui/material";
 import { type PropertyAppearance } from "./appearance";
 import { type PropertyRowLayoutProps } from "./PropertyRow";
 import { type PropertyBindingProps } from "./binding";
+/**
+ * 속성 칸의 자동 꼴(3.5.7) — "phone" 은 치는 대로 하이픈(010-1234-5678 · 02-123-4567 · 1588-0000), "number" 는 천 단위 쉼표(1,234,000).
+ * 쉼표는 보이기만 하고 저장(onCommit)에는 쉼표 없는 숫자 글이 간다. 전화는 하이픈을 넣은 꼴 그대로 저장한다(폼의 PhoneTextField includeDash 와 같다).
+ */
+export type PropertyInputFormat = "phone" | "number";
+/**
+ * 전화번호 꼴 — 숫자 · 하이픈 · 공백만 친 글에 하이픈을 넣는다. 국제번호(+82) · 내선(내선 12) 같은 글은 친 그대로 둔다.
+ * 끝에 붙는 하이픈("010-")은 뺀다 — 지우는 중에 하이픈이 되살아나 Backspace 가 걸리지 않게, 덜 친 번호가 "010-" 으로 저장되지 않게.
+ */
+export declare function formatPropertyPhone(raw: string): string;
+/** 천 단위 쉼표 — 숫자가 아닌 글은 그대로 둔다(검사는 parse · onCommit 이 한다). */
+export declare function formatPropertyNumber(raw: string): string;
 export interface PropertyInputProps extends PropertyBindingProps<string> {
     placeholder?: string;
     multiline?: boolean;
@@ -29,6 +41,11 @@ export interface PropertyInputProps extends PropertyBindingProps<string> {
      * 저장 전에 친 글을 바꾼다(전화번호 하이픈 · 8자리 날짜 등). null 을 돌려주면 틀린 값 — 저장하지 않고 되돌린다.
      */
     parse?: (raw: string) => string | null;
+    /**
+     * 자동 꼴(3.5.7) — "phone" 은 치는 대로 하이픈, "number" 는 천 단위 쉼표(저장은 쉼표 없는 숫자 글). inputMode 를 안 주면 tel · numeric 이 된다.
+     * 사업자번호 · 주민번호처럼 제 꼴이 있는 번호, 연도 · 우편번호처럼 쉼표가 어색한 숫자에는 주지 않는다.
+     */
+    format?: PropertyInputFormat;
     /** Esc 로 고치기를 물린다(창이 닫히지 않게 이벤트를 멈춘다). 기본 true. */
     escapeReverts?: boolean;
     /** 한글 조합 중의 Enter 에도 칸을 벗어난다(예전 업무함 동작). 기본 false — 조합을 마치는 Enter 는 그대로 둔다. */

package/dist/property/index.d.ts

@@ -8,10 +8,11 @@
 export { DEFAULT_PROPERTY_APPEARANCE, usePropertyAppearance } from "./appearance";
 export type { PropertyAppearance } from "./appearance";
 export { PropertyRow, PropertyGrid, PropertyEmpty, PROPERTY_GRID_TWO_COLUMN_MIN, PROPERTY_GRID_FOUR_COLUMN_MIN, PROPERTY_GRID_FOUR_CQ, } from "./PropertyRow";
+export type { PropertyInputFormat } from "./PropertyText";
 export type { PropertyRowProps, PropertyRowLayoutProps, PropertyGridProps } from "./PropertyRow";
 export { withPropertyForm, writeFormValue } from "./binding";
 export type { PropertyBindingProps, PropertyCommitHandler } from "./binding";
-export { PropertyInput, PROPERTY_BORDERED_SX, PropertyText, PropertyTextArea, PropertyDate, PropertyDateInput, PropertyTextDate, PropertyTextDateInput, isDateText, normalizeDateText, parseDateText } from "./PropertyText";
+export { formatPropertyNumber, formatPropertyPhone, PropertyInput, PROPERTY_BORDERED_SX, PropertyText, PropertyTextArea, PropertyDate, PropertyDateInput, PropertyTextDate, PropertyTextDateInput, isDateText, normalizeDateText, parseDateText } from "./PropertyText";
 export type { PropertyInputProps, PropertyTextProps, PropertyDateInputProps } from "./PropertyText";
 export { PropertySelect, PropertyMultiSelect, PropertySwitch } from "./PropertySelect";
 export type { PropertyOption, PropertySelectValue, PropertySelectProps, PropertyMultiSelectProps, PropertySwitchProps } from "./PropertySelect";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@ehfuse/mui-form-controls",
-    "version": "3.5.6",
+    "version": "3.5.7",
     "description": "Material-UI form controls and text fields for complex forms",
     "private": false,
     "publishConfig": {