Repository-cleanup / DX pass folding three tracker items into one coherent change, verified green end to end (`bin/x test` 49/0, `bin/x selfhost-test` 29/0, `bin/x test-tools` 29/0). #28 — curate & categorise examples/ - 42 flat entries regrouped into intent-revealing subdirs: games/, rendering/, ecs/, events/, networking/, lang/, library/ (was lib/). - chronorift dir-vs-file duplication resolved: the entry file and its import modules now live together under games/chronorift(.ludic). - Every path reference updated repo-wide (test runner, editor-tool drivers, docs/site, design docs). - New examples/README.md indexes the whole set with run commands. - Showcase examples without a self-asserting entry (hello, events, net_rt) now get a compile-only rot guard in `bin/x test`, so nothing here rots silently. #30 — text-diffable golden baseline - The 4 binary selfhost/golden/*.ppm blobs are replaced by a single selfhost/golden/renders.sha256 manifest (SHA-256 per render). Hashes are byte-identical to the old PPMs, so the baseline is unchanged — only its form. - game_case now compares framebuffer hashes; a regression shows as a changed hex line in review, not "binary files differ". - New `bin/x golden` regenerates the manifest deliberately (review with `git diff selfhost/golden/renders.sha256`). #27 — PPM & asset handling - Headless renders now write build/out.ppm, never the repo root; `x app`, `x clean`, messaging and .gitignore updated to match. Nothing is written to the working root any more. - Redundant local Kenney .zip archives removed (the art ships extracted; .gitignore already excludes *.zip). CC0 License.txt files retained. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
40 lines
2 KiB
Text
40 lines
2 KiB
Text
# net_sync.ludic — N2: @Sync replication codegen (NETWORKING-DESIGN §6.1, §13 N2).
|
|
#
|
|
# Replication is opt-in at the field level and per model use-site. All three
|
|
# granularities here:
|
|
# @Sync property Position — every field of Position is replicable
|
|
# Health { @Sync hp, max } — only hp is replicable; max never is
|
|
# @Sync Position in Player — Position participates → x, y replicate
|
|
# Position in Prop — not @Sync here → Prop's Position does NOT replicate
|
|
#
|
|
# The compiler generates per-model serialize/apply over exactly the replicable-
|
|
# and-participating fields, plus by-kind dispatchers: sync_size(e) / serialize(e,
|
|
# buf) / apply(e, buf, len). This snapshots a Player's synced fields, mutates all
|
|
# of them, then applies the snapshot: synced fields (x, y, hp) restore; the
|
|
# unsynced one (max) keeps its mutation. Prints 12 (bytes) / 3 4 50 999.
|
|
program NetSync {
|
|
@Sync property Position { x: int = 0, y: int = 0 } # all fields replicable
|
|
property Health { @Sync hp: int = 0, max: int = 0 } # only hp replicable
|
|
|
|
@Owned model Player { @Sync Position, @Sync Health }
|
|
model Prop { Position } # Position not @Sync here → no replication
|
|
|
|
entry {
|
|
spawn Player { Position { x: 3, y: 4 }, Health { hp: 50, max: 100 } }
|
|
for (Position, Health) in query [Position, Health, {Player}] {
|
|
let e = self()
|
|
let buf = bytes(64)
|
|
print(sync_size(e)) # 12 = Position(x,y)=8 + Health.hp=4
|
|
let n = serialize(e, buf) # snapshot the synced fields
|
|
Position.x = 99 # mutate everything
|
|
Position.y = 88
|
|
Health.hp = 7
|
|
Health.max = 999 # max is NOT synced
|
|
apply(e, buf, n) # restore from the snapshot
|
|
print(Position.x) # 3 — restored
|
|
print(Position.y) # 4 — restored
|
|
print(Health.hp) # 50 — restored
|
|
print(Health.max) # 999 — kept (unsynced)
|
|
}
|
|
}
|
|
}
|