cluaupp 1.0.0 → 1.4.0

package/templates/game/src/ReplicatedStorage/Shared/Constants/Primitives/.gitkeep

@@ -0,0 +1 @@
+

package/templates/game/src/ReplicatedStorage/Shared/Modules/.gitkeep

@@ -0,0 +1 @@
+

package/templates/game/src/ReplicatedStorage/Shared/Net/.gitkeep

@@ -0,0 +1 @@
+

package/templates/game/src/ReplicatedStorage/Shared/Services/.gitkeep

@@ -0,0 +1 @@
+

package/templates/game/src/ReplicatedStorage/Shared/Types/.gitkeep

@@ -0,0 +1 @@
+

package/templates/game/src/ReplicatedStorage/Shared/Utils/.gitkeep

@@ -0,0 +1 @@
+

package/templates/game/src/ServerScriptService/Boot/DataBoot.server.clpp

@@ -0,0 +1,13 @@
+#pragma strict
+#include <clpp/roblox.clh>
+#include <clpp/libs/keep.clh>
+#include "../../ReplicatedStorage/Shared/Constants/Datas/TemplateData.clh"
+
+void init() {
+	PlayerTemplate playerData;
+	Keep.Server.Init(DataServiceOptions {
+		.Template = playerData,
+		.StoreName = "PlayerData",
+		.UseMock = true,
+	});
+}

package/templates/game/src/ServerScriptService/Components/.gitkeep

@@ -0,0 +1 @@
+

package/templates/game/src/ServerScriptService/Configuration/ServerConfig.clp

@@ -0,0 +1,4 @@
+#pragma once
+
+const string STORE_NAME = "PlayerData";
+const bool USE_MOCK_IN_STUDIO = true;

package/templates/game/src/ServerScriptService/Handlers/Guard.server.clpp

@@ -0,0 +1,7 @@
+#pragma strict
+#include <clpp/roblox.clh>
+#include <clpp/libs/ward.clh>
+
+void init() {
+	Ward.Start();
+}

package/templates/game/src/ServerScriptService/Handlers/PlayerHandler.server.clpp

@@ -0,0 +1,24 @@
+#pragma strict
+#include <clpp/roblox.clh>
+#include <clpp/libs/keep.clh>
+
+void BindLeaderstats(Player player) {
+	Data data = Keep.Server.WaitFor(player);
+	if (player.FindFirstChild("leaderstats") != null) {
+		return;
+	}
+
+	Folder leaderstats = new Folder(player);
+	leaderstats.Name = "leaderstats";
+	IntValue coins = new IntValue(leaderstats);
+	coins.Name = "Coins";
+	coins.Value = data.Get(Keep.Server.Paths.Currencies.Coins);
+}
+
+void init() {
+	Players players = GetService<Players>();
+	for (Player player in players.GetPlayers()) {
+		BindLeaderstats(player);
+	}
+	players.PlayerAdded~>Connect(BindLeaderstats);
+}

package/templates/game/src/ServerScriptService/Services/.gitkeep

@@ -0,0 +1 @@
+

package/templates/game/src/ServerStorage/Configuration/.gitkeep

@@ -0,0 +1 @@
+

package/templates/game/src/ServerStorage/Modules/.gitkeep

@@ -0,0 +1 @@
+

package/{examples/game/src/client/init.client.clpp → templates/game/src/StarterPlayer/StarterCharacterScripts/Character/CharacterReady.client.clpp}

@@ -2,5 +2,5 @@
 #include <clpp/roblox.clh>
 
 void init() {
-	post("Cluaupp client ok");
+	post("character local ready");
 }

package/templates/game/src/StarterPlayer/StarterCharacterScripts/Combat/.gitkeep

@@ -0,0 +1 @@
+

package/templates/game/src/StarterPlayer/StarterCharacterScripts/Movement/.gitkeep

@@ -0,0 +1 @@
+

package/templates/game/src/StarterPlayer/StarterPlayerScripts/Controllers/DataController.client.clpp

