mn-docs-mcp 0.1.0

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

@@ -0,0 +1,436 @@
+---
+title: NSCharacterSet
+description: 字符集合（用于字符串过滤、扫描、拆分等）。
+---
+
+`NSCharacterSet` 表示一组字符的集合，常用于字符串扫描/过滤/拆分等场景。
+
+## 类成员 (Class members)
+
+### 常用预置集合
+
+### `controlCharacterSet`
+
+控制字符集。
+
+```javascript
+static controlCharacterSet(): NSCharacterSet
+```
+
+**Return Value:**
+
+- `NSCharacterSet`: 预置集合。
+
+### `whitespaceCharacterSet`
+
+空白字符集。
+
+```javascript
+static whitespaceCharacterSet(): NSCharacterSet
+```
+
+**Return Value:**
+
+- `NSCharacterSet`: 预置集合。
+
+### `whitespaceAndNewlineCharacterSet`
+
+空白与换行字符集。
+
+```javascript
+static whitespaceAndNewlineCharacterSet(): NSCharacterSet
+```
+
+**Return Value:**
+
+- `NSCharacterSet`: 预置集合。
+
+### `newlineCharacterSet`
+
+换行字符集。
+
+```javascript
+static newlineCharacterSet(): NSCharacterSet
+```
+
+**Return Value:**
+
+- `NSCharacterSet`: 预置集合。
+
+### `decimalDigitCharacterSet`
+
+十进制数字字符集。
+
+```javascript
+static decimalDigitCharacterSet(): NSCharacterSet
+```
+
+**Return Value:**
+
+- `NSCharacterSet`: 预置集合。
+
+### `letterCharacterSet`
+
+字母字符集。
+
+```javascript
+static letterCharacterSet(): NSCharacterSet
+```
+
+**Return Value:**
+
+- `NSCharacterSet`: 预置集合。
+
+### `lowercaseLetterCharacterSet`
+
+小写字母字符集。
+
+```javascript
+static lowercaseLetterCharacterSet(): NSCharacterSet
+```
+
+**Return Value:**
+
+- `NSCharacterSet`: 预置集合。
+
+### `uppercaseLetterCharacterSet`
+
+大写字母字符集。
+
+```javascript
+static uppercaseLetterCharacterSet(): NSCharacterSet
+```
+
+**Return Value:**
+
+- `NSCharacterSet`: 预置集合。
+
+### `capitalizedLetterCharacterSet`
+
+首字母大写字符集。
+
+```javascript
+static capitalizedLetterCharacterSet(): NSCharacterSet
+```
+
+**Return Value:**
+
+- `NSCharacterSet`: 预置集合。
+
+### `alphanumericCharacterSet`
+
+字母数字字符集。
+
+```javascript
+static alphanumericCharacterSet(): NSCharacterSet
+```
+
+**Return Value:**
+
+- `NSCharacterSet`: 预置集合。
+
+### `nonBaseCharacterSet`
+
+非基础字符集。
+
+```javascript
+static nonBaseCharacterSet(): NSCharacterSet
+```
+
+**Return Value:**
+
+- `NSCharacterSet`: 预置集合。
+
+### `decomposableCharacterSet`
+
+可分解字符集。
+
+```javascript
+static decomposableCharacterSet(): NSCharacterSet
+```
+
+**Return Value:**
+
+- `NSCharacterSet`: 预置集合。
+
+### `illegalCharacterSet`
+
+非法字符集。
+
+```javascript
+static illegalCharacterSet(): NSCharacterSet
+```
+
+**Return Value:**
+
+- `NSCharacterSet`: 预置集合。
+
+### `punctuationCharacterSet`
+
+标点字符集。
+
+```javascript
+static punctuationCharacterSet(): NSCharacterSet
+```
+
+**Return Value:**
+
+- `NSCharacterSet`: 预置集合。
+
+### `symbolCharacterSet`
+
+符号字符集。
+
+```javascript
+static symbolCharacterSet(): NSCharacterSet
+```
+
+**Return Value:**
+
+- `NSCharacterSet`: 预置集合。
+
+### URL 相关预置集合
+
+### `URLUserAllowedCharacterSet`
+
+URL 用户部分允许字符集。
+
+```javascript
+static URLUserAllowedCharacterSet(): NSCharacterSet
+```
+
+**Return Value:**
+
+- `NSCharacterSet`: 预置集合。
+
+### `URLPasswordAllowedCharacterSet`
+
+URL 密码部分允许字符集。
+
+```javascript
+static URLPasswordAllowedCharacterSet(): NSCharacterSet
+```
+
+**Return Value:**
+
+- `NSCharacterSet`: 预置集合。
+
+### `URLHostAllowedCharacterSet`
+
+URL 主机部分允许字符集。
+
+```javascript
+static URLHostAllowedCharacterSet(): NSCharacterSet
+```
+
+**Return Value:**
+
+- `NSCharacterSet`: 预置集合。
+
+### `URLPathAllowedCharacterSet`
+
+URL 路径部分允许字符集。
+
+```javascript
+static URLPathAllowedCharacterSet(): NSCharacterSet
+```
+
+**Return Value:**
+
+- `NSCharacterSet`: 预置集合。
+
+### `URLQueryAllowedCharacterSet`
+
+URL 查询部分允许字符集。
+
+```javascript
+static URLQueryAllowedCharacterSet(): NSCharacterSet
+```
+
+**Return Value:**
+
+- `NSCharacterSet`: 预置集合。
+
+### `URLFragmentAllowedCharacterSet`
+
+URL 片段部分允许字符集。
+
+```javascript
+static URLFragmentAllowedCharacterSet(): NSCharacterSet
+```
+
+**Return Value:**
+
+- `NSCharacterSet`: 预置集合。
+
+### 创建
+
+### `characterSetWithRange`
+
+从 Unicode 范围创建。
+
+```javascript
+static characterSetWithRange(aRange: any): NSCharacterSet
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `aRange` | `any` | 范围（如 { location, length }）。 |
+
+**Return Value:**
+
+- `NSCharacterSet`: 新实例。
+
+### `characterSetWithCharactersInString`
+
+从字符串中的字符创建。
+
+```javascript
+static characterSetWithCharactersInString(aString: string): NSCharacterSet
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `aString` | `string` | 字符来源字符串。 |
+
+**Return Value:**
+
+- `NSCharacterSet`: 新实例。
+
+### `characterSetWithBitmapRepresentation`
+
+从位图数据创建。
+
+```javascript
+static characterSetWithBitmapRepresentation(data: NSData): NSCharacterSet
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `data` | `NSData` | 位图数据。 |
+
+**Return Value:**
+
+- `NSCharacterSet`: 新实例。
+
+### `characterSetWithContentsOfFile`
+
+从文件内容创建。
+
+```javascript
+static characterSetWithContentsOfFile(fName: string): NSCharacterSet
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `fName` | `string` | 文件路径。 |
+
+**Return Value:**
+
+- `NSCharacterSet`: 新实例。
+
+## 实例成员 (Instance members)
+
+### `characterIsMember`
+
+某字符是否在集合中。
+
+```javascript
+characterIsMember(aCharacter: number): boolean
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `aCharacter` | `number` | Unicode 码点。 |
+
+**Return Value:**
+
+- `boolean`: 是否在集合中。
+
+### `longCharacterIsMember`
+
+某长字符（如 surrogate pair）是否在集合中。
+
+```javascript
+longCharacterIsMember(theLongChar: number): boolean
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `theLongChar` | `number` | 长字符码点。 |
+
+**Return Value:**
+
+- `boolean`: 是否在集合中。
+
+### `isSupersetOfSet`
+
+是否包含另一字符集的所有字符。
+
+```javascript
+isSupersetOfSet(other: NSCharacterSet): boolean
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `other` | `NSCharacterSet` | 另一字符集。 |
+
+**Return Value:**
+
+- `boolean`: 是否为超集。
+
+### `hasMemberInPlane`
+
+指定 plane 是否有成员。
+
+```javascript
+hasMemberInPlane(thePlane: number): boolean
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `thePlane` | `number` | Unicode plane。 |
+
+**Return Value:**
+
+- `boolean`: 是否有成员。
+
+### `bitmapRepresentation`
+
+位图表示。
+
+```javascript
+bitmapRepresentation(): NSData
+```
+
+**Return Value:**
+
+- `NSData`: 位图数据。
+
+### `invertedSet`
+
+取反字符集（不在当前集合中的字符）。
+
+```javascript
+invertedSet(): NSCharacterSet
+```
+
+**Return Value:**
+
+- `NSCharacterSet`: 取反后的新字符集。

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

