@kubohiroya/turbowarp-asset-cache 0.2.0 → 0.2.2

package/README.md

@@ -4,6 +4,13 @@ A browser-local image, audio, and runtime-text asset cache for TurboWarp project
 
 Asset Cache intentionally keeps the legacy `isLoaded` and cache lifecycle semantics. It is not a general server object store: every block is marked `server.supported: false` in the format 2 manifest. Use [`@kubohiroya/turbowarp-kvs`](https://github.com/kubohiroya/turbowarp-kvs) for portable namespace/key persistence and server lowering.
 
+`@kubohiroya/turbowarp-asset-manager` is deprecated. Composition consumers can replace its import
+path with `@kubohiroya/turbowarp-asset-cache/composition` for asset registration, rendering,
+playback, DOM image resources, and verified remote-cache APIs. Import binary object, bundle, and
+session-backing APIs directly from `@kubohiroya/turbowarp-kvs`. Standalone projects must also
+replace the extension ID `kubohiroyaassetmanager` with `kubohiroyaassetcache`; published historical
+SB3 artifacts should remain pinned to their original extension.
+
 ## User Guide
 
 For setup, safety notes, recipes, and the illustrated block guide, see the [English user guide](https://kubohiroya.github.io/turbowarp-asset-cache/) or [Japanese user guide](https://kubohiroya.github.io/turbowarp-asset-cache/ja/).
@@ -41,13 +48,13 @@ The built JavaScript file is committed to this repository so users do not need t
 The versioned npm package contains the same reviewed build:
 
 ```bash
-pnpm add --save-exact @kubohiroya/turbowarp-asset-cache@0.2.0
+pnpm add --save-exact @kubohiroya/turbowarp-asset-cache@0.2.2
 ```
 
 Load `node_modules/@kubohiroya/turbowarp-asset-cache/dist/asset-cache.js`, or use the version-pinned CDN URL:
 
 ```text
-https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-asset-cache@0.2.0/dist/asset-cache.js
+https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-asset-cache@0.2.2/dist/asset-cache.js
 ```
 
 ## Quick Start

package/dist/asset-cache.js

@@ -287,7 +287,404 @@
     ]
   };
   //#endregion
