mn-docs-mcp 0.1.0

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

@@ -0,0 +1,131 @@
+---
+title: NSFormatter
+description: 格式化基类（对象↔字符串转换）。
+---
+
+`NSFormatter` 是格式化器基类，用于把对象转换成字符串、或从字符串解析回对象。
+
+在插件环境里更常用的是其具体子类（例如 `NSDateFormatter`、`NSNumberFormatter`）。
+
+## 实例成员 (Instance members)
+
+### `stringForObjectValue`
+
+将对象格式化为字符串。
+
+```javascript
+stringForObjectValue(obj: any): string
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `obj` | `any` | 要格式化的对象。 |
+
+**Return Value:**
+
+- `string`: 格式化后的字符串。
+
+### `editingStringForObjectValue`
+
+用于编辑的字符串表示。
+
+```javascript
+editingStringForObjectValue(obj: any): string
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `obj` | `any` | 对象。 |
+
+**Return Value:**
+
+- `string`: 编辑用字符串。
+
+### `attributedStringForObjectValueWithDefaultAttributes`
+
+格式化为富文本。
+
+```javascript
+attributedStringForObjectValueWithDefaultAttributes(obj: any, attrs: NSDictionary): NSAttributedString
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `obj` | `any` | 对象。 |
+| `attrs` | `NSDictionary` | 默认属性。 |
+
+**Return Value:**
+
+- `NSAttributedString`: 富文本。
+
+### `getObjectValueForStringErrorDescription`
+
+从字符串解析对象。
+
+```javascript
+getObjectValueForStringErrorDescription(obj: any, string: string, error: any): boolean
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `obj` | `any` | 输出参数，接收解析结果。 |
+| `string` | `string` | 源字符串。 |
+| `error` | `any` | 输出参数，接收错误信息。 |
+
+**Return Value:**
+
+- `boolean`: 是否解析成功。
+
+### `isPartialStringValidNewEditingStringErrorDescription`
+
+增量校验（较少用）。
+
+```javascript
+isPartialStringValidNewEditingStringErrorDescription(partialString: string, newString: string, error: any): boolean
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `partialString` | `string` | 当前部分字符串。 |
+| `newString` | `string` | 新编辑字符串。 |
+| `error` | `any` | 输出参数，错误信息。 |
+
+**Return Value:**
+
+- `boolean`: 是否有效。
+
+### `isPartialStringValidProposedSelectedRangeOriginalStringOriginalSelectedRangeErrorDescription`
+
+增量校验（长签名，较少用）。
+
+```javascript
+isPartialStringValidProposedSelectedRangeOriginalStringOriginalSelectedRangeErrorDescription(partialStringPtr: any, proposedSelRangePtr: any, origString: string, origSelRange: any, error: any): boolean
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `partialStringPtr` | `any` | 部分字符串指针。 |
+| `proposedSelRangePtr` | `any` | 提议选区指针。 |
+| `origString` | `string` | 原始字符串。 |
+| `origSelRange` | `any` | 原始选区。 |
+| `error` | `any` | 错误输出。 |
+
+**Return Value:**
+
+- `boolean`: 是否有效。
+
+## 类成员 (Class members)
+
+当前运行时未额外暴露 `NSFormatter` 的类成员。

package/src/content/docs/reference/foundation/ns-hash-table.md

