npm - @cp949/japanpost-react - Versions diffs - 1.0.4 → 1.0.5 - Mend

@cp949/japanpost-react 1.0.4 → 1.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/dist/client.d.ts CHANGED Viewed

@@ -1,6 +1,42 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
 import { ReactNode, ComponentPropsWithoutRef } from 'react';
+/**
+ * 스타일 의존성이 없는 최소한의 주소 키워드 검색 입력 컴포넌트.
+ * value를 전달하면 제어 모드, 전달하지 않으면 비제어 모드로 동작한다.
+ * 검색 시 trim 처리를 내부에서 수행해 공백만 다른 입력이 별도 쿼리로 번지지 않게 한다.
+ */
+declare const AddressSearchInput: react.ForwardRefExoticComponent<{
+    defaultValue?: string;
+    value?: string;
+    disabled?: boolean;
+    label?: react.ReactNode;
+    buttonLabel?: react.ReactNode;
+    inputProps?: Omit<react.ComponentPropsWithoutRef<"input">, "defaultValue" | "disabled" | "onChange" | "value">;
+    buttonProps?: Omit<react.ComponentPropsWithoutRef<"button">, "children" | "disabled" | "onClick" | "type">;
+} & {
+    onChange?: (query: string) => void;
+    onSearch: (query: string) => void;
+} & react.RefAttributes<HTMLInputElement>>;
+/**
+ * 스타일 의존성이 없는 최소한의 우편번호 입력 컴포넌트.
+ * value를 전달하면 제어 모드, 전달하지 않으면 비제어 모드로 동작한다.
+ * 제출 시에는 표시 형식이 아니라 정규화된 숫자 문자열을 콜백에 넘기는 것이 핵심 계약이다.
+ */
+declare const PostalCodeInput: react.ForwardRefExoticComponent<{
+    defaultValue?: string;
+    value?: string;
+    disabled?: boolean;
+    label?: react.ReactNode;
+    buttonLabel?: react.ReactNode;
+    inputProps?: Omit<react.ComponentPropsWithoutRef<"input">, "defaultValue" | "disabled" | "onChange" | "value">;
+    buttonProps?: Omit<react.ComponentPropsWithoutRef<"button">, "children" | "disabled" | "onClick" | "type">;
+} & {
+    onChange?: (postalCode: string) => void;
+    onSearch: (postalCode: string) => void;
+} & react.RefAttributes<HTMLInputElement>>;
 /**
  * `japanpost-react`의 공개 계약과 내부 정규화 계약을 한 곳에 모아 둔 타입 모음이다.
  * 훅, 입력 컴포넌트, data source, minimal-api 연동 예제가 모두 이 정의를 기준으로 맞물리므로
@@ -260,20 +296,6 @@ type AddressSearchInputProps = BaseTextSearchInputProps & {
     onSearch: (query: string) => void;
 };
-/**
- * 스타일 의존성이 없는 최소한의 주소 키워드 검색 입력 컴포넌트.
- * value를 전달하면 제어 모드, 전달하지 않으면 비제어 모드로 동작한다.
- * 검색 시 trim 처리를 내부에서 수행해 공백만 다른 입력이 별도 쿼리로 번지지 않게 한다.
- */
-declare function AddressSearchInput({ defaultValue, value, disabled, label, buttonLabel, inputProps, buttonProps, onChange, onSearch, }: AddressSearchInputProps): react_jsx_runtime.JSX.Element;
-/**
- * 스타일 의존성이 없는 최소한의 우편번호 입력 컴포넌트.
- * value를 전달하면 제어 모드, 전달하지 않으면 비제어 모드로 동작한다.
- * 제출 시에는 표시 형식이 아니라 정규화된 숫자 문자열을 콜백에 넘기는 것이 핵심 계약이다.
- */
-declare function PostalCodeInput({ defaultValue, value, disabled, label, buttonLabel, inputProps, buttonProps, onChange, onSearch, }: PostalCodeInputProps): react_jsx_runtime.JSX.Element;
 /**
  * 우편번호 조회와 키워드 주소 검색을 하나의 인터페이스로 제공하는 통합 훅.
  * 두 검색 모드가 공유하는 data source를 내부에서 재사용하고,

package/dist/client.es.js CHANGED Viewed

@@ -1,9 +1,9 @@
 "use client";
-import { useState, useMemo, useRef, useCallback, useEffect } from 'react';
+import { forwardRef, useState, useMemo, useRef, useCallback, useEffect } from 'react';
 import { jsxs, jsx } from 'react/jsx-runtime';
 // src/components/AddressSearchInput.tsx
-function AddressSearchInput({
+var AddressSearchInput = forwardRef(function AddressSearchInput2({
   defaultValue = "",
   value,
   disabled,
@@ -13,7 +13,7 @@ function AddressSearchInput({
   buttonProps,
   onChange,
   onSearch
-}) {
+}, ref) {
   const [internalValue, setInternalValue] = useState(defaultValue);
   const currentValue = value ?? internalValue;
   function handleSubmit(event) {
@@ -33,6 +33,7 @@ function AddressSearchInput({
         "input",
         {
           ...inputProps,
+          ref,
           disabled,
           value: currentValue,
           onChange: (event) => handleChange(event.target.value)
@@ -41,52 +42,55 @@ function AddressSearchInput({
     ] }),
     /* @__PURE__ */ jsx("button", { ...buttonProps, disabled, type: "submit", children: buttonLabel })
   ] });
