Support LUMINO_BUILD_BASE_ONLY

Author: lriki

CLAUDE.md .github/copilot-instructions.mdCLAUDE.md renamed to .github/copilot-instructions.md

@@ -1,62 +1,62 @@
-# CLAUDE.md
-
-このファイルは、Claude Code (claude.ai/code) がこのリポジトリ内のコードを操作する際のガイダンスを提供します。
-
-
-## リポジトリアーキテクチャ
-
-Lumino は、以下の主要なアーキテクチャレイヤーを備えたマルチプラットフォームゲームエンジンライブラリです。
-
-### コアパッケージ構造
-- **LuminoCore**: 基盤レイヤー (演算、I/O、スレッド、シリアル化、文字列)
-- **LuminoEngine**: コアエンジンモジュール (グラフィックス RHI、オーディオ、レンダリング、プラットフォーム抽象化)
-- **LuminoFramework**: 高レベルゲームフレームワーク (シーン、物理演算、UI、エフェクト)
-- **LuminoFFI**: 他言語との統合のための C API バインディング
-- **lumino-js**: JavaScript/WebAssembly バインディング
-
-### 主要なアーキテクチャコンセプト
-
-**マルチプラットフォーム設計**: エンジンは、Windows (DirectX12/OpenGL)、Linux/macOS (OpenGL/Vulkan)、WebAssembly (WebGL/WebGPU)、Android/iOS (OpenGL ES) をサポートします。
-
-**グラフィックス RHI**: 複数のバックエンドをサポートするハードウェア抽象化レイヤー(DirectX12、Vulkan、OpenGL、WebGL、WebGPU)
-
-**アセットパイプライン**: メッシュ、テクスチャ、シェーダー、オーディオをサポートするランタイムアセットのロードとコンパイル
-
-**コンポーネントアーキテクチャ**: ゲームオブジェクト用のエンティティコンポーネントシステムを備えたシーングラフ
-
-**モダンC++17**: モダンC++機能、STLコンテナ、スマートポインタ、オプショナル型を使用
-
-### パッケージ依存関係
-- LuminoCore → 内部依存関係なし
-- LuminoEngine → LuminoCore
-- LuminoFramework → LuminoEngine + LuminoCore
-- LuminoFFI → LuminoEngine + LuminoCore
-
-### 外部依存関係
-vcpkg経由で管理: zlib、libpng、freetype、Vulkan、glslang、SPIRV-Cross、OpenAL、bullet3、box2d、ImGui、glTF、OBJローダー
-
-### シェーダーシステム
-- プライマリ: HLSL/GLSL へのクロスコンパイルが可能な Slang シェーディング言語
-- レガシー: HLSL エフェクトシステム
-- 場所: `packages/LuminoEngine/shader/`
-
-### プラットフォーム抽象化
-プラットフォーム固有のコードは `Platform/` ディレクトリに分離され、マネージャークラスによって Windows (Win32)、Linux/macOS (GLFW)、Web (Emscripten) 間で統一された API が提供されます。
-
-## 開発ワークフロー
-
-1. **セットアップ**: `docs/how-to-build.md` に記載されているとおり、vcpkg をリポジトリのルートにクローンします。
-2. **ビルド**: テストを含む完全なビルドには、`dotnet run -- Bootstrap` を使用します。
-3. **イテレーション**: エンジンのみのリビルドには、`dotnet run -- BuildEngine` を使用します。
-4. **テスト**: エンジンのビルド中に ctest を介してテストが自動的に実行されます。
-5. **Web**: `packages/lumino-js/` で別の npm ビルドプロセスを使用します。
-
-## 重要なファイルの場所
-
-- メイン CMake: `CMakeLists.txt`
-- コアエンジン: `packages/LuminoEngine/src/`
-- パブリックヘッダー: `packages/*/include/`
-- サンプル: `packages/*/examples/`、`examples/`
-- テスト: `packages/*/test/`
-- ビルドシステム: `tools/LuminoBuild/`
-- ドキュメント: `docs/`
+# CLAUDE.md
+
+このファイルは、Claude Code (claude.ai/code) がこのリポジトリ内のコードを操作する際のガイダンスを提供します。
+
+
+## リポジトリアーキテクチャ
+
+Lumino は、以下の主要なアーキテクチャレイヤーを備えたマルチプラットフォームゲームエンジンライブラリです。
+
+### コアパッケージ構造
+- **LuminoCore**: 基盤レイヤー (演算、I/O、スレッド、シリアル化、文字列)
+- **LuminoEngine**: コアエンジンモジュール (グラフィックス RHI、オーディオ、レンダリング、プラットフォーム抽象化)
+- **LuminoFramework**: 高レベルゲームフレームワーク (シーン、物理演算、UI、エフェクト)
+- **LuminoFFI**: 他言語との統合のための C API バインディング
+- **lumino-js**: JavaScript/WebAssembly バインディング
+
+### 主要なアーキテクチャコンセプト
+
+**マルチプラットフォーム設計**: エンジンは、Windows (DirectX12/OpenGL)、Linux/macOS (OpenGL/Vulkan)、WebAssembly (WebGL/WebGPU)、Android/iOS (OpenGL ES) をサポートします。
+
+**グラフィックス RHI**: 複数のバックエンドをサポートするハードウェア抽象化レイヤー(DirectX12、Vulkan、OpenGL、WebGL、WebGPU)
+
+**アセットパイプライン**: メッシュ、テクスチャ、シェーダー、オーディオをサポートするランタイムアセットのロードとコンパイル
+
+**コンポーネントアーキテクチャ**: ゲームオブジェクト用のエンティティコンポーネントシステムを備えたシーングラフ
+
+**モダンC++17**: モダンC++機能、STLコンテナ、スマートポインタ、オプショナル型を使用
+
+### パッケージ依存関係
+- LuminoCore → 内部依存関係なし
+- LuminoEngine → LuminoCore
+- LuminoFramework → LuminoEngine + LuminoCore
+- LuminoFFI → LuminoEngine + LuminoCore
+
+### 外部依存関係
+vcpkg経由で管理: zlib、libpng、freetype、Vulkan、glslang、SPIRV-Cross、OpenAL、bullet3、box2d、ImGui、glTF、OBJローダー
+
+### シェーダーシステム
+- プライマリ: HLSL/GLSL へのクロスコンパイルが可能な Slang シェーディング言語
+- レガシー: HLSL エフェクトシステム
+- 場所: `packages/LuminoEngine/shader/`
+
+### プラットフォーム抽象化
+プラットフォーム固有のコードは `Platform/` ディレクトリに分離され、マネージャークラスによって Windows (Win32)、Linux/macOS (GLFW)、Web (Emscripten) 間で統一された API が提供されます。
+
+## 開発ワークフロー
+
+1. **セットアップ**: `docs/how-to-build.md` に記載されているとおり、vcpkg をリポジトリのルートにクローンします。
+2. **ビルド**: テストを含む完全なビルドには、`dotnet run -- Bootstrap` を使用します。
+3. **イテレーション**: エンジンのみのリビルドには、`dotnet run -- BuildEngine` を使用します。
+4. **テスト**: エンジンのビルド中に ctest を介してテストが自動的に実行されます。
+5. **Web**: `packages/lumino-js/` で別の npm ビルドプロセスを使用します。
+
+## 重要なファイルの場所
+
+- メイン CMake: `CMakeLists.txt`
+- コアエンジン: `packages/LuminoEngine/src/`
+- パブリックヘッダー: `packages/*/include/`
+- サンプル: `packages/*/examples/`、`examples/`
+- テスト: `packages/*/test/`
+- ビルドシステム: `tools/LuminoBuild/`
+- ドキュメント: `docs/`

