2025-07-05 20:20 UTC+0200 Aleksander Czajczynski (hb fki.pl)

+ config/wasm/global.mk
  + config/wasm/libs.mk
  + config/wasm/emcc.mk
  * utils/hbmk2/hbmk2.prg
  * contrib/hbrun/hbrun.hbp
    + add basic support for build Harbour into JS/WebAssembly using
      emscripten, using these settings:
        HB_PLATFORM=wasm HB_COMPILER=emcc HB_BUILD_3RDEXT=no

    * {abstr} is now a hbmk2 keyword to possibly group all
      toolsets similar in flavour: WASI/clang, JS/emscripten
      These most likely will be targeting plaforms which are not
      full operating-systems, they are also commonly qualified as
      sandbox solutions.

    * introduced __PLATFORM__WASM and __PLATFORM__ABSTRACT .prg defines

  * utils/hbmk2/hbmk2.prg
    + allow to specify hb_ProgName() value at build-time for platforms
      where the function cannot return a meaningful value (f.e.
      JS/WebAssembly)
    ; TODO: Add support for passing hb_ProgName() value command-line
            parameter, f.e. `--hb:self=hbrun`

  * config/global.mk
  * include/hbsetup.h
    * consider abstract/emscripten targets similar to linux-like

  * src/rtl/arc4.c
    ! fix to build under emscripten (which is assumed to be a
      linux-like environment)

  ; though platform/compiler names are not currently compatible
    with origin, this WebAssembly platform support was guided by
    Harbour 3.4:
    2017-06-09 01:10 UTC Viktor Szakats (vszakats users.noreply.github.com)
    as usual Viktor was here before, many thanks!

  ; example project, how to make a multi-platform GUI application which
    also targets WebAssembly, can be found here:
    https://github.com/alcz/harbour-cimgui-sokol-starterkit/

config/global.mk

@@ -1748,6 +1748,12 @@ ifneq ($(HB_HOST_PLAT)$(HB_HOST_CPU),$(HB_PLATFORM)$(HB_CPU))
       else
       ifeq ($(HB_PLATFORM),aix)
          HB_PRGFLAGS += -D__PLATFORM__AIX -D__PLATFORM__UNIX
+      else
+      ifeq ($(HB_PLATFORM),wasm)
+         HB_PRGFLAGS += -D__PLATFORM__LINUX -D__PLATFORM__UNIX -D__PLATFORM__WASM
+         # NOTE: __PLATFORM__LINUX here definitely is a hack, remove
+         # if WASM platform settles more (it's currently emscripten oriented)
+      endif
       endif
       endif
       endif

config/wasm/emcc.mk