-}
+});
 // src/core/formatters.ts
 function normalizeJapanPostalCode(value) {
   return value.replace(/[^\d]/g, "");
 }
-function PostalCodeInput({
-  defaultValue = "",
-  value,
-  disabled,
-  label = "Postal code",
-  buttonLabel = "Search",
-  inputProps,
-  buttonProps,
-  onChange,
-  onSearch
-}) {
-  const [internalValue, setInternalValue] = useState(defaultValue);
-  const currentValue = value ?? internalValue;
-  function handleSubmit(event) {
-    event.preventDefault();
-    onSearch(normalizeJapanPostalCode(currentValue));
-  }
-  function handleChange(nextValue) {
-    if (value === void 0) {
-      setInternalValue(nextValue);
+var PostalCodeInput = forwardRef(
+  function PostalCodeInput2({
+    defaultValue = "",
+    value,
+    disabled,
+    label = "Postal code",
+    buttonLabel = "Search",
+    inputProps,
+    buttonProps,
+    onChange,
+    onSearch
+  }, ref) {
+    const [internalValue, setInternalValue] = useState(defaultValue);
+    const currentValue = value ?? internalValue;
+    function handleSubmit(event) {
+      event.preventDefault();
+      onSearch(normalizeJapanPostalCode(currentValue));
     }
-    onChange?.(nextValue);
+    function handleChange(nextValue) {
+      if (value === void 0) {
+        setInternalValue(nextValue);
+      }
+      onChange?.(nextValue);
+    }
+    return /* @__PURE__ */ jsxs("form", { onSubmit: handleSubmit, children: [
+      /* @__PURE__ */ jsxs("label", { children: [
+        label,
+        /* @__PURE__ */ jsx(
+          "input",
+          {
+            ...inputProps,
+            ref,
+            disabled,
+            inputMode: inputProps?.inputMode ?? "numeric",
+            value: currentValue,
+            onChange: (event) => handleChange(event.target.value)
+          }
+        )
+      ] }),
+      /* @__PURE__ */ jsx("button", { ...buttonProps, disabled, type: "submit", children: buttonLabel })
+    ] });
   }
-  return /* @__PURE__ */ jsxs("form", { onSubmit: handleSubmit, children: [
-    /* @__PURE__ */ jsxs("label", { children: [
-      label,
-      /* @__PURE__ */ jsx(
-        "input",
-        {
-          ...inputProps,
-          disabled,
-          inputMode: inputProps?.inputMode ?? "numeric",
-          value: currentValue,
-          onChange: (event) => handleChange(event.target.value)
-        }
-      )
-    ] }),
-    /* @__PURE__ */ jsx("button", { ...buttonProps, disabled, type: "submit", children: buttonLabel })
-  ] });
-}
+);
 // src/core/errors.ts
 function createJapanAddressError(code, message, options) {
@@ -99,8 +103,24 @@ function createJapanAddressError(code, message, options) {
 }
 // src/react/toJapanAddressError.ts
+var JAPAN_ADDRESS_ERROR_CODES = /* @__PURE__ */ new Set([
+  "invalid_postal_code",
+  "invalid_query",
+  "network_error",
+  "timeout",
+  "not_found",
+  "bad_response",
+  "data_source_error"
+]);
+function isJapanAddressError(error) {
+  if (typeof error !== "object" || error === null) {
+    return false;
+  }
+  const maybeError = error;
+  return maybeError.name === "JapanAddressError" && typeof maybeError.code === "string" && JAPAN_ADDRESS_ERROR_CODES.has(maybeError.code);
+}
 function toJapanAddressError(error) {
-  if (typeof error === "object" && error !== null && "code" in error && typeof error.code === "string") {
+  if (isJapanAddressError(error)) {
     return error;
   }
   return createJapanAddressError(

package/dist/index.d.ts CHANGED Viewed

@@ -1,6 +1,42 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
 import { ReactNode, ComponentPropsWithoutRef } from 'react';
+/**
+ * 스타일 의존성이 없는 최소한의 주소 키워드 검색 입력 컴포넌트.
+ * value를 전달하면 제어 모드, 전달하지 않으면 비제어 모드로 동작한다.
+ * 검색 시 trim 처리를 내부에서 수행해 공백만 다른 입력이 별도 쿼리로 번지지 않게 한다.
+ */
+declare const AddressSearchInput: react.ForwardRefExoticComponent<{
+    defaultValue?: string;
+    value?: string;
+    disabled?: boolean;
+    label?: react.ReactNode;
+    buttonLabel?: react.ReactNode;
+    inputProps?: Omit<react.ComponentPropsWithoutRef<"input">, "defaultValue" | "disabled" | "onChange" | "value">;
+    buttonProps?: Omit<react.ComponentPropsWithoutRef<"button">, "children" | "disabled" | "onClick" | "type">;
+} & {
+    onChange?: (query: string) => void;
+    onSearch: (query: string) => void;
+} & react.RefAttributes<HTMLInputElement>>;
+/**
+ * 스타일 의존성이 없는 최소한의 우편번호 입력 컴포넌트.
+ * value를 전달하면 제어 모드, 전달하지 않으면 비제어 모드로 동작한다.
+ * 제출 시에는 표시 형식이 아니라 정규화된 숫자 문자열을 콜백에 넘기는 것이 핵심 계약이다.
+ */
+declare const PostalCodeInput: react.ForwardRefExoticComponent<{
+    defaultValue?: string;
+    value?: string;
+    disabled?: boolean;
+    label?: react.ReactNode;
+    buttonLabel?: react.ReactNode;
+    inputProps?: Omit<react.ComponentPropsWithoutRef<"input">, "defaultValue" | "disabled" | "onChange" | "value">;
+    buttonProps?: Omit<react.ComponentPropsWithoutRef<"button">, "children" | "disabled" | "onClick" | "type">;
+} & {
+    onChange?: (postalCode: string) => void;
+    onSearch: (postalCode: string) => void;
+} & react.RefAttributes<HTMLInputElement>>;
 /**
  * minimal-api가 그대로 받는 공개 searchcode 요청 타입이다.
  * pageNumber/rowsPerPage를 노출하는 이유는 라이브러리와 API 예제가 같은 pager 의미 체계를 공유하기 위해서다.
@@ -221,20 +257,6 @@ type AddressSearchInputProps = BaseTextSearchInputProps & {
     onSearch: (query: string) => void;
 };
-/**
- * 스타일 의존성이 없는 최소한의 주소 키워드 검색 입력 컴포넌트.
- * value를 전달하면 제어 모드, 전달하지 않으면 비제어 모드로 동작한다.
- * 검색 시 trim 처리를 내부에서 수행해 공백만 다른 입력이 별도 쿼리로 번지지 않게 한다.
- */
-declare function AddressSearchInput({ defaultValue, value, disabled, label, buttonLabel, inputProps, buttonProps, onChange, onSearch, }: AddressSearchInputProps): react_jsx_runtime.JSX.Element;
-/**
- * 스타일 의존성이 없는 최소한의 우편번호 입력 컴포넌트.
- * value를 전달하면 제어 모드, 전달하지 않으면 비제어 모드로 동작한다.
- * 제출 시에는 표시 형식이 아니라 정규화된 숫자 문자열을 콜백에 넘기는 것이 핵심 계약이다.
- */
-declare function PostalCodeInput({ defaultValue, value, disabled, label, buttonLabel, inputProps, buttonProps, onChange, onSearch, }: PostalCodeInputProps): react_jsx_runtime.JSX.Element;
 /**
  * 라이브러리 전반에서 공통으로 쓰는 오류 객체 생성기다.
  * 브라우저 fetch 오류, validation 오류, data source 오류를 모두 같은 표면으로 맞춰

package/dist/index.es.js CHANGED Viewed

@@ -1,8 +1,8 @@
-import { useState, useMemo, useRef, useCallback, useEffect } from 'react';
+import { forwardRef, useState, useMemo, useRef, useCallback, useEffect } from 'react';
 import { jsxs, jsx } from 'react/jsx-runtime';
 // src/components/AddressSearchInput.tsx
-function AddressSearchInput({
+var AddressSearchInput = forwardRef(function AddressSearchInput2({
   defaultValue = "",
   value,
   disabled,
@@ -12,7 +12,7 @@ function AddressSearchInput({
   buttonProps,
   onChange,
   onSearch
-}) {
+}, ref) {
   const [internalValue, setInternalValue] = useState(defaultValue);
   const currentValue = value ?? internalValue;
   function handleSubmit(event) {
@@ -32,6 +32,7 @@ function AddressSearchInput({
         "input",
         {
           ...inputProps,
+          ref,
           disabled,
           value: currentValue,
           onChange: (event) => handleChange(event.target.value)
@@ -40,7 +41,7 @@ function AddressSearchInput({
     ] }),
     /* @__PURE__ */ jsx("button", { ...buttonProps, disabled, type: "submit", children: buttonLabel })
   ] });
-}
+});
 // src/core/formatters.ts
 function normalizeJapanPostalCode(value) {
@@ -53,46 +54,49 @@ function formatJapanPostalCode(value) {
   }
   return `${normalized.slice(0, 3)}-${normalized.slice(3)}`;
 }
