快速开始

简介

Melange 是一个现代化的 JavaScript/TypeScript 工具库，提供函数式编程模式、面向对象工具和完整的类型支持。

安装

npm

npm install @lee-zg/melange

yarn

yarn add @lee-zg/melange

pnpm

pnpm add @lee-zg/melange

基本使用

导入整个库

import * as melange from '@lee-zg/melange';

// 使用函数组合
const result = melange.pipe(
  5,
  (x) => x * 2,
  (x) => x + 1
);
console.log(result); // 11

按需导入

// 导入特定模块
import { pipe, compose, curry } from '@lee-zg/melange/fp';
import { debounce, throttle, deepClone } from '@lee-zg/melange/utils';
import { EventEmitter, Container } from '@lee-zg/melange/core';
import { speak, listen, getFingerprint } from '@lee-zg/melange/plugins';

模块概览

模块	描述	导入路径
FP	函数式编程工具	@lee-zg/melange/fp
Utils	实用工具函数	@lee-zg/melange/utils
Core	核心 OOP 工具	@lee-zg/melange/core
Plugins	语音与指纹插件	@lee-zg/melange/plugins

快速示例

函数组合

import { pipe, compose } from '@lee-zg/melange/fp';

// 使用 pipe（从左到右）
const addOne = (x: number) => x + 1;
const double = (x: number) => x * 2;

const result = pipe(5, addOne, double);
console.log(result); // 12

// 使用 compose（从右到左）
const fn = compose(double, addOne);
console.log(fn(5)); // 12

Result 类型处理错误

import { tryCatch, mapResult, matchResult } from '@lee-zg/melange/fp';

const divide = (a: number, b: number) => {
  if (b === 0) throw new Error('除数不能为零');
  return a / b;
};

const result = tryCatch(() => divide(10, 2));

matchResult(result, {
  ok: (value) => console.log('结果:', value), // 结果: 5
  err: (error) => console.log('错误:', error.message),
});

防抖和节流

import { debounce, throttle } from '@lee-zg/melange/utils';

// 防抖：延迟执行，在停止触发后才执行
const debouncedFn = debounce(() => {
  console.log('搜索...');
}, 300);

// 节流：限制执行频率
const throttledFn = throttle(() => {
  console.log('滚动处理...');
}, 100);

语音合成

import { speak, createSpeechSynthesizer } from '@lee-zg/melange/plugins';

// 快速朗读
await speak('你好，世界！');

// 高级用法
const synthesizer = await createSpeechSynthesizer({
  lang: 'zh-CN',
  rate: 1.0,
});
await synthesizer.speak('这是一段测试文本');
synthesizer.dispose();

隐私友好指纹

import { getFingerprint } from '@lee-zg/melange/plugins';

const fingerprint = await getFingerprint({
  salt: 'my-app',
  privacyMode: 'balanced',
});

console.log(fingerprint.visitorId);

指纹模块默认只采集低敏信号，不采集 Canvas、音频、WebGL 渲染、字体枚举、浏览历史或插件列表。生产环境应提供清晰告知、合法依据和退出机制。

下一步

• 阅读安装指南了解更多安装选项
• 探索函数式编程核心概念
• 查看语音功能和指纹识别插件指南
• 查看完整的 API 参考