.github/workflows/build-continuous.yml …/workflows-disabled/build-continuous.yml.github/workflows/build-continuous.yml renamed to .github/workflows-disabled/build-continuous.yml .github/workflows/build-continuous.yml renamed to .github/workflows-disabled/build-continuous.yml

@@ -0,0 +1,34 @@
+name: Build with LUMINO_BUILD_BASE_ONLY
+
+on:
+  push:
+    branches:
+      - dev-lyric # main
+
+jobs:
+  build-base-only:
+    strategy:
+      matrix:
+        os: [windows-latest] #[ubuntu-latest, windows-latest, macos-latest]
+    runs-on: ${{ matrix.os }}
+    
+    steps:
+    - uses: actions/checkout@v3
+    
+    - name: Setup CMake
+      uses: jwlawson/actions-setup-cmake@v1.13
+      with:
+        cmake-version: 'latest'
+    
+    - name: Configure CMake (with tests)
+      run: >
+        cmake -S . -B build -G"${{ matrix.os == 'windows-latest' && 'Visual Studio 17 2022' || 'Unix Makefiles' }}"
+        -DCMAKE_INSTALL_PREFIX=installed
+        -DCMAKE_DEBUG_POSTFIX=d
+        -DLUMINO_BUILD_BASE_ONLY=ON
+        -DLUMINO_BUILD_TESTS=OFF
+    
+    - name: Build
+      run: |
+        cmake --build build --config Debug --target install
+        cmake --build build --config Release --target install

