@nexe/config-manager 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 aqz236
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,208 @@
+# @nexe/config-manager
+
+A flexible configuration management solution with multiple sources and hot reload support.
+
+## Features
+
+- 🔧 **Multiple Configuration Sources**: Support for environment variables, JSON, YAML, TOML, Consul, and custom sources
+- 🔄 **Hot Reload**: Automatic configuration updates with change notifications
+- 📊 **Priority-based Configuration**: Layer configurations with different priorities
+- 🎯 **Type Safety**: Strong typing with TypeScript decorators
+- 🔌 **Dependency Injection**: Seamless integration with tsyringe
+- 📝 **Validation**: Built-in configuration validation support
+- 🚀 **Easy to Use**: Simple API with minimal setup
+
+## Installation
+
+```bash
+# Using bun
+bun add @nexe/config-manager
+
+# Using npm
+npm install @nexe/config-manager
+
+# Using yarn
+yarn add @nexe/config-manager
+```
+
+## Quick Start
+
+### 1. Define Configuration Class
+
+```typescript
+import { ConfigProperty, ConfigSection } from '@nexe/config-manager';
+
+@ConfigSection('database')
+export class DatabaseConfig {
+  @ConfigProperty('host')
+  host = 'localhost';
+
+  @ConfigProperty('port')
+  port = 5432;
+
+  @ConfigProperty('username')
+  username = '';
+
+  @ConfigProperty('password')
+  password = '';
+
+  @ConfigProperty('database')
+  database = 'myapp';
+}
+```
+
+### 2. Setup Configuration Manager
+
+```typescript
+import 'reflect-metadata';
+import { container } from 'tsyringe';
+import { 
+  ConfigManager, 
+  EnvironmentConfigSource,
+  JsonConfigSource 
+} from '@nexe/config-manager';
+
+// Register config manager
+container.registerSingleton('IConfigManager', ConfigManager);
+
+// Get config manager instance
+const configManager = container.resolve<ConfigManager>('IConfigManager');
+
+// Add configuration sources (higher priority first)
+configManager.addSource(new EnvironmentConfigSource(), 100);
+configManager.addSource(new JsonConfigSource('./config.json'), 50);
+```
+
+### 3. Use Configuration
+
+```typescript
+// Get typed configuration
+const dbConfig = await configManager.getConfig(DatabaseConfig);
+console.log(`Connecting to ${dbConfig.host}:${dbConfig.port}`);
+
+// Get individual values
+const host = await configManager.get<string>('database.host', 'localhost');
+```
+
+## Configuration Sources
+
+### Environment Variables
+
+```typescript
+import { EnvironmentConfigSource } from '@nexe/config-manager';
+
+configManager.addSource(new EnvironmentConfigSource(), 100);
+```
+
+### JSON File
+
+```typescript
+import { JsonConfigSource } from '@nexe/config-manager';
+
+configManager.addSource(new JsonConfigSource('./config.json'), 50);
+```
+
+### YAML File
+
+```typescript
+import { YamlConfigSource } from '@nexe/config-manager';
+
+configManager.addSource(new YamlConfigSource('./config.yaml'), 50);
+```
+
+### Consul
+
+```typescript
+import { ConsulConfigSource } from '@nexe/config-manager';
+
+const consulSource = new ConsulConfigSource({
+  host: 'localhost',
+  port: 8500,
+  basePath: 'config/myapp'
+});
+
+configManager.addSource(consulSource, 75);
+```
+
+## Hot Reload
+
+Subscribe to configuration changes:
+
+```typescript
+// Subscribe to specific key changes
+configManager.subscribe<string>('database.host', (newHost) => {
+  console.log(`Database host changed to: ${newHost}`);
+});
+
+// Subscribe with path prefix
+configManager.subscribe<number>('port', (newPort) => {
+  console.log(`Port changed to: ${newPort}`);
+}, { pathPrefix: 'database' });
+```
+
+## Advanced Usage
+
+### Custom Configuration Source
+
+```typescript
+import { IConfigSource } from '@nexe/config-manager';
+
+export class CustomConfigSource implements IConfigSource {
+  async load(key?: string): Promise<unknown> {
+    // Your custom loading logic
+    return value;
+  }
+
+  getName(): string {
+    return 'custom-source';
+  }
+
+  supportsHotReload(): boolean {
+    return false;
+  }
+}
+
+configManager.addSource(new CustomConfigSource(), 25);
+```
+
+### Configuration Factory
+
+```typescript
+import { ConfigFactory } from '@nexe/config-manager';
+
+// Use factory for convenient setup
+const factory = new ConfigFactory();
+factory
+  .addEnvironmentSource(100)
+  .addJsonSource('./config.json', 50)
+  .addYamlSource('./config.yaml', 25);
+
+const configManager = factory.build();
+```
+
+## API Reference
+
+### ConfigManager
+
+- `addSource(source: IConfigSource, priority?: number)`: Add a configuration source
+- `get<T>(key: string, defaultValue?: T, options?: ConfigOptions)`: Get a configuration value
+- `getConfig<T>(configClass: new () => T, options?: ConfigOptions)`: Get a typed configuration object
+- `subscribe<T>(key: string, callback: (value: T) => void, options?: ConfigOptions)`: Subscribe to configuration changes
+- `unsubscribe(key: string, options?: ConfigOptions)`: Unsubscribe from configuration changes
+
+### Decorators
+
+- `@ConfigSection(section: string)`: Mark a class as a configuration section
+- `@ConfigProperty(key: string)`: Mark a property as a configuration property
+
+## License
+
+MIT © [aqz236](https://github.com/aqz236)
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## Support
+
+If you have any questions or issues, please open an issue on [GitHub](https://github.com/aqz236/nexe/issues).

package/dist/config-manager.d.ts

@@ -0,0 +1,34 @@
+import 'reflect-metadata';
+import type { ConfigOptions, IConfigManager, IConfigSource } from './interfaces';
+/**
+ * 配置管理器实现
+ */
+export declare class ConfigManager implements IConfigManager {
+    private sources;
+    private subscriptions;
+    /**
+     * 添加配置源
+     */
+    addSource(source: IConfigSource, priority?: number): void;
+    /**
+     * 获取配置值
+     */
+    get<T>(key: string, defaultValue?: T, options?: ConfigOptions): Promise<T>;
+    /**
+     * 获取强类型配置对象
+     */
+    getConfig<T>(configClass: new () => T, options?: ConfigOptions): Promise<T>;
+    /**
+     * 订阅配置变更
+     */
+    subscribe<T>(key: string, callback: (value: T) => void, options?: ConfigOptions): void;
+    /**
+     * 取消订阅配置变更
+     */
+    unsubscribe(key: string, options?: ConfigOptions): void;
+    /**
+     * 设置配置源的变更订阅
+     */
+    private setupSourceSubscription;
+}
+//# sourceMappingURL=config-manager.d.ts.map

package/dist/config-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-manager.d.ts","sourceRoot":"","sources":["../src/config-manager.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EACV,aAAa,EAEb,cAAc,EACd,aAAa,EACd,MAAM,cAAc,CAAC;AAWtB;;GAEG;AACH,qBACa,aAAc,YAAW,cAAc;IAClD,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,aAAa,CAAmD;IAExE;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,SAAI,GAAG,IAAI;IAWpD;;OAEG;IACG,GAAG,CAAC,CAAC,EACT,GAAG,EAAE,MAAM,EACX,YAAY,CAAC,EAAE,CAAC,EAChB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,CAAC,CAAC;IAoBb;;OAEG;IACG,SAAS,CAAC,CAAC,EACf,WAAW,EAAE,UAAU,CAAC,EACxB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,CAAC,CAAC;IAkBb;;OAEG;IACH,SAAS,CAAC,CAAC,EACT,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,EAC5B,OAAO,CAAC,EAAE,aAAa,GACtB,IAAI;IAsCP;;OAEG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI;IAkBvD;;OAEG;IACH,OAAO,CAAC,uBAAuB;CAchC"}

package/dist/config-manager.js

@@ -0,0 +1,138 @@
+import { __decorate } from "tslib";
+import 'reflect-metadata';
+import { injectable } from 'tsyringe';
+import { CONFIG_PROPERTY_METADATA, CONFIG_SECTION_METADATA, } from './interfaces';
+/**
+ * 配置管理器实现
+ */
+let ConfigManager = class ConfigManager {
+    constructor() {
+        this.sources = [];
+        this.subscriptions = new Map();
+    }
+    /**
+     * 添加配置源
+     */
+    addSource(source, priority = 0) {
+        this.sources.push({ source, priority });
+        // 根据优先级排序，高优先级的在前面
+        this.sources.sort((a, b) => b.priority - a.priority);
+        // 如果配置源支持热更新，设置变更监听
+        if (source.supportsHotReload() && source.subscribe) {
+            this.setupSourceSubscription(source);
+        }
+    }
+    /**
+     * 获取配置值
+     */
+    async get(key, defaultValue, options) {
+        for (const { source } of this.sources) {
+            try {
+                // 如果指定了配置源名称，只从该配置源获取
+                if (options?.sourceName && source.getName() !== options.sourceName) {
+                    continue;
+                }
+                const value = await source.load(key, options?.pathPrefix);
+                if (value !== undefined && value !== null) {
+                    return value;
+                }
+            }
+            catch (error) {
+                // eslint-disable-next-line no-console
+                console.warn(`配置源 ${source.getName()} 加载键 ${key} 时出错:`, error);
+            }
+        }
+        return defaultValue;
+    }
+    /**
+     * 获取强类型配置对象
+     */
+    async getConfig(configClass, options) {
+        const instance = new configClass();
+        const section = Reflect.getMetadata(CONFIG_SECTION_METADATA, configClass);
+        const properties = Reflect.getMetadata(CONFIG_PROPERTY_METADATA, configClass) ?? [];
+        for (const { key, propertyKey } of properties) {
+            const configKey = section ? `${section}.${key}` : key;
+            const value = await this.get(configKey, undefined, options);
+            if (value !== undefined) {
+                instance[propertyKey] = value;
+            }
+        }
+        return instance;
+    }
+    /**
+     * 订阅配置变更
+     */
+    subscribe(key, callback, options) {
+        const subscriptionKey = options?.pathPrefix
+            ? `${options.pathPrefix}:${key}`
+            : key;
+        const callbacks = this.subscriptions.get(subscriptionKey) ?? [];
+        callbacks.push(callback);
+        this.subscriptions.set(subscriptionKey, callbacks);
+        // 只订阅第一个支持热更新的配置源，避免重复订阅
+        let subscribed = false;
+        for (const { source } of this.sources) {
+            if (source.supportsHotReload() && source.subscribe && !subscribed) {
+                // 如果配置源支持动态路径，传递路径前缀
+                if (source.supportsDynamicPath && source.supportsDynamicPath()) {
+                    source.subscribe(key, newValue => {
+                        // 通知所有订阅此键的回调
+                        const currentCallbacks = this.subscriptions.get(subscriptionKey) ?? [];
+                        currentCallbacks.forEach(cb => cb(newValue));
+                    }, options?.pathPrefix);
+                }
+                else {
+                    source.subscribe(key, newValue => {
+                        // 通知所有订阅此键的回调
+                        const currentCallbacks = this.subscriptions.get(subscriptionKey) ?? [];
+                        currentCallbacks.forEach(cb => cb(newValue));
+                    });
+                }
+                subscribed = true;
+                break; // 只订阅第一个配置源
+            }
+        }
+    }
+    /**
+     * 取消订阅配置变更
+     */
+    unsubscribe(key, options) {
+        const subscriptionKey = options?.pathPrefix
+            ? `${options.pathPrefix}:${key}`
+            : key;
+        this.subscriptions.delete(subscriptionKey);
+        // 通知配置源取消订阅
+        for (const { source } of this.sources) {
+            if (source.supportsHotReload() && source.unsubscribe) {
+                if (source.supportsDynamicPath && source.supportsDynamicPath()) {
+                    source.unsubscribe(key, options?.pathPrefix);
+                }
+                else {
+                    source.unsubscribe(key);
+                }
+            }
+        }
+    }
+    /**
+     * 设置配置源的变更订阅
+     */
+    setupSourceSubscription(source) {
+        // 确保 subscribe 方法存在
+        const subscribeMethod = source.subscribe;
+        if (!subscribeMethod) {
+            return;
+        }
+        // 为每个订阅的键设置变更监听
+        this.subscriptions.forEach((callbacks, key) => {
+            subscribeMethod.call(source, key, newValue => {
+                callbacks.forEach(callback => callback(newValue));
+            });
+        });
+    }
+};
+ConfigManager = __decorate([
+    injectable()
+], ConfigManager);
+export { ConfigManager };
+//# sourceMappingURL=config-manager.js.map

package/dist/config-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-manager.js","sourceRoot":"","sources":["../src/config-manager.ts"],"names":[],"mappings":"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"}

package/dist/debug/consul-debug.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 调试Consul配置的工具函数
+ */
+declare function debugConsulConfig(): Promise<void>;
+export { debugConsulConfig };
+//# sourceMappingURL=consul-debug.d.ts.map

package/dist/debug/consul-debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consul-debug.d.ts","sourceRoot":"","sources":["../../src/debug/consul-debug.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,iBAAe,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAuChD;AAUD,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/debug/consul-debug.js

@@ -0,0 +1,53 @@
+import { createLogger } from '@nexe/logger';
+import { ConsulConfigSource } from '../sources/consul-config-source';
+const logger = createLogger('ConsulDebug');
+/**
+ * 调试Consul配置的工具函数
+ */
+async function debugConsulConfig() {
+    const consulConfig = new ConsulConfigSource({
+        host: '127.0.0.1',
+        port: 8500,
+        secure: false,
+        defaultKeyPrefix: 'app/config',
+    });
+    try {
+        // 1. 加载所有配置
+        logger.info('=== 调试：加载所有配置 ===');
+        const allConfig = await consulConfig.load();
+        logger.info('所有配置:', JSON.stringify(allConfig, null, 2));
+        // 2. 尝试加载特定的registrationMethod配置
+        logger.info('=== 调试：加载registrationMethod配置 ===');
+        const registrationMethod = await consulConfig.load('registrationMethod');
+        logger.info('registrationMethod配置:', registrationMethod);
+        // 3. 测试订阅
+        logger.info('=== 调试：测试配置订阅 ===');
+        consulConfig.subscribe('registrationMethod', (newValue) => {
+            logger.info('🔄 配置变更回调被触发');
+            logger.info('新值类型:', typeof newValue);
+            logger.info('新值内容:', JSON.stringify(newValue, null, 2));
+        });
+        // 等待一些时间来观察变更
+        await new Promise(resolve => {
+            setTimeout(() => {
+                logger.info('调试完成，清理资源...');
+                resolve();
+            }, 10000);
+        });
+    }
+    catch (error) {
+        logger.error('调试失败:', error);
+    }
+    finally {
+        consulConfig.dispose();
+    }
+}
+// 如果直接运行此文件，执行调试
+if (require.main === module) {
+    debugConsulConfig().catch(error => {
+        logger.error('调试执行失败:', error);
+        process.exit(1);
+    });
+}
+export { debugConsulConfig };
+//# sourceMappingURL=consul-debug.js.map

package/dist/debug/consul-debug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consul-debug.js","sourceRoot":"","sources":["../../src/debug/consul-debug.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAErE,MAAM,MAAM,GAAG,YAAY,CAAC,aAAa,CAAC,CAAC;AAE3C;;GAEG;AACH,KAAK,UAAU,iBAAiB;IAC9B,MAAM,YAAY,GAAG,IAAI,kBAAkB,CAAC;QAC1C,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,IAAI;QACV,MAAM,EAAE,KAAK;QACb,gBAAgB,EAAE,YAAY;KAC/B,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,YAAY;QACZ,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QACjC,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAEzD,iCAAiC;QACjC,MAAM,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QACjD,MAAM,kBAAkB,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACzE,MAAM,CAAC,IAAI,CAAC,uBAAuB,EAAE,kBAAkB,CAAC,CAAC;QAEzD,UAAU;QACV,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QACjC,YAAY,CAAC,SAAS,CAAC,oBAAoB,EAAE,CAAC,QAAiB,EAAE,EAAE;YACjE,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAC5B,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,QAAQ,CAAC,CAAC;YACtC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;QAEH,cAAc;QACd,MAAM,IAAI,OAAO,CAAO,OAAO,CAAC,EAAE;YAChC,UAAU,CAAC,GAAG,EAAE;gBACd,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;gBAC5B,OAAO,EAAE,CAAC;YACZ,CAAC,EAAE,KAAK,CAAC,CAAC;QACZ,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,OAAO,EAAE,CAAC;IACzB,CAAC;AACH,CAAC;AAED,iBAAiB;AACjB,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,iBAAiB,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;QAChC,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAC/B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/decorators.d.ts

@@ -0,0 +1,12 @@
+import 'reflect-metadata';
+/**
+ * 配置属性装饰器，用于将配置值映射到类属性
+ * @param key 配置键，如果不提供则使用属性名
+ */
+export declare function ConfigProperty(key?: string): PropertyDecorator;
+/**
+ * 配置分区装饰器，用于定义配置类所对应的配置分区
+ * @param section 配置分区名称
+ */
+export declare function ConfigSection(section: string): ClassDecorator;
+//# sourceMappingURL=decorators.d.ts.map

package/dist/decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAM1B;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAmB9D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAK7D"}

package/dist/decorators.js

@@ -0,0 +1,29 @@
+import 'reflect-metadata';
+import { CONFIG_PROPERTY_METADATA, CONFIG_SECTION_METADATA, } from './interfaces';
+/**
+ * 配置属性装饰器，用于将配置值映射到类属性
+ * @param key 配置键，如果不提供则使用属性名
+ */
+export function ConfigProperty(key) {
+    return (target, propertyKey) => {
+        const configKey = key ?? String(propertyKey);
+        // 存储配置属性元数据
+        const existingProperties = Reflect.getMetadata(CONFIG_PROPERTY_METADATA, target.constructor) ?? [];
+        existingProperties.push({
+            key: configKey,
+            propertyKey: String(propertyKey),
+        });
+        Reflect.defineMetadata(CONFIG_PROPERTY_METADATA, existingProperties, target.constructor);
+    };
+}
+/**
+ * 配置分区装饰器，用于定义配置类所对应的配置分区
+ * @param section 配置分区名称
+ */
+export function ConfigSection(section) {
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
+    return (target) => {
+        Reflect.defineMetadata(CONFIG_SECTION_METADATA, section, target);
+    };
+}
+//# sourceMappingURL=decorators.js.map

package/dist/decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EACL,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,cAAc,CAAC;AAEtB;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,GAAY;IACzC,OAAO,CAAC,MAAc,EAAE,WAA4B,EAAQ,EAAE;QAC5D,MAAM,SAAS,GAAG,GAAG,IAAI,MAAM,CAAC,WAAW,CAAC,CAAC;QAE7C,YAAY;QACZ,MAAM,kBAAkB,GACtB,OAAO,CAAC,WAAW,CAAC,wBAAwB,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QAE1E,kBAAkB,CAAC,IAAI,CAAC;YACtB,GAAG,EAAE,SAAS;YACd,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC;SACjC,CAAC,CAAC;QAEH,OAAO,CAAC,cAAc,CACpB,wBAAwB,EACxB,kBAAkB,EAClB,MAAM,CAAC,WAAW,CACnB,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,sEAAsE;IACtE,OAAO,CAAC,MAAgB,EAAQ,EAAE;QAChC,OAAO,CAAC,cAAc,CAAC,uBAAuB,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IACnE,CAAC,CAAC;AACJ,CAAC"}

package/dist/examples/annotation-example.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=annotation-example.d.ts.map

package/dist/examples/annotation-example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotation-example.d.ts","sourceRoot":"","sources":["../../src/examples/annotation-example.ts"],"names":[],"mappings":""}