@kubohiroya/turbowarp-structured-data 0.6.0 → 0.6.1

package/README.ja.md

@@ -71,3 +71,16 @@ pnpm run check
 SPDX-License-Identifier: MPL-2.0
 
 bundleへ含まれるthird-party softwareのlicenseは[THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)に記載します。
+
+## 固定引数の編集フォーム（S3-4）
+
+共通エディターの起動時フラグ `blockEditorFixedInputs` とDialogsがONのGUIでは、`forEachAtPath` の `MAX` だけを固定フォームとして登録します。旧GUI・フラグOFFでは追加登録を行いません。Schemaの正本は `schemas/block-editor-fixed-inputs.schema.json#/$defs/forEachAtPath/properties/MAX`、codecと登録は `src/fixed-input-editors.ts` です。既存raw値・未変更alias・未知enumは無操作保存で書き換えず、reporterを評価しません。明示変更だけを検査し、他の引数やブロック宣言、保存形式を変更しません。
+
+MAXは整数1〜1000です。新しい入力には共通の有限数値token規則も適用し、途中入力を保存しません。MVP flagがOFFなら登録せず、NAME/PATH・staticLiteral由来の接続可否を変更しません。
+
+登録はoptional API（apiVersion:1）に限定し、RUNTIME_DISPOSED/明示disposeで解除します。起動フラグOFF＋再読込で従来経路へ切り戻せます。依存を戻す場合はmanifest/lock/実解決を一組で復旧します。npm公開や後続段階の動的候補は含みません。
+
+Schemaが記述する契約の根拠は実getInfoの宣言と既存の純粋なruntime変換です。SchemaBundleのretrievalUriはこのローカル文書の識別子であり、URL配信済み・HTTP取得によるref解決を意味しません。Schemaは同梱文書だけでcompileします。
+既存MAXの非空finiteなNumber alias（例`001`・`+1`・`0x10`）はNumberによる表示投影だけを行い、無変更rawを保存し直しません。空白・非finite・投影不能値はreadonlyとし、0/defaultを補いません。新しい入力にはこれらaliasを許可せずNP-finite-new-input-v1を適用します。
+
+登録は拡張インスタンスの構築時に存在する任意の editor API を使用します。後からの API 追加や差し替えには自動追従しません。起動設定を変更した場合は GUI を再読み込みし、拡張インスタンスを再構築してください。

package/README.md

@@ -23,7 +23,7 @@ JSON and YAML input is limited to 256 KiB, nesting depth 64, and 50,000 values.
 ## Installation
 
 ```bash
-pnpm add --save-exact @kubohiroya/turbowarp-structured-data@0.6.0
+pnpm add --save-exact @kubohiroya/turbowarp-structured-data@0.6.1
 ```
 
 ## Quick start
@@ -243,3 +243,16 @@ pnpm run check
 SPDX-License-Identifier: MPL-2.0
 
 Bundled third-party license terms are listed in [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).
+
+## 固定引数の編集フォーム（S3-4）
+
+共通エディターの起動時フラグ `blockEditorFixedInputs` とDialogsがONのGUIでは、`forEachAtPath` の `MAX` だけを固定フォームとして登録します。旧GUI・フラグOFFでは追加登録を行いません。Schemaの正本は `schemas/block-editor-fixed-inputs.schema.json#/$defs/forEachAtPath/properties/MAX`、codecと登録は `src/fixed-input-editors.ts` です。既存raw値・未変更alias・未知enumは無操作保存で書き換えず、reporterを評価しません。明示変更だけを検査し、他の引数やブロック宣言、保存形式を変更しません。
+
+MAXは整数1〜1000です。新しい入力には共通の有限数値token規則も適用し、途中入力を保存しません。MVP flagがOFFなら登録せず、NAME/PATH・staticLiteral由来の接続可否を変更しません。
+
+登録はoptional API（apiVersion:1）に限定し、RUNTIME_DISPOSED/明示disposeで解除します。起動フラグOFF＋再読込で従来経路へ切り戻せます。依存を戻す場合はmanifest/lock/実解決を一組で復旧します。npm公開や後続段階の動的候補は含みません。
+
+Schemaが記述する契約の根拠は実getInfoの宣言と既存の純粋なruntime変換です。SchemaBundleのretrievalUriはこのローカル文書の識別子であり、URL配信済み・HTTP取得によるref解決を意味しません。Schemaは同梱文書だけでcompileします。
+既存MAXの非空finiteなNumber alias（例`001`・`+1`・`0x10`）はNumberによる表示投影だけを行い、無変更rawを保存し直しません。空白・非finite・投影不能値はreadonlyとし、0/defaultを補いません。新しい入力にはこれらaliasを許可せずNP-finite-new-input-v1を適用します。
+
+Registration uses the optional editor API available when the extension instance is constructed. Adding or replacing that API later is not followed automatically; reload the GUI and reconstruct the extension instance after changing the startup configuration.

package/dist/structured-data.js

@@ -65,6 +65,66 @@
   	docsURI: "https://kubohiroya.github.io/turbowarp-structured-data/",
   	blockIconURI: "data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCA0OCA0OCI+PHJlY3QgeD0iNCIgeT0iOCIgd2lkdGg9IjE4IiBoZWlnaHQ9IjE0IiByeD0iMyIgZmlsbD0iIzRDOTdGRiIvPjxyZWN0IHg9IjI2IiB5PSI4IiB3aWR0aD0iMTgiIGhlaWdodD0iMTQiIHJ4PSIzIiBmaWxsPSIjNTlDMDU5Ii8+PHJlY3QgeD0iMTUiIHk9IjI2IiB3aWR0aD0iMTgiIGhlaWdodD0iMTQiIHJ4PSIzIiBmaWxsPSIjRkZBQjE5Ii8+PC9zdmc+"
   };
+  var JsonSnapshotError = class extends Error {
+  	constructor(kind, dataPath) {
+  		super("JSON snapshot failed.");
+  		this.kind = kind;
+  		this.dataPath = dataPath;
+  	}
+  };
+  function appendPointer(path, key) {
+  	return `${path}/${key.replace(/~/g, "~0").replace(/\//g, "~1")}`;
+  }
+  /** Copy JSON values without invoking accessors, toJSON, or input iterators. */
+  function snapshotJson(value) {
+  	const active = /* @__PURE__ */ new WeakSet();
+  	let remaining = 1e5;
+  	const visit = (input, path, depth) => {
+  		if (--remaining < 0 || depth > 128) throw new JsonSnapshotError("limit", path);
+  		if (input === null || typeof input === "string" || typeof input === "boolean") return input;
+  		if (typeof input === "number" && Number.isFinite(input)) return input;
+  		if (typeof input !== "object" || input === null || active.has(input)) throw new JsonSnapshotError("invalid", path);
+  		const array = Array.isArray(input);
+  		const prototype = Object.getPrototypeOf(input);
+  		if (!array && prototype !== null && prototype !== Object.prototype) throw new JsonSnapshotError("invalid", path);
+  		if (Object.getOwnPropertySymbols(input).length) throw new JsonSnapshotError("invalid", path);
+  		active.add(input);
+  		try {
+  			if (array) {
+  				const length = input.length;
+  				if (!Number.isSafeInteger(length) || length > remaining) throw new JsonSnapshotError("limit", path);
+  				const result = [];
+  				for (let i = 0; i < length; i++) {
+  					const child = appendPointer(path, String(i));
+  					const descriptor = Object.getOwnPropertyDescriptor(input, i);
+  					if (!descriptor || !("value" in descriptor)) throw new JsonSnapshotError("invalid", child);
+  					result.push(visit(descriptor.value, child, depth + 1));
+  				}
+  				for (const key of Object.keys(input)) if (!/^(0|[1-9][0-9]*)$/.test(key) || Number(key) >= length) throw new JsonSnapshotError("invalid", appendPointer(path, key));
+  				return result;
+  			}
+  			const result = {};
+  			for (const key of Object.keys(input)) {
+  				const child = appendPointer(path, key);
+  				const descriptor = Object.getOwnPropertyDescriptor(input, key);
+  				if (!descriptor || !("value" in descriptor)) throw new JsonSnapshotError("invalid", child);
+  				Object.defineProperty(result, key, {
+  					value: visit(descriptor.value, child, depth + 1),
+  					enumerable: true,
+  					writable: true,
+  					configurable: true
+  				});
+  			}
+  			return result;
+  		} finally {
+  			active.delete(input);
+  		}
+  	};
+  	return visit(value, "", 0);
+  }
+  function isJsonRecord(value) {
+  	return value !== null && typeof value === "object" && !Array.isArray(value);
+  }
   var require_code$1 = /* @__PURE__ */ __commonJSMin(((exports) => {
   	Object.defineProperty(exports, "__esModule", { value: true });
   	exports.regexpCode = exports.getEsmExportName = exports.getProperty = exports.safeStringify = exports.stringify = exports.strConcat = exports.addCodeArg = exports.str = exports._ = exports.nil = exports._Code = exports.Name = exports.IDENTIFIER = exports._CodeOrName = void 0;
@@ -2727,16 +2787,16 @@
   	}
   }));
   var data_exports = /* @__PURE__ */ __exportAll({
-  	$id: () => $id$9,
+  	$id: () => $id$10,
   	additionalProperties: () => false,
   	default: () => data_default,
   	description: () => description,
   	properties: () => properties$9,
   	required: () => required,
   	type: () => type$9
-  }), $id$9, description, type$9, required, properties$9, data_default;
+  }), $id$10, description, type$9, required, properties$9, data_default;
   var init_data = __esmMin((() => {
-  	$id$9 = "https://raw.githubusercontent.com/ajv-validator/ajv/master/lib/refs/data.json#";
+  	$id$10 = "https://raw.githubusercontent.com/ajv-validator/ajv/master/lib/refs/data.json#";
   	description = "Meta-schema for $data reference (JSON AnySchema extension proposal)";
   	type$9 = "object";
   	required = ["$data"];
@@ -2745,7 +2805,7 @@
   		"anyOf": [{ "format": "relative-json-pointer" }, { "format": "json-pointer" }]
   	} };
   	data_default = {
-  		$id: $id$9,
+  		$id: $id$10,
   		description,
   		type: type$9,
   		required,
@@ -5997,18 +6057,18 @@
   	};
   }));
   var json_schema_draft_07_exports = /* @__PURE__ */ __exportAll({
-  	$id: () => $id$8,
-  	$schema: () => $schema$8,
+  	$id: () => $id$9,
+  	$schema: () => $schema$9,
   	default: () => json_schema_draft_07_default,
   	definitions: () => definitions$1,
   	properties: () => properties$8,
   	title: () => title$8,
   	type: () => type$8
   });
