mn-docs-mcp 0.1.0

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

@@ -0,0 +1,586 @@
+---
+title: NSSet
+description: 不可变无序集合（集合/去重容器）。
+---
+
+`NSSet` 是不可变集合，适合表示“去重后的元素集合”。在插件环境中，你会在很多 API 里见到它（例如返回一组对象、或用于 membership 判断）。
+
+## 类成员 (Class members)
+
+### `set`
+
+返回空集合。
+
+```javascript
+static set(): NSSet
+```
+
+**Return Value:**
+
+- `NSSet`: 空集合实例。
+
+### `setWithObject`
+
+从单个元素创建集合。
+
+```javascript
+static setWithObject(object: any): NSSet
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `object` | `any` | 唯一元素。 |
+
+**Return Value:**
+
+- `NSSet`: 新集合。
+
+### `setWithObjectsCount`
+
+从 C 数组与长度创建。
+
+```javascript
+static setWithObjectsCount(objects: any, cnt: number): NSSet
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `objects` | `any` | 元素序列。 |
+| `cnt` | `number` | 元素个数。 |
+
+**Return Value:**
+
+- `NSSet`: 新集合。
+
+### `setWithObjects`
+
+从可变参数创建集合。
+
+```javascript
+static setWithObjects(firstObj: any, ...args: any[]): NSSet
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `firstObj` | `any` | 第一个元素。 |
+| `...args` | `any[]` | 其余元素。 |
+
+**Return Value:**
+
+- `NSSet`: 新集合。
+
+### `setWithSet`
+
+从已有集合拷贝创建。
+
+```javascript
+static setWithSet(set: NSSet): NSSet
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `set` | `NSSet` | 源集合。 |
+
+**Return Value:**
+
+- `NSSet`: 新集合。
+
+### `setWithArray`
+
+从数组创建集合（去重）。
+
+```javascript
+static setWithArray(array: NSArray): NSSet
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `array` | `NSArray` | 源数组。 |
+
+**Return Value:**
+
+- `NSSet`: 新集合。
+
+## 实例成员 (Instance members)
+
+### `count`
+
+元素个数。
+
+```javascript
+count(): number
+```
+
+**Return Value:**
+
+- `number`: 集合大小。
+
+### `member`
+
+按相等性查找成员（返回相等对象或 undefined）。
+
+```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`: 元素数组。
+
+### `sortedArrayUsingDescriptors`
+
+按排序描述符排序得到数组。
+
+```javascript
+sortedArrayUsingDescriptors(sortDescriptors: NSArray): NSArray
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `sortDescriptors` | `NSArray` | 排序描述符数组。 |
+
+**Return Value:**
+
+- `NSArray`: 排序后的数组。
+
+### `filteredSetUsingPredicate`
+
+按谓词过滤得到新集合。
+
+```javascript
+filteredSetUsingPredicate(predicate: NSPredicate): NSSet
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `predicate` | `NSPredicate` | 谓词。 |
+
+**Return Value:**
+
+- `NSSet`: 过滤后的新集合。
+
+### `isEqualToSet`
+
+是否与另一集合内容相等。
+
+```javascript
+isEqualToSet(otherSet: NSSet): boolean
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `otherSet` | `NSSet` | 另一集合。 |
+
+**Return Value:**
+
+- `boolean`: 是否相等。
+
+### `intersectsSet`
+
+是否与另一集合有交集。
+
+```javascript
+intersectsSet(otherSet: NSSet): boolean
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `otherSet` | `NSSet` | 另一集合。 |
+
+**Return Value:**
+
+- `boolean`: 是否有交集。
+
+### `isSubsetOfSet`
+
+是否为另一集合的子集。
+
+```javascript
+isSubsetOfSet(otherSet: NSSet): boolean
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `otherSet` | `NSSet` | 另一集合。 |
+
+**Return Value:**
+
+- `boolean`: 是否为子集。
+
+### `setByAddingObject`
+
+添加一个元素得到新集合。
+
+```javascript
+setByAddingObject(anObject: any): NSSet
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `anObject` | `any` | 要添加的元素。 |
+
+**Return Value:**
+
+- `NSSet`: 新集合。
+
+### `setByAddingObjectsFromSet`
+
+与另一集合的并集。
+
+```javascript
+setByAddingObjectsFromSet(other: NSSet): NSSet
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `other` | `NSSet` | 另一集合。 |
+
+**Return Value:**
+
+- `NSSet`: 新集合。
+
+### `setByAddingObjectsFromArray`
+
+与数组的并集。
+
+```javascript
+setByAddingObjectsFromArray(other: NSArray): NSSet
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `other` | `NSArray` | 数组。 |
+
+**Return Value:**
+
+- `NSSet`: 新集合。
+
+### `objectEnumerator`
+
+元素枚举器。
+
+```javascript
+objectEnumerator(): NSEnumerator
+```
+
+**Return Value:**
+
+- `NSEnumerator`: 枚举器。
+
+### `enumerateObjectsUsingBlock`
+
+用 block 遍历元素。
+
+```javascript
+enumerateObjectsUsingBlock(block: (obj: any, stop: any) => void): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `block` | `(obj, stop) => void` | 每元素调用的回调。 |
+
+**Return Value:**
+
+- 无。
+
+### `enumerateObjectsWithOptionsUsingBlock`
+
+带选项的遍历。
+
+```javascript
+enumerateObjectsWithOptionsUsingBlock(opts: number, block: (obj: any, stop: any) => void): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `opts` | `number` | 枚举选项。 |
+| `block` | `(obj, stop) => void` | 回调。 |
+
+**Return Value:**
+
+- 无。
+
+### `objectsPassingTest`
+
+通过测试的元素组成的新集合。
+
+```javascript
+objectsPassingTest(predicate: (obj: any, stop: any) => boolean): NSSet
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `predicate` | `(obj, stop) => boolean` | 测试函数。 |
+
+**Return Value:**
+
+- `NSSet`: 新集合。
+
+### `objectsWithOptionsPassingTest`
+
+带选项的过滤。
+
+```javascript
+objectsWithOptionsPassingTest(opts: number, predicate: (obj: any, stop: any) => boolean): NSSet
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `opts` | `number` | 枚举选项。 |
+| `predicate` | `(obj, stop) => boolean` | 测试函数。 |
+
+**Return Value:**
+
+- `NSSet`: 新集合。
+
+### `valueForKey`
+
+KVC 取值。
+
+```javascript
+valueForKey(key: string): any
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `key` | `string` | 键路径。 |
+
+**Return Value:**
+
+- `any`: 值。
+
+### `setValueForKey`
+
+KVC 设值（可变集合上常用）。
+
+```javascript
+setValueForKey(value: any, key: string): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `value` | `any` | 值。 |
+| `key` | `string` | 键路径。 |
+
+**Return Value:**
+
+- 无。
+
+### `addObserverForKeyPathOptionsContext`
+
+添加 KVO 观察。
+
+```javascript
+addObserverForKeyPathOptionsContext(observer: any, keyPath: string, options: number, context: any): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `observer` | `any` | 观察者。 |
+| `keyPath` | `string` | 键路径。 |
+| `options` | `number` | 观察选项。 |
+| `context` | `any` | 上下文。 |
+
+**Return Value:**
+
+- 无。
+
+### `removeObserverForKeyPathContext`
+
+移除 KVO 观察。
+
+```javascript
+removeObserverForKeyPathContext(observer: any, keyPath: string, context: any): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `observer` | `any` | 观察者。 |
+| `keyPath` | `string` | 键路径。 |
+| `context` | `any` | 上下文。 |
+
+**Return Value:**
+
+- 无。
+
+### `removeObserverForKeyPath`
+
+移除 KVO 观察（无 context）。
+
+```javascript
+removeObserverForKeyPath(observer: any, keyPath: string): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `observer` | `any` | 观察者。 |
+| `keyPath` | `string` | 键路径。 |
+
+**Return Value:**
+
+- 无。
+
+### `makeObjectsPerformSelector`
+
+对每个元素调用 selector。
+
+```javascript
+makeObjectsPerformSelector(aSelector: any): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `aSelector` | `any` | 要调用的 selector。 |
+
+**Return Value:**
+
+- 无。
+
+### `makeObjectsPerformSelectorWithObject`
+
+对每个元素调用带参 selector。
+
+```javascript
+makeObjectsPerformSelectorWithObject(aSelector: any, argument: any): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `aSelector` | `any` | 要调用的 selector。 |
+| `argument` | `any` | 参数。 |
+
+**Return Value:**
+
+- 无。
+
+### `description`
+
+返回集合的字符串描述。
+
+```javascript
+description(): string
+```
+
+**Return Value:**
+
+- `string`: 描述字符串。
+
+### `descriptionWithLocale`
+
+按 locale 返回描述。
+
+```javascript
+descriptionWithLocale(locale: any): string
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `locale` | `any` | locale。 |
+
+**Return Value:**
+
+- `string`: 描述字符串。
+
+## 相关
+
+- `NSMutableSet` — 可变集合
+- [NSArray](/reference/foundation/ns-array/)
+- [NSEnumerator](/reference/foundation/ns-enumerator/)

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

@@ -0,0 +1,20 @@
+---
+title: NSSimpleCString
+description: 内部字符串类型（可当作 NSString 使用）。
+---
+
+`NSSimpleCString` 是一种内部字符串类型。在插件环境中你通常**不需要关心它本身**：它按“字符串”语义工作，可当作 `NSString`/JS 字符串的等价载体来使用。
+
+## 实例成员 (Instance members)
+
+`NSSimpleCString` 可当作普通字符串使用，不需要调用其上的专属成员。
+
+## 类成员 (Class members)
+
+当前运行时未额外暴露 `NSSimpleCString` 的类成员。
+
+## 说明
+
+- **没有额外可调用成员**：它不额外暴露独有方法/属性。
+- **使用建议**：把它当作普通字符串传递/拼接/比较即可。
+

package/src/content/docs/reference/foundation/ns-time-zone.md

@@ -0,0 +1,86 @@
+---
+title: NSTimeZone
+description: 时区对象。
+---
+
+`NSTimeZone` 表示时区信息，通常与 `NSDateFormatter` 配合使用。
+
+## 类成员 (Class members)
+
+### `systemTimeZone`
+
+系统时区。
+
+```javascript
+static systemTimeZone(): NSTimeZone
+```
+
+**Return Value:**
+
+- `NSTimeZone`: 系统时区实例。
+
+### `localTimeZone`
+
+本地时区。
+
+```javascript
+static localTimeZone(): NSTimeZone
+```
+
+**Return Value:**
+
+- `NSTimeZone`: 本地时区实例。
+
+### `timeZoneWithName`
+
+从时区名创建。
+
+```javascript
+static timeZoneWithName(name: string): NSTimeZone
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `name` | `string` | 时区名（如 "Asia/Shanghai"）。 |
+
+**Return Value:**
+
+- `NSTimeZone`: 新时区实例。
+
+## 实例成员 (Instance members)
+
+### `name`
+
+时区名称。
+
+```javascript
+name(): string
+```
+
+**Return Value:**
+
+- `string`: 时区名。
+
+### `secondsFromGMTForDate`
+
+某日期在该时区相对 GMT 的秒数偏移。
+
+```javascript
+secondsFromGMTForDate(date: NSDate): number
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `date` | `NSDate` | 日期。 |
+
+**Return Value:**
+
+- `number`: 秒数偏移。
+
+## 相关
+
+- [NSDateFormatter](/reference/foundation/ns-date-formatter/)

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

@@ -0,0 +1,24 @@
+---
+title: NSTimer
+description: 定时器，延迟执行或周期执行回调。
+---
+
+用于延迟执行或重复执行一段代码。JS 侧通过 `scheduledTimerWithTimeInterval(ti, repeats, block)` 创建，block 接收 timer 参数。
+
+## 类成员 (Class members)
+
+| 方法 | 参数 | 返回值 | 说明 |
+|------|------|--------|------|
+| `scheduledTimerWithTimeInterval(ti, repeats, block)` | ti: number（秒）, repeats: boolean, block: (timer) => void | NSTimer | 创建并调度定时器；repeats 为 false 时只执行一次。 |
+
+## 实例成员 (Instance members)
+
+| 方法 | 说明 |
+|------|------|
+| `invalidate()` | 使定时器失效，停止触发。 |
+| `fire()` | 立即触发一次。 |
+| `isValid` | 是否仍有效。 |
+
+## 相关
+
+- 常用于在 `notebookWillOpen` 后延迟 0.2 秒再挂载 UI，以确保 studyController 已就绪。