Method register

ui/src/protocol/registry.ts:83–115

* 注册组件 * * @param typeName - 组件类型名称（必须以字母开头，只能包含字母和数字） * @param constructor - 组件构造函数 * @param tagName - 可选的自定义元素标签名（用于 Web Components） * @throws {RegistryError} 如果注册表已冻结、类型名称无效或组件已注册

(typeName: string, constructor: ComponentConstructor, _tagName?: string)

   * @throws {RegistryError} 如果注册表已冻结、类型名称无效或组件已注册
   */
  register(typeName: string, constructor: ComponentConstructor, _tagName?: string): void {
    // 检查是否已冻结
    if (this.frozen) {
      throw new RegistryError(
        'Cannot register component: registry is frozen in production mode',
        RegistryErrorCodes.REGISTRY_FROZEN,
        { typeName },
      );
    }

    // 验证类型名称
    if (!isValidTypeName(typeName)) {
      throw new RegistryError(
        `Invalid component type name: "${typeName}". Type name must start with a letter and contain only alphanumeric characters.`,
        RegistryErrorCodes.INVALID_TYPE_NAME,
        { typeName },
      );
    }

    // 检查是否已注册
    if (this.components.has(typeName)) {
      // 如果已注册相同的构造函数，静默返回（幂等性）
      if (this.components.get(typeName) === constructor) {
        return;
      }
      // 否则记录警告并返回（不覆盖）
      console.warn(`Component "${typeName}" is already registered. Skipping registration.`);
      return;
    }

    // 注册组件
    this.components.set(typeName, constructor);
  }

  /**
   * 获取已注册的组件构造函数