create-mendix-widget-gleam 1.0.0 → 1.0.2

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

@@ -0,0 +1,47 @@
+// Mendix Reference 타입 — 연관 관계 (Association) 값
+// ReferenceValue: 단일 참조, ReferenceSetValue: 다중 참조
+// 둘 다 ModifiableValue 패턴을 따름
+
+import gleam/option.{type Option}
+
+// === 타입 ===
+
+pub type ReferenceValue
+
+pub type ReferenceSetValue
+
+// === ReferenceValue (단일 참조) ===
+
+/// 참조 값 (없으면 None)
+@external(javascript, "../mendix_ffi.mjs", "get_modifiable_value")
+pub fn value(ref: ReferenceValue) -> Option(a)
+
+/// 참조 설정 (None → 참조 해제)
+@external(javascript, "../mendix_ffi.mjs", "modifiable_set_value")
+pub fn set_value(ref: ReferenceValue, value: Option(a)) -> Nil
+
+/// 읽기 전용 여부
+@external(javascript, "../mendix_ffi.mjs", "get_modifiable_read_only")
+pub fn read_only(ref: ReferenceValue) -> Bool
+
+/// 유효성 검사 메시지 (없으면 None)
+@external(javascript, "../mendix_ffi.mjs", "get_modifiable_validation")
+pub fn validation(ref: ReferenceValue) -> Option(String)
+
+// === ReferenceSetValue (다중 참조) ===
+
+/// 참조 목록 (없으면 None)
+@external(javascript, "../mendix_ffi.mjs", "get_modifiable_value")
+pub fn multi_value(rset: ReferenceSetValue) -> Option(List(a))
+
+/// 참조 목록 설정 (None → 전체 해제)
+@external(javascript, "../mendix_ffi.mjs", "modifiable_set_value")
+pub fn set_multi_value(rset: ReferenceSetValue, value: Option(List(a))) -> Nil
+
+/// 읽기 전용 여부
+@external(javascript, "../mendix_ffi.mjs", "get_modifiable_read_only")
+pub fn multi_read_only(rset: ReferenceSetValue) -> Bool
+
+/// 유효성 검사 메시지 (없으면 None)
+@external(javascript, "../mendix_ffi.mjs", "get_modifiable_validation")
+pub fn multi_validation(rset: ReferenceSetValue) -> Option(String)

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

@@ -0,0 +1,31 @@
+// Mendix Selection 타입 — 단일/다중 선택
+// 사용: 데이터 그리드 선택, 리스트 선택 등
+
+import gleam/option.{type Option}
+import widget/mendix.{type ObjectItem}
+
+// === 타입 ===
+
+pub type SelectionSingleValue
+
+pub type SelectionMultiValue
+
+// === 단일 선택 ===
+
+/// 현재 선택된 아이템 (없으면 None)
+@external(javascript, "../mendix_ffi.mjs", "get_selection_single")
+pub fn selection(sel: SelectionSingleValue) -> Option(ObjectItem)
+
+/// 선택 설정 (None → 선택 해제)
+@external(javascript, "../mendix_ffi.mjs", "set_selection_single")
+pub fn set_selection(sel: SelectionSingleValue, item: Option(ObjectItem)) -> Nil
+
+// === 다중 선택 ===
+
+/// 현재 선택된 아이템 목록
+@external(javascript, "../mendix_ffi.mjs", "get_selection_multi")
+pub fn selections(sel: SelectionMultiValue) -> List(ObjectItem)
+
+/// 선택 목록 설정
+@external(javascript, "../mendix_ffi.mjs", "set_selection_multi")
+pub fn set_selections(sel: SelectionMultiValue, items: List(ObjectItem)) -> Nil

package/template/src/widget/mendix.gleam

