minor improvements in http

`http`: breaking changes and minor improvements.

Moved server-only HTTP header constants to server-only modules.

`notFound` now uses named parameters.

`LiveBroad..response` now uses named parameters.

`HttpFile..response` now uses named parameters.

Various response-generating functions and methods now support
overriding the response class.

`fileResponse` now supports "modified since" HTTP headers, returning
a 304 response when a file hasn't been modified since the timestamp
provided in the request, if any. However, file responses don't have
the `last-modified` header by default. It can be set optionally.

Fixed a bug in `fileResponse` where files with 304 responses
were not registered with the provided live client, if any.

Author: mitranim

.eslint.config.mjs

@@ -77,7 +77,6 @@ export default [
       [`no-import-assign`]: `error`,
       [`no-inner-declarations`]: `error`,
       [`no-invalid-regexp`]: `error`,
-      [`no-invalid-this`]: [`error`, {capIsConstructor: false}],
       [`no-irregular-whitespace`]: `error`,
       [`no-misleading-character-class`]: `error`,
       [`no-mixed-spaces-and-tabs`]: `error`,
@@ -110,7 +109,17 @@ export default [
       [`use-isnan`]: `error`,
       [`valid-typeof`]: `error`,
 
-      // [`quotes`]: [`error`, `backtick`], // Doesn't work properly.
+      // Doesn't work properly.
+      // [`quotes`]: [`error`, `backtick`],
+
+      /*
+      There used to be a time and place for this rule. However, it can also lead
+      to pitfalls. There are cases when separating a context object from a method
+      is correct and useful, and enforcing "no this" can lead to mistakes, such
+      as accidentally closuring an object which is meant to be referenced weakly
+      via `WeakRef`.
+      */
+      // [`no-invalid-this`]: [`error`, {capIsConstructor: false}],
     },
   },
   {

doc/prax_readme.md

@@ -15,7 +15,7 @@ Short overview of features:
 * Convenient syntax. Nice-to-use in plain JS.
   * No templates.
   * No string parsing.
-  * No need for JSX.
+  * No need for JSX. (Compatible with it.)
   * No need for a build system.
 * Built-in reactivity with {{featLink obs}}.
 * Can use native [custom elements](https://developer.mozilla.org/en-US/docs/Web/Web_Components/Using_custom_elements) for state.

docs/cli_readme.md

@@ -23,7 +23,7 @@
 CLI args:
 
 ```js
-import * as cl from 'https://cdn.jsdelivr.net/npm/@mitranim/js@0.1.82/cli.mjs'
+import * as cl from 'https://cdn.jsdelivr.net/npm/@mitranim/js@0.1.83/cli.mjs'
 
 const cli = cl.Flag.os()
 
@@ -34,15 +34,15 @@ console.log(...cli.args)
 Console clearing:
 
 ```js
-import * as cl from 'https://cdn.jsdelivr.net/npm/@mitranim/js@0.1.82/cli.mjs'
+import * as cl from 'https://cdn.jsdelivr.net/npm/@mitranim/js@0.1.83/cli.mjs'
 
 cl.emptty()
 ```
 
 Clearing the console only once, before running your code:
 
 ```js
-import 'https://cdn.jsdelivr.net/npm/@mitranim/js@0.1.82/cli_emptty.mjs'
+import 'https://cdn.jsdelivr.net/npm/@mitranim/js@0.1.83/cli_emptty.mjs'
 ```
 
 ## API

docs/coll_readme.md

@@ -26,7 +26,7 @@ Port and rework of https://github.com/mitranim/jol.
 ## Usage
 
 ```js
-import * as c from 'https://cdn.jsdelivr.net/npm/@mitranim/js@0.1.82/coll.mjs'
+import * as c from 'https://cdn.jsdelivr.net/npm/@mitranim/js@0.1.83/coll.mjs'
 ```
 
 ## API
@@ -101,8 +101,8 @@ Links: [source](../coll.mjs#L100); [test/example](../test/coll_test.mjs#L218).
 Variant of [#`Bmap`](#class-bmap) with support for key and value checks. Subclasses must override methods `.reqKey` and `.reqVal`. These methods are automatically called by `.set`. Method `.reqKey` must validate and return the given key, and method `.reqVal` must validate and return the given value. Use type assertions provided by [`lang`](lang_readme.md).
 
 ```js
-import * as l from 'https://cdn.jsdelivr.net/npm/@mitranim/js@0.1.82/lang.mjs'
-import * as c from 'https://cdn.jsdelivr.net/npm/@mitranim/js@0.1.82/coll.mjs'
+import * as l from 'https://cdn.jsdelivr.net/npm/@mitranim/js@0.1.83/lang.mjs'
+import * as c from 'https://cdn.jsdelivr.net/npm/@mitranim/js@0.1.83/coll.mjs'
 
 class StrNatMap extends c.TypedMap {
   reqKey(key) {return l.reqStr(key)}
@@ -242,7 +242,7 @@ Differences and advantages over `Array`:
 The overhead of the wrapper is insignificant.
 
 ```js
-import * as c from 'https://cdn.jsdelivr.net/npm/@mitranim/js@0.1.82/coll.mjs'
+import * as c from 'https://cdn.jsdelivr.net/npm/@mitranim/js@0.1.83/coll.mjs'
 
 console.log(new c.Vec())
 // Vec{Symbol(val): []}

docs/dom_readme.md

@@ -11,7 +11,7 @@
 ## Usage
 
 ```js
-import * as d from 'https://cdn.jsdelivr.net/npm/@mitranim/js@0.1.82/dom.mjs'
+import * as d from 'https://cdn.jsdelivr.net/npm/@mitranim/js@0.1.83/dom.mjs'
 ```
 
 ## API

docs/dom_reg_readme.md

@@ -27,7 +27,7 @@
 Example mockup for a pushstate link.
 
 ```js
-import * as dr from 'https://cdn.jsdelivr.net/npm/@mitranim/js@0.1.82/dom_reg.mjs'
+import * as dr from 'https://cdn.jsdelivr.net/npm/@mitranim/js@0.1.83/dom_reg.mjs'
 
 // Immediately ready for use. Tag is automatically set to `a-btn`.
 // The mixin `MixReg` enables automatic registration on instantiation.
@@ -66,7 +66,7 @@ Apps which use server-side rendering and client-side upgrading of custom element
 Instead, use `dr.reg`, which is also used internally by `MixReg`. This is simply a shortcut for using the [#default registry](#class-reg) provided by this module.
 
 ```js
-import * as dr from 'https://cdn.jsdelivr.net/npm/@mitranim/js@0.1.82/dom_reg.mjs'
+import * as dr from 'https://cdn.jsdelivr.net/npm/@mitranim/js@0.1.83/dom_reg.mjs'
 
 class Btn extends HTMLButtonElement {
   /*
@@ -106,7 +106,7 @@ For browser-only code, prefer the mixin `MixReg` from the same module which is e
 Simple usage:
 
 ```js
-import * as dr from 'https://cdn.jsdelivr.net/npm/@mitranim/js@0.1.82/dom_reg.mjs'
+import * as dr from 'https://cdn.jsdelivr.net/npm/@mitranim/js@0.1.83/dom_reg.mjs'
 
 class Btn extends HTMLButtonElement {
   /*
@@ -126,7 +126,7 @@ document.body.append(new Btn())
 You can unset the default definer to defer registration:
 
 ```js
-import * as dr from 'https://cdn.jsdelivr.net/npm/@mitranim/js@0.1.82/dom_reg.mjs'
+import * as dr from 'https://cdn.jsdelivr.net/npm/@mitranim/js@0.1.83/dom_reg.mjs'
 
 dr.Reg.main.setDefiner()
 

docs/dom_shim_readme.md

@@ -11,7 +11,7 @@
 ## Usage
 
 ```js
-import * as ds from 'https://cdn.jsdelivr.net/npm/@mitranim/js@0.1.82/dom_shim.mjs'
+import * as ds from 'https://cdn.jsdelivr.net/npm/@mitranim/js@0.1.83/dom_shim.mjs'
 ```
 
 ## API

docs/http_bun_readme.md

@@ -80,4 +80,4 @@ The following APIs are exported but undocumented. Check [http_bun.mjs](../http_b
   * [`function serve`](../http_bun.mjs#L9)
   * [`function srvUrl`](../http_bun.mjs#L18)
   * [`class HttpFile`](../http_bun.mjs#L20)
-  * [`class HttpDir`](../http_bun.mjs#L46)
+  * [`class HttpDir`](../http_bun.mjs#L48)

docs/http_deno_readme.md

@@ -80,4 +80,4 @@ The following APIs are exported but undocumented. Check [http_deno.mjs](../http_
   * [`function serve`](../http_deno.mjs#L9)
   * [`function srvUrl`](../http_deno.mjs#L14)
   * [`class HttpFile`](../http_deno.mjs#L21)
-  * [`class HttpDir`](../http_deno.mjs#L44)
+  * [`class HttpDir`](../http_deno.mjs#L46)

docs/http_live_readme.md

@@ -23,5 +23,5 @@ The following APIs are exported but undocumented. Check [http_live.mjs](../http_
   * [`const LIVE_PATH_SEND`](../http_live.mjs#L17)
   * [`function liveScript`](../http_live.mjs#L21)
   * [`class LiveBroad`](../http_live.mjs#L25)
-  * [`class LiveClient`](../http_live.mjs#L59)
-  * [`function isResHtmlText`](../http_live.mjs#L119)
+  * [`class LiveClient`](../http_live.mjs#L66)
+  * [`function isResHtmlText`](../http_live.mjs#L125)