create-mendix-widget-gleam 1.0.2 → 1.0.4

package/README.md

@@ -0,0 +1,61 @@
+# create-mendix-widget-gleam
+
+Gleam 언어로 Mendix Pluggable Widget 프로젝트를 스케폴딩하는 CLI 도구.
+
+JSX 없이, **오직 Gleam + FFI**로 React 컴포넌트를 작성하여 Mendix Studio Pro에서 동작하는 위젯을 만든다.
+
+## 사용법
+
+```bash
+npx create-mendix-widget-gleam my-widget
+```
+
+대화형 프롬프트를 통해 프로젝트명과 패키지 매니저를 선택하면, 즉시 개발 가능한 위젯 프로젝트가 생성된다.
+
+## 사전 요구사항
+
+- [Gleam](https://gleam.run/getting-started/installing/) (최신 버전)
+- [Node.js](https://nodejs.org/) (v18+)
+
+## 생성되는 프로젝트 구조
+
+```
+my-widget/
+  src/
+    widget/                    # Gleam 위젯 코드
+      my_widget.gleam          #   메인 위젯 모듈
+      react_ffi.mjs            #   React FFI 어댑터
+      mendix_ffi.mjs           #   Mendix FFI 어댑터
+      react.gleam + react/     #   React 바인딩 (타입, Props, Hooks, HTML)
+      mendix.gleam + mendix/   #   Mendix API 바인딩 (전체 Pluggable Widget API)
+      editor_config.gleam      #   Studio Pro 속성 패널
+    scripts/                   #   빌드/개발 스크립트
+  gleam.toml                   # Gleam 프로젝트 설정
+  CLAUDE.md                    # AI 어시스턴트용 프로젝트 컨텍스트
+```
+
+## 생성 후 시작하기
+
+```bash
+cd my-widget
+gleam run -m scripts/install   # 의존성 설치
+gleam run -m scripts/dev       # 개발 서버 시작
+gleam run -m scripts/build     # 프로덕션 빌드 (.mpk 생성)
+```
+
+## 포함된 Mendix API 바인딩
+
+생성된 프로젝트에는 Mendix Pluggable Widget API 전체에 대한 Gleam 바인딩이 포함되어 있다:
+
+- **EditableValue** — 텍스트, 숫자, 날짜 등 편집 가능한 값
+- **ActionValue** — 마이크로플로우/나노플로우 실행
+- **ListValue** — 데이터 목록 (필터, 정렬, 페이지네이션)
+- **SelectionValue** — 단일/다중 선택
+- **ReferenceValue** — 연관 관계 (단일/다중 참조)
+- **JsDate / Big** — JS Date, Big.js 고정밀 십진수 래퍼
+- **Filter** — 필터 조건 빌더
+- **그 외** — DynamicValue, FileValue, WebIcon, ValueFormatter 등
+
+## 라이선스
+
+Apache-2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-mendix-widget-gleam",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Scaffold a Mendix Pluggable Widget powered by Gleam",
   "type": "module",
   "license": "Apache-2.0",
@@ -8,7 +8,8 @@
   "files": [
     "bin/",
     "src/",
-    "template/"
+    "template/",
+    "README.md"
   ],
   "engines": {
     "node": ">=18"

package/src/index.mjs

@@ -214,6 +214,8 @@ gleam format                     # Gleam 코드 포맷팅
 - \`mendix/list_attribute.gleam\` — \`ListAttributeValue\` 등 리스트 연결 타입
 - \`mendix/selection.gleam\` — 단일/다중 선택
 - \`mendix/reference.gleam\` — 참조 관계 값
+- \`mendix/date.gleam\` — \`JsDate\` (JS Date opaque 래퍼)
+- \`mendix/big.gleam\` — \`Big\` (Big.js 고정밀 십진수 래퍼)
 - \`mendix/file.gleam\` — 파일/이미지
 - \`mendix/icon.gleam\` — 아이콘
 - \`mendix/formatter.gleam\` — 값 포맷팅/파싱

package/template/src/widget/mendix/big.gleam

@@ -0,0 +1,86 @@
+// Mendix Big.js 타입 — 고정밀 십진수 Gleam opaque 래퍼
+// EditableValue<BigJs.Big>에서 반환되는 Big.js 객체를 타입 안전하게 다룸
+
+import gleam/order.{type Order, Eq, Gt, Lt}
+
+// === 타입 ===
+
+pub type Big
+
+// === 생성 ===
+
+/// 문자열로 Big 생성
+@external(javascript, "../mendix_ffi.mjs", "big_from_string")
+pub fn from_string(s: String) -> Big
+
+/// 정수로 Big 생성
+@external(javascript, "../mendix_ffi.mjs", "big_from_int")
+pub fn from_int(n: Int) -> Big
+
+/// 부동소수점으로 Big 생성
+@external(javascript, "../mendix_ffi.mjs", "big_from_float")
+pub fn from_float(f: Float) -> Big
+
+// === 변환 ===
+
+/// 문자열로 변환
+@external(javascript, "../mendix_ffi.mjs", "big_to_string")
+pub fn to_string(b: Big) -> String
+
+/// Float로 변환 (정밀도 손실 가능)
+@external(javascript, "../mendix_ffi.mjs", "big_to_float")
+pub fn to_float(b: Big) -> Float
+
+/// Int로 변환 (소수점 이하 버림)
+@external(javascript, "../mendix_ffi.mjs", "big_to_int")
+pub fn to_int(b: Big) -> Int
+
+/// 고정 소수점 문자열 (소수점 이하 dp자리)
+@external(javascript, "../mendix_ffi.mjs", "big_to_fixed")
+pub fn to_fixed(b: Big, dp: Int) -> String
+
+// === 산술 ===
+
+/// 덧셈
+@external(javascript, "../mendix_ffi.mjs", "big_add")
+pub fn add(a: Big, b: Big) -> Big
+
+/// 뺄셈
+@external(javascript, "../mendix_ffi.mjs", "big_sub")
+pub fn subtract(a: Big, b: Big) -> Big
+
+/// 곱셈
+@external(javascript, "../mendix_ffi.mjs", "big_mul")
+pub fn multiply(a: Big, b: Big) -> Big
+
+/// 나눗셈
+@external(javascript, "../mendix_ffi.mjs", "big_div")
+pub fn divide(a: Big, b: Big) -> Big
+
+/// 절대값
+@external(javascript, "../mendix_ffi.mjs", "big_abs")
+pub fn absolute(b: Big) -> Big
+
+/// 부호 반전
+@external(javascript, "../mendix_ffi.mjs", "big_negate")
+pub fn negate(b: Big) -> Big
+
+// === 비교 ===
+
+/// 비교 (Gleam Order 반환)
+pub fn compare(a: Big, b: Big) -> Order {
+  case cmp(a, b) {
+    x if x < 0 -> Lt
+    x if x > 0 -> Gt
+    _ -> Eq
+  }
+}
+
+/// 동등 비교
+@external(javascript, "../mendix_ffi.mjs", "big_eq")
+pub fn equal(a: Big, b: Big) -> Bool
+
+// === 내부 FFI ===
+
+@external(javascript, "../mendix_ffi.mjs", "big_cmp")
+fn cmp(a: Big, b: Big) -> Int

package/template/src/widget/mendix/date.gleam

@@ -0,0 +1,92 @@
+// Mendix JS Date 타입 — Gleam opaque 래퍼
+// EditableValue<Date>에서 반환되는 JS Date 객체를 타입 안전하게 다룸
+
+// === 타입 ===
+
+pub type JsDate
+
+// === 생성 ===
+
+/// 현재 시각
+@external(javascript, "../mendix_ffi.mjs", "date_now")
+pub fn now() -> JsDate
+
+/// ISO 8601 문자열로 생성
+@external(javascript, "../mendix_ffi.mjs", "date_from_iso")
+pub fn from_iso(iso_string: String) -> JsDate
+
+/// Unix 타임스탬프(밀리초)로 생성
+@external(javascript, "../mendix_ffi.mjs", "date_from_timestamp")
+pub fn from_timestamp(ms: Int) -> JsDate
+
+/// 날짜/시간 요소로 생성 (month: 1-12)
+@external(javascript, "../mendix_ffi.mjs", "date_create")
+pub fn create(
+  year: Int,
+  month: Int,
+  day: Int,
+  hours: Int,
+  minutes: Int,
+  seconds: Int,
+  milliseconds: Int,
+) -> JsDate
+
+// === 변환 ===
+
+/// ISO 8601 문자열로 변환
+@external(javascript, "../mendix_ffi.mjs", "date_to_iso")
+pub fn to_iso(date: JsDate) -> String
+
+/// Unix 타임스탬프(밀리초) 반환
+@external(javascript, "../mendix_ffi.mjs", "date_get_time")
+pub fn to_timestamp(date: JsDate) -> Int
+
+/// 사람이 읽기 쉬운 문자열로 변환
+@external(javascript, "../mendix_ffi.mjs", "date_to_string")
+pub fn to_string(date: JsDate) -> String
+
+// === 접근자 ===
+
+/// 연도 (4자리)
+@external(javascript, "../mendix_ffi.mjs", "date_get_full_year")
+pub fn year(date: JsDate) -> Int
+
+/// 월 (1-12, Gleam 기준 1-based)
+@external(javascript, "../mendix_ffi.mjs", "date_get_month")
+pub fn month(date: JsDate) -> Int
+
+/// 일 (1-31)
+@external(javascript, "../mendix_ffi.mjs", "date_get_date")
+pub fn day(date: JsDate) -> Int
+
+/// 시 (0-23)
+@external(javascript, "../mendix_ffi.mjs", "date_get_hours")
+pub fn hours(date: JsDate) -> Int
+
+/// 분 (0-59)
+@external(javascript, "../mendix_ffi.mjs", "date_get_minutes")
+pub fn minutes(date: JsDate) -> Int
+
+/// 초 (0-59)
+@external(javascript, "../mendix_ffi.mjs", "date_get_seconds")
+pub fn seconds(date: JsDate) -> Int
+
+/// 밀리초 (0-999)
+@external(javascript, "../mendix_ffi.mjs", "date_get_milliseconds")
+pub fn milliseconds(date: JsDate) -> Int
+
+/// 요일 (0=일요일, 1=월요일, ..., 6=토요일)
+@external(javascript, "../mendix_ffi.mjs", "date_get_day")
+pub fn day_of_week(date: JsDate) -> Int
+
+// === HTML input[type="date"] 변환 ===
+
+import gleam/option.{type Option}
+
+/// JsDate → "YYYY-MM-DD" 변환 (로컬 시간 기준, input[type="date"] 용)
+@external(javascript, "../mendix_ffi.mjs", "date_to_input_value")
+pub fn to_input_value(date: JsDate) -> String
+
+/// "YYYY-MM-DD" → Option(JsDate) 변환 (빈 문자열 → None)
+@external(javascript, "../mendix_ffi.mjs", "input_value_to_date")
+pub fn from_input_value(date_string: String) -> Option(JsDate)

package/template/src/widget/mendix/editable_value.gleam

@@ -70,4 +70,4 @@ pub fn is_available(ev: EditableValue) -> Bool {
 /// 편집 가능한 상태인지 확인 (사용 가능 + 읽기 전용 아님)
 pub fn is_editable(ev: EditableValue) -> Bool {
   is_available(ev) && !read_only(ev)
-}
+}

package/template/src/widget/mendix/reference.gleam

@@ -30,12 +30,12 @@ pub fn validation(ref: ReferenceValue) -> Option(String)
 
 // === ReferenceSetValue (다중 참조) ===
 
-/// 참조 목록 (없으면 None)
-@external(javascript, "../mendix_ffi.mjs", "get_modifiable_value")
+/// 참조 목록 (없으면 None) — JS Array↔Gleam List 변환 포함
+@external(javascript, "../mendix_ffi.mjs", "get_reference_set_value")
 pub fn multi_value(rset: ReferenceSetValue) -> Option(List(a))
 
-/// 참조 목록 설정 (None → 전체 해제)
-@external(javascript, "../mendix_ffi.mjs", "modifiable_set_value")
+/// 참조 목록 설정 (None → 전체 해제) — Gleam List→JS Array 변환 포함
+@external(javascript, "../mendix_ffi.mjs", "set_reference_set_value")
 pub fn set_multi_value(rset: ReferenceSetValue, value: Option(List(a))) -> Nil
 
 /// 읽기 전용 여부

package/template/src/widget/mendix_ffi.mjs

@@ -209,6 +209,20 @@ export function modifiable_set_value(obj, option) {
   obj.setValue(from_option(option));
 }
 
+// === ReferenceSetValue (Array↔List 변환) ===
+
+export function get_reference_set_value(obj) {
+  return to_option(obj.value ? toList(obj.value) : undefined);
+}
+
+export function set_reference_set_value(obj, option) {
+  if (option instanceof Some) {
+    obj.setValue(option[0].toArray());
+  } else {
+    obj.setValue(undefined);
+  }
+}
+
 export function get_modifiable_read_only(obj) {
   return obj.readOnly;
 }
@@ -274,6 +288,149 @@ export function get_sort_asc(instr) {
   return instr.asc;
 }
 
+// === JS Date ===
+
+export function date_now() {
+  return new Date();
+}
+
+export function date_from_iso(iso_string) {
+  return new Date(iso_string);
+}
+
+export function date_from_timestamp(ms) {
+  return new Date(ms);
+}
+
+// month: Gleam 1-based → JS 0-based 변환
+export function date_create(year, month, day, hours, minutes, seconds, ms) {
+  return new Date(year, month - 1, day, hours, minutes, seconds, ms);
+}
+
+export function date_to_iso(d) {
+  return d.toISOString();
+}
+
+export function date_get_time(d) {
+  return d.getTime();
+}
+
+export function date_to_string(d) {
+  return d.toString();
+}
+
+export function date_get_full_year(d) {
+  return d.getFullYear();
+}
+
+// JS 0-based → Gleam 1-based 변환
+export function date_get_month(d) {
+  return d.getMonth() + 1;
+}
+
+export function date_get_date(d) {
+  return d.getDate();
+}
+
+export function date_get_hours(d) {
+  return d.getHours();
+}
+
+export function date_get_minutes(d) {
+  return d.getMinutes();
+}
+
+export function date_get_seconds(d) {
+  return d.getSeconds();
+}
+
+export function date_get_milliseconds(d) {
+  return d.getMilliseconds();
+}
+
+export function date_get_day(d) {
+  return d.getDay();
+}
+
+// === Date 변환 (JS Date ↔ HTML input[type="date"]) ===
+
+export function date_to_input_value(jsDate) {
+  const year = jsDate.getFullYear();
+  const month = String(jsDate.getMonth() + 1).padStart(2, "0");
+  const day = String(jsDate.getDate()).padStart(2, "0");
+  return `${year}-${month}-${day}`;
+}
+
+export function input_value_to_date(dateString) {
+  if (!dateString) return new None();
+  const [year, month, day] = dateString.split("-").map(Number);
+  return new Some(new Date(year, month - 1, day));
+}
+
+// === Big.js ===
+
+import Big from "big.js";
+
+export function big_from_string(s) {
+  return new Big(s);
+}
+
+export function big_from_int(n) {
+  return new Big(n);
+}
+
+export function big_from_float(f) {
+  return new Big(f);
+}
+
+export function big_to_string(b) {
+  return b.toString();
+}
+
+export function big_to_float(b) {
+  return b.toNumber();
+}
+
+export function big_to_int(b) {
+  return Math.trunc(b.toNumber());
+}
+
+export function big_to_fixed(b, dp) {
+  return b.toFixed(dp);
+}
+
+export function big_add(a, b) {
+  return a.plus(b);
+}
+
+export function big_sub(a, b) {
+  return a.minus(b);
+}
+
+export function big_mul(a, b) {
+  return a.times(b);
+}
+
+export function big_div(a, b) {
+  return a.div(b);
+}
+
+export function big_abs(b) {
+  return b.abs();
+}
+
+export function big_negate(b) {
+  return b.times(-1);
+}
+
+export function big_cmp(a, b) {
+  return a.cmp(b);
+}
+
+export function big_eq(a, b) {
+  return a.eq(b);
+}
+
 // === Filter 빌더 (mendix/filters/builders 래핑) ===
 // Mendix 런타임에서 제공하는 외부 모듈 (Rollup에서 external 처리)
 import * as filters from "mendix/filters/builders";

package/template/src/widget/react/hook.gleam

@@ -22,6 +22,24 @@ pub fn use_effect_always(effect_fn: fn() -> Nil) -> Nil
 @external(javascript, "../react_ffi.mjs", "use_effect_once")
 pub fn use_effect_once(effect_fn: fn() -> Nil) -> Nil
 
+// === useEffect (cleanup 반환) ===
+// Gleam fn() -> fn() -> Nil = JS에서 함수를 반환하는 함수 → React cleanup으로 인식
+
+/// 의존성 배열과 함께 실행 (cleanup 함수 반환)
+@external(javascript, "../react_ffi.mjs", "use_effect")
+pub fn use_effect_cleanup(
+  setup: fn() -> fn() -> Nil,
+  deps: List(a),
+) -> Nil
+
+/// 매 렌더링마다 실행 + cleanup
+@external(javascript, "../react_ffi.mjs", "use_effect_always")
+pub fn use_effect_always_cleanup(setup: fn() -> fn() -> Nil) -> Nil
+
+/// 마운트 시 한 번만 실행 + cleanup
+@external(javascript, "../react_ffi.mjs", "use_effect_once")
+pub fn use_effect_once_cleanup(setup: fn() -> fn() -> Nil) -> Nil
+
 // === useMemo / useCallback ===
 
 /// 메모이제이션된 값 계산