@madojs/mado 0.11.1 → 0.13.0

package/dist/src/router/base.js

@@ -0,0 +1,168 @@
+/**
+ * Single source of truth for the Vite `base` URL prefix at runtime.
+ *
+ * Mado reads `import.meta.env.BASE_URL` once at module init and exposes
+ * three pure helpers used by the router, navigation, head and any user
+ * code that constructs internal links.
+ *
+ *   vite.config.ts → base
+ *     ├── runtime: import.meta.env.BASE_URL      (this module)
+ *     └── CLI:     resolved config → _mado/build.json
+ *
+ * There is intentionally NO `<meta name="mado:base">`, no
+ * `routes({}, { base })`, no second runtime config. Tools that load Mado
+ * outside Vite (native ESM tests, partial SSR probes) fall back to "/".
+ */
+function readEnvBase() {
+    // Direct access to the well-known constant so Vite's static
+    // `define`-replacement (and Vite-only `import.meta.env.BASE_URL`
+    // injection) sees the expression verbatim. Optional chaining or
+    // intermediate variables would defeat the rewriter. In non-Vite
+    // environments the property is undefined and we fall back to "/".
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const value = import.meta.env?.BASE_URL;
+        if (typeof value === "string")
+            return value;
+    }
+    catch {
+        /* fall through */
+    }
+    return "/";
+}
+/**
+ * Normalise an arbitrary base value into the canonical Mado form:
+ * starts with "/", ends with "/", collapses repeated slashes. The root
+ * base is the literal "/".
+ *
+ *   normalizeBase("")        === "/"
+ *   normalizeBase("/")       === "/"
+ *   normalizeBase("mado")    === "/mado/"
+ *   normalizeBase("/mado")   === "/mado/"
+ *   normalizeBase("/mado/")  === "/mado/"
+ *   normalizeBase("//x//y/") === "/x/y/"
+ */
+export function normalizeBase(raw) {
+    if (!raw)
+        return "/";
+    let s = String(raw).trim();
+    if (!s || s === "/")
+        return "/";
+    if (!s.startsWith("/"))
+        s = "/" + s;
+    if (!s.endsWith("/"))
+        s = s + "/";
+    s = s.replace(/\/+/g, "/");
+    return s;
+}
+/**
+ * The active base prefix for the running app. Computed once from
+ * `import.meta.env.BASE_URL` and normalised. Use it inside Mado runtime;
+ * application code should call `routeUrl()` instead.
+ */
+export const appBase = normalizeBase(readEnvBase());
+/**
+ * Strip the base prefix off a browser pathname so it becomes a route
+ * pathname the matcher understands.
+ *
+ *   base = "/mado/"
+ *   stripBase("/mado/")        === "/"
+ *   stripBase("/mado/docs")    === "/docs"
+ *   stripBase("/mado/docs/")   === "/docs"
+ *   stripBase("/other")        === "/other"     (no base → unchanged)
+ *   stripBase("")              === "/"
+ *
+ *   base = "/"
+ *   stripBase("/docs")         === "/docs"
+ */
+export function stripBase(pathname, base = appBase) {
+    const b = normalizeBase(base);
+    if (!pathname)
+        return "/";
+    if (b === "/")
+        return pathname.startsWith("/") ? pathname : "/" + pathname;
+    // Exact match of base without trailing slash → root.
+    const bNoTrail = b.slice(0, -1);
+    if (pathname === bNoTrail)
+        return "/";
+    if (pathname === b)
+        return "/";
+    if (pathname.startsWith(b)) {
+        const rest = pathname.slice(b.length - 1); // keep leading slash
+        return rest || "/";
+    }
+    // Pathname is outside our base (foreign link clicked, etc.); return it
+    // unchanged so the caller can detect the mismatch and fall back to a
+    // native navigation.
+    return pathname;
+}
+/**
+ * Prefix a route pathname with the active base so it becomes a real
+ * browser URL suitable for `history.pushState` and `<a href>`.
+ *
+ *   base = "/mado/"
+ *   withBase("/")          === "/mado/"
+ *   withBase("/docs")      === "/mado/docs"
+ *   withBase("/docs/", b)  === "/mado/docs/"
+ *   withBase("docs")       === "/mado/docs"
+ *
+ *   base = "/"
+ *   withBase("/docs")      === "/docs"
+ */
+export function withBase(pathname, base = appBase) {
+    const b = normalizeBase(base);
+    const p = pathname || "/";
+    const abs = p.startsWith("/") ? p : "/" + p;
+    if (b === "/")
+        return abs;
+    // Root route under a non-trivial base must keep the trailing slash so
+    // that `<a href>` agrees with the canonical deployment URL shape.
+    //   routeUrl("/") with base "/mado/" === "/mado/"   (not "/mado")
+    if (abs === "/")
+        return b;
+    // Strip leading slash from abs so we can concatenate with base ("/mado/").
+    // If abs already starts with the base prefix, return it unchanged so we
+    // do not double-prefix on accident.
+    if (abs === b || abs.startsWith(b))
+        return abs;
+    if (abs === b.slice(0, -1))
+        return abs;
+    return b + abs.slice(1);
+}
+/**
+ * Build an internal link URL: prefix the given route pathname with the
+ * active Vite base, preserving query and hash. This is the canonical way
+ * to emit `<a href>` values in Mado views.
+ *
+ *   import { routeUrl } from "@madojs/mado";
+ *   html`<a data-link href=${routeUrl("/docs")}>Docs</a>`
+ *
+ *   base = "/mado/"
+ *   routeUrl("/docs")              === "/mado/docs"
+ *   routeUrl("/docs?q=1#h")        === "/mado/docs?q=1#h"
+ *   routeUrl("/")                  === "/mado/"
+ *
+ *   base = "/"
+ *   routeUrl("/docs")              === "/docs"
+ */
+export function routeUrl(pathname, base = appBase) {
+    if (!pathname)
+        return withBase("/", base);
+    // Split off ?query and #hash so we only run withBase on the pathname.
+    let path = pathname;
+    let suffix = "";
+    const hashAt = path.indexOf("#");
+    if (hashAt >= 0) {
+        suffix = path.slice(hashAt) + suffix;
+        path = path.slice(0, hashAt);
+    }
+    const queryAt = path.indexOf("?");
+    if (queryAt >= 0) {
+        suffix = path.slice(queryAt) + suffix;
+        path = path.slice(0, queryAt);
+    }
+    if (path === "")
+        path = "/";
+    return withBase(path, base) + suffix;
+}
+//# sourceMappingURL=base.js.map

