mn-docs-mcp 0.1.0

package/src/content/docs/reference/foundation/ns-pointer-array.md

@@ -0,0 +1,192 @@
+---
+title: NSPointerArray
+description: 指针数组（可配置强/弱引用语义）。
+---
+
+`NSPointerArray` 是“指针数组”容器，允许存放对象指针或空洞，并支持强/弱语义（例如 `weakObjectsPointerArray()`）。在插件里通常把它当成“特殊数组”来用。
+
+## 类成员 (Class members)
+
+### `strongObjectsPointerArray`
+
+创建强引用指针数组。
+
+```javascript
+static strongObjectsPointerArray(): NSPointerArray
+```
+
+**Return Value:**
+
+- `NSPointerArray`: 新实例。
+
+### `weakObjectsPointerArray`
+
+创建弱引用指针数组。
+
+```javascript
+static weakObjectsPointerArray(): NSPointerArray
+```
+
+**Return Value:**
+
+- `NSPointerArray`: 新实例。
+
+## 实例成员 (Instance members)
+
+### `count`
+
+元素个数。
+
+```javascript
+count(): number
+```
+
+**Return Value:**
+
+- `number`: 个数。
+
+### `setCount`
+
+设置元素个数。
+
+```javascript
+setCount(count: number): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `count` | `number` | 新个数。 |
+
+**Return Value:**
+
+- 无。
+
+### `pointerAtIndex`
+
+取指定索引的指针。
+
+```javascript
+pointerAtIndex(index: number): any
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `index` | `number` | 索引。 |
+
+**Return Value:**
+
+- `any`: 指针或 null。
+
+### `addPointer`
+
+在末尾添加指针。
+
+```javascript
+addPointer(pointer: any): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `pointer` | `any` | 要添加的指针。 |
+
+**Return Value:**
+
+- 无。
+
+### `removePointerAtIndex`
+
+移除指定索引的指针。
+
+```javascript
+removePointerAtIndex(index: number): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `index` | `number` | 索引。 |
+
+**Return Value:**
+
+- 无。
+
+### `insertPointerAtIndex`
+
+在指定索引插入指针。
+
+```javascript
+insertPointerAtIndex(item: any, index: number): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `item` | `any` | 指针。 |
+| `index` | `number` | 索引。 |
+
+**Return Value:**
+
+- 无。
+
+### `replacePointerAtIndexWithPointer`
+
+替换指定索引的指针。
+
+```javascript
+replacePointerAtIndexWithPointer(index: number, item: any): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `index` | `number` | 索引。 |
+| `item` | `any` | 新指针。 |
+
+**Return Value:**
+
+- 无。
+
+### `compact`
+
+移除空洞，压缩数组。
+
+```javascript
+compact(): void
+```
+
+**Return Value:**
+
+- 无。
+
+### `allObjects`
+
+所有非空指针组成的数组。
+
+```javascript
+allObjects(): NSArray
+```
+
+**Return Value:**
+
+- `NSArray`: 对象数组。
+
+### `pointerFunctions`
+
+指针函数配置。
+
+```javascript
+pointerFunctions(): any
+```
+
+**Return Value:**
+
+- `any`: 指针函数对象。

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

