@lppx/nlearn 1.1.0

package/dist/src/demo/esm/04-/345/256/236/346/210/230/346/241/210/344/276/213.js

@@ -0,0 +1,509 @@
+"use strict";
+/**
+ * ESM 实战案例
+ * ============
+ * 本文件通过实际案例展示 ESM 的应用场景
+ * 包括模块组织、代码分割、插件系统等
+ */
+// #region 示例1: 工具函数库的模块化组织
+/**
+ * 案例：创建一个工具函数库，使用 ESM 进行模块化组织
+ */
+function demonstrateUtilsLibrary() {
+    console.log('=== 案例1: 工具函数库的模块化组织 ===\n');
+    console.log('项目结构：');
+    console.log('utils/');
+    console.log('  ├── string/');
+    console.log('  │   ├── capitalize.js');
+    console.log('  │   ├── trim.js');
+    console.log('  │   └── index.js');
+    console.log('  ├── array/');
+    console.log('  │   ├── unique.js');
+    console.log('  │   ├── flatten.js');
+    console.log('  │   └── index.js');
+    console.log('  └── index.js\n');
+    console.log('实现代码：');
+    console.log('---');
+    console.log('// string/capitalize.js');
+    console.log('export function capitalize(str) {');
+    console.log('  return str.charAt(0).toUpperCase() + str.slice(1);');
+    console.log('}\n');
+    console.log('// string/trim.js');
+    console.log('export function trim(str) {');
+    console.log('  return str.trim();');
+    console.log('}\n');
+    console.log('// string/index.js (聚合导出)');
+    console.log('export { capitalize } from "./capitalize.js";');
+    console.log('export { trim } from "./trim.js";\n');
+    console.log('// array/unique.js');
+    console.log('export function unique(arr) {');
+    console.log('  return [...new Set(arr)];');
+    console.log('}\n');
+    console.log('// array/flatten.js');
+    console.log('export function flatten(arr) {');
+    console.log('  return arr.flat(Infinity);');
+    console.log('}\n');
+    console.log('// array/index.js (聚合导出)');
+    console.log('export { unique } from "./unique.js";');
+    console.log('export { flatten } from "./flatten.js";\n');
+    console.log('// utils/index.js (总入口)');
+    console.log('export * as string from "./string/index.js";');
+    console.log('export * as array from "./array/index.js";\n');
+    console.log('// 或者扁平化导出');
+    console.log('export * from "./string/index.js";');
+    console.log('export * from "./array/index.js";');
+    console.log('---\n');
+    console.log('使用方式：');
+    console.log('---');
+    console.log('// 方式1: 命名空间导入');
+    console.log('import { string, array } from "./utils/index.js";');
+    console.log('console.log(string.capitalize("hello"));');
+    console.log('console.log(array.unique([1, 2, 2, 3]));\n');
+    console.log('// 方式2: 扁平化导入');
+    console.log('import { capitalize, unique } from "./utils/index.js";');
+    console.log('console.log(capitalize("hello"));');
+    console.log('console.log(unique([1, 2, 2, 3]));');
+    console.log('---\n');
+    console.log('优势：');
+    console.log('  ✓ 清晰的目录结构');
+    console.log('  ✓ 按功能分类组织');
+    console.log('  ✓ 支持按需导入（Tree Shaking）');
+    console.log('  ✓ 易于维护和扩展\n');
+}
+// #endregion
+// #region 示例2: 配置管理系统
+/**
+ * 案例：使用 ESM 实现灵活的配置管理系统
+ */
+function demonstrateConfigSystem() {
+    console.log('=== 案例2: 配置管理系统 ===\n');
+    console.log('项目结构：');
+    console.log('config/');
+    console.log('  ├── base.js        (基础配置)');
+    console.log('  ├── development.js (开发环境)');
+    console.log('  ├── production.js  (生产环境)');
+    console.log('  └── index.js       (配置入口)\n');
+    console.log('实现代码：');
+    console.log('---');
+    console.log('// config/base.js');
+    console.log('export default {');
+    console.log('  app: {');
+    console.log('    name: "MyApp",');
+    console.log('    version: "1.0.0"');
+    console.log('  },');
+    console.log('  server: {');
+    console.log('    port: 3000,');
+    console.log('    host: "localhost"');
+    console.log('  }');
+    console.log('};\n');
+    console.log('// config/development.js');
+    console.log('import base from "./base.js";');
+    console.log('');
+    console.log('export default {');
+    console.log('  ...base,');
+    console.log('  debug: true,');
+    console.log('  server: {');
+    console.log('    ...base.server,');
+    console.log('    port: 3001  // 覆盖端口');
+    console.log('  }');
+    console.log('};\n');
+    console.log('// config/production.js');
+    console.log('import base from "./base.js";');
+    console.log('');
+    console.log('export default {');
+    console.log('  ...base,');
+    console.log('  debug: false,');
+    console.log('  server: {');
+    console.log('    ...base.server,');
+    console.log('    host: "0.0.0.0"');
+    console.log('  }');
+    console.log('};\n');
+    console.log('// config/index.js');
+    console.log('const env = process.env.NODE_ENV || "development";');
+    console.log('');
+    console.log('let config;');
+    console.log('switch (env) {');
+    console.log('  case "production":');
+    console.log('    config = await import("./production.js");');
+    console.log('    break;');
+    console.log('  case "development":');
+    console.log('  default:');
+    console.log('    config = await import("./development.js");');
+    console.log('}');
+    console.log('');
+    console.log('export default config.default;');
+    console.log('---\n');
+    console.log('使用方式：');
+    console.log('---');
+    console.log('import config from "./config/index.js";');
+    console.log('');
+    console.log('console.log(config.app.name);');
+    console.log('console.log(config.server.port);');
+    console.log('console.log(config.debug);');
+    console.log('---\n');
+    console.log('优势：');
+    console.log('  ✓ 环境配置分离');
+    console.log('  ✓ 配置继承和覆盖');
+    console.log('  ✓ 按需加载配置');
+    console.log('  ✓ 类型安全（配合 TypeScript）\n');
+}
+// #endregion
+// #region 示例3: 插件系统
+/**
+ * 案例：使用动态导入实现插件系统
+ */
+async function demonstratePluginSystem() {
+    console.log('=== 案例3: 插件系统 ===\n');
+    console.log('项目结构：');
+    console.log('plugins/');
+    console.log('  ├── logger.js');
+    console.log('  ├── cache.js');
+    console.log('  ├── validator.js');
+    console.log('  └── index.js\n');
+    console.log('实现代码：');
+    console.log('---');
+    console.log('// plugins/logger.js');
+    console.log('export default {');
+    console.log('  name: "logger",');
+    console.log('  version: "1.0.0",');
+    console.log('  install(app) {');
+    console.log('    app.log = (msg) => console.log(`[LOG] ${msg}`);');
+    console.log('  }');
+    console.log('};\n');
+    console.log('// plugins/cache.js');
+    console.log('export default {');
+    console.log('  name: "cache",');
+    console.log('  version: "1.0.0",');
+    console.log('  install(app) {');
+    console.log('    const cache = new Map();');
+    console.log('    app.cache = {');
+    console.log('      get: (key) => cache.get(key),');
+    console.log('      set: (key, value) => cache.set(key, value)');
+    console.log('    };');
+    console.log('  }');
+    console.log('};\n');
+    console.log('// app.js (应用主类)');
+    console.log('class App {');
+    console.log('  constructor() {');
+    console.log('    this.plugins = [];');
+    console.log('  }');
+    console.log('');
+    console.log('  async use(pluginName) {');
+    console.log('    // 动态导入插件');
+    console.log('    const module = await import(`./plugins/${pluginName}.js`);');
+    console.log('    const plugin = module.default;');
+    console.log('    ');
+    console.log('    // 安装插件');
+    console.log('    plugin.install(this);');
+    console.log('    this.plugins.push(plugin);');
+    console.log('    ');
+    console.log('    console.log(`Plugin ${plugin.name} installed`);');
+    console.log('  }');
+    console.log('}');
+    console.log('---\n');
+    console.log('使用方式：');
+    console.log('---');
+    console.log('const app = new App();');
+    console.log('');
+    console.log('// 按需加载插件');
+    console.log('await app.use("logger");');
+    console.log('await app.use("cache");');
+    console.log('');
+    console.log('// 使用插件功能');
+    console.log('app.log("Hello World");');
+    console.log('app.cache.set("key", "value");');
+    console.log('console.log(app.cache.get("key"));');
+    console.log('---\n');
+    console.log('优势：');
+    console.log('  ✓ 按需加载插件');
+    console.log('  ✓ 减少初始加载时间');
+    console.log('  ✓ 插件独立开发和维护');
+    console.log('  ✓ 灵活的插件组合\n');
+}
+// #endregion
+// #region 示例4: 路由懒加载
+/**
+ * 案例：Web 应用中的路由懒加载
+ */
+function demonstrateLazyRouting() {
+    console.log('=== 案例4: 路由懒加载 ===\n');
+    console.log('项目结构：');
+    console.log('pages/');
+    console.log('  ├── home.js');
+    console.log('  ├── about.js');
+    console.log('  ├── contact.js');
+    console.log('  └── admin.js\n');
+    console.log('实现代码：');
+    console.log('---');
+    console.log('// router.js');
+    console.log('class Router {');
+    console.log('  constructor() {');
+    console.log('    this.routes = new Map();');
+    console.log('    this.currentPage = null;');
+    console.log('  }');
+    console.log('');
+    console.log('  // 注册路由（懒加载）');
+    console.log('  register(path, loader) {');
+    console.log('    this.routes.set(path, loader);');
+    console.log('  }');
+    console.log('');
+    console.log('  // 导航到指定路由');
+    console.log('  async navigate(path) {');
+    console.log('    const loader = this.routes.get(path);');
+    console.log('    if (!loader) {');
+    console.log('      console.error(`Route ${path} not found`);');
+    console.log('      return;');
+    console.log('    }');
+    console.log('');
+    console.log('    // 动态加载页面模块');
+    console.log('    console.log(`Loading ${path}...`);');
+    console.log('    const module = await loader();');
+    console.log('    ');
+    console.log('    // 渲染页面');
+    console.log('    this.currentPage = module.default;');
+    console.log('    this.currentPage.render();');
+    console.log('  }');
+    console.log('}');
+    console.log('');
+    console.log('// 创建路由实例');
+    console.log('const router = new Router();');
+    console.log('');
+    console.log('// 注册路由（使用动态导入）');
+    console.log('router.register("/", () => import("./pages/home.js"));');
+    console.log('router.register("/about", () => import("./pages/about.js"));');
+    console.log('router.register("/contact", () => import("./pages/contact.js"));');
+    console.log('router.register("/admin", () => import("./pages/admin.js"));');
+    console.log('---\n');
+    console.log('页面模块示例：');
+    console.log('---');
+    console.log('// pages/home.js');
+    console.log('export default {');
+    console.log('  name: "Home",');
+    console.log('  render() {');
+    console.log('    console.log("Rendering Home Page");');
+    console.log('    // 实际渲染逻辑');
+    console.log('  }');
+    console.log('};');
+    console.log('---\n');
+    console.log('使用方式：');
+    console.log('---');
+    console.log('// 导航到首页（只加载 home.js）');
+    console.log('await router.navigate("/");');
+    console.log('');
+    console.log('// 导航到关于页（只加载 about.js）');
+    console.log('await router.navigate("/about");');
+    console.log('---\n');
+    console.log('优势：');
+    console.log('  ✓ 减少初始加载体积');
+    console.log('  ✓ 提升首屏加载速度');
+    console.log('  ✓ 按需加载页面资源');
+    console.log('  ✓ 改善用户体验\n');
+}
+// #endregion
+// #region 示例5: 国际化（i18n）系统
+/**
+ * 案例：使用动态导入实现国际化
+ */
+async function demonstrateI18nSystem() {
+    console.log('=== 案例5: 国际化系统 ===\n');
+    console.log('项目结构：');
+    console.log('locales/');
+    console.log('  ├── zh-CN.js');
+    console.log('  ├── en-US.js');
+    console.log('  ├── ja-JP.js');
+    console.log('  └── index.js\n');
+    console.log('实现代码：');
+    console.log('---');
+    console.log('// locales/zh-CN.js');
+    console.log('export default {');
+    console.log('  common: {');
+    console.log('    hello: "你好",');
+    console.log('    goodbye: "再见"');
+    console.log('  },');
+    console.log('  errors: {');
+    console.log('    notFound: "未找到"');
+    console.log('  }');
+    console.log('};\n');
+    console.log('// locales/en-US.js');
+    console.log('export default {');
+    console.log('  common: {');
+    console.log('    hello: "Hello",');
+    console.log('    goodbye: "Goodbye"');
+    console.log('  },');
+    console.log('  errors: {');
+    console.log('    notFound: "Not Found"');
+    console.log('  }');
+    console.log('};\n');
+    console.log('// i18n.js');
+    console.log('class I18n {');
+    console.log('  constructor() {');
+    console.log('    this.locale = "en-US";');
+    console.log('    this.messages = null;');
+    console.log('  }');
+    console.log('');
+    console.log('  async setLocale(locale) {');
+    console.log('    this.locale = locale;');
+    console.log('    // 动态加载语言包');
+    console.log('    const module = await import(`./locales/${locale}.js`);');
+    console.log('    this.messages = module.default;');
+    console.log('    console.log(`Locale changed to ${locale}`);');
+    console.log('  }');
+    console.log('');
+    console.log('  t(key) {');
+    console.log('    const keys = key.split(".");');
+    console.log('    let value = this.messages;');
+    console.log('    for (const k of keys) {');
+    console.log('      value = value?.[k];');
+    console.log('    }');
+    console.log('    return value || key;');
+    console.log('  }');
+    console.log('}');
+    console.log('---\n');
+    console.log('使用方式：');
+    console.log('---');
+    console.log('const i18n = new I18n();');
+    console.log('');
+    console.log('// 切换到中文');
+    console.log('await i18n.setLocale("zh-CN");');
+    console.log('console.log(i18n.t("common.hello"));  // "你好"');
+    console.log('');
+    console.log('// 切换到英文');
+    console.log('await i18n.setLocale("en-US");');
+    console.log('console.log(i18n.t("common.hello"));  // "Hello"');
+    console.log('---\n');
+    console.log('优势：');
+    console.log('  ✓ 按需加载语言包');
+    console.log('  ✓ 减少初始加载体积');
+    console.log('  ✓ 支持动态切换语言');
+    console.log('  ✓ 易于添加新语言\n');
+}
+// #endregion
+// #region 示例6: 微前端架构
+/**
+ * 案例：使用 ESM 实现微前端架构
+ */
+function demonstrateMicroFrontend() {
+    console.log('=== 案例6: 微前端架构 ===\n');
+    console.log('项目结构：');
+    console.log('micro-apps/');
+    console.log('  ├── app-dashboard/');
+    console.log('  │   └── index.js');
+    console.log('  ├── app-settings/');
+    console.log('  │   └── index.js');
+    console.log('  └── app-analytics/');
+    console.log('      └── index.js\n');
+    console.log('实现代码：');
+    console.log('---');
+    console.log('// micro-apps/app-dashboard/index.js');
+    console.log('export default {');
+    console.log('  name: "dashboard",');
+    console.log('  mount(container) {');
+    console.log('    container.innerHTML = "<h1>Dashboard App</h1>";');
+    console.log('    console.log("Dashboard mounted");');
+    console.log('  },');
+    console.log('  unmount(container) {');
+    console.log('    container.innerHTML = "";');
+    console.log('    console.log("Dashboard unmounted");');
+    console.log('  }');
+    console.log('};\n');
+    console.log('// main-app.js (主应用)');
+    console.log('class MicroFrontend {');
+    console.log('  constructor() {');
+    console.log('    this.apps = new Map();');
+    console.log('    this.currentApp = null;');
+    console.log('  }');
+    console.log('');
+    console.log('  async loadApp(appName) {');
+    console.log('    // 检查是否已加载');
+    console.log('    if (this.apps.has(appName)) {');
+    console.log('      return this.apps.get(appName);');
+    console.log('    }');
+    console.log('');
+    console.log('    // 动态加载微应用');
+    console.log('    const module = await import(`./micro-apps/${appName}/index.js`);');
+    console.log('    const app = module.default;');
+    console.log('    this.apps.set(appName, app);');
+    console.log('    return app;');
+    console.log('  }');
+    console.log('');
+    console.log('  async mountApp(appName, container) {');
+    console.log('    // 卸载当前应用');
+    console.log('    if (this.currentApp) {');
+    console.log('      this.currentApp.unmount(container);');
+    console.log('    }');
+    console.log('');
+    console.log('    // 加载并挂载新应用');
+    console.log('    const app = await this.loadApp(appName);');
+    console.log('    app.mount(container);');
+    console.log('    this.currentApp = app;');
+    console.log('  }');
+    console.log('}');
+    console.log('---\n');
+    console.log('使用方式：');
+    console.log('---');
+    console.log('const mf = new MicroFrontend();');
+    console.log('const container = document.getElementById("app");');
+    console.log('');
+    console.log('// 加载仪表盘应用');
+    console.log('await mf.mountApp("app-dashboard", container);');
+    console.log('');
+    console.log('// 切换到设置应用');
+    console.log('await mf.mountApp("app-settings", container);');
+    console.log('---\n');
+    console.log('优势：');
+    console.log('  ✓ 应用独立开发和部署');
+    console.log('  ✓ 按需加载子应用');
+    console.log('  ✓ 技术栈独立');
+    console.log('  ✓ 团队独立协作\n');
+}
+// #endregion
+// 主函数：根据参数运行指定示例
+if (require.main === module) {
+    const args = process.argv.slice(2);
+    const exampleNum = args[0] ? parseInt(args[0]) : 0;
+    const examples = [
+        { name: '所有示例', fn: runAllExamples },
+        { name: '工具函数库的模块化组织', fn: demonstrateUtilsLibrary },
+        { name: '配置管理系统', fn: demonstrateConfigSystem },
+        { name: '插件系统', fn: demonstratePluginSystem },
+        { name: '路由懒加载', fn: demonstrateLazyRouting },
+        { name: '国际化系统', fn: demonstrateI18nSystem },
+        { name: '微前端架构', fn: demonstrateMicroFrontend }
+    ];
+    if (exampleNum === 0) {
+        runAllExamples();
+    }
+    else if (exampleNum > 0 && exampleNum < examples.length) {
+        console.log(`\n运行示例 ${exampleNum}: ${examples[exampleNum].name}\n`);
+        console.log('='.repeat(50));
+        const fn = examples[exampleNum].fn;
+        Promise.resolve(fn()).then(() => {
+            console.log('='.repeat(50));
+        });
+    }
+    else {
+        console.log(`可用的示例：
+${examples.slice(1).map((ex, idx) => `  ${idx + 1}. ${ex.name}`).join('\n')}
+
+使用方法: ts-node 04-实战案例.ts [示例编号]`);
+    }
+}
+async function runAllExamples() {
+    console.log(`
+${'='.repeat(50)}
+运行所有示例
+${'='.repeat(50)}
+`);
+    demonstrateUtilsLibrary();
+    console.log('\n' + '-'.repeat(50) + '\n');
+    demonstrateConfigSystem();
+    console.log('\n' + '-'.repeat(50) + '\n');
+    await demonstratePluginSystem();
+    console.log('\n' + '-'.repeat(50) + '\n');
+    demonstrateLazyRouting();
+    console.log('\n' + '-'.repeat(50) + '\n');
+    await demonstrateI18nSystem();
+    console.log('\n' + '-'.repeat(50) + '\n');
+    demonstrateMicroFrontend();
+    console.log('\n' + '='.repeat(50));
+}

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

