@kubohiroya/turbowarp-structured-data 0.6.0 → 0.6.2

package/lib-editor/src/fixed-input-editors.d.ts

@@ -0,0 +1,9 @@
+import type { FixedInputEditorOptions } from '@kubohiroya/turbowarp-extension-data-editor';
+export declare const fixedInputEditorDefinitions: readonly FixedInputEditorOptions[];
+interface RuntimeLifetime {
+    on?: (event: string, listener: () => void) => void;
+    off?: (event: string, listener: () => void) => void;
+}
+/** Register metadata only; the GUI startup capability owns editor activation. */
+export declare function registerFixedInputEditors(scratch: unknown, definitions: readonly FixedInputEditorOptions[], runtimeOverride?: RuntimeLifetime): () => void;
+export {};

package/lib-editor/src/fixed-input-schema.d.ts

@@ -0,0 +1,3 @@
+import type { SchemaBundle } from '@kubohiroya/turbowarp-extension-data-editor/schema';
+/** The on-disk owner Schema is canonical; this is its single-field projection. */
+export declare const fixedInputSchemaBundle: SchemaBundle;

package/lib-editor/src/source-editor.d.ts

@@ -0,0 +1,8 @@
+import type { SchemaBundle, SchemaDocument, SourceBinding, SourceEditorOptions } from '@kubohiroya/turbowarp-extension-data-editor/schema';
+export declare function canonicalBundle(ownerId: string, contractId: string, document: SchemaDocument, ownerSource: {
+    path: string;
+    symbol: string;
+}): SchemaBundle;
+export declare function sourceBinding(argument: string, bundle: SchemaBundle, read: (source: string) => unknown, check?: (source: string) => unknown, format?: 'json' | 'yaml', uiSchema?: SourceBinding['variants'][number]['uiSchema']): SourceBinding;
+/** The optional capability keeps legacy hosts and the startup flag safely inactive. */
+export declare function registerSourceEditors(scratch: unknown, definitions: readonly SourceEditorOptions[]): () => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubohiroya/turbowarp-structured-data",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "description": "Named structured data with JSON/YAML codecs and deterministic path operations for TurboWarp.",
   "author": "Hiroya Kubo <hiroya@cuc.ac.jp>",
   "license": "MPL-2.0",
@@ -27,11 +27,13 @@
     "dist/",
     "docs/",
     "src/",
+    "schemas/",
     "templates/",
     "README.md",
     "README.ja.md",
     "THIRD_PARTY_NOTICES.md",
-    "LICENSE"
+    "LICENSE",
+    "lib-editor/"
   ],
   "publishConfig": {
     "access": "public",
@@ -44,22 +46,23 @@
   "scripts": {
     "dev": "vite build --watch",
     "typecheck": "tsc --noEmit",
-    "build": "vite build",
-    "lint": "eslint src tests scripts vite.config.ts eslint.config.ts",
+    "build": "vite build && pnpm run build:editor",
+    "lint": "eslint src tests scripts vite.config.ts vite.editor.config.ts eslint.config.ts",
     "test": "vitest run",
-    "docs": "node scripts/generate-readme.ts",
-    "docs:check": "node scripts/generate-readme.ts --check",
+    "docs": "node scripts/generate-readme.ts && node scripts/generate-fixed-input-docs.mjs",
+    "docs:check": "node scripts/generate-readme.ts --check && node scripts/generate-fixed-input-docs.mjs --check",
     "template:readme": "node scripts/apply-readme-template.ts",
     "repo:check": "node scripts/check-repo.ts",
     "pack:check": "npm pack --dry-run --ignore-scripts",
     "check": "pnpm run typecheck && pnpm run lint && pnpm run test && pnpm run docs:check && pnpm run check:dist && pnpm run repo:check && pnpm run pack:check",
-    "check:dist": "pnpm run build && node scripts/check-dist.ts"
+    "check:dist": "pnpm run build && node scripts/check-dist.ts",
+    "build:editor": "tsc -p tsconfig.editor.json && vite build --config vite.editor.config.ts"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.5",
-    "@kubohiroya/turbowarp-extension-manifest": "0.3.0",
-    "@kubohiroya/turbowarp-named-data": "0.1.0",
-    "@kubohiroya/vite-plugin-turbowarp-extension": "0.3.0",
+    "@kubohiroya/turbowarp-extension-manifest": "0.3.2",
+    "@kubohiroya/turbowarp-named-data": "0.3.1",
+    "@kubohiroya/vite-plugin-turbowarp-extension": "0.6.1",
     "@types/node": "^24.13.3",
     "eslint": "^9.39.5",
     "jiti": "^2.7.0",
@@ -67,13 +70,26 @@
     "typescript-eslint": "^8.66.0",
     "vite": "^8.2.2",
     "vitest": "^5.0.0",
-    "react-dom": "18.3.1"
+    "react-dom": "18.3.1",
+    "@kubohiroya/turbowarp-extension-data-editor": "0.2.1"
   },
   "dependencies": {
-    "yaml": "^2.9.1",
-    "@kubohiroya/turbowarp-extension-data-editor": "git+https://github.com/kubohiroya/turbowarp-extension-data-editor.git#76fa1d50a3c188082ceef723ea018a9d8769ea6e"
+    "yaml": "^2.9.1"
   },
   "peerDependencies": {
-    "@kubohiroya/turbowarp-named-data": ">=0.1.0 <1"
+    "@kubohiroya/turbowarp-named-data": "0.3.1"
+  },
+  "gitHead": "385a31c2a7957b51003686fab0b2d76199db705a",
+  "x-turbowarp-source": {
+    "revision": "385a31c2a7957b51003686fab0b2d76199db705a",
+    "revisionRole": "base-commit",
+    "sourceState": "local-release-overlay"
+  },
+  "exports": {
+    "./*": "./*",
+    "./editor-metadata": {
+      "types": "./lib-editor/src/editor-metadata.d.ts",
+      "import": "./lib-editor/src/editor-metadata.js"
+    }
   }
 }

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

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