@@ -0,0 +1,304 @@
+---
+title: NSHashTable
+description: 哈希表式集合容器（可配置弱引用/指针语义）。
+---
+
+`NSHashTable` 类似 `NSSet`，但支持自定义指针语义（例如弱引用集合）。在插件中遇到它时，常用操作与集合类似。
+
+## 类成员 (Class members)
+
+### `hashTableWithOptions`
+
+按选项创建哈希表。
+
+```javascript
+static hashTableWithOptions(options: number): NSHashTable
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `options` | `number` | 选项（如弱引用等）。 |
+
+**Return Value:**
+
+- `NSHashTable`: 新实例。
+
+### `weakObjectsHashTable`
+
+弱引用对象哈希表。
+
+```javascript
+static weakObjectsHashTable(): NSHashTable
+```
+
+**Return Value:**
+
+- `NSHashTable`: 新实例。
+
+## 实例成员 (Instance members)
+
+### `count`
+
+元素个数。
+
+```javascript
+count(): number
+```
+
+**Return Value:**
+
+- `number`: 个数。
+
+### `member`
+
+按相等性查找成员。
+
+```javascript
+member(object: any): any
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `object` | `any` | 待查找对象。 |
+
+**Return Value:**
+
+- `any`: 集合中与之相等的对象或 undefined。
+
+### `anyObject`
+
+任取一个元素。
+
+```javascript
+anyObject(): any
+```
+
+**Return Value:**
+
+- `any`: 任一元素或 undefined。
+
+### `containsObject`
+
+是否包含某元素。
+
+```javascript
+containsObject(anObject: any): boolean
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `anObject` | `any` | 待查找元素。 |
+
+**Return Value:**
+
+- `boolean`: 是否包含。
+
+### `allObjects`
+
+所有元素组成的数组。
+
+```javascript
+allObjects(): NSArray
+```
+
+**Return Value:**
+
+- `NSArray`: 元素数组。
+
+### `setRepresentation`
+
+转为 NSSet 表示。
+
+```javascript
+setRepresentation(): NSSet
+```
+
+**Return Value:**
+
+- `NSSet`: 集合表示。
+
+### `pointerFunctions`
+
+指针函数配置。
+
+```javascript
+pointerFunctions(): any
+```
+
+**Return Value:**
+
+- `any`: 指针函数对象。
+
+### `objectEnumerator`
+
+元素枚举器。
+
+```javascript
+objectEnumerator(): NSEnumerator
+```
+
+**Return Value:**
+
+- `NSEnumerator`: 枚举器。
+
+### `addObject`
+
+添加对象。
+
+```javascript
+addObject(object: any): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `object` | `any` | 要添加的对象。 |
+
+**Return Value:**
+
+- 无。
+
+### `removeObject`
+
+移除对象。
+
+```javascript
+removeObject(object: any): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `object` | `any` | 要移除的对象。 |
+
+**Return Value:**
+
+- 无。
+
+### `removeAllObjects`
+
+清空哈希表。
+
+```javascript
+removeAllObjects(): void
+```
+
+**Return Value:**
+
+- 无。
+
+### `intersectsHashTable`
+
+是否与另一哈希表有交集。
+
+```javascript
+intersectsHashTable(other: NSHashTable): boolean
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `other` | `NSHashTable` | 另一哈希表。 |
+
+**Return Value:**
+
+- `boolean`: 是否有交集。
+
+### `isEqualToHashTable`
+
+是否与另一哈希表相等。
+
+```javascript
+isEqualToHashTable(other: NSHashTable): boolean
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `other` | `NSHashTable` | 另一哈希表。 |
+
+**Return Value:**
+
+- `boolean`: 是否相等。
+
+### `isSubsetOfHashTable`
+
+是否为另一哈希表的子集。
+
+```javascript
+isSubsetOfHashTable(other: NSHashTable): boolean
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `other` | `NSHashTable` | 另一哈希表。 |
+
+**Return Value:**
+
+- `boolean`: 是否为子集。
+
+### `intersectHashTable`
+
+与另一哈希表取交集（结果写回自身）。
+
+```javascript
+intersectHashTable(other: NSHashTable): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `other` | `NSHashTable` | 另一哈希表。 |
+
+**Return Value:**
+
+- 无。
+
+### `unionHashTable`
+
+与另一哈希表取并集（结果写回自身）。
+
+```javascript
+unionHashTable(other: NSHashTable): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `other` | `NSHashTable` | 另一哈希表。 |
+
+**Return Value:**
+
+- 无。
+
+### `minusHashTable`
+
+与另一哈希表取差集（结果写回自身）。
+
+```javascript
+minusHashTable(other: NSHashTable): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `other` | `NSHashTable` | 另一哈希表。 |
+
+**Return Value:**
+
+- 无。

package/src/content/docs/reference/foundation/ns-http-url-response.md

@@ -0,0 +1,73 @@
+---
+title: NSHTTPURLResponse
+description: HTTP 响应对象（NSURLResponse 子类），提供 statusCode 与 headerFields。
+---
+
+`NSHTTPURLResponse` 是 `NSURLResponse` 的 HTTP 子类，提供 HTTP 状态码与响应头信息。常见于 `NSURLConnection` 请求回调的 response 参数类型。
+
+## 类成员 (Class members)
+
+### `localizedStringForStatusCode`
+
+返回状态码的本地化描述。
+
+```javascript
+static localizedStringForStatusCode(statusCode: number): string
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `statusCode` | `number` | HTTP 状态码。 |
+
+**Return Value:**
+
+- `string`: 本地化描述。
+
+## 实例成员 (Instance members)
+
+### `initWithURLStatusCodeHTTPVersionHeaderFields`
+
+初始化 HTTP 响应实例。
+
+```javascript
+initWithURLStatusCodeHTTPVersionHeaderFields(url: NSURL, statusCode: number, httpVersion: string, headerFields: NSDictionary): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `url` | `NSURL` | 响应 URL。 |
+| `statusCode` | `number` | HTTP 状态码。 |
+| `httpVersion` | `string` | HTTP 版本。 |
+| `headerFields` | `NSDictionary` | 响应头字典。 |
+
+**Return Value:**
+
+- 无。
+
+### `statusCode`
+
+HTTP 状态码。
+
+```javascript
+statusCode(): number
+```
+
+**Return Value:**
+
+- `number`: 状态码（如 200、404）。
+
+### `allHeaderFields`
+
+所有响应头。
+
+```javascript
+allHeaderFields(): NSDictionary
+```
+
+**Return Value:**
+
+- `NSDictionary`: 头字段字典。

package/src/content/docs/reference/foundation/ns-index-path.md

@@ -0,0 +1,185 @@
+---
+title: NSIndexPath
+description: 索引路径（常用于 Table/Collection 的 section/row/item）。
+---
+
+`NSIndexPath` 表示一个由多个索引组成的“路径”。在 UIKit 里最常见的用法是表示表格/集合视图的 `section` 与 `row/item`。
+
+## 类成员 (Class members)
+
+### `indexPathWithIndex`
+
+从单个索引创建路径。
+
+```javascript
+static indexPathWithIndex(index: number): NSIndexPath
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `index` | `number` | 索引。 |
+
+**Return Value:**
+
+- `NSIndexPath`: 新路径。
+
+### `indexPathWithIndexesLength`
+
+从索引数组与长度创建。
+
+```javascript
+static indexPathWithIndexesLength(indexes: any, length: number): NSIndexPath
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `indexes` | `any` | 索引序列。 |
+| `length` | `number` | 长度。 |
+
+**Return Value:**
+
+- `NSIndexPath`: 新路径。
+
+### `indexPathForRowInSection`
+
+创建 TableView 常用的 row/section 路径。
+
+```javascript
+static indexPathForRowInSection(row: number, section: number): NSIndexPath
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `row` | `number` | 行索引。 |
+| `section` | `number` | 段索引。 |
+
+**Return Value:**
+
+- `NSIndexPath`: 新路径。
+
+### `indexPathForItemInSection`
+
+创建 CollectionView 常用的 item/section 路径。
+
+```javascript
+static indexPathForItemInSection(item: number, section: number): NSIndexPath
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `item` | `number` | 项索引。 |
+| `section` | `number` | 段索引。 |
+
+**Return Value:**
+
+- `NSIndexPath`: 新路径。
+
+## 实例成员 (Instance members)
+
+### `length`
+
+路径中索引个数。
+
+```javascript
+length(): number
+```
+
+**Return Value:**
+
+- `number`: 索引个数。
+
+### `indexAtPosition`
+
+取指定位置的索引。
+
+```javascript
+indexAtPosition(position: number): number
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `position` | `number` | 位置。 |
+
+**Return Value:**
+
+- `number`: 该位置索引。
+
+### `getIndexes`
+
+将索引写入 C 数组。
+
+```javascript
+getIndexes(indexes: any): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `indexes` | `any` | 目标数组。 |
+
+**Return Value:**
+
+- 无。
+
+### `compare`
+
+与另一路径比较。
+
+```javascript
+compare(otherObject: NSIndexPath): number
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `otherObject` | `NSIndexPath` | 另一路径。 |
+
+**Return Value:**
+
+- `number`: 比较结果。
+
+### `indexPathByAddingIndex`
+
+在末尾追加索引得到新路径。
+
+```javascript
+indexPathByAddingIndex(index: number): NSIndexPath
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `index` | `number` | 要追加的索引。 |
+
+**Return Value:**
+
+- `NSIndexPath`: 新路径。
+
+### `indexPathByRemovingLastIndex`
+
+移除最后一个索引得到新路径。
+
+```javascript
+indexPathByRemovingLastIndex(): NSIndexPath
+```
+
+**Return Value:**
+
+- `NSIndexPath`: 新路径。
+
+## 相关
+
+- UIKit：`UITableView` / `UICollectionView`（待补齐）