@wcstack/router 1.32.0 → 2.0.0

package/dist/index.d.ts

@@ -86,6 +86,13 @@ interface IRouteMatchResult {
     lastPath: string;
 }
 type GuardHandler = (toPath: string, fromPath: string) => boolean | Promise<boolean>;
+interface _ILayout {
+    readonly uuid: string;
+    readonly enableShadowRoot: boolean;
+    readonly name: string;
+    loadTemplate(): Promise<HTMLTemplateElement>;
+}
+type ILayout = _ILayout & Pick<Element, 'childNodes'>;
 type SegmentType = 'static' | 'param' | 'catch-all';
 interface ISegmentInfo {
     type: SegmentType;
@@ -188,6 +195,16 @@ interface IOutlet {
     readonly rootNode: HTMLElement | ShadowRoot;
     lastRoutes: IRoute[];
 }
+interface ILayoutOutlet {
+    layout: ILayout;
+    readonly name: string;
+    assignParams(params: Record<string, any>): void;
+}
+interface ILink {
+    readonly uuid: string;
+    readonly router: IRouter;
+    readonly anchorElement: HTMLAnchorElement | null;
+}
 
 /**
  * AppRoutes - Root component for @wcstack/router
@@ -500,5 +517,163 @@ declare class RouteCore extends EventTarget {
 
 declare const VERSION: string;
 
+declare class Outlet extends HTMLElement implements IOutlet {
+    private _routesNode;
+    private _lastRoutes;
+    private _initialized;
+    constructor();
+    get routesNode(): IRouter;
+    set routesNode(value: IRouter);
+    get rootNode(): HTMLElement | ShadowRoot;
+    get lastRoutes(): IRoute[];
+    set lastRoutes(value: IRoute[]);
+    /**
+     * shadowRoot 有効化判定。Layout と挙動を揃え、属性で個別オーバーライド可能にする。
+     * - `enable-shadow-root` 属性あり → true
+     * - `disable-shadow-root` 属性あり → false
+     * - いずれもなし → config.enableShadowRoot を尊重
+     */
+    private _resolveEnableShadowRoot;
+    private _initialize;
+    connectedCallback(): void;
+    /**
+     * Outlet が disconnect された際の状態クリーンアップ。
+     *
+     * `_lastRoutes` をクリアすることで、再接続後の applyRoute における diff
+     * （既に show 済みのルートは show を skip する判定）が、切断中に外部から
+     * 操作された DOM と整合しなくなる事故を防ぐ。
+     *
+     * 仕様前提として Outlet は Router と一体運用される（Router が `_getOutlet()` で
+     * 自身の兄弟に Outlet を配置・参照する）。それでも単独で再接続される
+     * エッジケースに備える防衛的措置として `_lastRoutes` のみクリアする。
+     * `_initialized` と shadowRoot は維持し、再 attachShadow による
+     * InvalidStateError を回避する。
+     */
+    disconnectedCallback(): void;
+}
+
+declare class Layout extends HTMLElement implements ILayout {
+    private _uuid;
+    constructor();
+    private _loadTemplateFromSource;
+    private _loadTemplateFromDocument;
+    loadTemplate(): Promise<HTMLTemplateElement>;
+    get uuid(): string;
+    get enableShadowRoot(): boolean;
+    get name(): string;
+}
+
+declare class LayoutOutlet extends HTMLElement implements ILayoutOutlet {
+    private _layout;
+    private _initialized;
+    private _initializing;
+    private _disconnectedDuringInit;
+    private _layoutChildNodes;
+    constructor();
+    get layout(): ILayout;
+    set layout(value: ILayout);
+    get name(): string;
+    private _initialize;
+    connectedCallback(): Promise<void>;
+    disconnectedCallback(): void;
+    assignParams(params: Record<string, any>): void;
+}
+
+declare class Link extends HTMLElement implements ILink {
+    static get observedAttributes(): string[];
+    private _childNodeArray;
+    private _uuid;
+    private _path;
+    private _router;
+    private _anchorElement;
+    private _initialized;
+    private _onClick?;
+    constructor();
+    get uuid(): string;
+    /**
+     * 最寄りの Router を返す。
+     *
+     * 注意: この getter は DOM 走査で Router を探すため、
+     * Router がまだ upgrade されていない場合は HTMLElement として返る可能性がある。
+     * 通常は registerComponents() で Router を Link より先に upgrade することを推奨する。
+     */
+    get router(): Router;
+    private _initialize;
+    /**
+     * URL pathname を正規化する。Router と共通実装を使うことで
+     * basenameFileExtensions の取り扱いを揃え、active 判定の取りこぼしを防ぐ。
+     */
+    private _normalizePathname;
+    private _joinInternalPath;
+    /**
+     * router が扱う内部ターゲットか。`/` 始まりに加え、`?` 始まり（クエリのみ遷移 —
+     * docs/router-state-contract-design.md §4.1）も内部ターゲットとして受理する。
+     */
+    private _isInternalTarget;
+    private _setAnchorHref;
+    connectedCallback(): void;
+    /**
+     * サーバーが生成した目印付き anchor（直後の兄弟）。クライアントの採用対象
+     */
+    private _findSsrAnchor;
+    private _connect;
+    disconnectedCallback(): void;
+    attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
+    private _updateActiveState;
+    get anchorElement(): HTMLAnchorElement | null;
+}
+
+declare class Head extends HTMLElement {
+    private _initialized;
+    private _childElementArray;
+    constructor();
+    private _initialize;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    get childElementArray(): Element[];
+    /**
+     * 要素の一意キーを生成（WeakMap でキャッシュ）
+     */
+    private _getKey;
+    /**
+     * 要素の一意キーを計算（実体）
+     */
+    private _computeKey;
+    /**
+     * head 内の要素を key で引ける Map を構築する。
+     * `_reapplyHead` のループ前に一度だけ呼び出し、O(N) lookup に置き換えるためのヘルパ。
+     *
+     * 設計仕様: 同一 key の要素が複数 `document.head` 内に存在する場合は **first-wins**
+     * （DOM 順で最初の要素のみ採用）。これは `_captureInitialHead` および
+     * `initialHeadValues` の挙動とも整合する。
+     * 重複は基本的にユーザーの記述ミスだが、_getKey の粒度（href/name 等の主要属性のみ）に
+     * よる「論理的重複」もあり得るため、サイレントに first-wins とする。
+     * 厳密な重複検出が必要な場合は呼び出し側で行う。
+     */
+    private _buildHeadElementMap;
+    /**
+     * 初期の<head>状態をキャプチャ
+     * document.head内の全ての要素をスキャンして保存する
+     */
+    private _captureInitialHead;
+    /**
+     * スタック全体からheadを再構築
+     * 後のHeadが優先される（上書き）
+     */
+    private _reapplyHead;
+}
+
+declare global {
+    interface HTMLElementTagNameMap {
+        "wcs-router": Router;
+        "wcs-route": Route;
+        "wcs-outlet": Outlet;
+        "wcs-layout": Layout;
+        "wcs-layout-outlet": LayoutOutlet;
+        "wcs-link": Link;
+        "wcs-head": Head;
+    }
+}
+
 export { Route, RouteCore, Router, VERSION, bootstrapRouter, getConfig };
 export type { IWritableConfig, IWritableTagNames, RouteParseOptions };