.github/workflows/package-continuous.yml …orkflows-disabled/package-continuous.yml.github/workflows/package-continuous.yml renamed to .github/workflows-disabled/package-continuous.yml .github/workflows/package-continuous.yml renamed to .github/workflows-disabled/package-continuous.yml

@@ -31,9 +31,26 @@ message("VCPKG_CMAKE_SYSTEM_NAME: ${VCPKG_CMAKE_SYSTEM_NAME}")
 # -------------------------------------------------------------------------------
 # Options
 # -------------------------------------------------------------------------------
+# MSVC Runtime library.
+option(LN_MSVC_STATIC_RUNTIME "static runtime (/MT, /MTd) or DLL runtime (/MD, /MDd) or to link either." OFF)
+
+# Builds LuminoCore.
+option(LUMINO_BUILD_BASE "Builds LuminoCore." ON)
+
+# Builds LuminoEngine.
+option(LUMINO_BUILD_ENGINE "Builds LuminoEngine." ON)
+
+# Builds Unit-Tests.
+option(LUMINO_BUILD_TESTS "Builds unit test projects." ON)
+
+# Builds only the Base module.
+option(LUMINO_BUILD_BASE_ONLY "Builds only the Base module." OFF)
+
+# -------------------------------------------------------------------------------
+# Options (experimental)
+# -------------------------------------------------------------------------------
 option(LN_TARGET_ARCH "arch." "Unknown")
 
-option(LN_BUILD_TESTS "build unit test projects." ON)
 
 option(LUMINO_BUILD_EXAMPLES "build example projects." ON)
 
@@ -46,19 +63,11 @@ option(LN_BUILD_BINDINGS "build language bindings." OFF)
 # build shared library
 option(LN_BUILD_SHARED_LIBRARY "build shared library." OFF)
 
-# build LuminoCore.
-option(LUMINO_BUILD_CORE "build LuminoCore." ON)
-
-# build LuminoEngine.
-option(LUMINO_BUILD_ENGINE "build LuminoEngine." ON)
 
 # build embedded shader transcompiler.
 option(LN_BUILD_EMBEDDED_SHADER_TRANSCOMPILER "build tool projects.build embedded shader transcompiler." OFF)
 option(LUMINO_USE_SLANG "build tool projects.build embedded shader transcompiler." OFF)
 
-# MSVC Runtime library.
-option(LN_MSVC_STATIC_RUNTIME "static runtime (/MT, /MTd) or DLL runtime (/MD, /MDd) or to link either." OFF)
-
 # use SDL on MSVC
 option(LN_MSVC_USE_SDL "use SDL on MSVC" OFF)
 
@@ -168,16 +177,34 @@ if(WIN32)
     set(LN_USE_DIRECTX12 ON)
 endif()
 
+if(LUMINO_BUILD_BASE)
+    set(LN_BUILD_BASE ON)
+else()
+    set(LN_BUILD_BASE OFF)
+endif()
 
 if(LUMINO_BUILD_ENGINE)
-    set(LUMINO_BUILD_CORE ON)
+    set(LN_BUILD_ENGINE ON)
+    set(LUMINO_BUILD_BASE ON)
+else()
+    set(LN_BUILD_ENGINE OFF)
+endif()
+
+if(LUMINO_BUILD_TESTS)
+    set(LN_BUILD_TESTS ON)
+else()
+    set(LN_BUILD_TESTS OFF)
+endif()
+
+if(LUMINO_BUILD_BASE_ONLY)
+    set(LN_BUILD_BASE ON)
+    set(LN_BUILD_ENGINE OFF)
 endif()
 
 # -------------------------------------------------------------------------------
 # Externals
 # -------------------------------------------------------------------------------
-find_package(tl-expected CONFIG REQUIRED)
-if(LN_OS_DESKTOP)
+if(LN_BUILD_TESTS AND LN_OS_DESKTOP)
     find_package(GTest CONFIG REQUIRED)
 endif()
 