@@ -0,0 +1,65 @@
+// Mendix Pluggable Widget API - 핵심 타입 + JsProps 접근자
+// ValueStatus, ObjectItem 타입과 props 접근 유틸리티
+
+import gleam/option.{type Option}
+import widget/react.{type JsProps}
+
+// === ValueStatus ===
+
+pub type ValueStatus {
+  Available
+  Unavailable
+  Loading
+}
+
+pub fn to_value_status(status: String) -> ValueStatus {
+  case status {
+    "available" -> Available
+    "loading" -> Loading
+    _ -> Unavailable
+  }
+}
+
+// === ObjectItem ===
+
+pub type ObjectItem
+
+@external(javascript, "./mendix_ffi.mjs", "get_object_id")
+pub fn object_id(item: ObjectItem) -> String
+
+// === JsProps 접근자 ===
+
+/// Mendix props에서 값 추출 (undefined → None)
+@external(javascript, "./mendix_ffi.mjs", "get_mendix_prop")
+pub fn get_prop(props: JsProps, key: String) -> Option(a)
+
+/// Mendix props에서 항상 존재하는 값 추출
+@external(javascript, "./mendix_ffi.mjs", "get_mendix_prop_required")
+pub fn get_prop_required(props: JsProps, key: String) -> a
+
+/// Mendix props에서 문자열 속성값 추출 (undefined → "")
+@external(javascript, "./react_ffi.mjs", "get_string_prop")
+pub fn get_string_prop(props: JsProps, key: String) -> String
+
+/// Mendix props에서 키 존재 확인
+@external(javascript, "./react_ffi.mjs", "has_prop")
+pub fn has_prop(props: JsProps, key: String) -> Bool
+
+// === Status 접근 (status 속성을 가진 모든 Mendix 객체) ===
+
+@external(javascript, "./mendix_ffi.mjs", "get_status")
+fn get_status_raw(obj: a) -> String
+
+pub fn get_status(obj: a) -> ValueStatus {
+  to_value_status(get_status_raw(obj))
+}
+
+// === Option 변환 유틸리티 (FFI 경계 처리) ===
+
+/// JS 값을 Gleam Option으로 변환 (undefined/null → None)
+@external(javascript, "./mendix_ffi.mjs", "to_option")
+pub fn to_option(value: a) -> Option(a)
+
+/// Gleam Option을 JS 값으로 변환 (None → undefined)
+@external(javascript, "./mendix_ffi.mjs", "from_option")
+pub fn from_option(option: Option(a)) -> a

package/template/src/widget/mendix_ffi.mjs