-  var $schema$8, $id$8, title$8, definitions$1, type$8, properties$8, json_schema_draft_07_default;
+  var $schema$9, $id$9, title$8, definitions$1, type$8, properties$8, json_schema_draft_07_default;
   var init_json_schema_draft_07 = __esmMin((() => {
-  	$schema$8 = "http://json-schema.org/draft-07/schema#";
-  	$id$8 = "http://json-schema.org/draft-07/schema#";
+  	$schema$9 = "http://json-schema.org/draft-07/schema#";
+  	$id$9 = "http://json-schema.org/draft-07/schema#";
   	title$8 = "Core schema meta-schema";
   	definitions$1 = {
   		"schemaArray": {
@@ -6139,8 +6199,8 @@
   		"not": { "$ref": "#" }
   	};
   	json_schema_draft_07_default = {
-  		$schema: $schema$8,
-  		$id: $id$8,
+  		$schema: $schema$9,
+  		$id: $id$9,
   		title: title$8,
   		definitions: definitions$1,
   		type: type$8,
@@ -6512,8 +6572,8 @@
   var schema_exports = /* @__PURE__ */ __exportAll({
   	$comment: () => $comment,
   	$dynamicAnchor: () => $dynamicAnchor$7,
-  	$id: () => $id$7,
-  	$schema: () => $schema$7,
+  	$id: () => $id$8,
+  	$schema: () => $schema$8,
   	$vocabulary: () => $vocabulary$7,
   	allOf: () => allOf,
   	default: () => schema_default,
@@ -6521,10 +6581,10 @@
   	title: () => title$7,
   	type: () => type$7
   });
-  var $schema$7, $id$7, $vocabulary$7, $dynamicAnchor$7, title$7, allOf, type$7, $comment, properties$7, schema_default;
+  var $schema$8, $id$8, $vocabulary$7, $dynamicAnchor$7, title$7, allOf, type$7, $comment, properties$7, schema_default;
   var init_schema = __esmMin((() => {
-  	$schema$7 = "https://json-schema.org/draft/2020-12/schema";
-  	$id$7 = "https://json-schema.org/draft/2020-12/schema";
+  	$schema$8 = "https://json-schema.org/draft/2020-12/schema";
+  	$id$8 = "https://json-schema.org/draft/2020-12/schema";
   	$vocabulary$7 = {
   		"https://json-schema.org/draft/2020-12/vocab/core": true,
   		"https://json-schema.org/draft/2020-12/vocab/applicator": true,
@@ -6574,8 +6634,8 @@
   		}
   	};
   	schema_default = {
-  		$schema: $schema$7,
-  		$id: $id$7,
+  		$schema: $schema$8,
+  		$id: $id$8,
   		$vocabulary: $vocabulary$7,
   		$dynamicAnchor: $dynamicAnchor$7,
   		title: title$7,
@@ -6586,20 +6646,20 @@
   	};
   }));
   var applicator_exports = /* @__PURE__ */ __exportAll({
-  	$defs: () => $defs$2,
+  	$defs: () => $defs$3,
   	$dynamicAnchor: () => $dynamicAnchor$6,
-  	$id: () => $id$6,
-  	$schema: () => $schema$6,
+  	$id: () => $id$7,
+  	$schema: () => $schema$7,
   	$vocabulary: () => $vocabulary$6,
   	default: () => applicator_default,
   	properties: () => properties$6,
   	title: () => title$6,
   	type: () => type$6
   });
-  var $schema$6, $id$6, $vocabulary$6, $dynamicAnchor$6, title$6, type$6, properties$6, $defs$2, applicator_default;
+  var $schema$7, $id$7, $vocabulary$6, $dynamicAnchor$6, title$6, type$6, properties$6, $defs$3, applicator_default;
   var init_applicator = __esmMin((() => {
-  	$schema$6 = "https://json-schema.org/draft/2020-12/schema";
-  	$id$6 = "https://json-schema.org/draft/2020-12/meta/applicator";
+  	$schema$7 = "https://json-schema.org/draft/2020-12/schema";
+  	$id$7 = "https://json-schema.org/draft/2020-12/meta/applicator";
   	$vocabulary$6 = { "https://json-schema.org/draft/2020-12/vocab/applicator": true };
   	$dynamicAnchor$6 = "meta";
   	title$6 = "Applicator vocabulary meta-schema";
@@ -6634,36 +6694,36 @@
   		"oneOf": { "$ref": "#/$defs/schemaArray" },
   		"not": { "$dynamicRef": "#meta" }
   	};
-  	$defs$2 = { "schemaArray": {
+  	$defs$3 = { "schemaArray": {
   		"type": "array",
   		"minItems": 1,
   		"items": { "$dynamicRef": "#meta" }
   	} };
   	applicator_default = {
-  		$schema: $schema$6,
-  		$id: $id$6,
+  		$schema: $schema$7,
+  		$id: $id$7,
   		$vocabulary: $vocabulary$6,
   		$dynamicAnchor: $dynamicAnchor$6,
   		title: title$6,
   		type: type$6,
   		properties: properties$6,
-  		$defs: $defs$2
+  		$defs: $defs$3
   	};
   }));
   var unevaluated_exports = /* @__PURE__ */ __exportAll({
   	$dynamicAnchor: () => $dynamicAnchor$5,
-  	$id: () => $id$5,
-  	$schema: () => $schema$5,
+  	$id: () => $id$6,
+  	$schema: () => $schema$6,
   	$vocabulary: () => $vocabulary$5,
   	default: () => unevaluated_default,
   	properties: () => properties$5,
   	title: () => title$5,
   	type: () => type$5
   });
-  var $schema$5, $id$5, $vocabulary$5, $dynamicAnchor$5, title$5, type$5, properties$5, unevaluated_default;
+  var $schema$6, $id$6, $vocabulary$5, $dynamicAnchor$5, title$5, type$5, properties$5, unevaluated_default;
   var init_unevaluated = __esmMin((() => {
-  	$schema$5 = "https://json-schema.org/draft/2020-12/schema";
-  	$id$5 = "https://json-schema.org/draft/2020-12/meta/unevaluated";
+  	$schema$6 = "https://json-schema.org/draft/2020-12/schema";
+  	$id$6 = "https://json-schema.org/draft/2020-12/meta/unevaluated";
   	$vocabulary$5 = { "https://json-schema.org/draft/2020-12/vocab/unevaluated": true };
   	$dynamicAnchor$5 = "meta";
   	title$5 = "Unevaluated applicator vocabulary meta-schema";
@@ -6673,8 +6733,8 @@
   		"unevaluatedProperties": { "$dynamicRef": "#meta" }
   	};
   	unevaluated_default = {
-  		$schema: $schema$5,
-  		$id: $id$5,
+  		$schema: $schema$6,
+  		$id: $id$6,
   		$vocabulary: $vocabulary$5,
   		$dynamicAnchor: $dynamicAnchor$5,
   		title: title$5,
@@ -6684,18 +6744,18 @@
   }));
   var content_exports = /* @__PURE__ */ __exportAll({
   	$dynamicAnchor: () => $dynamicAnchor$4,
-  	$id: () => $id$4,
-  	$schema: () => $schema$4,
+  	$id: () => $id$5,
+  	$schema: () => $schema$5,
   	$vocabulary: () => $vocabulary$4,
   	default: () => content_default,
   	properties: () => properties$4,
   	title: () => title$4,
   	type: () => type$4
   });
-  var $schema$4, $id$4, $vocabulary$4, $dynamicAnchor$4, title$4, type$4, properties$4, content_default;
+  var $schema$5, $id$5, $vocabulary$4, $dynamicAnchor$4, title$4, type$4, properties$4, content_default;
   var init_content = __esmMin((() => {
-  	$schema$4 = "https://json-schema.org/draft/2020-12/schema";
-  	$id$4 = "https://json-schema.org/draft/2020-12/meta/content";
+  	$schema$5 = "https://json-schema.org/draft/2020-12/schema";
+  	$id$5 = "https://json-schema.org/draft/2020-12/meta/content";
   	$vocabulary$4 = { "https://json-schema.org/draft/2020-12/vocab/content": true };
   	$dynamicAnchor$4 = "meta";
   	title$4 = "Content vocabulary meta-schema";
@@ -6706,8 +6766,8 @@
   		"contentSchema": { "$dynamicRef": "#meta" }
   	};
   	content_default = {
-  		$schema: $schema$4,
-  		$id: $id$4,
+  		$schema: $schema$5,
+  		$id: $id$5,
   		$vocabulary: $vocabulary$4,
   		$dynamicAnchor: $dynamicAnchor$4,
   		title: title$4,
@@ -6716,20 +6776,20 @@
   	};
   }));
   var core_exports = /* @__PURE__ */ __exportAll({
-  	$defs: () => $defs$1,
+  	$defs: () => $defs$2,
   	$dynamicAnchor: () => $dynamicAnchor$3,
-  	$id: () => $id$3,
-  	$schema: () => $schema$3,
+  	$id: () => $id$4,
+  	$schema: () => $schema$4,
   	$vocabulary: () => $vocabulary$3,
   	default: () => core_default,
   	properties: () => properties$3,
   	title: () => title$3,
   	type: () => type$3
   });
-  var $schema$3, $id$3, $vocabulary$3, $dynamicAnchor$3, title$3, type$3, properties$3, $defs$1, core_default;
+  var $schema$4, $id$4, $vocabulary$3, $dynamicAnchor$3, title$3, type$3, properties$3, $defs$2, core_default;
   var init_core = __esmMin((() => {
-  	$schema$3 = "https://json-schema.org/draft/2020-12/schema";
-  	$id$3 = "https://json-schema.org/draft/2020-12/meta/core";
+  	$schema$4 = "https://json-schema.org/draft/2020-12/schema";
+  	$id$4 = "https://json-schema.org/draft/2020-12/meta/core";
   	$vocabulary$3 = { "https://json-schema.org/draft/2020-12/vocab/core": true };
   	$dynamicAnchor$3 = "meta";
   	title$3 = "Core vocabulary meta-schema";
@@ -6756,7 +6816,7 @@
   			"additionalProperties": { "$dynamicRef": "#meta" }
   		}
   	};
-  	$defs$1 = {
+  	$defs$2 = {
   		"anchorString": {
   			"type": "string",
   			"pattern": "^[A-Za-z_][-A-Za-z0-9._]*$"
@@ -6771,38 +6831,38 @@
   		}
   	};
   	core_default = {
-  		$schema: $schema$3,
-  		$id: $id$3,
+  		$schema: $schema$4,
+  		$id: $id$4,
   		$vocabulary: $vocabulary$3,
   		$dynamicAnchor: $dynamicAnchor$3,
   		title: title$3,
   		type: type$3,
   		properties: properties$3,
-  		$defs: $defs$1
+  		$defs: $defs$2
   	};
   }));
   var format_annotation_exports = /* @__PURE__ */ __exportAll({
   	$dynamicAnchor: () => $dynamicAnchor$2,
-  	$id: () => $id$2,
-  	$schema: () => $schema$2,
+  	$id: () => $id$3,
+  	$schema: () => $schema$3,
   	$vocabulary: () => $vocabulary$2,
   	default: () => format_annotation_default,
   	properties: () => properties$2,
   	title: () => title$2,
   	type: () => type$2
   });
-  var $schema$2, $id$2, $vocabulary$2, $dynamicAnchor$2, title$2, type$2, properties$2, format_annotation_default;
+  var $schema$3, $id$3, $vocabulary$2, $dynamicAnchor$2, title$2, type$2, properties$2, format_annotation_default;
   var init_format_annotation = __esmMin((() => {
-  	$schema$2 = "https://json-schema.org/draft/2020-12/schema";
-  	$id$2 = "https://json-schema.org/draft/2020-12/meta/format-annotation";
+  	$schema$3 = "https://json-schema.org/draft/2020-12/schema";
+  	$id$3 = "https://json-schema.org/draft/2020-12/meta/format-annotation";
   	$vocabulary$2 = { "https://json-schema.org/draft/2020-12/vocab/format-annotation": true };
   	$dynamicAnchor$2 = "meta";
   	title$2 = "Format vocabulary meta-schema for annotation results";
   	type$2 = ["object", "boolean"];
   	properties$2 = { "format": { "type": "string" } };
   	format_annotation_default = {
-  		$schema: $schema$2,
-  		$id: $id$2,
+  		$schema: $schema$3,
+  		$id: $id$3,
   		$vocabulary: $vocabulary$2,
   		$dynamicAnchor: $dynamicAnchor$2,
   		title: title$2,
@@ -6812,18 +6872,18 @@
   }));
   var meta_data_exports = /* @__PURE__ */ __exportAll({
   	$dynamicAnchor: () => $dynamicAnchor$1,
-  	$id: () => $id$1,
-  	$schema: () => $schema$1,
+  	$id: () => $id$2,
+  	$schema: () => $schema$2,
   	$vocabulary: () => $vocabulary$1,
   	default: () => meta_data_default,
   	properties: () => properties$1,
   	title: () => title$1,
   	type: () => type$1
   });
-  var $schema$1, $id$1, $vocabulary$1, $dynamicAnchor$1, title$1, type$1, properties$1, meta_data_default;
+  var $schema$2, $id$2, $vocabulary$1, $dynamicAnchor$1, title$1, type$1, properties$1, meta_data_default;
   var init_meta_data = __esmMin((() => {
-  	$schema$1 = "https://json-schema.org/draft/2020-12/schema";
-  	$id$1 = "https://json-schema.org/draft/2020-12/meta/meta-data";
+  	$schema$2 = "https://json-schema.org/draft/2020-12/schema";
+  	$id$2 = "https://json-schema.org/draft/2020-12/meta/meta-data";
   	$vocabulary$1 = { "https://json-schema.org/draft/2020-12/vocab/meta-data": true };
   	$dynamicAnchor$1 = "meta";
   	title$1 = "Meta-data vocabulary meta-schema";
@@ -6850,8 +6910,8 @@
   		}
   	};
   	meta_data_default = {
-  		$schema: $schema$1,
-  		$id: $id$1,
+  		$schema: $schema$2,
+  		$id: $id$2,
   		$vocabulary: $vocabulary$1,
   		$dynamicAnchor: $dynamicAnchor$1,
   		title: title$1,
@@ -6860,20 +6920,20 @@
   	};
   }));
   var validation_exports = /* @__PURE__ */ __exportAll({
-  	$defs: () => $defs,
+  	$defs: () => $defs$1,
   	$dynamicAnchor: () => $dynamicAnchor,
-  	$id: () => $id,
-  	$schema: () => $schema,
+  	$id: () => $id$1,
+  	$schema: () => $schema$1,
   	$vocabulary: () => $vocabulary,
   	default: () => validation_default,
   	properties: () => properties,
   	title: () => title,
   	type: () => type
   });
-  var $schema, $id, $vocabulary, $dynamicAnchor, title, type, properties, $defs, validation_default;
+  var $schema$1, $id$1, $vocabulary, $dynamicAnchor, title, type, properties, $defs$1, validation_default;
   var init_validation = __esmMin((() => {
-  	$schema = "https://json-schema.org/draft/2020-12/schema";
-  	$id = "https://json-schema.org/draft/2020-12/meta/validation";
+  	$schema$1 = "https://json-schema.org/draft/2020-12/schema";
+  	$id$1 = "https://json-schema.org/draft/2020-12/meta/validation";
   	$vocabulary = { "https://json-schema.org/draft/2020-12/vocab/validation": true };
   	$dynamicAnchor = "meta";
   	title = "Validation vocabulary meta-schema";
@@ -6923,7 +6983,7 @@
   			"additionalProperties": { "$ref": "#/$defs/stringArray" }
   		}
   	};
-  	$defs = {
+  	$defs$1 = {
   		"nonNegativeInteger": {
   			"type": "integer",
   			"minimum": 0
@@ -6949,14 +7009,14 @@
   		}
   	};
   	validation_default = {
-  		$schema,
-  		$id,
+  		$schema: $schema$1,
+  		$id: $id$1,
   		$vocabulary,
   		$dynamicAnchor,
   		title,
   		type,
   		properties,
-  		$defs
+  		$defs: $defs$1
   	};
   }));
   var require_json_schema_2020_12 = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -7349,66 +7409,6 @@
   	Object.defineProperty(exports, "__esModule", { value: true });
   	exports.default = formatsPlugin;
   }));
