mn-docs-mcp 0.1.0

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

@@ -0,0 +1,376 @@
+---
+title: NSDictionary
+description: 不可变键值集合（字典/映射）。
+---
+
+`NSDictionary` 是不可变的键值集合类型。常见于 API 返回 `NSDictionary`（例如 options、headerFields、配置对象等）。
+
+## 类成员 (Class members)
+
+### `dictionary`
+
+返回空字典。
+
+```javascript
+static dictionary(): NSDictionary
+```
+
+**Return Value:**
+
+- `NSDictionary`: 空字典实例。
+
+### `dictionaryWithObjectForKey`
+
+从单键值对创建字典。
+
+```javascript
+static dictionaryWithObjectForKey(object: any, key: any): NSDictionary
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `object` | `any` | 值。 |
+| `key` | `any` | 键（需支持 NSCopying）。 |
+
+**Return Value:**
+
+- `NSDictionary`: 新字典。
+
+### `dictionaryWithDictionary`
+
+从已有字典拷贝创建。
+
+```javascript
+static dictionaryWithDictionary(dict: NSDictionary): NSDictionary
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `dict` | `NSDictionary` | 源字典。 |
+
+**Return Value:**
+
+- `NSDictionary`: 新字典。
+
+### `dictionaryWithObjectsForKeys`
+
+从键数组与值数组创建。
+
+```javascript
+static dictionaryWithObjectsForKeys(objects: NSArray, keys: NSArray): NSDictionary
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `objects` | `NSArray` | 值数组。 |
+| `keys` | `NSArray` | 键数组。 |
+
+**Return Value:**
+
+- `NSDictionary`: 新字典。
+
+### `dictionaryWithObjectsAndKeys`
+
+从可变参数键值对创建（firstObject, firstKey, ...）。
+
+```javascript
+static dictionaryWithObjectsAndKeys(firstObject: any, firstKey: any, ...args: any[]): NSDictionary
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `firstObject` | `any` | 第一个值。 |
+| `firstKey` | `any` | 第一个键。 |
+| `...args` | `any[]` | 其余键值交替。 |
+
+**Return Value:**
+
+- `NSDictionary`: 新字典。
+
+### `dictionaryWithContentsOfFile`
+
+从 plist 文件路径创建。
+
+```javascript
+static dictionaryWithContentsOfFile(path: string): any
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `path` | `string` | 文件路径。 |
+
+**Return Value:**
+
+- `any`: 解析得到的字典或 null。
+
+### `dictionaryWithContentsOfURL`
+
+从 URL 创建。
+
+```javascript
+static dictionaryWithContentsOfURL(url: NSURL): any
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `url` | `NSURL` | 资源 URL。 |
+
+**Return Value:**
+
+- `any`: 解析得到的字典或 null。
+
+## 实例成员 (Instance members)
+
+### `count`
+
+键值对个数。
+
+```javascript
+count(): number
+```
+
+**Return Value:**
+
+- `number`: 字典大小。
+
+### `allKeys`
+
+所有键组成的数组。
+
+```javascript
+allKeys(): NSArray
+```
+
+**Return Value:**
+
+- `NSArray`: 键数组。
+
+### `allValues`
+
+所有值组成的数组。
+
+```javascript
+allValues(): NSArray
+```
+
+**Return Value:**
+
+- `NSArray`: 值数组。
+
+### `objectForKey`
+
+按键取值。
+
+```javascript
+objectForKey(key: any): any
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `key` | `any` | 键。 |
+
+**Return Value:**
+
+- `any`: 对应值或 undefined。
+
+### `objectForKeyedSubscript`
+
+下标访问（同 `objectForKey`）。
+
+```javascript
+objectForKeyedSubscript(key: any): any
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `key` | `any` | 键。 |
+
+**Return Value:**
+
+- `any`: 对应值或 undefined。
+
+### `keysSortedByValueUsingSelector`
+
+按键对应值的排序结果返回键数组。
+
+```javascript
+keysSortedByValueUsingSelector(comparator: any): NSArray
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `comparator` | `any` | 比较方法。 |
+
+**Return Value:**
+
+- `NSArray`: 排序后的键数组。
+
+### `isEqualToDictionary`
+
+是否与另一字典内容相等。
+
+```javascript
+isEqualToDictionary(otherDictionary: NSDictionary): boolean
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `otherDictionary` | `NSDictionary` | 另一字典。 |
+
+**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`: 描述字符串。
+
+### `descriptionWithLocaleIndent`
+
+按 locale 与缩进返回描述。
+
+```javascript
+descriptionWithLocaleIndent(locale: any, level: number): string
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `locale` | `any` | locale。 |
+| `level` | `number` | 缩进层级。 |
+
+**Return Value:**
+
+- `string`: 描述字符串。
+
+### `keyEnumerator`
+
+键的枚举器。
+
+```javascript
+keyEnumerator(): NSEnumerator
+```
+
+**Return Value:**
+
+- `NSEnumerator`: 键枚举器。
+
+### `objectEnumerator`
+
+值的枚举器。
+
+```javascript
+objectEnumerator(): NSEnumerator
+```
+
+**Return Value:**
+
+- `NSEnumerator`: 值枚举器。
+
+### `enumerateKeysAndObjectsUsingBlock`
+
+用 block 遍历键值对。
+
+```javascript
+enumerateKeysAndObjectsUsingBlock(block: (key: any, obj: any, stop: any) => void): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `block` | `(key, obj, stop) => void` | 每对调用的回调。 |
+
+**Return Value:**
+
+- 无。
+
+### `writeToFileAtomically`
+
+写入 plist 文件。
+
+```javascript
+writeToFileAtomically(path: string, useAuxiliaryFile: boolean): boolean
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `path` | `string` | 文件路径。 |
+| `useAuxiliaryFile` | `boolean` | 是否先写临时再替换。 |
+
+**Return Value:**
+
+- `boolean`: 是否成功。
+
+### `writeToURLAtomically`
+
+写入 URL。
+
+```javascript
+writeToURLAtomically(url: NSURL, atomically: boolean): boolean
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `url` | `NSURL` | 目标 URL。 |
+| `atomically` | `boolean` | 是否原子写入。 |
+
+**Return Value:**
+
+- `boolean`: 是否成功。
+
+## 相关
+
+- `NSMutableDictionary` — 可变字典
+- [NSArray](/reference/foundation/ns-array/)

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

@@ -0,0 +1,36 @@
+---
+title: NSEnumerator
+description: 枚举器（用于顺序遍历集合）。
+---
+
+`NSEnumerator` 用于遍历集合（例如 `NSArray.objectEnumerator()`、`NSDictionary.keyEnumerator()` 等返回它）。
+
+## 实例成员 (Instance members)
+
+### `nextObject`
+
+取下一个元素。
+
+```javascript
+nextObject(): any
+```
+
+**Return Value:**
+
+- `any`: 下一个元素，无则 undefined。
+
+### `allObjects`
+
+剩余元素组成的数组。
+
+```javascript
+allObjects(): NSArray
+```
+
+**Return Value:**
+
+- `NSArray`: 剩余元素数组。
+
+## 类成员 (Class members)
+
+当前运行时未额外暴露 `NSEnumerator` 的类成员。

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

@@ -0,0 +1,75 @@
+---
+title: NSError
+description: 错误对象，包含 domain/code/userInfo 与本地化描述信息。
+---
+
+`NSError` 用于表示错误信息。网络请求（如 `NSURLConnection`）或文件 API 可能通过 `NSError **` 返回错误对象（JS 侧通常作为回调参数或返回值的一部分出现）。
+
+## 类成员 (Class members)
+
+### `errorWithDomainCodeUserInfo`
+
+创建错误实例。
+
+```javascript
+static errorWithDomainCodeUserInfo(domain: string, code: number, userInfo: NSDictionary): NSError
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `domain` | `string` | 错误域。 |
+| `code` | `number` | 错误码。 |
+| `userInfo` | `NSDictionary` | 附加信息字典。 |
+
+**Return Value:**
+
+- `NSError`: 新错误实例。
+
+## 实例成员 (Instance members)
+
+### 属性（只读）
+
+| 属性 | 类型 | 说明 |
+| :--- | :--- | :--- |
+| `domain` | `string` | 错误域。 |
+| `code` | `number` | 错误码。 |
+| `userInfo` | `NSDictionary` | 附加信息。 |
+| `localizedDescription` | `string` | 本地化描述。 |
+| `localizedFailureReason` | `string` | 失败原因描述。 |
+| `localizedRecoverySuggestion` | `string` | 恢复建议。 |
+| `localizedRecoveryOptions` | `NSArray` | 恢复选项。 |
+| `helpAnchor` | `string` | 帮助锚点。 |
+
+### `initWithDomainCodeUserInfo`
+
+初始化错误实例（通常由工厂方法创建，较少直接调用）。
+
+```javascript
+initWithDomainCodeUserInfo(domain: string, code: number, userInfo: NSDictionary): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `domain` | `string` | 错误域。 |
+| `code` | `number` | 错误码。 |
+| `userInfo` | `NSDictionary` | 附加信息。 |
+
+**Return Value:**
+
+- 无。
+
+### `recoveryAttempter`
+
+恢复尝试对象。
+
+```javascript
+recoveryAttempter(): any
+```
+
+**Return Value:**
+
+- `any`: 恢复尝试对象或 undefined。