@wcstack/state 3.4.0 → 3.5.0

package/dist/index.d.ts

@@ -799,6 +799,7 @@ interface IBindingErrorInfo {
 }
 interface IWritableConfig {
     bindAttributeName?: string;
+    /** @deprecated Removed in 4.0, whose `bootstrapState` throws on it (3.5 warns `wcs/v4-migration`). */
     commentTextPrefix?: string;
     commentForPrefix?: string;
     commentIfPrefix?: string;
@@ -806,11 +807,16 @@ interface IWritableConfig {
     commentElsePrefix?: string;
     tagNames?: IWritableTagNames;
     locale?: string;
+    /** @deprecated Removed in 4.0, whose `bootstrapState` throws on it (3.5 warns `wcs/v4-migration`). */
     debug?: boolean;
+    /** Moves to the state's `$behavior` in 4.0 (3.5 warns `wcs/v4-migration`); in 3.x, set it here. */
     enableMustache?: boolean;
+    /** Moves to the state's `$behavior` in 4.0 (3.5 warns `wcs/v4-migration`); in 3.x, set it here. */
     enableDirectionalInitialSync?: boolean;
+    /** @deprecated Removed in 4.0, whose `bootstrapState` throws on it (3.5 warns `wcs/v4-migration`). */
     enablePropagationContext?: boolean;
     enableContractAnalyzer?: boolean;
+    /** Moves to the state's `$behavior` in 4.0 (3.5 warns `wcs/v4-migration`); in 3.x, set it here. */
     sameValueGuard?: boolean;
 }
 
@@ -1670,7 +1676,23 @@ declare class State extends HTMLElementBase implements IStateElement {
     private set _state(value);
     attributeChangedCallback(_name: string, oldValue: string | null, newValue: string | null): void;
     private _loadFromSsrElement;
-    /** state / src / json / inner <script> / API set のソース解決（_initialize とボリュームで共用）。 */
+    /**
+     * state / src / json / inner <script> / API set のソース解決（_initialize とボリュームで共用）。
+     *
+     * A load failure is not wrapped, here or in the loaders: what was thrown propagates as is —
+     * the SyntaxError of `JSON.parse` (`state=` / `json=`), the `import()` rejection or the
+     * module's own throw (`src="*.js"`), the inline-script loader's Error (the import failure is
+     * its `cause`), the unsupported-extension error, or a non-Error value. On a root,
+     * `_failInitializeLoudly` logs it under the element's "failed to initialize" line and rejects
+     * connectedCallbackPromise with that same value (the README contract); on a volume,
+     * volumeLifecycle logs it under its "failed to load" line. The old wrappers
+     * (`Failed to initialize state: ${e}` here, `Failed to load script file` /
+     * `Failed to parse JSON from script element` in the loaders) were new Errors that kept the
+     * original only as text, losing its type, stack and cause.
+     *
+     * Two sources do not fail at all in 3.x (README): `src="*.json"` that cannot be fetched or
+     * parsed, and `state=` naming no JSON script. Both log and start with an empty state.
+     */
     private _loadStateFromSource;
     /**
      * 初回マウントのロードと登録。戻り値は「この接続で初期化を**完了**したか」で、