@lppx/nlearn 1.1.4 → 1.1.7

package/dist/src/cli/cli.js

@@ -1,8 +1,48 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.scanDemoFunctions = scanDemoFunctions;
+exports.selectFunctionWithFuzzySearch = selectFunctionWithFuzzySearch;
+exports.executeDemoFunction = executeDemoFunction;
 const promises_1 = require("node:fs/promises");
 const node_path_1 = require("node:path");
+const prompts_1 = __importDefault(require("prompts"));
+const fuse_js_1 = __importDefault(require("fuse.js"));
 /**
  * 扫描 demo 文件夹中的所有示例函数
  */
@@ -22,15 +62,17 @@ async function scanDemoFunctions() {
                     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+)\s*\(/g;
+                // 提取函数名（匹配 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];
+                    const displayName = `${folder.name}@${file.name.replace('.ts', '')}@${functionName}`;
                     results.push({
                         folder: folder.name,
                         file: file.name.replace('.ts', ''),
-                        functionName
+                        functionName,
+                        displayName
                     });
                 }
             }
@@ -42,3 +84,61 @@ async function scanDemoFunctions() {
         return [];
     }
 }
+/**
+ * 使用 prompts 和 fuse.js 实现模糊搜索选择函数
+ */
+async function selectFunctionWithFuzzySearch(functions) {
+    // 配置 Fuse.js 进行模糊搜索
+    const fuse = new fuse_js_1.default(functions, {
+        keys: ['displayName', 'folder', 'file', 'functionName'],
+        threshold: 0.4,
+        includeScore: true
+    });
+    // 自定义搜索建议函数
+    const suggest = (input, choices) => {
+        if (!input) {
+            return Promise.resolve(choices);
+        }
+        const results = fuse.search(input);
+        return Promise.resolve(results.map(result => ({
+            title: result.item.displayName,
+            value: result.item
+        })));
+    };
+    const response = await (0, prompts_1.default)({
+        type: 'autocomplete',
+        name: 'selectedFunction',
+        message: '请选择要运行的示例函数 (支持模糊搜索):',
+        choices: functions.map(fn => ({
+            title: fn.displayName,
+            value: fn
+        })),
+        suggest
+    });
+    return response.selectedFunction || null;
+}
+/**
+ * 动态导入并执行选中的函数
+ */
+async function executeDemoFunction(demoFunc) {
+    try {
+        console.log(`\n正在运行: ${demoFunc.displayName}\n`);
+        console.log('='.repeat(50));
+        // 构建模块路径
+        const modulePath = (0, node_path_1.join)(process.cwd(), 'src', 'demo', demoFunc.folder, `${demoFunc.file}.js`);
+        // 动态导入模块
+        const module = await Promise.resolve(`${modulePath}`).then(s => __importStar(require(s)));
+        // 检查函数是否存在
+        if (typeof module[demoFunc.functionName] !== 'function') {
+            console.error(`错误: 函数 ${demoFunc.functionName} 不存在或不是一个函数`);
+            return;
+        }
+        // 执行函数
+        await module[demoFunc.functionName]();
+        console.log('\n' + '='.repeat(50));
+        console.log('✓ 执行完成\n');
+    }
+    catch (error) {
+        console.error('\n执行函数时出错:', error);
+    }
+}

package/dist/src/cli/index.js

@@ -38,6 +38,20 @@ program.command("list")
 program.command("run")
     .description("运行示例函数")
     .action(async () => {
-    (0, node_console_1.log)("运行用户选择的示例函数");
+    (0, node_console_1.log)("扫描示例函数...\n");
+    const functions = await (0, cli_js_1.scanDemoFunctions)();
+    if (functions.length === 0) {
+        (0, node_console_1.log)("未找到任何示例函数");
+        return;
+    }
+    (0, node_console_1.log)(`找到 ${functions.length} 个示例函数\n`);
+    // 使用 prompts 和 fuse.js 实现模糊搜索选择
+    const selectedFunction = await (0, cli_js_1.selectFunctionWithFuzzySearch)(functions);
+    if (!selectedFunction) {
+        (0, node_console_1.log)("\n未选择任何函数");
+        return;
+    }
+    // 执行选中的函数
+    await (0, cli_js_1.executeDemoFunction)(selectedFunction);
 });
 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();
+        });
+    }
+}