plusui-native 0.2.107 → 0.2.109

package/templates/base/Justfile

@@ -1,115 +1,115 @@
-# PlusUI Project Justfile
-# Cross-platform build automation
-
-# Use PowerShell on Windows, bash on Unix
-set windows-shell := ["powershell.exe", "-NoLogo", "-Command"]
-set shell := ["bash", "-cu"]
-
-# Project name (from directory)
-project_name := file_stem(justfile_directory())
-
-# Default recipe
-default: dev
-
-# ============================================================
-# DEVELOPMENT
-# ============================================================
-
-# Start development mode (frontend HMR + C++ app)
-dev:
-    npm run dev
-
-# Start only frontend dev server (Vite with HMR)
-dev-frontend:
-    npm run dev:frontend
-
-# Start only backend in watch mode
-dev-backend:
-    npm run dev:backend
-
-# ============================================================
-# BUILD
-# ============================================================
-
-# Build for current platform (dev mode, connects to Vite)
-build:
-    npm run build
-
-# Build frontend only
-build-frontend:
-    npm run build:frontend
-
-# Build backend only (production mode)
-build-backend:
-    npm run build:backend
-
-# Build for all platforms
-build-all:
-    npm run build:all
-
-# ============================================================
-# PLATFORM-SPECIFIC BUILDS
-# ============================================================
-
-# Build for Windows
-build-windows:
-    @echo "Building for Windows..."
-    cmake -S . -B build/Windows -DCMAKE_BUILD_TYPE=Release
-    cmake --build build/Windows --config Release
-
-# Build for macOS
-build-macos:
-    @echo "Building for macOS..."
-    cmake -S . -B build/MacOS -G Xcode -DCMAKE_BUILD_TYPE=Release
-    cmake --build build/MacOS --config Release
-
-# Build for Linux
-build-linux:
-    @echo "Building for Linux..."
-    cmake -S . -B build/Linux -DCMAKE_BUILD_TYPE=Release
-    cmake --build build/Linux --config Release
-
-# ============================================================
-# RUN
-# ============================================================
-
-# Run the built application
-run:
-    npm run start
-
-# ============================================================
-# UTILITIES
-# ============================================================
-
-# Clean build artifacts
-clean:
-    @echo "Cleaning build artifacts..."
-    rm -rf build
-    rm -rf frontend/dist
-    @echo "Done!"
-
-# Clean everything including node_modules
-clean-all: clean
-    rm -rf node_modules
-    rm -rf frontend/node_modules
-
-# Install dependencies
-install:
-    npm install
-    cd frontend && npm install
-
-# Check development environment
-doctor:
-    plusui doctor
-
-# Fix development environment
-doctor-fix:
-    plusui doctor --fix
-
-# ============================================================
-# HELP
-# ============================================================
-
-# Show available commands
-help:
-    @just --list
+# PlusUI Project Justfile
+# Cross-platform build automation
+
+# Use PowerShell on Windows, bash on Unix
+set windows-shell := ["powershell.exe", "-NoLogo", "-Command"]
+set shell := ["bash", "-cu"]
+
+# Project name (from directory)
+project_name := file_stem(justfile_directory())
+
+# Default recipe
+default: dev
+
+# ============================================================
+# DEVELOPMENT
+# ============================================================
+
+# Start development mode (frontend HMR + C++ app)
+dev:
+    npm run dev
+
+# Start only frontend dev server (Vite with HMR)
+dev-frontend:
+    npm run dev:frontend
+
+# Start only backend in watch mode
+dev-backend:
+    npm run dev:backend
+
+# ============================================================
+# BUILD
+# ============================================================
+
+# Build for current platform (dev mode, connects to Vite)
+build:
+    npm run build
+
+# Build frontend only
+build-frontend:
+    npm run build:frontend
+
+# Build backend only (production mode)
+build-backend:
+    npm run build:backend
+
+# Build for all platforms
+build-all:
+    npm run build:all
+
+# ============================================================
+# PLATFORM-SPECIFIC BUILDS
+# ============================================================
+
+# Build for Windows
+build-windows:
+    @echo "Building for Windows..."
+    cmake -S . -B Build/Windows -DCMAKE_BUILD_TYPE=Release
+    cmake --build Build/Windows --config Release
+
+# Build for macOS
+build-macos:
+    @echo "Building for macOS..."
+    cmake -S . -B Build/MacOS -G Xcode -DCMAKE_BUILD_TYPE=Release
+    cmake --build Build/MacOS --config Release
+
+# Build for Linux
+build-linux:
+    @echo "Building for Linux..."
+    cmake -S . -B Build/Linux -DCMAKE_BUILD_TYPE=Release
+    cmake --build Build/Linux --config Release
+
+# ============================================================
+# RUN
+# ============================================================
+
+# Run the built application
+run:
+    npm run start
+
+# ============================================================
+# UTILITIES
+# ============================================================
+
+# Clean build artifacts
+clean:
+    @echo "Cleaning build artifacts..."
+    rm -rf Build
+    rm -rf frontend/dist
+    @echo "Done!"
+
+# Clean everything including node_modules
+clean-all: clean
+    rm -rf node_modules
+    rm -rf frontend/node_modules
+
+# Install dependencies
+install:
+    npm install
+    cd frontend && npm install
+
+# Check development environment
+doctor:
+    plusui doctor
+
+# Fix development environment
+doctor-fix:
+    plusui doctor --fix
+
+# ============================================================
+# HELP
+# ============================================================
+
+# Show available commands
+help:
+    @just --list