package/dist/src/router/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/router/base.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Single source of truth for the Vite `base` URL prefix at runtime.\n *\n * Mado reads `import.meta.env.BASE_URL` once at module init and exposes\n * three pure helpers used by the router, navigation, head and any user\n * code that constructs internal links.\n *\n *   vite.config.ts → base\n *     ├── runtime: import.meta.env.BASE_URL      (this module)\n *     └── CLI:     resolved config → _mado/build.json\n *\n * There is intentionally NO `<meta name=\"mado:base\">`, no\n * `routes({}, { base })`, no second runtime config. Tools that load Mado\n * outside Vite (native ESM tests, partial SSR probes) fall back to \"/\".\n */\nfunction readEnvBase(): string {\n  // Direct access to the well-known constant so Vite's static\n  // `define`-replacement (and Vite-only `import.meta.env.BASE_URL`\n  // injection) sees the expression verbatim. Optional chaining or\n  // intermediate variables would defeat the rewriter. In non-Vite\n  // environments the property is undefined and we fall back to \"/\".\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const value = (import.meta as any).env?.BASE_URL;\n    if (typeof value === \"string\") return value;\n  } catch {\n    /* fall through */\n  }\n  return \"/\";\n}\n\n/**\n * Normalise an arbitrary base value into the canonical Mado form:\n * starts with \"/\", ends with \"/\", collapses repeated slashes. The root\n * base is the literal \"/\".\n *\n *   normalizeBase(\"\")        === \"/\"\n *   normalizeBase(\"/\")       === \"/\"\n *   normalizeBase(\"mado\")    === \"/mado/\"\n *   normalizeBase(\"/mado\")   === \"/mado/\"\n *   normalizeBase(\"/mado/\")  === \"/mado/\"\n *   normalizeBase(\"//x//y/\") === \"/x/y/\"\n */\nexport function normalizeBase(raw: string | null | undefined): string {\n  if (!raw) return \"/\";\n  let s = String(raw).trim();\n  if (!s || s === \"/\") return \"/\";\n  if (!s.startsWith(\"/\")) s = \"/\" + s;\n  if (!s.endsWith(\"/\")) s = s + \"/\";\n  s = s.replace(/\\/+/g, \"/\");\n  return s;\n}\n\n/**\n * The active base prefix for the running app. Computed once from\n * `import.meta.env.BASE_URL` and normalised. Use it inside Mado runtime;\n * application code should call `routeUrl()` instead.\n */\nexport const appBase: string = normalizeBase(readEnvBase());\n\n/**\n * Strip the base prefix off a browser pathname so it becomes a route\n * pathname the matcher understands.\n *\n *   base = \"/mado/\"\n *   stripBase(\"/mado/\")        === \"/\"\n *   stripBase(\"/mado/docs\")    === \"/docs\"\n *   stripBase(\"/mado/docs/\")   === \"/docs\"\n *   stripBase(\"/other\")        === \"/other\"     (no base → unchanged)\n *   stripBase(\"\")              === \"/\"\n *\n *   base = \"/\"\n *   stripBase(\"/docs\")         === \"/docs\"\n */\nexport function stripBase(pathname: string, base: string = appBase): string {\n  const b = normalizeBase(base);\n  if (!pathname) return \"/\";\n  if (b === \"/\") return pathname.startsWith(\"/\") ? pathname : \"/\" + pathname;\n  // Exact match of base without trailing slash → root.\n  const bNoTrail = b.slice(0, -1);\n  if (pathname === bNoTrail) return \"/\";\n  if (pathname === b) return \"/\";\n  if (pathname.startsWith(b)) {\n    const rest = pathname.slice(b.length - 1); // keep leading slash\n    return rest || \"/\";\n  }\n  // Pathname is outside our base (foreign link clicked, etc.); return it\n  // unchanged so the caller can detect the mismatch and fall back to a\n  // native navigation.\n  return pathname;\n}\n\n/**\n * Prefix a route pathname with the active base so it becomes a real\n * browser URL suitable for `history.pushState` and `<a href>`.\n *\n *   base = \"/mado/\"\n *   withBase(\"/\")          === \"/mado/\"\n *   withBase(\"/docs\")      === \"/mado/docs\"\n *   withBase(\"/docs/\", b)  === \"/mado/docs/\"\n *   withBase(\"docs\")       === \"/mado/docs\"\n *\n *   base = \"/\"\n *   withBase(\"/docs\")      === \"/docs\"\n */\nexport function withBase(pathname: string, base: string = appBase): string {\n  const b = normalizeBase(base);\n  const p = pathname || \"/\";\n  const abs = p.startsWith(\"/\") ? p : \"/\" + p;\n  if (b === \"/\") return abs;\n  // Root route under a non-trivial base must keep the trailing slash so\n  // that `<a href>` agrees with the canonical deployment URL shape.\n  //   routeUrl(\"/\") with base \"/mado/\" === \"/mado/\"   (not \"/mado\")\n  if (abs === \"/\") return b;\n  // Strip leading slash from abs so we can concatenate with base (\"/mado/\").\n  // If abs already starts with the base prefix, return it unchanged so we\n  // do not double-prefix on accident.\n  if (abs === b || abs.startsWith(b)) return abs;\n  if (abs === b.slice(0, -1)) return abs;\n  return b + abs.slice(1);\n}\n\n/**\n * Build an internal link URL: prefix the given route pathname with the\n * active Vite base, preserving query and hash. This is the canonical way\n * to emit `<a href>` values in Mado views.\n *\n *   import { routeUrl } from \"@madojs/mado\";\n *   html`<a data-link href=${routeUrl(\"/docs\")}>Docs</a>`\n *\n *   base = \"/mado/\"\n *   routeUrl(\"/docs\")              === \"/mado/docs\"\n *   routeUrl(\"/docs?q=1#h\")        === \"/mado/docs?q=1#h\"\n *   routeUrl(\"/\")                  === \"/mado/\"\n *\n *   base = \"/\"\n *   routeUrl(\"/docs\")              === \"/docs\"\n */\nexport function routeUrl(pathname: string, base: string = appBase): string {\n  if (!pathname) return withBase(\"/\", base);\n  // Split off ?query and #hash so we only run withBase on the pathname.\n  let path = pathname;\n  let suffix = \"\";\n  const hashAt = path.indexOf(\"#\");\n  if (hashAt >= 0) {\n    suffix = path.slice(hashAt) + suffix;\n    path = path.slice(0, hashAt);\n  }\n  const queryAt = path.indexOf(\"?\");\n  if (queryAt >= 0) {\n    suffix = path.slice(queryAt) + suffix;\n    path = path.slice(0, queryAt);\n  }\n  if (path === \"\") path = \"/\";\n  return withBase(path, base) + suffix;\n}\n\n"]}

package/dist/src/router/manifest.d.ts

@@ -66,3 +66,4 @@ export declare function routes(manifest: RoutesMap, options?: RoutesOptions): Ro
  * If there is no active routes() — no-op.
  */
 export declare function prefetchPath(pathname: string): void;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/src/router/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/router/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAShE,OAAO,EAIL,KAAK,WAAW,EAEhB,KAAK,SAAS,EACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAoB,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAWnE,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,cAAc,CAAC;IAC/B,0CAA0C;IAC1C,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,cAAc,CAAC;IACvC;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,KAAK,cAAc,CAAC;IAChE,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AA2CD;;GAEG;AACH,wBAAgB,MAAM,CACpB,QAAQ,EAAE,SAAS,EACnB,OAAO,GAAE,aAAkB,GAC1B,SAAS,CA4DX;AAiCD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAInD"}