@@ -0,0 +1,94 @@
+# https://developer.mozilla.org/docs/WebAssembly/C_to_wasm
+# https://kripken.github.io/emscripten-site/docs/compiling/Building-Projects.html
+
+ifeq ($(HB_BUILD_MODE),cpp)
+   ifneq ($(findstring clang$(subst x, ,x)version$(subst x, ,x)1,$(shell clang --version)),)
+      HB_BUILD_MODE := c
+   endif
+endif
+
+ifeq ($(HB_BUILD_MODE),cpp)
+   HB_CMP := em++
+else
+   HB_CMP := emcc
+endif
+
+OBJ_EXT := .o
+LIB_PREF := lib
+LIB_EXT := .a
+
+CC := $(HB_CCACHE) $(HB_CCPREFIX)$(HB_CMP)$(HB_CCSUFFIX)
+CC_IN :=
+# NOTE: The ending space after -o is important, please preserve it.
+CC_OUT := -o$(subst x,x, )
+
+CFLAGS += -I. -I$(HB_HOST_INC)
+ifeq ($(filter --analyze, $(HB_USER_CFLAGS)),)
+   CFLAGS += -c
+endif
+
+ifneq ($(HB_BUILD_WARN),no)
+   CFLAGS += -W -Weverything
+   CFLAGS += -Wno-padded -Wno-cast-align -Wno-float-equal -Wno-missing-prototypes
+   CFLAGS += -Wno-disabled-macro-expansion -Wno-undef -Wno-unused-macros -Wno-variadic-macros -Wno-documentation
+   CFLAGS += -Wno-switch-enum
+   ifeq ($(HB_PLATFORM),darwin)
+      ifeq ($(filter $(HB_COMPILER_VER),0304 0305 0306),)
+         CFLAGS += -Wno-reserved-id-macro
+      endif
+   else
+      ifeq ($(filter $(HB_COMPILER_VER),0304 0305),)
+         CFLAGS += -Wno-reserved-id-macro
+      endif
+   endif
+   CFLAGS += -Wno-empty-translation-unit
+   # These are potentially useful. -Wsign-conversion would require proper HB_SIZE/HB_ISIZ cleanup.
+   CFLAGS += -Wno-sign-conversion -Wno-shorten-64-to-32 -Wno-conversion -Wno-bad-function-cast
+else
+   CFLAGS += -Wmissing-braces -Wreturn-type -Wformat
+   ifneq ($(HB_BUILD_MODE),cpp)
+      CFLAGS += -Wimplicit-int -Wimplicit-function-declaration
+   endif
+endif
+
+ifneq ($(HB_BUILD_OPTIM),no)
+   ifeq ($(HB_BUILD_DEBUG),yes)
+      ifeq ($(filter $(HB_COMPILER_VER),0304 0305 0306 0307 0308 0309),)
+         CFLAGS += -O0
+      else
+         CFLAGS += -O1
+      endif
+   else
+      CFLAGS += -O3
+   endif
+endif
+
+ifeq ($(HB_BUILD_DEBUG),yes)
+   CFLAGS += -g
+endif
+
+LD := $(CC)
+# NOTE: The ending space after -o is important, please preserve it.
+LD_OUT := -o$(subst x,x, )
+
+LIBPATHS := $(foreach dir,$(LIB_DIR) $(SYSLIBPATHS),-L$(dir))
+LDLIBS := $(foreach lib,$(HB_USER_LIBS) $(LIBS) $(SYSLIBS),-l$(lib))
+
+LDFLAGS += -sWASM=1 $(LIBPATHS)
+
+AR := $(LLVM_ROOT)/llvm-ar
+AR_RULE = ( $(AR) $(ARFLAGS) $(HB_AFLAGS) $(HB_USER_AFLAGS) rcs \
+   $(LIB_DIR)/$@ $(^F) $(ARSTRIP) ) \
+   || ( $(RM) $(LIB_DIR)/$@ && $(FALSE) )
+
+DY := $(CC)
+DFLAGS += -shared $(LIBPATHS)
+DY_OUT := -o$(subst x,x, )
+DLIBS := $(foreach lib,$(HB_USER_LIBS) $(SYSLIBS),-l$(lib))
+
+DY_RULE = $(DY) $(DFLAGS) -Wl,-soname,$(DYN_NAME_CPT) $(HB_USER_DFLAGS) \
+   $(DY_OUT)$(DYN_DIR)/$@ $^ $(DLIBS) $(DYSTRIP) \
+   && $(LN) $(@F) $(DYN_FILE_NVR) \
+   && $(LN) $(@F) $(DYN_FILE_CPT)
+
+include $(TOP)$(ROOT)config/rules.mk

config/wasm/global.mk

@@ -0,0 +1,9 @@
+all : first
+
+ifeq ($(HB_COMPILER),wasm)
+   BIN_EXT := .js
+   DYN_EXT := .so
+endif
+DYN_PREF := lib
+
+HB_GT_LIBS += gtcgi

config/wasm/libs.mk

@@ -0,0 +1,23 @@
+SYSLIBPATHS :=
+
+ifneq ($(HB_LINKING_RTL),)
+   ifneq ($(HB_HAS_X11),)
+      SYSLIBS += X11
+      ifneq ($(wildcard /usr/X11R6/lib),)
+         SYSLIBPATHS += /usr/X11R6/lib
+      endif
+      ifneq ($(wildcard /opt/X11/lib),)
+         SYSLIBPATHS += /opt/X11/lib
+      endif
+   endif
+   ifneq ($(HB_HAS_PCRE),)
+      ifeq ($(HB_HAS_PCRE_LOCAL),)
+         SYSLIBS += pcre
+      endif
+   endif
+   ifeq ($(HB_HAS_ZLIB_LOCAL),)
+      SYSLIBS += z
+   endif
+endif
+
+SYSLIBS += m