package/templates/base/README.md.template

@@ -1,185 +1,185 @@
-# {{PROJECT_NAME}}
-
-A desktop application built with the PlusUI framework.
-
-## Prerequisites
-
-Check your development environment:
-```bash
-plusui doctor
-```
-
-If any tools are missing, run:
-```bash
-plusui doctor --fix
-```
-
-## Development
-
-Start development server with hot reload:
-```bash
-npm run dev
-```
-
-This will:
-- Start the Vite dev server with HMR on http://localhost:5173
-- Build and launch the C++ app pointing to the dev server
-- Changes to frontend code reflect instantly
-- Auto-refresh app bindings when `src/features` exists
-
-Dev build intermediates are stored in `.plusui/dev/...` so your `build/` folder stays focused on release/platform outputs.
-
-Note: You can run `npm run connect` manually anytime.
-
-## Connection Generation (App-level)
-
-Generate project connection bindings from real `connect.emit()`/`connect.on()` usage:
-```bash
-npm run connect
-```
-
-Default connect generator paths:
-- Input: project root scan (frontend + backend files)
-- Output: `Connections/` (at project root)
-
-Generated structure:
-- `Connections/connections.gen.ts`    — typed TS channel exports (regenerated)
-- `Connections/connections.gen.hpp`   — C++ `Connections` struct (regenerated)
-- `Connections/connect.manifest.json` — detected channel list (regenerated)
-
-All three files are always regenerated — do not manually edit them.
-
-Scan extensions:
-- `WEB_IO`: `.ts`, `.tsx`, `.js`, `.jsx`, `.mts`, `.cts`, `.html`
-- `CPP_IO`: `.h`, `.hpp`, `.hh`, `.hxx`, `.cpp`, `.cc`, `.cxx`
-
-`plusui connect` scans your project structure and does not require a schema file.
-
-You can also pass custom paths:
-```bash
-plusui connect <projectRoot> <outputDir>
-```
-
-## Assets & Icons
-
-### App Icon
-
-Place your app icon at `assets/icon.png` (512x512+ recommended). Generate platform-specific icons:
-
-```bash
-plusui icons
-```
-
-This creates:
-- **Windows**: `app.ico` for title bar, taskbar, task manager
-- **macOS**: `app.icns` for dock, finder, about dialog  
-- **Linux**: Multiple PNG sizes for window managers
-- **Tray**: Small icons for system tray (all platforms)
-
-### Embedded Assets
-
-All files in `assets/` are embedded into the final executable. Access them in C++:
-
-```cpp
-#include <plusui/resources.hpp>
-std::string data = plusui::resources::getResource("path/to/file.png");
-```
-
-See `assets/README.md` for details.
-
-## Build
-
-### Build for current platform
-```bash
-npm run build
-```
-
-Build also auto-refreshes app bindings when `src/features` exists.
-
-### Build for all platforms
-```bash
-npm run build:all
-```
-
-This creates platform-specific builds in:
-```
-build/
-├── Windows/    # Windows builds
-├── MacOS/      # macOS builds
-├── Linux/      # Linux builds
-├── Android/    # Android builds
-└── iOS/        # iOS builds
-```
-
-### Platform-specific builds
-```bash
-plusui build:windows
-plusui build:macos
-plusui build:linux
-```
-
-## Run
-
-Run the built application:
-```bash
-npm run start
-```
-
-## Using Just (Optional)
-
-If you have [`just`](https://github.com/casey/just) installed:
-
-```bash
-just dev          # Start development mode
-just build        # Build for current platform
-just build-all    # Build for all platforms
-just run          # Run the built application
-just clean        # Clean build artifacts
-just help         # Show all commands
-```
-
-## Project Structure
-
-```
-{{PROJECT_NAME}}/
-├── src/                  # C++ backend code
-│   └── main.cpp          # Application entry point
-├── frontend/             # Frontend web code (React + Vite)
-│   ├── src/
-│   │   ├── main.tsx      # React entry point
-│   │   ├── App.tsx       # Main app component
-│   │   └── styles/       # CSS styles
-│   ├── index.html
-│   └── vite.config.ts
-├── build/                # Build output (generated)
-├── CMakeLists.txt        # CMake build configuration
-├── package.json          # npm dependencies and scripts
-└── Justfile              # Build automation (optional)
-```
-
-## Calling C++ from TypeScript
-
-All features and custom channels are available via a single import:
-
-```tsx
-import plusui from 'plusui';
-// or named imports:
-import { connect, win, clipboard, app } from 'plusui';
-
-// Window controls
-await win.minimize();
-await win.maximize();
-await win.close();
-
-// Get window info
-const size = await win.getSize();
-console.log(`Window size: ${size.width}x${size.height}`);
-```
-
-## Learn More
-
-- [PlusUI Documentation](https://github.com/yourorg/plusui)
-- [React Documentation](https://react.dev/)
-- [Vite Documentation](https://vitejs.dev/)
-
-
+# {{PROJECT_NAME}}
+
+A desktop application built with the PlusUI framework.
+
+## Prerequisites
+
+Check your development environment:
+```bash
+plusui doctor
+```
+
+If any tools are missing, run:
+```bash
+plusui doctor --fix
+```
+
+## Development
+
+Start development server with hot reload:
+```bash
+npm run dev
+```
+
+This will:
+- Start the Vite dev server with HMR on http://localhost:5173
+- Build and launch the C++ app pointing to the dev server
+- Changes to frontend code reflect instantly
+- Auto-refresh app bindings when `src/features` exists
+
+Dev build intermediates are stored in `Build/dev/...` so your `Build/` folder stays focused on release/platform outputs.
+
+Note: You can run `npm run connect` manually anytime.
+
+## Connection Generation (App-level)
+
+Generate project connection bindings from real `connect.emit()`/`connect.on()` usage:
+```bash
+npm run connect
+```
+
+Default connect generator paths:
+- Input: project root scan (frontend + backend files)
+- Output: `Connections/` (at project root)
+
+Generated structure:
+- `Connections/connections.gen.ts`    — typed TS channel exports (regenerated)
+- `Connections/connections.gen.hpp`   — C++ `Connections` struct (regenerated)
+- `Connections/connect.manifest.json` — detected channel list (regenerated)
+
+All three files are always regenerated — do not manually edit them.
+
+Scan extensions:
+- `WEB_IO`: `.ts`, `.tsx`, `.js`, `.jsx`, `.mts`, `.cts`, `.html`
+- `CPP_IO`: `.h`, `.hpp`, `.hh`, `.hxx`, `.cpp`, `.cc`, `.cxx`
+
+`plusui connect` scans your project structure and does not require a schema file.
+
+You can also pass custom paths:
+```bash
+plusui connect <projectRoot> <outputDir>
+```
+
+## Assets & Icons
+
+### App Icon
+
+Place your app icon at `assets/icon.png` (512x512+ recommended). Generate platform-specific icons:
+
+```bash
+plusui icons
+```
+
+This creates:
+- **Windows**: `app.ico` for title bar, taskbar, task manager
+- **macOS**: `app.icns` for dock, finder, about dialog  
+- **Linux**: Multiple PNG sizes for window managers
+- **Tray**: Small icons for system tray (all platforms)
+
+### Embedded Assets
+
+All files in `assets/` are embedded into the final executable. Access them in C++:
+
+```cpp
+#include <plusui/resources.hpp>
+std::string data = plusui::resources::getResource("path/to/file.png");
+```
+
+See `assets/README.md` for details.
+
+## Build
+
+### Build for current platform
+```bash
+npm run build
+```
+
+Build also auto-refreshes app bindings when `src/features` exists.
+
+### Build for all platforms
+```bash
+npm run build:all
+```
+
+This creates platform-specific builds in:
+```
+Build/
+├── Windows/    # Windows builds
+├── MacOS/      # macOS builds
+├── Linux/      # Linux builds
+├── Android/    # Android builds
+└── iOS/        # iOS builds
+```
+
+### Platform-specific builds
+```bash
+plusui build:windows
+plusui build:macos
+plusui build:linux
+```
+
+## Run
+
+Run the built application:
+```bash
+npm run start
+```
+
+## Using Just (Optional)
+
+If you have [`just`](https://github.com/casey/just) installed:
+
+```bash
+just dev          # Start development mode
+just build        # Build for current platform
+just build-all    # Build for all platforms
+just run          # Run the built application
+just clean        # Clean build artifacts
+just help         # Show all commands
+```
+
+## Project Structure
+
+```
+{{PROJECT_NAME}}/
+├── src/                  # C++ backend code
+│   └── main.cpp          # Application entry point
+├── frontend/             # Frontend web code (React + Vite)
+│   ├── src/
+│   │   ├── main.tsx      # React entry point
+│   │   ├── App.tsx       # Main app component
+│   │   └── styles/       # CSS styles
+│   ├── index.html
+│   └── vite.config.ts
+├── Build/                # Build output (generated)
+├── CMakeLists.txt        # CMake build configuration
+├── package.json          # npm dependencies and scripts
+└── Justfile              # Build automation (optional)
+```
+
+## Calling C++ from TypeScript
+
+All features and custom channels are available via a single import:
+
+```tsx
+import plusui from 'plusui';
+// or named imports:
+import { connect, win, clipboard, app } from 'plusui';
+
+// Window controls
+await win.minimize();
+await win.maximize();
+await win.close();
+
+// Get window info
+const size = await win.getSize();
+console.log(`Window size: ${size.width}x${size.height}`);
+```
+
+## Learn More
+
+- [PlusUI Documentation](https://github.com/yourorg/plusui)
+- [React Documentation](https://react.dev/)
+- [Vite Documentation](https://vitejs.dev/)
+
+