@vmz/core 0.2.0 → 0.2.2

package/dist/browser/direct-api.types.d.ts

@@ -2,11 +2,6 @@
  * Direct DOM API types for `@vmz/core` browser runtime.
  */
 export type BindingId = number | string | null;
-export type DirectInstance = Record<string, unknown> & {
-    __vmzDestroyed?: boolean;
-    __vmzDomRoot?: Node | null;
-    __vmzFlushTrie?: Record<string, unknown> | null;
-};
 export type PatchFn = (this: DirectInstance) => void;
 export type DirectBranchCreate = (api: DirectApi) => Node;
 export type DirectIfBranch = {
@@ -20,6 +15,96 @@ export type DirectEachSpec = {
     createItem: DirectBranchCreate;
     serializeItem?: DirectBranchCreate;
 };
+export type BinderEntry = {
+    deps: string[];
+    fn: PatchFn;
+    bindingId?: BindingId;
+};
+export type DirtyTrieNode = {
+    [seg: string]: DirtyTrieNode | true | undefined;
+};
+export type ComponentListenerBag = Record<string, Array<(detail?: unknown) => void>>;
+export type VmzPlan = {
+    schema?: string;
+    root_ids?: Array<string | number>;
+    [key: string]: unknown;
+};
+export type TaskStatus = 'pending' | 'success' | 'error' | 'cancelled';
+export type TaskEntry = {
+    generation: number;
+    controller: AbortController | {
+        signal: {
+            aborted: boolean;
+        };
+        abort: () => void;
+    };
+    status: TaskStatus;
+    result?: unknown;
+    error?: unknown;
+    promise?: Promise<unknown>;
+};
+export type DirtyNotice = {
+    type: 'replace';
+    root: string;
+} | {
+    type: 'path';
+    root: string;
+    segs: string[];
+};
+/** Runtime instance shape mounted by Direct create / hydrate / resume. */
+export type DirectInstance = {
+    [key: string]: unknown;
+    __vmzDestroyed?: boolean;
+    __vmzDomRoot?: (Node & {
+        __vmzInst?: DirectInstance | null;
+    }) | null;
+    __vmzFlushTrie?: DirtyTrieNode | null;
+    __vmzFlushScheduled?: boolean;
+    __vmzFlushSync?: boolean;
+    __vmzDirtyTrie?: DirtyTrieNode | null;
+    __vmzDirty?: Set<string>;
+    __vmzDirtyNotices?: DirtyNotice[];
+    __vmzLeafDirty?: Array<{
+        root: string;
+        field: string;
+        idxs: number[];
+    }>;
+    __vmzDrainLeafDirty?: boolean;
+    __vmzBinders?: Record<string, BinderEntry | PatchFn>;
+    __vmzBindings?: Record<string, BinderEntry | PatchFn>;
+    __vmzDepToBindings?: Record<string, Array<string | number>>;
+    __vmzPendingChildMounts?: Array<Promise<unknown>>;
+    __vmzComponentListeners?: ComponentListenerBag;
+    __vmzOnParentProp?: (propName: string, value: unknown) => void;
+    __vmzApplyProps?: (props: object) => void;
+    __vmzTasks?: Record<string, TaskEntry>;
+    __vmzPlan?: VmzPlan | null;
+    __vmzCtor?: ComponentCtorLike | null;
+    __vmzQuiet?: boolean;
+    __vmzEventDepth?: number;
+    __vmzEachApplyLeaf?: unknown;
+    __vmzEachCompoundStride?: unknown;
+    __vmzEachTranspose?: unknown;
+    onMount?: () => void | Promise<void>;
+    onDestroy?: () => void | Promise<void>;
+};
+export type ComponentCtorLike = (new (props?: object) => DirectInstance) & {
+    __vmzDirect?: boolean;
+    __vmzCreate?: (this: DirectInstance, api: DirectApi) => Node;
+    __vmzSerialize?: (this: DirectInstance, api: DirectApi) => unknown;
+    __vmzPlan?: VmzPlan | unknown;
+    __vmzHostBox?: string;
+    __vmzTag?: string;
+    __vmzState?: string[];
+    __vmzProps?: string[];
+    __vmzWBInstalled?: boolean;
+    __vmzCtorAppliesProps?: boolean;
+    name?: string;
+};
+export type DirectEachCtx = {
+    noteItemBind: (bindingId: BindingId, deps: string[], fn: PatchFn) => void;
+    needDelegate: (type: string) => void;
+};
 /** Browser + generated artifact platform surface (0.2.0 thin runtime). */
 export type DirectApi = {
     _inst: DirectInstance | null;
@@ -29,16 +114,15 @@ export type DirectApi = {
         bindingId?: BindingId;
     }> | null;
     _itemPatches: PatchFn[] | null;
-    _eachCtx: null | {
-        noteItemBind: (bindingId: BindingId, deps: string[], fn: PatchFn) => void;
-        needDelegate: (type: string) => void;
-    };
+    _eachCtx: DirectEachCtx | null;
     _resumeAdopt: null | Record<string, unknown>;
     el: (tag: string) => Element;
     text: (value?: unknown) => Text;
     frag: () => DocumentFragment;
     comment: (value?: string) => Comment;
     attr: (el: Element, name: string, value: unknown) => void;
+    mergeClass: (...parts: unknown[]) => string;
+    mergeStyle: (...parts: unknown[]) => string;
     insertBefore: (parent: Node, node: Node, ref: Node | null) => void;
     removeNode: (node: Node) => void;
     trackPatch: (inst: DirectInstance, deps: string[], patch: PatchFn, bindingId?: BindingId) => void;
@@ -53,6 +137,5 @@ export type DirectApi = {
     setHtml: (el: Element, value: unknown) => void;
     bindHtml: (inst: DirectInstance, bindingId: BindingId, deps: string[], get: PatchFn, el: Element) => void;
     bindComponentProp: (inst: DirectInstance, bindingId: BindingId, deps: string[], get: PatchFn, hostInst: DirectInstance, propName: string) => void;
-    component: (Ctor: new (props?: object) => DirectInstance, props?: object) => HTMLElement;
-    [key: string]: unknown;
+    component: (Ctor: ComponentCtorLike | string, props?: object) => HTMLElement;
 };

package/dist/browser/dom-core.d.ts

@@ -8,6 +8,7 @@
  */
 import type { BindingId, DirectInstance, PatchFn } from './direct-api.types.js';
 import type { ComponentCtor, EachCtx, ResumeAdoptCtx } from './dom-core.types.js';
+export { mergeClassParts, mergeStyleParts } from '../shared/dom-attr-normalize.js';
 export { applyDirectHostBox, INLINE_HOST_CONTENTS, resolveDirectHostBox } from './direct-host-box.js';
 export { createUnknownComponentElement, markUnknownComponentHost, serializeUnknownComponentNode, UNKNOWN_COMPONENT_ERROR, } from './unknown-component.js';
 export declare function __vmzPrecisionEnable(on?: boolean): void;
@@ -80,6 +81,8 @@ export declare function runDirectCreate(Component: any, inst: any): any;
  * projects parent siblings into the wrong host (commercial Drawer into Create btn).
  */
 export declare function findOwnedDefaultSlot(root: any): any;
+/** Button/Link shell when `<slot>` is absent (SSR-flattened or resume adopt). */
+export declare function findOwnedDefaultSlotTarget(root: any): any;
 export declare const directApi: {
     _inst: DirectInstance | null;
     _branchBinds: Array<{
@@ -91,6 +94,7 @@ export declare const directApi: {
     _eachCtx: EachCtx | null;
     _resumeAdopt: ResumeAdoptCtx | null;
     el(tag: any): any;
+    elNS(ns: any, tag: any): Element;
     text(value: any): Text;
     adoptEnter(node: any): boolean;
     adoptLeave(): void;
@@ -105,6 +109,8 @@ export declare const directApi: {
     untrackPatch(inst: any, deps: any, patch: any, bindingId?: any): void;
     disposeTree(root: any): void;
     attr(el: any, name: any, value: any): void;
+    mergeClass(...parts: any[]): string;
+    mergeStyle(...parts: any[]): string;
     on(el: any, type: any, handler: any): void;
     /**
      * Bind a named instance method (no arrow / Function#toString).

package/dist/browser/dom-core.js

@@ -6,8 +6,10 @@
  * Mount and client patches run that same schedule (SSR/hydrate/resume in dom-ssr).
  * Field writes only run registered dep patches ??never re-create structure.
  */
+import { mergeClassParts, mergeStyleParts } from '../shared/dom-attr-normalize.js';
 import { applyDirectHostBox } from './direct-host-box.js';
 import { createUnknownComponentElement } from './unknown-component.js';
+export { mergeClassParts, mergeStyleParts } from '../shared/dom-attr-normalize.js';
 export { applyDirectHostBox, INLINE_HOST_CONTENTS, resolveDirectHostBox } from './direct-host-box.js';
 export { createUnknownComponentElement, markUnknownComponentHost, serializeUnknownComponentNode, UNKNOWN_COMPONENT_ERROR, } from './unknown-component.js';
 const components = Object.create(null);
@@ -148,7 +150,7 @@ export function getRegisteredComponent(name) {
 export async function resolveComponent(name) {
     let Ctor = components[name];
     if (!Ctor && typeof globalThis.__vmzLoadComponent === 'function') {
-        Ctor = await globalThis.__vmzLoadComponent(name);
+        Ctor = (await globalThis.__vmzLoadComponent(name));
         if (Ctor)
             registerComponents({ [name]: Ctor });
     }
@@ -260,6 +262,33 @@ export function findOwnedDefaultSlot(root) {
     }
     return null;
 }
+/** Button/Link shell when `<slot>` is absent (SSR-flattened or resume adopt). */
+export function findOwnedDefaultSlotTarget(root) {
+    const slot = findOwnedDefaultSlot(root);
+    if (slot)
+        return slot;
+    if (!root || root.nodeType !== 1)
+        return null;
+    const walk = (el) => {
+        if (!el || el.nodeType !== 1)
+            return null;
+        const tag = String(el.tagName || '').toLowerCase();
+        if ((tag === 'button' || tag === 'a') && el.getAttribute('data-vmz-ui') === 'button')
+            return el;
+        if (el.hasAttribute('data-vmz'))
+            return null;
+        const kids = el.children;
+        if (!kids || !kids.length)
+            return null;
+        for (let i = 0; i < kids.length; i++) {
+            const hit = walk(kids[i]);
+            if (hit)
+                return hit;
+        }
+        return null;
+    };
+    return walk(root);
+}
 export const directApi = {
     _inst: null,
     _branchBinds: null,
@@ -272,6 +301,13 @@ export const directApi = {
         noteDomCreate();
         return document.createElement(tag || 'div');
     },
+    elNS(ns, tag) {
+        if (directApi._resumeAdopt && typeof directApi._resumeAdopt.elNS === 'function') {
+            return directApi._resumeAdopt.elNS(ns, tag);
+        }
+        noteDomCreate();
+        return document.createElementNS(ns || 'http://www.w3.org/2000/svg', tag || 'g');
+    },
     text(value) {
         if (directApi._resumeAdopt)
             return directApi._resumeAdopt.text(value);
@@ -374,6 +410,12 @@ export const directApi = {
     attr(el, name, value) {
         applyDomAttr(el, name, value);
     },
+    mergeClass(...parts) {
+        return mergeClassParts(...parts);
+    },
+    mergeStyle(...parts) {
+        return mergeStyleParts(...parts);
+    },
     on(el, type, handler) {
         const inst = directApi._inst;
         if (directApi._eachCtx && typeof handler === 'function') {
@@ -479,12 +521,19 @@ export const directApi = {
         directApi.trackPatch(inst, [fieldName], function specFieldAttrPatch() {
             const raw = this[fieldName];
             if (name === 'class' || name === 'className') {
-                const s = String(raw ?? '');
+                const s = mergeClassParts(raw);
                 if (s)
                     el.setAttribute('class', s);
                 else if (el.hasAttribute('class'))
                     el.removeAttribute('class');
             }
+            else if (name === 'style') {
+                const s = mergeStyleParts(raw);
+                if (s)
+                    el.setAttribute('style', s);
+                else if (el.hasAttribute('style'))
+                    el.removeAttribute('style');
+            }
             else {
                 applyDomAttr(el, name, raw);
             }
@@ -662,12 +711,13 @@ export const directApi = {
         // Emptied DocumentFragment after append must not receive slot kids.
         if (!root || root.nodeType !== 1)
             root = hostEl;
-        let slot = null;
-        if (root && root.nodeType === 1) {
-            slot = findOwnedDefaultSlot(root);
-        }
-        if (slot && slot.parentNode) {
-            slot.replaceWith(node);
+        const target = root && root.nodeType === 1 ? findOwnedDefaultSlotTarget(root) : null;
+        if (target && target.parentNode) {
+            if (String(target.tagName || '').toLowerCase() === 'slot') {
+                target.replaceWith(node);
+                return;
+            }
+            target.appendChild(node);
             return;
         }
         if (root && root.nodeType === 1 && typeof root.appendChild === 'function')
@@ -731,6 +781,22 @@ export const BOOLEAN_HTML_ATTRS = new Set([
 ]);
 export function applyDomAttr(el, name, value) {
     const key = name === 'className' ? 'class' : name;
+    if (key === 'class') {
+        const s = mergeClassParts(value);
+        if (s)
+            el.setAttribute('class', s);
+        else
+            el.removeAttribute('class');
+        return;
+    }
+    if (key === 'style') {
+        const s = mergeStyleParts(value);
+        if (s)
+            el.setAttribute('style', s);
+        else
+            el.removeAttribute('style');
+        return;
+    }
     if (BOOLEAN_HTML_ATTRS.has(String(key).toLowerCase())) {
         if (value === false || value == null || value === '') {
             el.removeAttribute(key);

package/dist/browser/dom-core.types.d.ts

@@ -1,20 +1,9 @@
 /**
  * Internal types for `@vmz/core` browser DOM runtime (`dom-core.ts`).
  */
-import type { DirectApi, DirectInstance, PatchFn, BindingId } from './direct-api.types.js';
-export type { DirectApi, DirectInstance, PatchFn, BindingId };
-export type ComponentCtor = (new (props?: object) => DirectInstance) & {
-    __vmzDirect?: boolean;
-    __vmzCreate?: (this: DirectInstance, api: DirectApi) => Node;
-    __vmzSerialize?: (this: DirectInstance, api: DirectApi) => unknown;
-    __vmzPlan?: unknown;
-    __vmzHostBox?: string;
-    __vmzTag?: string;
-    __vmzState?: string[];
-    __vmzProps?: string[];
-    __vmzWBInstalled?: boolean;
-    __vmzCtorAppliesProps?: boolean;
-    name?: string;
+import type { BindingId, ComponentCtorLike, DirectApi, DirectInstance, PatchFn, VmzPlan } from './direct-api.types.js';
+export type { BindingId, DirectApi, DirectInstance, PatchFn, VmzPlan };
+export type ComponentCtor = ComponentCtorLike & {
     [key: string]: unknown;
 };
 export type VmzDomElement = Element & {
@@ -81,6 +70,7 @@ export type TraceBuffer = {
 };
 export type ResumeAdoptCtx = {
     el: (tag: string) => Element;
+    elNS?: (ns: string, tag: string) => Element;
     text: (value?: unknown) => Text;
     componentHost?: (name: string) => HTMLElement | null;
     enter?: (node: Element) => boolean;

package/dist/browser/unknown-component.js

@@ -35,8 +35,7 @@ export function noteUnknownComponent(name, via = 'ssr') {
         if (!Array.isArray(g.__VMZ_COMPONENT_ERRORS__)) {
             g.__VMZ_COMPONENT_ERRORS__ = [];
         }
-        const bag = g.__VMZ_COMPONENT_ERRORS__;
-        bag.push(detail);
+        g.__VMZ_COMPONENT_ERRORS__.push(detail);
     }
     catch {
         /* ignore */

package/dist/faces/dom.browser.d.ts

@@ -4,4 +4,4 @@
  * Full barrel remains `@vmz/core/dom` (`dom.js` / dist `vmz-dom.js`) for Node host.
  */
 export * from '../browser/dom-core.js';
-export { attachEventEntries, hydrate, hydrateIslands, hydrateRoute, hydrateRoutePage, resume, resumeIslands, } from '../ssr/dom-ssr.js';
+export { attachEventEntries, hydrate, hydrateIslands, hydrateRoute, hydrateRoutePage, resume, resumeIslands } from '../ssr/dom-ssr.js';

package/dist/faces/dom.browser.js

@@ -4,4 +4,4 @@
  * Full barrel remains `@vmz/core/dom` (`dom.js` / dist `vmz-dom.js`) for Node host.
  */
 export * from '../browser/dom-core.js';
-export { attachEventEntries, hydrate, hydrateIslands, hydrateRoute, hydrateRoutePage, resume, resumeIslands, } from '../ssr/dom-ssr.js';
+export { attachEventEntries, hydrate, hydrateIslands, hydrateRoute, hydrateRoutePage, resume, resumeIslands } from '../ssr/dom-ssr.js';

package/dist/faces/http.d.ts

@@ -1,6 +1,6 @@
-/** Compile-time HTTP decorators �?erased from server JS emit; kept for authoring. */
-export declare function Get(path: any): (_target: any, _key: any, descriptor: any) => any;
-export declare function Post(path: any): (_target: any, _key: any, descriptor: any) => any;
-export declare function Put(path: any): (_target: any, _key: any, descriptor: any) => any;
-export declare function Delete(path: any): (_target: any, _key: any, descriptor: any) => any;
-export declare function Patch(path: any): (_target: any, _key: any, descriptor: any) => any;
+/** Compile-time HTTP decorators — erased from server JS emit; kept for authoring. */
+export declare function Get(path: string): (_target: object, _key: string | symbol, descriptor: PropertyDescriptor) => PropertyDescriptor;
+export declare function Post(path: string): (_target: object, _key: string | symbol, descriptor: PropertyDescriptor) => PropertyDescriptor;
+export declare function Put(path: string): (_target: object, _key: string | symbol, descriptor: PropertyDescriptor) => PropertyDescriptor;
+export declare function Delete(path: string): (_target: object, _key: string | symbol, descriptor: PropertyDescriptor) => PropertyDescriptor;
+export declare function Patch(path: string): (_target: object, _key: string | symbol, descriptor: PropertyDescriptor) => PropertyDescriptor;

package/dist/faces/http.js

@@ -1,4 +1,4 @@
-/** Compile-time HTTP decorators �?erased from server JS emit; kept for authoring. */
+/** Compile-time HTTP decorators — erased from server JS emit; kept for authoring. */
 export function Get(path) {
     return function GetDecorator(_target, _key, descriptor) {
         return descriptor;

package/dist/faces/server.d.ts

@@ -4,26 +4,27 @@
  * Browser-safe: no static `node:*` imports. Node builtins are loaded only inside
  * Node/SSR request handlers so client bundles can `import { callServer }`.
  */
-import type { Route, ServerModuleResolver } from '../shared/server.types.js';
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { NodeRequestOptions, Route, RpcRequest, ServerModuleResolver } from '../shared/server.types.js';
 /**
- * Map `#server/foo` �?filesystem / URL the host can `import`.
- * Only set this in Node/SSR hosts �?browser bundles must omit it so RPC goes HTTP.
+ * Map `#server/foo` → filesystem / URL the host can `import`.
+ * Only set this in Node/SSR hosts → browser bundles must omit it so RPC goes HTTP.
  */
 export declare function setServerModuleResolver(fn: ServerModuleResolver): void;
 export declare function setRoutes(next: Route[]): void;
 export declare function callServer(moduleId: string, method: string, args?: unknown[]): Promise<unknown>;
-export declare function handleRpc(body: any): Promise<any>;
+export declare function handleRpc(body: RpcRequest): Promise<unknown>;
 /**
  * Match REST route from `vmz-routes.json`.
  */
-export declare function matchRoute(verb: any, pathname: any): Route;
+export declare function matchRoute(verb: string, pathname: string): Route | null;
 /**
  * Web Standards Fetch entry for ServerArtifact hosts (Node adapter, worker/edge parity).
  * Handles RPC + public ServerRoute only; static/SSR stay on Node host options.
  */
-export declare function handleFetchRequest(request: any): Promise<Response>;
+export declare function handleFetchRequest(request: Request): Promise<Response>;
 /**
  * Node `http.createServer` listener: RPC + REST + optional static / SSR index.
  * RPC/REST go through {@link handleFetchRequest} so Node and Fetch hosts share one core.
  */
-export declare function handleNodeRequest(req: any, res: any, opts?: any): Promise<void>;
+export declare function handleNodeRequest(req: IncomingMessage, res: ServerResponse, opts?: NodeRequestOptions): Promise<void>;

package/dist/faces/server.js

@@ -8,8 +8,8 @@ const DEFAULT_RPC_PATH = '/__vmz/rpc';
 let resolveServerModule = null;
 let routes = [];
 /**
- * Map `#server/foo` �?filesystem / URL the host can `import`.
- * Only set this in Node/SSR hosts �?browser bundles must omit it so RPC goes HTTP.
+ * Map `#server/foo` → filesystem / URL the host can `import`.
+ * Only set this in Node/SSR hosts → browser bundles must omit it so RPC goes HTTP.
  */
 export function setServerModuleResolver(fn) {
     resolveServerModule = fn;
@@ -19,7 +19,7 @@ export function setRoutes(next) {
 }
 export async function callServer(moduleId, method, args = []) {
     // Browser (or tests forcing HTTP): never touch server modules in-process.
-    // Node SSR / smokes set a resolver and leave __VMZ_USE_HTTP_RPC unset �?local.
+    // Node SSR / smokes set a resolver and leave __VMZ_USE_HTTP_RPC unset → local.
     if (globalThis.__VMZ_USE_HTTP_RPC || !resolveServerModule) {
         return callServerHttp(moduleId, method, args);
     }
@@ -30,11 +30,12 @@ async function callServerLocal(moduleId, method, args) {
         throw new Error(`vmz:runtime callServer(${moduleId}): setServerModuleResolver() required in Node`);
     }
     const spec = resolveServerModule(moduleId);
-    const mod = await import(typeof spec === 'string' ? spec : spec.href);
-    const Ctor = mod.default ?? mod[exportGuess(moduleId)];
-    if (typeof Ctor !== 'function') {
+    const mod = (await import(typeof spec === 'string' ? spec : spec.href));
+    const exported = mod.default ?? mod[exportGuess(moduleId)];
+    if (typeof exported !== 'function') {
         throw new Error(`vmz:runtime: no class export for ${moduleId}`);
     }
+    const Ctor = exported;
     const instance = new Ctor();
     const fn = instance[method];
     if (typeof fn !== 'function') {
@@ -84,8 +85,8 @@ export function matchRoute(verb, pathname) {
 }
 /**
  * Build `callServerLocal` args from a Fetch Request for REST routes.
- * GET/HEAD �?`[]`. JSON POST/PUT/PATCH �?`[body]`. form-urlencoded �?`[record]`.
- * Multipart �?`[record]` where File/Blob parts stay as File/Blob (tool-site binary upload).
+ * GET/HEAD → `[]`. JSON POST/PUT/PATCH → `[body]`. form-urlencoded → `[record]`.
+ * Multipart → `[record]` where File/Blob parts stay as File/Blob (tool-site binary upload).
  * Octet-stream PUT also forwards Upload resumable chunk headers (upload-id / chunk-index / chunk-total).
  * Extra args are ignored by zero-parameter server methods (JS).
  */
@@ -106,12 +107,12 @@ async function routeArgsFromRequest(request, verb) {
         }
     }
     if (ctype.includes('multipart/form-data')) {
-        // Parse from raw bytes �?undici Request.formData() can UTF-8-mangle high bytes in file parts
-        // (0xFF/0xFE �?U+FFFD), which breaks Upload binary / tool-site intakes.
+        // Parse from raw bytes → undici Request.formData() can UTF-8-mangle high bytes in file parts
+        // (0xFF/0xFE → U+FFFD), which breaks Upload binary / tool-site intakes.
         const buf = Buffer.from(await request.arrayBuffer());
         return [parseMultipartBuffer(buf, ctype)];
     }
-    // Object-store PUT / resumable chunk PUT �?keep bytes (never request.text()).
+    // Object-store PUT / resumable chunk PUT → keep bytes (never request.text()).
     if (ctype.includes('application/octet-stream') ||
         ((v === 'PUT' || v === 'PATCH') && !ctype.includes('json') && !ctype.includes('x-www-form-urlencoded'))) {
         const buf = Buffer.from(await request.arrayBuffer());
@@ -145,7 +146,7 @@ export async function handleFetchRequest(request) {
     const verb = (request.method || 'GET').toUpperCase();
     try {
         if (verb === 'POST' && url.pathname === DEFAULT_RPC_PATH) {
-            const body = await request.json();
+            const body = (await request.json());
             const result = await handleRpc(body);
             return Response.json(result);
         }
@@ -179,10 +180,11 @@ export async function handleNodeRequest(req, res, opts = {}) {
             const response = await handleFetchRequest(request);
             return await writeFetchResponse(res, response);
         }
-        // Static first for assets + DocumentMount (`/d/�`) so docs aren't swallowed by SSR 404 shells.
-        // static route HTML (`index.html`, `about/index.html`, �? is a CDN/deploy projection only �?        // when Server Host SSR is active, those files must not shadow live render (local/dev �?SSR truth).
+        // Static first for assets + DocumentMount (`/d/…`) so docs aren't swallowed by SSR 404 shells.
+        // static route HTML (`index.html`, `about/index.html`, …) is a CDN/deploy projection only —
+        // when Server Host SSR is active, those files must not shadow live render (local/dev → SSR truth).
         if (verb === 'GET' && opts.distDir) {
-            const nodePath = await import('node:path');
+            const nodePath = (await import('node:path'));
             const { readFile, stat } = await import('node:fs/promises');
             const file = await resolveDistStatic(opts.distDir, url.pathname, nodePath, stat, {
                 cookieHeader: String(req.headers.cookie || ''),
@@ -197,7 +199,8 @@ export async function handleNodeRequest(req, res, opts = {}) {
                     return sendBytes(res, 200, body, contentType(file, nodePath));
                 }
                 catch (err) {
-                    if (err && (err.code === 'ENOENT' || err.code === 'EISDIR')) {
+                    const code = err && typeof err === 'object' && 'code' in err ? err.code : undefined;
+                    if (code === 'ENOENT' || code === 'EISDIR') {
                         /* fall through */
                     }
                     else {
@@ -216,7 +219,7 @@ export async function handleNodeRequest(req, res, opts = {}) {
                     /* ignore */
                 }
             };
-            // Do not abort on IncomingMessage `close` �?that fires after a POST body is
+            // Do not abort on IncomingMessage `close` — that fires after a POST body is
             // fully read (normal), which would cancel SSR before the first chunk.
             req.on('aborted', onClientGone);
             res.on('close', () => {
@@ -244,7 +247,7 @@ export async function handleNodeRequest(req, res, opts = {}) {
                         body,
                     });
                     if (rendered) {
-                        if (typeof rendered === 'object' && rendered.redirect) {
+                        if (typeof rendered === 'object' && 'redirect' in rendered && rendered.redirect) {
                             const status = Number(rendered.status) || 302;
                             const headers = {
                                 Location: String(rendered.redirect),
@@ -255,7 +258,7 @@ export async function handleNodeRequest(req, res, opts = {}) {
                             return;
                         }
                         const status = rendered && typeof rendered === 'object' && 'status' in rendered ? Number(rendered.status) || 200 : 200;
-                        const stream = rendered && typeof rendered === 'object' && rendered.stream ? rendered.stream : rendered;
+                        const stream = rendered && typeof rendered === 'object' && 'stream' in rendered && rendered.stream ? rendered.stream : rendered;
                         return await sendHtmlStream(res, status, stream, ac.signal);
                     }
                 }
@@ -355,7 +358,7 @@ function safeDistFile(distDir, pathname, nodePath) {
 }
 /**
  * static profile emits per-route HTML beside client assets. That HTML is for CDN / local-static
- * delivery hosts �?not for Server Host when SSR is available. DocumentMount stays static.
+ * delivery hosts — not for Server Host when SSR is available. DocumentMount stays static.
  */
 function isWebStaticHtmlShadow(file, pathname, nodePath) {
     const ext = nodePath.extname(file).toLowerCase();
@@ -364,14 +367,14 @@ function isWebStaticHtmlShadow(file, pathname, nodePath) {
     let rel = decodeURIComponent(String(pathname || '').split('?')[0] || '/');
     if (!rel.startsWith('/'))
         rel = `/${rel}`;
-    // Integrated DocumentMount �?keep static-first (see resolveDistStatic comment).
+    // Integrated DocumentMount — keep static-first (see resolveDistStatic comment).
     if (rel === '/d' || rel.startsWith('/d/'))
         return false;
     return true;
 }
 /**
  * Static resolve for app assets + integrated document mounts:
- * `/d/` �?`d/index.html`, `/d/zh-hans/guide` �?`d/zh-hans/guide.html`.
+ * `/d/` → `d/index.html`, `/d/zh-hans/guide` → `d/zh-hans/guide.html`.
  */
 async function resolveDistStatic(distDir, pathname, nodePath, stat, _opts = {}) {
     const candidates = staticPathCandidates(pathname);
@@ -451,7 +454,9 @@ function contentType(filePath, nodePath) {
 function readJson(req) {
     return new Promise((resolve, reject) => {
         const chunks = [];
-        req.on('data', (c) => chunks.push(c));
+        req.on('data', (c) => {
+            chunks.push(typeof c === 'string' ? Buffer.from(c) : c);
+        });
         req.on('end', () => {
             try {
                 const raw = Buffer.concat(chunks).toString('utf8') || '{}';
@@ -467,8 +472,10 @@ function readJson(req) {
 function readRawBody(req) {
     return new Promise((resolve, reject) => {
         const chunks = [];
-        req.on('data', (c) => chunks.push(c));
-        // Buffer �?never utf8-string: multipart File bytes must survive (Upload binary gate).
+        req.on('data', (c) => {
+            chunks.push(typeof c === 'string' ? Buffer.from(c) : c);
+        });
+        // Buffer — never utf8-string: multipart File bytes must survive (Upload binary gate).
         req.on('end', () => resolve(Buffer.concat(chunks)));
         req.on('error', reject);
     });
@@ -513,7 +520,7 @@ function parseMultipartBuffer(buf, contentType) {
                 if (fileM) {
                     const filename = fileM[1] || 'upload.bin';
                     const type = typeM ? String(typeM[1]).trim() : 'application/octet-stream';
-                    // Copy body �?File may outlive the request buffer.
+                    // Copy body — File may outlive the request buffer.
                     const copy = Buffer.from(body);
                     const file = new File([copy], filename, { type });
                     const prev = out[key];
@@ -551,19 +558,20 @@ function indexOfBuffer(hay, needle, from) {
     return -1;
 }
 function parseFormBody(raw, contentType) {
-    if (!raw)
+    const text = typeof raw === 'string' ? raw : raw.toString('utf8');
+    if (!text)
         return {};
     if (contentType.includes('application/x-www-form-urlencoded')) {
         const out = {};
-        for (const [k, v] of new URLSearchParams(raw))
+        for (const [k, v] of new URLSearchParams(text))
             out[k] = v;
         return out;
     }
     try {
-        return JSON.parse(raw);
+        return JSON.parse(text);
     }
     catch {
-        return { raw };
+        return { raw: text };
     }
 }
 function wantsBrowserHtml(req) {
@@ -592,7 +600,7 @@ function wantsBrowserHtml(req) {
 }
 /**
  * Browser-facing error document (no N-API). Used when SSR returns null or throws
- * on a document navigation �?must not fall back to API-shaped JSON.
+ * on a document navigation — must not fall back to API-shaped JSON.
  */
 function browserErrorHtml(status, title, message, stack) {
     const esc = (s) => String(s).replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
@@ -619,7 +627,7 @@ function browserErrorHtml(status, title, message, stack) {
     <h1>${esc(title)}</h1>
     <pre>${esc(message)}</pre>
     ${stackBlock}
-    <p class="hint">Document navigation returns HTML errors �?not API JSON.</p>
+    <p class="hint">Document navigation returns HTML errors — not API JSON.</p>
   </main>
 </body>
 </html>
@@ -652,8 +660,8 @@ async function sendHtmlStream(res, status, source, signal) {
         'transfer-encoding': 'chunked',
         'cache-control': 'no-cache',
     };
-    // Defer writeHead until the first successful chunk so SSR throw �?clean 500
-    // (not headersSent + destroy �?ERR_EMPTY_RESPONSE).
+    // Defer writeHead until the first successful chunk so SSR throw → clean 500
+    // (not headersSent + destroy → ERR_EMPTY_RESPONSE).
     let started = false;
     try {
         for await (const chunk of source) {
@@ -691,7 +699,7 @@ async function sendHtmlStream(res, status, source, signal) {
     catch (err) {
         if (aborted())
             return;
-        // Before headers: let outer handler sendJson(500). After headers: rethrow �?destroy.
+        // Before headers: let outer handler sendJson(500). After headers: rethrow → destroy.
         throw err;
     }
     if (started && !res.writableEnded && !res.destroyed) {
@@ -703,7 +711,7 @@ function sendBytes(res, status, body, type) {
         'content-type': type,
         'content-length': body.byteLength,
     };
-    // Dev: stylesheets are rebuilt in-place �?never cache @import siblings (VMZ-8).
+    // Dev: stylesheets are rebuilt in-place — never cache @import siblings (VMZ-8).
     if (process.env.VMZ_DEV === '1' && typeof type === 'string' && type.startsWith('text/css')) {
         headers['cache-control'] = 'no-store';
     }

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

@@ -7,8 +7,8 @@ export declare function createRenderHost(distDir: string, opts?: Record<string,
     deployment: import("../shared/host.types.js").DeploymentDocument;
     dom: any;
     loadedChunkIds: Set<string>;
-    ensureComponents: (rootChunkIds: any) => Promise<import("../shared/host.types.js").ComponentRegistryMap>;
-    closureChunkIds: (rootChunkIds: any) => Set<unknown>;
+    ensureComponents: (rootChunkIds?: string[] | null) => Promise<import("../shared/host.types.js").ComponentRegistryMap>;
+    closureChunkIds: (rootChunkIds?: string[] | null) => Set<string>;
     renderToString: any;
     renderToStream: any;
     mount: any;

package/dist/host/render-host.js

@@ -4,7 +4,7 @@
  */
 import path from 'node:path';
 import { pathToFileURL } from 'node:url';
-import { bootstrapComponentRegistry, collectDependsOnClosure, loadComponentEntries, readDeploymentDocument, importAndRegisterComponentEntries, } from './deployment-registry.js';
+import { bootstrapComponentRegistry, collectDependsOnClosure, importAndRegisterComponentEntries, loadComponentEntries, readDeploymentDocument, } from './deployment-registry.js';
 export async function createRenderHost(distDir, opts = {}) {
     const strict = opts.strictDeployment === true || opts.strict === true;
     const domPath = path.join(distDir, 'vmz-dom.js');

package/dist/shared/dom-attr-normalize.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Shared class/style normalization for Direct SSR + client (0.1.33).
+ * Vue-compatible: string | string[] | object map | falsy parts.
+ */
+/** Normalize one or more class fragments into a deduped class string. */
+export declare function mergeClassParts(...parts: unknown[]): string;
+/** Merge static + dynamic style fragments; later parts override same keys. */
+export declare function mergeStyleParts(...parts: unknown[]): string;

package/dist/shared/dom-attr-normalize.js

@@ -0,0 +1,71 @@
+/**
+ * Shared class/style normalization for Direct SSR + client (0.1.33).
+ * Vue-compatible: string | string[] | object map | falsy parts.
+ */
+function pushClassTokens(out, value) {
+    if (value == null || value === false)
+        return;
+    if (typeof value === 'string') {
+        for (const token of value.split(/\s+/)) {
+            if (token)
+                out.push(token);
+        }
+        return;
+    }
+    if (Array.isArray(value)) {
+        for (const item of value)
+            pushClassTokens(out, item);
+        return;
+    }
+    if (typeof value === 'object') {
+        for (const [key, enabled] of Object.entries(value)) {
+            if (enabled)
+                out.push(key);
+        }
+        return;
+    }
+    const s = String(value).trim();
+    if (s)
+        out.push(s);
+}
+/** Normalize one or more class fragments into a deduped class string. */
+export function mergeClassParts(...parts) {
+    const tokens = [];
+    for (const part of parts)
+        pushClassTokens(tokens, part);
+    return [...new Set(tokens)].join(' ');
+}
+function parseStyleObject(value) {
+    const out = {};
+    if (value == null || value === false)
+        return out;
+    if (typeof value === 'string') {
+        for (const chunk of value.split(';')) {
+            const idx = chunk.indexOf(':');
+            if (idx < 0)
+                continue;
+            const key = chunk.slice(0, idx).trim();
+            const val = chunk.slice(idx + 1).trim();
+            if (key)
+                out[key] = val;
+        }
+        return out;
+    }
+    if (typeof value === 'object' && !Array.isArray(value)) {
+        for (const [key, raw] of Object.entries(value)) {
+            if (raw == null || raw === false)
+                continue;
+            out[key] = String(raw);
+        }
+    }
+    return out;
+}
+/** Merge static + dynamic style fragments; later parts override same keys. */
+export function mergeStyleParts(...parts) {
+    const merged = {};
+    for (const part of parts)
+        Object.assign(merged, parseStyleObject(part));
+    return Object.entries(merged)
+        .map(([key, val]) => `${key}: ${val}`)
+        .join('; ');
+}

package/dist/shared/host.types.d.ts

@@ -32,7 +32,28 @@ export type ClosedAccessResult = {
     kind: 'not-found';
 };
 export type SseClient = Pick<ServerResponse, 'write' | 'end'>;
-export type DeploymentDocument = Record<string, unknown>;
+/** Deployment graph document (`vmz.deployment.v0`). */
+export type DeploymentUnit = {
+    chunkId?: string;
+    name?: string;
+    entry?: string;
+    source?: string;
+    dependsOn?: string[];
+    [key: string]: unknown;
+};
+export type DeploymentLayoutChain = {
+    routeId?: string;
+    layouts?: string[];
+    page?: string;
+    [key: string]: unknown;
+};
+export type DeploymentDocument = {
+    schema?: string;
+    units?: DeploymentUnit[];
+    layoutChain?: DeploymentLayoutChain[] | Record<string, unknown>;
+    dependsOn?: Record<string, string[]>;
+    [key: string]: unknown;
+};
 export type ComponentRegistryMap = Record<string, unknown>;
 export type LoadComponentEntriesOpts = {
     strict?: boolean;
@@ -65,3 +86,28 @@ export type PreloadComponentRegistryOpts = ListClientComponentsOpts & {
     preload?: 'all' | 'closure' | 'none';
 };
 export type NativeAddon = Record<string, unknown>;
+export type ServeHostOpts = {
+    distDir?: string;
+    port?: number;
+    host?: string;
+    signal?: AbortSignal;
+    [key: string]: unknown;
+};
+export type SoftReloadOpts = {
+    reason?: string;
+    signal?: AbortSignal;
+    [key: string]: unknown;
+};
+export type RenderPageStreamOpts = HostRequestOpts & {
+    localeId?: string;
+    [key: string]: unknown;
+};
+export type RenderHostOpts = {
+    strict?: boolean;
+    closureRoots?: string[];
+    explicit?: Record<string, string>;
+    preload?: 'all' | 'closure' | 'none';
+    cacheBust?: string | number;
+    rootChunkIds?: string[] | null;
+    [key: string]: unknown;
+};

package/dist/shared/server.types.d.ts

@@ -37,3 +37,31 @@ export type NodeRequestOptions = {
     req?: IncomingMessage;
 };
 export type ServerModuleResolver = (id: string) => string | URL;
+/** Subset of `node:path` used by static resolve helpers. */
+export type NodePathModule = {
+    resolve(...paths: string[]): string;
+    join(...paths: string[]): string;
+    extname(path: string): string;
+    readonly sep: string;
+};
+/** Minimal `fs.Stats`-like surface for static file probes. */
+export type StatResult = {
+    isFile(): boolean;
+    isDirectory(): boolean;
+};
+export type StatFn = (path: string) => Promise<StatResult>;
+export type DistStaticResolveOpts = {
+    cookieHeader?: string;
+};
+/** Multipart form fields: text, File, or repeated same-name values. */
+export type MultipartFieldValue = string | File | Array<string | File>;
+export type MultipartFields = Record<string, MultipartFieldValue>;
+export type OctetStreamBody = {
+    bytes: Buffer;
+    size: number;
+    key: string;
+    uploadId: string;
+    chunkIndex?: number;
+    chunkTotal?: number;
+    contentType: string;
+};

package/dist/ssr/dom-ssr.js

@@ -3,7 +3,7 @@
  * Imports client DOM primitives from ./dom-core.js for tree-shakeable browser entry.
  */
 import { applyDirectHostBox, directHostBoxStyleAttr } from '../browser/direct-host-box.js';
-import { applyPreservedState, BOOLEAN_HTML_ATTRS, createInstance, destroy, directApi, eventPropHandlerName, findOwnedDefaultSlot, getRegisteredComponent, hasMeaningfulChild, isEventEntryStrategy, mount, noteDomCreate, resolveComponent, runDirectCreate, scheduleClientOn, settlePendingChildMounts, snapshotInstanceState, stripFns, } from '../browser/dom-core.js';
+import { applyPreservedState, BOOLEAN_HTML_ATTRS, createInstance, destroy, directApi, eventPropHandlerName, findOwnedDefaultSlot, getRegisteredComponent, hasMeaningfulChild, isEventEntryStrategy, mergeClassParts, mergeStyleParts, mount, noteDomCreate, resolveComponent, runDirectCreate, scheduleClientOn, settlePendingChildMounts, snapshotInstanceState, stripFns, } from '../browser/dom-core.js';
 import { markUnknownComponentHost, serializeUnknownComponentNode } from '../browser/unknown-component.js';
 let _ssrDocumentLastError = null;
 /**
@@ -549,7 +549,16 @@ const serializeApi = {
         return child;
     },
     el(tag) {
-        return makeVirtualEl(tag);
+        const node = makeVirtualEl(tag);
+        if (String(tag || '').toLowerCase() === 'svg') {
+            node.namespaceURI = 'http://www.w3.org/2000/svg';
+        }
+        return node;
+    },
+    elNS(ns, tag) {
+        const node = makeVirtualEl(tag);
+        node.namespaceURI = ns || 'http://www.w3.org/2000/svg';
+        return node;
     },
     text(value) {
         const node = { __kind: 'text', value: value == null ? '' : String(value), parentNode: null };
@@ -633,6 +642,12 @@ const serializeApi = {
             return;
         applySerializeAttr(el, name, value);
     },
+    mergeClass(...parts) {
+        return mergeClassParts(...parts);
+    },
+    mergeStyle(...parts) {
+        return mergeStyleParts(...parts);
+    },
     on() {
         /* events are no-ops during SSR */
     },
@@ -666,6 +681,14 @@ const serializeApi = {
         catch {
             raw = null;
         }
+        if (name === 'class' || name === 'className') {
+            applySerializeAttr(el, 'class', mergeClassParts(raw));
+            return;
+        }
+        if (name === 'style') {
+            applySerializeAttr(el, 'style', mergeStyleParts(raw));
+            return;
+        }
         applySerializeAttr(el, name, raw);
     },
     bindComponentProp() {
@@ -677,7 +700,17 @@ const serializeApi = {
         // serializeApi.component returns a serialize el tree (or island shell).
         const root = hostEl.__kind === 'el' ? hostEl : null;
         const findOwnedSlot = (n) => {
-            if (!n || n.__kind !== 'el')
+            if (!n || typeof n !== 'object')
+                return null;
+            if (n.__kind === 'frag') {
+                for (const c of n.children || []) {
+                    const hit = findOwnedSlot(c);
+                    if (hit)
+                        return hit;
+                }
+                return null;
+            }
+            if (n.__kind !== 'el')
                 return null;
             if (n.tag === 'slot' && !(n.attrs && n.attrs.name))
                 return n;
@@ -690,26 +723,52 @@ const serializeApi = {
             }
             return null;
         };
+        const findOwnedSlotTarget = (n) => {
+            const slot = findOwnedSlot(n);
+            if (slot)
+                return slot;
+            if (!n || n.__kind !== 'el')
+                return null;
+            const tag = String(n.tag || '').toLowerCase();
+            if ((tag === 'button' || tag === 'a') && n.attrs && n.attrs['data-vmz-ui'] === 'button')
+                return n;
+            if (n.attrs && n.attrs['data-vmz'] != null)
+                return null;
+            for (const c of n.children || []) {
+                if (c && c.__kind === 'el' && c.attrs && c.attrs['data-vmz'] != null)
+                    continue;
+                const hit = findOwnedSlotTarget(c);
+                if (hit)
+                    return hit;
+            }
+            return null;
+        };
         // Prefer searching the component body (first child of host wrapper).
-        let slot = null;
+        let target = null;
         if (root) {
             for (const c of root.children || []) {
                 if (c && c.__kind === 'el' && c.attrs && c.attrs['data-vmz'] != null)
                     continue;
-                slot = findOwnedSlot(c);
-                if (slot)
+                target = findOwnedSlotTarget(c);
+                if (target)
                     break;
             }
-            if (!slot)
-                slot = findOwnedSlot(root);
+            if (!target)
+                target = findOwnedSlotTarget(root);
         }
-        if (slot) {
-            slot.__rawHtml = null;
-            if (!Array.isArray(slot.children))
-                slot.children = [];
-            // Append ??multiple projectDefaultSlot calls must accumulate (SSR).
-            // Client path replaces the live <slot> then appends siblings; serialize must push.
-            slot.children.push(node);
+        if (target) {
+            if (target.tag === 'slot') {
+                target.__rawHtml = null;
+                if (!Array.isArray(target.children))
+                    target.children = [];
+                // Append ??multiple projectDefaultSlot calls must accumulate (SSR).
+                // Client path replaces the live <slot> then appends siblings; serialize must push.
+                target.children.push(node);
+                return;
+            }
+            if (!Array.isArray(target.children))
+                target.children = [];
+            target.children.push(node);
             return;
         }
         if (root)
@@ -833,6 +892,22 @@ function applySerializeAttr(el, name, value) {
     if (!el || el.__kind !== 'el')
         return;
     const key = name === 'className' ? 'class' : name;
+    if (key === 'class') {
+        const s = mergeClassParts(value);
+        if (s)
+            el.attrs[key] = s;
+        else
+            delete el.attrs[key];
+        return;
+    }
+    if (key === 'style') {
+        const s = mergeStyleParts(value);
+        if (s)
+            el.attrs[key] = s;
+        else
+            delete el.attrs[key];
+        return;
+    }
     if (BOOLEAN_HTML_ATTRS.has(String(key).toLowerCase())) {
         if (value === false || value == null || value === '')
             delete el.attrs[key];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vmz/core",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "type": "module",
   "description": "VMZ production runtime core — DOM / SSR / HTTP / WriteBarrier (no compiler)",
   "exports": {
@@ -70,12 +70,12 @@
     "linkedom": "^0.18.13"
   },
   "optionalDependencies": {
-    "@vmz/vmz-win32-x64": "0.2.0",
-    "@vmz/vmz-win32-arm64": "0.2.0",
-    "@vmz/vmz-darwin-x64": "0.2.0",
-    "@vmz/vmz-darwin-arm64": "0.2.0",
-    "@vmz/vmz-linux-x64": "0.2.0",
-    "@vmz/vmz-linux-arm64": "0.2.0"
+    "@vmz/vmz-win32-x64": "0.2.2",
+    "@vmz/vmz-win32-arm64": "0.2.2",
+    "@vmz/vmz-darwin-x64": "0.2.2",
+    "@vmz/vmz-darwin-arm64": "0.2.2",
+    "@vmz/vmz-linux-x64": "0.2.2",
+    "@vmz/vmz-linux-arm64": "0.2.2"
   },
   "publishConfig": {
     "access": "public"