@@ -0,0 +1,373 @@
+// Mendix Pluggable Widget API FFI 어댑터
+// Mendix 런타임 타입의 속성 접근과 메서드 호출을 Gleam에 노출
+import { Some, None } from "../../gleam_stdlib/gleam/option.mjs";
+import { Ok, Error as GleamError, toList } from "../gleam.mjs";
+
+// === JS undefined ↔ Gleam Option 변환 ===
+
+export function to_option(value) {
+  return value !== undefined && value !== null ? new Some(value) : new None();
+}
+
+export function from_option(option) {
+  return option instanceof Some ? option[0] : undefined;
+}
+
+// === JsProps 접근 ===
+
+export function get_mendix_prop(props, key) {
+  return to_option(props[key]);
+}
+
+export function get_mendix_prop_required(props, key) {
+  return props[key];
+}
+
+// === ValueStatus / ObjectItem ===
+
+export function get_status(obj) {
+  return obj.status;
+}
+
+export function get_object_id(item) {
+  return item.id;
+}
+
+// === EditableValue ===
+
+export function get_editable_value(obj) {
+  return to_option(obj.value);
+}
+
+export function get_editable_read_only(obj) {
+  return obj.readOnly;
+}
+
+export function get_editable_validation(obj) {
+  return to_option(obj.validation);
+}
+
+export function get_editable_display_value(obj) {
+  return obj.displayValue;
+}
+
+export function get_editable_formatter(obj) {
+  return obj.formatter;
+}
+
+export function get_editable_universe(obj) {
+  return to_option(obj.universe ? toList(obj.universe) : undefined);
+}
+
+export function editable_set_value(obj, option) {
+  obj.setValue(from_option(option));
+}
+
+export function editable_set_text_value(obj, text) {
+  obj.setTextValue(text);
+}
+
+export function editable_set_validator(obj, option_fn) {
+  if (option_fn instanceof Some) {
+    const gleam_fn = option_fn[0];
+    obj.setValidator((value) => {
+      const result = gleam_fn(to_option(value));
+      return from_option(result);
+    });
+  } else {
+    obj.setValidator(undefined);
+  }
+}
+
+// === ActionValue ===
+
+export function get_action_can_execute(a) {
+  return a.canExecute;
+}
+
+export function get_action_is_executing(a) {
+  return a.isExecuting;
+}
+
+export function action_execute(a) {
+  a.execute();
+}
+
+// === DynamicValue ===
+
+export function get_dynamic_value(obj) {
+  return to_option(obj.value);
+}
+
+// === ListValue ===
+
+export function get_list_items(lv) {
+  return to_option(lv.items ? toList(lv.items) : undefined);
+}
+
+export function get_list_offset(lv) {
+  return lv.offset;
+}
+
+export function get_list_limit(lv) {
+  return lv.limit;
+}
+
+export function get_list_has_more_items(lv) {
+  return to_option(lv.hasMoreItems);
+}
+
+export function get_list_total_count(lv) {
+  return to_option(lv.totalCount);
+}
+
+export function get_list_sort_order(lv) {
+  return toList(lv.sortOrder || []);
+}
+
+export function get_list_filter(lv) {
+  return to_option(lv.filter);
+}
+
+export function list_set_offset(lv, offset) {
+  lv.setOffset(offset);
+}
+
+export function list_set_limit(lv, limit) {
+  lv.setLimit(limit);
+}
+
+export function list_set_filter(lv, option) {
+  lv.setFilter(from_option(option));
+}
+
+export function list_set_sort_order(lv, gleam_list) {
+  lv.setSortOrder(gleam_list.toArray());
+}
+
+export function list_reload(lv) {
+  lv.reload();
+}
+
+export function list_request_total_count(lv, need) {
+  lv.requestTotalCount(need);
+}
+
+// === List-linked 타입 (공용) ===
+
+export function list_type_get(list_type, item) {
+  return list_type.get(item);
+}
+
+// === ListAttributeValue 메타데이터 ===
+
+export function get_list_attr_id(attr) {
+  return attr.id;
+}
+
+export function get_list_attr_sortable(attr) {
+  return attr.sortable;
+}
+
+export function get_list_attr_filterable(attr) {
+  return attr.filterable;
+}
+
+export function get_list_attr_type(attr) {
+  return attr.type;
+}
+
+export function get_list_attr_formatter(attr) {
+  return attr.formatter;
+}
+
+// === Selection ===
+
+export function get_selection_single(sel) {
+  return to_option(sel.selection);
+}
+
+export function get_selection_multi(sel) {
+  return toList(sel.selection || []);
+}
+
+export function set_selection_single(sel, option) {
+  sel.setSelection(from_option(option));
+}
+
+export function set_selection_multi(sel, gleam_list) {
+  sel.setSelection(gleam_list.toArray());
+}
+
+// === ModifiableValue / Reference ===
+
+export function get_modifiable_value(obj) {
+  return to_option(obj.value);
+}
+
+export function modifiable_set_value(obj, option) {
+  obj.setValue(from_option(option));
+}
+
+export function get_modifiable_read_only(obj) {
+  return obj.readOnly;
+}
+
+export function get_modifiable_validation(obj) {
+  return to_option(obj.validation);
+}
+
+// === FileValue / WebImage ===
+
+export function get_file_uri(f) {
+  return f.uri;
+}
+
+export function get_file_name(f) {
+  return to_option(f.name);
+}
+
+export function get_image_alt_text(img) {
+  return to_option(img.altText);
+}
+
+// === WebIcon ===
+
+export function get_icon_type(icon) {
+  return icon.type;
+}
+
+export function get_icon_class(icon) {
+  return icon.iconClass || "";
+}
+
+export function get_icon_url(icon) {
+  return icon.iconUrl || "";
+}
+
+// === Formatter ===
+
+export function formatter_format(fmt, option_value) {
+  return fmt.format(from_option(option_value));
+}
+
+export function formatter_parse(fmt, text) {
+  const result = fmt.parse(text);
+  if (result.valid) {
+    return new Ok(to_option(result.value));
+  } else {
+    return new GleamError(undefined);
+  }
+}
+
+// === SortInstruction ===
+
+export function make_sort_instruction(id, asc) {
+  return { id, asc };
+}
+
+export function get_sort_id(instr) {
+  return instr.id;
+}
+
+export function get_sort_asc(instr) {
+  return instr.asc;
+}
+
+// === Filter 빌더 (mendix/filters/builders 래핑) ===
+// Mendix 런타임에서 제공하는 외부 모듈 (Rollup에서 external 처리)
+import * as filters from "mendix/filters/builders";
+
+// Boolean 조합
+export function filter_and(conditions) {
+  return filters.and(...conditions.toArray());
+}
+
+export function filter_or(conditions) {
+  return filters.or(...conditions.toArray());
+}
+
+export function filter_not(condition) {
+  return filters.not(condition);
+}
+
+// 동등 비교
+export function filter_equals(a, b) {
+  return filters.equals(a, b);
+}
+
+export function filter_not_equal(a, b) {
+  return filters.notEqual(a, b);
+}
+
+// 크기 비교
+export function filter_greater_than(a, b) {
+  return filters.greaterThan(a, b);
+}
+
+export function filter_greater_than_or_equal(a, b) {
+  return filters.greaterThanOrEqual(a, b);
+}
+
+export function filter_less_than(a, b) {
+  return filters.lessThan(a, b);
+}
+
+export function filter_less_than_or_equal(a, b) {
+  return filters.lessThanOrEqual(a, b);
+}
+
+// 문자열 검색
+export function filter_contains(a, b) {
+  return filters.contains(a, b);
+}
+
+export function filter_starts_with(a, b) {
+  return filters.startsWith(a, b);
+}
+
+export function filter_ends_with(a, b) {
+  return filters.endsWith(a, b);
+}
+
+// 날짜 비교
+export function filter_day_equals(a, b) {
+  return filters.dayEquals(a, b);
+}
+
+export function filter_day_not_equal(a, b) {
+  return filters.dayNotEqual(a, b);
+}
+
+export function filter_day_greater_than(a, b) {
+  return filters.dayGreaterThan(a, b);
+}
+
+export function filter_day_greater_than_or_equal(a, b) {
+  return filters.dayGreaterThanOrEqual(a, b);
+}
+
+export function filter_day_less_than(a, b) {
+  return filters.dayLessThan(a, b);
+}
+
+export function filter_day_less_than_or_equal(a, b) {
+  return filters.dayLessThanOrEqual(a, b);
+}
+
+// 표현식 생성
+export function filter_attribute(id) {
+  return filters.attribute(id);
+}
+
+export function filter_association(id) {
+  return filters.association(id);
+}
+
+export function filter_literal(value) {
+  return filters.literal(value);
+}
+
+export function filter_empty() {
+  return filters.empty();
+}

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

