streetui 1.6.0 → 1.7.0

package/dist/{server-C2xovHHb.d.cts → server-D4A8eunr.d.cts}

@@ -1,4 +1,4 @@
-import { C as CompiledApplication } from './compile-CEom4hkp.cjs';
+import { C as CompiledApplication } from './compile-Cte0nf06.cjs';
 
 /**
  * DOMAdapter — framework-owned abstraction over DOM operations.
@@ -11,6 +11,13 @@ interface DOMAdapter {
     createTextNode(data: string): Text;
     createComment(data: string): Comment;
     createFragment(): DocumentFragment;
+    /**
+     * Optional, server-only: create a verbatim pre-serialized HTML node used by
+     * the v1.7 static SSR plan. The browser adapter does not implement it; the
+     * renderer only calls it when a static SSR plan is active (i.e. during SSR),
+     * so client builds never reach this path and it stays tree-shakeable.
+     */
+    createRawHTML?(html: string): Node;
     appendChild(parent: Node, child: Node): void;
     insertBefore(parent: Node, child: Node, reference: Node | null): void;
     removeChild(parent: Node, child: Node): void;
@@ -31,6 +38,18 @@ interface DOMAdapter {
      * focus) this is a safe no-op, keeping focus management SSR-compatible.
      */
     focus(element: Element): void;
+    /**
+     * The document body — the default mount target for portals/overlays. Returns
+     * null on the server (no document), which is what makes portal SSR degrade to
+     * inline rendering and focus management degrade to a no-op.
+     */
+    body(): Element | null;
+    /** The currently focused element, or null on the server / when none is focused. */
+    activeElement(): Element | null;
+    /** True if `ancestor` contains `node` (inclusive). Always false on the server. */
+    contains(ancestor: Element, node: Node): boolean;
+    /** True if `element` matches the given CSS selector. Always false on the server. */
+    matches(element: Element, selector: string): boolean;
     isElement(node: Node): node is Element;
     isTextNode(node: Node): node is Text;
     /** Lower-cased tag name of an element (e.g. "div", "h1"). */
