@kubohiroya/turbowarp-webrtc-qrcode-pairing 0.2.3 → 0.2.4

package/README.md

@@ -116,7 +116,7 @@ pnpm run dev
 
 Build output: `dist/webrtc-qrcode-pairing.js` and `dist/extension-manifest.json`. Load the JavaScript file as a custom TurboWarp extension. The manifest always records every declared block, including blocks the feature flag hides at runtime: it is the build-time contract, not the runtime state.
 
-Package name and version: `@kubohiroya/turbowarp-webrtc-qrcode-pairing@0.2.3`.
+Package name and version: `@kubohiroya/turbowarp-webrtc-qrcode-pairing@0.2.4`.
 
 ## Block reference
 
@@ -449,3 +449,14 @@ Track implementation in this repository's GitHub Issues. Design documents live i
 ## License
 
 SPDX-License-Identifier: MPL-2.0
+
+## Fixed input editing
+
+With a compatible TurboWarp GUI, enable fixed-input forms to edit only standard literal fields. Numbers use complete finite JSON number tokens; menu fields use existing choices. Connected reporters and unavailable fields stay read-only and are never evaluated. Saving an unchanged form preserves exact existing raw values, including legacy spellings and unknown choices. Invalid drafts stay in the same editing session; cancel, project/target replacement, or block removal discards them. Disabling the GUI feature flag restores native field editing. This form does not run blocks, open network/audio/key/QR sessions, resolve names, or edit Schema arguments. QR index is a positive integer without a session-derived candidate limit. Timeout remains 1–3600 seconds.
+
+Canonical contracts: `schemas/block-editor-fixed-inputs.schema.json`; codecs and optional registration: `src/fixed-input-editors.ts`. These contracts describe new fixed-field candidates; they do not redefine all runtime data. The GUI integration is optional and existing standalone/composition APIs stay available.
+
+- `showPairingQrPart`: INDEX — [block documentation](https://kubohiroya.github.io/turbowarp-webrtc-qrcode-pairing/#block-showPairingQrPart).
+- `pairingQrPartSvg`: INDEX — [block documentation](https://kubohiroya.github.io/turbowarp-webrtc-qrcode-pairing/#block-pairingQrPartSvg).
+- `pairingQrPartDataUri`: INDEX — [block documentation](https://kubohiroya.github.io/turbowarp-webrtc-qrcode-pairing/#block-pairingQrPartDataUri).
+- `setPairingTimeout`: SECONDS — [block documentation](https://kubohiroya.github.io/turbowarp-webrtc-qrcode-pairing/#block-setPairingTimeout).

package/dist/webrtc-qrcode-pairing.js

@@ -19,6 +19,192 @@
   	docsURI: "https://kubohiroya.github.io/turbowarp-webrtc-qrcode-pairing/",
   	blockIconURI: "data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCA0OCA0OCI+PHJlY3QgeD0iNCIgeT0iOCIgd2lkdGg9IjE4IiBoZWlnaHQ9IjE0IiByeD0iMyIgZmlsbD0iIzRDOTdGRiIvPjxyZWN0IHg9IjI2IiB5PSI4IiB3aWR0aD0iMTgiIGhlaWdodD0iMTQiIHJ4PSIzIiBmaWxsPSIjNTlDMDU5Ii8+PHJlY3QgeD0iMTUiIHk9IjI2IiB3aWR0aD0iMTgiIGhlaWdodD0iMTQiIHJ4PSIzIiBmaWxsPSIjRkZBQjE5Ii8+PC9zdmc+"
   };
+  var block_editor_fixed_inputs_schema_default = {
+  	$schema: "http://json-schema.org/draft-07/schema#",
+  	$id: "https://kubohiroya.github.io/turbowarp-webrtc-qrcode-pairing/schemas/block-editor-fixed-inputs.schema.json",
+  	title: "turbowarp-webrtc-qrcode-pairing fixed editing contracts",
+  	$defs: {
+  		"showPairingQrPart": {
+  			"type": "object",
+  			"properties": { "INDEX": {
+  				"type": "integer",
+  				"minimum": 1
+  			} },
+  			"additionalProperties": false
+  		},
+  		"pairingQrPartSvg": {
+  			"type": "object",
+  			"properties": { "INDEX": {
+  				"type": "integer",
+  				"minimum": 1
+  			} },
+  			"additionalProperties": false
+  		},
+  		"pairingQrPartDataUri": {
+  			"type": "object",
+  			"properties": { "INDEX": {
+  				"type": "integer",
+  				"minimum": 1
+  			} },
+  			"additionalProperties": false
+  		},
+  		"setPairingTimeout": {
+  			"type": "object",
+  			"properties": { "SECONDS": {
+  				"type": "number",
+  				"minimum": 1,
+  				"maximum": 3600
+  			} },
+  			"additionalProperties": false
+  		}
+  	}
+  };
+  //#endregion
+  //#region src/fixed-input-editors.ts
+  var contracts = block_editor_fixed_inputs_schema_default.$defs;
+  var repository = "turbowarp-webrtc-qrcode-pairing";
+  var extensionId = "kubohiroyawebrtcqrcodepairing";
+  var token = /^-?(?:0|[1-9][0-9]*)(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$/u;
+  function readNumber(value) {
+  	if (typeof value !== "string" && typeof value !== "number") throw new TypeError("Invalid numeric projection.");
+  	if (typeof value === "string" && value.trim() === "") throw new TypeError("Existing blank field is readonly.");
+  	const number = Number(value);
+  	if (!Number.isFinite(number)) throw new TypeError("Existing nonfinite field is readonly.");
+  	return number;
+  }
+  function newNumberToken(value) {
+  	if (typeof value === "number") {
+  		if (!Number.isFinite(value)) throw new TypeError("Invalid new number.");
+  		return Object.is(value, -0) ? "-0" : String(value);
+  	}
+  	if (typeof value !== "string" || !token.test(value.trim()) || !Number.isFinite(Number(value))) throw new TypeError("Invalid new number.");
+  	return value.trim();
+  }
+  function existingChoice(_opcode, value) {
+  	if (typeof value !== "string") throw new TypeError("Invalid string projection.");
+  	return value;
+  }
+  function candidateValid(_opcode, _argument, schema, value) {
+  	if (schema.type === "number" || schema.type === "integer") {
+  		let number;
+  		try {
+  			number = readNumber(value);
+  		} catch {
+  			return false;
+  		}
+  		if (schema.type === "integer" && !Number.isInteger(number)) return false;
+  		if (schema.minimum !== void 0 && number < schema.minimum) return false;
+  		if (schema.maximum !== void 0 && number > schema.maximum) return false;
+  		if (schema.exclusiveMinimum !== void 0 && number <= schema.exclusiveMinimum) return false;
+  		if (schema.enum && !schema.enum.includes(number)) return false;
+  		return true;
+  	}
+  	return typeof value === "string" && schema.enum.includes(value);
+  }
+  function fixedInputEditorOptions() {
+  	return Object.entries(contracts).map(([opcode, contract]) => ({
+  		apiVersion: 1,
+  		extensionId,
+  		editorId: `${extensionId}.fixed.${opcode}`,
+  		opcodes: [`${extensionId}_${opcode}`],
+  		contractId: `${repository}.${opcode}.fixed`,
+  		contractRevision: "fixed-inputs-v1",
+  		validationContext: () => ({
+  			consumerId: repository,
+  			nowMs: 0,
+  			settings: null
+  		}),
+  		bindings: Object.entries(contract.properties).map(([argument, schema]) => {
+  			const numeric = schema.type === "number" || schema.type === "integer";
+  			const source = {
+  				repository,
+  				path: "schemas/block-editor-fixed-inputs.schema.json",
+  				symbol: `/$defs/${opcode}/properties/${argument}`
+  			};
+  			return {
+  				argument,
+  				schemaBundle: {
+  					identity: {
+  						ownerId: repository,
+  						contractId: `${opcode}.${argument}`,
+  						revision: "fixed-inputs-v1",
+  						variantId: "fixed"
+  					},
+  					dialect: "draft-07",
+  					root: {
+  						retrievalUri: `${block_editor_fixed_inputs_schema_default.$id}?binding=${opcode}.${argument}`,
+  						document: schema,
+  						artifact: {
+  							role: "canonical-schema",
+  							source
+  						}
+  					},
+  					resources: [],
+  					provenance: {
+  						canonicalSources: [
+  							source,
+  							{
+  								repository,
+  								path: "src/block-definitions.json"
+  							},
+  							{
+  								repository,
+  								path: "src/extension.ts",
+  								symbol: opcode
+  							}
+  						],
+  						generatedFiles: [],
+  						referenceSchemas: [],
+  						generationSources: []
+  					}
+  				},
+  				control: numeric ? { kind: "number" } : {
+  					kind: "enum",
+  					choices: schema.enum.map((value) => ({
+  						value,
+  						label: String(value)
+  					}))
+  				},
+  				read: (value) => numeric ? readNumber(value) : existingChoice(opcode, value),
+  				encode: (value) => {
+  					if (numeric) return newNumberToken(value);
+  					if (typeof value !== "string" || !schema.enum.includes(value)) throw new TypeError("Invalid new enum value.");
+  					return value;
+  				},
+  				validateCandidate: (value) => candidateValid(opcode, argument, schema, value) ? [] : [{
+  					path: argument,
+  					message: "Check this value before saving."
+  				}]
+  			};
+  		})
+  	}));
+  }
+  /** Register only visible static contracts; ordinary composition consumers load no editor runtime. */
+  function registerFixedInputEditors(scratch, runtime, visibleBlocks) {
+  	const api = scratch.gui?.blockEditors;
+  	if (api?.apiVersion !== 1 || typeof api.registerFixedInputEditor !== "function") return void 0;
+  	const visibleOpcodes = new Set(visibleBlocks.flatMap((block) => {
+  		if (typeof block !== "object" || block === null || !("opcode" in block)) return [];
+  		return typeof block.opcode === "string" ? [block.opcode] : [];
+  	}));
+  	const events = runtime;
+  	const removers = [];
+  	let active = true;
+  	const dispose = () => {
+  		if (!active) return;
+  		active = false;
+  		events?.off?.("RUNTIME_DISPOSED", dispose);
+  		for (const remove of removers.splice(0).reverse()) remove();
+  	};
+  	try {
+  		for (const options of fixedInputEditorOptions()) if (options.opcodes.some((opcode) => visibleOpcodes.has(opcode.slice(30)))) removers.push(api.registerFixedInputEditor.call(api, options));
+  		events?.on?.("RUNTIME_DISPOSED", dispose);
+  	} catch (error) {
+  		dispose();
+  		throw error;
+  	}
+  	return dispose;
+  }
   var block_definitions_default = {
   	extensionName: "TurboWarp-WebRTC-QRCode-Pairing",
   	blocks: [
@@ -509,7 +695,7 @@
   	_checkPrivateRedeclaration(e, a), a.add(e);
   }
   //#endregion
-  //#region node_modules/.pnpm/@kubohiroya+qrcode-structured-append@0.1.0/node_modules/@kubohiroya/qrcode-structured-append/dist/index.js
+  //#region node_modules/.pnpm/@kubohiroya+qrcode-structured-append@0.1.1/node_modules/@kubohiroya/qrcode-structured-append/dist/index.js
   var _Charset;
   var _label;
   var _values;
@@ -4129,13 +4315,15 @@
   		this.runtime.on?.("targetWasRemoved", this.targetRemovedListener);
   	}
   	getInfo() {
-  		return {
+  		const info = {
   			id: extensionConfig.id,
   			name: Scratch.translate(block_definitions_default.extensionName),
   			docsURI: extensionConfig.docsURI,
   			blockIconURI: extensionConfig.blockIconURI,
   			blocks: this.enabled ? blockDefinitions.map((block) => this.toScratchBlock(block)) : []
   		};
+  		this.fixedEditorsDispose ?? (this.fixedEditorsDispose = registerFixedInputEditors(Scratch, this.runtime, info.blocks));
+  		return info;
   	}
   	async startOfferPairing(args) {
   		await this.pairing.startOfferPairing({
@@ -4239,6 +4427,7 @@
   		this.pairing.setTimeoutSeconds(Scratch.Cast.toString(args.SESSION), Scratch.Cast.toNumber(args.SECONDS));
   	}
   	dispose() {
+  		this.fixedEditorsDispose?.();
   		this.pairing.dispose();
   		this.runtime.off?.("PROJECT_RUN_STOP", this.stopListener);
   		this.runtime.off?.("PROJECT_STOP_ALL", this.stopListener);

package/docs/index.html

@@ -4,8 +4,17 @@
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width,initial-scale=1">
   <title>TurboWarp-WebRTC-QRCode-Pairing</title>
+<style id="block-reference-style">
+#extension-block-reference{max-width:72rem;margin:2rem auto;padding:1rem;line-height:1.6;overflow-wrap:anywhere}
+#extension-block-reference .block-reference-entry{display:block;scroll-margin-top:6rem;margin:2rem 0;padding:1rem;border:1px solid currentColor;border-radius:.5rem}
+#extension-block-reference .block-reference-table{overflow-x:auto}
+#extension-block-reference table{border-collapse:collapse;width:100%}
+#extension-block-reference th,#extension-block-reference td{text-align:left;vertical-align:top;border:1px solid currentColor;padding:.5rem}
+#extension-block-reference code{white-space:pre-wrap}
+#extension-block-reference a:focus-visible{outline:3px solid currentColor;outline-offset:3px}
+</style>
 </head>
-<body>
+<body><p lang="en" class="complete-block-reference-link"><a href="#extension-block-reference">Complete block reference (31 blocks)</a></p>
   <h1>TurboWarp-WebRTC-QRCode-Pairing</h1>
   <p>A TurboWarp extension that pairs WebRTC peers by carrying the offer and the answer optically, as QR codes.</p>
   <h2>How the workflow runs</h2>
@@ -30,5 +39,47 @@
     <li><a href="architecture.md">Architecture</a> (<a href="architecture.ja.md">日本語</a>) &mdash; runtime structure, build outputs, extension API manifest</li>
     <li><a href="https://github.com/kubohiroya/turbowarp-webrtc-qrcode-pairing#readme">Repository documentation and block reference</a></li>
   </ul>
+<!-- BEGIN COMPLETE BLOCK REFERENCE -->
+<section lang="en" id="extension-block-reference" aria-labelledby="block-reference-title">
+<h2 id="block-reference-title">TurboWarp-WebRTC-QRCode-Pairing: complete block reference</h2>
+<p>All 31 blocks are documented below, including compatibility blocks and blocks available through optional features. Select a block to read its behavior, arguments, default values, and menu choices. Each block has a permanent link.</p>
+<nav aria-label="Block reference"><ul><li><a href="#block-startOfferPairing"><code>start offer pairing [SESSION] as [LOCAL_PEER] to [REMOTE_PEER]</code></a></li>
+<li><a href="#block-startAnswerPairing"><code>start answer pairing [SESSION] as [LOCAL_PEER]</code></a></li>
+<li><a href="#block-ingestPairingQrText"><code>receive pairing message [TEXT] for [SESSION]</code></a></li>
+<li><a href="#block-scanPairingQrFromCamera"><code>scan pairing QR for [SESSION] from camera [CAMERA_ID]</code></a></li>
+<li><a href="#block-pairingReceivedParts"><code>received parts of [SESSION]</code></a></li>
+<li><a href="#block-pairingRequiredParts"><code>required parts of [SESSION]</code></a></li>
+<li><a href="#block-pairingMissingParts"><code>missing parts of [SESSION]</code></a></li>
+<li><a href="#block-pairingReadCount"><code>pairing QR reads of [SESSION]</code></a></li>
+<li><a href="#block-pairingLastRead"><code>last pairing QR read of [SESSION]</code></a></li>
+<li><a href="#block-pairingLastReadDetail"><code>last pairing QR read detail of [SESSION]</code></a></li>
+<li><a href="#block-showPairingQrPart"><code>show pairing QR part [INDEX] of [SESSION] on this sprite</code></a></li>
+<li><a href="#block-showNextPairingQrPart"><code>show next pairing QR part of [SESSION] on this sprite</code></a></li>
+<li><a href="#block-pairingQrPartCount"><code>pairing QR part count of [SESSION]</code></a></li>
+<li><a href="#block-pairingQrCurrentPart"><code>current pairing QR part of [SESSION]</code></a></li>
+<li><a href="#block-pairingQrPartSvg"><code>pairing QR part [INDEX] of [SESSION] as SVG</code></a></li>
+<li><a href="#block-pairingQrPartDataUri"><code>pairing QR part [INDEX] of [SESSION] as data URI</code></a></li>
+<li><a href="#block-endPairingQrDisplay"><code>end pairing QR display of [SESSION]</code></a></li>
+<li><a href="#block-pairingPhase"><code>pairing phase of [SESSION]</code></a></li>
+<li><a href="#block-pairingConnectionState"><code>pairing connection state of [SESSION]</code></a></li>
+<li><a href="#block-isPairingConnected"><code>pairing [SESSION] connected?</code></a></li>
+<li><a href="#block-waitUntilPairingConnected"><code>wait until pairing [SESSION] is connected</code></a></li>
+<li><a href="#block-pairingError"><code>pairing error code of [SESSION]</code></a></li>
+<li><a href="#block-pairingErrorMessage"><code>pairing error message of [SESSION]</code></a></li>
+<li><a href="#block-pairingLocalPeer"><code>local peer of [SESSION]</code></a></li>
+<li><a href="#block-pairingRemotePeer"><code>remote peer of [SESSION]</code></a></li>
+<li><a href="#block-pairingExchangeId"><code>exchange id of [SESSION]</code></a></li>
+<li><a href="#block-pairingRemainingSeconds"><code>remaining seconds of [SESSION]</code></a></li>
+<li><a href="#block-pairingSessions"><code>pairing sessions</code></a></li>
+<li><a href="#block-cancelPairing"><code>cancel pairing [SESSION]</code></a></li>
+<li><a href="#block-retryPairing"><code>retry pairing [SESSION]</code></a></li>
+<li><a href="#block-setPairingTimeout"><code>set pairing timeout of [SESSION] to [SECONDS] seconds</code></a></li>
+</ul></nav>
+<article id="block-startOfferPairing" class="block-reference-entry"><h3><code>start offer pairing [SESSION] as [LOCAL_PEER] to [REMOTE_PEER]</code></h3><p>Creates a WebRTC offer for the integration machine and prepares it as a Structured Append sequence of QR codes.</p><p>Block type: COMMAND. Opcode: <code>startOfferPairing</code>. <a href="#block-startOfferPairing">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>SESSION</code></th><td>STRING</td><td><code>pairing-1</code></td><td></td></tr><tr><th scope="row"><code>LOCAL_PEER</code></th><td>STRING</td><td><code>hub</code></td><td></td></tr><tr><th scope="row"><code>REMOTE_PEER</code></th><td>STRING</td><td><code>camera-1</code></td><td></td></tr></tbody></table></div></article><article id="block-startAnswerPairing" class="block-reference-entry"><h3><code>start answer pairing [SESSION] as [LOCAL_PEER]</code></h3><p>Waits for an offer on the camera machine. Leave the name empty to adopt the name the offer assigns.</p><p>Block type: COMMAND. Opcode: <code>startAnswerPairing</code>. <a href="#block-startAnswerPairing">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>SESSION</code></th><td>STRING</td><td><code>pairing-1</code></td><td></td></tr><tr><th scope="row"><code>LOCAL_PEER</code></th><td>STRING</td><td><code></code></td><td></td></tr></tbody></table></div></article><article id="block-ingestPairingQrText" class="block-reference-entry"><h3><code>receive pairing message [TEXT] for [SESSION]</code></h3><p>Accepts a whole pairing message as text, such as one pasted or carried some other way. Camera scanning reads the QR codes of a sequence itself.</p><p>Block type: COMMAND. Opcode: <code>ingestPairingQrText</code>. <a href="#block-ingestPairingQrText">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></code></td><td></td></tr><tr><th scope="row"><code>SESSION</code></th><td>STRING</td><td><code>pairing-1</code></td><td></td></tr></tbody></table></div></article><article id="block-scanPairingQrFromCamera" class="block-reference-entry"><h3><code>scan pairing QR for [SESSION] from camera [CAMERA_ID]</code></h3><p>Reads QR codes from the named camera, in any order, until the exchange has every code of the sequence. Codes of other sequences are reported and ignored.</p><p>Block type: COMMAND. Opcode: <code>scanPairingQrFromCamera</code>. <a href="#block-scanPairingQrFromCamera">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>SESSION</code></th><td>STRING</td><td><code>pairing-1</code></td><td></td></tr><tr><th scope="row"><code>CAMERA_ID</code></th><td>STRING</td><td><code>default</code></td><td></td></tr></tbody></table></div></article><article id="block-pairingReceivedParts" class="block-reference-entry"><h3><code>received parts of [SESSION]</code></h3><p>Returns how many distinct codes of the incoming sequence have been read.</p><p>Block type: REPORTER. Opcode: <code>pairingReceivedParts</code>. <a href="#block-pairingReceivedParts">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>SESSION</code></th><td>STRING</td><td><code>pairing-1</code></td><td></td></tr></tbody></table></div></article><article id="block-pairingRequiredParts" class="block-reference-entry"><h3><code>required parts of [SESSION]</code></h3><p>Returns how many codes the incoming sequence has, or zero before the first code arrives.</p><p>Block type: REPORTER. Opcode: <code>pairingRequiredParts</code>. <a href="#block-pairingRequiredParts">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>SESSION</code></th><td>STRING</td><td><code>pairing-1</code></td><td></td></tr></tbody></table></div></article><article id="block-pairingMissingParts" class="block-reference-entry"><h3><code>missing parts of [SESSION]</code></h3><p>Returns the one-based code numbers that have not been read yet, separated by commas.</p><p>Block type: REPORTER. Opcode: <code>pairingMissingParts</code>. <a href="#block-pairingMissingParts">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>SESSION</code></th><td>STRING</td><td><code>pairing-1</code></td><td></td></tr></tbody></table></div></article><article id="block-pairingReadCount" class="block-reference-entry"><h3><code>pairing QR reads of [SESSION]</code></h3><p>Returns how many pairing QR codes this session has read, of any result. It rises by one per read, so a change means there is a new result to show.</p><p>Block type: REPORTER. Opcode: <code>pairingReadCount</code>. <a href="#block-pairingReadCount">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>SESSION</code></th><td>STRING</td><td><code>pairing-1</code></td><td></td></tr></tbody></table></div></article><article id="block-pairingLastRead" class="block-reference-entry"><h3><code>last pairing QR read of [SESSION]</code></h3><p>Returns what the latest pairing QR code was: accepted (a new code of the sequence), duplicate (a code already read), foreign (a code this exchange cannot use, which is ignored), or an empty string before the first read. QR codes that are not pairing codes are not reported.</p><p>Block type: REPORTER. Opcode: <code>pairingLastRead</code>. <a href="#block-pairingLastRead">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>SESSION</code></th><td>STRING</td><td><code>pairing-1</code></td><td></td></tr></tbody></table></div></article><article id="block-pairingLastReadDetail" class="block-reference-entry"><h3><code>last pairing QR read detail of [SESSION]</code></h3><p>Returns the code as &quot;2 / 4&quot; for accepted and duplicate reads, or why a foreign code was ignored as an error code such as message-mismatch (another sequence), stale-exchange or peer-mismatch.</p><p>Block type: REPORTER. Opcode: <code>pairingLastReadDetail</code>. <a href="#block-pairingLastReadDetail">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>SESSION</code></th><td>STRING</td><td><code>pairing-1</code></td><td></td></tr></tbody></table></div></article><article id="block-showPairingQrPart" class="block-reference-entry"><p class="fixed-input-help-link">Fixed literal fields: <code>INDEX</code>. <a href="#fixed-input-editing">Editing UI and preservation rules</a>.</p><h3><code>show pairing QR part [INDEX] of [SESSION] on this sprite</code></h3><p>Shows the selected one-based code of the sequence using a temporary sprite skin.</p><p>Block type: COMMAND. Opcode: <code>showPairingQrPart</code>. <a href="#block-showPairingQrPart">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>INDEX</code></th><td>NUMBER</td><td><code>1</code></td><td></td></tr><tr><th scope="row"><code>SESSION</code></th><td>STRING</td><td><code>pairing-1</code></td><td></td></tr></tbody></table></div></article><article id="block-showNextPairingQrPart" class="block-reference-entry"><h3><code>show next pairing QR part of [SESSION] on this sprite</code></h3><p>Shows the next code and wraps from the last back to the first, so a loop with a short wait cycles the whole sequence.</p><p>Block type: COMMAND. Opcode: <code>showNextPairingQrPart</code>. <a href="#block-showNextPairingQrPart">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>SESSION</code></th><td>STRING</td><td><code>pairing-1</code></td><td></td></tr></tbody></table></div></article><article id="block-pairingQrPartCount" class="block-reference-entry"><h3><code>pairing QR part count of [SESSION]</code></h3><p>Returns how many codes are prepared for display, or zero when none are.</p><p>Block type: REPORTER. Opcode: <code>pairingQrPartCount</code>. <a href="#block-pairingQrPartCount">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>SESSION</code></th><td>STRING</td><td><code>pairing-1</code></td><td></td></tr></tbody></table></div></article><article id="block-pairingQrCurrentPart" class="block-reference-entry"><h3><code>current pairing QR part of [SESSION]</code></h3><p>Returns the one-based code selected for display, or zero when none is selected.</p><p>Block type: REPORTER. Opcode: <code>pairingQrCurrentPart</code>. <a href="#block-pairingQrCurrentPart">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>SESSION</code></th><td>STRING</td><td><code>pairing-1</code></td><td></td></tr></tbody></table></div></article><article id="block-pairingQrPartSvg" class="block-reference-entry"><p class="fixed-input-help-link">Fixed literal fields: <code>INDEX</code>. <a href="#fixed-input-editing">Editing UI and preservation rules</a>.</p><h3><code>pairing QR part [INDEX] of [SESSION] as SVG</code></h3><p>Returns the code as SVG markup so a project can display it its own way.</p><p>Block type: REPORTER. Opcode: <code>pairingQrPartSvg</code>. <a href="#block-pairingQrPartSvg">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>INDEX</code></th><td>NUMBER</td><td><code>1</code></td><td></td></tr><tr><th scope="row"><code>SESSION</code></th><td>STRING</td><td><code>pairing-1</code></td><td></td></tr></tbody></table></div></article><article id="block-pairingQrPartDataUri" class="block-reference-entry"><p class="fixed-input-help-link">Fixed literal fields: <code>INDEX</code>. <a href="#fixed-input-editing">Editing UI and preservation rules</a>.</p><h3><code>pairing QR part [INDEX] of [SESSION] as data URI</code></h3><p>Returns the code as a base64 SVG data URI for costumes and HTML images.</p><p>Block type: REPORTER. Opcode: <code>pairingQrPartDataUri</code>. <a href="#block-pairingQrPartDataUri">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>INDEX</code></th><td>NUMBER</td><td><code>1</code></td><td></td></tr><tr><th scope="row"><code>SESSION</code></th><td>STRING</td><td><code>pairing-1</code></td><td></td></tr></tbody></table></div></article><article id="block-endPairingQrDisplay" class="block-reference-entry"><h3><code>end pairing QR display of [SESSION]</code></h3><p>Restores the sprites this session changed. The session itself stays open.</p><p>Block type: COMMAND. Opcode: <code>endPairingQrDisplay</code>. <a href="#block-endPairingQrDisplay">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>SESSION</code></th><td>STRING</td><td><code>pairing-1</code></td><td></td></tr></tbody></table></div></article><article id="block-pairingPhase" class="block-reference-entry"><h3><code>pairing phase of [SESSION]</code></h3><p>Returns the session phase, such as offer-ready, receiving, answer-ready, connecting, or connected.</p><p>Block type: REPORTER. Opcode: <code>pairingPhase</code>. <a href="#block-pairingPhase">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>SESSION</code></th><td>STRING</td><td><code>pairing-1</code></td><td></td></tr></tbody></table></div></article><article id="block-pairingConnectionState" class="block-reference-entry"><h3><code>pairing connection state of [SESSION]</code></h3><p>Returns the WebRTC connection state reported for this session&#x27;s peer.</p><p>Block type: REPORTER. Opcode: <code>pairingConnectionState</code>. <a href="#block-pairingConnectionState">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>SESSION</code></th><td>STRING</td><td><code>pairing-1</code></td><td></td></tr></tbody></table></div></article><article id="block-isPairingConnected" class="block-reference-entry"><h3><code>pairing [SESSION] connected?</code></h3><p>Reports whether WebRTC has established the connection for this session.</p><p>Block type: BOOLEAN. Opcode: <code>isPairingConnected</code>. <a href="#block-isPairingConnected">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>SESSION</code></th><td>STRING</td><td><code>pairing-1</code></td><td></td></tr></tbody></table></div></article><article id="block-waitUntilPairingConnected" class="block-reference-entry"><h3><code>wait until pairing [SESSION] is connected</code></h3><p>Waits for the connection, or fails when the session is cancelled, times out, or fails.</p><p>Block type: COMMAND. Opcode: <code>waitUntilPairingConnected</code>. <a href="#block-waitUntilPairingConnected">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>SESSION</code></th><td>STRING</td><td><code>pairing-1</code></td><td></td></tr></tbody></table></div></article><article id="block-pairingError" class="block-reference-entry"><h3><code>pairing error code of [SESSION]</code></h3><p>Returns the latest error code, such as hash-mismatch or peer-mismatch, or an empty string.</p><p>Block type: REPORTER. Opcode: <code>pairingError</code>. <a href="#block-pairingError">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>SESSION</code></th><td>STRING</td><td><code>pairing-1</code></td><td></td></tr></tbody></table></div></article><article id="block-pairingErrorMessage" class="block-reference-entry"><h3><code>pairing error message of [SESSION]</code></h3><p>Returns the latest error message. Pairing codes and QR payloads are never included.</p><p>Block type: REPORTER. Opcode: <code>pairingErrorMessage</code>. <a href="#block-pairingErrorMessage">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>SESSION</code></th><td>STRING</td><td><code>pairing-1</code></td><td></td></tr></tbody></table></div></article><article id="block-pairingLocalPeer" class="block-reference-entry"><h3><code>local peer of [SESSION]</code></h3><p>Returns the name this machine uses for itself in this exchange.</p><p>Block type: REPORTER. Opcode: <code>pairingLocalPeer</code>. <a href="#block-pairingLocalPeer">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>SESSION</code></th><td>STRING</td><td><code>pairing-1</code></td><td></td></tr></tbody></table></div></article><article id="block-pairingRemotePeer" class="block-reference-entry"><h3><code>remote peer of [SESSION]</code></h3><p>Returns the name this machine uses for the other machine, which is also its WebRTC peer name.</p><p>Block type: REPORTER. Opcode: <code>pairingRemotePeer</code>. <a href="#block-pairingRemotePeer">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>SESSION</code></th><td>STRING</td><td><code>pairing-1</code></td><td></td></tr></tbody></table></div></article><article id="block-pairingExchangeId" class="block-reference-entry"><h3><code>exchange id of [SESSION]</code></h3><p>Returns the identifier of the current offer and answer exchange. A retry allocates a new one.</p><p>Block type: REPORTER. Opcode: <code>pairingExchangeId</code>. <a href="#block-pairingExchangeId">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>SESSION</code></th><td>STRING</td><td><code>pairing-1</code></td><td></td></tr></tbody></table></div></article><article id="block-pairingRemainingSeconds" class="block-reference-entry"><h3><code>remaining seconds of [SESSION]</code></h3><p>Returns the seconds left before the exchange times out.</p><p>Block type: REPORTER. Opcode: <code>pairingRemainingSeconds</code>. <a href="#block-pairingRemainingSeconds">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>SESSION</code></th><td>STRING</td><td><code>pairing-1</code></td><td></td></tr></tbody></table></div></article><article id="block-pairingSessions" class="block-reference-entry"><h3><code>pairing sessions</code></h3><p>Returns the open session names, separated by commas.</p><p>Block type: REPORTER. Opcode: <code>pairingSessions</code>. <a href="#block-pairingSessions">Permanent link</a></p><p>This block has no arguments.</p></article><article id="block-cancelPairing" class="block-reference-entry"><h3><code>cancel pairing [SESSION]</code></h3><p>Cancels the exchange and releases displays, buffers, and unconnected peers. Established connections stay up.</p><p>Block type: COMMAND. Opcode: <code>cancelPairing</code>. <a href="#block-cancelPairing">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>SESSION</code></th><td>STRING</td><td><code>pairing-1</code></td><td></td></tr></tbody></table></div></article><article id="block-retryPairing" class="block-reference-entry"><h3><code>retry pairing [SESSION]</code></h3><p>Starts a new exchange for the same session. QR codes from the previous exchange stop being accepted.</p><p>Block type: COMMAND. Opcode: <code>retryPairing</code>. <a href="#block-retryPairing">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>SESSION</code></th><td>STRING</td><td><code>pairing-1</code></td><td></td></tr></tbody></table></div></article><article id="block-setPairingTimeout" class="block-reference-entry"><p class="fixed-input-help-link">Fixed literal fields: <code>SECONDS</code>. <a href="#fixed-input-editing">Editing UI and preservation rules</a>.</p><h3><code>set pairing timeout of [SESSION] to [SECONDS] seconds</code></h3><p>Sets how long the exchange waits, measured on this machine&#x27;s own clock.</p><p>Block type: COMMAND. Opcode: <code>setPairingTimeout</code>. <a href="#block-setPairingTimeout">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>SESSION</code></th><td>STRING</td><td><code>pairing-1</code></td><td></td></tr><tr><th scope="row"><code>SECONDS</code></th><td>NUMBER</td><td><code>600</code></td><td></td></tr></tbody></table></div></article>
+<p><a href="https://github.com/kubohiroya/turbowarp-webrtc-qrcode-pairing/blob/main/README.md">Repository guide and examples</a></p>
+</section>
+<!-- END COMPLETE BLOCK REFERENCE -->
+
+<section id="fixed-input-editing"><h2>Fixed input editing</h2><p>With a compatible TurboWarp GUI, enable fixed-input forms to edit only standard literal fields. Numbers use complete finite JSON number tokens; menu fields use existing choices. Connected reporters and unavailable fields stay read-only and are never evaluated. Saving an unchanged form preserves exact existing raw values, including legacy spellings and unknown choices. Invalid drafts stay in the same editing session; cancel, project/target replacement, or block removal discards them. Disabling the GUI feature flag restores native field editing. This form does not run blocks, open network/audio/key/QR sessions, resolve names, or edit Schema arguments. QR index is a positive integer without a session-derived candidate limit. Timeout remains 1–3600 seconds.</p><ul><li><a href="#block-showPairingQrPart"><code>showPairingQrPart</code></a>: INDEX</li><li><a href="#block-pairingQrPartSvg"><code>pairingQrPartSvg</code></a>: INDEX</li><li><a href="#block-pairingQrPartDataUri"><code>pairingQrPartDataUri</code></a>: INDEX</li><li><a href="#block-setPairingTimeout"><code>setPairingTimeout</code></a>: SECONDS</li></ul></section>
 </body>
 </html>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubohiroya/turbowarp-webrtc-qrcode-pairing",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "TurboWarp extension that pairs WebRTC peers by carrying offers and answers as QR codes.",
   "author": "Hiroya Kubo <hiroya@cuc.ac.jp>",
   "license": "MPL-2.0",
@@ -25,12 +25,12 @@
   "files": [
     "dist/",
     "docs/",
-    "schemas/",
     "src/",
     "templates/",
     "README.md",
     "README.ja.md",
-    "LICENSE"
+    "LICENSE",
+    "schemas"
   ],
   "publishConfig": {
     "access": "public",
@@ -57,20 +57,22 @@
   },
   "devDependencies": {
     "@eslint/js": "^9.39.5",
-    "@kubohiroya/turbowarp-jsqr": "0.4.0",
-    "@kubohiroya/vite-plugin-turbowarp-extension": "0.3.0",
+    "@kubohiroya/turbowarp-extension-manifest": "0.3.2",
+    "@kubohiroya/turbowarp-jsqr": "0.4.1",
+    "@kubohiroya/vite-plugin-turbowarp-extension": "0.6.1",
     "@types/node": "^24.13.3",
     "eslint": "^9.39.5",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.66.0",
     "vite": "^8.2.2",
     "vitest": "^5.0.0",
-    "zxing-wasm": "3.1.4"
+    "zxing-wasm": "3.1.4",
+    "@kubohiroya/turbowarp-extension-data-editor": "0.2.1"
   },
   "peerDependencies": {
-    "@kubohiroya/turbowarp-camera-source": "0.5.0",
-    "@kubohiroya/turbowarp-jsqr": ">=0.4.0 <1",
-    "@kubohiroya/turbowarp-webrtc": ">=0.4.0"
+    "@kubohiroya/turbowarp-camera-source": "0.17.1",
+    "@kubohiroya/turbowarp-jsqr": "0.4.1",
+    "@kubohiroya/turbowarp-webrtc": "0.4.1"
   },
   "peerDependenciesMeta": {
     "@kubohiroya/turbowarp-webrtc": {
@@ -84,6 +86,12 @@
     }
   },
   "dependencies": {
-    "@kubohiroya/qrcode-structured-append": "0.1.0"
+    "@kubohiroya/qrcode-structured-append": "0.1.1"
+  },
+  "gitHead": "f085ffbbb8417b058d102cc9c0679160f5904d4f",
+  "x-turbowarp-source": {
+    "revision": "f085ffbbb8417b058d102cc9c0679160f5904d4f",
+    "revisionRole": "base-commit",
+    "sourceState": "local-release-overlay"
   }
 }

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

@@ -0,0 +1,48 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://kubohiroya.github.io/turbowarp-webrtc-qrcode-pairing/schemas/block-editor-fixed-inputs.schema.json",
+  "title": "turbowarp-webrtc-qrcode-pairing fixed editing contracts",
+  "$defs": {
+    "showPairingQrPart": {
+      "type": "object",
+      "properties": {
+        "INDEX": {
+          "type": "integer",
+          "minimum": 1
+        }
+      },
+      "additionalProperties": false
+    },
+    "pairingQrPartSvg": {
+      "type": "object",
+      "properties": {
+        "INDEX": {
+          "type": "integer",
+          "minimum": 1
+        }
+      },
+      "additionalProperties": false
+    },
+    "pairingQrPartDataUri": {
+      "type": "object",
+      "properties": {
+        "INDEX": {
+          "type": "integer",
+          "minimum": 1
+        }
+      },
+      "additionalProperties": false
+    },
+    "setPairingTimeout": {
+      "type": "object",
+      "properties": {
+        "SECONDS": {
+          "type": "number",
+          "minimum": 1,
+          "maximum": 3600
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/src/extension.ts

@@ -1,3 +1,4 @@
+import {registerFixedInputEditors} from './fixed-input-editors.js';
 import definitions from './block-definitions.json';
 import {extensionConfig} from './config';
 import {featureFlags} from './config/feature-flags.js';
@@ -33,6 +34,8 @@ export interface WebRtcQrCodePairingExtensionOptions extends PairingControllerOp
  * a runtime.
  */
 export class WebRtcQrCodePairingExtension implements TurboWarpExtension {
+  private fixedEditorsDispose: (() => void) | undefined;
+
   private readonly enabled: boolean;
   private readonly runtime: TurboWarpRuntime;
   private readonly pairing: PairingController;
@@ -68,13 +71,15 @@ export class WebRtcQrCodePairingExtension implements TurboWarpExtension {
   }
 
   public getInfo(): Record<string, unknown> {
-    return {
+    const info = {
       id: extensionConfig.id,
       name: Scratch.translate(definitions.extensionName),
       docsURI: extensionConfig.docsURI,
       blockIconURI: extensionConfig.blockIconURI,
       blocks: this.enabled ? blockDefinitions.map((block) => this.toScratchBlock(block)) : []
     };
+    this.fixedEditorsDispose ??= registerFixedInputEditors(Scratch, this.runtime, info.blocks);
+    return info;
   }
 
   // --- Starting an exchange ------------------------------------------------
@@ -246,6 +251,7 @@ export class WebRtcQrCodePairingExtension implements TurboWarpExtension {
   }
 
   public dispose(): void {
+    this.fixedEditorsDispose?.();
     this.pairing.dispose();
     this.runtime.off?.('PROJECT_RUN_STOP', this.stopListener);
     this.runtime.off?.('PROJECT_STOP_ALL', this.stopListener);

package/src/fixed-input-editors.ts

@@ -0,0 +1,214 @@
+import type {
+  FixedInputBinding,
+  FixedInputEditorOptions,
+  JsonValue,
+  LiteralValue,
+} from "@kubohiroya/turbowarp-extension-data-editor";
+import type { SchemaBundle } from "@kubohiroya/turbowarp-extension-data-editor/schema";
+import schemas from "../schemas/block-editor-fixed-inputs.schema.json" with { type: "json" };
+interface InputSchema {
+  readonly type: string;
+  readonly enum?: readonly (string | number)[];
+  readonly minimum?: number;
+  readonly maximum?: number;
+  readonly exclusiveMinimum?: number;
+}
+const contracts = schemas.$defs as Readonly<
+  Record<string, { readonly properties: Readonly<Record<string, InputSchema>> }>
+>;
+const repository = "turbowarp-webrtc-qrcode-pairing";
+const extensionId = "kubohiroyawebrtcqrcodepairing";
+const token = /^-?(?:0|[1-9][0-9]*)(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$/u;
+export function readNumber(value: LiteralValue): number {
+  if (typeof value !== "string" && typeof value !== "number")
+    throw new TypeError("Invalid numeric projection.");
+  if (typeof value === "string" && value.trim() === "")
+    throw new TypeError("Existing blank field is readonly.");
+  const number = Number(value);
+  if (!Number.isFinite(number))
+    throw new TypeError("Existing nonfinite field is readonly.");
+  return number;
+}
+export function newNumberToken(value: JsonValue): string {
+  if (typeof value === "number") {
+    if (!Number.isFinite(value)) throw new TypeError("Invalid new number.");
+    return Object.is(value, -0) ? "-0" : String(value);
+  }
+  if (
+    typeof value !== "string" ||
+    !token.test(value.trim()) ||
+    !Number.isFinite(Number(value))
+  )
+    throw new TypeError("Invalid new number.");
+  return value.trim();
+}
+function existingChoice(_opcode: string, value: LiteralValue): string {
+  if (typeof value !== "string")
+    throw new TypeError("Invalid string projection.");
+  return value;
+}
+export function candidateValid(
+  _opcode: string,
+  _argument: string,
+  schema: InputSchema,
+  value: LiteralValue,
+): boolean {
+  if (schema.type === "number" || schema.type === "integer") {
+    let number;
+    try {
+      number = readNumber(value);
+    } catch {
+      return false;
+    }
+    if (schema.type === "integer" && !Number.isInteger(number)) return false;
+    if (schema.minimum !== undefined && number < schema.minimum) return false;
+    if (schema.maximum !== undefined && number > schema.maximum) return false;
+    if (
+      schema.exclusiveMinimum !== undefined &&
+      number <= schema.exclusiveMinimum
+    )
+      return false;
+    if (schema.enum && !schema.enum!.includes(number)) return false;
+    return true;
+  }
+  return typeof value === "string" && schema.enum!.includes(value);
+}
+export function fixedInputEditorOptions(): readonly FixedInputEditorOptions[] {
+  return Object.entries(contracts).map(([opcode, contract]) => ({
+    apiVersion: 1,
+    extensionId,
+    editorId: `${extensionId}.fixed.${opcode}`,
+    opcodes: [`${extensionId}_${opcode}`],
+    contractId: `${repository}.${opcode}.fixed`,
+    contractRevision: "fixed-inputs-v1",
+    validationContext: () => ({
+      consumerId: repository,
+      nowMs: 0,
+      settings: null,
+    }),
+    bindings: Object.entries(contract.properties).map(
+      ([argument, schema]): FixedInputBinding => {
+        const numeric = schema.type === "number" || schema.type === "integer";
+        const source = {
+          repository,
+          path: "schemas/block-editor-fixed-inputs.schema.json",
+          symbol: `/$defs/${opcode}/properties/${argument}`,
+        };
+        return {
+          argument,
+          schemaBundle: {
+            identity: {
+              ownerId: repository,
+              contractId: `${opcode}.${argument}`,
+              revision: "fixed-inputs-v1",
+              variantId: "fixed",
+            },
+            dialect: "draft-07",
+            root: {
+              retrievalUri: `${schemas.$id}?binding=${opcode}.${argument}`,
+              document: schema as unknown as SchemaBundle["root"]["document"],
+              artifact: { role: "canonical-schema", source },
+            },
+            resources: [],
+            provenance: {
+              canonicalSources: [
+                source,
+                { repository, path: "src/block-definitions.json" },
+                { repository, path: "src/extension.ts", symbol: opcode },
+              ],
+              generatedFiles: [],
+              referenceSchemas: [],
+              generationSources: [],
+            },
+          },
+          control: numeric
+            ? { kind: "number" }
+            : {
+                kind: "enum",
+                choices: schema.enum!.map((value) => ({
+                  value,
+                  label: String(value),
+                })),
+              },
+          read: (value) =>
+            numeric ? readNumber(value) : existingChoice(opcode, value),
+          encode: (value) => {
+            if (numeric) return newNumberToken(value);
+            if (typeof value !== "string" || !schema.enum!.includes(value))
+              throw new TypeError("Invalid new enum value.");
+            return value;
+          },
+          validateCandidate: (value) =>
+            candidateValid(opcode, argument, schema, value)
+              ? []
+              : [
+                  {
+                    path: argument,
+                    message: "Check this value before saving.",
+                  },
+                ],
+        };
+      },
+    ),
+  }));
+}
+
+interface RegistrationRuntime {
+  on?(event: string, listener: () => void): void;
+  off?(event: string, listener: () => void): void;
+}
+/** Register only visible static contracts; ordinary composition consumers load no editor runtime. */
+export function registerFixedInputEditors(
+  scratch: unknown,
+  runtime: unknown,
+  visibleBlocks: readonly unknown[],
+): (() => void) | undefined {
+  const api = (
+    scratch as {
+      gui?: {
+        blockEditors?: {
+          apiVersion?: number;
+          registerFixedInputEditor?: (
+            options: FixedInputEditorOptions,
+          ) => () => void;
+        };
+      };
+    }
+  ).gui?.blockEditors;
+  if (
+    api?.apiVersion !== 1 ||
+    typeof api.registerFixedInputEditor !== "function"
+  )
+    return undefined;
+  const visibleOpcodes = new Set(
+    visibleBlocks.flatMap((block) => {
+      if (typeof block !== "object" || block === null || !("opcode" in block))
+        return [];
+      return typeof block.opcode === "string" ? [block.opcode] : [];
+    }),
+  );
+  const events = runtime as RegistrationRuntime | undefined;
+  const removers: (() => void)[] = [];
+  let active = true;
+  const dispose = () => {
+    if (!active) return;
+    active = false;
+    events?.off?.("RUNTIME_DISPOSED", dispose);
+    for (const remove of removers.splice(0).reverse()) remove();
+  };
+  try {
+    for (const options of fixedInputEditorOptions()) {
+      if (
+        options.opcodes.some((opcode) =>
+          visibleOpcodes.has(opcode.slice(extensionId.length + 1)),
+        )
+      )
+        removers.push(api.registerFixedInputEditor.call(api, options));
+    }
+    events?.on?.("RUNTIME_DISPOSED", dispose);
+  } catch (error) {
+    dispose();
+    throw error;
+  }
+  return dispose;
+}

package/schemas/extension-manifest.schema.json

@@ -1,49 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://raw.githubusercontent.com/kubohiroya/turbowarp-extension-template/main/schemas/extension-manifest.schema.json",
-  "title": "TurboWarp Extension API Manifest",
-  "type": "object",
-  "additionalProperties": false,
-  "required": ["formatVersion", "id", "blocks", "menus"],
-  "properties": {
-    "formatVersion": {"const": 1},
-    "id": {"type": "string", "pattern": "^[a-z0-9]+$"},
-    "blocks": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "additionalProperties": false,
-        "required": ["opcode", "blockType", "arguments"],
-        "properties": {
-          "opcode": {"type": "string", "minLength": 1},
-          "blockType": {"type": "string", "minLength": 1},
-          "arguments": {
-            "type": "array",
-            "items": {
-              "type": "object",
-              "additionalProperties": false,
-              "required": ["id", "type"],
-              "properties": {
-                "id": {"type": "string", "minLength": 1},
-                "type": {"type": "string", "minLength": 1},
-                "menu": {"type": "string", "minLength": 1}
-              }
-            }
-          }
-        }
-      }
-    },
-    "menus": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "additionalProperties": false,
-        "required": ["id", "acceptReporters"],
-        "properties": {
-          "id": {"type": "string", "minLength": 1},
-          "acceptReporters": {"type": "boolean"}
-        }
-      }
-    }
-  }
-}

package/src/extension-manifest.ts

@@ -1,149 +0,0 @@
-import type {Plugin} from 'vite';
-
-export const EXTENSION_MANIFEST_FORMAT_VERSION = 1 as const;
-
-export interface ExtensionManifestArgument {
-  id: string;
-  type: string;
-  menu?: string;
-}
-
-export interface ExtensionManifestBlock {
-  opcode: string;
-  blockType: string;
-  arguments: ExtensionManifestArgument[];
-}
-
-export interface ExtensionManifestMenu {
-  id: string;
-  acceptReporters: boolean;
-}
-
-export interface ExtensionManifest {
-  formatVersion: typeof EXTENSION_MANIFEST_FORMAT_VERSION;
-  id: string;
-  blocks: ExtensionManifestBlock[];
-  menus: ExtensionManifestMenu[];
-}
-
-export interface ExtensionManifestPluginOptions {
-  id: string;
-  definitions: unknown;
-  fileName?: string;
-}
-
-export function createExtensionManifest(id: string, definitions: unknown): ExtensionManifest {
-  if (!/^[a-z0-9]+$/.test(id)) {
-    throw new TypeError('Extension manifest ID must contain only lowercase letters and numbers.');
-  }
-
-  const source = requireRecord(definitions, 'Block definitions');
-  const sourceBlocks = source.blocks;
-  if (!Array.isArray(sourceBlocks)) {
-    throw new TypeError('Block definitions must contain a blocks array.');
-  }
-
-  const menus = normalizeMenus(source.menus);
-  const menuIds = new Set(menus.map((menu) => menu.id));
-  const seenOpcodes = new Set<string>();
-  const blocks = sourceBlocks.map((block, index) => {
-    const normalized = normalizeBlock(block, index, menuIds);
-    if (seenOpcodes.has(normalized.opcode)) {
-      throw new TypeError(`Duplicate block opcode: ${normalized.opcode}`);
-    }
-    seenOpcodes.add(normalized.opcode);
-    return normalized;
-  });
-
-  return {
-    formatVersion: EXTENSION_MANIFEST_FORMAT_VERSION,
-    id,
-    blocks: blocks.sort((left, right) => compareIds(left.opcode, right.opcode)),
-    menus
-  };
-}
-
-export function serializeExtensionManifest(id: string, definitions: unknown): string {
-  return `${JSON.stringify(createExtensionManifest(id, definitions), null, 2)}\n`;
-}
-
-export function extensionManifestPlugin(options: ExtensionManifestPluginOptions): Plugin {
-  return {
-    name: 'extension-api-manifest',
-    apply: 'build',
-    enforce: 'post',
-    generateBundle() {
-      this.emitFile({
-        type: 'asset',
-        fileName: options.fileName ?? 'extension-manifest.json',
-        source: serializeExtensionManifest(options.id, options.definitions)
-      });
-    }
-  };
-}
-
-function normalizeBlock(
-  value: unknown,
-  index: number,
-  menuIds: ReadonlySet<string>
-): ExtensionManifestBlock {
-  const block = requireRecord(value, `Block at index ${index}`);
-  const opcode = requireNonEmptyString(block.opcode, `Block at index ${index} opcode`);
-  const blockType = requireNonEmptyString(block.blockType, `Block ${opcode} blockType`);
-  const sourceArguments = block.arguments ?? {};
-  const argumentRecord = requireRecord(sourceArguments, `Block ${opcode} arguments`);
-  const argumentsList = Object.entries(argumentRecord).map(([argumentId, argument]) => {
-    requireNonEmptyString(argumentId, `Block ${opcode} argument ID`);
-    const definition = requireRecord(argument, `Block ${opcode} argument ${argumentId}`);
-    const type = requireNonEmptyString(
-      definition.type,
-      `Block ${opcode} argument ${argumentId} type`
-    );
-    const menu = definition.menu;
-    if (menu !== undefined && (typeof menu !== 'string' || !menuIds.has(menu))) {
-      throw new TypeError(`Block ${opcode} argument ${argumentId} references unknown menu: ${menu}`);
-    }
-    return menu === undefined ? {id: argumentId, type} : {id: argumentId, type, menu};
-  });
-
-  return {
-    opcode,
-    blockType,
-    arguments: argumentsList.sort((left, right) => compareIds(left.id, right.id))
-  };
-}
-
-function normalizeMenus(value: unknown): ExtensionManifestMenu[] {
-  const menuRecord = requireRecord(value ?? {}, 'Block definition menus');
-  return Object.entries(menuRecord)
-    .map(([id, menu]) => {
-      requireNonEmptyString(id, 'Menu ID');
-      const definition = requireRecord(menu, `Menu ${id}`);
-      const acceptReporters = definition.acceptReporters ?? false;
-      if (typeof acceptReporters !== 'boolean') {
-        throw new TypeError(`Menu ${id} acceptReporters must be a boolean.`);
-      }
-      return {id, acceptReporters};
-    })
-    .sort((left, right) => compareIds(left.id, right.id));
-}
-
-function requireRecord(value: unknown, label: string): Record<string, unknown> {
-  if (typeof value !== 'object' || value === null || Array.isArray(value)) {
-    throw new TypeError(`${label} must be an object.`);
-  }
-  return value as Record<string, unknown>;
-}
-
-function requireNonEmptyString(value: unknown, label: string): string {
-  if (typeof value !== 'string' || value.length === 0) {
-    throw new TypeError(`${label} must be a non-empty string.`);
-  }
-  return value;
-}
-
-function compareIds(left: string, right: string): number {
-  if (left < right) return -1;
-  if (left > right) return 1;
-  return 0;
-}