mn-docs-mcp 0.1.0

package/src/content/docs/reference/foundation/ns-date-formatter.md

@@ -0,0 +1,70 @@
+---
+title: NSDateFormatter
+description: 日期格式化与解析。
+---
+
+`NSDateFormatter` 用于在 `NSDate` 与字符串之间转换。常见于日志输出、持久化、与外部系统交互。
+
+## 类成员 (Class members)
+
+### 创建
+
+通过 `new()` 或 `alloc().init()` 创建（视环境可用方式）。
+
+```javascript
+// 示例
+var formatter = new NSDateFormatter();
+// 或
+var formatter = NSDateFormatter.alloc().init();
+```
+
+## 实例成员 (Instance members)
+
+### 属性
+
+| 属性 | 类型 | 说明 |
+| :--- | :--- | :--- |
+| `dateFormat` | `string` | 日期格式字符串（如 "yyyy-MM-dd"）。 |
+| `locale` | `NSLocale` | 区域。 |
+| `timeZone` | `NSTimeZone` | 时区。 |
+
+### `stringFromDate`
+
+将日期格式化为字符串。
+
+```javascript
+stringFromDate(date: NSDate): string
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `date` | `NSDate` | 要格式化的日期。 |
+
+**Return Value:**
+
+- `string`: 格式化后的字符串。
+
+### `dateFromString`
+
+从字符串解析日期。
+
+```javascript
+dateFromString(string: string): NSDate
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `string` | `string` | 日期字符串。 |
+
+**Return Value:**
+
+- `NSDate`: 解析得到的日期。
+
+## 相关
+
+- [NSDate](/reference/foundation/ns-date/)
+- [NSLocale](/reference/foundation/ns-locale/)、[NSTimeZone](/reference/foundation/ns-time-zone/)

package/src/content/docs/reference/foundation/ns-date.md