-  //#region node_modules/.pnpm/@kubohiroya+turbowarp-named-data@0.1.0/node_modules/@kubohiroya/turbowarp-named-data/dist/composition.js
+  //#region node_modules/.pnpm/@kubohiroya+turbowarp-extension-data-editor@0.2.1_react@18.3.1/node_modules/@kubohiroya/turbowarp-extension-data-editor/dist/fixed-input-schema.js
+  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-asset-cache/schemas/block-editor-fixed-inputs.schema.json",
+    $defs: {
+      "setTextStyle": {
+        "type": "object",
+        "properties": {
+          "PROPERTY": {
+            "type": "string",
+            "enum": [
+              "animation",
+              "font",
+              "color",
+              "width",
+              "align"
+            ]
+          },
+          "VALUE": { "type": "string" }
+        },
+        "additionalProperties": false
+      },
+      "animation": {
+        "type": "string",
+        "enum": [
+          "",
+          "none",
+          "type",
+          "rainbow",
+          "zoom",
+          "shake"
+        ]
+      },
+      "font": { "type": "string" },
+      "color": {
+        "type": "string",
+        "pattern": "^(?:|#[0-9a-fA-F]{3}|#[0-9a-fA-F]{6})$"
+      },
+      "width": {
+        "type": "string",
+        "$comment": "Empty/trimmed empty resets; otherwise normalizeTextStyleValue requires Number(value) finite and positive. Preserve the existing STRING grammar, including hexadecimal and leading plus."
+      },
+      "align": {
+        "type": "string",
+        "enum": [
+          "",
+          "left",
+          "center",
+          "right"
+        ]
+      },
+      "loadingCostumeAt": {
+        "type": "object",
+        "properties": { "INDEX": { "type": "number" } },
+        "additionalProperties": false
+      }
+    }
+  };
+  //#endregion
+  //#region src/fixed-input-schema.ts
+  /** Canonical owner schema fragments; no network resources or runtime providers. */
+  function fixedInputBundle(fragment, schema) {
+    const source = {
+      repository: "turbowarp-asset-cache",
+      path: "schemas/block-editor-fixed-inputs.schema.json",
+      symbol: {
+        "setTextStyle-PROPERTY": "#/$defs/setTextStyle/properties/PROPERTY",
+        "setTextStyle-VALUE": "#/$defs/setTextStyle/properties/VALUE",
+        "loadingCostumeAt-INDEX": "#/$defs/loadingCostumeAt/properties/INDEX"
+      }[fragment] ?? `#/$defs/${fragment}`
+    };
+    return {
+      identity: {
+        ownerId: "turbowarp-asset-cache",
+        contractId: "fixed-inputs",
+        revision: "1",
+        variantId: fragment
+      },
+      dialect: "2020-12",
+      root: {
+        retrievalUri: block_editor_fixed_inputs_schema_default.$id,
+        document: schema,
+        artifact: {
+          role: "canonical-schema",
+          source
+        }
+      },
+      resources: [],
+      provenance: {
+        canonicalSources: [
+          source,
+          {
+            repository: "turbowarp-asset-cache",
+            path: "src/text-style.ts",
+            symbol: "normalizeTextStyleProperty / normalizeTextStyleValue"
+          },
+          {
+            repository: "turbowarp-asset-cache",
+            path: "src/extension.ts",
+            symbol: "getInfo / loadingCostumeAt"
+          }
+        ],
+        generatedFiles: [],
+        referenceSchemas: [],
+        generationSources: []
+      }
+    };
+  }
+  var fixedSchemas = block_editor_fixed_inputs_schema_default.$defs;
+  //#endregion
+  //#region src/text-style.ts
+  var TEXT_RUNTIME_NAMESPACE = "text";
+  var TEXT_STYLE_RUNTIME_NAMESPACE = "textStyle";
+  var TEXT_STYLE_PROPERTIES = [
+    "animation",
+    "font",
+    "color",
+    "width",
+    "align"
+  ];
+  var DEFAULT_STAGE_WIDTH = 480;
+  var DEFAULT_FONT = "Handwriting";
+  var DEFAULT_COLOR = "#ffffff";
+  var DEFAULT_ALIGNMENT = "center";
+  var DEFAULT_OUTLINE_COLOR = "#000000";
+  function textRuntimeVariableName(name) {
+    return `${TEXT_RUNTIME_NAMESPACE}:${name}`;
+  }
+  function textStyleRuntimeVariableName(name, property) {
+    return `${TEXT_STYLE_RUNTIME_NAMESPACE}:${name}:${property}`;
+  }
+  function normalizeTextStyleProperty(value) {
+    const property = String(value ?? "").trim().toLowerCase();
+    if (TEXT_STYLE_PROPERTIES.includes(property)) return property;
+    throw new Error(`Unknown text style property: ${property || "(empty)"}`);
+  }
+  /**
+  * Normalize a DSL-facing style value for runtime-variable storage.
+  * An empty value intentionally resets the property to its default.
+  */
+  function normalizeTextStyleValue(property, value) {
+    const raw = String(value ?? "").trim();
+    if (!raw) return "";
+    switch (property) {
+      case "animation": {
+        const animation = raw.toLowerCase() === "typing" ? "type" : raw.toLowerCase();
+        if (animation === "none" || animation === "type" || animation === "rainbow" || animation === "zoom" || animation === "shake") return animation;
+        throw new Error(`Invalid text animation: ${raw}`);
+      }
+      case "font": return raw;
+      case "color": {
+        if (/^#[0-9a-f]{6}$/i.test(raw)) return raw.toLowerCase();
+        const shortColor = /^#([0-9a-f])([0-9a-f])([0-9a-f])$/i.exec(raw);
+        if (shortColor) return `#${shortColor[1]}${shortColor[1]}${shortColor[2]}${shortColor[2]}${shortColor[3]}${shortColor[3]}`.toLowerCase();
+        throw new Error(`Invalid text color: ${raw}`);
+      }
+      case "width": {
+        const width = Number(raw);
+        if (!Number.isFinite(width) || width <= 0) throw new Error(`Text width must be a positive number: ${raw}`);
+        return String(width);
+      }
+      case "align": {
+        const align = raw.toLowerCase();
+        if (align === "left" || align === "center" || align === "right") return align;
+        throw new Error(`Invalid text alignment: ${raw}`);
+      }
+    }
+  }
+  function resolveTextStyle(name, stageWidth, getRuntimeVariable) {
+    const width = Number(stageWidth);
+    const defaults = {
+      animation: "none",
+      font: DEFAULT_FONT,
+      color: DEFAULT_COLOR,
+      width: Number.isFinite(width) && width > 0 ? width : DEFAULT_STAGE_WIDTH,
+      align: DEFAULT_ALIGNMENT
+    };
+    const read = (property) => normalizeTextStyleValue(property, getRuntimeVariable(textStyleRuntimeVariableName(name, property)));
+    const animation = read("animation");
+    const font = read("font");
+    const color = read("color");
+    const configuredWidth = read("width");
+    const align = read("align");
+    return {
+      animation: animation ? animation : defaults.animation,
+      font: font || defaults.font,
+      color: color || defaults.color,
+      width: configuredWidth ? Number(configuredWidth) : defaults.width,
+      align: align ? align : defaults.align
+    };
+  }
+  //#endregion
+  //#region src/fixed-input-editors.ts
+  var extensionId = "kubohiroyaassetcache";
+  var choices = (values) => values.map((value) => ({ value }));
+  var context = () => ({
+    consumerId: "turbowarp-asset-cache",
+    nowMs: 0,
+    settings: null
+  });
+  var string = (value) => {
+    if (typeof value !== "string") throw new TypeError("Expected a string literal.");
+    return value;
+  };
+  var issue = () => [{ message: "Invalid asset style value." }];
+  /** New edits preserve the candidate token; existing aliases are display projections only. */
+  function styleBinding(property) {
+    const values = property === "animation" ? [
+      "",
+      "none",
+      "type",
+      "rainbow",
+      "zoom",
+      "shake"
+    ] : property === "align" ? [
+      "",
+      "left",
+      "center",
+      "right"
+    ] : void 0;
+    return {
+      argument: "VALUE",
+      schemaBundle: fixedInputBundle(property, fixedSchemas[property]),
+      control: {
+        kind: values ? "enum" : property === "color" ? "color" : property === "width" ? "number" : "text",
+        reset: "",
+        ...values ? { choices: choices(values) } : {}
+      },
+      read(value) {
+        return normalizeTextStyleValue(property, string(value));
+      },
+      encode(value) {
+        const raw = string(value);
+        if (property !== "width" || raw === "") return raw;
+        normalizeTextStyleValue(property, raw);
+        return raw;
+      },
+      validateCandidate(value) {
+        try {
+          normalizeTextStyleValue(property, string(value));
+          return [];
+        } catch {
+          return issue();
+        }
+      }
+    };
+  }
+  var fixedInputEditors = [{
+    apiVersion: 1,
+    extensionId,
+    editorId: "text-style-fixed",
+    opcodes: [`${extensionId}_setTextStyle`],
+    contractId: "CP-asset-cache",
+    contractRevision: "1",
+    validationContext: context,
+    bindings: [{
+      argument: "PROPERTY",
+      schemaBundle: fixedInputBundle("setTextStyle-PROPERTY", fixedSchemas.setTextStyle.properties.PROPERTY),
+      control: {
+        kind: "enum",
+        choices: choices(TEXT_STYLE_PROPERTIES)
+      },
+      read(value) {
+        const raw = string(value);
+        try {
+          return normalizeTextStyleProperty(raw);
+        } catch {
+          return raw;
+        }
+      },
+      encode: (value) => string(value),
+      validateCandidate(value) {
+        try {
+          normalizeTextStyleProperty(value);
+          return [];
+        } catch {
+          return issue();
+        }
+      }
+    }, {
+      argument: "VALUE",
+      schemaBundle: fixedInputBundle("setTextStyle-VALUE", fixedSchemas.setTextStyle.properties.VALUE),
+      read: (value) => string(value),
+      encode: (value) => string(value),
+      validateCandidate: () => []
+    }],
+    dependencies: [{
+      selector: "PROPERTY",
+      dependents: ["VALUE"]
+    }],
+    branchPolicies: [{
+      selector: "PROPERTY",
+      normalize: {
+        trim: true,
+        lowercase: true
+      },
+      cases: TEXT_STYLE_PROPERTIES.map((property) => ({
+        values: [property],
+        activeDependents: ["VALUE"],
+        bindings: [styleBinding(property)]
+      }))
+    }]
+  }, {
+    apiVersion: 1,
+    extensionId,
+    editorId: "loading-costume-index-fixed",
+    opcodes: [`${extensionId}_loadingCostumeAt`],
+    contractId: "turbowarp-asset-cache/loadingCostumeAt.INDEX",
+    contractRevision: "1",
+    validationContext: context,
+    bindings: [{
+      argument: "INDEX",
+      schemaBundle: fixedInputBundle("loadingCostumeAt-INDEX", fixedSchemas.loadingCostumeAt.properties.INDEX),
+      control: { kind: "number" },
+      read(value) {
+        if (typeof value !== "number" && typeof value !== "string" || typeof value === "string" && value.trim() === "") throw new TypeError("Non-numeric index.");
+        const number = Number(value);
+        if (!Number.isFinite(number)) throw new TypeError("Nonfinite index.");
+        return number;
+      },
+      encode(value) {
+        const parsed = parseFixedNumberInput(value);
+        if (parsed.kind !== "valid") throw new TypeError("Invalid index.");
+        return parsed.token;
+      },
+      validateCandidate(value) {
+        return Number.isFinite(Number(value)) ? [] : [{ message: "Invalid index." }];
+      }
+    }]
+  }];
+  /** Per-instance, idempotent registration. Legacy hosts never acquire the fixed capability. */
+  function fixedInputRegistration(scratch) {
+    const host = scratch;
+    let active;
+    let removers = [];
+    let disposed = false;
+    const dispose = () => {
+      host.vm?.runtime?.off?.("RUNTIME_DISPOSED", shutdown);
+      for (const remove of removers.splice(0).reverse()) remove();
+      active = void 0;
+    };
+    const shutdown = () => {
+      disposed = true;
+      dispose();
+    };
+    return {
+      ensure(opcodes) {
+        const api = host.gui?.blockEditors;
+        if (disposed || api === active) return;
+        dispose();
+        if (api?.apiVersion !== 1 || typeof api.registerFixedInputEditor !== "function") return;
+        try {
+          for (const definition of fixedInputEditors) if (definition.opcodes.every((opcode) => opcodes.includes(opcode))) {
+            const remove = api.registerFixedInputEditor.call(api, definition);
+            if (typeof remove !== "function") throw new TypeError("Invalid fixed registration cleanup.");
+            removers.push(remove);
+          }
+          active = api;
+          host.vm?.runtime?.on?.("RUNTIME_DISPOSED", shutdown);
+        } catch (error) {
+          dispose();
+          throw error;
+        }
+      },
+      dispose: shutdown
+    };
+  }
+  //#endregion
+  //#region node_modules/.pnpm/@kubohiroya+turbowarp-named-data@0.3.1/node_modules/@kubohiroya/turbowarp-named-data/dist/composition.js
   var NAMED_DATA_REGISTRY_SYMBOL_KEY = "@kubohiroya/turbowarp-named-data/registry";
   var NAMED_DATA_REGISTRY_SYMBOL = Symbol.for(NAMED_DATA_REGISTRY_SYMBOL_KEY);
   var NAMED_DATA_NAMESPACE_PATTERN = /^[a-z][a-z0-9.-]{0,63}$/u;
@@ -308,6 +705,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",
@@ -316,6 +715,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",
@@ -536,9 +938,21 @@
     if (!reference || typeof reference !== "object") throw invalidReference$1();
     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$1();
+    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";
@@ -575,7 +989,10 @@
     const value = globalThis.__TW_NAMED_DATA_FEATURE_FLAGS__?.[name];
     return value === true || value === "true";
   }
