@greenlabs/rescript-kakao-postcode 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021-2026 Greenlabs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,70 @@
+# 카카오 주소 검색 리스크립트 바인딩
+
+`rescript-kakao-postcode`는 [카카오 주소 검색](https://postcode.map.kakao.com/guide) 자바스크립트 모듈의 리스크립트(ReScript) 바인딩 입니다.
+
+> 기존 `@greenlabs/rescript-daum-postcode` 패키지의 서비스 도메인이 변경됨에 따라 새롭게 만들어진 패키지입니다.
+
+## 설치하기
+
+> ReScript 버전 호환 표
+
+| Compiler | rescript_kakao_postcode |
+| -------- | ---------------------- |
+| v12      | >= v0.1.0              |
+
+1. 모듈 설치
+
+```shell
+npm i @greenlabs/rescript-kakao-postcode
+or
+yarn add @greenlabs/rescript-kakao-postcode
+```
+
+2. `rescript.json` 의존성 추가하기
+
+```json
+"dependencies": [
+  "@greenlabs/rescript-kakao-postcode"
+]
+```
+
+## 사용방법
+
+```rescript
+open KakaoPostCode
+
+let kakaoPostCode = make({
+  oncomplete: data => data->Js.Console.log,
+  onresize: size => size->Js.Console.log,
+  onclose: state =>
+    switch state {
+    | FORCE_CLOSE => "fc"->Js.Console.log
+    | COMPLETE_CLOSE => "cc"->Js.Console.log
+    },
+  onsearch: data => data->Js.Console.log,
+  width: 500.0,
+  height: 700.0,
+})
+
+// 팝업 방식
+kakaoPostCode->openPostCode({
+  q: "문정동",
+  left: 100.0,
+  top: 200.0,
+  popupName: "주소검색",
+  autoClose: true,
+})
+
+// 임베드 방식
+open Webapi
+
+let div = Dom.document |> Dom.Document.getElementById("search-address")
+div->Belt.Option.map(el => kakaoPostCode->embedPostCode(el, {
+  q: "문정동",
+  autoClose: true
+}))->ignore
+```
+
+## API
+
+[카카오 주소 검색 API](https://postcode.map.kakao.com/guide#attributes)

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@greenlabs/rescript-kakao-postcode",
+  "version": "0.1.0",
+  "description": "ReScript binding to Kakao Postcode",
+  "scripts": {
+    "start": "rescript watch",
+    "build": "rescript",
+    "clean": "rescript clean"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/green-labs/rescript-bindings.git",
+    "directory": "packages/rescript-kakao-postcode"
+  },
+  "keywords": [
+    "ReScript",
+    "Kakao Postcode"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": "Greenlabs Dev <developer@greenlabs.co.kr>",
+  "license": "MIT",
+  "bugs": "https://github.com/green-labs/rescript-bindings/issues",
+  "homepage": "https://github.com/green-labs/rescript-bindings/tree/main/packages/rescript-kakao-postcode",
+  "devDependencies": {
+    "rescript": "^12.0.0"
+  }
+}

package/rescript.json

@@ -0,0 +1,17 @@
+{
+  "name": "@greenlabs/rescript-kakao-postcode",
+  "compiler-flags": [],
+  "sources": [
+    {
+      "dir": "src"
+    }
+  ],
+  "package-specs": [
+    {
+      "module": "esmodule",
+      "in-source": true
+    }
+  ],
+  "suffix": ".bs.js",
+  "dev-dependencies": []
+}

package/src/KakaoPostCode.res

@@ -0,0 +1,106 @@
+type t
+type addressType = R | J // R 도로명 | J 지번
+type selected = Y | N // 선택 상태
+type lang = K | E // K 한글주소 | E 영문주소
+
+type oncompleteResponse = {
+  address: string,
+  addressEnglish: string,
+  addressType: addressType,
+  apartment: selected,
+  autoJibunAddress: string,
+  autoJibunAddressEnglish: string,
+  autoRoadAddress: string,
+  autoRoadAddressEnglish: string,
+  bcode: string,
+  bname: string,
+  bname1: string,
+  bname1English: string,
+  bname2: string,
+  bname2English: string,
+  bnameEnglish: string,
+  buildingCode: string,
+  buildingName: string,
+  hname: string,
+  jibunAddress: string,
+  jibunAddressEnglish: string,
+  noSelected: selected,
+  postcode: string,
+  postcode1: string,
+  postcode2: string,
+  postcodeSeq: string,
+  query: string,
+  roadAddress: string,
+  roadAddressEnglish: string,
+  roadname: string,
+  roadnameCode: string,
+  roadnameEnglish: string,
+  sido: string,
+  sidoEnglish: string,
+  sigungu: string,
+  sigunguCode: string,
+  sigunguEnglish: string,
+  userLanguageType: lang,
+  userSelectedType: addressType,
+  zonecode: string,
+}
+type onresizeResponse = {
+  width: float,
+  height: float,
+}
+type oncloseResponse = FORCE_CLOSE | COMPLETE_CLOSE
+type onsearchResponse = {q: string, count: int}
+
+type themeObj = {
+  bgColor?: string, // 바탕 배경색
+  searchBgColor?: string, // 검색창 배경색
+  contentBgColor?: string, // 본문 배경색(검색결과,결과없음,첫화면,검색서제스트)
+  pageBgColor?: string, // 페이지 배경색
+  textColor?: string, // 기본 글자색
+  queryTextColor?: string, // 검색창 글자색
+  postcodeTextColor?: string, // 우편번호 글자색
+  emphTextColor?: string, // 강조 글자색
+  outlineColor?: string, // 테두리
+}
+
+type params = {
+  oncomplete?: oncompleteResponse => unit,
+  onresize?: onresizeResponse => unit,
+  onclose?: oncloseResponse => unit,
+  onsearch?: onsearchResponse => unit,
+  width?: float,
+  height?: float,
+  animation?: bool,
+  focusInput?: bool,
+  autoMapping?: bool,
+  shorthand?: bool,
+  pleaseReadGuide?: int,
+  pleaseReadGuideTimer?: float,
+  maxSuggestItems?: int,
+  showMoreHName?: bool,
+  hideMapBtn?: bool,
+  hideEngBtn?: bool,
+  alwaysShowEngAddr?: bool,
+  useBannerLink?: bool,
+  theme?: themeObj,
+  submitMode?: bool,
+}
+
+@new @scope("kakao") external make: params => t = "Postcode"
+
+type openParams = {
+  q?: string,
+  left?: float,
+  top?: float,
+  popupName?: string,
+  autoClose?: bool,
+}
+
+@send external openPostCode: (t, openParams) => unit = "open"
+
+type embedParams = {
+  q?: string,
+  autoClose?: bool,
+}
+
+@send external embedPostCode: (t, Dom.element, embedParams) => unit = "embed"