package/dist/index.esm.js

@@ -2234,6 +2234,12 @@ class Router extends HTMLElement {
             this._resolveConnectedCallback = resolve;
             this._rejectConnectedCallback = reject;
         });
+        // 初期化の失敗は reject として配管するが、この Promise は readiness プロトコルの
+        // 消費者（renderToString / @wcstack/testing の mount）が居るときだけ await される。
+        // 誰も await しない通常のページやユニットテストで reject を「未処理」として
+        // 報告させないよう、ここで観測済みにしておく。await する側には従来どおり
+        // reject が届く（別の consumer が付いても settled 結果は共有される）。
+        this._connectedCallbackPromise.catch(() => { });
     }
     get connectedCallbackPromise() {
         return this._connectedCallbackPromise;
@@ -2695,10 +2701,17 @@ class Router extends HTMLElement {
                 rootNode.appendChild(fragment);
             }
             await applyRoute(this, this.outlet, fullPath, this._path, window.location.search || "");
-            if (adoptable) {
-                // 描き直したノードを binder へ差し出す。state がサーバー DOM を既に
-                // ハイドレート済み（初期走査完了後）の場合、破棄と同時にそのバインドは
-                // 死んでおり、「初期描画は走査時に DOM に居る」前提も崩れているため。
+            if (adoptable || getBinder() !== null) {
+                // 初期描画の内容を binder へ差し出す。
+                // - adoptable（描き直し）: state がサーバー DOM を既にハイドレート済み（初期走査
+                //   完了後）の場合、破棄と同時にそのバインドは死んでいる。
+                // - binder が既に居る: state の初回走査が router の挿入より先に完了し得る
+                //   （`json=` の state は I/O 無しで走査を終える。/auto の文書順ではなく
+                //   bootstrap を先に済ませてから HTML を流し込むテストハーネス
+                //   — @wcstack/testing の mount() — で起きる。_renderForSsr と同じ理由）。
+                //   bind() は冪等なので、走査に間に合っていた分を再度渡しても壊れない。
+                // binder が居なければ渡さない: state を読まないページで保留キューに
+                // ノードを溜め続けないため（後から来る state は走査で拾う）。
                 this._offerInitialContentToBinder();
             }
             this._notifyLocationChange();
@@ -3015,7 +3028,25 @@ class Router extends HTMLElement {
         }
         if (!this._initialized) {
             this._disconnectedDuringInit = false;
-            await this._initialize();
+            try {
+                // ストリーミング型パーサ（happy-dom: `document.body.innerHTML = ...` の途中）は
+                // 開始タグの時点で connectedCallback を呼び、子（<template>）がまだ無い。
+                // SSR 経路と同じく 1 microtask 譲れば同期パースが完走して子が揃う。
+                // ブラウザの deferred なバンドルでは upgrade 時に子が揃っているので、
+                // template が既にあるときは譲らない（従来どおり）。
+                if (this._getTemplate() === null) {
+                    await Promise.resolve();
+                }
+                await this._initialize();
+            }
+            catch (error) {
+                // reject を配管しないと、初期化の失敗（template 無し・ルート定義無し・
+                // basename 不整合 …）が connectedCallbackPromise を永久に未決着にし、
+                // waitForReady（@wcstack/server / @wcstack/testing）が無言でハングする。
+                // SSR 経路と同じ扱いにする。
+                this._rejectConnectedCallback?.(error);
+                throw error;
+            }
             // 初期化中に disconnectedCallback が呼ばれた場合はイベントリスナを登録しない
             if (this._disconnectedDuringInit) {
                 this._resolveConnectedCallback?.();
@@ -3611,7 +3642,7 @@ function bootstrapRouter(config, registry) {
     registerComponents(registry);
 }
 
-var version = "1.32.0";
+var version = "2.0.0";
 var pkg = {
 	version: version};