@wcstack/state 3.5.4 → 4.0.0-rc.2

package/dist/manifest.d.ts

@@ -30,83 +30,45 @@ interface IFilterMeta {
 /** 組み込みフィルタ名 → 構造化メタデータ。キー集合は builtinFilters と一致しなければならない。 */
 declare const builtinFilterMeta: Record<string, IFilterMeta>;
 
-/**
- * filters/filterAliases.ts — 組み込みフィルタの旧名 → 正式名（要件 B12・docs/state-3x-naming.ja.md V1〜V9）。
- *
- * 旧名は 3.x の間エイリアスとして残り、4.0 で外す（D4）。解決は登録簿（core/filterRegistry）が行い、
- * 実装・引数の個数・メタデータは正式名だけが持つ。formats の install と manifest（tooling）の両方が読むので、
- * 実装にもメタデータにも依存しない小さな表として独立させている。
- */
-declare const builtinFilterAliases: Readonly<Record<string, string>>;
-
-declare const DECLARATION_ALIASES: Readonly<Record<string, string>>;
-
 type BindingType = 'text' | 'prop' | 'event' | 'for' | 'if' | 'elseif' | 'else' | 'radio' | 'checkbox' | 'spread';
+/** Bindings that must be the only binding of their attribute value. */
+declare const STRUCTURAL_BINDING_TYPE_SET: ReadonlySet<BindingType>;
 
-declare const STRUCTURAL_BINDING_TYPE_SET: Set<BindingType>;
-
-/**
- * マニフェストのバージョン（構造を変えたら上げる）。
- *
- * 3.1 で `syntax.bindingTypes.explicitPropertyPrefix`、3.2 で `filterAliases`、
- * 3.x の次で `declarationAliases` / `apiAliases` を足したので 2。
- * 消費側（vscode-wcs）はまだこの定数を参照していないが、公開している以上ドリフトさせない。
- */
+/** The manifest's shape version (the same shape as 3.x). */
 declare const WCS_MANIFEST_VERSION = 2;
-/**
- * state API の旧名 → 正式名（要件 B12・docs/state-3x-naming.ja.md）。正本は
- * `proxy/traps/get.ts` の case ラベルで、ここはそれを機械可読にした写し
- * （一致は `__tests__/manifest.test.ts` が固定する）。
- */
+/** Filter old names → canonical (3.2): removed in 4.0. */
+declare const builtinFilterAliases: Readonly<Record<string, string>>;
+/** Declaration-key old names → canonical (3.2): removed in 4.0 (`$streams` fails as `[wcs/declaration-alias]`). */
+declare const DECLARATION_ALIASES: Readonly<Record<string, string>>;
+/** State API old names → canonical (3.2): removed in 4.0 (`$trackDependency` fails as `[wcs/name-alias]`). */
 declare const STATE_API_ALIASES: Readonly<Record<string, string>>;
 interface IWcsManifest {
     version: number;
     syntax: {
-        /** バインド属性名（既定 data-wcs） */
         bindAttribute: string;
-        /** タグ名（既定 wcs-state） */
         tagName: string;
-        /** パス区切り（`.`） */
         pathDelimiter: string;
-        /** ワイルドカード（`*`） */
         wildcard: string;
-        /** バインディング構文 `[prop][#mod]: [path][|filter...]` の区切り文字 */
         delimiters: {
             binding: string;
             propValue: string;
             modifier: string;
             filter: string;
         };
-        /** 構造ディレクティブ（`<template data-wcs="for: ...">` 等） */
         structuralDirectives: readonly string[];
-        /**
-         * 修飾子（`#` 後）の語彙。flags は値を取らない形（`#prevent`）、keyValue は
-         * `=` で値を取る形（`#init=element`）、eventNamePrefix は `on` + イベント名の形
-         * （`#onchange` — two-way / radio / checkbox のイベント名上書き。README「Modifiers」）。
-         * define.ts の定数が単一正本で、ランタイムの消費箇所も同じ定数に分岐する。
-         */
         modifiers: {
             flags: readonly string[];
             keyValue: readonly string[];
             eventNamePrefix: string;
         };
-        /** リストインデックス参照名（`$1`..`$N`）。prefix + 1 始まり連番、maxDepth まで。 */
         indexParam: {
             prefix: string;
             maxDepth: number;
         };
-        /**
-         * bindingType 判別の語彙（parseBindTextsForElement の分岐と同一の定数から導出）。
-         * 判別順: else → spread → 構造ディレクティブ/radio/checkbox → eventToken・`on*`
-         * （event）→ prop。propNamespaces は左辺先頭セグメントの特殊 namespace で、
-         * apply 層のディスパッチキー集合との一致はテストが強制する。
-         * 既知の未収載: `radio` / `checkbox`（BindingType union のみが正本）。
-         */
         bindingTypes: {
             elseKeyword: string;
             spread: string;
             eventPropertyPrefix: string;
-            /** 左辺の先頭に付けると、名前が `on` で始まってもイベントにしない明示のプロパティ形（`.online:`、要件 B5） */
             explicitPropertyPrefix: string;
             propNamespaces: {
                 eventToken: string;
@@ -117,27 +79,24 @@ interface IWcsManifest {
             };
         };
     };
-    /** 組み込みフィルタ名（builtinFilters から自動導出＝実装が正本） */
+    /** The built-in filter names: the core set, then the formats add-on's. */
     filters: string[];
-    /** 組み込みフィルタの構造化メタデータ（説明・引数仕様・型）。vscode-wcs の手リスト撤去用。 */
     filterMeta: Record<string, IFilterMeta>;
-    /** 組み込みフィルタの旧名 → 正式名（要件 B12）。旧名も解決するが、ツールは正式名を提案する */
     filterAliases: Readonly<Record<string, string>>;
-    /**
-     * 宣言キーの旧名 → 正式名（要件 B12。`$updatedCallback` → `$renderedCallback`、
-     * `$streams` → `$stream`）。ランタイムは旧名も受けるが、ツールは正式名を提案する。
-     * `reservedLifecycle` / `reservedStateApi` は**正式名だけ**なので、旧名が予約かどうかは
-     * この表と併せて判断する
-     */
     declarationAliases: Readonly<Record<string, string>>;
-    /** state API の旧名 → 正式名（`$trackDependency` → `$dependOn` 等、要件 B12） */
     apiAliases: Readonly<Record<string, string>>;
-    /** 予約ライフサイクルフック名（正式名のみ。旧名は `declarationAliases` を見る） */
+    /** Reserved lifecycle hooks. */
     reservedLifecycle: readonly string[];
-    /** 予約 state API（プロトコル系の `$` 名前空間。正式名のみ） */
+    /** Reserved state keys and `$` namespaces. */
     reservedStateApi: readonly string[];
+    /** A state's `$behavior` options (4.0): each key, the type of its value and its value when left out. */
+    behaviorOptions: Readonly<Record<string, {
+        type: "boolean";
+        default: boolean;
+    }>>;
+    /** The add-on names `$features` and the root `<wcs-state features>` take (4.0). */
+    features: readonly string[];
 }
-/** 機械可読な単一正本を返す。vscode-wcs はこれを消費する想定。 */
 declare function getWcsManifest(): IWcsManifest;
 
 export { DECLARATION_ALIASES, STATE_API_ALIASES, STRUCTURAL_BINDING_TYPE_SET, WCS_MANIFEST_VERSION, builtinFilterAliases, builtinFilterMeta, getWcsManifest };