-  Object.freeze({ NAMED_DATA_REGISTRY_MVP: configuredFlag$1("NAMED_DATA_REGISTRY_MVP") });
+  Object.freeze({
+    NAMED_DATA_REGISTRY_MVP: configuredFlag$1("NAMED_DATA_REGISTRY_MVP"),
+    NAMED_DATA_SCHEMA_REF: configuredFlag$1("NAMED_DATA_SCHEMA_REF")
+  });
   //#endregion
   //#region \0@oxc-project+runtime@0.148.0/helpers/esm/typeof.js
   function _typeof(o) {
@@ -994,88 +1411,6 @@
     if (signal?.aborted) throw namedBodyAbortError();
   }
   //#endregion
-  //#region src/text-style.ts
-  var TEXT_RUNTIME_NAMESPACE = "text";
-  var TEXT_STYLE_RUNTIME_NAMESPACE = "textStyle";
-  var TEXT_STYLE_PROPERTIES = [
-    "animation",
-    "font",
-    "color",
-    "width",
-    "align"
-  ];
-  var DEFAULT_STAGE_WIDTH = 480;
-  var DEFAULT_FONT = "Handwriting";
-  var DEFAULT_COLOR = "#ffffff";
-  var DEFAULT_ALIGNMENT = "center";
-  var DEFAULT_OUTLINE_COLOR = "#000000";
-  function textRuntimeVariableName(name) {
-    return `${TEXT_RUNTIME_NAMESPACE}:${name}`;
-  }
-  function textStyleRuntimeVariableName(name, property) {
-    return `${TEXT_STYLE_RUNTIME_NAMESPACE}:${name}:${property}`;
-  }
-  function normalizeTextStyleProperty(value) {
-    const property = String(value ?? "").trim().toLowerCase();
-    if (TEXT_STYLE_PROPERTIES.includes(property)) return property;
-    throw new Error(`Unknown text style property: ${property || "(empty)"}`);
-  }
-  /**
-  * Normalize a DSL-facing style value for runtime-variable storage.
-  * An empty value intentionally resets the property to its default.
-  */
-  function normalizeTextStyleValue(property, value) {
-    const raw = String(value ?? "").trim();
-    if (!raw) return "";
-    switch (property) {
-      case "animation": {
-        const animation = raw.toLowerCase() === "typing" ? "type" : raw.toLowerCase();
-        if (animation === "none" || animation === "type" || animation === "rainbow" || animation === "zoom" || animation === "shake") return animation;
-        throw new Error(`Invalid text animation: ${raw}`);
-      }
-      case "font": return raw;
-      case "color": {
-        if (/^#[0-9a-f]{6}$/i.test(raw)) return raw.toLowerCase();
-        const shortColor = /^#([0-9a-f])([0-9a-f])([0-9a-f])$/i.exec(raw);
-        if (shortColor) return `#${shortColor[1]}${shortColor[1]}${shortColor[2]}${shortColor[2]}${shortColor[3]}${shortColor[3]}`.toLowerCase();
-        throw new Error(`Invalid text color: ${raw}`);
-      }
-      case "width": {
-        const width = Number(raw);
-        if (!Number.isFinite(width) || width <= 0) throw new Error(`Text width must be a positive number: ${raw}`);
-        return String(width);
-      }
-      case "align": {
-        const align = raw.toLowerCase();
-        if (align === "left" || align === "center" || align === "right") return align;
-        throw new Error(`Invalid text alignment: ${raw}`);
-      }
-    }
-  }
-  function resolveTextStyle(name, stageWidth, getRuntimeVariable) {
-    const width = Number(stageWidth);
-    const defaults = {
-      animation: "none",
-      font: DEFAULT_FONT,
-      color: DEFAULT_COLOR,
-      width: Number.isFinite(width) && width > 0 ? width : DEFAULT_STAGE_WIDTH,
-      align: DEFAULT_ALIGNMENT
-    };
-    const read = (property) => normalizeTextStyleValue(property, getRuntimeVariable(textStyleRuntimeVariableName(name, property)));
-    const animation = read("animation");
-    const font = read("font");
-    const color = read("color");
-    const configuredWidth = read("width");
-    const align = read("align");
-    return {
-      animation: animation ? animation : defaults.animation,
-      font: font || defaults.font,
-      color: color || defaults.color,
-      width: configuredWidth ? Number(configuredWidth) : defaults.width,
-      align: align ? align : defaults.align
-    };
-  }
-  //#endregion
   //#region src/extension.ts
   var EXTENSION_ID = "kubohiroyaassetcache";
   var EXTENSION_VERSION = "0.14.0";
@@ -1581,6 +1916,7 @@
         this.unbindNamedDataRegistryLifecycle?.();
         this.unbindNamedDataRegistryLifecycle = void 0;
       });