@@ -0,0 +1,7 @@
+#pragma strict
+#include <clpp/roblox.clh>
+#include <clpp/libs/keep.clh>
+
+void init() {
+	Keep.Client.Init();
+}

package/templates/game/src/StarterPlayer/StarterPlayerScripts/Input/.gitkeep

@@ -0,0 +1 @@
+

package/templates/game/src/StarterPlayer/StarterPlayerScripts/UI/.gitkeep

@@ -0,0 +1 @@
+

package/templates/game/wally.toml

@@ -4,8 +4,9 @@ version = "0.1.0"
 registry = "https://github.com/UpliftGames/wally-index"
 realm = "shared"
 
-# CluauppLibs already ships Janitor, Promise, Fusion, Iris, Cmdr, TopbarPlus,
-# Chrono, DataServiceV2, EzVisualz, StateMachine, Spring, Display, Module3D,
-# FormatNumber. Add Wally entries only for extra packages.
+# CluauppLibs (copied to ReplicatedStorage.CluauppLibs on init/build) already
+# ships Sweep, Spark, Keep, Flare, Mint, Axiom, Roster, Gleam, Bloom, Lens,
+# Crest, Pin, Stage, Coil, Helm, Shift, Hive, Ember, Echo, Guide, Trace, Promise, Net.
+# Add Wally entries only for packages that are not in CluauppLibs.
 
 [dependencies]

package/docs/README.md