@@ -0,0 +1,78 @@
+---
+title: NSCountedSet
+description: 计数集合（记录每个对象出现次数）。
+---
+
+`NSCountedSet` 是“带计数”的集合：相同对象可以被多次加入，并可以查询某个对象出现的次数。
+
+## 实例成员 (Instance members)
+
+### `countForObject`
+
+返回某对象在集合中的出现次数。
+
+```javascript
+countForObject(object: any): number
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `object` | `any` | 要查询的对象。 |
+
+**Return Value:**
+
+- `number`: 出现次数。
+
+### `objectEnumerator`
+
+元素枚举器。
+
+```javascript
+objectEnumerator(): NSEnumerator
+```
+
+**Return Value:**
+
+- `NSEnumerator`: 枚举器（每个元素只出现一次）。
+
+### `addObject`
+
+将对象加入集合（计数加一）。
+
+```javascript
+addObject(object: any): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `object` | `any` | 要加入的对象。 |
+
+**Return Value:**
+
+- 无。
+
+### `removeObject`
+
+将对象从集合中移除一次（计数减一，为 0 时移除）。
+
+```javascript
+removeObject(object: any): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `object` | `any` | 要移除的对象。 |
+
+**Return Value:**
+
+- 无。
+
+## 类成员 (Class members)
+
+当前运行时未额外暴露 `NSCountedSet` 的类成员。

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

@@ -0,0 +1,183 @@
+---
+title: NSData
+description: 二进制数据对象，用于读写文件、字符串编码、网络等。
+---
+
+用于表示二进制数据。常用创建方式：从文件/URL 读取、从字符串编码、从字节。编码常用值：4 表示 UTF-8（NSUTF8StringEncoding）。
+
+## 类成员 (Class members)
+
+### `data`
+
+返回空数据。
+
+```javascript
+static data(): NSData
+```
+
+**Return Value:**
+
+- `NSData`: 空数据实例。
+
+### `dataWithStringEncoding`
+
+从字符串与编码创建。
+
+```javascript
+static dataWithStringEncoding(string: string, encoding: number): NSData
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `string` | `string` | 源字符串。 |
+| `encoding` | `number` | 编码（4 为 UTF-8）。 |
+
+**Return Value:**
+
+- `NSData`: 新数据。
+
+### `dataWithContentsOfFile`
+
+从文件路径读取。
+
+```javascript
+static dataWithContentsOfFile(path: string): NSData
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `path` | `string` | 文件路径。 |
+
+**Return Value:**
+
+- `NSData`: 新数据。
+
+### `dataWithContentsOfURL`
+
+从 URL 读取。
+
+```javascript
+static dataWithContentsOfURL(url: NSURL): NSData
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `url` | `NSURL` | 资源 URL。 |
+
+**Return Value:**
+
+- `NSData`: 新数据。
+
+### `dataWithBytesLength`
+
+从字节与长度创建。
+
+```javascript
+static dataWithBytesLength(bytes: any, length: number): NSData
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `bytes` | `any` | 字节序列。 |
+| `length` | `number` | 长度。 |
+
+**Return Value:**
+
+- `NSData`: 新数据。
+
+### `dataWithData`
+
+拷贝数据。
+
+```javascript
+static dataWithData(data: NSData): NSData
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `data` | `NSData` | 源数据。 |
+
+**Return Value:**
+
+- `NSData`: 新数据。
+
+## 实例成员 (Instance members)
+
+### 属性
+
+| 属性 | 类型 | 说明 |
+| :--- | :--- | :--- |
+| `length` | `number` | 字节数。 |
+| `bytes` | 只读 | 原始字节。 |
+| `base64Encoding` | `string` | Base64 编码字符串。 |
+
+### `writeToFileAtomically`
+
+写入文件。
+
+```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`: 是否成功。
+
+### `subdataWithRange`
+
+取子数据。
+
+```javascript
+subdataWithRange(range: any): NSData
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `range` | `any` | 范围（如 { location, length }）。 |
+
+**Return Value:**
+
+- `NSData`: 子数据。
+
+## 相关
+
+- [NSFileManager](/reference/foundation/ns-file-manager/)、[NSURL](/reference/foundation/ns-url/)
+- [教程：存储与文件](/guides/storage-and-files/)

package/src/content/docs/reference/foundation/ns-date-components.md

@@ -0,0 +1,24 @@
+---
+title: NSDateComponents
+description: 日期组成部分（年/月/日/时/分/秒等）。
+---
+
+`NSDateComponents` 用于表示日期的组成部分（年/月/日/时/分/秒等）。通常与 `NSCalendar`（如可用）配合用于构造/分解日期。
+
+## 实例成员 (Instance members)
+
+### 常用属性
+
+- `year` / `month` / `day`
+- `hour` / `minute` / `second`
+- `weekday` / `weekdayOrdinal`
+- `weekOfYear` / `weekOfMonth`
+
+## 类成员 (Class members)
+
+当前运行时未额外暴露 `NSDateComponents` 的类成员。
+
+## 相关
+
+- [NSDate](/reference/foundation/ns-date/)
+