mn-docs-mcp 0.1.0

package/src/content/docs/reference/foundation/ns-mutable-string.md

@@ -0,0 +1,190 @@
+---
+title: NSMutableString
+description: 可变字符串（可原地增删改）。
+---
+
+`NSMutableString` 是可变字符串，支持原地插入/删除/替换与追加。
+
+## 类成员 (Class members)
+
+### `string`
+
+创建空可变字符串。
+
+```javascript
+static string(): NSMutableString
+```
+
+**Return Value:**
+
+- `NSMutableString`: 新实例。
+
+### `stringWithCapacity`
+
+预分配容量创建。
+
+```javascript
+static stringWithCapacity(capacity: number): NSMutableString
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `capacity` | `number` | 初始容量（字符数）。 |
+
+**Return Value:**
+
+- `NSMutableString`: 新实例。
+
+## 实例成员 (Instance members)
+
+### `replaceCharactersInRangeWithString`
+
+在范围内替换为字符串。
+
+```javascript
+replaceCharactersInRangeWithString(range: any, aString: string): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `range` | `any` | 范围（如 { location, length }）。 |
+| `aString` | `string` | 替换字符串。 |
+
+**Return Value:**
+
+- 无。
+
+### `insertStringAtIndex`
+
+在指定位置插入字符串。
+
+```javascript
+insertStringAtIndex(aString: string, loc: number): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `aString` | `string` | 要插入的字符串。 |
+| `loc` | `number` | 插入位置索引。 |
+
+**Return Value:**
+
+- 无。
+
+### `deleteCharactersInRange`
+
+删除范围内字符。
+
+```javascript
+deleteCharactersInRange(range: any): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `range` | `any` | 要删除的范围。 |
+
+**Return Value:**
+
+- 无。
+
+### `appendString`
+
+在末尾追加字符串。
+
+```javascript
+appendString(aString: string): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `aString` | `string` | 要追加的字符串。 |
+
+**Return Value:**
+
+- 无。
+
+### `setString`
+
+用字符串整体替换内容。
+
+```javascript
+setString(aString: string): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `aString` | `string` | 新内容字符串。 |
+
+**Return Value:**
+
+- 无。
+
+### `initWithCapacity`
+
+用容量初始化（通常由工厂方法创建）。
+
+```javascript
+initWithCapacity(capacity: number): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `capacity` | `number` | 初始容量。 |
+
+**Return Value:**
+
+- 无。
+
+### `appendFormat`
+
+按格式字符串追加（格式化输出）。
+
+```javascript
+appendFormat(format: string, ...arguments: any[]): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `format` | `string` | 格式字符串。 |
+| `...arguments` | `any[]` | 格式参数。 |
+
+**Return Value:**
+
+- 无。
+
+### `replaceOccurrencesOfStringWithStringOptionsRange`
+
+在范围内替换所有出现的目标字符串。
+
+```javascript
+replaceOccurrencesOfStringWithStringOptionsRange(target: string, replacement: string, options: number, searchRange: any): number
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `target` | `string` | 要替换的子串。 |
+| `replacement` | `string` | 替换为的字符串。 |
+| `options` | `number` | 比较选项（如大小写敏感）。 |
+| `searchRange` | `any` | 搜索范围。 |
+
+**Return Value:**
+
+- `number`: 替换次数。

package/src/content/docs/reference/foundation/ns-mutable-url-request.md

@@ -0,0 +1,26 @@
+---
+title: NSMutableURLRequest
+description: 可变 URL 请求对象（NSURLRequest 子类），用于设置 method/headers/body 等。
+---
+
+完整用法见 [网络请求](/guides/network-requests/) 教程。
+
+`NSMutableURLRequest` 继承自 `NSURLRequest`，用于构造可变的 HTTP 请求（设置 method/header/body 等）。在插件的网络请求里（例如 `NSURLConnection`）通常用它来构造请求。
+
+## 实例成员 (Instance members)
+
+### 常用写法
+
+```javascript
+var req = NSMutableURLRequest.requestWithURL(NSURL.URLWithString("https://example.com"));
+req.setHTTPMethod("POST");
+req.setValueForHTTPHeaderField("application/json", "Content-Type");
+req.setHTTPBody(NSData.dataWithStringEncoding("{}", 4));
+```
+
+## 类成员 (Class members)
+
+当前运行时未额外在本文列出 `NSMutableURLRequest` 的类成员；通常通过 `requestWithURL(...)` 等工厂方法创建（以你的运行时实际暴露为准，站内搜索即可定位）。
+
+相关：[网络请求](/guides/network-requests/) 教程含完整请求构建示例。
+

package/src/content/docs/reference/foundation/ns-notification-center.md

@@ -0,0 +1,30 @@
+---
+title: NSNotificationCenter
+description: 通知中心，用于插件内部或与系统的事件通信。
+---
+
+用于发送与接收应用内通知。通过 `NSNotificationCenter.defaultCenter()` 获取默认中心。
+
+## 类成员 (Class members)
+
+### 获取实例
+
+| 方法 | 返回值 | 说明 |
+|------|--------|------|
+| `static defaultCenter()` | NSNotificationCenter | 获取默认通知中心。 |
+
+## 实例成员 (Instance members)
+
+### 方法
+
+| 方法 | 参数 | 说明 |
+|------|------|------|
+| `addObserverSelectorName(observer, aSelector, aName)` | observer: id, aSelector: string（方法名）, aName: string | 添加观察者（JS 中 _addObserver）。 |
+| `postNotificationNameObject( aName, anObject)` | aName: string, anObject: id | 发送通知。 |
+| `postNotificationNameObjectUserInfo(aName, anObject, aUserInfo)` | aName, anObject, aUserInfo: NSDictionary | 发送带 userInfo 的通知。 |
+| `removeObserver(observer)` | observer: id | 移除观察者。 |
+| `removeObserverName(observer, aName)` | observer, aName | 移除指定名称的观察（_removeObserverName）。 |
+
+## 相关
+
+- 用于插件内部多模块或与 MarginNote 事件联动。

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

@@ -0,0 +1,73 @@
+---
+title: NSNotification
+description: 通知对象（name/object/userInfo）。
+---
+
+`NSNotification` 表示一条通知（name、object、userInfo）。常见于 `NSNotificationCenter` 的 post/回调参数。
+
+## 类成员 (Class members)
+
+### `notificationWithNameObject`
+
+创建无 userInfo 的通知。
+
+```javascript
+static notificationWithNameObject(aName: string, anObject: any): NSNotification
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `aName` | `string` | 通知名。 |
+| `anObject` | `any` | 关联对象。 |
+
+**Return Value:**
+
+- `NSNotification`: 新通知实例。
+
+### `notificationWithNameObjectUserInfo`
+
+创建带 userInfo 的通知。
+
+```javascript
+static notificationWithNameObjectUserInfo(aName: string, anObject: any, aUserInfo: NSDictionary): NSNotification
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `aName` | `string` | 通知名。 |
+| `anObject` | `any` | 关联对象。 |
+| `aUserInfo` | `NSDictionary` | 附加信息。 |
+
+**Return Value:**
+
+- `NSNotification`: 新通知实例。
+
+## 实例成员 (Instance members)
+
+### `initWithNameObjectUserInfo`
+
+初始化通知实例。
+
+```javascript
+initWithNameObjectUserInfo(name: string, object: any, userInfo: NSDictionary): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `name` | `string` | 通知名。 |
+| `object` | `any` | 关联对象。 |
+| `userInfo` | `NSDictionary` | 附加信息。 |
+
+**Return Value:**
+
+- 无。
+
+## 相关
+
+- [NSNotificationCenter](/reference/foundation/ns-notification-center/)

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

