@vmz/core 0.2.5 → 0.2.7

package/dist/host/serve/route-catalog.js

@@ -0,0 +1,108 @@
+export function parsePathPattern(pattern) {
+    const raw = String(pattern || '').trim();
+    if (!raw || raw === '/')
+        return [];
+    const parts = raw.replace(/^\/+/, '').split('/').filter(Boolean);
+    const segs = [];
+    for (const p of parts) {
+        if (isRouteGroupDir(p))
+            continue;
+        segs.push(parsePathSegment(p));
+    }
+    return segs;
+}
+function parsePathSegment(p) {
+    const catchAll = /^\[\.\.\.([^\]]+)\]$/.exec(p);
+    const param = /^\[([^\]]+)\]$/.exec(p);
+    const colon = /^:([A-Za-z_][\w]*)$/.exec(p);
+    if (catchAll)
+        return { kind: 'catch', name: catchAll[1] };
+    if (param)
+        return { kind: 'param', name: param[1] };
+    if (colon)
+        return { kind: 'param', name: colon[1] };
+    return { kind: 'static', value: p.toLowerCase() };
+}
+function isRouteGroupDir(seg) {
+    return typeof seg === 'string' && seg.startsWith('(') && seg.endsWith(')') && seg.length > 2;
+}
+export function isRouteBoundaryStem(stem) {
+    return stem === 'Layout' || stem === 'Loading' || stem === 'Error' || stem === 'NotFound';
+}
+export function matchFileRoute(pathname, catalog) {
+    const pathParts = decodeURIComponent(pathname.split('?')[0] || '/')
+        .replace(/\/+$/, '')
+        .split('/')
+        .filter(Boolean)
+        .map((p) => p.toLowerCase());
+    let best = null;
+    let bestScore = -1;
+    for (const page of catalog) {
+        const score = scoreRoute(page.segs, pathParts);
+        if (score == null)
+            continue;
+        if (score > bestScore) {
+            bestScore = score;
+            best = page;
+        }
+    }
+    return best;
+}
+export function extractRouteParams(segs, pathname) {
+    const pathParts = decodeURIComponent(pathname.split('?')[0] || '/')
+        .replace(/\/+$/, '')
+        .split('/')
+        .filter(Boolean);
+    const params = {};
+    let j = 0;
+    for (let i = 0; i < segs.length; i++) {
+        const s = segs[i];
+        if (s.kind === 'catch') {
+            if (s.name)
+                params[s.name] = pathParts.slice(j).join('/');
+            return params;
+        }
+        if (j >= pathParts.length)
+            break;
+        if (s.kind === 'param' && s.name) {
+            params[s.name] = pathParts[j];
+        }
+        j++;
+    }
+    return params;
+}
+function scoreRoute(segs, pathParts) {
+    let i = 0;
+    let j = 0;
+    let score = 0;
+    while (i < segs.length) {
+        const s = segs[i];
+        if (s.kind === 'catch') {
+            if (j >= pathParts.length)
+                return null;
+            score += 1;
+            return score;
+        }
+        if (j >= pathParts.length)
+            return null;
+        if (s.kind === 'static') {
+            if (s.value !== pathParts[j])
+                return null;
+            score += 1000;
+        }
+        else if (s.kind === 'param') {
+            score += 100;
+        }
+        i++;
+        j++;
+    }
+    if (j !== pathParts.length)
+        return null;
+    return score + segs.length;
+}
+export function isRootCatchAll(page) {
+    return page?.segs?.length === 1 && page.segs[0].kind === 'catch';
+}
+export function findRootCatchAll(catalog) {
+    return catalog.find((p) => isRootCatchAll(p)) || null;
+}

package/dist/host/serve/state.d.ts

@@ -0,0 +1,30 @@
+import type { Server } from 'node:http';
+import type { SseClient } from '../../shared/host.types.js';
+export declare function resolveServeDistDir(): string;
+export declare const serveState: {
+    distDir: string;
+    appPackageRequire: ReturnType<typeof import("node:module").createRequire> | null;
+    host: string;
+    port: number;
+    isDev: boolean;
+    reloadToken: number;
+    ssrRenderHost: Awaited<ReturnType<typeof import("../render/render-host.js").createRenderHost>> | null;
+    lastDevBuildId: string | null;
+    pageCatalog: any[];
+    pageCtors: Map<string, any>;
+    cssEntry: string | null;
+    styleBundleHash: string | null;
+    styleTheme: any;
+    localeArtifact: any;
+    localeLinkPlan: any;
+    sseClients: Set<SseClient>;
+    inFlight: number;
+    shuttingDown: boolean;
+    ready: boolean;
+    lastDevError: {
+        message: string;
+        stack?: string;
+        at: number;
+    } | null;
+    server: Server | null;
+};

package/dist/host/serve/state.js

@@ -0,0 +1,36 @@
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+export function resolveServeDistDir() {
+    if (process.env.VMZ_DIST)
+        return path.resolve(process.env.VMZ_DIST);
+    const hostDir = path.join(path.dirname(fileURLToPath(import.meta.url)), '..');
+    const norm = hostDir.replace(/\\/g, '/');
+    const marker = '/_vmz/host';
+    const idx = norm.toLowerCase().lastIndexOf(marker);
+    if (idx >= 0)
+        return path.resolve(hostDir.slice(0, idx));
+    return hostDir;
+}
+export const serveState = {
+    distDir: resolveServeDistDir(),
+    appPackageRequire: null,
+    host: process.env.VMZ_HOST || '127.0.0.1',
+    port: Number(process.env.VMZ_PORT || process.env.PORT || 5173),
+    isDev: process.env.VMZ_DEV === '1' || process.env.VMZ_DEV === 'true',
+    reloadToken: Date.now(),
+    ssrRenderHost: null,
+    lastDevBuildId: null,
+    pageCatalog: [],
+    pageCtors: new Map(),
+    cssEntry: null,
+    styleBundleHash: null,
+    styleTheme: null,
+    localeArtifact: null,
+    localeLinkPlan: null,
+    sseClients: new Set(),
+    inFlight: 0,
+    shuttingDown: false,
+    ready: false,
+    lastDevError: null,
+    server: null,
+};

package/dist/host/serve-host.d.ts

@@ -1,18 +1 @@
-/**
- * Generic VMZ Node host �?SSR Route Graph pages + dist static + RPC/REST.
- *
- * Invoked by `vmz serve` / `vmz dev` (or: node dist/vmz-serve-host.mjs).
- *
- * Pathname matches compiled `_vmz/route-catalog.json` (frozen segs / pathPattern).
- * Hosts must not re-parse deployment pathPattern into a live catalog.
- * Not an SPA shell.
- *
- * `VMZ_DEV=1`: POST `/__vmz/reload` soft-reloads modules (cache-bust import);
- * GET `/__vmz/events` SSE notifies the browser:
- * - island HMR �?re-import `entry-client.js` (no full document reload)
- * - otherwise �?`location.reload`
- *
- * Dev resolve hook propagates `?t=` onto nested relative `file:` imports under
- * dist so soft reload does not keep a stale `lib/*.js` ESM cache entry.
- */
 export {};