@velarscript/cli 0.20.0 → 0.21.0

package/skill/ai-skill-web.md

@@ -23,6 +23,15 @@ modules, and the `web` manifest key. Without that extension these are not Core
 syntax. Web visual builders are named imports from `velar/look`; there is no
 `Look.` namespace.
 
+Every word in that list is a contextual keyword that stays available as an
+ordinary name — except five. `mount`, `tick`, `viewport`, `scheme`, and `motion`
+are **reserved bindings**: `mount` and `tick` are real runtime entry points, and
+`viewport`, `scheme`, and `motion` name the Look media subjects, so a local
+binding can never shadow a media condition. A Web module refuses all five as
+binding names with `VEL3007`. Three of them are ordinary words for a Web author,
+so name a scroll container `scroller`, a colour setting `theme`, and an
+animation preference `reducedMotion`.
+
 `@` remains the language-wide annotation introducer, and `@name` is a context
 annotation with a compiler-owned compile-time role. Components own `@mounted:`
 and `@cleanup:`; Look owns conditions such as `@hover` and `@before`. They are

package/skill/ai-skill.md

@@ -75,7 +75,8 @@ considering source fallback. Other templates select their own framework brief. E
 `velar.json`, a `package.json` whose scripts are the gates, a `src/` tree, a
 passing test, and an `AGENTS.md`.
 
-Writing the manifest yourself: `formatVersion` is required, `extensions` may be
+Writing the manifest yourself: `formatVersion` is required, `kind` may be
+`application` or `library` (and defaults to `application`), `extensions` may be
 omitted by a project that loads none, `entry` defaults to `src/main.vel`,
 `outDir` to `dist`, and `publicDir` to `public`.
 
@@ -84,6 +85,7 @@ A Core project (CLI or library) loads no extensions:
 ```json
 {
   "formatVersion": 2,
+  "kind": "library",
   "entry": "src/main.vel",
   "extensions": []
 }
@@ -242,8 +244,10 @@ def publicUser(source: SourceUser, requestId: string) -> PublicUser:
 `Type.from` is shallow and compile-time checked. It does not accept `unknown`;
 validate untrusted data with `Type.parse` first.
 
-`enum` declares finite string-backed states; a member may map an external
-wire spelling without losing its nominal identity:
+`enum` declares finite states backed by a wire value; a member may map an
+external spelling — a string, or a safe integer where a protocol pins a version
+— without losing its nominal identity. A member satisfies a contract for the
+scalar its own wire value is, and nothing else:
 
 ```velar
 enum Status:
@@ -255,8 +259,14 @@ enum ProviderEventKind:
     textDelta = "response.output_text.delta"
     completed = "response.completed"
 
+enum KernelProtocol:
+    v1 = 1
+    v2 = 2
+
 const status: Status = Status.active
+const protocol: number = KernelProtocol.v2
 print(ProviderEventKind.textDelta)
+print(str(protocol))
 ```
 
 Classes use typed body fields, one explicit constructor, and explicit `self`;