@@ -0,0 +1,24 @@
+---
+title: NSNull
+description: 空值对象（用于集合中表示“空”）。
+---
+
+`NSNull` 用于在 `NSArray`/`NSDictionary` 等集合中表达“空值”，避免使用 `null/undefined` 导致集合语义不一致。
+
+## 类成员 (Class members)
+
+### `null`
+
+获取单例空值对象。
+
+```javascript
+static null(): NSNull
+```
+
+**Return Value:**
+
+- `NSNull`: 全局唯一的 NSNull 实例。
+
+## 实例成员 (Instance members)
+
+`NSNull` 的实例通常只作为“占位空值”使用，不需要调用其上的成员。

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

@@ -0,0 +1,147 @@
+---
+title: NSNumberFormatter
+description: 数字格式化与解析（本地化/千分位/货币等）。
+---
+
+`NSNumberFormatter` 用于把 `NSNumber` 与字符串互相转换，并控制本地化与显示格式（小数位、千分位、货币符号等）。
+
+> 本类型导出方法/属性较多，下面按“核心用法优先”列出常用项；遇到更细的配置项，直接在站内搜索成员名即可。
+
+## 类成员 (Class members)
+
+### `localizedStringFromNumberNumberStyle`
+
+按样式生成本地化字符串。
+
+```javascript
+static localizedStringFromNumberNumberStyle(num: NSNumber, nstyle: number): string
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `num` | `NSNumber` | 数值。 |
+| `nstyle` | `number` | 样式（如 decimal、currency）。 |
+
+**Return Value:**
+
+- `string`: 本地化字符串。
+
+### `defaultFormatterBehavior`
+
+默认格式化行为。
+
+```javascript
+static defaultFormatterBehavior(): number
+```
+
+**Return Value:**
+
+- `number`: 行为值。
+
+### `setDefaultFormatterBehavior`
+
+设置默认格式化行为。
+
+```javascript
+static setDefaultFormatterBehavior(behavior: number): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `behavior` | `number` | 行为值。 |
+
+**Return Value:**
+
+- 无。
+
+## 实例成员 (Instance members)
+
+### `stringFromNumber`
+
+将数值格式化为字符串。
+
+```javascript
+stringFromNumber(number: NSNumber): string
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `number` | `NSNumber` | 数值。 |
+
+**Return Value:**
+
+- `string`: 格式化后的字符串。
+
+### `numberFromString`
+
+从字符串解析数值。
+
+```javascript
+numberFromString(string: string): NSNumber
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `string` | `string` | 数字字符串。 |
+
+**Return Value:**
+
+- `NSNumber`: 解析得到的数值。
+
+### `getObjectValueForStringRangeError`
+
+从字符串解析对象（带范围与错误输出）。
+
+```javascript
+getObjectValueForStringRangeError(obj: any, string: string, rangep: any, error: any): boolean
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `obj` | `any` | 输出参数，接收解析结果。 |
+| `string` | `string` | 源字符串。 |
+| `rangep` | `any` | 输出参数，接收解析到的范围。 |
+| `error` | `any` | 输出参数，接收错误。 |
+
+**Return Value:**
+
+- `boolean`: 是否解析成功。
+
+### 常用配置（属性/方法）
+
+| 方法/属性 | 说明 |
+| :--- | :--- |
+| `numberStyle()` / `setNumberStyle(style)` | 数字样式。 |
+| `locale()` / `setLocale(locale)` | 区域。 |
+| `allowsFloats()` / `setAllowsFloats(flag)` | 是否允许浮点。 |
+| `generatesDecimalNumbers()` / `setGeneratesDecimalNumbers(b)` | 是否生成 NSDecimalNumber。 |
+| `decimalSeparator()` | 小数分隔符。 |
+| `groupingSeparator()` | 千分位分隔符。 |
+| `usesGroupingSeparator()` / `setUsesGroupingSeparator(b)` | 是否使用千分位。 |
+| `minimumFractionDigits()` / `setMinimumFractionDigits(number)` | 最少小数位。 |
+| `maximumFractionDigits()` / `setMaximumFractionDigits(number)` | 最多小数位。 |
+| `minimumIntegerDigits()` / `setMinimumIntegerDigits(number)` | 最少整数位。 |
+| `maximumIntegerDigits()` / `setMaximumIntegerDigits(number)` | 最多整数位。 |
+| `positivePrefix()` / `setPositivePrefix(string)` | 正数前缀。 |
+| `positiveSuffix()` / `setPositiveSuffix(string)` | 正数后缀。 |
+| `negativePrefix()` / `setNegativePrefix(string)` | 负数前缀。 |
+| `negativeSuffix()` / `setNegativeSuffix(string)` | 负数后缀。 |
+
+### 进阶
+
+本类型还导出了大量与舍入、科学计数、货币、百分比、解析容错、符号显示相关的 getter/setter（例如 roundingMode、currencyCode、percentSymbol、lenient、usesSignificantDigits 等）。可通过站内搜索成员名定位。
+
+## 相关
+
+- [NSNumber](/reference/foundation/ns-number/)
+- [NSDecimalNumber](/reference/foundation/ns-decimal-number/)