@lppx/nlearn 1.1.3 → 1.1.5

package/dist/src/cli/cli.js

@@ -1 +1,44 @@
 "use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scanDemoFunctions = scanDemoFunctions;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+/**
+ * 扫描 demo 文件夹中的所有示例函数
+ */
+async function scanDemoFunctions() {
+    const demoPath = (0, node_path_1.join)(process.cwd(), 'src', 'demo');
+    const results = [];
+    try {
+        // 读取所有文件夹
+        const folders = await (0, promises_1.readdir)(demoPath, { withFileTypes: true });
+        for (const folder of folders) {
+            if (!folder.isDirectory())
+                continue;
+            const folderPath = (0, node_path_1.join)(demoPath, folder.name);
+            const files = await (0, promises_1.readdir)(folderPath, { withFileTypes: true });
+            for (const file of files) {
+                if (!file.isFile() || !file.name.endsWith('.ts'))
+                    continue;
+                const filePath = (0, node_path_1.join)(folderPath, file.name);
+                const content = await (0, promises_1.readFile)(filePath, 'utf-8');
+                // 提取函数名（匹配 async function 和 function 声明，支持中文）
+                const functionRegex = /(?:async\s+)?function\s+([\w\u4e00-\u9fa5]+)\s*\(/g;
+                let match;
+                while ((match = functionRegex.exec(content)) !== null) {
+                    const functionName = match[1];
+                    results.push({
+                        folder: folder.name,
+                        file: file.name.replace('.ts', ''),
+                        functionName
+                    });
+                }
+            }
+        }
+        return results;
+    }
+    catch (error) {
+        console.error('扫描示例函数时出错:', error);
+        return [];
+    }
+}

package/dist/src/cli/index.js

@@ -2,9 +2,42 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const commander_1 = require("commander");
+const node_console_1 = require("node:console");
+const cli_js_1 = require("./cli.js");
 const program = new commander_1.Command();
 program
     .name('nlearn')
     .description('nodejs 生态学习工具')
     .version('1.0.0');
+program.command("list")
+    .alias("ls")
+    .description("列出所有模块")
+    .action(async () => {
+    (0, node_console_1.log)("列出所有示例\n");
+    const functions = await (0, cli_js_1.scanDemoFunctions)();
+    if (functions.length === 0) {
+        (0, node_console_1.log)("未找到任何示例函数");
+        return;
+    }
+    // 按文件夹分组显示
+    const grouped = functions.reduce((acc, item) => {
+        if (!acc[item.folder]) {
+            acc[item.folder] = [];
+        }
+        acc[item.folder].push(item);
+        return acc;
+    }, {});
+    for (const [folder, items] of Object.entries(grouped)) {
+        (0, node_console_1.log)(`\n📦 ${folder}`);
+        items.forEach(item => {
+            (0, node_console_1.log)(`  ${item.folder}@${item.file}@${item.functionName}`);
+        });
+    }
+    (0, node_console_1.log)(`\n共找到 ${functions.length} 个示例函数`);
+});
+program.command("run")
+    .description("运行示例函数")
+    .action(async () => {
+    (0, node_console_1.log)("运行用户选择的示例函数");
+});
 program.parse(process.argv);

package/dist/src/demo/class/01-/345/237/272/347/241/200/346/246/202/345/277/265.js

@@ -0,0 +1,169 @@
+"use strict";
+/**
+ * TypeScript 类的基础概念
+ * ========================
+ * 介绍类的基本定义、构造函数、属性和方法
+ * 适用于 TypeScript 3.0+
+ */
+// #region 示例1: 基本类定义
+class Person {
+    constructor(name, age) {
+        this.name = name;
+        this.age = age;
+    }
+    greet() {
+        console.log(`你好，我是 ${this.name}，今年 ${this.age} 岁`);
+    }
+}
+function basicClassDemo() {
+    const person = new Person('张三', 25);
+    person.greet();
+    console.log('姓名:', person.name);
+    console.log('年龄:', person.age);
+}
+// #endregion
+// #region 示例2: 访问修饰符
+class BankAccount {
+    constructor(accountNumber, owner, initialBalance) {
+        this.accountNumber = accountNumber;
+        this.owner = owner;
+        this.balance = initialBalance;
+    }
+    // 公开方法
+    deposit(amount) {
+        this.balance += amount;
+        console.log(`存入 ${amount} 元，当前余额: ${this.balance} 元`);
+    }
+    // 私有方法
+    validateAmount(amount) {
+        return amount > 0;
+    }
+    withdraw(amount) {
+        if (this.validateAmount(amount) && amount <= this.balance) {
+            this.balance -= amount;
+            console.log(`取出 ${amount} 元，当前余额: ${this.balance} 元`);
+        }
+        else {
+            console.log('取款失败：金额无效或余额不足');
+        }
+    }
+    getBalance() {
+        return this.balance;
+    }
+}
+function accessModifiersDemo() {
+    const account = new BankAccount('6222021234567890', '李四', 1000);
+    console.log('账号:', account.accountNumber);
+    account.deposit(500);
+    account.withdraw(300);
+    console.log('最终余额:', account.getBalance());
+    // console.log(account.balance); // 错误：balance 是私有属性
+}
+// #endregion
+// #region 示例3: 属性简写
+class Product {
+    // 构造函数参数属性简写
+    constructor(name, price, stock) {
+        this.name = name;
+        this.price = price;
+        this.stock = stock;
+    }
+    displayInfo() {
+        console.log(`商品: ${this.name}, 价格: ¥${this.price}, 库存: ${this.stock}`);
+    }
+    sell(quantity) {
+        if (quantity <= this.stock) {
+            this.stock -= quantity;
+            console.log(`售出 ${quantity} 件，剩余库存: ${this.stock}`);
+        }
+        else {
+            console.log('库存不足');
+        }
+    }
+}
+function propertyShorthandDemo() {
+    const product = new Product('笔记本电脑', 5999, 10);
+    product.displayInfo();
+    product.sell(3);
+    product.displayInfo();
+}
+// #endregion
+// #region 示例4: Getter 和 Setter
+class Temperature {
+    constructor() {
+        this._celsius = 0;
+    }
+    get celsius() {
+        return this._celsius;
+    }
+    set celsius(value) {
+        if (value < -273.15) {
+            console.log('温度不能低于绝对零度');
+            return;
+        }
+        this._celsius = value;
+    }
+    get fahrenheit() {
+        return this._celsius * 9 / 5 + 32;
+    }
+    set fahrenheit(value) {
+        this.celsius = (value - 32) * 5 / 9;
+    }
+}
+function getterSetterDemo() {
+    const temp = new Temperature();
+    temp.celsius = 25;
+    console.log(`摄氏度: ${temp.celsius}°C`);
+    console.log(`华氏度: ${temp.fahrenheit}°F`);
+    temp.fahrenheit = 86;
+    console.log(`摄氏度: ${temp.celsius}°C`);
+    console.log(`华氏度: ${temp.fahrenheit}°F`);
+    temp.celsius = -300; // 触发验证
+}
+// #endregion
+// #region 示例5: 只读属性
+class Book {
+    constructor(isbn, title, author) {
+        this.isbn = isbn;
+        this.title = title;
+        this.author = author;
+    }
+    updateAuthor(newAuthor) {
+        this.author = newAuthor;
+        // this.isbn = '123'; // 错误：不能修改只读属性
+    }
+    displayInfo() {
+        console.log(`ISBN: ${this.isbn}`);
+        console.log(`书名: ${this.title}`);
+        console.log(`作者: ${this.author}`);
+    }
+}
+function readonlyPropertyDemo() {
+    const book = new Book('978-7-115-12345-6', 'TypeScript 入门', '王五');
+    book.displayInfo();
+    book.updateAuthor('赵六');
+    console.log('\n更新作者后:');
+    book.displayInfo();
+}
+// #endregion
+if (require.main === module) {
+    const demos = [
+        basicClassDemo,
+        accessModifiersDemo,
+        propertyShorthandDemo,
+        getterSetterDemo,
+        readonlyPropertyDemo
+    ];
+    const index = parseInt(process.argv[2]) || 0;
+    if (index > 0 && index <= demos.length) {
+        console.log(`\n=== 运行示例 ${index} ===\n`);
+        demos[index - 1]();
+    }
+    else {
+        console.log('=== 运行所有示例 ===\n');
+        demos.forEach((demo, i) => {
+            console.log(`\n--- 示例 ${i + 1}: ${demo.name} ---\n`);
+            demo();
+        });
+    }
+}

package/dist/src/demo/class/02-/347/273/247/346/211/277/344/270/216/345/244/232/346/200/201.js

@@ -0,0 +1,232 @@
+"use strict";
+/**
+ * TypeScript 类的继承与多态
+ * ==========================
+ * 介绍类的继承、方法重写、super 关键字和多态性
+ * 适用于 TypeScript 3.0+
+ */
+// #region 示例1: 基本继承
+class Animal {
+    constructor(name) {
+        this.name = name;
+    }
+    move(distance = 0) {
+        console.log(`${this.name} 移动了 ${distance} 米`);
+    }
+    makeSound() {
+        console.log(`${this.name} 发出声音`);
+    }
+}
+class Dog extends Animal {
+    constructor(name, breed) {
+        super(name); // 调用父类构造函数
+        this.breed = breed;
+    }
+    makeSound() {
+        console.log(`${this.name} 汪汪叫`);
+    }
+    fetch() {
+        console.log(`${this.name} 去捡球`);
+    }
+}
+function basicInheritanceDemo() {
+    const animal = new Animal('动物');
+    animal.makeSound();
+    animal.move(10);
+    console.log();
+    const dog = new Dog('旺财', '金毛');
+    dog.makeSound();
+    dog.move(20);
+    dog.fetch();
+    console.log(`品种: ${dog.breed}`);
+}
+// #endregion
+// #region 示例2: 方法重写与 super
+class Shape {
+    constructor(color) {
+        this.color = color;
+    }
+    describe() {
+        console.log(`这是一个 ${this.color} 的图形`);
+    }
+    getArea() {
+        return 0;
+    }
+}
+class Rectangle extends Shape {
+    constructor(color, width, height) {
+        super(color);
+        this.width = width;
+        this.height = height;
+    }
+    describe() {
+        super.describe(); // 调用父类方法
+        console.log(`宽度: ${this.width}, 高度: ${this.height}`);
+    }
+    getArea() {
+        return this.width * this.height;
+    }
+}
+class Circle extends Shape {
+    constructor(color, radius) {
+        super(color);
+        this.radius = radius;
+    }
+    describe() {
+        super.describe();
+        console.log(`半径: ${this.radius}`);
+    }
+    getArea() {
+        return Math.PI * this.radius ** 2;
+    }
+}
+function methodOverrideDemo() {
+    const rect = new Rectangle('红色', 10, 5);
+    rect.describe();
+    console.log(`面积: ${rect.getArea()}\n`);
+    const circle = new Circle('蓝色', 7);
+    circle.describe();
+    console.log(`面积: ${circle.getArea().toFixed(2)}`);
+}
+// #endregion
+// #region 示例3: 多态性
+class Employee {
+    constructor(name, salary) {
+        this.name = name;
+        this.salary = salary;
+    }
+    calculateBonus() {
+        return this.salary * 0.1;
+    }
+    displayInfo() {
+        console.log(`员工: ${this.name}`);
+        console.log(`基本工资: ¥${this.salary}`);
+        console.log(`奖金: ¥${this.calculateBonus()}`);
+    }
+}
+class Manager extends Employee {
+    constructor(name, salary, teamSize) {
+        super(name, salary);
+        this.teamSize = teamSize;
+    }
+    calculateBonus() {
+        return this.salary * 0.2 + this.teamSize * 1000;
+    }
+}
+class Developer extends Employee {
+    constructor(name, salary, projectCount) {
+        super(name, salary);
+        this.projectCount = projectCount;
+    }
+    calculateBonus() {
+        return this.salary * 0.15 + this.projectCount * 500;
+    }
+}
+function polymorphismDemo() {
+    const employees = [
+        new Employee('张三', 8000),
+        new Manager('李四', 15000, 5),
+        new Developer('王五', 12000, 3)
+    ];
+    employees.forEach((emp, index) => {
+        console.log(`\n--- 员工 ${index + 1} ---`);
+        emp.displayInfo();
+    });
+}
+// #endregion
+// #region 示例4: 抽象类
+class Vehicle {
+    constructor(brand) {
+        this.brand = brand;
+    }
+    // 普通方法，子类可以直接使用
+    displayBrand() {
+        console.log(`品牌: ${this.brand}`);
+    }
+}
+class Car extends Vehicle {
+    constructor(brand, model) {
+        super(brand);
+        this.model = model;
+    }
+    start() {
+        console.log(`${this.brand} ${this.model} 启动发动机`);
+    }
+    stop() {
+        console.log(`${this.brand} ${this.model} 熄火`);
+    }
+}
+class Bicycle extends Vehicle {
+    constructor(brand, type) {
+        super(brand);
+        this.type = type;
+    }
+    start() {
+        console.log(`${this.brand} ${this.type} 开始骑行`);
+    }
+    stop() {
+        console.log(`${this.brand} ${this.type} 停止骑行`);
+    }
+}
+function abstractClassDemo() {
+    // const vehicle = new Vehicle('通用'); // 错误：不能实例化抽象类
+    const car = new Car('特斯拉', 'Model 3');
+    car.displayBrand();
+    car.start();
+    car.stop();
+    console.log();
+    const bike = new Bicycle('捷安特', '山地车');
+    bike.displayBrand();
+    bike.start();
+    bike.stop();
+}
+// #endregion
+// #region 示例5: 受保护成员的继承
+class BankAccountBase {
+    constructor(initialBalance) {
+        this.balance = initialBalance;
+    }
+    getBalance() {
+        return this.balance;
+    }
+}
+class SavingsAccount extends BankAccountBase {
+    constructor(initialBalance, interestRate) {
+        super(initialBalance);
+        this.interestRate = interestRate;
+    }
+    addInterest() {
+        const interest = this.balance * this.interestRate;
+        this.balance += interest; // 可以访问父类的 protected 成员
+        console.log(`添加利息 ¥${interest.toFixed(2)}`);
+        console.log(`新余额: ¥${this.balance.toFixed(2)}`);
+    }
+}
+function protectedMemberDemo() {
+    const savings = new SavingsAccount(10000, 0.03);
+    console.log(`初始余额: ¥${savings.getBalance()}`);
+    savings.addInterest();
+    // console.log(savings.balance); // 错误：balance 是受保护的
+}
+// #endregion
+if (require.main === module) {
+    const demos = [
+        basicInheritanceDemo,
+        methodOverrideDemo,
+        polymorphismDemo,
+        abstractClassDemo,
+        protectedMemberDemo
+    ];
+    const index = parseInt(process.argv[2]) || 0;
+    if (index > 0 && index <= demos.length) {
+        console.log(`\n=== 运行示例 ${index} ===\n`);
+        demos[index - 1]();
+    }
+    else {
+        console.log('=== 运行所有示例 ===\n');
+        demos.forEach((demo, i) => {
+            console.log(`\n--- 示例 ${i + 1}: ${demo.name} ---\n`);
+            demo();
+        });
+    }
+}

package/dist/src/demo/class/03-/351/235/231/346/200/201/346/210/220/345/221/230/344/270/216/345/215/225/344/276/213.js

@@ -0,0 +1,221 @@
+"use strict";
+/**
+ * TypeScript 类的静态成员与单例模式
+ * ===================================
+ * 介绍静态属性、静态方法和单例模式的实现
+ * 适用于 TypeScript 3.0+
+ */
+// #region 示例1: 静态属性和方法
+class MathUtils {
+    static add(a, b) {
+        return a + b;
+    }
+    static multiply(a, b) {
+        return a * b;
+    }
+    static circleArea(radius) {
+        return this.PI * radius ** 2;
+    }
+    static power(base, exponent) {
+        return Math.pow(base, exponent);
+    }
+}
+MathUtils.PI = 3.14159;
+MathUtils.E = 2.71828;
+function staticMembersDemo() {
+    // 直接通过类名访问静态成员，无需实例化
+    console.log('PI 的值:', MathUtils.PI);
+    console.log('E 的值:', MathUtils.E);
+    console.log('5 + 3 =', MathUtils.add(5, 3));
+    console.log('4 × 6 =', MathUtils.multiply(4, 6));
+    console.log('半径为 5 的圆面积:', MathUtils.circleArea(5).toFixed(2));
+    console.log('2 的 8 次方:', MathUtils.power(2, 8));
+}
+// #endregion
+// #region 示例2: 静态属性计数器
+class User {
+    constructor(username) {
+        this.username = username;
+        User.userCount++;
+        this.id = User.userCount;
+        User.users.push(this);
+    }
+    static getUserCount() {
+        return User.userCount;
+    }
+    static getAllUsers() {
+        return User.users;
+    }
+    static findUserById(id) {
+        return User.users.find(user => user.id === id);
+    }
+    displayInfo() {
+        console.log(`用户 ID: ${this.id}, 用户名: ${this.username}`);
+    }
+}
+User.userCount = 0;
+User.users = [];
+function staticCounterDemo() {
+    console.log('初始用户数:', User.getUserCount());
+    const user1 = new User('张三');
+    const user2 = new User('李四');
+    const user3 = new User('王五');
+    console.log('当前用户数:', User.getUserCount());
+    console.log('\n所有用户:');
+    User.getAllUsers().forEach(user => user.displayInfo());
+    console.log('\n查找 ID 为 2 的用户:');
+    const foundUser = User.findUserById(2);
+    foundUser?.displayInfo();
+}
+// #endregion
+// #region 示例3: 单例模式 - 基础实现
+class Database {
+    // 私有构造函数，防止外部实例化
+    constructor() {
+        this.connectionString = 'mongodb://localhost:27017/mydb';
+        console.log('数据库连接已创建');
+    }
+    static getInstance() {
+        if (!Database.instance) {
+            Database.instance = new Database();
+        }
+        return Database.instance;
+    }
+    query(sql) {
+        console.log(`执行查询: ${sql}`);
+        console.log(`连接字符串: ${this.connectionString}`);
+    }
+}
+function singletonBasicDemo() {
+    // const db = new Database(); // 错误：构造函数是私有的
+    const db1 = Database.getInstance();
+    db1.query('SELECT * FROM users');
+    console.log();
+    const db2 = Database.getInstance();
+    db2.query('SELECT * FROM products');
+    console.log();
+    console.log('db1 和 db2 是同一个实例:', db1 === db2);
+}
+// #endregion
+// #region 示例4: 单例模式 - 配置管理器
+class ConfigManager {
+    constructor() {
+        this.config = new Map();
+        this.loadDefaultConfig();
+    }
+    static getInstance() {
+        if (!ConfigManager.instance) {
+            ConfigManager.instance = new ConfigManager();
+        }
+        return ConfigManager.instance;
+    }
+    loadDefaultConfig() {
+        this.config.set('appName', 'MyApp');
+        this.config.set('version', '1.0.0');
+        this.config.set('debug', false);
+        console.log('默认配置已加载');
+    }
+    get(key) {
+        return this.config.get(key);
+    }
+    set(key, value) {
+        this.config.set(key, value);
+        console.log(`配置已更新: ${key} = ${value}`);
+    }
+    getAll() {
+        return Object.fromEntries(this.config);
+    }
+}
+function configManagerDemo() {
+    const config1 = ConfigManager.getInstance();
+    console.log('应用名称:', config1.get('appName'));
+    console.log('版本:', config1.get('version'));
+    console.log();
+    config1.set('debug', true);
+    config1.set('port', 3000);
+    console.log();
+    const config2 = ConfigManager.getInstance();
+    console.log('所有配置:', config2.getAll());
+    console.log('config1 和 config2 是同一个实例:', config1 === config2);
+}
+// #endregion
+// #region 示例5: 静态工厂方法
+class Logger {
+    constructor(level, prefix) {
+        this.level = level;
+        this.prefix = prefix;
+    }
+    static createConsoleLogger() {
+        return new Logger('INFO', '[Console]');
+    }
+    static createFileLogger() {
+        return new Logger('DEBUG', '[File]');
+    }
+    static createErrorLogger() {
+        return new Logger('ERROR', '[Error]');
+    }
+    log(message) {
+        console.log(`${this.prefix} [${this.level}] ${message}`);
+    }
+}
+class DateFormatter {
+    constructor(formatPattern) {
+        this.formatPattern = formatPattern;
+    }
+    static createShortFormat() {
+        return new DateFormatter('YYYY-MM-DD');
+    }
+    static createLongFormat() {
+        return new DateFormatter('YYYY-MM-DD HH:mm:ss');
+    }
+    format(date) {
+        const year = date.getFullYear();
+        const month = String(date.getMonth() + 1).padStart(2, '0');
+        const day = String(date.getDate()).padStart(2, '0');
+        if (this.formatPattern === 'YYYY-MM-DD') {
+            return `${year}-${month}-${day}`;
+        }
+        else {
+            const hours = String(date.getHours()).padStart(2, '0');
+            const minutes = String(date.getMinutes()).padStart(2, '0');
+            const seconds = String(date.getSeconds()).padStart(2, '0');
+            return `${year}-${month}-${day} ${hours}:${minutes}:${seconds}`;
+        }
+    }
+}
+function staticFactoryDemo() {
+    const consoleLogger = Logger.createConsoleLogger();
+    const fileLogger = Logger.createFileLogger();
+    const errorLogger = Logger.createErrorLogger();
+    consoleLogger.log('这是一条控制台日志');
+    fileLogger.log('这是一条文件日志');
+    errorLogger.log('这是一条错误日志');
+    console.log();
+    const now = new Date();
+    const shortFormatter = DateFormatter.createShortFormat();
+    const longFormatter = DateFormatter.createLongFormat();
+    console.log('短格式:', shortFormatter.format(now));
+    console.log('长格式:', longFormatter.format(now));
+}
+// #endregion
+if (require.main === module) {
+    const demos = [
+        staticMembersDemo,
+        staticCounterDemo,
+        singletonBasicDemo,
+        configManagerDemo,
+        staticFactoryDemo
+    ];
+    const index = parseInt(process.argv[2]) || 0;
+    if (index > 0 && index <= demos.length) {
+        console.log(`\n=== 运行示例 ${index} ===\n`);
+        demos[index - 1]();
+    }
+    else {
+        console.log('=== 运行所有示例 ===\n');
+        demos.forEach((demo, i) => {
+            console.log(`\n--- 示例 ${i + 1}: ${demo.name} ---\n`);
+            demo();
+        });
+    }
+}