kopular 1.1.4 → 1.1.5

package/GUIDE.md

@@ -43,6 +43,8 @@ both scripts). `ks check src/app.ks` type-checks without building, if you just w
 - `try { } catch (string e) { } finally { }` and `throw "message";` all exist — one `catch`
   per `try`, and its parameter type is your choice (it is *not* checked against what was
   actually thrown).
+- **Comments are `//` only** — there is no `/* ... */` block comment, and a `/*` is a parse
+  error (`KS2020`), not an ignored region.
 - **Reserved words**: naming a local or parameter one of these is a parse error, not
   shadowing — `raw`, `state`, `task`, `from`, `as`, `get`, `set`, `in`, `base` and `match`
   are the ones easy to pick by accident. Full list: `using extern raw template styles from
@@ -57,6 +59,9 @@ both scripts). `ks check src/app.ks` type-checks without building, if you just w
   `.Split(sep)`, `.Replace(from, to)`, `.CompareTo(other)` (sort comparator), `+` concatenates.
   Both `"double"` and `'single'` quotes work — use whichever the other isn't, e.g. inside
   a template attribute (`*if="Name != ''"`).
+- Arrays are created with a literal and nothing else: `number[] xs = [];`, `[1, 2, 3]`,
+  `[new Todo("a")]`. **There is no `new number[3]` form** — that's a parse error, not an
+  empty array.
 - Arrays: `xs.Length`, `.Map()/.Filter()/.ForEach()/.Find()/.FindIndex()/.Includes()/.IndexOf()`,
   `.Sort(cmp)/.Reverse()/.Push(x)` (all three **non-mutating**, return a new array),
   `.Slice(a, b)/.Concat(ys)/.Join(sep)/.Reduce(fn, initial)`.

package/LLM.md

@@ -171,7 +171,7 @@ extern class Router {
   // is in flight — default: `<div class="router-loading">Loading...</div>`.
   // Only declare this if you actually override it (a class extending
   // Router) — see "Lazy routes" below.
-  protected virtual VElement BuildLoadingPlaceholder();
+  virtual VElement BuildLoadingPlaceholder();
   void Navigate(string path);
   void Mount(Element parent);
   // One guard for the whole Router, not per-route — see "Router" below.
@@ -320,6 +320,7 @@ w.Bump();                // re-render + diff + patch
   component, applied once the handler returns:
   ```ks
   private void Save() {
+    Item newItem = new Item(this.Draft);      // whatever this handler just built
     this.Draft = "";                          // a plain field Render() also reads
     this.Items.Value = this.Items.Value.Push(newItem);  // triggers the ONE render, via Subscribe
   }
@@ -503,7 +504,7 @@ Real URLs via the History API (`pushState`/`popstate`), not hash routing.
 
 ```ks
 class NotFoundPage : Component {
-  public override VElement Render() { /* ... */ }
+  public override VElement Render() { return VElement.Create("h1"); }
 }
 class HomePage : Component {
   private Router Nav;

package/README.md

@@ -641,7 +641,7 @@ own `header.ks`/`nav.ks` use it exactly this way):
 ```ks
 VElement header = VElement.Create("header");
 header.RawHtml = SiteHeaderHtml; // a raw string ... from "./header.html"; constant
-header.OnClick = (Event e) => { /* one delegated listener over the whole subtree */ };
+header.OnClick = (Event e) => { };  // one delegated listener over the whole subtree
 ```
 
 **It's unescaped, real `innerHTML` — never assign it anything reachable from user input.**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kopular",
-  "version": "1.1.4",
+  "version": "1.1.5",
   "description": "Kopular: a small component framework for KopScript — components, reactive state, constructor-injected services, routing, real compiled templates, and HTTP, with no DI container",
   "type": "module",
   "license": "MIT",