@velarscript/cli 0.12.0 → 0.12.1

package/dist/version.d.ts

@@ -1,3 +1,3 @@
-export declare const VELAR_VERSION = "0.12.0";
+export declare const VELAR_VERSION = "0.12.1";
 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.12.0";
+export const VELAR_VERSION = "0.12.1";
 export { VELAR_STANDARD_API_VERSION } from "@velarscript/core";
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@velarscript/cli",
-  "version": "0.12.0",
+  "version": "0.12.1",
   "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.12.0",
-    "@velarscript/core": "0.12.0",
-    "@velarscript/desktop": "0.12.0",
-    "@velarscript/node": "0.12.0",
+    "@velarscript/compiler": "0.12.1",
+    "@velarscript/core": "0.12.1",
+    "@velarscript/desktop": "0.12.1",
+    "@velarscript/node": "0.12.1",
     "@velarscript/script-analysis": "0.10.5",
-    "@velarscript/web": "0.12.0",
-    "create-velar": "0.12.0",
+    "@velarscript/web": "0.12.1",
+    "create-velar": "0.12.1",
     "esbuild": "^0.28.1",
     "playwright": "^1.58.2"
   }

package/skill/ai-skill-node.md

@@ -41,7 +41,7 @@ server.
 
 `@name` keeps its one language-wide role: it qualifies a compiler-owned name
 in the current context. In a `server` block, the available names are `@get`,
-`@post`, `@put`, `@patch`, and `@delete`. They are not decorators,
+`@post`, `@put`, `@patch`, `@delete`, and `@notFound`. They are not decorators,
 functions, imports, annotations, first-class values, or user extension points.
 
 ## Routes and checked inputs
@@ -65,6 +65,7 @@ export server articles:
 
     @post(p"/articles", input: CreateArticle):
         return created({id: 1, title: input.title})
+
 ```
 
 The path is written once. A capture such as `{id:number}` declares `id`
@@ -82,6 +83,18 @@ request, including `queryAll` and cooperative `cancellation`. Ambiguous bodies,
 duplicate declarations, conflicting path shapes, and unsupported path types are
 compile errors.
 
+`@notFound()` is the one application fallback for a path that matches no
+route. It may omit its parameter or accept one explicitly typed `Request`.
+Returning Data keeps status 404; return an explicit response such as
+`json(value, status=410)` to choose another final status. A matched route's
+`HttpError` and framework 405 responses do not enter this fallback. Declare at
+most one on the final application; an app that owns `@notFound` cannot be moved
+under a non-root `prefix`, because a global fallback has no unambiguous prefix
+scope. Compose prefixed route tables first, then declare the fallback on the
+outer `server`. A catch-all route such as `staticFiles("/", ...)` is a matched
+route and therefore owns its own file fallback instead of entering
+`@notFound`.
+
 Use ordinary values for the cases that need more than inference:
 
 ```velar
@@ -131,7 +144,7 @@ closed. Do not build a controller or container layer around it.
 Compose route tables as values:
 
 ```velar fragment
-import {RouteDocumentation, docs, lifecycle, middleware, prefix, staticFiles, use} from "velar/serve"
+import {Request, RouteDocumentation, docs, lifecycle, middleware, prefix, staticFiles, use} from "velar/serve"
 
 const service = lifecycle(
     prefix("/api", articles),
@@ -154,7 +167,8 @@ const routeDocs: Map<string, RouteDocumentation> = Map([["GET /api/articles/{id:
 
 export server app:
     ...docs(hardened, title="Article API", version="1.0.0", routes=routeDocs)
-    ...staticFiles("/", root="public", fallback="index.html")
+    ...staticFiles("/assets", root="public")
+    @notFound(request: Request) => {error: "route_not_found", path: request.path}
 ```
 
 `prefix` changes a literal route prefix; `bodyLimit` narrows one route