@@ -0,0 +1,199 @@
+---
+title: NSPredicate
+description: 谓词（用于过滤/测试对象，常与集合筛选配合）。
+---
+
+`NSPredicate` 用于描述一个过滤/判断条件。你会在很多“过滤/筛选”API 中遇到它（例如 `filteredSetUsingPredicate`、`filterUsingPredicate`、`filteredOrderedSetUsingPredicate` 等）。
+
+## 类成员 (Class members)
+
+### `predicateWithFormat`
+
+从格式字符串创建谓词。
+
+```javascript
+static predicateWithFormat(predicateFormat: string): NSPredicate
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `predicateFormat` | `string` | 谓词格式（如 "age > 18"）。 |
+
+**Return Value:**
+
+- `NSPredicate`: 新谓词实例。
+
+### `predicateWithFormatArgumentArray`
+
+从格式与参数数组创建。
+
+```javascript
+static predicateWithFormatArgumentArray(predicateFormat: string, arguments: NSArray): NSPredicate
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `predicateFormat` | `string` | 谓词格式。 |
+| `arguments` | `NSArray` | 参数数组。 |
+
+**Return Value:**
+
+- `NSPredicate`: 新谓词实例。
+
+### `predicateWithFormatArguments`
+
+从格式与可变参数创建。
+
+```javascript
+static predicateWithFormatArguments(predicateFormat: string, argList: any): NSPredicate
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `predicateFormat` | `string` | 谓词格式。 |
+| `argList` | `any` | 参数列表。 |
+
+**Return Value:**
+
+- `NSPredicate`: 新谓词实例。
+
+### `predicateFromMetadataQueryString`
+
+从元数据查询字符串创建。
+
+```javascript
+static predicateFromMetadataQueryString(queryString: string): NSPredicate
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `queryString` | `string` | 查询字符串。 |
+
+**Return Value:**
+
+- `NSPredicate`: 新谓词实例。
+
+### `predicateWithValue`
+
+创建恒真/恒假谓词。
+
+```javascript
+static predicateWithValue(value: boolean): NSPredicate
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `value` | `boolean` | true 为恒真，false 为恒假。 |
+
+**Return Value:**
+
+- `NSPredicate`: 新谓词实例。
+
+### `predicateWithBlock`
+
+从 block 创建谓词。
+
+```javascript
+static predicateWithBlock(block: (object: any, bindings: any) => boolean): NSPredicate
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `block` | `(object, bindings) => boolean` | 对每个对象调用的判断块。 |
+
+**Return Value:**
+
+- `NSPredicate`: 新谓词实例。
+
+## 实例成员 (Instance members)
+
+### `predicateFormat`
+
+谓词格式字符串。
+
+```javascript
+predicateFormat(): string
+```
+
+**Return Value:**
+
+- `string`: 格式字符串。
+
+### `predicateWithSubstitutionVariables`
+
+用变量绑定生成新谓词。
+
+```javascript
+predicateWithSubstitutionVariables(variables: NSDictionary): NSPredicate
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `variables` | `NSDictionary` | 变量名到值的映射。 |
+
+**Return Value:**
+
+- `NSPredicate`: 新谓词实例。
+
+### `evaluateWithObject`
+
+对对象求值。
+
+```javascript
+evaluateWithObject(object: any): boolean
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `object` | `any` | 要测试的对象。 |
+
+**Return Value:**
+
+- `boolean`: 是否满足谓词。
+
+### `evaluateWithObjectSubstitutionVariables`
+
+对对象与变量绑定求值。
+
+```javascript
+evaluateWithObjectSubstitutionVariables(object: any, bindings: NSDictionary): boolean
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `object` | `any` | 要测试的对象。 |
+| `bindings` | `NSDictionary` | 变量绑定。 |
+
+**Return Value:**
+
+- `boolean`: 是否满足谓词。
+
+### `allowEvaluation`
+
+允许求值（安全相关，较少直接调用）。
+
+```javascript
+allowEvaluation(): void
+```
+
+**Return Value:**
+
+- 无。

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

@@ -0,0 +1,178 @@
+---
+title: NSProxy
+description: 代理基类（消息转发基础设施）。
+---
+
+`NSProxy` 是 Objective‑C 世界里的代理基类。在插件环境中，你一般不会直接创建它，但可能会在调试/反射/桥接场景里遇到它的基础方法。
+
+## 类成员 (Class members)
+
+### `alloc`
+
+分配实例。
+
+```javascript
+static alloc(): NSProxy
+```
+
+**Return Value:**
+
+- `NSProxy`: 新实例。
+
+### `allocWithZone`
+
+在指定 zone 分配。
+
+```javascript
+static allocWithZone(zone: any): NSProxy
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `zone` | `any` | 内存 zone。 |
+
+**Return Value:**
+
+- `NSProxy`: 新实例。
+
+### `class`
+
+类对象。
+
+```javascript
+static class(): any
+```
+
+**Return Value:**
+
+- `any`: 类对象。
+
+## 实例成员 (Instance members)
+
+### `respondsToSelector`
+
+是否响应某 selector。
+
+```javascript
+respondsToSelector(aSelector: any): boolean
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `aSelector` | `any` | selector。 |
+
+**Return Value:**
+
+- `boolean`: 是否响应。
+
+### `methodSignatureForSelector`
+
+某 selector 的方法签名。
+
+```javascript
+methodSignatureForSelector(sel: any): any
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `sel` | `any` | selector。 |
+
+**Return Value:**
+
+- `any`: 方法签名。
+
+### `forwardInvocation`
+
+转发调用。
+
+```javascript
+forwardInvocation(invocation: any): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `invocation` | `any` | 调用对象。 |
+
+**Return Value:**
+
+- 无。
+
+### `dealloc`
+
+析构（通常不直接调用）。
+
+```javascript
+dealloc(): void
+```
+
+**Return Value:**
+
+- 无。
+
+### `finalize`
+
+终结（通常不直接调用）。
+
+```javascript
+finalize(): void
+```
+
+**Return Value:**
+
+- 无。
+
+### `description`
+
+对象描述。
+
+```javascript
+description(): string
+```
+
+**Return Value:**
+
+- `string`: 描述字符串。
+
+### `debugDescription`
+
+调试描述。
+
+```javascript
+debugDescription(): string
+```
+
+**Return Value:**
+
+- `string`: 调试描述字符串。
+
+### `allowsWeakReference`
+
+是否允许弱引用。
+
+```javascript
+allowsWeakReference(): boolean
+```
+
+**Return Value:**
+
+- `boolean`: 是否允许。
+
+### `retainWeakReference`
+
+保留弱引用。
+
+```javascript
+retainWeakReference(): boolean
+```
+
+**Return Value:**
+
+- `boolean`: 是否成功保留。