gofront 1.7.0 → 1.8.0

package/README.md

@@ -228,6 +228,7 @@ Key syntax features:
 - `@Component(args)` — call another templ component and mount it as a child
 - `if cond { } else if cond { } else { }` — conditional rendering (arbitrary depth)
 - `for _, v := range slice { }` — loop rendering inside template bodies
+- Go expressions in template bodies are type-checked like the rest of the package
 - `switch expr { case v: ... default: ... }` — switch rendering inside template bodies
 - `@templ.Raw(htmlStr)` — inject raw/trusted HTML (uses `insertAdjacentHTML`)
 - `ref="name"` — capture the element at mount time into an optional `refs map[string]any`
@@ -329,11 +330,17 @@ example/hybrid/
 
 ### Build and run
 
+The examples are not committed pre-built. Build them once, then serve an example's
+directory and open it in a browser:
+
 ```sh
 npm run build             # compile all example applications
-# open the respective index.html in a browser
+npx serve example/simple  # then open the printed address
 ```
 
+`example/preact/vendor.js` is the exception: it is committed, and
+`node src/index.js prep example/preact` regenerates it.
+
 ---
 
 ## The Hybrid Architecture: JS + WasmGC
@@ -398,7 +405,7 @@ The compiler analyzes both sides of the boundary and synthesizes a facade into `
 - **Slices & Arrays:** Slices and arrays copy element-wise in both directions; TypedArrays (`Float32Array`, `Int32Array`, etc.) are natively accepted.
 - **Closures & Interfaces:** Function values, callbacks, and named non-empty interfaces cross the boundary transparently.
 - **Shared Linear-Memory Buffers:** `gofront/shared` (`shared.NewFloat32`, etc.) exposes zero-copy TypedArray views over linear memory for bulk per-frame data.
-- **WASM SIMD (`gofront/simd`):** Experimental 4-wide float vector type (`simd.F32x4`) compiling directly to native `v128` instructions with zero GC overhead, including `simd.LoadF32x4`/`StoreF32x4` for direct linear-memory access.
+- **WASM SIMD (`gofront/simd`, experimental):** 4-wide float vector type (`simd.F32x4`) compiling directly to native `v128` instructions with zero GC overhead, including `simd.LoadF32x4`/`StoreF32x4` for direct linear-memory access (about 1.6× faster than a scalar loop on a particle-integration benchmark).
 - **WASM Loader:** The generated JS bundle automatically fetches `app.wasm` relative to `app.js` (`import.meta.url`, customizable via `globalThis.__GOFRONT_WASM_URL` or `globalThis.__GOFRONT_WASM_BYTES`).
 - **WAT Inspection:** Passing `--emit-wat` writes human-readable `app.wat` alongside the binary module.
 - **Binaryen Optimization:** Passing `--release` or `--wasm-opt` optimizes `app.wasm` via Binaryen (`-O3` + GUFA), achieving ~23% smaller binaries and generating `app.wasm.map` source maps.
@@ -447,26 +454,19 @@ For detailed command flags, project configuration (`gofront.json`), multi-file p
 * [Go to JS Mapping](docs/compilation-mapping.md) — what each construct compiles to
 * [Go Compatibility Differences](docs/go-compatibility.md) — where GoFront deliberately differs from Go
 * [Compiler Architecture & Internals](docs/architecture.md) — pipeline stages and source layout
-
----
-
-## Roadmap
-
-See [`docs/roadmap.md`](docs/roadmap.md) for the full roadmap and release history.
-Design documents for planned features are organised by release under `docs/v*/`
-(e.g. [`docs/v0.0.8/`](docs/v0.0.8/), [`docs/v1.2.0/`](docs/v1.2.0/), [`docs/v1.3.0/`](docs/v1.3.0/), [`docs/v1.6.0/`](docs/v1.6.0/)).
+* [Changelog](CHANGELOG.md) — release history and upgrade notes
 
 ---
 
 ## Tests
 
 ```sh
-npm test                  # unit, zero-alloc perf, and example tests (~1,920+ tests, no browser required)
+npm test                  # unit, zero-alloc perf, and example tests (~2,900 tests, no browser required)
 npm run test:e2e          # E2E browser tests (Playwright, headless Chromium)
-npm run bench             # Möller–Trumbore raycast benchmark comparing pure JS vs hybrid WASM
+npm run bench             # Raycast, JSON, and SIMD particle benchmarks (pure JS vs hybrid WASM)
 ```
 
-**Unit tests** (~1,920+) cover language features, type errors, edge cases, DOM (jsdom),
+**Unit tests** (~2,900) cover language features, type errors, edge cases, DOM (jsdom),
 external `.d.ts`, npm resolver, TypeScript tuple return signatures, multi-file compilation,
 embedded structs, string formatting, compile-time `encoding/json` serialization with struct tags,
 map iteration order, integer overflow semantics, unused variable detection,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "gofront",
-	"version": "1.7.0",
+	"version": "1.8.0",
 	"author": "Luuk van Venrooij",
 	"license": "MIT",
 	"repository": {
@@ -28,19 +28,21 @@
 	},
 	"type": "module",
 	"files": [
-		"src/"
+		"src/",
+		"stdlib/"
 	],
 	"bin": {
 		"gofront": "src/index.js"
 	},
 	"scripts": {
-		"build": "node src/index.js example/simple/src -o example/simple/app.js && node src/index.js example/preact/src -o example/preact/app.js && node src/index.js example/gom/src -o example/gom/app.js && node src/index.js example/templ/src -o example/templ/app.js && node src/index.js example/webgl/src -o example/webgl/app.js && node src/index.js example/hybrid/src -o example/hybrid/app.js",
-		"test": "node test/unit/run.js && node test/e2e/perf/zero-alloc.js && node src/index.js test --dom example/...",
+		"build": "node scripts/build-examples.js",
+		"test": "node test/unit/run.js && node test/perf/zero-alloc.js && node test/perf/bce-mathx.js && node src/index.js test --dom example/...",
 		"test:e2e": "playwright test",
 		"test:coverage": "c8 --include='src/**' --reporter=text --reporter=lcov node test/unit/run.js",
-		"bench": "node --expose-gc test/e2e/perf/raycast-bench.js",
+		"bench": "node --expose-gc test/perf/raycast-bench.js && node test/perf/json-bench.js && node --expose-gc test/perf/particle-bench.js",
+		"check:layers": "node scripts/check-layers.js",
 		"format": "biome format --write .",
-		"check": "biome check . && sentrux check && sentrux gate && node src/index.js check example/...",
+		"check": "biome check . && node scripts/check-layers.js && sentrux check && sentrux gate && node src/index.js check example/...",
 		"prepare": "lefthook install"
 	},
 	"devDependencies": {
@@ -55,36 +57,5 @@
 	},
 	"optionalDependencies": {
 		"binaryen": "^132.0.0"
-	},
-	"gofront": {
-		"vendor": {
-			"dest": "example/preact/vendor.js",
-			"packages": [
-				"preact",
-				"preact/hooks"
-			],
-			"globals": {
-				"preact": "preact",
-				"preact/hooks": [
-					"preact/hooks",
-					"preact_hooks"
-				]
-			},
-			"namedExports": {
-				"preact": [
-					"h",
-					"render",
-					"Component"
-				],
-				"preact/hooks": [
-					"useState",
-					"useEffect",
-					"useRef",
-					"useMemo",
-					"useCallback",
-					"useReducer"
-				]
-			}
-		}
 	}
 }