@zerolith/cli 0.1.0-alpha.5 → 0.1.0-alpha.6

package/README.md

@@ -1,6 +1,6 @@
 # @zerolith/cli
 
-The `zerolith` command line from npm: `new`, `dev`, which serves a project with its packages resolved from `node_modules` and forwards its API to a backend, `serve`, `build`, which bundles and minifies an application with Rolldown compiled into the binary, `preview`, `importmap`, and `doctor`. The binary is written in Rust; this package carries none itself and depends optionally on one package per platform, so npm installs only the binary that matches the machine.
+The `zerolith` command line from npm: `new`, `dev`, which serves a project with its packages resolved from `node_modules` and forwards its API to a backend, `serve`, `build`, which bundles and minifies an application with Rolldown compiled into the binary, `preview`, `skill`, which writes the zerolith skill for coding agents into a project, `importmap`, and `doctor`. The binary is written in Rust; this package carries none itself and depends optionally on one package per platform, so npm installs only the binary that matches the machine.
 
 Install it once and start a project. `new` asks a few questions, each with a default, writes the starter, and installs its dependencies, this package among them:
 
@@ -20,7 +20,7 @@ npm install --save-dev @zerolith/cli@alpha
 npx zerolith doctor .
 ```
 
-Prebuilt binaries exist for Linux (glibc), macOS, and Windows on x64 and arm64. On any other system, or on Alpine and other musl distributions, install the crate with `cargo install zerolith` and point `ZEROLITH_BINARY_PATH` at the binary; the shim runs that instead. Installing with `--omit=optional` leaves the binary out, and the shim says which platform package to install.
+Prebuilt binaries exist for Linux (glibc), macOS, and Windows on x64 and arm64. On any other system, or on Alpine and other musl distributions, install the crate with `cargo install zerolith --locked` and point `ZEROLITH_BINARY_PATH` at the binary; the shim runs that instead. Installing with `--omit=optional` leaves the binary out, and the shim says which platform package to install.
 
 The commands are documented in the [command line guide](https://molexxxx.github.io/zerolith/guide/command-line/).
 

package/assets.d.ts

@@ -0,0 +1,260 @@
+/**
+ * The types of the files `zerolith dev` and `zerolith build` turn into
+ * values when a module imports them, for a project's `env.d.ts` to
+ * reference with `/// <reference types="@zerolith/cli/assets" />`. An
+ * image, a font, media, or a document gives its URL, `?url` gives any
+ * file's URL, and `?raw` gives a file's text. A project on Vite takes the
+ * same types from `vite/client` instead, since both declare these modules.
+ */
+
+/** A file imported for its text, as in `import notes from "./notes.md?raw"`. */
+declare module "*?raw"
+{
+    const text: string;
+    export default text;
+}
+
+/** Any file imported for its URL, as in `import url from "./worker.js?url"`. */
+declare module "*?url"
+{
+    const url: string;
+    export default url;
+}
+
+/** A `.apng` file, imported for its URL. */
+declare module "*.apng"
+{
+    const url: string;
+    export default url;
+}
+
+/** A `.bmp` file, imported for its URL. */
+declare module "*.bmp"
+{
+    const url: string;
+    export default url;
+}
+
+/** A `.png` file, imported for its URL. */
+declare module "*.png"
+{
+    const url: string;
+    export default url;
+}
+
+/** A `.jpg` file, imported for its URL. */
+declare module "*.jpg"
+{
+    const url: string;
+    export default url;
+}
+
+/** A `.jpeg` file, imported for its URL. */
+declare module "*.jpeg"
+{
+    const url: string;
+    export default url;
+}
+
+/** A `.jfif` file, imported for its URL. */
+declare module "*.jfif"
+{
+    const url: string;
+    export default url;
+}
+
+/** A `.pjpeg` file, imported for its URL. */
+declare module "*.pjpeg"
+{
+    const url: string;
+    export default url;
+}
+
+/** A `.pjp` file, imported for its URL. */
+declare module "*.pjp"
+{
+    const url: string;
+    export default url;
+}
+
+/** A `.gif` file, imported for its URL. */
+declare module "*.gif"
+{
+    const url: string;
+    export default url;
+}
+
+/** A `.svg` file, imported for its URL. */
+declare module "*.svg"
+{
+    const url: string;
+    export default url;
+}
+
+/** A `.ico` file, imported for its URL. */
+declare module "*.ico"
+{
+    const url: string;
+    export default url;
+}
+
+/** A `.webp` file, imported for its URL. */
+declare module "*.webp"
+{
+    const url: string;
+    export default url;
+}
+
+/** A `.avif` file, imported for its URL. */
+declare module "*.avif"
+{
+    const url: string;
+    export default url;
+}
+
+/** A `.cur` file, imported for its URL. */
+declare module "*.cur"
+{
+    const url: string;
+    export default url;
+}
+
+/** A `.jxl` file, imported for its URL. */
+declare module "*.jxl"
+{
+    const url: string;
+    export default url;
+}
+
+/** A `.mp4` file, imported for its URL. */
+declare module "*.mp4"
+{
+    const url: string;
+    export default url;
+}
+
+/** A `.webm` file, imported for its URL. */
+declare module "*.webm"
+{
+    const url: string;
+    export default url;
+}
+
+/** A `.ogg` file, imported for its URL. */
+declare module "*.ogg"
+{
+    const url: string;
+    export default url;
+}
+
+/** A `.mp3` file, imported for its URL. */
+declare module "*.mp3"
+{
+    const url: string;
+    export default url;
+}
+
+/** A `.wav` file, imported for its URL. */
+declare module "*.wav"
+{
+    const url: string;
+    export default url;
+}
+
+/** A `.flac` file, imported for its URL. */
+declare module "*.flac"
+{
+    const url: string;
+    export default url;
+}
+
+/** A `.aac` file, imported for its URL. */
+declare module "*.aac"
+{
+    const url: string;
+    export default url;
+}
+
+/** A `.opus` file, imported for its URL. */
+declare module "*.opus"
+{
+    const url: string;
+    export default url;
+}
+
+/** A `.mov` file, imported for its URL. */
+declare module "*.mov"
+{
+    const url: string;
+    export default url;
+}
+
+/** A `.m4a` file, imported for its URL. */
+declare module "*.m4a"
+{
+    const url: string;
+    export default url;
+}
+
+/** A `.vtt` file, imported for its URL. */
+declare module "*.vtt"
+{
+    const url: string;
+    export default url;
+}
+
+/** A `.woff` file, imported for its URL. */
+declare module "*.woff"
+{
+    const url: string;
+    export default url;
+}
+
+/** A `.woff2` file, imported for its URL. */
+declare module "*.woff2"
+{
+    const url: string;
+    export default url;
+}
+
+/** A `.eot` file, imported for its URL. */
+declare module "*.eot"
+{
+    const url: string;
+    export default url;
+}
+
+/** A `.ttf` file, imported for its URL. */
+declare module "*.ttf"
+{
+    const url: string;
+    export default url;
+}
+
+/** A `.otf` file, imported for its URL. */
+declare module "*.otf"
+{
+    const url: string;
+    export default url;
+}
+
+/** A `.webmanifest` file, imported for its URL. */
+declare module "*.webmanifest"
+{
+    const url: string;
+    export default url;
+}
+
+/** A `.pdf` file, imported for its URL. */
+declare module "*.pdf"
+{
+    const url: string;
+    export default url;
+}
+
+/** A `.txt` file, imported for its URL. */
+declare module "*.txt"
+{
+    const url: string;
+    export default url;
+}