@@ -0,0 +1,135 @@
+"use strict";
+/**
+ * Inquirer.js 基础概念
+ * ==================
+ * Inquirer.js 是一个用于创建命令行交互式问答的 Node.js 库
+ * 适用于构建 CLI 工具、脚手架等需要用户输入的场景
+ * 支持 Node.js 14.18.0+
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const inquirer_1 = __importDefault(require("inquirer"));
+// #region 示例1: 简单的文本输入
+async function simpleInput() {
+    console.log('\n=== 示例1: 简单的文本输入 ===\n');
+    const answers = await inquirer_1.default.prompt([
+        {
+            type: 'input',
+            name: 'username',
+            message: '请输入你的用户名:',
+        }
+    ]);
+    console.log(`你好, ${answers.username}!`);
+}
+// #endregion
+// #region 示例2: 带默认值的输入
+async function inputWithDefault() {
+    console.log('\n=== 示例2: 带默认值的输入 ===\n');
+    const answers = await inquirer_1.default.prompt([
+        {
+            type: 'input',
+            name: 'projectName',
+            message: '请输入项目名称:',
+            default: 'my-awesome-project',
+        }
+    ]);
+    console.log(`项目名称: ${answers.projectName}`);
+}
+// #endregion
+// #region 示例3: 密码输入
+async function passwordInput() {
+    console.log('\n=== 示例3: 密码输入 ===\n');
+    const answers = await inquirer_1.default.prompt([
+        {
+            type: 'password',
+            name: 'password',
+            message: '请输入密码:',
+            mask: '*', // 使用 * 遮盖输入
+        }
+    ]);
+    console.log(`密码长度: ${answers.password.length} 个字符`);
+}
+// #endregion
+// #region 示例4: 数字输入
+async function numberInput() {
+    console.log('\n=== 示例4: 数字输入 ===\n');
+    const answers = await inquirer_1.default.prompt([
+        {
+            type: 'number',
+            name: 'age',
+            message: '请输入你的年龄:',
+            default: 18,
+        }
+    ]);
+    console.log(`你的年龄是: ${answers.age} 岁`);
+}
+// #endregion
+// #region 示例5: 确认输入 (Yes/No)
+async function confirmInput() {
+    console.log('\n=== 示例5: 确认输入 ===\n');
+    const answers = await inquirer_1.default.prompt([
+        {
+            type: 'confirm',
+            name: 'shouldContinue',
+            message: '是否继续执行?',
+            default: true,
+        }
+    ]);
+    if (answers.shouldContinue) {
+        console.log('用户选择继续');
+    }
+    else {
+        console.log('用户选择取消');
+    }
+}
+// #endregion
+// #region 示例6: 多个问题组合
+async function multipleQuestions() {
+    console.log('\n=== 示例6: 多个问题组合 ===\n');
+    const answers = await inquirer_1.default.prompt([
+        {
+            type: 'input',
+            name: 'name',
+            message: '你的名字:',
+        },
+        {
+            type: 'input',
+            name: 'email',
+            message: '你的邮箱:',
+        },
+        {
+            type: 'number',
+            name: 'age',
+            message: '你的年龄:',
+        },
+        {
+            type: 'confirm',
+            name: 'subscribe',
+            message: '是否订阅新闻?',
+            default: false,
+        }
+    ]);
+    console.log('\n用户信息:');
+    console.log(JSON.stringify(answers, null, 2));
+}
+// #endregion
+if (require.main === module) {
+    const exampleNumber = process.argv[2];
+    const examples = {
+        '1': simpleInput,
+        '2': inputWithDefault,
+        '3': passwordInput,
+        '4': numberInput,
+        '5': confirmInput,
+        '6': multipleQuestions,
+    };
+    if (exampleNumber && examples[exampleNumber]) {
+        examples[exampleNumber]();
+    }
+    else {
+        console.log('请指定示例编号 (1-6)');
+        console.log('例如: ts-node src/demo/inquirer/01-基础概念.ts 1');
+    }
+}