@wcstack/state 1.32.0 → 2.0.0

package/dist/index.d.ts

@@ -98,14 +98,6 @@ interface IStateElement {
      * optional なのはテスト用モック互換のため（undefined は「不明＝未初期化扱い」）。
      */
     readonly initialized?: boolean;
-    /**
-     * この state element が今使えるか（＝ 接続済みで rootNode を保持しているか）。
-     * `createState` は rootNode を要求するので、false のときに呼ぶと raiseError する。
-     * 台帳に載っていること（登録済み）と使えることは別で、要素をキーにした台帳には
-     * 切断済みの state element が残る窓がある（§1.9）。
-     * optional なのはテスト用モック互換のため（undefined は「不明＝使える扱い」）。
-     */
-    readonly hasRootNode?: boolean;
     readonly initializePromise: Promise<void>;
     readonly connectedCallbackPromise: Promise<void>;
     readonly listPaths: Set<string>;
@@ -122,15 +114,34 @@ interface IStateElement {
      * `bind-component` で束ねられているコンポーネント要素（親スコープ側のノード）。
      * マッピング規則の引き当てに使う。optional なのはテスト用モック互換のため。
      */
-    readonly boundComponent?: Element | null;
     /**
      * この state の実体が innerState proxy（＝ 値の正本が親スコープの state にある
      * mapped な `bind-component`）か。真のときだけ越境アドレスの受け渡しと
      * リストパスの外向き伝播が働く（§1.8）。
      * optional なのはテスト用モック互換のため（undefined は plain 扱い）。
      */
-    readonly hasMappedComponentState?: boolean;
-    markComponentStateMapped?(): void;
+    /**
+     * この state element にマウント（Phase 2 の単一ツリー — webComponent/mount.ts）が
+     * 1 つでも登録されているか。偽のとき getByAddress / isCacheable / `$n` 補正は
+     * boolean 判定 1 個でオーバーレイ経路を抜ける（設計書 D18）。
+     * optional なのはテスト用モック互換のため（undefined は「マウント無し」扱い）。
+     */
+    readonly hasMounts?: boolean;
+    markHasMounts?(): void;
+    /**
+     * この state element に接ぎ木済みのボリューム（`mount=` — webComponent/volume.ts）が
+     * 1 つでもあるか。偽のとき setByAddress の D22 後段ガード（マウントポイントを含む
+     * 親の丸ごと書き検査）は boolean 判定 1 個で抜ける（設計書 D18 と同じ形）。
+     * optional なのはテスト用モック互換のため（undefined は「ボリューム無し」扱い）。
+     */
+    readonly hasGraftedVolumes?: boolean;
+    markHasGraftedVolumes?(): void;
+    /**
+     * この state 要素に束ねられた（`setPathInfo` を通った）パスの集合。丸ごとマウント
+     * （ルート規則）の親→子通知が「登録済みパス全部を読み直せ」を組み立てるのに使う
+     * （webComponent/rootReloadPaths.ts）。
+     * optional なのはテスト用モック互換のため（undefined は「登録なし」扱い）。
+     */
     /**
      * DCC の `$bindables` から生成した「パス → 変更イベント名」表。
      * 唯一の書き手は defineDCC で、読み手は setByAddress。
@@ -184,13 +195,20 @@ interface IStateElement {
      * `source` は存在検査の診断 code と適用範囲を決める（pathDiagnostics.ts）。
      * 省略時は `"binding"`（テスト用モック互換のため optional）。
      */
+    /** ボリュームの宣言面の合流（webComponent/volume.ts 専用・実装は State のみ） */
+    addVolumeWatchPaths?(paths: ReadonlySet<string>): void;
+    mergeVolumeListKeys?(entries: ReadonlyMap<string, ListKeySpec>): void;
+    enableUpdatedCallback?(): void;
+    /** enable-ssr スナップショットから初期化されたか（D14）。 */
+    readonly hydratedFromSsr?: boolean;
+    /** ボリュームのアクセサ登録（webComponent/volume.ts 専用） */
+    defineTreeAccessor(path: string, descriptor: PropertyDescriptor): void;
     setPathInfo(path: string, bindingType: BindingType, source?: PathInfoSource): void;
     addStaticDependency(parentPath: string, childPath: string): boolean;
     addDynamicDependency(fromPath: string, toPath: string): boolean;
     createStateAsync(mutability: Mutability, callback: (state: IStateProxy) => Promise<void>): Promise<void>;
     createState(mutability: Mutability, callback: (state: IStateProxy) => void): void;
     nextVersion(): number;
-    bindProperty(prop: string, desc: PropertyDescriptor): void;
     setInitialState(state: Record<string, any>): void;
 }
 
@@ -225,7 +243,6 @@ interface IStateAddress {
     readonly parentAddress: IStateAddress | null;
 }
 interface IAbsolutePathInfo {
-    readonly stateName: string;
     readonly stateElement: IStateElement;
     readonly pathInfo: IPathInfo;
     readonly parentAbsolutePathInfo: IAbsolutePathInfo | null;
@@ -269,7 +286,6 @@ interface IParsedBinding {
     readonly propModifiers: string[];
     readonly statePathName: string;
     readonly statePathInfo: IPathInfo;
-    readonly stateName: string;
     readonly inFilters: IFilterInfo[];
     readonly outFilters: IFilterInfo[];
     readonly bindingType: BindingType;
@@ -364,7 +380,6 @@ declare function getBindingsReady(rootNode: Node): Promise<void>;
 declare const HTMLElementBase: typeof HTMLElement;
 
 interface ISsrElement {
-    readonly name: string;
     readonly version: string;
     readonly stateData: IState;
     readonly templates: Map<string, HTMLTemplateElement>;
@@ -376,7 +391,6 @@ declare class Ssr extends HTMLElementBase implements ISsrElement {
     private _stateData;
     private _templates;
     private _hydrateProps;
-    get name(): string;
     get version(): string;
     get stateData(): IState;
     get templates(): Map<string, HTMLTemplateElement>;
@@ -393,7 +407,7 @@ declare class Ssr extends HTMLElementBase implements ISsrElement {
     private _loadStateData;
     private _loadTemplates;
     private _loadHydrateProps;
-    static findByName(root: Node, name: string): ISsrElement | null;
+    static find(root: Node): ISsrElement | null;
     /**
      * stateData と構造テンプレート・プロパティから <wcs-ssr> の中身を構築する。
      * server パッケージの renderToString から呼ばれる。
@@ -751,12 +765,11 @@ interface IWcsManifest {
         pathDelimiter: string;
         /** ワイルドカード（`*`） */
         wildcard: string;
-        /** バインディング構文 `[prop][#mod]: [path][@state][|filter...]` の区切り文字 */
+        /** バインディング構文 `[prop][#mod]: [path][|filter...]` の区切り文字 */
         delimiters: {
             binding: string;
             propValue: string;
             modifier: string;
-            stateName: string;
             filter: string;
         };
         /** 構造ディレクティブ（`<template data-wcs="for: ...">` 等） */
@@ -821,12 +834,10 @@ declare function getWcsManifest(): IWcsManifest;
 
 type DevtoolsEvent = {
     readonly type: "state:element-registered";
-    readonly name: string;
     readonly rootNode: Node;
     readonly element: IStateElement;
 } | {
     readonly type: "state:element-unregistered";
-    readonly name: string;
     readonly rootNode: Node;
     readonly element: IStateElement;
 } | {
@@ -853,7 +864,6 @@ type DevtoolsEvent = {
 } | {
     readonly type: "state:token-emit";
     readonly kind: "command" | "event";
-    readonly stateName: string | null;
     readonly tokenName: string;
     readonly args: readonly unknown[];
     readonly subscriberCount: number;
@@ -861,7 +871,6 @@ type DevtoolsEvent = {
     readonly type: "state:watch-error";
     /** throw 元。cur の評価（getter）とハンドラ本体では原因も直し方も違う */
     readonly phase: "prime" | "evaluate" | "handler";
-    readonly stateName: string;
     /** `$watch` の宣言キー（ワイルドカードを含む生のパス） */
     readonly path: string;
     readonly error: unknown;
@@ -872,21 +881,18 @@ type DevtoolsEvent = {
     readonly paths: readonly string[];
 } | {
     readonly type: "state:watch-fired";
-    readonly stateName: string;
     /** `$watch` の宣言キー（ワイルドカードを含む生のパス） */
     readonly path: string;
 } | {
     readonly type: "state:path-unresolved";
     /** 書き手が書いた面。診断 code が binding / watch で変わる */
     readonly source: "binding" | "watch";
-    readonly stateName: string;
     /** 宣言されたパス（ワイルドカードを含む生の文字列） */
     readonly path: string;
     /** 解決に失敗したセグメント */
     readonly missingSegment: string;
 } | {
     readonly type: "state:binding-apply-error";
-    readonly stateName: string;
     /** バインディングの state パス（ワイルドカードを含む生の文字列） */
     readonly path: string;
     readonly bindingType: string;
@@ -979,5 +985,168 @@ interface IContractManifest {
  */
 declare function analyzeContract(manifest: IContractManifest): readonly ContractEvent[];
 
+declare class State extends HTMLElementBase implements IStateElement {
+    static hasConnectedCallbackPromise: boolean;
+    static getBindingsReady(rootNode: Node): Promise<void>;
+    private __state;
+    private _hasUpdatedCallback;
+    /** enable-ssr のスナップショットから初期化された（D14: ボリュームはデータを採用する） */
+    private _hydratedFromSsr;
+    private _crossRowListPaths;
+    private _indexDependentGetterPaths;
+    private _name;
+    private _initialized;
+    private _initializePromise;
+    private _resolveInitialize;
+    private _connectedCallbackPromise;
+    private _resolveConnectedCallback;
+    private _rejectConnectedCallback;
+    private _loadingPromise;
+    private _resolveLoading;
+    private _setStatePromise;
+    private _resolveSetState;
+    private _listPaths;
+    private _listKeys;
+    private _elementPaths;
+    private _getterPaths;
+    private _setterPaths;
+    private _loopContextStack;
+    private _dynamicDependency;
+    private _staticDependency;
+    private _pathSet;
+    private _watchPaths;
+    private _version;
+    private _rootNode;
+    private _boundComponent;
+    private _boundComponentStateProp;
+    private _hasMounts;
+    private _hasGraftedVolumes;
+    /** ボリューム（mount=）: 接ぎ木済みの控え（$disconnectedCallback 用） */
+    private _volumeGraftInfo;
+    /** ボリューム: スロット予約済み・接ぎ木進行中（ロード完了前の再接続の再入ガード） */
+    private _volumeInitializing;
+    /** v2 マウント（Phase 2）: この bind-component 要素が構築したマウント記録 */
+    private _mountRecord;
+    private _bindableEventMap;
+    private _commandTokenNames;
+    private _eventTokenNames;
+    private _dcc;
+    private _connectGeneration;
+    private _streamsStartedGeneration;
+    constructor();
+    private get _state();
+    private set _state(value);
+    get name(): string;
+    private _loadFromSsrElement;
+    /** state / src / json / inner <script> / API set のソース解決（_initialize とボリュームで共用）。 */
+    private _loadStateFromSource;
+    /**
+     * ボリューム（`<wcs-state mount="path">`）: 独立ツリーを持たず、ロード完了で
+     * ルートに接ぎ木する（webComponent/volume.ts）。接続時にスロットを予約（D22）。
+     * ルートより先に接続されてもよい — ルート登録が保留分を引き取る（V5）。
+     */
+    private _initializeVolume;
+    private _initialize;
+    /**
+     * 設定エラーでの fail-fast。initializePromise 等を解決してから raise する —
+     * 未解決のまま投げると waitForStateInitialize（ホストの buildBindings）が
+     * この要素を待ち続け、**ページ全体が無言でウェッジする**（1 つの設定ミスが
+     * 無関係なバインディングまで道連れにする）。エラー自体は unhandled rejection
+     * として loud に残る。
+     */
+    private _failInitialization;
+    private _initializeBindWebComponent;
+    private _callStateConnectedCallback;
+    private _initializeDCC;
+    private _callStateDisconnectedCallback;
+    connectedCallback(): Promise<void>;
+    disconnectedCallback(): void;
+    get initialized(): boolean;
+    get initializePromise(): Promise<void>;
+    get connectedCallbackPromise(): Promise<void>;
+    get listPaths(): Set<string>;
+    get listKeys(): ListKeyMap | null;
+    get watchPaths(): ReadonlySet<string> | null;
+    get elementPaths(): Set<string>;
+    /**
+     * ボリューム（webComponent/volume.ts）のアクセサ登録: ツリーパスをキーにした
+     * quoted-path アクセサを state オブジェクトに定義し、getter / setter 台帳と
+     * 依存グラフに載せる。ルートのワイルドカード getter（`"children.*.label"`）と
+     * 同じ機構に乗るので、評価は pushAddress 下・依存はグラフに載る。
+     */
+    /** ボリュームの watch パスをホットパス用ゲート（watchPaths）へ合流させる。 */
+    addVolumeWatchPaths(paths: ReadonlySet<string>): void;
+    /** ボリュームの $listKeys（接頭辞翻訳済み）をルートの表へ合流させる。衝突は設定ミス。 */
+    mergeVolumeListKeys(entries: ReadonlyMap<string, ListKeySpec>): void;
+    /** ボリュームが $updatedCallback を持つとき、収集ゲートを開ける（apply/applyChange.ts）。 */
+    enableUpdatedCallback(): void;
+    /** enable-ssr スナップショットから初期化されたか（D14 — webComponent/volume.ts が読む）。 */
+    get hydratedFromSsr(): boolean;
+    defineTreeAccessor(path: string, descriptor: PropertyDescriptor): void;
+    get getterPaths(): Set<string>;
+    get setterPaths(): Set<string>;
+    get loopContextStack(): ILoopContextStack;
+    get dynamicDependency(): Map<string, string[]>;
+    get staticDependency(): Map<string, string[]>;
+    get version(): number;
+    get rootNode(): Node;
+    get boundComponentStateProp(): string | null;
+    get hasMounts(): boolean;
+    /** 唯一の呼び手は webComponent/mount.ts の registerMountRecord（Phase 2）。 */
+    markHasMounts(): void;
+    get hasGraftedVolumes(): boolean;
+    /** 唯一の呼び手は webComponent/volume.ts の graftVolume（D22 後段のガードが読む）。 */
+    markHasGraftedVolumes(): void;
+    get bindableEventMap(): Record<string, string>;
+    get commandTokenNames(): ReadonlySet<string>;
+    get eventTokenNames(): ReadonlySet<string>;
+    setBindableEventMap(map: Record<string, string>): void;
+    private _addDependency;
+    /**
+     * source,           target
+     *
+     * products.*.price => products.*.tax
+     * get "products.*.tax"() { return this["products.*.price"] * 0.1; }
+     *
+     * products.*.price => products.summary
+     * get "products.summary"() { return this.$getAll("products.*.price", []).reduce(sum); }
+     *
+     * categories.*.name => categories.*.products.*.categoryName
+     * get "categories.*.products.*.categoryName"() { return this["categories.*.name"]; }
+     *
+     * @param sourcePath
+     * @param targetPath
+     */
+    addDynamicDependency(sourcePath: string, targetPath: string): boolean;
+    /**
+     * source,      target
+     * products => products.*
+     * products.* => products.*.price
+     * products.* => products.*.name
+     *
+     * @param sourcePath
+     * @param targetPath
+     */
+    addStaticDependency(sourcePath: string, targetPath: string): boolean;
+    setPathInfo(path: string, bindingType: BindingType, source?: PathInfoSource): void;
+    private _createState;
+    createStateAsync(mutability: Mutability, callback: (state: IStateProxy) => Promise<void>): Promise<void>;
+    createState(mutability: Mutability, callback: (state: IStateProxy) => void): void;
+    nextVersion(): number;
+    get hasUpdatedCallback(): boolean;
+    get crossRowListPaths(): ReadonlySet<string>;
+    addCrossRowListPath(path: string): void;
+    get indexDependentGetterPaths(): ReadonlySet<string>;
+    addIndexDependentGetterPath(path: string): void;
+    setInitialState(state: Record<string, any>): void;
+}
+
+declare global {
+    interface HTMLElementTagNameMap {
+        "wcs-state": State;
+        "wcs-ssr": Ssr;
+    }
+}
+
 export { Ssr, VERSION, WCS_MANIFEST_VERSION, analyzeContract, bootstrapState, buildBindings, builtinFilterMeta, defineState, getBindingsReady, getConfig, getWcsManifest };
 export type { ContractEvent, FilterArgType, FilterResultType, IContractManifest, IFilterMeta, ISsrElement, IWcsManifest, IWritableConfig, IWritableTagNames, WcsPathValue, WcsPaths, WcsStateApi, WcsThis };