@@ -62,6 +81,13 @@ declare class ServerDOMAdapter implements DOMAdapter {
     createTextNode(data: string): Text;
     createComment(data: string): Comment;
     createFragment(): DocumentFragment;
+    /**
+     * Create a verbatim pre-serialized HTML node (v1.7 static SSR plan, §6).
+     * Server-only: the browser adapter does not implement this, and the renderer
+     * fast path only invokes it when a static SSR plan is present (SSR). The
+     * stored HTML was produced by this same serializer, so it is emitted as-is.
+     */
+    createRawHTML(html: string): Node;
     appendChild(parent: Node, child: Node): void;
     insertBefore(parent: Node, child: Node, reference: Node | null): void;
     removeChild(parent: Node, child: Node): void;
@@ -79,6 +105,10 @@ declare class ServerDOMAdapter implements DOMAdapter {
     querySelectorAll(): NodeListOf<Element>;
     getElementById(): Element | null;
     focus(): void;
+    body(): Element | null;
+    activeElement(): Element | null;
+    contains(_ancestor: Element, _node: Node): boolean;
+    matches(_element: Element, _selector: string): boolean;
     isElement(node: Node): node is Element;
     isTextNode(node: Node): node is Text;
     tagName(element: Element): string;
@@ -152,6 +182,18 @@ interface RenderToStringOptions {
      * `ServerDOMAdapter` per call so concurrent renders never share state.
      */
     readonly domAdapter?: ServerDOMAdapter;
+    /**
+     * @internal — testing/benchmark knob for the v1.7 static SSR plan.
+     *
+     * `undefined` (default): use the per-app cached plan (build once, reuse).
+     * `null`: disable the plan entirely — the exact v1.6 runtime mount path, used
+     *   by the byte-identity gate and A/B benchmark as the "legacy" baseline.
+     * a map: use this explicit plan.
+     *
+     * Not part of the supported public API; output is byte-identical regardless
+     * of this value (§8).
+     */
+    readonly staticPlan?: ReadonlyMap<string, string> | null;
 }
 /**
  * Render a compiled StreetUI application to an HTML string.

package/dist/{server-xU-BEwAj.d.ts → server-cgmCiPsz.d.ts}

@@ -1,4 +1,4 @@
-import { C as CompiledApplication } from './compile-CEom4hkp.js';
+import { C as CompiledApplication } from './compile-Cte0nf06.js';
 
 /**
  * DOMAdapter — framework-owned abstraction over DOM operations.
@@ -11,6 +11,13 @@ interface DOMAdapter {
     createTextNode(data: string): Text;
     createComment(data: string): Comment;
     createFragment(): DocumentFragment;
+    /**
+     * Optional, server-only: create a verbatim pre-serialized HTML node used by
+     * the v1.7 static SSR plan. The browser adapter does not implement it; the
+     * renderer only calls it when a static SSR plan is active (i.e. during SSR),
+     * so client builds never reach this path and it stays tree-shakeable.
+     */
+    createRawHTML?(html: string): Node;
     appendChild(parent: Node, child: Node): void;
     insertBefore(parent: Node, child: Node, reference: Node | null): void;
     removeChild(parent: Node, child: Node): void;
@@ -31,6 +38,18 @@ interface DOMAdapter {
      * focus) this is a safe no-op, keeping focus management SSR-compatible.
      */
     focus(element: Element): void;
+    /**
+     * The document body — the default mount target for portals/overlays. Returns
+     * null on the server (no document), which is what makes portal SSR degrade to
+     * inline rendering and focus management degrade to a no-op.
+     */
+    body(): Element | null;
+    /** The currently focused element, or null on the server / when none is focused. */
+    activeElement(): Element | null;
+    /** True if `ancestor` contains `node` (inclusive). Always false on the server. */
+    contains(ancestor: Element, node: Node): boolean;
+    /** True if `element` matches the given CSS selector. Always false on the server. */
+    matches(element: Element, selector: string): boolean;
     isElement(node: Node): node is Element;
     isTextNode(node: Node): node is Text;
     /** Lower-cased tag name of an element (e.g. "div", "h1"). */
@@ -62,6 +81,13 @@ declare class ServerDOMAdapter implements DOMAdapter {
     createTextNode(data: string): Text;
     createComment(data: string): Comment;
     createFragment(): DocumentFragment;
+    /**
+     * Create a verbatim pre-serialized HTML node (v1.7 static SSR plan, §6).
+     * Server-only: the browser adapter does not implement this, and the renderer
+     * fast path only invokes it when a static SSR plan is present (SSR). The
+     * stored HTML was produced by this same serializer, so it is emitted as-is.
+     */
+    createRawHTML(html: string): Node;
     appendChild(parent: Node, child: Node): void;
     insertBefore(parent: Node, child: Node, reference: Node | null): void;
     removeChild(parent: Node, child: Node): void;
@@ -79,6 +105,10 @@ declare class ServerDOMAdapter implements DOMAdapter {
     querySelectorAll(): NodeListOf<Element>;
     getElementById(): Element | null;
     focus(): void;
+    body(): Element | null;
+    activeElement(): Element | null;
+    contains(_ancestor: Element, _node: Node): boolean;
+    matches(_element: Element, _selector: string): boolean;
     isElement(node: Node): node is Element;
     isTextNode(node: Node): node is Text;
     tagName(element: Element): string;
@@ -152,6 +182,18 @@ interface RenderToStringOptions {
      * `ServerDOMAdapter` per call so concurrent renders never share state.
      */
     readonly domAdapter?: ServerDOMAdapter;
+    /**
+     * @internal — testing/benchmark knob for the v1.7 static SSR plan.
+     *
+     * `undefined` (default): use the per-app cached plan (build once, reuse).
+     * `null`: disable the plan entirely — the exact v1.6 runtime mount path, used
+     *   by the byte-identity gate and A/B benchmark as the "legacy" baseline.
+     * a map: use this explicit plan.
+     *
+     * Not part of the supported public API; output is byte-identical regardless
+     * of this value (§8).
+     */
+    readonly staticPlan?: ReadonlyMap<string, string> | null;
 }
 /**
  * Render a compiled StreetUI application to an HTML string.