@@ -0,0 +1,236 @@
+---
+title: NSDate
+description: 时间点对象。
+---
+
+`NSDate` 表示一个时间点。常见于笔记的 `createDate` / `modifiedDate` 等字段，或作为定时/格式化输入。
+
+## 类成员 (Class members)
+
+### `date`
+
+当前时间。
+
+```javascript
+static date(): NSDate
+```
+
+**Return Value:**
+
+- `NSDate`: 当前时间点。
+
+### `dateWithTimeIntervalSinceNow`
+
+相对当前时间的偏移。
+
+```javascript
+static dateWithTimeIntervalSinceNow(secs: number): NSDate
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `secs` | `number` | 相对当前的秒数。 |
+
+**Return Value:**
+
+- `NSDate`: 新时间点。
+
+### `dateWithTimeIntervalSince1970`
+
+自 1970-01-01 00:00:00 UTC 的秒数创建。
+
+```javascript
+static dateWithTimeIntervalSince1970(secs: number): NSDate
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `secs` | `number` | 秒数。 |
+
+**Return Value:**
+
+- `NSDate`: 新时间点。
+
+### `dateWithTimeIntervalSinceReferenceDate`
+
+自参考日期的秒数创建。
+
+```javascript
+static dateWithTimeIntervalSinceReferenceDate(secs: number): NSDate
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `secs` | `number` | 秒数。 |
+
+**Return Value:**
+
+- `NSDate`: 新时间点。
+
+## 实例成员 (Instance members)
+
+### `timeIntervalSinceNow`
+
+与当前时间的秒数差。
+
+```javascript
+timeIntervalSinceNow(): number
+```
+
+**Return Value:**
+
+- `number`: 秒数差。
+
+### `timeIntervalSince1970`
+
+自 1970-01-01 00:00:00 UTC 的秒数。
+
+```javascript
+timeIntervalSince1970(): number
+```
+
+**Return Value:**
+
+- `number`: 秒数。
+
+### `timeIntervalSinceReferenceDate`
+
+自参考日期的秒数。
+
+```javascript
+timeIntervalSinceReferenceDate(): number
+```
+
+**Return Value:**
+
+- `number`: 秒数。
+
+### `timeIntervalSinceDate`
+
+与另一日期的秒数差。
+
+```javascript
+timeIntervalSinceDate(anotherDate: NSDate): number
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `anotherDate` | `NSDate` | 另一日期。 |
+
+**Return Value:**
+
+- `number`: 秒数差。
+
+### `earlierDate`
+
+两者中较早的日期。
+
+```javascript
+earlierDate(anotherDate: NSDate): NSDate
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `anotherDate` | `NSDate` | 另一日期。 |
+
+**Return Value:**
+
+- `NSDate`: 较早的日期。
+
+### `laterDate`
+
+两者中较晚的日期。
+
+```javascript
+laterDate(anotherDate: NSDate): NSDate
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `anotherDate` | `NSDate` | 另一日期。 |
+
+**Return Value:**
+
+- `NSDate`: 较晚的日期。
+
+### `compare`
+
+与另一日期比较。
+
+```javascript
+compare(otherDate: NSDate): number
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `otherDate` | `NSDate` | 另一日期。 |
+
+**Return Value:**
+
+- `number`: 比较结果（小于/等于/大于）。
+
+### `isEqualToDate`
+
+是否与另一日期相等。
+
+```javascript
+isEqualToDate(otherDate: NSDate): boolean
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `otherDate` | `NSDate` | 另一日期。 |
+
+**Return Value:**
+
+- `boolean`: 是否相等。
+
+### `description`
+
+返回日期的字符串描述。
+
+```javascript
+description(): string
+```
+
+**Return Value:**
+
+- `string`: 描述字符串。
+
+### `descriptionWithLocale`
+
+按 locale 返回描述。
+
+```javascript
+descriptionWithLocale(locale: any): string
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `locale` | `any` | locale。 |
+
+**Return Value:**
+
+- `string`: 描述字符串。
+
+## 相关
+
+- `NSDateFormatter`、`NSCalendar`（如可用）

package/src/content/docs/reference/foundation/ns-decimal-number.md

@@ -0,0 +1,437 @@
+---
+title: NSDecimalNumber
+description: 十进制高精度数值（适合货币/精确计算）。
+---
+
+`NSDecimalNumber` 提供十进制高精度计算（避免浮点误差），适合货币、精确比例计算等。
+
+## 类成员 (Class members)
+
+### `decimalNumberWithString`
+
+从字符串创建。
+
+```javascript
+static decimalNumberWithString(numberValue: string): NSDecimalNumber
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `numberValue` | `string` | 数字字符串。 |
+
+**Return Value:**
+
+- `NSDecimalNumber`: 新实例。
+
+### `decimalNumberWithStringLocale`
+
+从字符串与 locale 创建。
+
+```javascript
+static decimalNumberWithStringLocale(numberValue: string, locale: any): NSDecimalNumber
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `numberValue` | `string` | 数字字符串。 |
+| `locale` | `any` | locale。 |
+
+**Return Value:**
+
+- `NSDecimalNumber`: 新实例。
+
+### `decimalNumberWithMantissaExponentIsNegative`
+
+从尾数与指数创建。
+
+```javascript
+static decimalNumberWithMantissaExponentIsNegative(mantissa: number, exponent: number, flag: boolean): NSDecimalNumber
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `mantissa` | `number` | 尾数。 |
+| `exponent` | `number` | 指数。 |
+| `flag` | `boolean` | 是否负数。 |
+
+**Return Value:**
+
+- `NSDecimalNumber`: 新实例。
+
+### `zero`
+
+零。
+
+```javascript
+static zero(): NSDecimalNumber
+```
+
+**Return Value:**
+
+- `NSDecimalNumber`: 零。
+
+### `one`
+
+一。
+
+```javascript
+static one(): NSDecimalNumber
+```
+
+**Return Value:**
+
+- `NSDecimalNumber`: 一。
+
+### `minimumDecimalNumber`
+
+最小可表示值。
+
+```javascript
+static minimumDecimalNumber(): NSDecimalNumber
+```
+
+**Return Value:**
+
+- `NSDecimalNumber`: 最小值。
+
+### `maximumDecimalNumber`
+
+最大可表示值。
+
+```javascript
+static maximumDecimalNumber(): NSDecimalNumber
+```
+
+**Return Value:**
+
+- `NSDecimalNumber`: 最大值。
+
+### `notANumber`
+
+非数字。
+
+```javascript
+static notANumber(): NSDecimalNumber
+```
+
+**Return Value:**
+
+- `NSDecimalNumber`: NaN。
+
+### `defaultBehavior`
+
+默认舍入/异常行为。
+
+```javascript
+static defaultBehavior(): any
+```
+
+**Return Value:**
+
+- `any`: 默认行为对象。
+
+### `setDefaultBehavior`
+
+设置默认行为。
+
+```javascript
+static setDefaultBehavior(behavior: any): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `behavior` | `any` | 行为对象。 |
+
+**Return Value:**
+
+- 无。
+
+## 实例成员 (Instance members)
+
+### `decimalNumberByAdding`
+
+加。
+
+```javascript
+decimalNumberByAdding(decimalNumber: NSDecimalNumber): NSDecimalNumber
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `decimalNumber` | `NSDecimalNumber` | 加数。 |
+
+**Return Value:**
+
+- `NSDecimalNumber`: 和。
+
+### `decimalNumberByAddingWithBehavior`
+
+按指定行为加。
+
+```javascript
+decimalNumberByAddingWithBehavior(decimalNumber: NSDecimalNumber, behavior: any): NSDecimalNumber
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `decimalNumber` | `NSDecimalNumber` | 加数。 |
+| `behavior` | `any` | 舍入/异常行为。 |
+
+**Return Value:**
+
+- `NSDecimalNumber`: 和。
+
+### `decimalNumberBySubtracting`
+
+减。
+
+```javascript
+decimalNumberBySubtracting(decimalNumber: NSDecimalNumber): NSDecimalNumber
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `decimalNumber` | `NSDecimalNumber` | 减数。 |
+
+**Return Value:**
+
+- `NSDecimalNumber`: 差。
+
+### `decimalNumberBySubtractingWithBehavior`
+
+按指定行为减。
+
+```javascript
+decimalNumberBySubtractingWithBehavior(decimalNumber: NSDecimalNumber, behavior: any): NSDecimalNumber
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `decimalNumber` | `NSDecimalNumber` | 减数。 |
+| `behavior` | `any` | 行为。 |
+
+**Return Value:**
+
+- `NSDecimalNumber`: 差。
+
+### `decimalNumberByMultiplyingBy`
+
+乘。
+
+```javascript
+decimalNumberByMultiplyingBy(decimalNumber: NSDecimalNumber): NSDecimalNumber
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `decimalNumber` | `NSDecimalNumber` | 乘数。 |
+
+**Return Value:**
+
+- `NSDecimalNumber`: 积。
+
+### `decimalNumberByMultiplyingByWithBehavior`
+
+按指定行为乘。
+
+```javascript
+decimalNumberByMultiplyingByWithBehavior(decimalNumber: NSDecimalNumber, behavior: any): NSDecimalNumber
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `decimalNumber` | `NSDecimalNumber` | 乘数。 |
+| `behavior` | `any` | 行为。 |
+
+**Return Value:**
+
+- `NSDecimalNumber`: 积。
+
+### `decimalNumberByDividingBy`
+
+除。
+
+```javascript
+decimalNumberByDividingBy(decimalNumber: NSDecimalNumber): NSDecimalNumber
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `decimalNumber` | `NSDecimalNumber` | 除数。 |
+
+**Return Value:**
+
+- `NSDecimalNumber`: 商。
+
+### `decimalNumberByDividingByWithBehavior`
+
+按指定行为除。
+
+```javascript
+decimalNumberByDividingByWithBehavior(decimalNumber: NSDecimalNumber, behavior: any): NSDecimalNumber
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `decimalNumber` | `NSDecimalNumber` | 除数。 |
+| `behavior` | `any` | 行为。 |
+
+**Return Value:**
+
+- `NSDecimalNumber`: 商。
+
+### `decimalNumberByRaisingToPower`
+
+幂。
+
+```javascript
+decimalNumberByRaisingToPower(power: number): NSDecimalNumber
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `power` | `number` | 指数。 |
+
+**Return Value:**
+
+- `NSDecimalNumber`: 结果。
+
+### `decimalNumberByRaisingToPowerWithBehavior`
+
+按指定行为求幂。
+
+```javascript
+decimalNumberByRaisingToPowerWithBehavior(power: number, behavior: any): NSDecimalNumber
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `power` | `number` | 指数。 |
+| `behavior` | `any` | 行为。 |
+
+**Return Value:**
+
+- `NSDecimalNumber`: 结果。
+
+### `decimalNumberByMultiplyingByPowerOf10`
+
+乘以 10 的幂。
+
+```javascript
+decimalNumberByMultiplyingByPowerOf10(power: number): NSDecimalNumber
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `power` | `number` | 指数。 |
+
+**Return Value:**
+
+- `NSDecimalNumber`: 结果。
+
+### `decimalNumberByMultiplyingByPowerOf10WithBehavior`
+
+按指定行为乘以 10 的幂。
+
+```javascript
+decimalNumberByMultiplyingByPowerOf10WithBehavior(power: number, behavior: any): NSDecimalNumber
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `power` | `number` | 指数。 |
+| `behavior` | `any` | 行为。 |
+
+**Return Value:**
+
+- `NSDecimalNumber`: 结果。
+
+### `decimalNumberByRoundingAccordingToBehavior`
+
+按指定行为舍入。
+
+```javascript
+decimalNumberByRoundingAccordingToBehavior(behavior: any): NSDecimalNumber
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `behavior` | `any` | 行为。 |
+
+**Return Value:**
+
+- `NSDecimalNumber`: 舍入结果。
+
+### `compare`
+
+与另一 NSDecimalNumber 比较。
+
+```javascript
+compare(decimalNumber: NSDecimalNumber): number
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `decimalNumber` | `NSDecimalNumber` | 另一数值。 |
+
+**Return Value:**
+
+- `number`: 比较结果。
+
+### `descriptionWithLocale`
+
+按 locale 返回描述。
+
+```javascript
+descriptionWithLocale(locale: any): string
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `locale` | `any` | locale。 |
+
+**Return Value:**
+
+- `string`: 描述字符串。
+
+### isEqualToNumber（未导出）
+
+`isEqualToNumber(...)` 在最新头文件导出清单中未暴露；如需比较请使用 `compare(...)` 或先转为标量后比较（以运行时行为为准）。