TypeScript原型扩展：实现公共读取与受控设置

class MyClass {
    private _data: string;

    public get data(): string {
        return this._data;
    }

    private set data(value: string) {
        this._data = value;
    }

    // 内部方法可以设置值
    public initializeData(initialValue: string) {
        this.data = initialValue; // 内部访问私有setter
    }
}

const instance = new MyClass();
// console.log(instance.data); // 外部可读
// instance.data = "newValue"; // 外部无法直接赋值，因为setter是私有的
instance.initializeData("initial"); // 内部方法设置值

// 假设我们有一个FeatureManager类
class FeatureManager {
    id: string;
    constructor(id: string) {
        this.id = id;
    }
    // ... 其他FeatureManager的逻辑
}

// 1. 扩展HTMLElement接口，声明features属性
declare global {
    interface HTMLElement {
        readonly features?: FeatureManager; // 使用readonly关键字，使其在外部表现为只读
        _internalFeatures?: FeatureManager; // 声明一个内部使用的字段来存储实际值
        setupFeatures(manager: FeatureManager): void; // 声明一个内部方法来设置features
    }
}

const myDiv = document.createElement('div');
const fm = new FeatureManager("feature-a");

// myDiv.features = fm; // 错误：无法分配到“features”，因为它是一个只读属性。(TS2540)
const currentFeatures = myDiv.features; // 允许读取

// 2. 在HTMLElement原型上实现getter和设置方法
(function() { // 使用IIFE封装，避免全局污染
    // 定义features属性的getter
    Object.defineProperty(HTMLElement.prototype, 'features', {
        get: function(this: HTMLElement): FeatureManager | undefined {
            // 返回内部存储的_internalFeatures
            return this._internalFeatures;
        },
        configurable: true // 允许重新定义此属性
        // 注意：这里没有setter，因为我们希望通过方法来控制设置
    });

    // 定义setupFeatures方法
    HTMLElement.prototype.setupFeatures = function(this: HTMLElement, manager: FeatureManager): void {
        if (this._internalFeatures) {
            console.warn("Features for this HTMLElement have already been initialized.");
            // 根据需求，可以选择抛出错误、更新或忽略
            // this._internalFeatures = manager; // 如果允许更新，则取消注释
            return;
        }
        this._internalFeatures = manager; // 第一次初始化
    };
})();

// 假设FeatureManager类已定义
// class FeatureManager { /* ... */ }

// 假设HTMLElement接口扩展和原型实现代码已运行

const myButton = document.createElement('button');
myButton.textContent = "Click Me";
document.body.appendChild(myButton);

const featureA = new FeatureManager("Analytics Tracking");
const featureB = new FeatureManager("Tooltip Display");

// 外部无法直接赋值
// myButton.features = featureA; // 编译错误！

// 通过受控方法初始化
myButton.setupFeatures(featureA);
console.log("Button features after setup:", myButton.features?.id); // 输出: Analytics Tracking

// 尝试再次设置（如果setupFeatures逻辑只允许一次初始化）
myButton.setupFeatures(featureB); // 会在控制台打印警告信息，features保持为featureA

// 外部可以读取
const currentFeature = myButton.features;
if (currentFeature) {
    console.log("Current feature ID:", currentFeature.id); // 输出: Analytics Tracking
}