@@ -0,0 +1,33 @@
+// React 이벤트 타입 + 값 추출 함수
+
+// === 이벤트 타입 (opaque) ===
+
+pub type Event
+
+pub type MouseEvent
+
+pub type ChangeEvent
+
+pub type KeyboardEvent
+
+pub type FormEvent
+
+pub type FocusEvent
+
+// === 값 추출 ===
+
+/// input/textarea의 현재 값 추출
+@external(javascript, "../react_ffi.mjs", "get_target_value")
+pub fn target_value(event: event) -> String
+
+/// 기본 동작 방지
+@external(javascript, "../react_ffi.mjs", "prevent_default")
+pub fn prevent_default(event: event) -> Nil
+
+/// 이벤트 전파 중지
+@external(javascript, "../react_ffi.mjs", "stop_propagation")
+pub fn stop_propagation(event: event) -> Nil
+
+/// 키보드 이벤트의 키 값
+@external(javascript, "../react_ffi.mjs", "get_event_key")
+pub fn key(event: event) -> String

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

@@ -0,0 +1,47 @@
+// React Hooks - useState, useEffect 등
+
+import widget/react.{type Ref}
+
+// === useState ===
+
+/// 상태 훅. #(현재값, 세터함수) 튜플 반환
+@external(javascript, "../react_ffi.mjs", "use_state")
+pub fn use_state(initial: a) -> #(a, fn(a) -> Nil)
+
+// === useEffect ===
+
+/// 의존성 배열과 함께 실행
+@external(javascript, "../react_ffi.mjs", "use_effect")
+pub fn use_effect(effect_fn: fn() -> Nil, deps: List(a)) -> Nil
+
+/// 매 렌더링마다 실행 (deps 없음)
+@external(javascript, "../react_ffi.mjs", "use_effect_always")
+pub fn use_effect_always(effect_fn: fn() -> Nil) -> Nil
+
+/// 마운트 시 한 번만 실행 (deps = [])
+@external(javascript, "../react_ffi.mjs", "use_effect_once")
+pub fn use_effect_once(effect_fn: fn() -> Nil) -> Nil
+
+// === useMemo / useCallback ===
+
+/// 메모이제이션된 값 계산
+@external(javascript, "../react_ffi.mjs", "use_memo")
+pub fn use_memo(compute: fn() -> a, deps: List(b)) -> a
+
+/// 메모이제이션된 콜백
+@external(javascript, "../react_ffi.mjs", "use_callback")
+pub fn use_callback(callback: fn(a) -> b, deps: List(c)) -> fn(a) -> b
+
+// === useRef ===
+
+/// ref 생성
+@external(javascript, "../react_ffi.mjs", "use_ref")
+pub fn use_ref(initial: a) -> Ref(a)
+
+/// ref 현재 값 읽기
+@external(javascript, "../react_ffi.mjs", "get_ref_current")
+pub fn get_ref(ref: Ref(a)) -> a
+
+/// ref 현재 값 설정
+@external(javascript, "../react_ffi.mjs", "set_ref_current")
+pub fn set_ref(ref: Ref(a), value: a) -> Nil