package/dist/index.d.ts

@@ -7,7 +7,7 @@
 /** The platform packages, keyed by `${platform}-${arch}` as Node reports them. */
 export declare const PLATFORMS: Readonly<Record<string, string>>;
 /** The route around a missing binary, appended to every error. */
-export declare const CARGO_HINT = "Alternatively install the crate with `cargo install zerolith` and point ZEROLITH_BINARY_PATH at the binary.";
+export declare const CARGO_HINT = "Alternatively install the crate with `cargo install zerolith --locked` and point ZEROLITH_BINARY_PATH at the binary.";
 /** What locating needs from the host. */
 export interface Host {
     readonly platform: string;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,kFAAkF;AAClF,eAAO,MAAM,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOtD,CAAC;AAEF,kEAAkE;AAClE,eAAO,MAAM,UAAU,gHAC0F,CAAC;AAElH,yCAAyC;AACzC,MAAM,WAAW,IAAI;IAEjB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,6GAA6G;IAC7G,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,0FAA0F;IAC1F,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,kDAAkD;IAClD,QAAQ,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;CACnD;AAED,4CAA4C;AAC5C,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGnD;AAED,6EAA6E;AAC7E,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGlF;AAED,oFAAoF;AACpF,wBAAgB,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAsBzC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,kFAAkF;AAClF,eAAO,MAAM,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOtD,CAAC;AAEF,kEAAkE;AAClE,eAAO,MAAM,UAAU,yHACmG,CAAC;AAE3H,yCAAyC;AACzC,MAAM,WAAW,IAAI;IAEjB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,6GAA6G;IAC7G,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,0FAA0F;IAC1F,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,kDAAkD;IAClD,QAAQ,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;CACnD;AAED,4CAA4C;AAC5C,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGnD;AAED,6EAA6E;AAC7E,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGlF;AAED,oFAAoF;AACpF,wBAAgB,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAsBzC"}

package/dist/index.js

@@ -14,7 +14,7 @@ export const PLATFORMS = {
     "win32-x64": "@zerolith/cli-win32-x64",
 };
 /** The route around a missing binary, appended to every error. */
-export const CARGO_HINT = "Alternatively install the crate with `cargo install zerolith` and point ZEROLITH_BINARY_PATH at the binary.";
+export const CARGO_HINT = "Alternatively install the crate with `cargo install zerolith --locked` and point ZEROLITH_BINARY_PATH at the binary.";
 /** The binary's file name on a platform. */
 export function binaryName(platform) {
     return platform === "win32" ? "zerolith.exe" : "zerolith";
@@ -37,7 +37,7 @@ export function locate(host) {
         return host.resolve(`${name}/${binaryName(host.platform)}`);
     }
     catch {
-        throw new Error(`${name}, the package that carries the zerolith binary for this platform, is not installed. Install @zerolith/cli without --omit=optional (its optional dependencies hold the binaries), or install ${name} directly. ${CARGO_HINT}`);
+        throw new Error(`${name}, the package that carries the zerolith binary for this platform, is not installed. Install @zerolith/cli without --omit=optional (its optional dependencies hold the binaries), or install ${name} directly. When npx ran this from a copy it cached before ${name} reached the registry, that copy lacks it: delete the _npx folder in npm's cache, which \`npm config get cache\` prints, and run the command again. ${CARGO_HINT}`);
     }
 }
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,kFAAkF;AAClF,MAAM,CAAC,MAAM,SAAS,GAAqC;IACvD,cAAc,EAAE,4BAA4B;IAC5C,YAAY,EAAE,0BAA0B;IACxC,aAAa,EAAE,2BAA2B;IAC1C,WAAW,EAAE,yBAAyB;IACtC,aAAa,EAAE,2BAA2B;IAC1C,WAAW,EAAE,yBAAyB;CACzC,CAAC;AAEF,kEAAkE;AAClE,MAAM,CAAC,MAAM,UAAU,GACnB,6GAA6G,CAAC;AAelH,4CAA4C;AAC5C,MAAM,UAAU,UAAU,CAAC,QAAgB;IAEvC,OAAO,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,UAAU,CAAC;AAC9D,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,IAAY;IAE1D,OAAO,SAAS,CAAC,GAAG,QAAQ,IAAI,IAAI,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,MAAM,CAAC,IAAU;IAE7B,IAAI,IAAI,CAAC,QAAQ,EACjB,CAAC;QACG,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IACD,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACvD,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,EACnC,CAAC;QACG,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACzE,MAAM,IAAI,KAAK,CAAC,uCAAuC,GAAG,KAAK,UAAU,EAAE,CAAC,CAAC;IACjF,CAAC;IACD,IACA,CAAC;QACG,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAChE,CAAC;IACD,MACA,CAAC;QACG,MAAM,IAAI,KAAK,CACX,GAAG,IAAI,+LAA+L,IAAI,cAAc,UAAU,EAAE,CACvO,CAAC;IACN,CAAC;AACL,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,kFAAkF;AAClF,MAAM,CAAC,MAAM,SAAS,GAAqC;IACvD,cAAc,EAAE,4BAA4B;IAC5C,YAAY,EAAE,0BAA0B;IACxC,aAAa,EAAE,2BAA2B;IAC1C,WAAW,EAAE,yBAAyB;IACtC,aAAa,EAAE,2BAA2B;IAC1C,WAAW,EAAE,yBAAyB;CACzC,CAAC;AAEF,kEAAkE;AAClE,MAAM,CAAC,MAAM,UAAU,GACnB,sHAAsH,CAAC;AAe3H,4CAA4C;AAC5C,MAAM,UAAU,UAAU,CAAC,QAAgB;IAEvC,OAAO,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,UAAU,CAAC;AAC9D,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,IAAY;IAE1D,OAAO,SAAS,CAAC,GAAG,QAAQ,IAAI,IAAI,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,MAAM,CAAC,IAAU;IAE7B,IAAI,IAAI,CAAC,QAAQ,EACjB,CAAC;QACG,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IACD,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACvD,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,EACnC,CAAC;QACG,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACzE,MAAM,IAAI,KAAK,CAAC,uCAAuC,GAAG,KAAK,UAAU,EAAE,CAAC,CAAC;IACjF,CAAC;IACD,IACA,CAAC;QACG,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAChE,CAAC;IACD,MACA,CAAC;QACG,MAAM,IAAI,KAAK,CACX,GAAG,IAAI,+LAA+L,IAAI,6DAA6D,IAAI,uJAAuJ,UAAU,EAAE,CACjb,CAAC;IACN,CAAC;AACL,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@zerolith/cli",
-    "version": "0.1.0-alpha.5",
+    "version": "0.1.0-alpha.6",
     "description": "The zerolith command line from npm: a production build that bundles and minifies, a dev server that serves TypeScript and JSX without a build step, import maps with integrity hashes, project checks, and the scaffold, as a prebuilt native binary for the platform npm installs on",
     "license": "Apache-2.0",
     "author": "molexxxx",
@@ -28,12 +28,16 @@
         "zerolith": "dist/bin.js"
     },
     "exports": {
+        "./assets": {
+            "types": "./assets.d.ts"
+        },
         "./package.json": "./package.json",
         "./zerolith.schema.json": "./zerolith.schema.json"
     },
     "files": [
         "dist",
         "src",
+        "assets.d.ts",
         "zerolith.schema.json",
         "LICENSE",
         "README.md"
@@ -42,11 +46,11 @@
         "build": "tsc -p tsconfig.build.json"
     },
     "optionalDependencies": {
-        "@zerolith/cli-darwin-arm64": "0.1.0-alpha.5",
-        "@zerolith/cli-darwin-x64": "0.1.0-alpha.5",
-        "@zerolith/cli-linux-arm64": "0.1.0-alpha.5",
-        "@zerolith/cli-linux-x64": "0.1.0-alpha.5",
-        "@zerolith/cli-win32-arm64": "0.1.0-alpha.5",
-        "@zerolith/cli-win32-x64": "0.1.0-alpha.5"
+        "@zerolith/cli-darwin-arm64": "0.1.0-alpha.6",
+        "@zerolith/cli-darwin-x64": "0.1.0-alpha.6",
+        "@zerolith/cli-linux-arm64": "0.1.0-alpha.6",
+        "@zerolith/cli-linux-x64": "0.1.0-alpha.6",
+        "@zerolith/cli-win32-arm64": "0.1.0-alpha.6",
+        "@zerolith/cli-win32-x64": "0.1.0-alpha.6"
     }
 }