@@ -1,27 +0,0 @@
-# Cluaupp documentation
-
-The live handbook is **[GitHub Pages](https://kartzrbx.github.io/Cluaupp/docs/)**. Language course: **[CL++](https://kartzrbx.github.io/CLPP/)**.
-
-## Start
-
-1. [Intro](intro.md)
-2. [Getting started](getting-started.md)
-3. [CLI](cli.md)
-4. [Config](config.md)
-5. [IntelliSense](intellisense.md) — `clpp install`
-6. [Migration](migration.md) — `.cpp` → `.clpp`
-
-## Language
-
-Syntax lives in CL++. Cluaupp [syntax](syntax.md) is a short map of operators and file tags.
-
-## Structure
-
-- [Architecture](architecture.md) — one file in, one file out
-- [OOP / file tags](oop/file-tags.md)
-
-## Roblox
-
-- [Libraries](libraries/index.md)
-- [Examples](examples/index.md)
-- [Comparison](comparison.md)

package/docs/architecture.md

@@ -1,29 +0,0 @@
----
-title: Architecture
-sidebar_position: 15
----
-
-# One file in, one file out
-
-roblox-ts decides **what instance you get** from a filename **key**. Cluaupp does the same for **CL++**.
-
-| Key | Rojo instance | Default output |
-| --- | --- | --- |
-| `*.server.clpp` | Script | `*.server.luau` |
-| `*.client.clpp` | LocalScript | `*.client.luau` |
-| `*.plugin.clpp` | Plugin Script | `*.plugin.luau` |
-| `.clp` / untagged `.clpp` | ModuleScript | `Name.luau` |
-| `.clh` | ModuleScript | `Name.luau` |
-
-```
-src/server/leaderstats.server.clpp  →  out/server/leaderstats.server.luau
-src/client/hud.client.clpp          →  out/client/hud.client.luau
-src/shared/config.clp               →  out/shared/config.luau
-src/shared/PlayerData.clh           →  out/shared/PlayerData.luau
-```
-
-`"architecture": true` (ForeverHD `Main` / Managers folders) is **not** generated in Cluaupp 1.0. `clpp` compiles each file; this CLI maps libraries and writes `out/`.
-
-`--!strict` is opt-in: `#pragma strict` or `"strict": true` in `cluaupp.config.json`.
-
-Language: [kartzrbx.github.io/CLPP](https://kartzrbx.github.io/CLPP/). File tags: [OOP](oop/file-tags.md).

package/docs/cli.md

@@ -1,39 +0,0 @@
-# CLI
-
-```
-cluaupp <command> [folder]
-```
-
-Cluaupp orchestrates **CL++ → Luau**. It does not parse the language. `clpp` (on PATH) compiles each `.clpp` / `.clp` / `.clh`; Cluaupp post-processes and writes `out/`.
-
-## `cluaupp init [folder]`
-
-Creates `src/server`, `src/client`, `src/shared`, Rojo, `rokit.toml`, and a CL++ scaffold. Then run `clpp install` for editor IntelliSense.
-
-## `cluaupp build [folder]`
-
-Compiles `src/**/*.{clpp,clp,clh}` into `out/`. One tagged file becomes one Luau instance.
-
-```bash
-cluaupp build
-cluaupp build --format --analyze
-cluaupp build --input ./src/server/boot.server.clpp --output ./out/boot.server.luau
-```
-
-`--format` runs StyLua; `--analyze` runs `luau-analyze`.
-
-If `clpp` is missing: install [CL++](https://github.com/KartzRbx/CLPP) or set `CLPP_PATH`.
-
-## `cluaupp watch [folder]`
-
-Rebuilds on save. Does not write `out/` while compile fails.
-
-## `cluaupp language`
-
-Prints `clpp api manifest` (extensions, tags, operators).
-
-## `cluaupp intellisense` / `cluaupp lsp`
-
-Delegates to CL++ (`clpp install`). Cluaupp only writes `files.associations` for `clpp`.
-
-## `cluaupp --version` / `--help`

package/docs/comparison.md

@@ -1,19 +0,0 @@
-# Why Cluaupp
-
-## vs roblox-ts
-
-[roblox-ts](https://roblox-ts.com/) transpiles TypeScript → Luau. Cluaupp does the same job for **[CL++](https://kartzrbx.github.io/CLPP/)**: one familiar syntax, readable Luau, Roblox APIs as in Studio.
-
-`*.server.clpp` → Script, `*.client.clpp` → LocalScript, untagged → ModuleScript.
-
-## vs C++ → WASM
-
-Cluaupp never compiles native C++ or WASM. The language compiler is `clpp` (Rust). This package is init / Rojo / CluauppLibs.
-
-## When to use what
-
-| Goal | Tool |
-| --- | --- |
-| Game in TypeScript | roblox-ts |
-| Game in CL++ | **Cluaupp** + [`clpp`](https://github.com/KartzRbx/CLPP) |
-| Language reference | [kartzrbx.github.io/CLPP](https://kartzrbx.github.io/CLPP/) |

package/docs/config.md

@@ -1,30 +0,0 @@
-# Configuration
-
-File: `cluaupp.config.json` at the game root (next to `src/`).
-
-```json
-{
-	"rootDir": "src",
-	"outDir": "out",
-	"strict": false,
-	"architecture": false
-}
-```
-
-| Field | Default | Effect |
-| --- | --- | --- |
-| `rootDir` | `"src"` | Where `.clpp` / `.clp` / `.clh` live |
-| `outDir` | `"out"` | Where Luau is written |
-| `strict` | `false` | Prefix `--!strict` when `clpp` did not already (overridden by `#pragma`) |
-| `architecture` | `false` | Ignored in 1.0 (always one file in, one file out) |
-
-## Rojo
-
-The template maps:
-
-- `out/server` → `ServerScriptService.Cluaupp`
-- `out/client` → `StarterPlayer.StarterPlayerScripts.Cluaupp`
-- `out/shared` → `ReplicatedStorage.Cluaupp`
-- `libs` → `ReplicatedStorage.CluauppLibs`
-
-`*.server.clpp` → `*.server.luau` (Script). `*.client.clpp` → LocalScript. `.clp` / `.clh` → ModuleScript.

package/docs/cpp-advanced.md

@@ -1,78 +0,0 @@
----
-title: Advanced Cluaupp
-sidebar_position: 14
----
-
-# Advanced Cluaupp
-
-The subset is intentional. What exists is enough for game scripts; what is missing is listed so you do not fight the compiler.
-
-## Supported
-
-- Functions, prototypes (headers only), `if` / `else` / `while` / range-`for` / `switch` (`case`, `default`, `break`)
-- `struct` types + `Class::` methods in a sibling `.h` / `.cpp`
-- `new Class(parent)`, `GetService<T>()`, `::` statics (`CFrame::lookAt`, `Enum::Material::Plastic`)
-- `static_cast<T>(x)`, `(void)x`, lambdas in `Connect` / `Add`
-- `static` / `constexpr` / `inline` specifiers, `LuaArray<T>`, `string_concat`
-- `->` methods and properties, `.` members, `Connect`
-- `const`, `auto`, `nullptr`, arithmetic, `&&` `||` `!=`, string `+`
-- Quoted includes, `.h` / `.hpp` as sources
-- Libraries via `#include <cluaupp/libs/...>` → `require(CluauppLibs.*)`
-
-## Not supported (yet)
-
-Full C++: templates besides `GetService<T>` / `static_cast` / `LuaArray`, `class` bodies as emitted metatables, `std::`, overloading as two runtimes, C-style `for`, macros, pointer arithmetic, JSX.
-
-If you need a custom type, it is usually a **ModuleScript in shared** (a `.cpp` of functions) or a Wally package, not a C++ class the compiler would lower to a metatable.
-
-## `::` vs `:` vs `.`
-
-| C++ | Luau | When |
-| --- | --- | --- |
-| `CFrame::lookAt(a, b)` | `CFrame.lookAt(a, b)` | datatype / enum / module static |
-| `MathUtils::Lerp(a, b, t)` | `MathUtils.Lerp(a, b, t)` | Cluaupp module function |
-| `Module3D::Attach3D(frame, model)` | `Module3D:Attach3D(frame, model)` | Module3D’s colon API |
-| `player->FindFirstChild("x")` | `player:FindFirstChild("x")` | Instance method |
-| `player->Name` | `player.Name` | property |
-| `janitor->Add(conn)` | `janitor:Add(conn)` | library method |
-
-## Init
-
-If a file defines `void init()`, Cluaupp calls `init()` at the end of the `.luau`. Use that as the Script / LocalScript entry. Shared modules should **not** define `init()` unless you want them to run on require.
-
-## Mixing extra Wally packages
-
-CluauppLibs already contains the full Janitor, Fusion, Cmdr, DataServiceV2, … systems (copied from GitHub into `runtime/`). Add Wally only for packages that are **not** in CluauppLibs. Headers in `include/cluaupp/libs/` match the shipped Luau.
-
-```cpp
-#include <cluaupp/libs/dataservice.hpp>
-
-void Grant(Player* player, int amount) {
-	Data* data = DataService::Server.WaitFor(player);
-	if (data == nullptr) {
-		return;
-	}
-	int coins = data->Get(DataService::Server.Paths.Currencies.Money);
-	data->Set(DataService::Server.Paths.Currencies.Money, coins + amount);
-}
-```
-
-`Paths.Currencies.Money` exists because **your** Template passed to `Init` had that field. Full copies: [Examples](examples/index.md).
-
-## Performance notes
-
-- Prefer `const` and locals over recomputing in `RenderStepped`.
-- `Net` already uses `buffer`. Batch when you can; do not fire per-heartbeat for every NPC.
-- Module3D is a ViewportFrame — fine for shops and inventory, not for cloning the whole map (same advice as the [original Module3D thread](https://devforum.roblox.com/t/module3d-v61-viewportframe-implementation/207383)).
-- Janitor `Cleanup` is O(tracked objects). Link to the Instance that owns the scope instead of a global janitor for the whole server.
-
-## Good C++ conduct that still applies
-
-1. **Initialize everything.** `int coins;` without a value is a bug; write `int coins = 0`.
-2. **Small functions.** One behavior, named after the behavior.
-3. **No magic numbers.** `const int MAX_INVENTORY = 20`.
-4. **Early return.** Flatten `if` pyramids.
-5. **Headers declare, scripts define.** Prototypes in `.h`, bodies in `.cpp`.
-6. **Do not share mutable statics across server and client** — use Net or DataService.
-
-See also: [syntax](syntax.md) (complete subset), [print and cout](print-cout.md), [libraries](libraries/index.md), [OOP](oop/index.md), [examples](examples/index.md), [comparison](comparison.md). Optimization notes on the site: [Optimization](https://kartzrbx.github.io/Cluaupp/docs/optimization.html).

package/docs/cpp-const.md

@@ -1,52 +0,0 @@
----
-title: const and immutability
-sidebar_position: 11
----
-
-# const and immutability
-
-A value that must not change should say so. In C++ that is `const`. Cluaupp emits Luau `const`, not `local x <const>`.
-
-```cpp
-const int STARTING_COINS = 0;
-const double GRAVITY = 196.2;
-```
-
-```luau
-const STARTING_COINS: number = 0
-const GRAVITY: number = 196.2
-```
-
-## Why it is a safety feature
-
-- Leaderstat starting values, product IDs, remote names, and animation speeds are configuration. If they are `local`, a later line can overwrite them by accident.
-- Reviewers see `const` and skip “could this mutate?”.
-- Luau `--!strict` rejects assignment to `const`.
-
-## What to keep mutable
-
-Player-owned numbers (`coins`, `combo`), UI state, and Janitor instances. Everything else defaults to `const` until you have a reason.
-
-```cpp
-const string REMOTE_COINS = "Coins";
-int coins = 0;
-
-void AddCoins(int amount) {
-	coins = coins + amount;
-}
-```
-
-`REMOTE_COINS` is a protocol name — immutable. `coins` is session state — mutable.
-
-## Immutability for tables and Instances
-
-`const` on a pointer does not freeze the Instance. `const Folder* stats` still has a mutable `Name` in Roblox. Treat “do not rebind the variable” and “do not mutate the object” as two separate decisions. For objects, prefer:
-
-- Create, parent, configure once, then only read.
-- Put mutations behind one function (`SetCoins`) instead of writing `coins.Value` from five scripts.
-
-## DataService paths
-
-Path tokens (`"Currencies.Coins"`) should be `const string` or a shared header. Never concatenate remote or datastore keys from user input.
-
-Next: [safety](cpp-safety.md).

package/docs/cpp-organization.md

@@ -1,63 +0,0 @@
----
-title: Organization
-sidebar_position: 13
----
-
-# Organization
-
-A Cluaupp game is laid out like a roblox-ts project on disk. One tagged `.cpp` becomes one Luau instance (`leaderstats.server.luau`, `hud.client.luau`). See [Architecture](architecture.md).
-
-```
-src/
-  server/     → Script (out/server)
-  client/     → LocalScript (out/client)
-  shared/     → ModuleScript (out/shared)
-include/cluaupp/   IntelliSense
-libs/              CluauppLibs (full Janitor, Fusion, Cmdr, DataService, …)
-Packages/          extra Wally packages only
-cluaupp.config.json
-default.project.json
-wally.toml
-```
-
-## Server / client / shared
-
-| Folder | Runs on | Allowed to |
-| --- | --- | --- |
-| `src/server` | Server | DataStore, DataService writes, `Net:Fire` |
-| `src/client` | Client | UI, Module3D, Twinkle, camera, `Net:FireServer` |
-| `src/shared` | Both | types, `const` config, FormatNumber, MathUtils |
-
-If a file needs `DataStoreService`, it is server. If it needs `UserInputService`, it is client. Shared code must compile in both.
-
-## Headers vs scripts
-
-- `.h` / `.hpp` in `src/` are inlined (`#include "config.h"`) and can hold `const` values and prototypes.
-- `#include <cluaupp/...>` is IntelliSense only — never inlined. `cluaupp build` copies those headers into the game `include/` folder. Cursor/clangd also reads `compile_flags.txt`.
-
-Keep config in `src/shared/config.h`:
-
-```cpp
-#pragma once
-const int STARTING_COINS = 0;
-const string REMOTE_COINS = "Coins";
-```
-
-## One module, one job
-
-`leaderstats.server.cpp` creates leaderstats. It does not also open the shop UI. Name files after the system: `inventory.server.cpp`, `shop.client.cpp`.
-
-`*.server.cpp` / `*.client.cpp` are **tags** (the same keys roblox-ts uses). Untagged `.cpp` is a ModuleScript. Set `"architecture": true` only if you want the old PascalCase folder split. See [Architecture](architecture.md) and [OOP structure](oop/index.md).
-
-## CluauppLibs vs extra Wally
-
-| Need | Where |
-| --- | --- |
-| Janitor, Promise, Fusion, Iris, Cmdr, TopbarPlus, Chrono, DataServiceV2, EzVisualz, StateMachine, Spring, Display, Module3D, FormatNumber, Net, MathUtils, Twinkle | `CluauppLibs` (copied on `cluaupp build` from GitHub-vendored `runtime/`) |
-| Some other community package | `wally.toml` → `Packages` |
-
-Do not install a second Janitor from Wally unless you have a reason — CluauppLibs already has howmanysmall/Janitor. DataServiceV2 still bundles its own janitor/quicknet/signal inside the DataService folder.
-
-How-tos: [Libraries](libraries/index.md). Service layout: [OOP](oop/index.md). Copy-paste: [Examples](examples/index.md).
-
-Next: [advanced Cluaupp](cpp-advanced.md).

package/docs/cpp-safety.md

@@ -1,62 +0,0 @@
----
-title: Safety
-sidebar_position: 12
----
-
-# Safety
-
-Safety in Cluaupp is not a sandbox flag. It is a set of habits the compiler and libraries make cheap.
-
-## 1. Never trust the client
-
-[Net](libraries/net.md) lets a client `FireServer`. The server must validate:
-
-```cpp
-void OnBuy(Player* player, int productId) {
-	if (productId < 1) {
-		return;
-	}
-	int price = PriceOf(productId);
-	Data* data = DataService::Server.WaitFor(player);
-	if (data == nullptr) {
-		return;
-	}
-	int coins = data->Get(DataService::Server.Paths.Currencies.Money);
-	if (coins < price) {
-		return;
-	}
-	data->Set(DataService::Server.Paths.Currencies.Money, coins - price);
-}
-```
-
-Do not store coins only on the client. Do not let the client pass the new coin total — pass the *intent* (`productId`). Full systems: [Shop](examples/shop.md), [Combat](examples/combat.md).
-
-## 2. Clean up with Janitor
-
-Every `Connect` that outlives a player, a GUI, or a tool needs a [Janitor](libraries/janitor.md). Leaving a step, destroying a character, or closing a menu should `Cleanup()` or `LinkToInstance`.
-
-```cpp
-auto* janitor = new Janitor();
-janitor->LinkToInstance(player);
-janitor->Add(players->PlayerAdded.Connect(OnPlayer));
-```
-
-Leaked connections duplicate effects: double coins, stacked cameras, lingering highlights.
-
-## 3. Check nil
-
-`FindFirstChild` returns `nullptr`. `WaitForChild` can hang. Prefer `FindFirstChild` plus an early return on the hot path.
-
-## 4. One writer for persisted data
-
-[DataService](libraries/dataservice.md) distinguishes `Get()` (merged, includes transient admin overlays) from `GetPersisted()` (what ProfileStore will save). Use `SetTransient` for test panels so you never persist cheat values. Only the server writes persisted paths. The save **shape** is your Template — the library does not ship `Currencies`.
-
-## 5. Buffers, not ad-hoc strings
-
-`Net` packs arguments into a `buffer`. That is smaller and typed. Do not `JSONEncode` a whole inventory on every heartbeat. Send deltas. Cap array lengths the client can send.
-
-## 6. Names are API
-
-Remote names (`Net::Event("Coins")`) are public protocol. Keep them `const`, short, and unique. Changing a name without a migration breaks old clients.
-
-Next: [organization](cpp-organization.md), [OOP](oop/index.md), [Examples](examples/index.md).

package/docs/cpp-types.md

@@ -1,68 +0,0 @@
----
-title: C++ types in Cluaupp
-sidebar_position: 10
----
-
-# Types
-
-Cluaupp is statically typed in the C++ you write and in the Luau it emits. A type is a contract: what a value is allowed to be, and what you are allowed to do with it.
-
-## Primitive map
-
-| C++ | Luau | Use for |
-| --- | --- | --- |
-| `int`, `float`, `double` | `number` | counts, damage, alpha |
-| `bool` | `boolean` | flags |
-| `string` / `const char*` | `string` | names, paths |
-| `void` | (no return) | procedures |
-| `auto` | inferred | when `new` or `GetService` makes the type obvious |
-| `Player*`, `Folder*`, … | `Player`, `Folder` | Instances |
-| `LuaArray<int>` / `vector<T>` | `{number}` | arrays (Template inventory, `GetPlayers`) |
-| `optional<T>` | `T?` | missing values (prefer `nullptr` on Instances) |
-| `Vector3`, `CFrame`, `UDim2` | same | datatypes |
-
-```cpp
-int coins = 10;
-bool loaded = false;
-auto* folder = new Folder(player);
-```
-
-```luau
-local coins: number = 10
-local loaded: boolean = false
-local folder: Folder = Instance.new("Folder")
-folder.Parent = player
-```
-
-## Pointers are Instances, not memory
-
-In Cluaupp, `Player*` does not mean “heap address”. It means “this is a Roblox Instance of class Player”. `->` becomes `.` for properties and `:` for engine/library methods.
-
-```cpp
-player->Name = "Kartz";
-player->FindFirstChild("leaderstats");
-```
-
-```luau
-player.Name = "Kartz"
-player:FindFirstChild("leaderstats")
-```
-
-There is no pointer arithmetic, no `delete`, no `std::unique_ptr`. Lifetime is Roblox’s: parented Instances live until `Destroy` or until a [Janitor](libraries/janitor.md) cleans them.
-
-## `nullptr`
-
-`nullptr` is `nil`. Always test before using a `FindFirstChild` result:
-
-```cpp
-auto* stats = player->FindFirstChild("leaderstats");
-if (stats == nullptr) {
-	return;
-}
-```
-
-## Why types matter
-
-Typos, wrong arguments, and `nil` indexing are the majority of live-game bugs. `--!strict` plus C++ types catch them in the editor. If a function takes `Player*`, do not pass a `string`. If a value is `const int`, do not assign to it later.
-
-Next: [const and immutability](cpp-const.md).

package/docs/examples/_category_.json

@@ -1,5 +0,0 @@
-{
-	"label": "Examples",
-	"position": 21,
-	"collapsed": false
-}

package/docs/examples/combat.md

@@ -1,31 +0,0 @@
----
-title: Combat (server validation)
-sidebar_position: 4
----
-
-# Combat
-
-Live source: [`examples/game/src/server/combat.server.clpp`](../../examples/game/src/server/combat.server.clpp). Language: [CL++](https://kartzrbx.github.io/CLPP/).
-
-This sample uses exclusive CL++:
-
-- `guard` / `match` instead of nested null checks
-- `signal<Player*, int> OnHit` and `OnHit~>Connect` / `OnHit::Fire`
-- `observable int combo`
-- `[[server]]` on `WatchWorkspace`
-- `spawn { task::wait(1); … }`
-
-The client never decides damage. Touched parts fire `OnHit`; the server prints combo and destroys the part.
-
-```clpp
-#include <clpp/roblox.clh>
-#include <clpp/libs/janitor.clh>
-
-struct CombatServer {
-	Janitor* janitor;
-	signal<Player*, int> OnHit;
-	void PlayerEntered(Player* player);
-	void BindPart(BasePart* part);
-	void WatchWorkspace();
-};
-```