-  var JsonSnapshotError = class extends Error {
-  	constructor(kind, dataPath) {
-  		super("JSON snapshot failed.");
-  		this.kind = kind;
-  		this.dataPath = dataPath;
-  	}
-  };
-  function appendPointer(path, key) {
-  	return `${path}/${key.replace(/~/g, "~0").replace(/\//g, "~1")}`;
-  }
-  /** Copy JSON values without invoking accessors, toJSON, or input iterators. */
-  function snapshotJson(value) {
-  	const active = /* @__PURE__ */ new WeakSet();
-  	let remaining = 1e5;
-  	const visit = (input, path, depth) => {
-  		if (--remaining < 0 || depth > 128) throw new JsonSnapshotError("limit", path);
-  		if (input === null || typeof input === "string" || typeof input === "boolean") return input;
-  		if (typeof input === "number" && Number.isFinite(input)) return input;
-  		if (typeof input !== "object" || input === null || active.has(input)) throw new JsonSnapshotError("invalid", path);
-  		const array = Array.isArray(input);
-  		const prototype = Object.getPrototypeOf(input);
-  		if (!array && prototype !== null && prototype !== Object.prototype) throw new JsonSnapshotError("invalid", path);
-  		if (Object.getOwnPropertySymbols(input).length) throw new JsonSnapshotError("invalid", path);
-  		active.add(input);
-  		try {
-  			if (array) {
-  				const length = input.length;
-  				if (!Number.isSafeInteger(length) || length > remaining) throw new JsonSnapshotError("limit", path);
-  				const result = [];
-  				for (let i = 0; i < length; i++) {
-  					const child = appendPointer(path, String(i));
-  					const descriptor = Object.getOwnPropertyDescriptor(input, i);
-  					if (!descriptor || !("value" in descriptor)) throw new JsonSnapshotError("invalid", child);
-  					result.push(visit(descriptor.value, child, depth + 1));
-  				}
-  				for (const key of Object.keys(input)) if (!/^(0|[1-9][0-9]*)$/.test(key) || Number(key) >= length) throw new JsonSnapshotError("invalid", appendPointer(path, key));
-  				return result;
-  			}
-  			const result = {};
-  			for (const key of Object.keys(input)) {
-  				const child = appendPointer(path, key);
-  				const descriptor = Object.getOwnPropertyDescriptor(input, key);
-  				if (!descriptor || !("value" in descriptor)) throw new JsonSnapshotError("invalid", child);
-  				Object.defineProperty(result, key, {
-  					value: visit(descriptor.value, child, depth + 1),
-  					enumerable: true,
-  					writable: true,
-  					configurable: true
-  				});
-  			}
-  			return result;
-  		} finally {
-  			active.delete(input);
-  		}
-  	};
-  	return visit(value, "", 0);
-  }
-  function isJsonRecord(value) {
-  	return value !== null && typeof value === "object" && !Array.isArray(value);
-  }
   var import_ajv = require_ajv();
   var import__2020 = require__2020();
   var import_dist = /* @__PURE__ */ __toESM(require_dist(), 1);