package/src/editor-metadata.ts

@@ -0,0 +1,5 @@
+/** Lightweight declarations and owner callbacks; the optional GUI owns Schema compilation. */
+export {sourceEditorDefinitions} from './editor-schema.js';
+export {canonicalBundle, registerSourceEditors, sourceBinding} from './source-editor.js';
+export {fixedInputEditorDefinitions, registerFixedInputEditors} from './fixed-input-editors.js';
+export {fixedInputSchemaBundle} from './fixed-input-schema.js';

package/src/extension.ts

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

package/src/fixed-input-editors.ts

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

package/src/fixed-input-schema.ts

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

package/src/source-editor.ts

@@ -1,4 +1,3 @@
-import {compileSchemaBundle, validateSchemaInput} from '@kubohiroya/turbowarp-extension-data-editor/schema';
 import type {SchemaBundle, SchemaDocument, SchemaJsonValue, SourceBinding, SourceEditorOptions} from '@kubohiroya/turbowarp-extension-data-editor/schema';
 
 export function canonicalBundle(ownerId: string, contractId: string, document: SchemaDocument, ownerSource: {path: string; symbol: string}): SchemaBundle {
@@ -16,21 +15,25 @@ export function canonicalBundle(ownerId: string, contractId: string, document: S
 export function sourceBinding(argument: string, bundle: SchemaBundle,
   read: (source: string) => unknown, check: (source: string) => unknown = read,
   format: 'json' | 'yaml' = 'json', uiSchema?: SourceBinding['variants'][number]['uiSchema']): SourceBinding {
-  const compiled = compileSchemaBundle(bundle);
   return {
     argument,
     variants: [{variantId: 'default', format, schemaBundle: bundle, ...(uiSchema ? {uiSchema} : {})}],
     decode(source) {return {source, format, variantId: 'default', data: read(source) as SchemaJsonValue};},
     validateSource(source, context) {
-      if (compiled.kind !== 'compiled') return {source, result: {kind: 'schema-error', diagnostics: [{code: 'source-schema-invalid'}]}};
+      try {read(source);}
+      catch {return {source, result: {kind: 'invalid', diagnostics: [{code: 'source-decode-invalid'}]}};}
       try {
-        const data = read(source) as SchemaJsonValue;
-        return {source, result: validateSchemaInput(compiled.validator, data, {context,
-          ownerValidate: () => {
-            try {check(source); return {kind: 'valid', issues: []};}
-            catch {return {kind: 'invalid', issues: [{dataPath: '', ruleId: 'source-owner-invalid'}]};}
-          }})};
-      } catch {return {source, result: {kind: 'invalid', diagnostics: [{code: 'source-decode-invalid'}]}};}
+        const descriptors = Object.getOwnPropertyDescriptors(context);
+        if (typeof descriptors.consumerId?.value !== 'string' ||
+            typeof descriptors.nowMs?.value !== 'number' || !Number.isFinite(descriptors.nowMs.value) ||
+            !descriptors.settings || !('value' in descriptors.settings)) {
+          return {source, result: {kind: 'execution-error', diagnostics: [{code: 'owner-context-invalid'}]}};
+        }
+      } catch {return {source, result: {kind: 'execution-error', diagnostics: [{code: 'owner-context-invalid'}]}};}
+      // The GUI checks Schema constraints; the owner checks the exact source without compiling.
+      try {check(source);}
+      catch {return {source, result: {kind: 'invalid', diagnostics: [{code: 'source-owner-invalid'}]}};}
+      return {source, result: {kind: 'valid', diagnostics: []}};
     }
   };
 }

package/templates/README.ja.md

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

package/templates/README.md

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