@velarscript/cli 0.19.1 → 0.20.0

package/dist/version.d.ts

@@ -1,3 +1,3 @@
-export declare const VELAR_VERSION = "0.19.1";
+export declare const VELAR_VERSION = "0.20.0";
 export { VELAR_STANDARD_API_VERSION } from "@velarscript/core";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,3 +1,3 @@
-export const VELAR_VERSION = "0.19.1";
+export const VELAR_VERSION = "0.20.0";
 export { VELAR_STANDARD_API_VERSION } from "@velarscript/core";
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@velarscript/cli",
-  "version": "0.19.1",
+  "version": "0.20.0",
   "description": "The VelarScript command-line compiler, dev server, test runner, and language server.",
   "license": "Apache-2.0",
   "type": "module",
@@ -30,13 +30,13 @@
     "velar": "./dist/cli.js"
   },
   "dependencies": {
-    "@velarscript/compiler": "0.19.1",
-    "@velarscript/core": "0.19.1",
-    "@velarscript/desktop": "0.19.1",
-    "@velarscript/node": "0.19.1",
-    "@velarscript/server": "0.19.1",
-    "@velarscript/web": "0.19.1",
-    "create-velar": "0.19.1",
+    "@velarscript/compiler": "0.20.0",
+    "@velarscript/core": "0.20.0",
+    "@velarscript/desktop": "0.20.0",
+    "@velarscript/node": "0.20.0",
+    "@velarscript/server": "0.20.0",
+    "@velarscript/web": "0.20.0",
+    "create-velar": "0.20.0",
     "esbuild": "^0.28.1",
     "playwright": "^1.58.2"
   }

package/skill/ai-skill-node.md

@@ -83,14 +83,14 @@ type CreateArticle:
 
 export server articles:
     /// Reports whether this service is ready.
-    @get(p"/health") => {ok: true}
+    @get health(p"/health") => {ok: true}
 
-    @get(p"/articles/{id:number}?{details:bool?}"):
+    @get readArticle(p"/articles/{id:number}?{details:bool?}"):
         if id < 1:
             throw HttpProblem({status: 404, code: "article.not_found", title: "Article not found"})
         return {id, details: details ?? false}
 
-    @post(p"/articles", input: CreateArticle):
+    @post createArticle(p"/articles", input: CreateArticle):
         return created({id: 1, title: input.title})
 
 ```
@@ -114,6 +114,12 @@ patterns require `as name` so the compiler never injects identifiers that are
 hidden inside another declaration. The old `path=` spelling is an error with a
 mechanical fix to the positional form and `as path`.
 
+For a public contract, put one stable source identifier between the role and
+the pattern: `@get readArticle(...)` or `@websocket worldRealtime(...)`.
+Operation identities must be unique after composition, survive `prefix`, and
+are emitted verbatim to OpenAPI. Leave the name out only for a local route whose
+method/path-derived OpenAPI identity is sufficient.
+
 On `POST`, `PUT`, or `PATCH`, one concrete Data parameter is the
 checked JSON body. A `Request` parameter explicitly requests the complete
 request, including `queryAll` and cooperative `cancellation`. Ambiguous bodies,
@@ -282,7 +288,9 @@ task finishes. `setCookie` and
 fields. Never start long-lived work by
 dropping a Promise; use an owned lifecycle, background task, Worker, or process.
 
-`docs` adds a bundled offline UI and OpenAPI 3.1 JSON. Compiler route types
+`docs` adds a bundled offline UI and OpenAPI 3.1 JSON. HTTP and WebSocket
+operations share its `paths` catalog; WebSocket entries use GET, response 101,
+and `x-velar-transport: websocket`. Compiler route types
 and response helpers supply parameter, body, response, content-type, and static
 success-status schemas. Applicable framework-generated 400, 401, 413, 415, and
 422 responses are included automatically; a preceding `///` comment supplies
@@ -317,7 +325,7 @@ session belongs in the route table:
 import {WebSocketConnection} from "velar/websocket"
 
 server realtime:
-    @websocket(p"/worlds/{worldId:string}/realtime", connection: WebSocketConnection):
+    @websocket worldRealtime(p"/worlds/{worldId:string}/realtime", connection: WebSocketConnection):
         async for message in connection:
             await connection.send(message)
 ```
@@ -331,7 +339,8 @@ contains these routes rejects its legacy single `path` option and does not offer
 accepted sessions through `WebSocketServer.next()`.
 
 Set
-`maxBodyBytes` to the supplied application value. `origins` contains exact
+`maxBodyBytes` to the supplied application value. `host` is non-empty text of
+at most 255 code units without NUL. `origins` contains exact
 canonical HTTP/HTTPS origins. The default rejects any upgrade carrying
 `Origin`; no-Origin non-browser clients remain allowed. Use `["*"]` only for an
 intentional unrestricted policy. A rejected browser origin receives 403 before

package/skill/ai-skill-server.md

@@ -13,7 +13,7 @@ browser application activates `@velarscript/web`:
 ```json
 {
   "dependencies": {
-    "@velarscript/server": "0.19.1"
+    "@velarscript/server": "0.20.0"
   }
 }
 ```