@wcstack/state 1.15.0 → 1.16.0

package/dist/manifest.esm.js

@@ -0,0 +1,925 @@
+const _config = {
+    bindAttributeName: 'data-wcs',
+    tagNames: {
+        state: 'wcs-state'},
+    locale: 'en'};
+// backward compatible export (read-only usage)
+const config = _config;
+
+function raiseError(message) {
+    throw new Error(`[@wcstack/state] ${message}`);
+}
+
+/**
+ * errorMessages.ts
+ *
+ * Error message generation utilities used by filter functions.
+ *
+ * Main responsibilities:
+ * - Throws clear error messages when filter options or value type checks fail
+ * - Takes function name as argument to specify which filter caused the error
+ *
+ * Design points:
+ * - optionsRequired: Error when required option is not specified
+ * - optionMustBeNumber: Error when option value is not a number
+ * - valueMustBeNumber: Error when value is not a number
+ * - valueMustBeBoolean: Error when value is not boolean
+ * - valueMustBeDate: Error when value is not a Date
+ */
+/**
+ * Throws error when filter requires at least one option but none provided.
+ *
+ * @param fnName - Name of the filter function
+ * @returns Never returns (always throws)
+ */
+function optionsRequired(fnName) {
+    raiseError(`filter ${fnName} requires at least one option`);
+}
+/**
+ * Throws error when filter option must be a number but invalid value provided.
+ *
+ * @param fnName - Name of the filter function
+ * @returns Never returns (always throws)
+ */
+function optionMustBeNumber(fnName) {
+    raiseError(`filter ${fnName} requires a number as option`);
+}
+/**
+ * Throws error when filter requires numeric value but non-number provided.
+ *
+ * @param fnName - Name of the filter function
+ * @returns Never returns (always throws)
+ */
+function valueMustBeNumber(fnName) {
+    raiseError(`filter ${fnName} requires a number value`);
+}
+/**
+ * Throws error when filter requires boolean value but non-boolean provided.
+ *
+ * @param fnName - Name of the filter function
+ * @returns Never returns (always throws)
+ */
+function valueMustBeBoolean(fnName) {
+    raiseError(`filter ${fnName} requires a boolean value`);
+}
+/**
+ * Throws error when filter requires Date value but non-Date provided.
+ *
+ * @param fnName - Name of the filter function
+ * @returns Never returns (always throws)
+ */
+function valueMustBeDate(fnName) {
+    raiseError(`filter ${fnName} requires a date value`);
+}
+
+/**
+ * builtinFilters.ts
+ *
+ * Implementation file for built-in filter functions available in Structive.
+ *
+ * Main responsibilities:
+ * - Provides filters for conversion, comparison, formatting, and validation of numbers, strings, dates, booleans, etc.
+ * - Defines functions with options for each filter name, enabling flexible use during binding
+ * - Designed for common use as both input and output filters
+ *
+ * Design points:
+ * - Comprehensive coverage of diverse filters: eq, ne, lt, gt, inc, fix, locale, uc, lc, cap, trim, slice, pad, int, float, round, date, time, ymd, falsy, truthy, defaults, boolean, number, string, null, etc.
+ * - Rich type checking and error handling for option values
+ * - Centralized management of filter functions with FilterWithOptions type, easy to extend
+ * - Dynamic retrieval of filter functions from filter names and options via builtinFilterFn
+ */
+function validateNumberString(value) {
+    if (!value || isNaN(Number(value))) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Equality filter - compares value with option.
+ *
+ * @param options - Array with comparison value as first element
+ * @returns Filter function that returns boolean
+ */
+const eq = (options) => {
+    const opt = options?.[0] ?? optionsRequired('eq');
+    return (value) => {
+        // Align types for comparison
+        if (typeof value === 'number') {
+            if (!validateNumberString(opt)) {
+                optionMustBeNumber('eq');
+            }
+            return value === Number(opt);
+        }
+        if (typeof value === 'string') {
+            return value === opt;
+        }
+        // Strict equality for others
+        return value === opt;
+    };
+};
+/**
+ * Inequality filter - compares value with option.
+ *
+ * @param options - Array with comparison value as first element
+ * @returns Filter function that returns boolean
+ */
+const ne = (options) => {
+    const opt = options?.[0] ?? optionsRequired('ne');
+    return (value) => {
+        // Align types for comparison
+        if (typeof value === 'number') {
+            if (!validateNumberString(opt)) {
+                optionMustBeNumber('ne');
+            }
+            return value !== Number(opt);
+        }
+        if (typeof value === 'string') {
+            return value !== opt;
+        }
+        // Strict equality for others
+        return value !== opt;
+    };
+};
+/**
+ * Boolean NOT filter - inverts boolean value.
+ *
+ * @param options - Unused
+ * @returns Filter function that returns inverted boolean
+ */
+const not = (_options) => {
+    return (value) => {
+        if (typeof value !== 'boolean') {
+            valueMustBeBoolean('not');
+        }
+        return !value;
+    };
+};
+/**
+ * Less than filter - checks if value is less than option.
+ *
+ * @param options - Array with comparison number as first element
+ * @returns Filter function that returns boolean
+ */
+const lt = (options) => {
+    const opt = options?.[0] ?? optionsRequired('lt');
+    if (!validateNumberString(opt)) {
+        optionMustBeNumber('lt');
+    }
+    return (value) => {
+        if (typeof value !== 'number') {
+            valueMustBeNumber('lt');
+        }
+        return value < Number(opt);
+    };
+};
+/**
+ * Less than or equal filter - checks if value is less than or equal to option.
+ *
+ * @param options - Array with comparison number as first element
+ * @returns Filter function that returns boolean
+ */
+const le = (options) => {
+    const opt = options?.[0] ?? optionsRequired('le');
+    if (!validateNumberString(opt)) {
+        optionMustBeNumber('le');
+    }
+    return (value) => {
+        if (typeof value !== 'number') {
+            valueMustBeNumber('le');
+        }
+        return value <= Number(opt);
+    };
+};
+/**
+ * Greater than filter - checks if value is greater than option.
+ *
+ * @param options - Array with comparison number as first element
+ * @returns Filter function that returns boolean
+ */
+const gt = (options) => {
+    const opt = options?.[0] ?? optionsRequired('gt');
+    if (!validateNumberString(opt)) {
+        optionMustBeNumber('gt');
+    }
+    return (value) => {
+        if (typeof value !== 'number') {
+            valueMustBeNumber('gt');
+        }
+        return value > Number(opt);
+    };
+};
+/**
+ * Greater than or equal filter - checks if value is greater than or equal to option.
+ *
+ * @param options - Array with comparison number as first element
+ * @returns Filter function that returns boolean
+ */
+const ge = (options) => {
+    const opt = options?.[0] ?? optionsRequired('ge');
+    if (!validateNumberString(opt)) {
+        optionMustBeNumber('ge');
+    }
+    return (value) => {
+        if (typeof value !== 'number') {
+            valueMustBeNumber('ge');
+        }
+        return value >= Number(opt);
+    };
+};
+/**
+ * Increment filter - adds option value to input value.
+ *
+ * @param options - Array with increment number as first element
+ * @returns Filter function that returns incremented number
+ */
+const inc = (options) => {
+    const opt = options?.[0] ?? optionsRequired('inc');
+    if (!validateNumberString(opt)) {
+        optionMustBeNumber('inc');
+    }
+    return (value) => {
+        if (typeof value !== 'number') {
+            valueMustBeNumber('inc');
+        }
+        return value + Number(opt);
+    };
+};
+/**
+ * Decrement filter - subtracts option value from input value.
+ *
+ * @param options - Array with decrement number as first element
+ * @returns Filter function that returns decremented number
+ */
+const dec = (options) => {
+    const opt = options?.[0] ?? optionsRequired('dec');
+    if (!validateNumberString(opt)) {
+        optionMustBeNumber('dec');
+    }
+    return (value) => {
+        if (typeof value !== 'number') {
+            valueMustBeNumber('dec');
+        }
+        return value - Number(opt);
+    };
+};
+/**
+ * Multiply filter - multiplies value by option.
+ *
+ * @param options - Array with multiplier number as first element
+ * @returns Filter function that returns multiplied number
+ */
+const mul = (options) => {
+    const opt = options?.[0] ?? optionsRequired('mul');
+    if (!validateNumberString(opt)) {
+        optionMustBeNumber('mul');
+    }
+    return (value) => {
+        if (typeof value !== 'number') {
+            valueMustBeNumber('mul');
+        }
+        return value * Number(opt);
+    };
+};
+/**
+ * Divide filter - divides value by option.
+ *
+ * @param options - Array with divisor number as first element
+ * @returns Filter function that returns divided number
+ */
+const div = (options) => {
+    const opt = options?.[0] ?? optionsRequired('div');
+    if (!validateNumberString(opt)) {
+        optionMustBeNumber('div');
+    }
+    return (value) => {
+        if (typeof value !== 'number') {
+            valueMustBeNumber('div');
+        }
+        return value / Number(opt);
+    };
+};
+/**
+ * Modulo filter - returns remainder of division.
+ *
+ * @param options - Array with divisor number as first element
+ * @returns Filter function that returns remainder
+ */
+const mod = (options) => {
+    const opt = options?.[0] ?? optionsRequired('mod');
+    if (!validateNumberString(opt)) {
+        optionMustBeNumber('mod');
+    }
+    return (value) => {
+        if (typeof value !== 'number') {
+            valueMustBeNumber('mod');
+        }
+        return value % Number(opt);
+    };
+};
+/**
+ * Fixed decimal filter - formats number to fixed decimal places.
+ *
+ * @param options - Array with decimal places as first element (default: 0)
+ * @returns Filter function that returns formatted string
+ */
+const fix = (options) => {
+    const opt = options?.[0] ?? "0";
+    if (!validateNumberString(opt)) {
+        optionMustBeNumber('fix');
+    }
+    return (value) => {
+        if (typeof value !== 'number') {
+            valueMustBeNumber('fix');
+        }
+        return value.toFixed(Number(opt));
+    };
+};
+/**
+ * Locale number filter - formats number according to locale.
+ *
+ * @param options - Array with locale string as first element (default: config.locale)
+ * @returns Filter function that returns localized number string
+ */
+const locale = (options) => {
+    const opt = options?.[0] ?? config.locale;
+    return (value) => {
+        if (typeof value !== 'number') {
+            valueMustBeNumber('locale');
+        }
+        return value.toLocaleString(opt);
+    };
+};
+/**
+ * Uppercase filter - converts string to uppercase.
+ *
+ * @param options - Unused
+ * @returns Filter function that returns uppercase string
+ */
+const uc = (_options) => {
+    return (value) => {
+        return String(value).toUpperCase();
+    };
+};
+/**
+ * Lowercase filter - converts string to lowercase.
+ *
+ * @param options - Unused
+ * @returns Filter function that returns lowercase string
+ */
+const lc = (_options) => {
+    return (value) => {
+        return String(value).toLowerCase();
+    };
+};
+/**
+ * Capitalize filter - capitalizes first character of string.
+ *
+ * @param options - Unused
+ * @returns Filter function that returns capitalized string
+ */
+const cap = (_options) => {
+    return (value) => {
+        const v = String(value);
+        if (v.length === 0) {
+            return v;
+        }
+        if (v.length === 1) {
+            return v.toUpperCase();
+        }
+        return v.charAt(0).toUpperCase() + v.slice(1);
+    };
+};
+/**
+ * Trim filter - removes whitespace from both ends of string.
+ *
+ * @param options - Unused
+ * @returns Filter function that returns trimmed string
+ */
+const trim = (_options) => {
+    return (value) => {
+        return String(value).trim();
+    };
+};
+/**
+ * Slice filter - extracts portion of string from specified index.
+ *
+ * @param options - Array with start index and optional end index
+ * @returns Filter function that returns sliced string
+ */
+const slice = (options) => {
+    const numberedOpts = [];
+    const opt1 = options?.[0] ?? optionsRequired('slice');
+    if (!validateNumberString(opt1)) {
+        optionMustBeNumber('slice');
+    }
+    numberedOpts.push(Number(opt1));
+    const opt2 = options?.[1];
+    if (typeof opt2 !== 'undefined') {
+        if (!validateNumberString(opt2)) {
+            optionMustBeNumber('slice');
+        }
+        numberedOpts.push(Number(opt2));
+    }
+    return (value) => {
+        return String(value).slice(...numberedOpts);
+    };
+};
+/**
+ * Substring filter - extracts substring from specified position and length.
+ *
+ * @param options - Array with start index and length
+ * @returns Filter function that returns substring
+ */
+const substr = (options) => {
+    const opt1 = options?.[0] ?? optionsRequired('substr');
+    if (!validateNumberString(opt1)) {
+        optionMustBeNumber('substr');
+    }
+    const opt2 = options?.[1] ?? optionsRequired('substr');
+    if (!validateNumberString(opt2)) {
+        optionMustBeNumber('substr');
+    }
+    return (value) => {
+        return String(value).substr(Number(opt1), Number(opt2));
+    };
+};
+/**
+ * Pad filter - pads string to specified length from start.
+ *
+ * @param options - Array with target length and pad string (default: '0')
+ * @returns Filter function that returns padded string
+ */
+const pad = (options) => {
+    const opt1 = options?.[0] ?? optionsRequired('pad');
+    if (!validateNumberString(opt1)) {
+        optionMustBeNumber('pad');
+    }
+    const opt2 = options?.[1] ?? '0';
+    return (value) => {
+        return String(value).padStart(Number(opt1), opt2);
+    };
+};
+/**
+ * Repeat filter - repeats string specified number of times.
+ *
+ * @param options - Array with repeat count as first element
+ * @returns Filter function that returns repeated string
+ */
+const rep = (options) => {
+    const opt = options?.[0] ?? optionsRequired('rep');
+    if (!validateNumberString(opt)) {
+        optionMustBeNumber('rep');
+    }
+    return (value) => {
+        return String(value).repeat(Number(opt));
+    };
+};
+/**
+ * Reverse filter - reverses character order in string.
+ *
+ * @param options - Unused
+ * @returns Filter function that returns reversed string
+ */
+const rev = (_options) => {
+    return (value) => {
+        return String(value).split('').reverse().join('');
+    };
+};
+/**
+ * Integer filter - parses value to integer.
+ *
+ * @param options - Unused
+ * @returns Filter function that returns integer
+ */
+const int = (_options) => {
+    return (value) => {
+        return parseInt(String(value), 10);
+    };
+};
+/**
+ * Float filter - parses value to floating point number.
+ *
+ * @param options - Unused
+ * @returns Filter function that returns float
+ */
+const float = (_options) => {
+    return (value) => {
+        return parseFloat(String(value));
+    };
+};
+/**
+ * Round filter - rounds number to specified decimal places.
+ *
+ * @param options - Array with decimal places as first element (default: 0)
+ * @returns Filter function that returns rounded number
+ */
+const round = (options) => {
+    const opt = options?.[0] ?? '0';
+    if (!validateNumberString(opt)) {
+        optionMustBeNumber('round');
+    }
+    return (value) => {
+        if (typeof value !== 'number') {
+            valueMustBeNumber('round');
+        }
+        const optValue = Math.pow(10, Number(opt));
+        return Math.round(value * optValue) / optValue;
+    };
+};
+/**
+ * Floor filter - rounds number down to specified decimal places.
+ *
+ * @param options - Array with decimal places as first element (default: 0)
+ * @returns Filter function that returns floored number
+ */
+const floor = (options) => {
+    const opt = options?.[0] ?? '0';
+    if (!validateNumberString(opt)) {
+        optionMustBeNumber('floor');
+    }
+    return (value) => {
+        if (typeof value !== 'number') {
+            valueMustBeNumber('floor');
+        }
+        const optValue = Math.pow(10, Number(opt));
+        return Math.floor(value * optValue) / optValue;
+    };
+};
+/**
+ * Ceiling filter - rounds number up to specified decimal places.
+ *
+ * @param options - Array with decimal places as first element (default: 0)
+ * @returns Filter function that returns ceiled number
+ */
+const ceil = (options) => {
+    const opt = options?.[0] ?? '0';
+    if (!validateNumberString(opt)) {
+        optionMustBeNumber('ceil');
+    }
+    return (value) => {
+        if (typeof value !== 'number') {
+            valueMustBeNumber('ceil');
+        }
+        const optValue = Math.pow(10, Number(opt));
+        return Math.ceil(value * optValue) / optValue;
+    };
+};
+/**
+ * Percent filter - formats number as percentage string.
+ *
+ * @param options - Array with decimal places as first element (default: 0)
+ * @returns Filter function that returns percentage string with '%'
+ */
+const percent = (options) => {
+    const opt = options?.[0] ?? '0';
+    if (!validateNumberString(opt)) {
+        optionMustBeNumber('percent');
+    }
+    return (value) => {
+        if (typeof value !== 'number') {
+            valueMustBeNumber('percent');
+        }
+        return `${(value * 100).toFixed(Number(opt))}%`;
+    };
+};
+/**
+ * Date filter - formats Date object as localized date string.
+ *
+ * @param options - Array with locale string as first element (default: config.locale)
+ * @returns Filter function that returns date string
+ */
+const date = (options) => {
+    const opt = options?.[0] ?? config.locale;
+    return (value) => {
+        if (!(value instanceof Date)) {
+            valueMustBeDate('date');
+        }
+        return value.toLocaleDateString(opt);
+    };
+};
+/**
+ * Time filter - formats Date object as localized time string.
+ *
+ * @param options - Array with locale string as first element (default: config.locale)
+ * @returns Filter function that returns time string
+ */
+const time = (options) => {
+    const opt = options?.[0] ?? config.locale;
+    return (value) => {
+        if (!(value instanceof Date)) {
+            valueMustBeDate('time');
+        }
+        return value.toLocaleTimeString(opt);
+    };
+};
+/**
+ * DateTime filter - formats Date object as localized date and time string.
+ *
+ * @param options - Array with locale string as first element (default: config.locale)
+ * @returns Filter function that returns datetime string
+ */
+const datetime = (options) => {
+    const opt = options?.[0] ?? config.locale;
+    return (value) => {
+        if (!(value instanceof Date)) {
+            valueMustBeDate('datetime');
+        }
+        return value.toLocaleString(opt);
+    };
+};
+/**
+ * Year-Month-Day filter - formats Date object as YYYY-MM-DD string.
+ *
+ * @param options - Array with separator string as first element (default: '-')
+ * @returns Filter function that returns formatted date string
+ */
+const ymd = (options) => {
+    const opt = options?.[0] ?? '-';
+    return (value) => {
+        if (!(value instanceof Date)) {
+            valueMustBeDate('ymd');
+        }
+        const year = value.getFullYear().toString();
+        const month = (value.getMonth() + 1).toString().padStart(2, '0');
+        const day = value.getDate().toString().padStart(2, '0');
+        return `${year}${opt}${month}${opt}${day}`;
+    };
+};
+/**
+ * Falsy filter - checks if value is falsy.
+ *
+ * @param options - Unused
+ * @returns Filter function that returns true for false/null/undefined/0/''/NaN
+ */
+const falsy = (_options) => {
+    return (value) => value === false || value === null || value === undefined || value === 0 || value === '' || Number.isNaN(value);
+};
+/**
+ * Truthy filter - checks if value is truthy.
+ *
+ * @param options - Unused
+ * @returns Filter function that returns true for non-falsy values
+ */
+const truthy = (_options) => {
+    return (value) => value !== false && value !== null && value !== undefined && value !== 0 && value !== '' && !Number.isNaN(value);
+};
+/**
+ * Default filter - returns default value if input is falsy.
+ *
+ * @param options - Array with default value as first element
+ * @returns Filter function that returns value or default
+ */
+const defaults = (options) => {
+    const opt = options?.[0] ?? optionsRequired('defaults');
+    return (value) => {
+        if (value === false || value === null || value === undefined || value === 0 || value === '' || Number.isNaN(value)) {
+            return opt;
+        }
+        return value;
+    };
+};
+/**
+ * Boolean filter - converts value to boolean.
+ *
+ * @param options - Unused
+ * @returns Filter function that returns boolean
+ */
+const boolean = (_options) => {
+    return (value) => {
+        return Boolean(value);
+    };
+};
+/**
+ * Number filter - converts value to number.
+ *
+ * @param options - Unused
+ * @returns Filter function that returns number
+ */
+const number = (_options) => {
+    return (value) => {
+        return Number(value);
+    };
+};
+/**
+ * String filter - converts value to string.
+ *
+ * @param options - Unused
+ * @returns Filter function that returns string
+ */
+const string = (_options) => {
+    return (value) => {
+        return String(value);
+    };
+};
+/**
+ * Null filter - converts empty string to null.
+ *
+ * @param options - Unused
+ * @returns Filter function that returns null for empty string, otherwise original value
+ */
+const _null = (_options) => {
+    return (value) => {
+        return (value === "") ? null : value;
+    };
+};
+const builtinFilters = {
+    "eq": eq,
+    "ne": ne,
+    "not": not,
+    "lt": lt,
+    "le": le,
+    "gt": gt,
+    "ge": ge,
+    "inc": inc,
+    "dec": dec,
+    "mul": mul,
+    "div": div,
+    "mod": mod,
+    "fix": fix,
+    "locale": locale,
+    "uc": uc,
+    "lc": lc,
+    "cap": cap,
+    "trim": trim,
+    "slice": slice,
+    "substr": substr,
+    "pad": pad,
+    "rep": rep,
+    "rev": rev,
+    "int": int,
+    "float": float,
+    "round": round,
+    "floor": floor,
+    "ceil": ceil,
+    "percent": percent,
+    "date": date,
+    "time": time,
+    "datetime": datetime,
+    "ymd": ymd,
+    "falsy": falsy,
+    "truthy": truthy,
+    "defaults": defaults,
+    "boolean": boolean,
+    "number": number,
+    "string": string,
+    "null": _null,
+};
+const outputBuiltinFilters = builtinFilters;
+
+/**
+ * filterMeta.ts — 組み込みフィルタの構造化メタデータ（単一正本・route-a A2-1）。
+ *
+ * これまで vscode-wcs（completionData.ts BUILTIN_FILTERS）が手で持っていたフィルタの
+ * 引数仕様・型・説明を、実装側（@wcstack/state）に**正本として移設**したもの。
+ * manifest.ts がこれを公開し、vscode-wcs はそれを消費して手リストを撤去できる。
+ *
+ * 完全性は __tests__/manifest.test.ts のドリフト検出が保証する
+ * （filterMeta のキー集合 == builtinFilters のキー集合）。フィルタを追加して meta を
+ * 書き忘れると CI が落ちる。
+ */
+/** 組み込みフィルタ名 → 構造化メタデータ。キー集合は builtinFilters と一致しなければならない。 */
+const builtinFilterMeta = {
+    // 比較・論理
+    eq: { description: "等しいか比較", hasArgs: true, resultType: "boolean", acceptTypes: "any", minArgs: 1, maxArgs: 1, argTypes: ["any"] },
+    ne: { description: "異なるか比較", hasArgs: true, resultType: "boolean", acceptTypes: "any", minArgs: 1, maxArgs: 1, argTypes: ["any"] },
+    not: { description: "ブール値を反転", hasArgs: false, resultType: "boolean", acceptTypes: ["boolean"], minArgs: 0, maxArgs: 0 },
+    lt: { description: "より小さいか", hasArgs: true, resultType: "boolean", acceptTypes: ["number", "string"], minArgs: 1, maxArgs: 1, argTypes: ["number"] },
+    le: { description: "以下か", hasArgs: true, resultType: "boolean", acceptTypes: ["number", "string"], minArgs: 1, maxArgs: 1, argTypes: ["number"] },
+    gt: { description: "より大きいか", hasArgs: true, resultType: "boolean", acceptTypes: ["number", "string"], minArgs: 1, maxArgs: 1, argTypes: ["number"] },
+    ge: { description: "以上か", hasArgs: true, resultType: "boolean", acceptTypes: ["number", "string"], minArgs: 1, maxArgs: 1, argTypes: ["number"] },
+    // 算術
+    inc: { description: "加算", hasArgs: true, resultType: "number", acceptTypes: ["number"], minArgs: 0, maxArgs: 1, argTypes: ["number"] },
+    dec: { description: "減算", hasArgs: true, resultType: "number", acceptTypes: ["number"], minArgs: 0, maxArgs: 1, argTypes: ["number"] },
+    mul: { description: "乗算", hasArgs: true, resultType: "number", acceptTypes: ["number"], minArgs: 1, maxArgs: 1, argTypes: ["number"] },
+    div: { description: "除算", hasArgs: true, resultType: "number", acceptTypes: ["number"], minArgs: 1, maxArgs: 1, argTypes: ["number"] },
+    mod: { description: "剰余", hasArgs: true, resultType: "number", acceptTypes: ["number"], minArgs: 1, maxArgs: 1, argTypes: ["number"] },
+    // 数値フォーマット
+    fix: { description: "固定小数点表記", hasArgs: true, resultType: "string", acceptTypes: ["number"], minArgs: 0, maxArgs: 1, argTypes: ["number"] },
+    locale: { description: "ロケール形式で数値フォーマット", hasArgs: true, resultType: "string", acceptTypes: ["number"], minArgs: 0, maxArgs: 1, argTypes: ["string"] },
+    // 文字列
+    uc: { description: "大文字に変換", hasArgs: false, resultType: "string", acceptTypes: ["string"], minArgs: 0, maxArgs: 0 },
+    lc: { description: "小文字に変換", hasArgs: false, resultType: "string", acceptTypes: ["string"], minArgs: 0, maxArgs: 0 },
+    cap: { description: "先頭文字を大文字に", hasArgs: false, resultType: "string", acceptTypes: ["string"], minArgs: 0, maxArgs: 0 },
+    trim: { description: "前後の空白を削除", hasArgs: false, resultType: "string", acceptTypes: ["string"], minArgs: 0, maxArgs: 0 },
+    slice: { description: "部分文字列 (start[,end])", hasArgs: true, resultType: "string", acceptTypes: ["string"], minArgs: 1, maxArgs: 2, argTypes: ["number", "number"] },
+    substr: { description: "部分文字列 (pos,len)", hasArgs: true, resultType: "string", acceptTypes: ["string"], minArgs: 1, maxArgs: 2, argTypes: ["number", "number"] },
+    pad: { description: "パディング (length[,char])", hasArgs: true, resultType: "string", acceptTypes: ["string"], minArgs: 1, maxArgs: 2, argTypes: ["number", "string"] },
+    rep: { description: "繰り返し (count)", hasArgs: true, resultType: "string", acceptTypes: ["string"], minArgs: 1, maxArgs: 1, argTypes: ["number"] },
+    rev: { description: "文字順を反転", hasArgs: false, resultType: "string", acceptTypes: ["string"], minArgs: 0, maxArgs: 0 },
+    // 数値パース・丸め
+    int: { description: "整数にパース", hasArgs: false, resultType: "number", acceptTypes: ["string", "number"], minArgs: 0, maxArgs: 0 },
+    float: { description: "浮動小数点数にパース", hasArgs: false, resultType: "number", acceptTypes: ["string", "number"], minArgs: 0, maxArgs: 0 },
+    round: { description: "四捨五入", hasArgs: true, resultType: "number", acceptTypes: ["number"], minArgs: 0, maxArgs: 1, argTypes: ["number"] },
+    floor: { description: "切り下げ", hasArgs: true, resultType: "number", acceptTypes: ["number"], minArgs: 0, maxArgs: 1, argTypes: ["number"] },
+    ceil: { description: "切り上げ", hasArgs: true, resultType: "number", acceptTypes: ["number"], minArgs: 0, maxArgs: 1, argTypes: ["number"] },
+    percent: { description: "パーセンテージ形式", hasArgs: true, resultType: "string", acceptTypes: ["number"], minArgs: 0, maxArgs: 1, argTypes: ["number"] },
+    // 日付・時刻
+    date: { description: "ロケール形式の日付", hasArgs: false, resultType: "string", acceptTypes: "any", minArgs: 0, maxArgs: 0 },
+    time: { description: "ロケール形式の時刻", hasArgs: false, resultType: "string", acceptTypes: "any", minArgs: 0, maxArgs: 0 },
+    datetime: { description: "ロケール形式の日時", hasArgs: false, resultType: "string", acceptTypes: "any", minArgs: 0, maxArgs: 0 },
+    ymd: { description: "YYYY-MM-DD 形式", hasArgs: true, resultType: "string", acceptTypes: "any", minArgs: 0, maxArgs: 1, argTypes: ["string"] },
+    // 真偽値・変換
+    falsy: { description: "偽値か判定", hasArgs: false, resultType: "boolean", acceptTypes: "any", minArgs: 0, maxArgs: 0 },
+    truthy: { description: "真値か判定", hasArgs: false, resultType: "boolean", acceptTypes: "any", minArgs: 0, maxArgs: 0 },
+    defaults: { description: "偽値の場合デフォルト値", hasArgs: true, resultType: "passthrough", acceptTypes: "any", minArgs: 1, maxArgs: 1, argTypes: ["any"] },
+    boolean: { description: "ブール値に変換", hasArgs: false, resultType: "boolean", acceptTypes: "any", minArgs: 0, maxArgs: 0 },
+    number: { description: "数値に変換", hasArgs: false, resultType: "number", acceptTypes: "any", minArgs: 0, maxArgs: 0 },
+    string: { description: "文字列に変換", hasArgs: false, resultType: "string", acceptTypes: "any", minArgs: 0, maxArgs: 0 },
+    null: { description: "空文字列をnullに変換", hasArgs: false, resultType: "passthrough", acceptTypes: ["string"], minArgs: 0, maxArgs: 0 },
+};
+
+const STRUCTURAL_BINDING_TYPE_SET = new Set([
+    "if",
+    "elseif",
+    "else",
+    "for",
+]);
+
+const DELIMITER = '.';
+const WILDCARD = '*';
+const MAX_WILDCARD_DEPTH = 128;
+// data-wcs バインディング構文 `[prop][#mod]: [path][@state][|filter...]` の区切り文字（単一正本）。
+// これらは「死守の壁（構文契約）」であり値は不変。manifest.syntax.delimiters で公開される。
+const BINDING_SEPARATOR = ';'; // 複数バインディングの区切り
+const PROP_VALUE_SEPARATOR = ':'; // 左辺(prop)と右辺(path)の区切り
+const MODIFIER_SEPARATOR = '#'; // prop と修飾子の区切り
+const STATE_NAME_SEPARATOR = '@'; // path と @stateName の区切り
+const FILTER_SEPARATOR = '|'; // フィルタパイプの区切り
+/**
+ * stackIndexByIndexName
+ * インデックス名からスタックインデックスへのマッピング
+ * $1 => 0
+ * $2 => 1
+ * :
+ * ${i + 1} => i
+ * i < MAX_WILDCARD_DEPTH
+ */
+const tmpIndexByIndexName = {};
+for (let i = 0; i < MAX_WILDCARD_DEPTH; i++) {
+    tmpIndexByIndexName[`$${i + 1}`] = i;
+}
+Object.freeze(tmpIndexByIndexName);
+const STATE_CONNECTED_CALLBACK_NAME = "$connectedCallback";
+const STATE_DISCONNECTED_CALLBACK_NAME = "$disconnectedCallback";
+const STATE_UPDATED_CALLBACK_NAME = "$updatedCallback";
+const WEBCOMPONENT_STATE_READY_CALLBACK_NAME = "$stateReadyCallback";
+const STATE_BINDABLES_NAME = "$bindables";
+const STATE_COMMAND_TOKENS_NAME = "$commandTokens";
+const STATE_COMMAND_NAMESPACE_NAME = "$command";
+const STATE_EVENT_TOKENS_NAME = "$eventTokens";
+const STATE_ON_NAME = "$on";
+
+/**
+ * manifest.ts — `<wcs-state>` の構文・フィルタ・予約名を機械可読な単一正本として公開する。
+ *
+ * 目的（route-a A2-1）: vscode-wcs（wcstack-intellisense）が現在ハードコードで二重実装している
+ * 「フィルタ一覧・構文区切り・予約名」を、state 側の実装から導出した manifest に一本化し、
+ * 手作業同期によるドリフトを構造的に断つための土台。
+ *
+ * 設計:
+ * - `filters` は実装（builtinFilters の Record キー）から **自動導出**＝実装が唯一の正本。
+ * - 構文・予約名は config / define.ts の定数から導出。
+ * - 将来 `dist/wcs-manifest.json` としてビルド時に書き出し、vscode-wcs がそれを読む形に発展させる。
+ * - ドリフト検出テスト（__tests__/manifest.test.ts）が、フィルタ集合の golden と実装の一致を CI で保証する。
+ */
+/** マニフェストのバージョン（構造を変えたら上げる）。 */
+const WCS_MANIFEST_VERSION = 1;
+/** 機械可読な単一正本を返す。vscode-wcs はこれを消費する想定。 */
+function getWcsManifest() {
+    return {
+        version: WCS_MANIFEST_VERSION,
+        syntax: {
+            bindAttribute: config.bindAttributeName,
+            tagName: config.tagNames.state,
+            pathDelimiter: DELIMITER,
+            wildcard: WILDCARD,
+            delimiters: {
+                binding: BINDING_SEPARATOR,
+                propValue: PROP_VALUE_SEPARATOR,
+                modifier: MODIFIER_SEPARATOR,
+                stateName: STATE_NAME_SEPARATOR,
+                filter: FILTER_SEPARATOR,
+            },
+            // 正本 STRUCTURAL_BINDING_TYPE_SET から導出（手書きの二重定義を排除）。
+            structuralDirectives: Array.from(STRUCTURAL_BINDING_TYPE_SET),
+        },
+        // 実装（Record のキー）から自動導出。手リストを持たない＝ドリフトの構造的排除。
+        filters: Object.keys(outputBuiltinFilters),
+        filterMeta: builtinFilterMeta,
+        reservedLifecycle: [
+            STATE_CONNECTED_CALLBACK_NAME,
+            STATE_DISCONNECTED_CALLBACK_NAME,
+            STATE_UPDATED_CALLBACK_NAME,
+            WEBCOMPONENT_STATE_READY_CALLBACK_NAME,
+        ],
+        reservedStateApi: [
+            STATE_BINDABLES_NAME,
+            STATE_COMMAND_TOKENS_NAME,
+            STATE_COMMAND_NAMESPACE_NAME,
+            STATE_EVENT_TOKENS_NAME,
+            STATE_ON_NAME,
+        ],
+    };
+}
+
+export { STRUCTURAL_BINDING_TYPE_SET, WCS_MANIFEST_VERSION, builtinFilterMeta, getWcsManifest };