@@ -7753,6 +7753,156 @@
   		});
   	}
   }
+  var numberToken = /^-?(?:0|[1-9][0-9]*)(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$/u;
+  var invalidNumber = Object.freeze({
+  	kind: "invalid",
+  	code: "fixed-number-input-invalid"
+  });
+  /**
+  * Parse a NEW numeric draft according to NP-finite-new-input-v1.
+  * Never apply this to opening/no-op raw values or use it as an owner validator.
+  * Keep the validated token so negative zero, precision and exponent spelling survive.
+  */
+  function parseFixedNumberInput(input) {
+  	if (typeof input === "number") {
+  		if (!Number.isFinite(input)) return invalidNumber;
+  		return Object.freeze({
+  			kind: "valid",
+  			token: Object.is(input, -0) ? "-0" : String(input),
+  			value: input
+  		});
+  	}
+  	if (typeof input !== "string") return invalidNumber;
+  	const token = input.trim();
+  	if (!numberToken.test(token)) return invalidNumber;
+  	const value = Number(token);
+  	return Number.isFinite(value) ? Object.freeze({
+  		kind: "valid",
+  		token,
+  		value
+  	}) : invalidNumber;
+  }
+  var block_editor_fixed_inputs_schema_default = {
+  	$schema: "https://json-schema.org/draft/2020-12/schema",
+  	$id: "https://kubohiroya.github.io/turbowarp-structured-data/schemas/block-editor-fixed-inputs.schema.json",
+  	$defs: { "forEachAtPath": {
+  		"type": "object",
+  		"properties": { "MAX": {
+  			"type": "integer",
+  			"minimum": 1,
+  			"maximum": 1e3
+  		} },
+  		"required": ["MAX"],
+  		"additionalProperties": true
+  	} }
+  };
+  var source$1 = {
+  	repository: "turbowarp-structured-data",
+  	path: "schemas/block-editor-fixed-inputs.schema.json",
+  	symbol: "#/$defs/forEachAtPath/properties/MAX"
+  };
+  /** The on-disk owner Schema is canonical; this is its single-field projection. */
+  var fixedInputSchemaBundle = {
+  	identity: {
+  		ownerId: "turbowarp-structured-data",
+  		contractId: "forEachAtPath.MAX",
+  		revision: "fixed-inputs-v1",
+  		variantId: "default"
+  	},
+  	dialect: "2020-12",
+  	root: {
+  		retrievalUri: "https://kubohiroya.github.io/turbowarp-structured-data/schemas/forEachAtPath-MAX.schema.json",
+  		document: block_editor_fixed_inputs_schema_default.$defs.forEachAtPath.properties.MAX,
+  		artifact: {
+  			role: "canonical-schema",
+  			source: source$1
+  		}
+  	},
+  	resources: [],
+  	provenance: {
+  		canonicalSources: [source$1, {
+  			repository: "turbowarp-structured-data",
+  			path: "src/core.ts",
+  			symbol: "iterationEntries"
+  		}],
+  		generatedFiles: [{
+  			repository: "turbowarp-structured-data",
+  			path: "docs/schemas/block-editor-fixed-inputs.schema.json"
+  		}],
+  		referenceSchemas: [],
+  		generationSources: [{
+  			repository: "turbowarp-structured-data",
+  			path: "scripts/generate-fixed-input-docs.mjs"
+  		}]
+  	}
+  };
+  var fixedInputEditorDefinitions = [{
+  	apiVersion: 1,
+  	extensionId: extensionConfig.id,
+  	editorId: "forEachAtPath-fixed-inputs",
+  	opcodes: [`${extensionConfig.id}_forEachAtPath`],
+  	contractId: "turbowarp-structured-data:forEachAtPath.MAX",
+  	contractRevision: "fixed-inputs-v1",
+  	bindings: [{
+  		argument: "MAX",
+  		schemaBundle: fixedInputSchemaBundle,
+  		control: {
+  			kind: "number",
+  			label: "MAX"
+  		},
+  		read(value) {
+  			if (typeof value !== "string" && typeof value !== "number") throw new TypeError("Expected a literal maximum.");
+  			if (typeof value === "string" && value.trim() === "") throw new TypeError("Blank maximum stays readonly.");
+  			const number = Number(value);
+  			if (!Number.isFinite(number)) throw new TypeError("Maximum must be finite.");
+  			return number;
+  		},
+  		encode(value) {
+  			const parsed = parseFixedNumberInput(value);
+  			if (parsed.kind !== "valid") throw new TypeError("Expected a finite numeric token.");
+  			return parsed.token;
+  		},
+  		validateCandidate(value) {
+  			const parsed = parseFixedNumberInput(value);
+  			return parsed.kind === "valid" && Number.isInteger(parsed.value) && parsed.value >= 1 && parsed.value <= 1e3 ? [] : [{
+  				path: "/inputs/MAX",
+  				message: "Maximum must be an integer from 1 to 1000."
+  			}];
+  		}
+  	}],
+  	validationContext: () => ({
+  		consumerId: extensionConfig.id,
+  		nowMs: Date.now(),
+  		settings: null
+  	})
+  }];
+  /** Register metadata only; the GUI startup capability owns editor activation. */
+  function registerFixedInputEditors(scratch, definitions, runtimeOverride) {
+  	const host = scratch;
+  	const api = host.gui?.blockEditors;
+  	if (!definitions.length || api?.apiVersion !== 1 || typeof api.registerFixedInputEditor !== "function") return () => {};
+  	const runtime = runtimeOverride ?? host.vm?.runtime;
+  	const removers = [];
+  	let active = true;
+  	const dispose = () => {
+  		if (!active) return;
+  		active = false;
+  		runtime?.off?.("RUNTIME_DISPOSED", dispose);
+  		for (const remove of removers.splice(0).reverse()) remove();
+  	};
+  	try {
+  		for (const definition of definitions) {
+  			const remove = api.registerFixedInputEditor.call(api, definition);
+  			if (typeof remove !== "function") throw new TypeError("Invalid fixed input registration disposer.");
+  			removers.push(remove);
+  		}
+  		runtime?.on?.("RUNTIME_DISPOSED", dispose);
+  	} catch (error) {
+  		dispose();
+  		throw error;
+  	}
+  	return dispose;
+  }
   function deepFreeze(value) {
   	if (value !== null && typeof value === "object") {
   		Object.values(value).forEach(deepFreeze);
@@ -14361,6 +14511,8 @@
   	"markdown",
   	"raw"
   ];
+  var NAMED_DATA_SCHEMA_ID_PATTERN = /^[a-z][a-z0-9.-]{0,127}$/u;
+  var NAMED_DATA_SCHEMA_VERSION_PATTERN = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[A-Za-z-][0-9A-Za-z-]*)(?:\.(?:0|[1-9]\d*|\d*[A-Za-z-][0-9A-Za-z-]*))*))?(?:\+([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?$/u;
   var NAMED_DATA_ERROR_CODES = [
   	"NAMED_DATA_INVALID_REF",
   	"NAMED_DATA_INVALID_REGISTRY",
@@ -14369,6 +14521,9 @@
   	"NAMED_DATA_NOT_FOUND",
   	"NAMED_DATA_KIND_MISMATCH",
   	"NAMED_DATA_SCOPE_MISMATCH",
+  	"NAMED_DATA_SCHEMA_NOT_FOUND",
+  	"NAMED_DATA_SCHEMA_VERSION_MISMATCH",
+  	"NAMED_DATA_SCHEMA_UNRESOLVED",
   	"NAMED_DATA_REPRESENTATION_UNSUPPORTED",
   	"NAMED_DATA_INVALID_METADATA",
   	"NAMED_DATA_BODY_TOO_LARGE",
@@ -14589,9 +14744,21 @@
   	if (!reference || typeof reference !== "object") throw invalidReference();
   	requireNamespace(reference.namespace);
   	if (typeof reference.name !== "string" || reference.name.length === 0 || reference.name.length > 256 || containsControlCharacter(reference.name) || !NAMED_DATA_KINDS.includes(reference.kind) || !NAMED_DATA_SCOPES.includes(reference.scope) || !NAMED_DATA_REPRESENTATIONS.includes(representation)) throw invalidReference();
+  	if (reference.schemaRef !== void 0) validateSchemaRef(reference.kind, reference.schemaRef);
   }
   function validateMetadata(metadata, reference, representation) {
   	if (metadata.representation !== representation || !isNativeRepresentation(metadata.reference.kind, metadata.nativeRepresentation) || metadata.reference.namespace !== reference.namespace || metadata.reference.name !== reference.name || metadata.reference.kind !== reference.kind || metadata.reference.scope !== reference.scope || typeof metadata.mediaType !== "string" || metadata.mediaType.length === 0 || typeof metadata.revision !== "string" || metadata.revision.length === 0 || typeof metadata.replayable !== "boolean" || metadata.byteLength !== void 0 && (!Number.isSafeInteger(metadata.byteLength) || metadata.byteLength < 0) || metadata.digest !== void 0 && !/^sha256-[A-Za-z0-9_-]+$/u.test(metadata.digest)) throw new NamedDataError("NAMED_DATA_INVALID_METADATA", "Provider returned invalid metadata.");
+  	const expectedSchema = reference.schemaRef;
+  	const actualSchema = metadata.schemaRef;
+  	if (actualSchema !== void 0) validateSchemaRef(metadata.reference.kind, actualSchema, "NAMED_DATA_INVALID_METADATA");
+  	if (metadata.reference.schemaRef !== void 0) validateSchemaRef(metadata.reference.kind, metadata.reference.schemaRef, "NAMED_DATA_INVALID_METADATA");
+  	if (!sameSchemaRef(expectedSchema, actualSchema) || !sameSchemaRef(expectedSchema, metadata.reference.schemaRef)) throw new NamedDataError("NAMED_DATA_SCHEMA_VERSION_MISMATCH", "Provider schemaRef does not match the requested reference.");
+  }
+  function validateSchemaRef(kind, schemaRef, errorCode = "NAMED_DATA_INVALID_REF") {
+  	if (kind !== "structured" || typeof schemaRef !== "object" || schemaRef === null || !NAMED_DATA_SCHEMA_ID_PATTERN.test(String(schemaRef.id ?? "")) || !NAMED_DATA_SCHEMA_VERSION_PATTERN.test(String(schemaRef.version ?? "")) || Object.keys(schemaRef).some((key) => key !== "id" && key !== "version")) throw new NamedDataError(errorCode, "Invalid schemaRef; schema references require a structured value, stable id, and full SemVer version.");
+  }
+  function sameSchemaRef(left, right) {
+  	return left === void 0 ? right === void 0 : right !== void 0 && left.id === right.id && left.version === right.version;
   }
   function isNativeRepresentation(kind, representation) {
   	if (kind === "structured") return representation === "json" || representation === "yaml";
@@ -14628,7 +14795,10 @@
   	const value = globalThis.__TW_NAMED_DATA_FEATURE_FLAGS__?.[name];
   	return value === true || value === "true";
   }
-  Object.freeze({ NAMED_DATA_REGISTRY_MVP: configuredFlag("NAMED_DATA_REGISTRY_MVP") });
+  Object.freeze({
+  	NAMED_DATA_REGISTRY_MVP: configuredFlag("NAMED_DATA_REGISTRY_MVP"),
+  	NAMED_DATA_SCHEMA_REF: configuredFlag("NAMED_DATA_SCHEMA_REF")
+  });
   var STRUCTURED_DATA_NAMESPACE = "structured";
   var STRUCTURED_BODY_MAX_BYTES = 262144;
   var StructuredDataNamedDataProvider = class {
@@ -14714,24 +14884,44 @@
   var blockDefinitions = block_definitions_default.blocks;
   var StructuredDataExtension = class {
   	constructor(enabled = isStructuredDataMvpEnabled(), namedDataEnabled = isNamedDataRegistryMvpEnabled()) {
+  		this.disposed = false;
   		this.registries = /* @__PURE__ */ new WeakMap();
   		this.iterationStacks = /* @__PURE__ */ new WeakMap();
   		this.nextRevision = 1;
   		this.enabled = enabled;
   		this.unregisterSourceEditors = registerSourceEditors(Scratch, enabled ? sourceEditorDefinitions : []);
-  		if (namedDataEnabled) {
-  			this.namedDataProvider = new StructuredDataNamedDataProvider({ get: (target, name) => this.registries.get(target)?.get(name) });
-  			const runtime = Scratch.vm?.runtime;
-  			if (runtime) {
-  				this.namedDataRegistry = installNamedDataRegistry(runtime);
-  				this.namedDataRegistration = this.namedDataRegistry.registerProvider(this.namedDataProvider, { lifetime: "persistent" });
-  				this.unbindNamedDataRegistryLifecycle = bindNamedDataRegistryLifecycle(runtime, this.namedDataRegistry);
-  				runtime.on?.("RUNTIME_DISPOSED", () => {
-  					this.dispose();
-  				});
+  		const runtime = Scratch.vm?.runtime;
+  		const onDispose = () => {
+  			this.dispose();
+  		};
+  		const onStop = () => this.clearRuntimeState();
+  		this.releaseRuntimeListeners = () => {
+  			runtime?.off?.("RUNTIME_DISPOSED", onDispose);
+  			runtime?.off?.("PROJECT_STOP_ALL", onStop);
+  		};
+  		let unregisterFixed = () => {};
+  		try {
+  			unregisterFixed = registerFixedInputEditors(Scratch, enabled ? fixedInputEditorDefinitions : []);
+  			this.unregisterFixedInputEditors = unregisterFixed;
+  			if (namedDataEnabled) {
+  				this.namedDataProvider = new StructuredDataNamedDataProvider({ get: (target, name) => this.registries.get(target)?.get(name) });
+  				const runtime = Scratch.vm?.runtime;
+  				if (runtime) {
+  					this.namedDataRegistry = installNamedDataRegistry(runtime);
+  					this.namedDataRegistration = this.namedDataRegistry.registerProvider(this.namedDataProvider, { lifetime: "persistent" });
+  					this.unbindNamedDataRegistryLifecycle = bindNamedDataRegistryLifecycle(runtime, this.namedDataRegistry);
+  					runtime.on?.("RUNTIME_DISPOSED", onDispose);
+  				}
   			}
+  			runtime?.on?.("PROJECT_STOP_ALL", onStop);
+  		} catch (error) {
+  			this.releaseRuntimeListeners();
+  			unregisterFixed();
+  			this.unregisterSourceEditors();
+  			this.unbindNamedDataRegistryLifecycle?.();
+  			this.namedDataRegistration?.unregister().catch(() => {});
+  			throw error;
   		}
-  		Scratch.vm?.runtime?.on?.("PROJECT_STOP_ALL", () => this.clearRuntimeState());
   	}
   	getNamedDataProvider() {
   		return this.namedDataProvider;
@@ -14740,6 +14930,10 @@
   		return this.namedDataRegistry;
   	}
   	async dispose() {
+  		if (this.disposed) return;
+  		this.disposed = true;
+  		this.releaseRuntimeListeners();
+  		this.unregisterFixedInputEditors();
   		this.unregisterSourceEditors();
   		await this.namedDataRegistration?.unregister();
   		this.unbindNamedDataRegistryLifecycle?.();

package/docs/index.html

@@ -52,7 +52,7 @@
 <li><a href="#block-currentIndex"><code>current index</code></a></li>
 <li><a href="#block-currentValueJson"><code>current value JSON</code></a></li>
 </ul></nav>
-<article id="block-parseJson" class="block-reference-entry"><h3><code>parse JSON [TEXT] as [NAME]</code></h3><p>Parse JSON text into the target-local structured data namespace.</p><p>Block type: COMMAND. Opcode: <code>parseJson</code>. <a href="#block-parseJson">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>TEXT</code></th><td>STRING</td><td><code>{&quot;name&quot;:&quot;TurboWarp&quot;}</code></td><td></td></tr><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>data</code></td><td></td></tr></tbody></table></div></article><article id="block-parseYaml" class="block-reference-entry"><h3><code>parse YAML [TEXT] as [NAME]</code></h3><p>Parse safe YAML text into the target-local structured data namespace.</p><p>Block type: COMMAND. Opcode: <code>parseYaml</code>. <a href="#block-parseYaml">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>TEXT</code></th><td>STRING</td><td><code>name: TurboWarp</code></td><td></td></tr><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>data</code></td><td></td></tr></tbody></table></div></article><article id="block-toJson" class="block-reference-entry"><h3><code>to JSON [NAME]</code></h3><p>Render named structured data as canonical JSON.</p><p>Block type: REPORTER. Opcode: <code>toJson</code>. <a href="#block-toJson">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>data</code></td><td></td></tr></tbody></table></div></article><article id="block-toYaml" class="block-reference-entry"><h3><code>to YAML [NAME]</code></h3><p>Render named structured data as deterministic YAML.</p><p>Block type: REPORTER. Opcode: <code>toYaml</code>. <a href="#block-toYaml">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>data</code></td><td></td></tr></tbody></table></div></article><article id="block-hasStructuredData" class="block-reference-entry"><h3><code>structured data [NAME] exists?</code></h3><p>Report whether the current target has named structured data.</p><p>Block type: BOOLEAN. Opcode: <code>hasStructuredData</code>. <a href="#block-hasStructuredData">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>data</code></td><td></td></tr></tbody></table></div></article><article id="block-deleteStructuredData" class="block-reference-entry"><h3><code>delete structured data [NAME]</code></h3><p>Delete named structured data from the current target.</p><p>Block type: COMMAND. Opcode: <code>deleteStructuredData</code>. <a href="#block-deleteStructuredData">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>data</code></td><td></td></tr></tbody></table></div></article><article id="block-getJsonAtPath" class="block-reference-entry"><h3><code>get JSON from [NAME] at path [PATH]</code></h3><p>Return a named value at a path as JSON.</p><p>Block type: REPORTER. Opcode: <code>getJsonAtPath</code>. <a href="#block-getJsonAtPath">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>data</code></td><td></td></tr><tr><th scope="row"><code>PATH</code></th><td>STRING</td><td><code>$.name</code></td><td></td></tr></tbody></table></div></article><article id="block-hasPath" class="block-reference-entry"><h3><code>structured data [NAME] has path [PATH]?</code></h3><p>Report whether a path exists in named structured data.</p><p>Block type: BOOLEAN. Opcode: <code>hasPath</code>. <a href="#block-hasPath">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>data</code></td><td></td></tr><tr><th scope="row"><code>PATH</code></th><td>STRING</td><td><code>$.name</code></td><td></td></tr></tbody></table></div></article><article id="block-setJsonAtPath" class="block-reference-entry"><h3><code>set [NAME] at path [PATH] to JSON [VALUE]</code></h3><p>Immutably update a named value and replace its binding.</p><p>Block type: COMMAND. Opcode: <code>setJsonAtPath</code>. <a href="#block-setJsonAtPath">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>data</code></td><td></td></tr><tr><th scope="row"><code>PATH</code></th><td>STRING</td><td><code>$.name</code></td><td></td></tr><tr><th scope="row"><code>VALUE</code></th><td>STRING</td><td><code>&quot;Scratch&quot;</code></td><td></td></tr></tbody></table></div></article><article id="block-deleteAtPath" class="block-reference-entry"><h3><code>delete path [PATH] from [NAME]</code></h3><p>Immutably delete a path and replace its named binding.</p><p>Block type: COMMAND. Opcode: <code>deleteAtPath</code>. <a href="#block-deleteAtPath">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>data</code></td><td></td></tr><tr><th scope="row"><code>PATH</code></th><td>STRING</td><td><code>$.name</code></td><td></td></tr></tbody></table></div></article><article id="block-keysAtPath" class="block-reference-entry"><h3><code>keys in [NAME] at path [PATH]</code></h3><p>Return sorted object keys as JSON.</p><p>Block type: REPORTER. Opcode: <code>keysAtPath</code>. <a href="#block-keysAtPath">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>data</code></td><td></td></tr><tr><th scope="row"><code>PATH</code></th><td>STRING</td><td><code>$</code></td><td></td></tr></tbody></table></div></article><article id="block-lengthAtPath" class="block-reference-entry"><h3><code>length of array in [NAME] at path [PATH]</code></h3><p>Return the array length.</p><p>Block type: REPORTER. Opcode: <code>lengthAtPath</code>. <a href="#block-lengthAtPath">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>data</code></td><td></td></tr><tr><th scope="row"><code>PATH</code></th><td>STRING</td><td><code>$</code></td><td></td></tr></tbody></table></div></article><article id="block-forEachAtPath" class="block-reference-entry"><h3><code>for each in [NAME] at path [PATH] max [MAX]</code></h3><p>Iterate named data deterministically with a static maximum.</p><p>Block type: LOOP. Opcode: <code>forEachAtPath</code>. <a href="#block-forEachAtPath">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>data</code></td><td></td></tr><tr><th scope="row"><code>PATH</code></th><td>STRING</td><td><code>$</code></td><td></td></tr><tr><th scope="row"><code>MAX</code></th><td>NUMBER</td><td><code>100</code></td><td></td></tr></tbody></table></div></article><article id="block-currentKey" class="block-reference-entry"><h3><code>current key</code></h3><p>Return the current object key or array index string.</p><p>Block type: REPORTER. Opcode: <code>currentKey</code>. <a href="#block-currentKey">Permanent link</a></p><p>This block has no arguments.</p></article><article id="block-currentIndex" class="block-reference-entry"><h3><code>current index</code></h3><p>Return the zero-based iteration number.</p><p>Block type: REPORTER. Opcode: <code>currentIndex</code>. <a href="#block-currentIndex">Permanent link</a></p><p>This block has no arguments.</p></article><article id="block-currentValueJson" class="block-reference-entry"><h3><code>current value JSON</code></h3><p>Return the current iteration value as JSON.</p><p>Block type: REPORTER. Opcode: <code>currentValueJson</code>. <a href="#block-currentValueJson">Permanent link</a></p><p>This block has no arguments.</p></article>
+<article id="block-parseJson" class="block-reference-entry"><h3><code>parse JSON [TEXT] as [NAME]</code></h3><p>Parse JSON text into the target-local structured data namespace.</p><p>Block type: COMMAND. Opcode: <code>parseJson</code>. <a href="#block-parseJson">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>TEXT</code></th><td>STRING</td><td><code>{&quot;name&quot;:&quot;TurboWarp&quot;}</code></td><td></td></tr><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>data</code></td><td></td></tr></tbody></table></div></article><article id="block-parseYaml" class="block-reference-entry"><h3><code>parse YAML [TEXT] as [NAME]</code></h3><p>Parse safe YAML text into the target-local structured data namespace.</p><p>Block type: COMMAND. Opcode: <code>parseYaml</code>. <a href="#block-parseYaml">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>TEXT</code></th><td>STRING</td><td><code>name: TurboWarp</code></td><td></td></tr><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>data</code></td><td></td></tr></tbody></table></div></article><article id="block-toJson" class="block-reference-entry"><h3><code>to JSON [NAME]</code></h3><p>Render named structured data as canonical JSON.</p><p>Block type: REPORTER. Opcode: <code>toJson</code>. <a href="#block-toJson">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>data</code></td><td></td></tr></tbody></table></div></article><article id="block-toYaml" class="block-reference-entry"><h3><code>to YAML [NAME]</code></h3><p>Render named structured data as deterministic YAML.</p><p>Block type: REPORTER. Opcode: <code>toYaml</code>. <a href="#block-toYaml">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>data</code></td><td></td></tr></tbody></table></div></article><article id="block-hasStructuredData" class="block-reference-entry"><h3><code>structured data [NAME] exists?</code></h3><p>Report whether the current target has named structured data.</p><p>Block type: BOOLEAN. Opcode: <code>hasStructuredData</code>. <a href="#block-hasStructuredData">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>data</code></td><td></td></tr></tbody></table></div></article><article id="block-deleteStructuredData" class="block-reference-entry"><h3><code>delete structured data [NAME]</code></h3><p>Delete named structured data from the current target.</p><p>Block type: COMMAND. Opcode: <code>deleteStructuredData</code>. <a href="#block-deleteStructuredData">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>data</code></td><td></td></tr></tbody></table></div></article><article id="block-getJsonAtPath" class="block-reference-entry"><h3><code>get JSON from [NAME] at path [PATH]</code></h3><p>Return a named value at a path as JSON.</p><p>Block type: REPORTER. Opcode: <code>getJsonAtPath</code>. <a href="#block-getJsonAtPath">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>data</code></td><td></td></tr><tr><th scope="row"><code>PATH</code></th><td>STRING</td><td><code>$.name</code></td><td></td></tr></tbody></table></div></article><article id="block-hasPath" class="block-reference-entry"><h3><code>structured data [NAME] has path [PATH]?</code></h3><p>Report whether a path exists in named structured data.</p><p>Block type: BOOLEAN. Opcode: <code>hasPath</code>. <a href="#block-hasPath">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>data</code></td><td></td></tr><tr><th scope="row"><code>PATH</code></th><td>STRING</td><td><code>$.name</code></td><td></td></tr></tbody></table></div></article><article id="block-setJsonAtPath" class="block-reference-entry"><h3><code>set [NAME] at path [PATH] to JSON [VALUE]</code></h3><p>Immutably update a named value and replace its binding.</p><p>Block type: COMMAND. Opcode: <code>setJsonAtPath</code>. <a href="#block-setJsonAtPath">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>data</code></td><td></td></tr><tr><th scope="row"><code>PATH</code></th><td>STRING</td><td><code>$.name</code></td><td></td></tr><tr><th scope="row"><code>VALUE</code></th><td>STRING</td><td><code>&quot;Scratch&quot;</code></td><td></td></tr></tbody></table></div></article><article id="block-deleteAtPath" class="block-reference-entry"><h3><code>delete path [PATH] from [NAME]</code></h3><p>Immutably delete a path and replace its named binding.</p><p>Block type: COMMAND. Opcode: <code>deleteAtPath</code>. <a href="#block-deleteAtPath">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>data</code></td><td></td></tr><tr><th scope="row"><code>PATH</code></th><td>STRING</td><td><code>$.name</code></td><td></td></tr></tbody></table></div></article><article id="block-keysAtPath" class="block-reference-entry"><h3><code>keys in [NAME] at path [PATH]</code></h3><p>Return sorted object keys as JSON.</p><p>Block type: REPORTER. Opcode: <code>keysAtPath</code>. <a href="#block-keysAtPath">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>data</code></td><td></td></tr><tr><th scope="row"><code>PATH</code></th><td>STRING</td><td><code>$</code></td><td></td></tr></tbody></table></div></article><article id="block-lengthAtPath" class="block-reference-entry"><h3><code>length of array in [NAME] at path [PATH]</code></h3><p>Return the array length.</p><p>Block type: REPORTER. Opcode: <code>lengthAtPath</code>. <a href="#block-lengthAtPath">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>data</code></td><td></td></tr><tr><th scope="row"><code>PATH</code></th><td>STRING</td><td><code>$</code></td><td></td></tr></tbody></table></div></article><article id="block-forEachAtPath" class="block-reference-entry"><h3><code>for each in [NAME] at path [PATH] max [MAX]</code></h3><p>Iterate named data deterministically with a static maximum.</p><p>Block type: LOOP. Opcode: <code>forEachAtPath</code>. <a href="#block-forEachAtPath">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>data</code></td><td></td></tr><tr><th scope="row"><code>PATH</code></th><td>STRING</td><td><code>$</code></td><td></td></tr><tr><th scope="row"><code>MAX</code></th><td>NUMBER</td><td><code>100</code></td><td></td></tr></tbody></table></div><!-- BEGIN FIXED INPUT HELP --><p id="fixed-input-forEachAtPath-MAX" class="fixed-input-editor">MVP機能を有効にした場合だけ、MAXを整数1〜1000で編集します。入力途中・空白・非finiteな新値は保存できません。NAMEとPATHは変更しません。 GUIのDialogsとFixedInputsは起動時の既定OFFです。両方を有効にして再読込すると固定フォームが使えます。未変更のraw値を保存し直さず、接続reporterは評価しません。</p><!-- END FIXED INPUT HELP --></article><article id="block-currentKey" class="block-reference-entry"><h3><code>current key</code></h3><p>Return the current object key or array index string.</p><p>Block type: REPORTER. Opcode: <code>currentKey</code>. <a href="#block-currentKey">Permanent link</a></p><p>This block has no arguments.</p></article><article id="block-currentIndex" class="block-reference-entry"><h3><code>current index</code></h3><p>Return the zero-based iteration number.</p><p>Block type: REPORTER. Opcode: <code>currentIndex</code>. <a href="#block-currentIndex">Permanent link</a></p><p>This block has no arguments.</p></article><article id="block-currentValueJson" class="block-reference-entry"><h3><code>current value JSON</code></h3><p>Return the current iteration value as JSON.</p><p>Block type: REPORTER. Opcode: <code>currentValueJson</code>. <a href="#block-currentValueJson">Permanent link</a></p><p>This block has no arguments.</p></article>
 <p><a href="https://github.com/kubohiroya/turbowarp-structured-data/blob/main/README.md">Repository guide and examples</a></p>
 </section>
 <!-- END COMPLETE BLOCK REFERENCE -->

package/docs/schemas/block-editor-fixed-inputs.schema.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://kubohiroya.github.io/turbowarp-structured-data/schemas/block-editor-fixed-inputs.schema.json",
+  "$defs": {
+    "forEachAtPath": {
+      "type": "object",
+      "properties": {
+        "MAX": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 1000
+        }
+      },
+      "required": [
+        "MAX"
+      ],
+      "additionalProperties": true
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubohiroya/turbowarp-structured-data",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Named structured data with JSON/YAML codecs and deterministic path operations for TurboWarp.",
   "author": "Hiroya Kubo <hiroya@cuc.ac.jp>",
   "license": "MPL-2.0",
@@ -27,6 +27,7 @@
     "dist/",
     "docs/",
     "src/",
+    "schemas/",
     "templates/",
     "README.md",
     "README.ja.md",
@@ -47,8 +48,8 @@
     "build": "vite build",
     "lint": "eslint src tests scripts vite.config.ts eslint.config.ts",
     "test": "vitest run",
-    "docs": "node scripts/generate-readme.ts",
-    "docs:check": "node scripts/generate-readme.ts --check",
+    "docs": "node scripts/generate-readme.ts && node scripts/generate-fixed-input-docs.mjs",
+    "docs:check": "node scripts/generate-readme.ts --check && node scripts/generate-fixed-input-docs.mjs --check",
     "template:readme": "node scripts/apply-readme-template.ts",
     "repo:check": "node scripts/check-repo.ts",
     "pack:check": "npm pack --dry-run --ignore-scripts",
@@ -57,9 +58,9 @@
   },
   "devDependencies": {
     "@eslint/js": "^9.39.5",
-    "@kubohiroya/turbowarp-extension-manifest": "0.3.0",
-    "@kubohiroya/turbowarp-named-data": "0.1.0",
-    "@kubohiroya/vite-plugin-turbowarp-extension": "0.3.0",
+    "@kubohiroya/turbowarp-extension-manifest": "0.3.2",
+    "@kubohiroya/turbowarp-named-data": "0.3.1",
+    "@kubohiroya/vite-plugin-turbowarp-extension": "0.6.1",
     "@types/node": "^24.13.3",
     "eslint": "^9.39.5",
     "jiti": "^2.7.0",
@@ -71,9 +72,15 @@
   },
   "dependencies": {
     "yaml": "^2.9.1",
-    "@kubohiroya/turbowarp-extension-data-editor": "git+https://github.com/kubohiroya/turbowarp-extension-data-editor.git#76fa1d50a3c188082ceef723ea018a9d8769ea6e"
+    "@kubohiroya/turbowarp-extension-data-editor": "0.2.1"
   },
   "peerDependencies": {
-    "@kubohiroya/turbowarp-named-data": ">=0.1.0 <1"
+    "@kubohiroya/turbowarp-named-data": "0.3.1"
+  },
+  "gitHead": "7429d0707e0c46099fa89d09f456a43a29919395",
+  "x-turbowarp-source": {
+    "revision": "7429d0707e0c46099fa89d09f456a43a29919395",
+    "revisionRole": "base-commit",
+    "sourceState": "local-release-overlay"
   }
 }

package/schemas/block-editor-fixed-inputs.schema.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://kubohiroya.github.io/turbowarp-structured-data/schemas/block-editor-fixed-inputs.schema.json",
+  "$defs": {
+    "forEachAtPath": {
+      "type": "object",
+      "properties": {
+        "MAX": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 1000
+        }
+      },
+      "required": [
+        "MAX"
+      ],
+      "additionalProperties": true
+    }
+  }
+}

package/src/extension.ts

@@ -1,3 +1,4 @@
+import {fixedInputEditorDefinitions, registerFixedInputEditors} from './fixed-input-editors.js';
 import {sourceEditorDefinitions} from './editor-schema.js';
 import {registerSourceEditors} from './source-editor.js';
 import definitions from './block-definitions.json';
@@ -74,7 +75,10 @@ const blockDefinitions = definitions.blocks as readonly BlockDefinition[];
 
 export class StructuredDataExtension implements TurboWarpExtension {
   private readonly enabled: boolean;
+  private disposed = false;
+  private readonly releaseRuntimeListeners: () => void;
   private readonly unregisterSourceEditors: () => void;
+  private readonly unregisterFixedInputEditors: () => void;
   private registries = new WeakMap<object, Map<string, StructuredDataBinding>>();
   private iterationStacks = new WeakMap<object, ActiveIteration[]>();
   private nextRevision = 1;
@@ -89,6 +93,17 @@ export class StructuredDataExtension implements TurboWarpExtension {
   ) {
     this.enabled = enabled;
     this.unregisterSourceEditors = registerSourceEditors(Scratch, enabled ? sourceEditorDefinitions : []);
+    const runtime = Scratch.vm?.runtime;
+    const onDispose = () => {void this.dispose();};
+    const onStop = () => this.clearRuntimeState();
+    this.releaseRuntimeListeners = () => {
+      runtime?.off?.('RUNTIME_DISPOSED', onDispose);
+      runtime?.off?.('PROJECT_STOP_ALL', onStop);
+    };
+    let unregisterFixed = () => {};
+    try {
+      unregisterFixed = registerFixedInputEditors(Scratch, enabled ? fixedInputEditorDefinitions : []);
+      this.unregisterFixedInputEditors = unregisterFixed;
     if (namedDataEnabled) {
       this.namedDataProvider = new StructuredDataNamedDataProvider({
         get: (target, name) => this.registries.get(target)?.get(name)
@@ -104,12 +119,18 @@ export class StructuredDataExtension implements TurboWarpExtension {
           runtime,
           this.namedDataRegistry
         );
-        runtime.on?.('RUNTIME_DISPOSED', () => {
-          void this.dispose();
-        });
+        runtime.on?.('RUNTIME_DISPOSED', onDispose);
       }
     }
-    Scratch.vm?.runtime?.on?.('PROJECT_STOP_ALL', () => this.clearRuntimeState());
+    runtime?.on?.('PROJECT_STOP_ALL', onStop);
+    } catch (error) {
+      this.releaseRuntimeListeners();
+      unregisterFixed();
+      this.unregisterSourceEditors();
+      this.unbindNamedDataRegistryLifecycle?.();
+      void this.namedDataRegistration?.unregister().catch(() => {});
+      throw error;
+    }
   }
 
   public getNamedDataProvider(): StructuredDataNamedDataProvider | undefined {
@@ -121,6 +142,10 @@ export class StructuredDataExtension implements TurboWarpExtension {
   }
 
   public async dispose(): Promise<void> {
+    if (this.disposed) return;
+    this.disposed = true;
+    this.releaseRuntimeListeners();
+    this.unregisterFixedInputEditors();
     this.unregisterSourceEditors();
     await this.namedDataRegistration?.unregister();
     this.unbindNamedDataRegistryLifecycle?.();

package/src/fixed-input-editors.ts

@@ -0,0 +1,67 @@
+import {parseFixedNumberInput} from '@kubohiroya/turbowarp-extension-data-editor';
+import type {FixedInputEditorOptions} from '@kubohiroya/turbowarp-extension-data-editor';
+import {extensionConfig} from './config.js';
+import {fixedInputSchemaBundle} from './fixed-input-schema.js';
+
+
+export const fixedInputEditorDefinitions: readonly FixedInputEditorOptions[] = [{
+  apiVersion: 1, extensionId: extensionConfig.id, editorId: 'forEachAtPath-fixed-inputs',
+  opcodes: [`${extensionConfig.id}_forEachAtPath`],
+  contractId: 'turbowarp-structured-data:forEachAtPath.MAX', contractRevision: 'fixed-inputs-v1',
+  bindings: [{argument: 'MAX', schemaBundle: fixedInputSchemaBundle,
+    control: {kind: 'number', label: 'MAX'},
+    read(value) {
+      if (typeof value !== 'string' && typeof value !== 'number') throw new TypeError('Expected a literal maximum.');
+      if (typeof value === 'string' && value.trim() === '') throw new TypeError('Blank maximum stays readonly.');
+      // Existing nonempty finite Number aliases may project; no-op saving retains the exact raw token.
+      const number = Number(value);
+      if (!Number.isFinite(number)) throw new TypeError('Maximum must be finite.');
+      return number;
+    },
+    encode(value) {
+      const parsed = parseFixedNumberInput(value);
+      if (parsed.kind !== 'valid') throw new TypeError('Expected a finite numeric token.');
+      return parsed.token;
+    },
+    validateCandidate(value) {
+      const parsed = parseFixedNumberInput(value);
+      return parsed.kind === 'valid' && Number.isInteger(parsed.value) && parsed.value >= 1 && parsed.value <= 1000 ? []
+        : [{path: '/inputs/MAX', message: 'Maximum must be an integer from 1 to 1000.'}];
+    }
+  }],
+  validationContext: () => ({consumerId: extensionConfig.id, nowMs: Date.now(), settings: null})
+}];
+
+interface RuntimeLifetime {
+  on?: (event: string, listener: () => void) => void;
+  off?: (event: string, listener: () => void) => void;
+}
+
+/** Register metadata only; the GUI startup capability owns editor activation. */
+export function registerFixedInputEditors(
+  scratch: unknown, definitions: readonly FixedInputEditorOptions[], runtimeOverride?: RuntimeLifetime
+): () => void {
+  const host = scratch as {gui?: {blockEditors?: {apiVersion?: number;
+    registerFixedInputEditor?: (options: FixedInputEditorOptions) => () => void}};
+    vm?: {runtime?: RuntimeLifetime}};
+  const api = host.gui?.blockEditors;
+  if (!definitions.length || api?.apiVersion !== 1 || typeof api.registerFixedInputEditor !== 'function') return () => {};
+  const runtime = runtimeOverride ?? host.vm?.runtime;
+  const removers: (() => void)[] = [];
+  let active = true;
+  const dispose = () => {
+    if (!active) return;
+    active = false;
+    runtime?.off?.('RUNTIME_DISPOSED', dispose);
+    for (const remove of removers.splice(0).reverse()) remove();
+  };
+  try {
+    for (const definition of definitions) {
+      const remove = api.registerFixedInputEditor.call(api, definition);
+      if (typeof remove !== 'function') throw new TypeError('Invalid fixed input registration disposer.');
+      removers.push(remove);
+    }
+    runtime?.on?.('RUNTIME_DISPOSED', dispose);
+  } catch (error) {dispose(); throw error;}
+  return dispose;
+}

package/src/fixed-input-schema.ts

@@ -0,0 +1,16 @@
+import type {SchemaBundle} from '@kubohiroya/turbowarp-extension-data-editor/schema';
+import document from '../schemas/block-editor-fixed-inputs.schema.json';
+
+const source = {repository: 'turbowarp-structured-data', path: 'schemas/block-editor-fixed-inputs.schema.json',
+  symbol: '#/$defs/forEachAtPath/properties/MAX'};
+
+/** The on-disk owner Schema is canonical; this is its single-field projection. */
+export const fixedInputSchemaBundle: SchemaBundle = {
+  identity: {ownerId: 'turbowarp-structured-data', contractId: 'forEachAtPath.MAX', revision: 'fixed-inputs-v1', variantId: 'default'},
+  dialect: '2020-12',
+  root: {retrievalUri: 'https://kubohiroya.github.io/turbowarp-structured-data/schemas/forEachAtPath-MAX.schema.json',
+    document: document.$defs.forEachAtPath.properties.MAX, artifact: {role: 'canonical-schema', source}},
+  resources: [],
+  provenance: {canonicalSources: [source, {repository: 'turbowarp-structured-data', path: 'src/core.ts', symbol: 'iterationEntries'}],
+    generatedFiles: [{repository: 'turbowarp-structured-data', path: 'docs/schemas/block-editor-fixed-inputs.schema.json'}], referenceSchemas: [], generationSources: [{repository: 'turbowarp-structured-data', path: 'scripts/generate-fixed-input-docs.mjs'}]}
+};

package/templates/README.ja.md

@@ -181,3 +181,16 @@ release consistency checkでは、exact-version README／CDN例に加え、`docs
 
 third-party componentを含む場合は
 [`THIRD_PARTY_NOTICES.md`](THIRD_PARTY_NOTICES.md)に記載します。
+
+## 固定引数の編集フォーム（S3-4）
+
+共通エディターの起動時フラグ `blockEditorFixedInputs` とDialogsがONのGUIでは、`forEachAtPath` の `MAX` だけを固定フォームとして登録します。旧GUI・フラグOFFでは追加登録を行いません。Schemaの正本は `schemas/block-editor-fixed-inputs.schema.json#/$defs/forEachAtPath/properties/MAX`、codecと登録は `src/fixed-input-editors.ts` です。既存raw値・未変更alias・未知enumは無操作保存で書き換えず、reporterを評価しません。明示変更だけを検査し、他の引数やブロック宣言、保存形式を変更しません。
+
+MAXは整数1〜1000です。新しい入力には共通の有限数値token規則も適用し、途中入力を保存しません。MVP flagがOFFなら登録せず、NAME/PATH・staticLiteral由来の接続可否を変更しません。
+
+登録はoptional API（apiVersion:1）に限定し、RUNTIME_DISPOSED/明示disposeで解除します。起動フラグOFF＋再読込で従来経路へ切り戻せます。依存を戻す場合はmanifest/lock/実解決を一組で復旧します。npm公開や後続段階の動的候補は含みません。
+
+Schemaが記述する契約の根拠は実getInfoの宣言と既存の純粋なruntime変換です。SchemaBundleのretrievalUriはこのローカル文書の識別子であり、URL配信済み・HTTP取得によるref解決を意味しません。Schemaは同梱文書だけでcompileします。
+既存MAXの非空finiteなNumber alias（例`001`・`+1`・`0x10`）はNumberによる表示投影だけを行い、無変更rawを保存し直しません。空白・非finite・投影不能値はreadonlyとし、0/defaultを補いません。新しい入力にはこれらaliasを許可せずNP-finite-new-input-v1を適用します。
+
+登録は拡張インスタンスの構築時に存在する任意の editor API を使用します。後からの API 追加や差し替えには自動追従しません。起動設定を変更した場合は GUI を再読み込みし、拡張インスタンスを再構築してください。

package/templates/README.md

@@ -196,3 +196,16 @@ site and `blockIconURI` remains a `data:image/svg+xml;base64,...` URI.
 
 Third-party components, when present, are listed in
 [`THIRD_PARTY_NOTICES.md`](THIRD_PARTY_NOTICES.md).
+
+## 固定引数の編集フォーム（S3-4）
+
+共通エディターの起動時フラグ `blockEditorFixedInputs` とDialogsがONのGUIでは、`forEachAtPath` の `MAX` だけを固定フォームとして登録します。旧GUI・フラグOFFでは追加登録を行いません。Schemaの正本は `schemas/block-editor-fixed-inputs.schema.json#/$defs/forEachAtPath/properties/MAX`、codecと登録は `src/fixed-input-editors.ts` です。既存raw値・未変更alias・未知enumは無操作保存で書き換えず、reporterを評価しません。明示変更だけを検査し、他の引数やブロック宣言、保存形式を変更しません。
+
+MAXは整数1〜1000です。新しい入力には共通の有限数値token規則も適用し、途中入力を保存しません。MVP flagがOFFなら登録せず、NAME/PATH・staticLiteral由来の接続可否を変更しません。
+
+登録はoptional API（apiVersion:1）に限定し、RUNTIME_DISPOSED/明示disposeで解除します。起動フラグOFF＋再読込で従来経路へ切り戻せます。依存を戻す場合はmanifest/lock/実解決を一組で復旧します。npm公開や後続段階の動的候補は含みません。
+
+Schemaが記述する契約の根拠は実getInfoの宣言と既存の純粋なruntime変換です。SchemaBundleのretrievalUriはこのローカル文書の識別子であり、URL配信済み・HTTP取得によるref解決を意味しません。Schemaは同梱文書だけでcompileします。
+既存MAXの非空finiteなNumber alias（例`001`・`+1`・`0x10`）はNumberによる表示投影だけを行い、無変更rawを保存し直しません。空白・非finite・投影不能値はreadonlyとし、0/defaultを補いません。新しい入力にはこれらaliasを許可せずNP-finite-new-input-v1を適用します。
+
+Registration uses the optional editor API available when the extension instance is constructed. Adding or replacing that API later is not followed automatically; reload the GUI and reconstruct the extension instance after changing the startup configuration.