@world-engines/blocks-editor 0.1.0

package/dist/blocks/registry.js

@@ -0,0 +1,1000 @@
+import * as Blockly from "blockly";
+import { registerFieldMultilineInput } from "@blockly/field-multilineinput";
+import { DEFAULT_WORLD_TIME_BOUNDS, TIME_FIELDS } from "./time-fields.js";
+import { attrOptionsForEntity, entityOptions, eventOptions, PLACEHOLDER_ATTR_OPTION, readCtxFromWorkspace } from "./ctx.js";
+import { BLOCK_STYLE_KEYS } from "../themes/liquid-glass-dark.js";
+import { FIELD_ATTR_PICKER, FIELD_ENTITY_PICKER, registerPickerFieldsOnce } from "../fields/register.js";
+// 保留旧 8 block 类型 兼容旧 IDB 数据
+export const BLOCK_TYPES = {
+    triggerRoot: "trigger_def_root",
+    // 触发器定义树沿用 statement 连接；Scratch 运算区的 op_and/op_or/op_not
+    // 是 Boolean value 连接。两者不得复用类型名，否则后注册的 reporter 定义
+    // 会覆盖触发器定义，导致旧触发器工作区反序列化时连接类型崩溃。
+    opAnd: "trigger_def_and",
+    opOr: "trigger_def_or",
+    opNot: "trigger_def_not",
+    leafTime: "trigger_def_time",
+    leafEvent: "trigger_def_event",
+    leafNl: "trigger_def_nl",
+    leafAttrRef: "trigger_def_attr_ref",
+    leafRelationRef: "trigger_def_relation_ref",
+    leafDaySegment: "trigger_def_day_segment"
+};
+export const FIELD_NAMES = {
+    closeMode: "close_mode",
+    eventId: "event_id",
+    delayMs: "delay_ms",
+    delaySeconds: "delay_seconds",
+    text: "text",
+    milestone: "milestone",
+    entityId: "entity_id",
+    attrKey: "attr_key",
+    srcId: "src_id",
+    dstId: "dst_id",
+    kind: "kind",
+    segment: "segment",
+    expectedValue: "expected_value"
+};
+export const INPUT_NAMES = {
+    tree: "tree",
+    closeWhen: "close_when",
+    children: "children",
+    child: "child"
+};
+export const CLOSE_MODE_OPTIONS = [
+    ["永久关闭", "permanent"],
+    ["临时关闭", "temporary"]
+];
+const FIELD_MULTILINE_TEXT = "field_multilinetext";
+const MUTATOR_OP_CHILDREN = "op_children_mutator";
+const EXT_LEAF_EVENT_DROPDOWN = "leaf_event_dropdown_ext";
+const EXT_LEAF_ATTR_REF_DROPDOWN = "leaf_attr_ref_dropdown_ext";
+const EXT_LEAF_TIME_INIT = "leaf_time_init_ext";
+const DEFAULT_CHILD_COUNT = 2;
+const MIN_CHILD_COUNT = 2;
+const MAX_CHILD_COUNT = 16;
+const LEAF_NL_DEFAULT_MAX_LINES = 4;
+const TIME_FIELD_LABELS = {
+    year: "年",
+    month: "月",
+    day: "日",
+    hour: "时",
+    minute: "分",
+    second: "秒"
+};
+const opChildrenMutator = {
+    child_count_: DEFAULT_CHILD_COUNT,
+    saveExtraState() {
+        return { child_count: this.child_count_ };
+    },
+    loadExtraState(state) {
+        const next = Math.max(MIN_CHILD_COUNT, Math.min(MAX_CHILD_COUNT, Math.floor(state.child_count)));
+        this.child_count_ = next;
+        this.updateShape_();
+    },
+    updateShape_() {
+        let i = 0;
+        while (this.getInput(`${INPUT_NAMES.children}_${i}`)) {
+            this.removeInput(`${INPUT_NAMES.children}_${i}`);
+            i++;
+        }
+        for (let idx = 0; idx < this.child_count_; idx++) {
+            this.appendStatementInput(`${INPUT_NAMES.children}_${idx}`).setCheck(null);
+        }
+    }
+};
+const dropdownGeneratorForEvent = function () {
+    const ctx = readCtxFromWorkspace(this.getSourceBlock()?.workspace ?? null);
+    return eventOptions(ctx).map((o) => [o[0], o[1]]);
+};
+const dropdownGeneratorForEntity = function () {
+    const ctx = readCtxFromWorkspace(this.getSourceBlock()?.workspace ?? null);
+    return entityOptions(ctx).map((o) => [o[0], o[1]]);
+};
+const attrDropdownGenerator = function () {
+    const source = this.getSourceBlock();
+    const ctx = readCtxFromWorkspace(source?.workspace ?? null);
+    if (source && typeof source === "object" && "getFieldValue" in source) {
+        const entityId = source.getFieldValue(FIELD_NAMES.entityId);
+        if (typeof entityId === "string") {
+            return attrOptionsForEntity(ctx, entityId).map((o) => [o[0], o[1]]);
+        }
+    }
+    return [[PLACEHOLDER_ATTR_OPTION[0], PLACEHOLDER_ATTR_OPTION[1]]];
+};
+function leafEventInit() {
+    this.appendDummyInput()
+        .appendField("事件")
+        .appendField(new Blockly.FieldDropdown(dropdownGeneratorForEvent), FIELD_NAMES.eventId);
+    this.appendDummyInput()
+        .appendField("延迟（剧情秒）")
+        .appendField(new Blockly.FieldNumber(0, 0), FIELD_NAMES.delaySeconds);
+    this.setPreviousStatement(true);
+    this.setNextStatement(true);
+    this.setStyle(BLOCK_STYLE_KEYS.dataEvent);
+}
+function leafTimeInit() {
+    const ctx = readCtxFromWorkspace(this.workspace);
+    const bounds = ctx.worldTime ?? DEFAULT_WORLD_TIME_BOUNDS;
+    const input = this.appendDummyInput();
+    input.appendField("世界时间到达");
+    for (const spec of TIME_FIELDS) {
+        const lo = spec.lo(bounds);
+        const hi = spec.hi(bounds);
+        input.appendField(TIME_FIELD_LABELS[spec.key] ?? spec.key);
+        input.appendField(new Blockly.FieldNumber(lo, lo, hi), spec.key);
+    }
+    this.setInputsInline(true);
+    this.setPreviousStatement(true);
+    this.setNextStatement(true);
+    this.setStyle(BLOCK_STYLE_KEYS.time);
+}
+function leafAttrRefInit() {
+    this.appendDummyInput()
+        .appendField("实体")
+        .appendField(new Blockly.FieldDropdown(dropdownGeneratorForEntity), FIELD_NAMES.entityId);
+    this.appendDummyInput()
+        .appendField("属性")
+        .appendField(new Blockly.FieldDropdown(attrDropdownGenerator), FIELD_NAMES.attrKey);
+    this.appendDummyInput()
+        .appendField("期望值")
+        .appendField(new Blockly.FieldTextInput(""), FIELD_NAMES.expectedValue);
+    this.appendDummyInput()
+        .appendField("延迟（剧情秒）")
+        .appendField(new Blockly.FieldNumber(0, 0), FIELD_NAMES.delaySeconds);
+    this.setPreviousStatement(true);
+    this.setNextStatement(true);
+    this.setStyle(BLOCK_STYLE_KEYS.dataAttr);
+}
+let extensionsRegistered = false;
+function registerExtensionsOnce() {
+    if (extensionsRegistered)
+        return;
+    if (!Blockly.Extensions.isRegistered(MUTATOR_OP_CHILDREN)) {
+        Blockly.Extensions.registerMutator(MUTATOR_OP_CHILDREN, opChildrenMutator);
+    }
+    if (!Blockly.Extensions.isRegistered(EXT_LEAF_EVENT_DROPDOWN)) {
+        Blockly.Extensions.register(EXT_LEAF_EVENT_DROPDOWN, leafEventInit);
+    }
+    if (!Blockly.Extensions.isRegistered(EXT_LEAF_ATTR_REF_DROPDOWN)) {
+        Blockly.Extensions.register(EXT_LEAF_ATTR_REF_DROPDOWN, leafAttrRefInit);
+    }
+    if (!Blockly.Extensions.isRegistered(EXT_LEAF_TIME_INIT)) {
+        Blockly.Extensions.register(EXT_LEAF_TIME_INIT, leafTimeInit);
+    }
+    extensionsRegistered = true;
+}
+let multilineFieldRegistered = false;
+function registerMultilineFieldOnce() {
+    if (multilineFieldRegistered)
+        return;
+    registerFieldMultilineInput();
+    multilineFieldRegistered = true;
+}
+// 旧 8 block 定义 (兼容 IDB v1 数据 toolbox 不再展示 trigger_root 但保留其余用于运行时兼容)
+function buildTriggerDefinitionBlockDefs() {
+    return [
+        {
+            type: BLOCK_TYPES.triggerRoot,
+            message0: "触发器条件",
+            message1: "满足条件 %1",
+            args1: [
+                { type: "input_statement", name: INPUT_NAMES.tree }
+            ],
+            message2: "关闭条件 %1",
+            args2: [
+                { type: "input_statement", name: INPUT_NAMES.closeWhen }
+            ],
+            message3: "关闭方式 %1",
+            args3: [
+                {
+                    type: "field_dropdown",
+                    name: FIELD_NAMES.closeMode,
+                    options: CLOSE_MODE_OPTIONS.map((p) => [p[0], p[1]])
+                }
+            ],
+            style: BLOCK_STYLE_KEYS.container,
+            tooltip: "由玩家触发引擎直接求值的条件定义",
+            helpUrl: ""
+        },
+        {
+            type: BLOCK_TYPES.opAnd,
+            message0: "并且（全部满足）",
+            style: BLOCK_STYLE_KEYS.boolean,
+            previousStatement: null,
+            nextStatement: null,
+            mutator: MUTATOR_OP_CHILDREN,
+            tooltip: "所有子条件都满足",
+            helpUrl: ""
+        },
+        {
+            type: BLOCK_TYPES.opOr,
+            message0: "或者（任一满足）",
+            style: BLOCK_STYLE_KEYS.boolean,
+            previousStatement: null,
+            nextStatement: null,
+            mutator: MUTATOR_OP_CHILDREN,
+            tooltip: "任意一个子条件满足",
+            helpUrl: ""
+        },
+        {
+            type: BLOCK_TYPES.opNot,
+            message0: "不满足 %1",
+            args0: [
+                { type: "input_statement", name: INPUT_NAMES.child }
+            ],
+            style: BLOCK_STYLE_KEYS.boolean,
+            previousStatement: null,
+            nextStatement: null,
+            tooltip: "对子条件取反",
+            helpUrl: ""
+        },
+        {
+            type: BLOCK_TYPES.leafTime,
+            extensions: [EXT_LEAF_TIME_INIT],
+            tooltip: "世界时间到达指定时刻",
+            helpUrl: ""
+        },
+        {
+            type: BLOCK_TYPES.leafEvent,
+            extensions: [EXT_LEAF_EVENT_DROPDOWN],
+            tooltip: "事件发生后可延迟若干剧情秒",
+            helpUrl: ""
+        },
+        {
+            type: BLOCK_TYPES.leafNl,
+            message0: "达到条件 %1 里程碑 %2",
+            args0: [
+                {
+                    type: FIELD_MULTILINE_TEXT,
+                    name: FIELD_NAMES.text,
+                    text: "",
+                    spellcheck: false,
+                    maxLines: LEAF_NL_DEFAULT_MAX_LINES
+                },
+                {
+                    type: "field_checkbox",
+                    name: FIELD_NAMES.milestone,
+                    checked: false
+                }
+            ],
+            message1: "延迟（剧情秒） %1",
+            args1: [
+                {
+                    type: "field_number",
+                    name: FIELD_NAMES.delaySeconds,
+                    value: 0,
+                    min: 0
+                }
+            ],
+            style: BLOCK_STYLE_KEYS.dataEvent,
+            previousStatement: null,
+            nextStatement: null,
+            tooltip: "用自然语言描述需要达到的剧情条件",
+            helpUrl: ""
+        },
+        {
+            type: BLOCK_TYPES.leafAttrRef,
+            extensions: [EXT_LEAF_ATTR_REF_DROPDOWN],
+            tooltip: "legacy: entity attribute reference",
+            helpUrl: ""
+        },
+        {
+            type: BLOCK_TYPES.leafRelationRef,
+            message0: "关系 %1 → %2 类型 %3 属性 %4 期望值 %5 延迟（剧情秒） %6",
+            args0: [
+                { type: "field_input", name: FIELD_NAMES.srcId, text: "" },
+                { type: "field_input", name: FIELD_NAMES.dstId, text: "" },
+                { type: "field_input", name: FIELD_NAMES.kind, text: "" },
+                { type: "field_input", name: FIELD_NAMES.attrKey, text: "" },
+                { type: "field_input", name: FIELD_NAMES.expectedValue, text: "" },
+                { type: "field_number", name: FIELD_NAMES.delaySeconds, value: 0, min: 0 }
+            ],
+            style: BLOCK_STYLE_KEYS.dataAttr,
+            previousStatement: null,
+            nextStatement: null,
+            tooltip: "legacy: relation attribute reference",
+            helpUrl: ""
+        },
+        {
+            type: BLOCK_TYPES.leafDaySegment,
+            message0: "当前时段为 %1",
+            args0: [
+                {
+                    type: "field_dropdown",
+                    name: FIELD_NAMES.segment,
+                    options: [
+                        ["清晨", "morning"],
+                        ["上午", "forenoon"],
+                        ["下午", "afternoon"],
+                        ["夜晚", "night"]
+                    ]
+                }
+            ],
+            style: BLOCK_STYLE_KEYS.time,
+            previousStatement: null,
+            nextStatement: null,
+            tooltip: "世界时间处于指定语义时段",
+            helpUrl: ""
+        }
+    ];
+}
+// Scratch 风格 hat block (顶部尖角 无 previousStatement) 新类型进 toolbox 旧类型保留兼容
+function buildHatBlockDefs() {
+    return [
+        {
+            type: "when_scenario_start",
+            message0: "剧本启动时",
+            nextStatement: null,
+            style: BLOCK_STYLE_KEYS.scenarioHat,
+            tooltip: "剧本启动时执行"
+        },
+        {
+            type: "when_value_changed",
+            message0: "当 %1 变化时",
+            args0: [{ type: "input_value", name: "VALUE" }],
+            inputsInline: true,
+            nextStatement: null,
+            style: BLOCK_STYLE_KEYS.scenarioHat,
+            tooltip: "变量值或对象属性值变化时执行"
+        },
+        {
+            type: "when_time_changed",
+            message0: "检测到时间变化",
+            nextStatement: null,
+            style: BLOCK_STYLE_KEYS.scenarioHat,
+            tooltip: "世界时间发生正向或反向变化时执行"
+        },
+        {
+            type: "when_entity_state_changed",
+            message0: "当对象 %1 状态变为 %2 时",
+            args0: [
+                { type: "input_value", name: "OBJECT", check: "Object" },
+                { type: "input_value", name: "STATE", check: "Boolean" }
+            ],
+            inputsInline: true,
+            nextStatement: null,
+            style: BLOCK_STYLE_KEYS.scenarioHat,
+            tooltip: "对象状态切换时执行"
+        },
+        {
+            type: "when_var_changed",
+            message0: "当变量 %1 变化时",
+            args0: [{ type: "field_variable", name: "VAR", variable: "var" }],
+            nextStatement: null,
+            style: BLOCK_STYLE_KEYS.scenarioHat,
+            tooltip: "变量值变化时执行"
+        },
+        {
+            type: "when_time_reached",
+            message0: "当时间到达 %1 时",
+            args0: [{ type: "input_value", name: "TIME", check: "Number" }],
+            inputsInline: true,
+            nextStatement: null,
+            style: BLOCK_STYLE_KEYS.scenarioHat,
+            tooltip: "世界时间到达指定点时执行"
+        },
+        {
+            type: "when_recall_success",
+            message0: "当召回成功时",
+            nextStatement: null,
+            style: BLOCK_STYLE_KEYS.scenarioHat,
+            tooltip: "LLM 检索并召回成功时执行"
+        }
+    ];
+}
+// 控制流 statement block — 7 个
+function buildControlBlockDefs() {
+    return [
+        {
+            type: "if",
+            message0: "如果 %1 那么",
+            args0: [{ type: "input_value", name: "COND", check: "Boolean" }],
+            message1: "%1",
+            args1: [{ type: "input_statement", name: "THEN" }],
+            previousStatement: null,
+            nextStatement: null,
+            style: BLOCK_STYLE_KEYS.control,
+            tooltip: "条件为真时执行分支"
+        },
+        {
+            type: "if_else",
+            message0: "如果 %1 那么",
+            args0: [{ type: "input_value", name: "COND", check: "Boolean" }],
+            message1: "%1",
+            args1: [{ type: "input_statement", name: "THEN" }],
+            message2: "否则 %1",
+            args2: [{ type: "input_statement", name: "ELSE" }],
+            previousStatement: null,
+            nextStatement: null,
+            style: BLOCK_STYLE_KEYS.control,
+            tooltip: "条件为真则执行 THEN 否则 ELSE"
+        },
+        {
+            type: "repeat",
+            message0: "重复 %1 次",
+            args0: [{ type: "input_value", name: "TIMES", check: "Number" }],
+            message1: "%1",
+            args1: [{ type: "input_statement", name: "BODY" }],
+            previousStatement: null,
+            nextStatement: null,
+            style: BLOCK_STYLE_KEYS.control,
+            tooltip: "重复指定次数"
+        },
+        {
+            type: "repeat_until",
+            message0: "重复直到 %1",
+            args0: [{ type: "input_value", name: "UNTIL", check: "Boolean" }],
+            message1: "%1",
+            args1: [{ type: "input_statement", name: "BODY" }],
+            previousStatement: null,
+            nextStatement: null,
+            style: BLOCK_STYLE_KEYS.control,
+            tooltip: "循环直到条件为真"
+        },
+        {
+            type: "wait_seconds",
+            message0: "等待 %1 %2",
+            args0: [
+                { type: "input_value", name: "AMOUNT", check: "Number" },
+                {
+                    type: "field_dropdown",
+                    name: "UNIT",
+                    options: [
+                        ["秒", "second"],
+                        ["分", "minute"],
+                        ["时", "hour"]
+                    ]
+                }
+            ],
+            previousStatement: null,
+            nextStatement: null,
+            inputsInline: true,
+            style: BLOCK_STYLE_KEYS.control,
+            tooltip: "暂停指定时长"
+        },
+        {
+            type: "stop_this_script",
+            message0: "停止此脚本",
+            previousStatement: null,
+            style: BLOCK_STYLE_KEYS.control,
+            tooltip: "结束当前规则 无 next 卡口"
+        }
+    ];
+}
+// 传感 reporter block — 9 个
+function buildSensingBlockDefs() {
+    return [
+        {
+            type: "sense_time_year",
+            message0: "当前年",
+            output: "Number",
+            style: BLOCK_STYLE_KEYS.sensing,
+            tooltip: "当前世界年"
+        },
+        {
+            type: "sense_time_month",
+            message0: "当前月",
+            output: "Number",
+            style: BLOCK_STYLE_KEYS.sensing,
+            tooltip: "当前世界月"
+        },
+        {
+            type: "sense_time_day",
+            message0: "当前日",
+            output: "Number",
+            style: BLOCK_STYLE_KEYS.sensing,
+            tooltip: "当前世界日"
+        },
+        {
+            type: "sense_time_hour",
+            message0: "当前时",
+            output: "Number",
+            style: BLOCK_STYLE_KEYS.sensing,
+            tooltip: "当前世界时"
+        },
+        {
+            type: "sense_time_minute",
+            message0: "当前分",
+            output: "Number",
+            style: BLOCK_STYLE_KEYS.sensing,
+            tooltip: "当前世界分"
+        },
+        {
+            type: "sense_time_second",
+            message0: "当前秒",
+            output: "Number",
+            style: BLOCK_STYLE_KEYS.sensing,
+            tooltip: "当前世界秒"
+        },
+        {
+            type: "sense_object_state",
+            message0: "对象 %1 状态",
+            args0: [{ type: FIELD_ENTITY_PICKER, name: "ENTITY" }],
+            output: "Object",
+            style: BLOCK_STYLE_KEYS.sensing,
+            tooltip: "对象引用 (方形输出 可插入需要对象槽位)"
+        },
+        {
+            type: "sense_object_attr",
+            message0: "对象 %1 的属性 %2",
+            args0: [
+                { type: FIELD_ENTITY_PICKER, name: "ENTITY" },
+                { type: FIELD_ATTR_PICKER, name: "ATTR" }
+            ],
+            output: null,
+            inputsInline: true,
+            style: BLOCK_STYLE_KEYS.sensing,
+            tooltip: "读取对象属性当前值 可插入变化事件的圆角值槽"
+        },
+        {
+            type: "sense_edge_relation",
+            message0: "对象 %1 可见",
+            args0: [{ type: FIELD_ENTITY_PICKER, name: "ENTITY" }],
+            output: "Boolean",
+            style: BLOCK_STYLE_KEYS.sensing,
+            tooltip: "读取对象当前是否可见 可见返回 true 不可见返回 false"
+        },
+        {
+            type: "sense_relation_ref",
+            message0: "关系 %1 → %2 类型 %3",
+            args0: [
+                { type: FIELD_ENTITY_PICKER, name: "SRC_ENTITY" },
+                { type: FIELD_ENTITY_PICKER, name: "DST_ENTITY" },
+                { type: "field_input", name: "RELATION_KIND", text: "" }
+            ],
+            message1: "属性 JSON Pointer %1 期望 JSON %2",
+            args1: [
+                { type: "field_input", name: "ATTRIBUTE_PATH", text: "" },
+                { type: "field_input", name: "EXPECTED_JSON", text: "" }
+            ],
+            message2: "持续剧情秒 %1",
+            args2: [
+                { type: "field_number", name: "DELAY_WORLD_SECONDS", value: 0, min: 0, precision: 1 }
+            ],
+            output: "Boolean",
+            inputsInline: false,
+            style: BLOCK_STYLE_KEYS.sensing,
+            tooltip: "按源实体、目标实体和关系类型读取真实关系；可用分段属性路径、JSON 期望值和剧情时间延迟限定"
+        },
+        {
+            type: "sense_object_frozen",
+            message0: "对象 %1 已冻结",
+            args0: [{ type: FIELD_ENTITY_PICKER, name: "ENTITY" }],
+            output: "Boolean",
+            style: BLOCK_STYLE_KEYS.sensing,
+            tooltip: "读取对象当前是否被冻结 被冻结返回 true 未被冻结返回 false"
+        }
+    ];
+}
+// 运算 reporter block (boolean/number/string) — 13 个
+function buildOperatorBlockDefs() {
+    return [
+        {
+            type: "op_time_crossed",
+            message0: "本次时间变动 %1 跨过 %2",
+            args0: [
+                {
+                    type: "field_dropdown",
+                    name: "DIRECTION",
+                    options: [
+                        ["任意方向", "any"],
+                        ["仅正向", "forward"],
+                        ["仅反向", "backward"]
+                    ]
+                },
+                { type: "input_value", name: "TIME", check: "Number" }
+            ],
+            output: "Boolean",
+            inputsInline: true,
+            style: BLOCK_STYLE_KEYS.operators,
+            tooltip: "判断触发本次时间变化事件的区间是否跨过目标时间点"
+        },
+        {
+            type: "op_and",
+            message0: "%1 且 %2",
+            args0: [
+                { type: "input_value", name: "A", check: "Boolean" },
+                { type: "input_value", name: "B", check: "Boolean" }
+            ],
+            output: "Boolean",
+            inputsInline: true,
+            style: BLOCK_STYLE_KEYS.operators,
+            tooltip: "逻辑与"
+        },
+        {
+            type: "op_or",
+            message0: "%1 或 %2",
+            args0: [
+                { type: "input_value", name: "A", check: "Boolean" },
+                { type: "input_value", name: "B", check: "Boolean" }
+            ],
+            output: "Boolean",
+            inputsInline: true,
+            style: BLOCK_STYLE_KEYS.operators,
+            tooltip: "逻辑或"
+        },
+        {
+            type: "op_not",
+            message0: "非 %1",
+            args0: [{ type: "input_value", name: "A", check: "Boolean" }],
+            output: "Boolean",
+            inputsInline: true,
+            style: BLOCK_STYLE_KEYS.operators,
+            tooltip: "逻辑非"
+        },
+        {
+            type: "op_equals",
+            message0: "%1 = %2",
+            args0: [
+                { type: "input_value", name: "A" },
+                { type: "input_value", name: "B" }
+            ],
+            output: "Boolean",
+            inputsInline: true,
+            style: BLOCK_STYLE_KEYS.operators,
+            tooltip: "两值相等"
+        },
+        {
+            type: "op_greater",
+            message0: "%1 > %2",
+            args0: [
+                { type: "input_value", name: "A", check: "Number" },
+                { type: "input_value", name: "B", check: "Number" }
+            ],
+            output: "Boolean",
+            inputsInline: true,
+            style: BLOCK_STYLE_KEYS.operators,
+            tooltip: "左值大于右值"
+        },
+        {
+            type: "op_less",
+            message0: "%1 < %2",
+            args0: [
+                { type: "input_value", name: "A", check: "Number" },
+                { type: "input_value", name: "B", check: "Number" }
+            ],
+            output: "Boolean",
+            inputsInline: true,
+            style: BLOCK_STYLE_KEYS.operators,
+            tooltip: "左值小于右值"
+        },
+        {
+            type: "op_contains",
+            message0: "%1 包含 %2",
+            args0: [
+                { type: "input_value", name: "A", check: "String" },
+                { type: "input_value", name: "B", check: "String" }
+            ],
+            output: "Boolean",
+            inputsInline: true,
+            style: BLOCK_STYLE_KEYS.operators,
+            tooltip: "字符串包含子串"
+        },
+        {
+            type: "op_add",
+            message0: "%1 + %2",
+            args0: [
+                { type: "input_value", name: "A", check: "Number" },
+                { type: "input_value", name: "B", check: "Number" }
+            ],
+            output: "Number",
+            inputsInline: true,
+            style: BLOCK_STYLE_KEYS.operators,
+            tooltip: "加法"
+        },
+        {
+            type: "op_subtract",
+            message0: "%1 - %2",
+            args0: [
+                { type: "input_value", name: "A", check: "Number" },
+                { type: "input_value", name: "B", check: "Number" }
+            ],
+            output: "Number",
+            inputsInline: true,
+            style: BLOCK_STYLE_KEYS.operators,
+            tooltip: "减法"
+        },
+        {
+            type: "op_multiply",
+            message0: "%1 × %2",
+            args0: [
+                { type: "input_value", name: "A", check: "Number" },
+                { type: "input_value", name: "B", check: "Number" }
+            ],
+            output: "Number",
+            inputsInline: true,
+            style: BLOCK_STYLE_KEYS.operators,
+            tooltip: "乘法"
+        },
+        {
+            type: "op_divide",
+            message0: "%1 ÷ %2",
+            args0: [
+                { type: "input_value", name: "A", check: "Number" },
+                { type: "input_value", name: "B", check: "Number" }
+            ],
+            output: "Number",
+            inputsInline: true,
+            style: BLOCK_STYLE_KEYS.operators,
+            tooltip: "除法"
+        },
+        {
+            type: "op_mod",
+            message0: "%1 mod %2",
+            args0: [
+                { type: "input_value", name: "A", check: "Number" },
+                { type: "input_value", name: "B", check: "Number" }
+            ],
+            output: "Number",
+            inputsInline: true,
+            style: BLOCK_STYLE_KEYS.operators,
+            tooltip: "取余"
+        },
+        {
+            type: "op_round",
+            message0: "四舍五入 %1",
+            args0: [{ type: "input_value", name: "A", check: "Number" }],
+            output: "Number",
+            inputsInline: true,
+            style: BLOCK_STYLE_KEYS.operators,
+            tooltip: "四舍五入"
+        },
+        {
+            type: "op_abs",
+            message0: "绝对值 %1",
+            args0: [{ type: "input_value", name: "A", check: "Number" }],
+            output: "Number",
+            inputsInline: true,
+            style: BLOCK_STYLE_KEYS.operators,
+            tooltip: "绝对值"
+        },
+        {
+            type: "op_join",
+            message0: "拼接 %1 %2",
+            args0: [
+                { type: "input_value", name: "A", check: "String" },
+                { type: "input_value", name: "B", check: "String" }
+            ],
+            output: "String",
+            inputsInline: true,
+            style: BLOCK_STYLE_KEYS.operators,
+            tooltip: "字符串拼接"
+        },
+        {
+            type: "op_letter_of",
+            message0: "%1 的第 %2 个字符",
+            args0: [
+                { type: "input_value", name: "STRING", check: "String" },
+                { type: "input_value", name: "INDEX", check: "Number" }
+            ],
+            output: "String",
+            inputsInline: true,
+            style: BLOCK_STYLE_KEYS.operators,
+            tooltip: "取字符串第 N 个字符"
+        },
+        {
+            type: "op_length_of",
+            message0: "%1 的长度",
+            args0: [{ type: "input_value", name: "STRING", check: "String" }],
+            output: "Number",
+            inputsInline: true,
+            style: BLOCK_STYLE_KEYS.operators,
+            tooltip: "字符串长度"
+        }
+    ];
+}
+// 变量 + 实体操作 + 时间 statement/reporter — 12 个
+function buildVariableEntityBlockDefs() {
+    return [
+        {
+            type: "var_read",
+            message0: "变量 %1",
+            args0: [{ type: "field_variable", name: "NAME", variable: "var" }],
+            output: "String",
+            inputsInline: true,
+            style: BLOCK_STYLE_KEYS.variables,
+            tooltip: "读取变量"
+        },
+        {
+            type: "var_set",
+            message0: "设 %1 为 %2",
+            args0: [
+                { type: "field_variable", name: "NAME", variable: "var" },
+                { type: "input_value", name: "VALUE" }
+            ],
+            previousStatement: null,
+            nextStatement: null,
+            inputsInline: true,
+            style: BLOCK_STYLE_KEYS.variables,
+            tooltip: "设置变量值"
+        },
+        {
+            type: "var_change",
+            message0: "让 %1 增加 %2",
+            args0: [
+                { type: "field_variable", name: "NAME", variable: "var" },
+                { type: "input_value", name: "VALUE", check: "Number" }
+            ],
+            previousStatement: null,
+            nextStatement: null,
+            inputsInline: true,
+            style: BLOCK_STYLE_KEYS.variables,
+            tooltip: "增量变量"
+        },
+        {
+            type: "entity_freeze",
+            message0: "冻结对象 %1 当前状态",
+            args0: [{ type: FIELD_ENTITY_PICKER, name: "ENTITY" }],
+            previousStatement: null,
+            nextStatement: null,
+            style: BLOCK_STYLE_KEYS.variables,
+            tooltip: "冻结对象当前状态 (后续不再变化)"
+        },
+        {
+            type: "entity_toggle",
+            message0: "切换对象 %1 可见状态",
+            args0: [{ type: FIELD_ENTITY_PICKER, name: "ENTITY" }],
+            previousStatement: null,
+            nextStatement: null,
+            style: BLOCK_STYLE_KEYS.variables,
+            tooltip: "切换对象的可见 / 不可见"
+        },
+        {
+            type: "entity_enable",
+            message0: "将对象 %1 设置为可见",
+            args0: [{ type: FIELD_ENTITY_PICKER, name: "ENTITY" }],
+            previousStatement: null,
+            nextStatement: null,
+            style: BLOCK_STYLE_KEYS.variables,
+            tooltip: "将对象设置为可见"
+        },
+        {
+            type: "entity_disable",
+            message0: "将对象 %1 设置为不可见",
+            args0: [{ type: FIELD_ENTITY_PICKER, name: "ENTITY" }],
+            previousStatement: null,
+            nextStatement: null,
+            style: BLOCK_STYLE_KEYS.variables,
+            tooltip: "将对象设置为不可见"
+        },
+        {
+            type: "attr_set",
+            message0: "设 %1 的属性 %2 为 %3",
+            args0: [
+                { type: FIELD_ENTITY_PICKER, name: "ENTITY" },
+                { type: FIELD_ATTR_PICKER, name: "ATTR" },
+                { type: "input_value", name: "VALUE" }
+            ],
+            previousStatement: null,
+            nextStatement: null,
+            inputsInline: true,
+            style: BLOCK_STYLE_KEYS.variables,
+            tooltip: "设置对象属性"
+        },
+        {
+            type: "time_advance",
+            message0: "推进时间 %1 %2",
+            args0: [
+                { type: "field_number", name: "AMOUNT", value: 0 },
+                {
+                    type: "field_dropdown",
+                    name: "UNIT",
+                    options: [
+                        ["年", "year"],
+                        ["月", "month"],
+                        ["日", "day"],
+                        ["时", "hour"],
+                        ["分", "minute"],
+                        ["秒", "second"]
+                    ]
+                }
+            ],
+            previousStatement: null,
+            nextStatement: null,
+            inputsInline: true,
+            style: BLOCK_STYLE_KEYS.variables,
+            tooltip: "世界时间前进 N 单位 (负数倒退)"
+        },
+        {
+            type: "time_set",
+            message0: "设时间为 %1",
+            args0: [{ type: "input_value", name: "TIME", check: "Number" }],
+            previousStatement: null,
+            nextStatement: null,
+            inputsInline: true,
+            style: BLOCK_STYLE_KEYS.variables,
+            tooltip: "设置世界时间 (可插入时间常量或时间戳)"
+        },
+        {
+            type: "var_const_boolean",
+            message0: "状态常量 %1",
+            args0: [
+                {
+                    type: "field_dropdown",
+                    name: "VALUE",
+                    options: [
+                        ["开启", "true"],
+                        ["关闭", "false"]
+                    ]
+                }
+            ],
+            output: "Boolean",
+            style: BLOCK_STYLE_KEYS.variables,
+            tooltip: "布尔常量 (尖角输出)"
+        },
+        {
+            type: "var_const_value",
+            message0: "数字或文本常量 %1",
+            args0: [{ type: "field_input", name: "VALUE", text: "" }],
+            output: null,
+            style: BLOCK_STYLE_KEYS.variables,
+            tooltip: "数字或字符串常量 (圆角输出)"
+        },
+        {
+            type: "var_const_time",
+            message0: "%1 年 %2 月 %3 日 %4 时 %5 分 %6 秒",
+            args0: [
+                { type: "field_number", name: "YEAR", value: 0, min: 0 },
+                { type: "field_number", name: "MONTH", value: 1, min: 1, max: 12 },
+                { type: "field_number", name: "DAY", value: 1, min: 1, max: 31 },
+                { type: "field_number", name: "HOUR", value: 0, min: 0, max: 23 },
+                { type: "field_number", name: "MINUTE", value: 0, min: 0, max: 59 },
+                { type: "field_number", name: "SECOND", value: 0, min: 0, max: 59 }
+            ],
+            output: "Number",
+            inputsInline: true,
+            style: BLOCK_STYLE_KEYS.variables,
+            tooltip: "时间常量 (6 数字槽 输出大数时间戳)"
+        }
+    ];
+}
+let blocksRegistered = false;
+const TRIGGER_BLOCK_REGISTRY_MARKER = Symbol.for("@world-engines/blocks-editor/trigger-block-registry");
+// Any change to the registered block JSON or extension semantics must bump this value.
+// Mixed versions intentionally fail closed and require a full page reload.
+const TRIGGER_BLOCK_REGISTRY_VERSION = "trigger-blocks-v1";
+export function registerTriggerBlocks() {
+    registerMultilineFieldOnce();
+    registerExtensionsOnce();
+    registerPickerFieldsOnce();
+    if (blocksRegistered)
+        return;
+    const defs = [
+        ...buildTriggerDefinitionBlockDefs(),
+        ...buildHatBlockDefs(),
+        ...buildControlBlockDefs(),
+        ...buildSensingBlockDefs(),
+        ...buildOperatorBlockDefs(),
+        ...buildVariableEntityBlockDefs()
+    ];
+    const registry = Blockly.Blocks;
+    const marker = registry[TRIGGER_BLOCK_REGISTRY_MARKER];
+    const registeredCount = defs.reduce((count, def) => count + (Object.prototype.hasOwnProperty.call(Blockly.Blocks, def.type) ? 1 : 0), 0);
+    if (marker === TRIGGER_BLOCK_REGISTRY_VERSION) {
+        if (registeredCount !== defs.length) {
+            throw new Error(`trigger_block_registry_incomplete:${registeredCount}/${defs.length}`);
+        }
+        blocksRegistered = true;
+        return;
+    }
+    if (marker !== undefined || registeredCount > 0) {
+        throw new Error(`trigger_block_registry_conflict:${registeredCount}/${defs.length}`);
+    }
+    Blockly.common.defineBlocksWithJsonArray(defs);
+    Object.defineProperty(registry, TRIGGER_BLOCK_REGISTRY_MARKER, {
+        configurable: false,
+        enumerable: false,
+        value: TRIGGER_BLOCK_REGISTRY_VERSION,
+        writable: false
+    });
+    blocksRegistered = true;
+}
+export function listTriggerBlockTypes() {
+    return Object.values(BLOCK_TYPES);
+}
+export function isTriggerBlockRegistered(type) {
+    return Object.prototype.hasOwnProperty.call(Blockly.Blocks, type);
+}
+// 导出全部 hat block type 供 adapter 识别
+export { HAT_BLOCK_TYPES, HAT_TYPES, isHatType, CONTROL_STATEMENT_TYPES, SENSING_REPORTER_TYPES, OPERATOR_BOOLEAN_TYPES, OPERATOR_NUMBER_TYPES, OPERATOR_STRING_TYPES, VARIABLE_TYPES, ENTITY_OP_TYPES, TIME_OP_TYPES } from "./registry-taxonomy.js";