@wcstack/typescript 4.0.0-rc.3 → 4.0.0-rc.5

package/dist/index.esm.js

@@ -572,7 +572,7 @@ function loadSchemaCore() {
     return cached;
 }
 
-var version = "4.0.0-rc.3";
+var version = "4.0.0-rc.5";
 var pkg = {
 	version: version};
 

package/dist/schema-core.cjs

@@ -766,32 +766,8 @@ var LINT_HINT = " Validate statically: npx @wcstack/lint <file>.";
 function raiseError(message, subject, candidates) {
   throw new Error(`[@wcstack/state] ${message}${hooks.explain?.(message, subject, candidates) ?? ""}`);
 }
-var CODES = [
-  "",
-  "binding-syntax",
-  "template-syntax",
-  "binding-path-missing",
-  "binding-type-expectation",
-  "filter-unknown",
-  "filter-arity",
-  "getter-cycle",
-  "getter-depth-exceeded",
-  "index-arity",
-  "index-param-range",
-  "recursion-unsupported",
-  "token-misconfigured",
-  "token-undeclared",
-  "wildcard-rank",
-  "spread-no-bindable",
-  "declaration-alias",
-  "name-alias"
-];
-var codeOf = (id) => {
-  const c = CODES[id / 100 | 0];
-  return c ? `[wcs/${c}] ` : "";
-};
 function text(id, args = []) {
-  return hooks.render?.(id, args) ?? `${codeOf(id)}#${id}${args.map((a) => ` ${typeof a === "string" ? JSON.stringify(a) : String(a)}`).join("")}`;
+  return hooks.render?.(id, args) ?? `#${id}${args.map((a) => ` ${typeof a === "string" ? JSON.stringify(a) : String(a)}`).join("")}`;
 }
 function raise(id, args, subject, candidates) {
   raiseError(text(id, args), subject, candidates);
@@ -819,7 +795,21 @@ var FORMATS_FILTER_NAMES = [
   "time",
   "datetime",
   "ymd",
-  "hms"
+  "hms",
+  "add",
+  "sub",
+  "mul",
+  "div",
+  "mod",
+  "abs",
+  "clamp",
+  "int",
+  "float",
+  "defaults",
+  "coalesce",
+  "number",
+  "string",
+  "nullIfEmpty"
 ];
 var definitions = /* @__PURE__ */ new Map();
 function hasFilter(name) {
@@ -1011,6 +1001,30 @@ function parseStatePart(statePart) {
 }
 var MAX_DRAIN_PASSES = 32;
 var MAX_RENDER_CHAIN = 100;
+var CODES = [
+  "",
+  "binding-syntax",
+  "template-syntax",
+  "binding-path-missing",
+  "binding-type-expectation",
+  "filter-unknown",
+  "filter-arity",
+  "getter-cycle",
+  "getter-depth-exceeded",
+  "index-arity",
+  "index-param-range",
+  "recursion-unsupported",
+  "token-misconfigured",
+  "token-undeclared",
+  "wildcard-rank",
+  "spread-no-bindable",
+  "declaration-alias",
+  "name-alias"
+];
+var codeOf = (id) => {
+  const c = CODES[id / 100 | 0];
+  return c ? `[wcs/${c}] ` : "";
+};
 var MOVED = ["enableMustache", "sameValueGuard", "enableDirectionalInitialSync"];
 var element = (tag, at2) => `<${tag}${at2.map((a, i) => i % 2 ? `="${a}"` : ` ${a}`).join("")}>`;
 var CSP_GUIDE = "https://github.com/wcstack/wcstack/blob/main/docs/csp.md";
@@ -1363,10 +1377,11 @@ var SENTENCES = {
     1201
     /* CommandRightSide */
   ]: (prop, p) => `"${prop}: ${p}": the right-hand side must be $command.<name>`,
+  // a native element's command (no hyphen: never a custom element) is the native-commands add-on's
   [
     1202
     /* NoBindable */
-  ]: (tag, what) => `<${tag}> declares no static wcBindable (${what}).`,
+  ]: (tag, what) => `<${tag}> declares no static wcBindable (${what}).${!tag.includes("-") && what.startsWith("command.") ? " A native element's command needs the add-on @wcstack/state/features/native-commands." : ""}`,
   [
     1203
     /* NoCommand */
@@ -1375,6 +1390,10 @@ var SENTENCES = {
     1204
     /* NoProperty */
   ]: (tag, prop) => `<${tag}> declares no property "${prop}".`,
+  [
+    1205
+    /* NativeNoCommand */
+  ]: (tag, method, allowed) => `<${tag}> has no command "${method}" (a native <${tag}>'s commands: ${allowed}).`,
   [
     1301
     /* EventTokenUndeclared */
@@ -1690,26 +1709,26 @@ function findStartTagRegions(html) {
   let lower2 = null;
   let i = 0;
   while (i < html.length) {
-    const lt = html.indexOf("<", i);
-    if (lt === -1) break;
-    const next = html[lt + 1];
-    if (html.startsWith("<!--", lt)) {
-      const close = html.indexOf("-->", lt + 4);
+    const lt2 = html.indexOf("<", i);
+    if (lt2 === -1) break;
+    const next = html[lt2 + 1];
+    if (html.startsWith("<!--", lt2)) {
+      const close = html.indexOf("-->", lt2 + 4);
       i = close === -1 ? html.length : close + 3;
       continue;
     }
     if (next === "!" || next === "?" || next === "/") {
-      const close = html.indexOf(">", lt + 1);
+      const close = html.indexOf(">", lt2 + 1);
       i = close === -1 ? html.length : close + 1;
       continue;
     }
     if (next === void 0 || !/[A-Za-z]/.test(next)) {
-      i = lt + 1;
+      i = lt2 + 1;
       continue;
     }
-    let n = lt + 1;
+    let n = lt2 + 1;
     while (n < html.length && /[^\s/>]/.test(html[n])) n++;
-    const tagName = asciiLowerCase(html.slice(lt + 1, n));
+    const tagName = asciiLowerCase(html.slice(lt2 + 1, n));
     let j = n;
     let quote = null;
     while (j < html.length) {
@@ -1723,10 +1742,10 @@ function findStartTagRegions(html) {
       }
       j++;
     }
-    const gt = j < html.length ? j : html.length;
-    const selfClosing = html[gt - 1] === "/";
-    out.push({ tagName, start: n, end: selfClosing ? gt - 1 : gt });
-    i = gt + 1;
+    const gt2 = j < html.length ? j : html.length;
+    const selfClosing = html[gt2 - 1] === "/";
+    out.push({ tagName, start: n, end: selfClosing ? gt2 - 1 : gt2 });
+    i = gt2 + 1;
     if (tagName === "script" || tagName === "style") {
       const close = (lower2 ??= asciiLowerCase(html)).indexOf(`</${tagName}`, i);
       i = close === -1 ? html.length : close;
@@ -1770,8 +1789,8 @@ function matchRawTextElement(html, lower2, pos) {
   return null;
 }
 function afterCloseTag(html, closeStart) {
-  const gt = html.indexOf(">", closeStart);
-  return gt === -1 ? html.length : gt + 1;
+  const gt2 = html.indexOf(">", closeStart);
+  return gt2 === -1 ? html.length : gt2 + 1;
 }
 function parseWcsStateElements(html, stateTagName = "wcs-state") {
   const elements = [];
@@ -1877,22 +1896,22 @@ function collectTemplateTags(html) {
   const tags = [];
   let pos = 0;
   while (pos < html.length) {
-    const lt = html.indexOf("<", pos);
-    if (lt === -1) break;
-    if (html.startsWith("<!--", lt)) {
-      const commentEnd = html.indexOf("-->", lt + 4);
+    const lt2 = html.indexOf("<", pos);
+    if (lt2 === -1) break;
+    if (html.startsWith("<!--", lt2)) {
+      const commentEnd = html.indexOf("-->", lt2 + 4);
       if (commentEnd === -1) break;
       pos = commentEnd + 3;
       continue;
     }
-    const raw = matchRawTextElement(html, lower2, lt);
+    const raw = matchRawTextElement(html, lower2, lt2);
     if (raw !== null) {
       pos = raw.closed ? afterCloseTag(html, raw.contentEnd) : html.length;
       continue;
     }
-    const tag = /^<(\/?)template(?=[\s/>])/i.exec(html.slice(lt, lt + 11));
-    if (tag !== null) tags.push({ at: lt, close: tag[1] === "/" });
-    pos = lt + 1;
+    const tag = /^<(\/?)template(?=[\s/>])/i.exec(html.slice(lt2, lt2 + 11));
+    if (tag !== null) tags.push({ at: lt2, close: tag[1] === "/" });
+    pos = lt2 + 1;
   }
   return tags;
 }
@@ -2036,32 +2055,8 @@ var hooks2 = {};
 function raiseError2(message, subject, candidates) {
   throw new Error(`[@wcstack/state] ${message}${hooks2.explain?.(message, subject, candidates) ?? ""}`);
 }
-var CODES2 = [
-  "",
-  "binding-syntax",
-  "template-syntax",
-  "binding-path-missing",
-  "binding-type-expectation",
-  "filter-unknown",
-  "filter-arity",
-  "getter-cycle",
-  "getter-depth-exceeded",
-  "index-arity",
-  "index-param-range",
-  "recursion-unsupported",
-  "token-misconfigured",
-  "token-undeclared",
-  "wildcard-rank",
-  "spread-no-bindable",
-  "declaration-alias",
-  "name-alias"
-];
-var codeOf2 = (id) => {
-  const c = CODES2[id / 100 | 0];
-  return c ? `[wcs/${c}] ` : "";
-};
 function text2(id, args = []) {
-  return hooks2.render?.(id, args) ?? `${codeOf2(id)}#${id}${args.map((a) => ` ${typeof a === "string" ? JSON.stringify(a) : String(a)}`).join("")}`;
+  return hooks2.render?.(id, args) ?? `#${id}${args.map((a) => ` ${typeof a === "string" ? JSON.stringify(a) : String(a)}`).join("")}`;
 }
 function raise2(id, args, subject, candidates) {
   raiseError2(text2(id, args), subject, candidates);
@@ -2076,7 +2071,17 @@ var config = {
   locale: typeof document !== "undefined" ? document.documentElement?.lang || "en" : "en",
   enableContractAnalyzer: false
 };
-var FEATURE_NAMES = ["formats", "diagnostics", "temporal", "list-keys", "scopes", "recursion", "ssr", "devtools"];
+var FEATURE_NAMES = ["formats", "diagnostics", "temporal", "list-keys", "scopes", "recursion", "ssr", "devtools", "native-commands"];
+var NATIVE_COMMANDS = {
+  "*": ["focus", "blur", "click", "scrollIntoView", "showPopover", "hidePopover", "togglePopover"],
+  "dialog": ["show", "showModal", "close", "requestClose"],
+  "form": ["requestSubmit", "checkValidity", "reportValidity"],
+  "input": ["select", "setSelectionRange", "showPicker", "setCustomValidity", "checkValidity", "reportValidity"],
+  "textarea": ["select", "setSelectionRange", "setCustomValidity", "checkValidity", "reportValidity"],
+  "select": ["showPicker", "setCustomValidity", "checkValidity", "reportValidity"],
+  "audio": ["play", "pause", "load"],
+  "video": ["play", "pause", "load"]
+};
 var WILDCARD2 = "*";
 function optionsRequired(fnName) {
   raise2(26, [fnName]);
@@ -2165,42 +2170,6 @@ var numeric = (name, op) => ({
 var truthy = () => (value) => !!value;
 var falsy = () => (value) => !value;
 var boolean = () => (value) => Boolean(value);
-var abs = () => (value) => {
-  if (typeof value !== "number") {
-    valueMustBeNumber("abs");
-  }
-  return Math.abs(value);
-};
-var clamp = (options) => {
-  const min = requiredNumberOption(options, 0, "clamp");
-  const max = requiredNumberOption(options, 1, "clamp");
-  return (value) => {
-    if (typeof value !== "number") {
-      valueMustBeNumber("clamp");
-    }
-    return Math.min(Math.max(value, min), max);
-  };
-};
-var number = () => (value) => Number(value);
-var string = () => (value) => String(value);
-var int = () => (value) => parseInt(String(value), 10);
-var float = () => (value) => parseFloat(String(value));
-var defaults = (options, literals) => {
-  const opt = options?.[0] ?? optionsRequired("defaults");
-  const fallback = firstLiteral(opt, literals);
-  return (value) => {
-    if (!value) {
-      return fallback;
-    }
-    return value;
-  };
-};
-var coalesce = (options, literals) => {
-  const opt = options?.[0] ?? optionsRequired("coalesce");
-  const fallback = firstLiteral(opt, literals);
-  return (value) => value ?? fallback;
-};
-var nullIfEmpty = () => (value) => value === "" ? null : value;
 var coreFilters = {
   eq: { factory: eq, arity: [1, 1] },
   ne: { factory: ne, arity: [1, 1] },
@@ -2209,23 +2178,9 @@ var coreFilters = {
   le: numeric("le", (value, opt) => value <= opt),
   gt: numeric("gt", (value, opt) => value > opt),
   ge: numeric("ge", (value, opt) => value >= opt),
-  add: numeric("add", (value, opt) => value + opt),
-  sub: numeric("sub", (value, opt) => value - opt),
-  mul: numeric("mul", (value, opt) => value * opt),
-  div: numeric("div", (value, opt) => value / opt),
-  mod: numeric("mod", (value, opt) => value % opt),
-  abs: { factory: abs, arity: [0, 0] },
-  clamp: { factory: clamp, arity: [2, 2] },
-  int: { factory: int, arity: [0, 0] },
-  float: { factory: float, arity: [0, 0] },
   falsy: { factory: falsy, arity: [0, 0] },
   truthy: { factory: truthy, arity: [0, 0] },
-  defaults: { factory: defaults, arity: [1, 1] },
-  coalesce: { factory: coalesce, arity: [1, 1] },
-  boolean: { factory: boolean, arity: [0, 0] },
-  number: { factory: number, arity: [0, 0] },
-  string: { factory: string, arity: [0, 0] },
-  nullIfEmpty: { factory: nullIfEmpty, arity: [0, 0] }
+  boolean: { factory: boolean, arity: [0, 0] }
 };
 var nullishPassthrough = (factory) => (options) => {
   const filterFn = factory(options);
@@ -2410,7 +2365,44 @@ var hms = (options) => {
     return `${hours}${opt}${minutes}${opt}${seconds}`;
   };
 };
-var formatFilters = {
+var abs = () => (value) => {
+  if (typeof value !== "number") {
+    valueMustBeNumber("abs");
+  }
+  return Math.abs(value);
+};
+var clamp = (options) => {
+  const min = requiredNumberOption(options, 0, "clamp");
+  const max = requiredNumberOption(options, 1, "clamp");
+  return (value) => {
+    if (typeof value !== "number") {
+      valueMustBeNumber("clamp");
+    }
+    return Math.min(Math.max(value, min), max);
+  };
+};
+var number = () => (value) => Number(value);
+var string = () => (value) => String(value);
+var int = () => (value) => parseInt(String(value), 10);
+var float = () => (value) => parseFloat(String(value));
+var defaults = (options, literals) => {
+  const opt = options?.[0] ?? optionsRequired("defaults");
+  const fallback = firstLiteral(opt, literals);
+  return (value) => {
+    if (!value) {
+      return fallback;
+    }
+    return value;
+  };
+};
+var coalesce = (options, literals) => {
+  const opt = options?.[0] ?? optionsRequired("coalesce");
+  const fallback = firstLiteral(opt, literals);
+  return (value) => value ?? fallback;
+};
+var nullIfEmpty = () => (value) => value === "" ? null : value;
+var { eq: eq2, ne: ne2, not: not2, lt, le, gt, ge, falsy: falsy2, truthy: truthy2, boolean: boolean2 } = coreFilters;
+var registered = {
   toFixed: { factory: toFixed, arity: [0, 1] },
   locale: { factory: locale, arity: [0, 1] },
   // The `String(value)` family passes an absent value through (B8 — see nullishPassthrough)
@@ -2436,8 +2428,36 @@ var formatFilters = {
   time: { factory: time, arity: [0, 1] },
   datetime: { factory: datetime, arity: [0, 1] },
   ymd: { factory: ymd, arity: [0, 1] },
-  hms: { factory: hms, arity: [0, 1] }
+  hms: { factory: hms, arity: [0, 1] },
+  // the core set of 4.0.0-rc.3 (the core's own: eq ne not lt le gt ge falsy truthy boolean)
+  eq: eq2,
+  ne: ne2,
+  not: not2,
+  lt,
+  le,
+  gt,
+  ge,
+  add: numeric("add", (value, opt) => value + opt),
+  sub: numeric("sub", (value, opt) => value - opt),
+  mul: numeric("mul", (value, opt) => value * opt),
+  div: numeric("div", (value, opt) => value / opt),
+  mod: numeric("mod", (value, opt) => value % opt),
+  abs: { factory: abs, arity: [0, 0] },
+  clamp: { factory: clamp, arity: [2, 2] },
+  int: { factory: int, arity: [0, 0] },
+  float: { factory: float, arity: [0, 0] },
+  falsy: falsy2,
+  truthy: truthy2,
+  defaults: { factory: defaults, arity: [1, 1] },
+  coalesce: { factory: coalesce, arity: [1, 1] },
+  boolean: boolean2,
+  number: { factory: number, arity: [0, 0] },
+  string: { factory: string, arity: [0, 0] },
+  nullIfEmpty: { factory: nullIfEmpty, arity: [0, 0] }
 };
+var formatFilters = /* @__PURE__ */ Object.fromEntries(
+  /* @__PURE__ */ Object.entries(registered).filter(([name]) => !(name in coreFilters))
+);
 var STRUCTURAL_BINDING_TYPE_SET2 = /* @__PURE__ */ new Set([
   "if",
   "elseif",
@@ -2573,10 +2593,18 @@ function getWcsManifest() {
     ],
     // every option is a boolean, true when left out (engine.ts `loadTarget`: `typeof … === "boolean"`, `?? true`)
     behaviorOptions: Object.fromEntries(BEHAVIOR_OPTION_KEYS.map((key) => [key, { type: "boolean", default: true }])),
-    features: [...FEATURE_NAMES]
+    features: [...FEATURE_NAMES],
+    nativeCommands: Object.fromEntries(Object.entries(NATIVE_COMMANDS).map(([tag, methods]) => [tag, [...methods]]))
   };
 }
 
+// src/service/wcsManifest.ts
+var NATIVE_COMMANDS2 = getWcsManifest().nativeCommands ?? null;
+function nativeCommandsOf(tag) {
+  if (NATIVE_COMMANDS2 === null) return null;
+  return [...NATIVE_COMMANDS2["*"] ?? [], ...Object.hasOwn(NATIVE_COMMANDS2, tag) ? NATIVE_COMMANDS2[tag] : []];
+}
+
 // src/service/completionData.ts
 var BUILTIN_FILTERS = Object.entries(builtinFilterMeta).map(
   ([name, meta]) => ({ name, ...meta })
@@ -2592,6 +2620,41 @@ var STRUCTURAL_DIRECTIVES = [...STRUCTURAL_BINDING_TYPE_SET2].map((name) => ({
   ...STRUCTURAL_DIRECTIVE_INFO[name]
 }));
 
+// src/service/suggestion.ts
+function suggestion(input, candidates, msgs) {
+  let best = null;
+  let bestDistance = 3;
+  for (const c of candidates) {
+    const d = editDistance2(input.toLowerCase(), c.toLowerCase(), bestDistance);
+    if (d < bestDistance) {
+      best = c;
+      bestDistance = d;
+    }
+  }
+  return best !== null ? msgs.didYouMean(best) : "";
+}
+function editDistance2(a, b, bound) {
+  if (Math.abs(a.length - b.length) >= bound) return bound;
+  const prev = new Array(b.length + 1);
+  const curr = new Array(b.length + 1);
+  for (let j = 0; j <= b.length; j++) prev[j] = j;
+  for (let i = 1; i <= a.length; i++) {
+    curr[0] = i;
+    let rowMin = curr[0];
+    for (let j = 1; j <= b.length; j++) {
+      curr[j] = Math.min(
+        prev[j] + 1,
+        curr[j - 1] + 1,
+        prev[j - 1] + (a[i - 1] === b[j - 1] ? 0 : 1)
+      );
+      if (curr[j] < rowMin) rowMin = curr[j];
+    }
+    if (rowMin >= bound) return bound;
+    for (let j = 0; j <= b.length; j++) prev[j] = curr[j];
+  }
+  return Math.min(prev[b.length], bound);
+}
+
 // src/service/recursionPaths.ts
 var RECURSION_WILDCARD2 = "**";
 var RECURSION_KEY = "$recursion";
@@ -10319,6 +10382,7 @@ var ja = {
   featuresAttrNotRoot: () => `features \u5C5E\u6027\u3092\u8AAD\u3080\u306E\u306F\u6587\u66F8\u306E root \u306E <wcs-state>\uFF08mount \u3068 bind-component \u3092\u6301\u305F\u306A\u3044\u6700\u521D\u306E\u3082\u306E\uFF09\u3060\u3051\u3067\u3059\u3002\u3053\u306E\u8981\u7D20\u306E features \u306F\u7121\u8996\u3055\u308C\u307E\u3059 \u2014 root \u306E <wcs-state> \u306B\u66F8\u3044\u3066\u304F\u3060\u3055\u3044`,
   onPrefixedMember: (member, tag, modifiers) => `"${member}" \u306F <${tag}> \u306E\u30E1\u30F3\u30D0\u30FC\u3067\u3059\u304C\u3001"on" \u3067\u59CB\u307E\u308B\u540D\u524D\u306F\u30A4\u30D9\u30F3\u30C8\u675F\u7E1B\u306B\u306A\u308A\uFF08"${member.slice(2)}" \u30A4\u30D9\u30F3\u30C8\u3092\u5F85\u3064\uFF09\u3001\u5024\u306F\u5C4A\u304D\u307E\u305B\u3093\u3002\u30D7\u30ED\u30D1\u30C6\u30A3\u3068\u3057\u3066\u675F\u7E1B\u3059\u308B\u306B\u306F ".${member}${modifiers ? `#${modifiers}` : ""}:" \u3068\u66F8\u3044\u3066\u304F\u3060\u3055\u3044\uFF08@wcstack/state 3.1\uFF09`,
   tagCommandUnknown: (name, tag, declared) => `"${name}" \u306F <${tag}> \u306E command \u3067\u306F\u3042\u308A\u307E\u305B\u3093\uFF08\u5BA3\u8A00\u6E08\u307F: ${declared}\uFF09`,
+  nativeCommandUnknown: (method, tag, allowed) => `"${method}" \u306F\u30CD\u30A4\u30C6\u30A3\u30D6\u306E <${tag}> \u306B command \u3067\u547C\u3079\u308B\u30E1\u30BD\u30C3\u30C9\u3067\u306F\u3042\u308A\u307E\u305B\u3093\uFF08\u547C\u3079\u308B\u306E\u306F ${allowed}\u3002\u30E9\u30F3\u30BF\u30A4\u30E0\u306F\u521D\u671F\u5316\u3067 wcs/token-misconfigured \u3092\u6295\u3052\u307E\u3059\uFF09`,
   spreadNoBindable: (tag) => `'...'\uFF08spread\uFF09\u306F <${tag}> \u306B\u6709\u52B9\u306A wcBindable \u5BA3\u8A00\u304C\u5FC5\u8981\u3067\u3059 \u2014 \u3053\u306E\u30BF\u30B0\u306F\u5BA3\u8A00\u3092\u6301\u305F\u306A\u3044\u305F\u3081\u3001\u30E9\u30F3\u30BF\u30A4\u30E0\u306F\u30A8\u30E9\u30FC\u3092\u9001\u51FA\u3057\u307E\u3059`,
   tagEventTokenKeyUnknown: (name, tag, declared) => `eventToken \u306E\u30AD\u30FC "${name}" \u306F <${tag}> \u306E wcBindable \u30D7\u30ED\u30D1\u30C6\u30A3\u3067\u306F\u3042\u308A\u307E\u305B\u3093\u3002\u751F DOM \u30A4\u30D9\u30F3\u30C8\u540D\u306F\u767A\u706B\u3057\u307E\u305B\u3093 \u2014 \u30D7\u30ED\u30D1\u30C6\u30A3\u540D\u3092\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044\uFF08\u5BA3\u8A00\u6E08\u307F: ${declared}\uFF09`,
   ariaAttrUnknown: (name) => `"${name}" \u306F WAI-ARIA \u306E\u5C5E\u6027\u3067\u306F\u3042\u308A\u307E\u305B\u3093\u3002setAttribute \u306F\u305D\u306E\u307E\u307E\u66F8\u304D\u8FBC\u307F\u307E\u3059\u304C\u3001\u652F\u63F4\u6280\u8853\u306B\u306F\u9ED9\u3063\u3066\u7121\u8996\u3055\u308C\u307E\u3059`,
@@ -10504,6 +10568,7 @@ var en = {
   featuresAttrNotRoot: () => `The features attribute is read only on the document's root <wcs-state> (the first one without mount and bind-component); it is ignored here \u2014 put it on the root <wcs-state>`,
   onPrefixedMember: (member, tag, modifiers) => `"${member}" is a member of <${tag}>, but a name starting with "on" makes an event binding (it listens for a "${member.slice(2)}" event) and the value never arrives. Write ".${member}${modifiers ? `#${modifiers}` : ""}:" to bind the property (@wcstack/state 3.1)`,
   tagCommandUnknown: (name, tag, declared) => `"${name}" is not a command of <${tag}> (declared: ${declared})`,
+  nativeCommandUnknown: (method, tag, allowed) => `"${method}" is not a command of a native <${tag}> (its commands: ${allowed}; the runtime throws wcs/token-misconfigured at initialization)`,
   spreadNoBindable: (tag) => `'...' (spread) requires <${tag}> to expose a valid wcBindable declaration \u2014 this tag declares none, so the runtime raises an error`,
   tagEventTokenKeyUnknown: (name, tag, declared) => `eventToken key "${name}" is not a wcBindable property of <${tag}>. Raw DOM event names never fire \u2014 use the property name (declared: ${declared})`,
   ariaAttrUnknown: (name) => `"${name}" is not a WAI-ARIA attribute. setAttribute writes it anyway, and assistive technology silently ignores it`,
@@ -10894,6 +10959,18 @@ function validateBindings(html, attrName, stateTagName = "wcs-state", locale2, f
         scopedPaths.filter((p) => p.kind === "command").map((p) => p.path)
       );
       if (propNoMod.startsWith("command.")) {
+        const allowed = attr.tagName !== void 0 && !attr.tagName.includes("-") ? nativeCommandsOf(attr.tagName) : null;
+        const method = propNoMod.slice("command.".length);
+        if (allowed !== null && !allowed.includes(method)) {
+          const methodStart = bindingStart + binding.indexOf("command.") + "command.".length;
+          diagnostics.push({
+            code: WcsDiagnosticCode.TokenMisconfigured,
+            start: methodStart,
+            end: methodStart + method.length,
+            message: msgs.nativeCommandUnknown(method, attr.tagName, allowed.join(", ")) + suggestion(method, allowed, msgs),
+            severity: "error"
+          });
+        }
         const tokenPath = parsed.path?.trim() ?? "";
         if (tokenPath) {
           const pathOffset = binding.indexOf(parsed.path);
@@ -13504,39 +13581,6 @@ function normalizeSeed(raw) {
   const compact = raw.replace(/\s+/g, "");
   return compact === "" ? raw : compact;
 }
-function suggestion(input, candidates, msgs) {
-  let best = null;
-  let bestDistance = 3;
-  for (const c of candidates) {
-    const d = editDistance2(input.toLowerCase(), c.toLowerCase(), bestDistance);
-    if (d < bestDistance) {
-      best = c;
-      bestDistance = d;
-    }
-  }
-  return best !== null ? msgs.didYouMean(best) : "";
-}
-function editDistance2(a, b, bound) {
-  if (Math.abs(a.length - b.length) >= bound) return bound;
-  const prev = new Array(b.length + 1);
-  const curr = new Array(b.length + 1);
-  for (let j = 0; j <= b.length; j++) prev[j] = j;
-  for (let i = 1; i <= a.length; i++) {
-    curr[0] = i;
-    let rowMin = curr[0];
-    for (let j = 1; j <= b.length; j++) {
-      curr[j] = Math.min(
-        prev[j] + 1,
-        curr[j - 1] + 1,
-        prev[j - 1] + (a[i - 1] === b[j - 1] ? 0 : 1)
-      );
-      if (curr[j] < rowMin) rowMin = curr[j];
-    }
-    if (rowMin >= bound) return bound;
-    for (let j = 0; j <= b.length; j++) prev[j] = curr[j];
-  }
-  return Math.min(prev[b.length], bound);
-}
 function findBuiltinTagOccurrences(html) {
   const out = [];
   const regex = /<(wcs-[a-z0-9-]+)((?:"[^"]*"|'[^']*'|[^>"'])*)>/gi;

package/dist/tsc-core.cjs

@@ -64,8 +64,8 @@ function matchRawTextElement(html, lower2, pos) {
   return null;
 }
 function afterCloseTag(html, closeStart) {
-  const gt = html.indexOf(">", closeStart);
-  return gt === -1 ? html.length : gt + 1;
+  const gt2 = html.indexOf(">", closeStart);
+  return gt2 === -1 ? html.length : gt2 + 1;
 }
 function parseWcsStateElements(html, stateTagName = "wcs-state") {
   const elements = [];
@@ -221,32 +221,8 @@ var hooks = {};
 function raiseError(message, subject, candidates) {
   throw new Error(`[@wcstack/state] ${message}${hooks.explain?.(message, subject, candidates) ?? ""}`);
 }
-var CODES = [
-  "",
-  "binding-syntax",
-  "template-syntax",
-  "binding-path-missing",
-  "binding-type-expectation",
-  "filter-unknown",
-  "filter-arity",
-  "getter-cycle",
-  "getter-depth-exceeded",
-  "index-arity",
-  "index-param-range",
-  "recursion-unsupported",
-  "token-misconfigured",
-  "token-undeclared",
-  "wildcard-rank",
-  "spread-no-bindable",
-  "declaration-alias",
-  "name-alias"
-];
-var codeOf = (id) => {
-  const c = CODES[id / 100 | 0];
-  return c ? `[wcs/${c}] ` : "";
-};
 function text(id, args = []) {
-  return hooks.render?.(id, args) ?? `${codeOf(id)}#${id}${args.map((a) => ` ${typeof a === "string" ? JSON.stringify(a) : String(a)}`).join("")}`;
+  return hooks.render?.(id, args) ?? `#${id}${args.map((a) => ` ${typeof a === "string" ? JSON.stringify(a) : String(a)}`).join("")}`;
 }
 function raise(id, args, subject, candidates) {
   raiseError(text(id, args), subject, candidates);
@@ -261,7 +237,17 @@ var config = {
   locale: typeof document !== "undefined" ? document.documentElement?.lang || "en" : "en",
   enableContractAnalyzer: false
 };
-var FEATURE_NAMES = ["formats", "diagnostics", "temporal", "list-keys", "scopes", "recursion", "ssr", "devtools"];
+var FEATURE_NAMES = ["formats", "diagnostics", "temporal", "list-keys", "scopes", "recursion", "ssr", "devtools", "native-commands"];
+var NATIVE_COMMANDS = {
+  "*": ["focus", "blur", "click", "scrollIntoView", "showPopover", "hidePopover", "togglePopover"],
+  "dialog": ["show", "showModal", "close", "requestClose"],
+  "form": ["requestSubmit", "checkValidity", "reportValidity"],
+  "input": ["select", "setSelectionRange", "showPicker", "setCustomValidity", "checkValidity", "reportValidity"],
+  "textarea": ["select", "setSelectionRange", "setCustomValidity", "checkValidity", "reportValidity"],
+  "select": ["showPicker", "setCustomValidity", "checkValidity", "reportValidity"],
+  "audio": ["play", "pause", "load"],
+  "video": ["play", "pause", "load"]
+};
 var WILDCARD = "*";
 function optionsRequired(fnName) {
   raise(26, [fnName]);
@@ -350,42 +336,6 @@ var numeric = (name, op) => ({
 var truthy = () => (value) => !!value;
 var falsy = () => (value) => !value;
 var boolean = () => (value) => Boolean(value);
-var abs = () => (value) => {
-  if (typeof value !== "number") {
-    valueMustBeNumber("abs");
-  }
-  return Math.abs(value);
-};
-var clamp = (options) => {
-  const min = requiredNumberOption(options, 0, "clamp");
-  const max = requiredNumberOption(options, 1, "clamp");
-  return (value) => {
-    if (typeof value !== "number") {
-      valueMustBeNumber("clamp");
-    }
-    return Math.min(Math.max(value, min), max);
-  };
-};
-var number = () => (value) => Number(value);
-var string = () => (value) => String(value);
-var int = () => (value) => parseInt(String(value), 10);
-var float = () => (value) => parseFloat(String(value));
-var defaults = (options, literals) => {
-  const opt = options?.[0] ?? optionsRequired("defaults");
-  const fallback = firstLiteral(opt, literals);
-  return (value) => {
-    if (!value) {
-      return fallback;
-    }
-    return value;
-  };
-};
-var coalesce = (options, literals) => {
-  const opt = options?.[0] ?? optionsRequired("coalesce");
-  const fallback = firstLiteral(opt, literals);
-  return (value) => value ?? fallback;
-};
-var nullIfEmpty = () => (value) => value === "" ? null : value;
 var coreFilters = {
   eq: { factory: eq, arity: [1, 1] },
   ne: { factory: ne, arity: [1, 1] },
@@ -394,23 +344,9 @@ var coreFilters = {
   le: numeric("le", (value, opt) => value <= opt),
   gt: numeric("gt", (value, opt) => value > opt),
   ge: numeric("ge", (value, opt) => value >= opt),
-  add: numeric("add", (value, opt) => value + opt),
-  sub: numeric("sub", (value, opt) => value - opt),
-  mul: numeric("mul", (value, opt) => value * opt),
-  div: numeric("div", (value, opt) => value / opt),
-  mod: numeric("mod", (value, opt) => value % opt),
-  abs: { factory: abs, arity: [0, 0] },
-  clamp: { factory: clamp, arity: [2, 2] },
-  int: { factory: int, arity: [0, 0] },
-  float: { factory: float, arity: [0, 0] },
   falsy: { factory: falsy, arity: [0, 0] },
   truthy: { factory: truthy, arity: [0, 0] },
-  defaults: { factory: defaults, arity: [1, 1] },
-  coalesce: { factory: coalesce, arity: [1, 1] },
-  boolean: { factory: boolean, arity: [0, 0] },
-  number: { factory: number, arity: [0, 0] },
-  string: { factory: string, arity: [0, 0] },
-  nullIfEmpty: { factory: nullIfEmpty, arity: [0, 0] }
+  boolean: { factory: boolean, arity: [0, 0] }
 };
 var nullishPassthrough = (factory) => (options) => {
   const filterFn = factory(options);
@@ -595,7 +531,44 @@ var hms = (options) => {
     return `${hours}${opt}${minutes}${opt}${seconds}`;
   };
 };
-var formatFilters = {
+var abs = () => (value) => {
+  if (typeof value !== "number") {
+    valueMustBeNumber("abs");
+  }
+  return Math.abs(value);
+};
+var clamp = (options) => {
+  const min = requiredNumberOption(options, 0, "clamp");
+  const max = requiredNumberOption(options, 1, "clamp");
+  return (value) => {
+    if (typeof value !== "number") {
+      valueMustBeNumber("clamp");
+    }
+    return Math.min(Math.max(value, min), max);
+  };
+};
+var number = () => (value) => Number(value);
+var string = () => (value) => String(value);
+var int = () => (value) => parseInt(String(value), 10);
+var float = () => (value) => parseFloat(String(value));
+var defaults = (options, literals) => {
+  const opt = options?.[0] ?? optionsRequired("defaults");
+  const fallback = firstLiteral(opt, literals);
+  return (value) => {
+    if (!value) {
+      return fallback;
+    }
+    return value;
+  };
+};
+var coalesce = (options, literals) => {
+  const opt = options?.[0] ?? optionsRequired("coalesce");
+  const fallback = firstLiteral(opt, literals);
+  return (value) => value ?? fallback;
+};
+var nullIfEmpty = () => (value) => value === "" ? null : value;
+var { eq: eq2, ne: ne2, not: not2, lt, le, gt, ge, falsy: falsy2, truthy: truthy2, boolean: boolean2 } = coreFilters;
+var registered = {
   toFixed: { factory: toFixed, arity: [0, 1] },
   locale: { factory: locale, arity: [0, 1] },
   // The `String(value)` family passes an absent value through (B8 — see nullishPassthrough)
@@ -621,8 +594,36 @@ var formatFilters = {
   time: { factory: time, arity: [0, 1] },
   datetime: { factory: datetime, arity: [0, 1] },
   ymd: { factory: ymd, arity: [0, 1] },
-  hms: { factory: hms, arity: [0, 1] }
+  hms: { factory: hms, arity: [0, 1] },
+  // the core set of 4.0.0-rc.3 (the core's own: eq ne not lt le gt ge falsy truthy boolean)
+  eq: eq2,
+  ne: ne2,
+  not: not2,
+  lt,
+  le,
+  gt,
+  ge,
+  add: numeric("add", (value, opt) => value + opt),
+  sub: numeric("sub", (value, opt) => value - opt),
+  mul: numeric("mul", (value, opt) => value * opt),
+  div: numeric("div", (value, opt) => value / opt),
+  mod: numeric("mod", (value, opt) => value % opt),
+  abs: { factory: abs, arity: [0, 0] },
+  clamp: { factory: clamp, arity: [2, 2] },
+  int: { factory: int, arity: [0, 0] },
+  float: { factory: float, arity: [0, 0] },
+  falsy: falsy2,
+  truthy: truthy2,
+  defaults: { factory: defaults, arity: [1, 1] },
+  coalesce: { factory: coalesce, arity: [1, 1] },
+  boolean: boolean2,
+  number: { factory: number, arity: [0, 0] },
+  string: { factory: string, arity: [0, 0] },
+  nullIfEmpty: { factory: nullIfEmpty, arity: [0, 0] }
 };
+var formatFilters = /* @__PURE__ */ Object.fromEntries(
+  /* @__PURE__ */ Object.entries(registered).filter(([name]) => !(name in coreFilters))
+);
 var STRUCTURAL_BINDING_TYPE_SET = /* @__PURE__ */ new Set([
   "if",
   "elseif",
@@ -758,10 +759,14 @@ function getWcsManifest() {
     ],
     // every option is a boolean, true when left out (engine.ts `loadTarget`: `typeof … === "boolean"`, `?? true`)
     behaviorOptions: Object.fromEntries(BEHAVIOR_OPTION_KEYS.map((key) => [key, { type: "boolean", default: true }])),
-    features: [...FEATURE_NAMES]
+    features: [...FEATURE_NAMES],
+    nativeCommands: Object.fromEntries(Object.entries(NATIVE_COMMANDS).map(([tag, methods]) => [tag, [...methods]]))
   };
 }
 
+// src/service/wcsManifest.ts
+var NATIVE_COMMANDS2 = getWcsManifest().nativeCommands ?? null;
+
 // src/language/preamble.ts
 var manifest = getWcsManifest();
 var BEHAVIOR_TYPE = `{ ${Object.entries(manifest.behaviorOptions).map(([key, option]) => `${key}?: ${option.type}`).join("; ")} }`;

package/dist/wcs-schema.mjs

@@ -573,7 +573,7 @@ function loadSchemaCore() {
     return cached;
 }
 
-var version = "4.0.0-rc.3";
+var version = "4.0.0-rc.5";
 var pkg = {
 	version: version};
 

package/dist/wcs-tsc.mjs

@@ -5,7 +5,7 @@ import { tmpdir } from 'node:os';
 import { dirname, join, isAbsolute, resolve, basename } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
-var version = "4.0.0-rc.3";
+var version = "4.0.0-rc.5";
 var pkg = {
 	version: version};
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wcstack/typescript",
-  "version": "4.0.0-rc.3",
+  "version": "4.0.0-rc.5",
   "description": "TypeScript tooling for wcstack apps: wcs-schema generates the sidecar stateSchema from a typed state file, so wcs-validate checks data-wcs paths against real types in CI and every editor.",
   "type": "module",
   "main": "./dist/index.esm.js",