+      _defineProperty(this, "fixedEditors", fixedInputRegistration(Scratch));
       this.featureFlags = Object.freeze({ ...featureFlags });
       if (this.featureFlags.NAMED_ASSET_BODY_PROVIDER) {
         this.namedBodyProviderValue = this.createNamedBodyProvider();
@@ -1646,6 +1982,8 @@
       return loadingCostumes[((Number.isFinite(numericIndex) ? Math.max(1, Math.trunc(numericIndex)) : 1) - 1) % loadingCostumes.length];
     }
     getInfo() {
+      const blocks = blockDefinitions.map((block) => this.toScratchBlock(block));
+      this.fixedEditors.ensure(blocks.map((block) => `${EXTENSION_ID}_${block.opcode}`));
       return {
         id: EXTENSION_ID,
         name: Scratch.translate(block_definitions_default.extensionName),
@@ -1654,9 +1992,13 @@
         color1: "#5b7cfa",
         color2: "#425ed8",
         color3: "#2f46aa",
-        blocks: blockDefinitions.map((block) => this.toScratchBlock(block))
+        blocks
       };
     }
+    /** Release only this optional editor registration; runtime data remains unchanged. */
+    dispose() {
+      this.fixedEditors.dispose();
+    }
     /**
     * Exposes the stock extension registry through a host-neutral DOM image
     * resource contract for other unsandboxed extensions.

package/dist/composition.js

@@ -278,7 +278,404 @@ var block_definitions_default = {
 	]
 };
 //#endregion
-//#region node_modules/.pnpm/@kubohiroya+turbowarp-named-data@0.1.0/node_modules/@kubohiroya/turbowarp-named-data/dist/composition.js
+//#region node_modules/.pnpm/@kubohiroya+turbowarp-extension-data-editor@0.2.1_react@18.3.1/node_modules/@kubohiroya/turbowarp-extension-data-editor/dist/fixed-input-schema.js
+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-asset-cache/schemas/block-editor-fixed-inputs.schema.json",
+	$defs: {
+		"setTextStyle": {
+			"type": "object",
+			"properties": {
+				"PROPERTY": {
+					"type": "string",
+					"enum": [
+						"animation",
+						"font",
+						"color",
+						"width",
+						"align"
+					]
+				},
+				"VALUE": { "type": "string" }
+			},
+			"additionalProperties": false
+		},
+		"animation": {
+			"type": "string",
+			"enum": [
+				"",
+				"none",
+				"type",
+				"rainbow",
+				"zoom",
+				"shake"
+			]
+		},
+		"font": { "type": "string" },
+		"color": {
+			"type": "string",
+			"pattern": "^(?:|#[0-9a-fA-F]{3}|#[0-9a-fA-F]{6})$"
+		},
+		"width": {
+			"type": "string",
+			"$comment": "Empty/trimmed empty resets; otherwise normalizeTextStyleValue requires Number(value) finite and positive. Preserve the existing STRING grammar, including hexadecimal and leading plus."
+		},
+		"align": {
+			"type": "string",
+			"enum": [
+				"",
+				"left",
+				"center",
+				"right"
+			]
+		},
+		"loadingCostumeAt": {
+			"type": "object",
+			"properties": { "INDEX": { "type": "number" } },
+			"additionalProperties": false
+		}
+	}
+};
+//#endregion
+//#region src/fixed-input-schema.ts
+/** Canonical owner schema fragments; no network resources or runtime providers. */
+function fixedInputBundle(fragment, schema) {
+	const source = {
+		repository: "turbowarp-asset-cache",
+		path: "schemas/block-editor-fixed-inputs.schema.json",
+		symbol: {
+			"setTextStyle-PROPERTY": "#/$defs/setTextStyle/properties/PROPERTY",
+			"setTextStyle-VALUE": "#/$defs/setTextStyle/properties/VALUE",
+			"loadingCostumeAt-INDEX": "#/$defs/loadingCostumeAt/properties/INDEX"
+		}[fragment] ?? `#/$defs/${fragment}`
+	};
+	return {
+		identity: {
+			ownerId: "turbowarp-asset-cache",
+			contractId: "fixed-inputs",
+			revision: "1",
+			variantId: fragment
+		},
+		dialect: "2020-12",
+		root: {
+			retrievalUri: block_editor_fixed_inputs_schema_default.$id,
+			document: schema,
+			artifact: {
+				role: "canonical-schema",
+				source
+			}
+		},
+		resources: [],
+		provenance: {
+			canonicalSources: [
+				source,
+				{
+					repository: "turbowarp-asset-cache",
+					path: "src/text-style.ts",
+					symbol: "normalizeTextStyleProperty / normalizeTextStyleValue"
+				},
+				{
+					repository: "turbowarp-asset-cache",
+					path: "src/extension.ts",
+					symbol: "getInfo / loadingCostumeAt"
+				}
+			],
+			generatedFiles: [],
+			referenceSchemas: [],
+			generationSources: []
+		}
+	};
+}
+var fixedSchemas = block_editor_fixed_inputs_schema_default.$defs;
+//#endregion
+//#region src/text-style.ts
+var TEXT_RUNTIME_NAMESPACE = "text";
+var TEXT_STYLE_RUNTIME_NAMESPACE = "textStyle";
+var TEXT_STYLE_PROPERTIES = [
+	"animation",
+	"font",
+	"color",
+	"width",
+	"align"
+];
+var DEFAULT_STAGE_WIDTH = 480;
+var DEFAULT_FONT = "Handwriting";
+var DEFAULT_COLOR = "#ffffff";
+var DEFAULT_ALIGNMENT = "center";
+var DEFAULT_OUTLINE_COLOR = "#000000";
+function textRuntimeVariableName(name) {
+	return `${TEXT_RUNTIME_NAMESPACE}:${name}`;
+}
+function textStyleRuntimeVariableName(name, property) {
+	return `${TEXT_STYLE_RUNTIME_NAMESPACE}:${name}:${property}`;
+}
+function normalizeTextStyleProperty(value) {
+	const property = String(value ?? "").trim().toLowerCase();
+	if (TEXT_STYLE_PROPERTIES.includes(property)) return property;
+	throw new Error(`Unknown text style property: ${property || "(empty)"}`);
+}
+/**
+* Normalize a DSL-facing style value for runtime-variable storage.
+* An empty value intentionally resets the property to its default.
+*/
+function normalizeTextStyleValue(property, value) {
+	const raw = String(value ?? "").trim();
+	if (!raw) return "";
+	switch (property) {
+		case "animation": {
+			const animation = raw.toLowerCase() === "typing" ? "type" : raw.toLowerCase();
+			if (animation === "none" || animation === "type" || animation === "rainbow" || animation === "zoom" || animation === "shake") return animation;
+			throw new Error(`Invalid text animation: ${raw}`);
+		}
+		case "font": return raw;
+		case "color": {
+			if (/^#[0-9a-f]{6}$/i.test(raw)) return raw.toLowerCase();
+			const shortColor = /^#([0-9a-f])([0-9a-f])([0-9a-f])$/i.exec(raw);
+			if (shortColor) return `#${shortColor[1]}${shortColor[1]}${shortColor[2]}${shortColor[2]}${shortColor[3]}${shortColor[3]}`.toLowerCase();
+			throw new Error(`Invalid text color: ${raw}`);
+		}
+		case "width": {
+			const width = Number(raw);
+			if (!Number.isFinite(width) || width <= 0) throw new Error(`Text width must be a positive number: ${raw}`);
+			return String(width);
+		}
+		case "align": {
+			const align = raw.toLowerCase();
+			if (align === "left" || align === "center" || align === "right") return align;
+			throw new Error(`Invalid text alignment: ${raw}`);
+		}
+	}
+}
+function resolveTextStyle(name, stageWidth, getRuntimeVariable) {
+	const width = Number(stageWidth);
+	const defaults = {
+		animation: "none",
+		font: DEFAULT_FONT,
+		color: DEFAULT_COLOR,
+		width: Number.isFinite(width) && width > 0 ? width : DEFAULT_STAGE_WIDTH,
+		align: DEFAULT_ALIGNMENT
+	};
+	const read = (property) => normalizeTextStyleValue(property, getRuntimeVariable(textStyleRuntimeVariableName(name, property)));
+	const animation = read("animation");
+	const font = read("font");
+	const color = read("color");
+	const configuredWidth = read("width");
+	const align = read("align");
+	return {
+		animation: animation ? animation : defaults.animation,
+		font: font || defaults.font,
+		color: color || defaults.color,
+		width: configuredWidth ? Number(configuredWidth) : defaults.width,
+		align: align ? align : defaults.align
+	};
+}
+//#endregion
+//#region src/fixed-input-editors.ts
+var extensionId = "kubohiroyaassetcache";
+var choices = (values) => values.map((value) => ({ value }));
+var context = () => ({
+	consumerId: "turbowarp-asset-cache",
+	nowMs: 0,
+	settings: null
+});
+var string = (value) => {
+	if (typeof value !== "string") throw new TypeError("Expected a string literal.");
+	return value;
+};
+var issue = () => [{ message: "Invalid asset style value." }];
+/** New edits preserve the candidate token; existing aliases are display projections only. */
+function styleBinding(property) {
+	const values = property === "animation" ? [
+		"",
+		"none",
+		"type",
+		"rainbow",
+		"zoom",
+		"shake"
+	] : property === "align" ? [
+		"",
+		"left",
+		"center",
+		"right"
+	] : void 0;
+	return {
+		argument: "VALUE",
+		schemaBundle: fixedInputBundle(property, fixedSchemas[property]),
+		control: {
+			kind: values ? "enum" : property === "color" ? "color" : property === "width" ? "number" : "text",
+			reset: "",
+			...values ? { choices: choices(values) } : {}
+		},
+		read(value) {
+			return normalizeTextStyleValue(property, string(value));
+		},
+		encode(value) {
+			const raw = string(value);
+			if (property !== "width" || raw === "") return raw;
+			normalizeTextStyleValue(property, raw);
+			return raw;
+		},
+		validateCandidate(value) {
+			try {
+				normalizeTextStyleValue(property, string(value));
+				return [];
+			} catch {
+				return issue();
+			}
+		}
+	};
+}
+var fixedInputEditors = [{
+	apiVersion: 1,
+	extensionId,
+	editorId: "text-style-fixed",
+	opcodes: [`${extensionId}_setTextStyle`],
+	contractId: "CP-asset-cache",
+	contractRevision: "1",
+	validationContext: context,
+	bindings: [{
+		argument: "PROPERTY",
+		schemaBundle: fixedInputBundle("setTextStyle-PROPERTY", fixedSchemas.setTextStyle.properties.PROPERTY),
+		control: {
+			kind: "enum",
+			choices: choices(TEXT_STYLE_PROPERTIES)
+		},
+		read(value) {
+			const raw = string(value);
+			try {
+				return normalizeTextStyleProperty(raw);
+			} catch {
+				return raw;
+			}
+		},
+		encode: (value) => string(value),
+		validateCandidate(value) {
+			try {
+				normalizeTextStyleProperty(value);
+				return [];
+			} catch {
+				return issue();
+			}
+		}
+	}, {
+		argument: "VALUE",
+		schemaBundle: fixedInputBundle("setTextStyle-VALUE", fixedSchemas.setTextStyle.properties.VALUE),
+		read: (value) => string(value),
+		encode: (value) => string(value),
+		validateCandidate: () => []
+	}],
+	dependencies: [{
+		selector: "PROPERTY",
+		dependents: ["VALUE"]
+	}],
+	branchPolicies: [{
+		selector: "PROPERTY",
+		normalize: {
+			trim: true,
+			lowercase: true
+		},
+		cases: TEXT_STYLE_PROPERTIES.map((property) => ({
+			values: [property],
+			activeDependents: ["VALUE"],
+			bindings: [styleBinding(property)]
+		}))
+	}]
+}, {
+	apiVersion: 1,
+	extensionId,
+	editorId: "loading-costume-index-fixed",
+	opcodes: [`${extensionId}_loadingCostumeAt`],
+	contractId: "turbowarp-asset-cache/loadingCostumeAt.INDEX",
+	contractRevision: "1",
+	validationContext: context,
+	bindings: [{
+		argument: "INDEX",
+		schemaBundle: fixedInputBundle("loadingCostumeAt-INDEX", fixedSchemas.loadingCostumeAt.properties.INDEX),
+		control: { kind: "number" },
+		read(value) {
+			if (typeof value !== "number" && typeof value !== "string" || typeof value === "string" && value.trim() === "") throw new TypeError("Non-numeric index.");
+			const number = Number(value);
+			if (!Number.isFinite(number)) throw new TypeError("Nonfinite index.");
+			return number;
+		},
+		encode(value) {
+			const parsed = parseFixedNumberInput(value);
+			if (parsed.kind !== "valid") throw new TypeError("Invalid index.");
+			return parsed.token;
+		},
+		validateCandidate(value) {
+			return Number.isFinite(Number(value)) ? [] : [{ message: "Invalid index." }];
+		}
+	}]
+}];
+/** Per-instance, idempotent registration. Legacy hosts never acquire the fixed capability. */
+function fixedInputRegistration(scratch) {
+	const host = scratch;
+	let active;
+	let removers = [];
+	let disposed = false;
+	const dispose = () => {
+		host.vm?.runtime?.off?.("RUNTIME_DISPOSED", shutdown);
+		for (const remove of removers.splice(0).reverse()) remove();
+		active = void 0;
+	};
+	const shutdown = () => {
+		disposed = true;
+		dispose();
+	};
+	return {
+		ensure(opcodes) {
+			const api = host.gui?.blockEditors;
+			if (disposed || api === active) return;
+			dispose();
+			if (api?.apiVersion !== 1 || typeof api.registerFixedInputEditor !== "function") return;
+			try {
+				for (const definition of fixedInputEditors) if (definition.opcodes.every((opcode) => opcodes.includes(opcode))) {
+					const remove = api.registerFixedInputEditor.call(api, definition);
+					if (typeof remove !== "function") throw new TypeError("Invalid fixed registration cleanup.");
+					removers.push(remove);
+				}
+				active = api;
+				host.vm?.runtime?.on?.("RUNTIME_DISPOSED", shutdown);
+			} catch (error) {
+				dispose();
+				throw error;
+			}
+		},
+		dispose: shutdown
+	};
+}
+//#endregion
+//#region node_modules/.pnpm/@kubohiroya+turbowarp-named-data@0.3.1/node_modules/@kubohiroya/turbowarp-named-data/dist/composition.js
 var NAMED_DATA_REGISTRY_SYMBOL_KEY = "@kubohiroya/turbowarp-named-data/registry";
 var NAMED_DATA_REGISTRY_SYMBOL = Symbol.for(NAMED_DATA_REGISTRY_SYMBOL_KEY);
 var NAMED_DATA_NAMESPACE_PATTERN = /^[a-z][a-z0-9.-]{0,63}$/u;
@@ -299,6 +696,8 @@ var NAMED_DATA_REPRESENTATIONS = [
 	"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",
@@ -307,6 +706,9 @@ var NAMED_DATA_ERROR_CODES = [
 	"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",
@@ -527,9 +929,21 @@ function validateReferenceShape(reference, representation) {
 	if (!reference || typeof reference !== "object") throw invalidReference$1();
 	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$1();
+	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";
@@ -566,7 +980,10 @@ function configuredFlag$1(name) {
 	const value = globalThis.__TW_NAMED_DATA_FEATURE_FLAGS__?.[name];
 	return value === true || value === "true";
 }
-Object.freeze({ NAMED_DATA_REGISTRY_MVP: configuredFlag$1("NAMED_DATA_REGISTRY_MVP") });
+Object.freeze({
+	NAMED_DATA_REGISTRY_MVP: configuredFlag$1("NAMED_DATA_REGISTRY_MVP"),
+	NAMED_DATA_SCHEMA_REF: configuredFlag$1("NAMED_DATA_SCHEMA_REF")
+});
 //#endregion
 //#region src/asset-cache-error.ts
 var AssetManagerError = class extends Error {
@@ -948,88 +1365,6 @@ function throwIfNamedBodyAborted(signal) {
 	if (signal?.aborted) throw namedBodyAbortError();
 }
 //#endregion
-//#region src/text-style.ts
-var TEXT_RUNTIME_NAMESPACE = "text";
-var TEXT_STYLE_RUNTIME_NAMESPACE = "textStyle";
-var TEXT_STYLE_PROPERTIES = [
-	"animation",
-	"font",
-	"color",
-	"width",
-	"align"
-];
-var DEFAULT_STAGE_WIDTH = 480;
-var DEFAULT_FONT = "Handwriting";
-var DEFAULT_COLOR = "#ffffff";
-var DEFAULT_ALIGNMENT = "center";
-var DEFAULT_OUTLINE_COLOR = "#000000";
-function textRuntimeVariableName(name) {
-	return `${TEXT_RUNTIME_NAMESPACE}:${name}`;
-}
-function textStyleRuntimeVariableName(name, property) {
-	return `${TEXT_STYLE_RUNTIME_NAMESPACE}:${name}:${property}`;
-}
-function normalizeTextStyleProperty(value) {
-	const property = String(value ?? "").trim().toLowerCase();
-	if (TEXT_STYLE_PROPERTIES.includes(property)) return property;
-	throw new Error(`Unknown text style property: ${property || "(empty)"}`);
-}
-/**
-* Normalize a DSL-facing style value for runtime-variable storage.
-* An empty value intentionally resets the property to its default.
-*/
-function normalizeTextStyleValue(property, value) {
-	const raw = String(value ?? "").trim();
-	if (!raw) return "";
-	switch (property) {
-		case "animation": {
-			const animation = raw.toLowerCase() === "typing" ? "type" : raw.toLowerCase();
-			if (animation === "none" || animation === "type" || animation === "rainbow" || animation === "zoom" || animation === "shake") return animation;
-			throw new Error(`Invalid text animation: ${raw}`);
-		}
-		case "font": return raw;
-		case "color": {
-			if (/^#[0-9a-f]{6}$/i.test(raw)) return raw.toLowerCase();
-			const shortColor = /^#([0-9a-f])([0-9a-f])([0-9a-f])$/i.exec(raw);
-			if (shortColor) return `#${shortColor[1]}${shortColor[1]}${shortColor[2]}${shortColor[2]}${shortColor[3]}${shortColor[3]}`.toLowerCase();
-			throw new Error(`Invalid text color: ${raw}`);
-		}
-		case "width": {
-			const width = Number(raw);
-			if (!Number.isFinite(width) || width <= 0) throw new Error(`Text width must be a positive number: ${raw}`);
-			return String(width);
-		}
-		case "align": {
-			const align = raw.toLowerCase();
-			if (align === "left" || align === "center" || align === "right") return align;
-			throw new Error(`Invalid text alignment: ${raw}`);
-		}
-	}
-}
-function resolveTextStyle(name, stageWidth, getRuntimeVariable) {
-	const width = Number(stageWidth);
-	const defaults = {
-		animation: "none",
-		font: DEFAULT_FONT,
-		color: DEFAULT_COLOR,
-		width: Number.isFinite(width) && width > 0 ? width : DEFAULT_STAGE_WIDTH,
-		align: DEFAULT_ALIGNMENT
-	};
-	const read = (property) => normalizeTextStyleValue(property, getRuntimeVariable(textStyleRuntimeVariableName(name, property)));
-	const animation = read("animation");
-	const font = read("font");
-	const color = read("color");
-	const configuredWidth = read("width");
-	const align = read("align");
-	return {
-		animation: animation ? animation : defaults.animation,
-		font: font || defaults.font,
-		color: color || defaults.color,
-		width: configuredWidth ? Number(configuredWidth) : defaults.width,
-		align: align ? align : defaults.align
-	};
-}
-//#endregion
 //#region src/extension.ts
 var EXTENSION_ID = "kubohiroyaassetcache";
 var EXTENSION_VERSION = "0.14.0";
@@ -1534,6 +1869,7 @@ var AssetManagerExtension = class {
 		this.unbindNamedDataRegistryLifecycle?.();
 		this.unbindNamedDataRegistryLifecycle = void 0;
 	};
+	fixedEditors = fixedInputRegistration(Scratch);
 	constructor(featureFlags = FEATURE_FLAGS) {
 		this.featureFlags = Object.freeze({ ...featureFlags });
 		if (this.featureFlags.NAMED_ASSET_BODY_PROVIDER) {
@@ -1600,6 +1936,8 @@ var AssetManagerExtension = class {
 		return loadingCostumes[((Number.isFinite(numericIndex) ? Math.max(1, Math.trunc(numericIndex)) : 1) - 1) % loadingCostumes.length];
 	}
 	getInfo() {
+		const blocks = blockDefinitions.map((block) => this.toScratchBlock(block));
+		this.fixedEditors.ensure(blocks.map((block) => `${EXTENSION_ID}_${block.opcode}`));
 		return {
 			id: EXTENSION_ID,
 			name: Scratch.translate(block_definitions_default.extensionName),
@@ -1608,9 +1946,13 @@ var AssetManagerExtension = class {
 			color1: "#5b7cfa",
 			color2: "#425ed8",
 			color3: "#2f46aa",
-			blocks: blockDefinitions.map((block) => this.toScratchBlock(block))
+			blocks
 		};
 	}
+	/** Release only this optional editor registration; runtime data remains unchanged. */
+	dispose() {
+		this.fixedEditors.dispose();
+	}
 	/**
 	* Exposes the stock extension registry through a host-neutral DOM image
 	* resource contract for other unsandboxed extensions.

package/dist/types/extension.d.ts

@@ -121,6 +121,7 @@ export declare class AssetManagerExtension {
     private readonly releaseDOMImageResourcesForRuntimeDispose;
     private readonly releaseNamedBodySnapshotsForLifecycle;
     private readonly unregisterNamedBodyProviderForRuntimeDispose;
+    private readonly fixedEditors;
     constructor(featureFlags?: AssetManagerFeatureFlags);
     setLoadingBackdrop(args: BlockArgs): void;
     setLoadingCostumes(args: BlockArgs): void;
@@ -138,6 +139,8 @@ export declare class AssetManagerExtension {
         color3: string;
         blocks: Record<string, unknown>[];
     };
+    /** Release only this optional editor registration; runtime data remains unchanged. */
+    dispose(): void;
     /**
      * Exposes the stock extension registry through a host-neutral DOM image
      * resource contract for other unsandboxed extensions.

package/dist/types/fixed-input-editors.d.ts

@@ -0,0 +1,10 @@
+import type { FixedInputBinding, FixedInputEditorOptions } from '@kubohiroya/turbowarp-extension-data-editor';
+import { type TextStyleProperty } from './text-style.js';
+/** New edits preserve the candidate token; existing aliases are display projections only. */
+export declare function styleBinding(property: TextStyleProperty): FixedInputBinding;
+export declare const fixedInputEditors: readonly FixedInputEditorOptions[];
+/** Per-instance, idempotent registration. Legacy hosts never acquire the fixed capability. */
+export declare function fixedInputRegistration(scratch: unknown): {
+    ensure(opcodes: readonly string[]): void;
+    dispose: () => void;
+};

package/dist/types/fixed-input-schema.d.ts

@@ -0,0 +1,46 @@
+import type { SchemaBundle, SchemaDocument } from '@kubohiroya/turbowarp-extension-data-editor/schema';
+/** Canonical owner schema fragments; no network resources or runtime providers. */
+export declare function fixedInputBundle(fragment: string, schema: SchemaDocument): SchemaBundle;
+export declare const fixedSchemas: {
+    setTextStyle: {
+        type: string;
+        properties: {
+            PROPERTY: {
+                type: string;
+                enum: string[];
+            };
+            VALUE: {
+                type: string;
+            };
+        };
+        additionalProperties: boolean;
+    };
+    animation: {
+        type: string;
+        enum: string[];
+    };
+    font: {
+        type: string;
+    };
+    color: {
+        type: string;
+        pattern: string;
+    };
+    width: {
+        type: string;
+        $comment: string;
+    };
+    align: {
+        type: string;
+        enum: string[];
+    };
+    loadingCostumeAt: {
+        type: string;
+        properties: {
+            INDEX: {
+                type: string;
+            };
+        };
+        additionalProperties: boolean;
+    };
+};

package/docs/fixed-input-editors.ja.md

@@ -0,0 +1,20 @@
+# 固定入力エディターの契約
+
+対応GUIの起動時に`blockEditorDialogs=1&blockEditorFixedInputs=1`を指定し、再読込した場合だけ登録する。既定OFFで、旧GUIやCLIに固定登録APIがなければ何もしない。公開するブロック・引数・既定値・`docsURI`・既存データ形式は変更しない。
+
+| ブロック | 対象 | UIと保存 |
+|---|---|---|
+| `setTextStyle` | `PROPERTY` / `VALUE` | PROPERTYの固定5選択とVALUEの有限分岐。animation/alignは選択、fontは自由入力、colorは色、widthは数値文字列。VALUEは常にSTRINGで空文字reset可能 |
+| `loadingCostumeAt` | `INDEX` | 数値UI。新入力は有限の数値表記。小数・負数を許容し、既存runtimeの切捨て・下限補正・循環を維持。非表示の互換ブロック |
+
+Schemaの正本は`schemas/block-editor-fixed-inputs.schema.json`。`getInfo()`と`src/text-style.ts`の`normalizeTextStyleProperty` / `normalizeTextStyleValue`、`src/extension.ts`の`loadingCostumeAt`がruntime契約の正本であり、棚卸しやUI候補だけを受け入れ根拠にしない。新Schemaは登録用の各fragmentに投影し、ネットワークSchema参照を行わない。NP-finite-new-input-v1の対象はINDEXであり、STRINGであるVALUE.widthへ一律適用しない。widthのSchemaはSTRING構造を確認し、CPの正の有限値/resetをpure normalizerで意味検証する。STRINGの数値UIとprogrammatic候補はともに`0x10`・`+20`等を既存runtimeと同じく受け入れる。JSON数値文法のbuffer検査はINDEX等のnumber型投影に限定し、widthと区別する。
+
+既存alias（`typing`、短縮色、大小文字、旧数値表記）は表示投影だけでは書き換えない。PROPERTYの修復・変更時は最終branchで必要なVALUEを検査し、不適合なら修正/resetまで全patchを拒否する。selectorがreporter・欠落・非対応ならVALUEは読取専用。reporterを評価・置換しない。未知literal selectorは既知値へ修復可能で、未変更なら未知rawも保持する。NAMEや素材registry、font候補providerには触れない。
+
+同じ画面で分岐を切り替えてもdraftを保持し、保存失敗後も保持する。取消・dispose・project/target/登録の失効では共通sessionが破棄する。再openは現在のrawから開始し、旧draftを復活させない。登録はgetInfoに存在するopcodeだけを対象とし、同じinstance/APIへの重複登録を行わず、API置換・部分失敗・runtime終了・disposeでcleanupする。
+
+共通依存はGit commit `485f0e550e622235624b5e9176820161aeeba252`に固定する。開発用の型とpure数値parserを使い、登録はhostの`registerFixedInputEditor`へoptionsを渡す。既存composition APIにGUI/React実行依存を追加しない。runtime同梱JSと公開入口の型が外部common参照を要求しないことをbuildとpack consumerで確認する。
+
+`tests/fixed-input-editors.test.ts`でCP-asset-cacheのBC01〜05/14全6fixture、全5branchのruntime比較、空文字reset、有限数値と精度表記、旧raw保持、登録とcleanupを検証する。Asset Managerは別ownerであり、この結果を流用して合格とはしない。文書入口は`docs/index.html`と`docs/ja/index.html`の各固定アンカーから到達でき、Markdown再生成ではこれらの静的HTML説明を削除しない。
+
+切戻しは固定フラグをOFFにして再読込する。依存を戻す場合はmanifest・lock・実解決を一組で戻す。既存raw値やsb3の移行は不要。今回の作業はローカルのみで、commit・push・PR・merge・Pages公開・npm公開・Issue操作は含まない。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubohiroya/turbowarp-asset-cache",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "A browser-local image, audio, and runtime-text asset cache for TurboWarp projects.",
   "author": "Hiroya Kubo <hiroya@cuc.ac.jp>",
   "type": "module",
@@ -22,6 +22,8 @@
   },
   "files": [
     "dist/",
+    "schemas/",
+    "docs/fixed-input-editors.ja.md",
     "README.md",
     "LICENSE"
   ],
@@ -60,9 +62,10 @@
   },
   "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.4.0",
+    "@kubohiroya/turbowarp-extension-data-editor": "0.2.1",
+    "@kubohiroya/turbowarp-extension-manifest": "0.3.2",
+    "@kubohiroya/turbowarp-named-data": "0.3.1",
+    "@kubohiroya/vite-plugin-turbowarp-extension": "0.6.1",
     "@types/node": "^22.20.1",
     "@xmldom/xmldom": "0.9.11",
     "eslint": "^9.39.5",
@@ -73,7 +76,7 @@
     "vitest": "^4.1.10"
   },
   "peerDependencies": {
-    "@kubohiroya/turbowarp-named-data": "^0.1.0"
+    "@kubohiroya/turbowarp-named-data": "0.3.1"
   },
   "keywords": [
     "turbowarp",
@@ -81,5 +84,11 @@
     "extension",
     "assets",
     "indexeddb"
-  ]
+  ],
+  "gitHead": "9a1a4a1a016722eccf649207f8517c8533bf68b0",
+  "x-turbowarp-source": {
+    "revision": "9a1a4a1a016722eccf649207f8517c8533bf68b0",
+    "revisionRole": "base-commit",
+    "sourceState": "local-release-overlay"
+  }
 }

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

@@ -0,0 +1,24 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://kubohiroya.github.io/turbowarp-asset-cache/schemas/block-editor-fixed-inputs.schema.json",
+  "$defs": {
+    "setTextStyle": {
+      "type": "object",
+      "properties": {
+        "PROPERTY": {"type": "string", "enum": ["animation", "font", "color", "width", "align"]},
+        "VALUE": {"type": "string"}
+      },
+      "additionalProperties": false
+    },
+    "animation": {"type": "string", "enum": ["", "none", "type", "rainbow", "zoom", "shake"]},
+    "font": {"type": "string"},
+    "color": {"type": "string", "pattern": "^(?:|#[0-9a-fA-F]{3}|#[0-9a-fA-F]{6})$"},
+    "width": {"type": "string", "$comment": "Empty/trimmed empty resets; otherwise normalizeTextStyleValue requires Number(value) finite and positive. Preserve the existing STRING grammar, including hexadecimal and leading plus."},
+    "align": {"type": "string", "enum": ["", "left", "center", "right"]},
+    "loadingCostumeAt": {
+      "type": "object",
+      "properties": {"INDEX": {"type": "number"}},
+      "additionalProperties": false
+    }
+  }
+}