-function PostalCodeInput({
-  defaultValue = "",
-  value,
-  disabled,
-  label = "Postal code",
-  buttonLabel = "Search",
-  inputProps,
-  buttonProps,
-  onChange,
-  onSearch
-}) {
-  const [internalValue, setInternalValue] = useState(defaultValue);
-  const currentValue = value ?? internalValue;
-  function handleSubmit(event) {
-    event.preventDefault();
-    onSearch(normalizeJapanPostalCode(currentValue));
-  }
-  function handleChange(nextValue) {
-    if (value === void 0) {
-      setInternalValue(nextValue);
+var PostalCodeInput = forwardRef(
+  function PostalCodeInput2({
+    defaultValue = "",
+    value,
+    disabled,
+    label = "Postal code",
+    buttonLabel = "Search",
+    inputProps,
+    buttonProps,
+    onChange,
+    onSearch
+  }, ref) {
+    const [internalValue, setInternalValue] = useState(defaultValue);
+    const currentValue = value ?? internalValue;
+    function handleSubmit(event) {
+      event.preventDefault();
+      onSearch(normalizeJapanPostalCode(currentValue));
     }
-    onChange?.(nextValue);
+    function handleChange(nextValue) {
+      if (value === void 0) {
+        setInternalValue(nextValue);
+      }
+      onChange?.(nextValue);
+    }
+    return /* @__PURE__ */ jsxs("form", { onSubmit: handleSubmit, children: [
+      /* @__PURE__ */ jsxs("label", { children: [
+        label,
+        /* @__PURE__ */ jsx(
+          "input",
+          {
+            ...inputProps,
+            ref,
+            disabled,
+            inputMode: inputProps?.inputMode ?? "numeric",
+            value: currentValue,
+            onChange: (event) => handleChange(event.target.value)
+          }
+        )
+      ] }),
+      /* @__PURE__ */ jsx("button", { ...buttonProps, disabled, type: "submit", children: buttonLabel })
+    ] });
   }
-  return /* @__PURE__ */ jsxs("form", { onSubmit: handleSubmit, children: [
-    /* @__PURE__ */ jsxs("label", { children: [
-      label,
-      /* @__PURE__ */ jsx(
-        "input",
-        {
-          ...inputProps,
-          disabled,
-          inputMode: inputProps?.inputMode ?? "numeric",
-          value: currentValue,
-          onChange: (event) => handleChange(event.target.value)
-        }
-      )
-    ] }),
-    /* @__PURE__ */ jsx("button", { ...buttonProps, disabled, type: "submit", children: buttonLabel })
-  ] });
-}
+);
 // src/core/errors.ts
 function createJapanAddressError(code, message, options) {
@@ -134,8 +138,24 @@ function isValidJapanPostalCode(value) {
 }
 // src/react/toJapanAddressError.ts
+var JAPAN_ADDRESS_ERROR_CODES = /* @__PURE__ */ new Set([
+  "invalid_postal_code",
+  "invalid_query",
+  "network_error",
+  "timeout",
+  "not_found",
+  "bad_response",
+  "data_source_error"
+]);
+function isJapanAddressError(error) {
+  if (typeof error !== "object" || error === null) {
+    return false;
+  }
+  const maybeError = error;
+  return maybeError.name === "JapanAddressError" && typeof maybeError.code === "string" && JAPAN_ADDRESS_ERROR_CODES.has(maybeError.code);
+}
 function toJapanAddressError(error) {
-  if (typeof error === "object" && error !== null && "code" in error && typeof error.code === "string") {
+  if (isJapanAddressError(error)) {
     return error;
   }
   return createJapanAddressError(

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@cp949/japanpost-react",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "Headless React hooks and optional components for Japan Post postcode and address search",
   "type": "module",
   "author": "cp949",
@@ -66,7 +66,7 @@
   "scripts": {
     "dev": "tsup --config tsup.config.ts --watch",
     "build": "tsup --config tsup.config.ts && node scripts/postbuild-client.mjs",
-    "release": "pnpm --dir ../.. readme:package && pnpm --dir ../.. test && pnpm build && pnpm publish --access public --no-git-checks",
+    "release": "pnpm --dir ../.. readme:package && pnpm --dir ../.. test && pnpm build && pnpm publish --access public",
     "lint": "biome lint .",
     "check-types": "tsc --noEmit",
     "test": "pnpm test:unit",