package/src/index.ts

@@ -17,7 +17,7 @@ export const PLATFORMS: Readonly<Record<string, string>> = {
 
 /** The route around a missing binary, appended to every error. */
 export const CARGO_HINT =
-    "Alternatively install the crate with `cargo install zerolith` and point ZEROLITH_BINARY_PATH at the binary.";
+    "Alternatively install the crate with `cargo install zerolith --locked` and point ZEROLITH_BINARY_PATH at the binary.";
 
 /** What locating needs from the host. */
 export interface Host
@@ -64,7 +64,7 @@ export function locate(host: Host): string
     catch
     {
         throw new Error(
-            `${name}, the package that carries the zerolith binary for this platform, is not installed. Install @zerolith/cli without --omit=optional (its optional dependencies hold the binaries), or install ${name} directly. ${CARGO_HINT}`,
+            `${name}, the package that carries the zerolith binary for this platform, is not installed. Install @zerolith/cli without --omit=optional (its optional dependencies hold the binaries), or install ${name} directly. When npx ran this from a copy it cached before ${name} reached the registry, that copy lacks it: delete the _npx folder in npm's cache, which \`npm config get cache\` prints, and run the command again. ${CARGO_HINT}`,
         );
     }
 }

package/zerolith.schema.json

@@ -15,6 +15,14 @@
             "description": "The public path the application is served under, such as /app/, for dev, build, and preview alike. ./ makes every URL the build writes relative to the page.",
             "examples": ["/", "/app/", "./"]
         },
+        "allowedHosts": {
+            "type": "array",
+            "description": "Host names dev, serve, and preview answer besides localhost and IP addresses, such as a name in the hosts file or a tunnel's. A request for any other host gets 403, so another site cannot read the project by pointing its own name at the loopback address (DNS rebinding). An entry starting with a dot allows every name under it.",
+            "items": {
+                "type": "string"
+            },
+            "examples": [["myapp.test"], [".example.dev"]]
+        },
         "proxy": {
             "type": "object",
             "description": "Paths dev, serve, and preview forward to a backend, by the path prefix they start with, such as \"/api\": \"http://127.0.0.1:3000\".",