@abide/abide 0.110.1 → 0.110.3

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @abide/abide
 
+## 0.110.3
+
+### Patch Changes
+
+- 804b901: the root below a mount is the bare mount, url('/') writing /docs and /docs/ redirected to it ([`9c5d3c3`](https://github.com/briancray/abide/commit/9c5d3c360c27f2d9918fb663d7aff83b22078707))
+
+## 0.110.2
+
+### Patch Changes
+
+- 14ee265: an SVG element spelled in camelCase hydrates, the compiler asking for the tag the parser writes inside an <svg> ([`f10c81b`](https://github.com/briancray/abide/commit/f10c81bff3ce0e43762a71e24634a218312c0d93))
+
 ## 0.110.1
 
 ### Patch Changes

package/docs/RULEBOOK.md

@@ -1236,8 +1236,9 @@ be refused at construction, naming its `Args` member, and the build MUST refuse
 19.16 `route.url` MUST hold the address a page is served at, the path `APP_URL` names included, on
 the server as in the browser.
 
-19.17 A request for the path `APP_URL` names, without its trailing `/`, MUST be redirected 308 to
-that path with one, by path alone.
+19.17 The root of an app served below the path `APP_URL` names MUST be that path without a trailing
+`/`, as `url('/')` writes it, and a request for the path with one MUST be redirected 308 to it, by
+path alone.
 
 19.18 A `Schema` derived per 19.9 MUST refuse a member its type does not declare, wherever the type
 carries no index signature.

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@abide/abide",
-    "version": "0.110.1",
+    "version": "0.110.3",
     "type": "module",
     "description": "Isomorphic type-safe framework for reactive async interfaces for humans and machines",
     "license": "MIT",

package/src/compiler/Cursor.ts

@@ -81,7 +81,8 @@ export type PlacedNode = {
      */
     parent: string
     /**
-     * An element's FOLDED tag, for the kind check `elementHere` makes. '' for the other two kinds.
+     * An element's tag as the parser writes it, for the kind check `elementHere` makes: folded,
+     * then given back SVG's camelCase (`SVG_CASE`). '' for the other two kinds.
      */
     tag: string
     /**
@@ -115,6 +116,51 @@ export type PlacedNode = {
     children: PlacedNode[]
 }
 
+// THE NAMES THE PARSER GIVES BACK SVG'S CASE, folded to the case it writes — the HTML standard's
+// adjustment table for foreign content. None is an HTML element, so one stands under an `<svg>`
+// even where the compiler cannot see it: a component's root does not know where it is invoked.
+const SVG_CASE = new Map<string, string>()
+for (const name of [
+    'altGlyph',
+    'altGlyphDef',
+    'altGlyphItem',
+    'animateColor',
+    'animateMotion',
+    'animateTransform',
+    'clipPath',
+    'feBlend',
+    'feColorMatrix',
+    'feComponentTransfer',
+    'feComposite',
+    'feConvolveMatrix',
+    'feDiffuseLighting',
+    'feDisplacementMap',
+    'feDistantLight',
+    'feDropShadow',
+    'feFlood',
+    'feFuncA',
+    'feFuncB',
+    'feFuncG',
+    'feFuncR',
+    'feGaussianBlur',
+    'feImage',
+    'feMerge',
+    'feMergeNode',
+    'feMorphology',
+    'feOffset',
+    'fePointLight',
+    'feSpecularLighting',
+    'feSpotLight',
+    'feTile',
+    'feTurbulence',
+    'foreignObject',
+    'glyphRef',
+    'linearGradient',
+    'radialGradient',
+    'textPath',
+])
+    SVG_CASE.set(name.toLowerCase(), name)
+
 /** A run of siblings being walked: the region's own root, or the inside of one element. */
 type Frame = {
     /**
@@ -202,7 +248,13 @@ export class Cursor {
      * emitted between its open and close tags and nowhere else. A void element is left at once.
      */
     element(node: ElementNode): PlacedNode {
-        const at = this.record('element', node, node.lowerTag, false, [])
+        const at = this.record(
+            'element',
+            node,
+            SVG_CASE.get(node.lowerTag) ?? node.lowerTag,
+            false,
+            [],
+        )
         this.frames.push({
             parent: at.name,
             within: at,

package/src/server/createApp.ts

@@ -507,14 +507,14 @@ function stamp(answered: Response): Response {
 
 /**
  * The request with the mount taken off its address, where it is under the mount — or the redirect
- * to the mount's root, where it asked for the mount with no `/` after it.
+ * to the mount's root, where it asked for the mount with a `/` after it.
  *
  * 16.10 — A REQUEST UNDER THE MOUNT IS ANSWERED AS THE ADDRESS BELOW IT; one that is not — a proxy
  * that already took the prefix off — is answered as it came.
  *
- * THE MOUNT'S ROOT IS `/docs/`, as `url('/')` writes it. A document answered at `/docs` resolves a
- * relative address against `/`, which is outside the app, so the bare mount is sent to the root a
- * relative address resolves under.
+ * 19.17 — THE MOUNT'S ROOT IS `/docs`, as `url('/')` writes it, and `/docs/` is sent there so the
+ * root has one address. Every address abide writes is absolute under the mount, so none resolves
+ * against the page's.
  */
 function belowMount(request: Request): Request | Response {
     const mount = MOUNT.current()
@@ -522,10 +522,10 @@ function belowMount(request: Request): Request | Response {
     const url = new URL(request.url)
     // A PATH RATHER THAN A URL: the origin this request names is the one it reached, which behind
     // a proxy is not the one the browser asked.
-    if (url.pathname === mount)
+    if (url.pathname === `${mount}/`)
         return new Response(null, {
             status: 308,
-            headers: { location: `${mount}/${url.search}` },
+            headers: { location: `${mount}${url.search}` },
         })
     const below = unmounted(url.pathname)
     if (below === undefined || below === url.pathname) return request

package/src/shared/mount.ts

@@ -25,10 +25,14 @@ function documentMount(): string {
     return documentMountRead
 }
 
-/** An address below the app's root, as the address it is served at. */
+/**
+ * An address below the app's root, as the address it is served at. 19.17 — the root below a mount
+ * is the bare mount, `/docs` rather than `/docs/`.
+ */
 export function mounted(address: string): string {
     const mount = MOUNT.current()
-    return mount === '' ? address : `${mount}${address}`
+    if (mount === '') return address
+    return address === '/' ? mount : `${mount}${address}`
 }
 
 /**