@@ -194,20 +221,19 @@ set(LN_SOURCES_gtest
 set(LN_GLTF_SAMPLE_MODELS_DIR "${CMAKE_CURRENT_LIST_DIR}/build/ExternalSource/glTF-Sample-Models/")
 
 # ------------------------------------------------------------------------------
-if(LUMINO_BUILD_CORE)
+if(LN_BUILD_BASE)
     add_subdirectory(packages/LuminoCore)
 endif()
 
-if(LUMINO_USE_WEBGPU)
-    set(LN_USE_WEBGPU ON)
-    if(LN_OS_DESKTOP)
-        set(LN_DESKTOP_WEBGPU ON)
-        set(WEBGPU_BACKEND "DAWN")
-        add_subdirectory(build/tools/WebGPU-distribution)
+if(LN_BUILD_ENGINE)
+    if(LUMINO_USE_WEBGPU)
+        set(LN_USE_WEBGPU ON)
+        if(LN_OS_DESKTOP)
+            set(LN_DESKTOP_WEBGPU ON)
+            set(WEBGPU_BACKEND "DAWN")
+            add_subdirectory(build/tools/WebGPU-distribution)
+        endif()
     endif()
-endif()
-
-if(LUMINO_BUILD_ENGINE)
     if(LN_EMSCRIPTEN)
         add_subdirectory(packages/LuminoEngine)
         add_subdirectory(examples/Example-WebLibrary)

.github/workflows/build-LUMINO_BUILD_BASE_ONLY.yml

@@ -2,17 +2,17 @@
 ==========
 
 Lumino is an open source library for building interactive applications such as games and digital art.
-It provides a simple API that runs on multiple platforms and is available for multiple programming languages.
+It provides a API that runs on multiple platforms and is available for multiple programming languages.
 
 Lumino はゲームやデジタルアートなどのインタラクティブアプリケーションを構築するためのオープンソースライブラリです。
-マルチプラットフォームで動作し複数のプログラミング言語から利用できる、シンプルな API を提供します。
+マルチプラットフォームで動作し複数のプログラミング言語から利用できる API を提供します。
 
 ## 💡 Project Status
 
 Lumino is currently being developed with the following two use cases in mind.
 
 - A. Use the core game engine modules (Graphics, Audio, Input, etc.) in other game engines or applications.
-- B. Use the basic modules (String, Array, FileSystem, etc.) in IoT platforms and testing tools. (auxiliary)
+- [B. Use the basic modules (String, Array, FileSystem, etc.) in IoT platforms and testing tools. (auxiliary)](./docs/use-base-module.md)
 
 Until v0.10.1, Lumino was developed as a standalone game engine, but the main motivation was technical exploration.
 
@@ -27,7 +27,7 @@ The future development concept is as follows:
 Lumino は現在、次の2つのユースケースを想定して開発を続けています。
 
 - A. ゲームエンジンのコアモジュール (Graphics, Audio, Input 等) を 他のゲームエンジンやアプリケーションで利用する。
-- B. 基礎的なモジュール (String, Array, FileSystem, 等) を IoTプラットフォームやテスティングツール で利用する。（補助的）
+- [B. 基礎的なモジュール (String, Array, FileSystem, 等) を IoTプラットフォームやテスティングツール で利用する。（補助的）](./docs/use-base-module.md)
 
 v0.10.1 までの Lumino はスタンドアロンゲームエンジンとして開発を続けていましたが、その主な動機は技術的探求でした。
 

CMakeLists.txt

@@ -0,0 +1,26 @@
+# Using only the Base module
+
+1. Configure
+
+```sh
+# Without unit tests.
+cmake -S <RepositoryRootDir> -B <BuildDir> -G<Generator> \
+  -DCMAKE_INSTALL_PREFIX=<InstallDir> \
+  -DCMAKE_DEBUG_POSTFIX=d \
+  -DLUMINO_BUILD_BASE_ONLY=ON \
+  -DLUMINO_BUILD_TESTS=OFF
+
+# With unit tests.
+cmake -S <RepositoryRootDir> -B <BuildDir> -G<Generator> \
+  -DCMAKE_INSTALL_PREFIX=<InstallDir> \
+  -DCMAKE_DEBUG_POSTFIX=d \
+  -DLUMINO_BUILD_BASE_ONLY=ON
+```
+
+2. Build
+
+```sh
+cmake --build <BuildDir> --config Debug --target install
+cmake --build <BuildDir> --config Release --target install
+```
+

README.md

@@ -54,7 +54,7 @@ target_include_directories(
     "src"
 )
 
-target_link_libraries(${PROJECT_NAME} PRIVATE tl::expected ${LN_LINK_LIBS})
+target_link_libraries(${PROJECT_NAME} PRIVATE ${LN_LINK_LIBS})
 
 set_target_properties(${PROJECT_NAME} PROPERTIES FOLDER "Lumino")
 target_precompile_headers(${PROJECT_NAME} PRIVATE "src/LuminoCore.PCH.h")

docs/use-base-module.md

@@ -1,5 +1,5 @@
 #pragma once
-#include <tl/expected.hpp>
+#include "detail/tl/expected.hpp"
 #include "String.hpp"
 
 namespace ln {