mn-docs-mcp 0.1.0

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

@@ -0,0 +1,80 @@
+---
+title: NSURLComponents
+description: URL 组件化读写（scheme/host/path/query 等）。
+---
+
+`NSURLComponents` 用于把 URL 拆分为可读写的组件（scheme/host/path/query 等），或由组件组装回 URL。
+
+## 类成员 (Class members)
+
+### `componentsWithURLResolvingAgainstBaseURL`
+
+从 URL 创建，可选相对 base 解析。
+
+```javascript
+static componentsWithURLResolvingAgainstBaseURL(url: NSURL, resolve: boolean): NSURLComponents
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `url` | `NSURL` | 源 URL。 |
+| `resolve` | `boolean` | 是否相对 base 解析。 |
+
+**Return Value:**
+
+- `NSURLComponents`: 新实例。
+
+### `componentsWithString`
+
+从 URL 字符串创建。
+
+```javascript
+static componentsWithString(urlString: string): NSURLComponents
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `urlString` | `string` | URL 字符串。 |
+
+**Return Value:**
+
+- `NSURLComponents`: 新实例。
+
+## 实例成员 (Instance members)
+
+### 属性
+
+| 属性 | 类型 | 说明 |
+| :--- | :--- | :--- |
+| `scheme` | `string` | 协议（如 https）。 |
+| `user` | `string` | 用户部分。 |
+| `password` | `string` | 密码部分。 |
+| `host` | `string` | 主机。 |
+| `port` | `number` | 端口。 |
+| `path` | `string` | 路径。 |
+| `query` | `string` | 查询串。 |
+| `fragment` | `string` | 片段。 |
+
+### `URL`
+
+组装为 NSURL。
+
+```javascript
+URL(): NSURL
+```
+
+**Return Value:**
+
+- `NSURL`: 当前组件对应的 URL。
+
+### `URLRelativeToURL`
+
+基于 baseURL 组装 URL（相对 base）。
+
+```javascript
+URLRelativeToURL(baseURL: NSURL): NSURL
+```

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

@@ -0,0 +1,169 @@
+---
+title: NSURLConnection
+description: 插件环境中唯一导出的网络请求类（deprecated，但可用）。
+---
+
+完整用法见 [网络请求](/guides/network-requests/) 教程。
+
+`NSURLConnection` 是插件环境中导出的网络请求类（头文件标注为 deprecated，但在当前接口里仍可用）。它通常与 `NSURLRequest`/`NSMutableURLRequest`、`NSOperationQueue`、`NSData`、`NSError`、`NSHTTPURLResponse` 配合使用。
+
+## 类成员 (Class members)
+
+### `connectionWithRequestDelegate`
+
+创建连接并设置 delegate。
+
+```javascript
+static connectionWithRequestDelegate(request: NSURLRequest, delegate: any): NSURLConnection
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `request` | `NSURLRequest` | 请求对象。 |
+| `delegate` | `any` | 委托对象（实现 delegate 回调）。 |
+
+**Return Value:**
+
+- `NSURLConnection`: 新连接实例。
+
+### `canHandleRequest`
+
+是否可处理该请求。
+
+```javascript
+static canHandleRequest(request: NSURLRequest): boolean
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `request` | `NSURLRequest` | 请求对象。 |
+
+**Return Value:**
+
+- `boolean`: 是否可处理。
+
+### `sendSynchronousRequestReturningResponseError`
+
+同步发送请求。
+
+```javascript
+static sendSynchronousRequestReturningResponseError(request: NSURLRequest, response: any, error: any): NSData
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `request` | `NSURLRequest` | 请求对象。 |
+| `response` | `any` | 输出参数，接收响应对象。 |
+| `error` | `any` | 输出参数，接收错误对象。 |
+
+**Return Value:**
+
+- `NSData`: 响应数据，失败时为 null/undefined。
+
+### `sendAsynchronousRequestQueueCompletionHandler`
+
+异步发送请求。
+
+```javascript
+static sendAsynchronousRequestQueueCompletionHandler(request: NSURLRequest, queue: NSOperationQueue, completionHandler: (response: any, data: NSData, error: NSError) => void): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `request` | `NSURLRequest` | 请求对象。 |
+| `queue` | `NSOperationQueue` | 完成回调所在队列。 |
+| `completionHandler` | `(response, data, error) => void` | 完成回调。 |
+
+**Return Value:**
+
+- 无。
+
+## 实例成员 (Instance members)
+
+### `originalRequest`
+
+原始请求。
+
+```javascript
+originalRequest(): NSURLRequest
+```
+
+**Return Value:**
+
+- `NSURLRequest`: 原始请求。
+
+### `currentRequest`
+
+当前请求（可能经重定向等变更）。
+
+```javascript
+currentRequest(): NSURLRequest
+```
+
+**Return Value:**
+
+- `NSURLRequest`: 当前请求。
+
+### `start`
+
+开始连接。
+
+```javascript
+start(): void
+```
+
+**Return Value:**
+
+- 无。
+
+### `cancel`
+
+取消连接。
+
+```javascript
+cancel(): void
+```
+
+**Return Value:**
+
+- 无。
+
+### `setDelegateQueue`
+
+设置 delegate 回调所在队列。
+
+```javascript
+setDelegateQueue(queue: NSOperationQueue): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `queue` | `NSOperationQueue` | 队列。 |
+
+**Return Value:**
+
+- 无。
+
+### Delegate 回调
+
+将插件对象作为 delegate 传入时，可实现对应回调方法接收数据流与生命周期事件（如 `connectionDidReceiveResponse`、`connectionDidReceiveData`、`connectionDidFinishLoading`、`connectionDidFailWithError` 等）。
+
+## 相关
+
+- [网络请求](/guides/network-requests/) —— 完整 GET/POST 示例
+- [NSURLRequest](/reference/foundation/ns-url-request/)
+- [NSMutableURLRequest](/reference/foundation/ns-mutable-url-request/)
+- [NSOperationQueue](/reference/foundation/ns-operation-queue/)
+- [NSData](/reference/foundation/ns-data/)
+- [NSError](/reference/foundation/ns-error/)
+- [NSHTTPURLResponse](/reference/foundation/ns-http-url-response/)

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

@@ -0,0 +1,224 @@
+---
+title: NSURLRequest
+description: 不可变 URL 请求对象，包含 URL、缓存策略、HTTP header/body 等只读访问。
+---
+
+`NSURLRequest` 表示一个不可变的 URL 请求。通常在插件里用于读取请求信息，或作为 `NSMutableURLRequest` 的父接口使用。
+
+## 类成员 (Class members)
+
+### `requestWithURL`
+
+从 URL 创建请求。
+
+```javascript
+static requestWithURL(URL: NSURL): NSURLRequest
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `URL` | `NSURL` | 请求 URL。 |
+
+**Return Value:**
+
+- `NSURLRequest`: 新请求实例。
+
+### `requestWithURLCachePolicyTimeoutInterval`
+
+从 URL、缓存策略与超时创建请求。
+
+```javascript
+static requestWithURLCachePolicyTimeoutInterval(URL: NSURL, cachePolicy: number, timeoutInterval: number): NSURLRequest
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `URL` | `NSURL` | 请求 URL。 |
+| `cachePolicy` | `number` | 缓存策略。 |
+| `timeoutInterval` | `number` | 超时时间（秒）。 |
+
+**Return Value:**
+
+- `NSURLRequest`: 新请求实例。
+
+### `supportsSecureCoding`
+
+是否支持安全编码。
+
+```javascript
+static supportsSecureCoding(): boolean
+```
+
+**Return Value:**
+
+- `boolean`: 是否支持。
+
+## 实例成员 (Instance members)
+
+### `URL`
+
+请求 URL。
+
+```javascript
+URL(): NSURL
+```
+
+**Return Value:**
+
+- `NSURL`: 请求 URL。
+
+### `cachePolicy`
+
+缓存策略。
+
+```javascript
+cachePolicy(): number
+```
+
+**Return Value:**
+
+- `number`: 缓存策略。
+
+### `timeoutInterval`
+
+超时时间（秒）。
+
+```javascript
+timeoutInterval(): number
+```
+
+**Return Value:**
+
+- `number`: 超时时间。
+
+### `mainDocumentURL`
+
+主文档 URL。
+
+```javascript
+mainDocumentURL(): NSURL
+```
+
+**Return Value:**
+
+- `NSURL`: 主文档 URL。
+
+### `networkServiceType`
+
+网络服务类型。
+
+```javascript
+networkServiceType(): number
+```
+
+**Return Value:**
+
+- `number`: 服务类型。
+
+### `allowsCellularAccess`
+
+是否允许蜂窝网络。
+
+```javascript
+allowsCellularAccess(): boolean
+```
+
+**Return Value:**
+
+- `boolean`: 是否允许。
+
+### `HTTPMethod`
+
+HTTP 方法（如 GET、POST）。
+
+```javascript
+HTTPMethod(): string
+```
+
+**Return Value:**
+
+- `string`: 方法名。
+
+### `allHTTPHeaderFields`
+
+所有 HTTP 头。
+
+```javascript
+allHTTPHeaderFields(): NSDictionary
+```
+
+**Return Value:**
+
+- `NSDictionary`: 头字段字典。
+
+### `valueForHTTPHeaderField`
+
+指定头字段值。
+
+```javascript
+valueForHTTPHeaderField(field: string): string
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `field` | `string` | 头字段名。 |
+
+**Return Value:**
+
+- `string`: 头字段值。
+
+### `HTTPBody`
+
+请求体数据。
+
+```javascript
+HTTPBody(): NSData
+```
+
+**Return Value:**
+
+- `NSData`: 请求体。
+
+### `HTTPBodyStream`
+
+请求体流。
+
+```javascript
+HTTPBodyStream(): any
+```
+
+**Return Value:**
+
+- `any`: 流对象。
+
+### `HTTPShouldHandleCookies`
+
+是否自动处理 Cookie。
+
+```javascript
+HTTPShouldHandleCookies(): boolean
+```
+
+**Return Value:**
+
+- `boolean`: 是否处理。
+
+### `HTTPShouldUsePipelining`
+
+是否使用 HTTP 管道。
+
+```javascript
+HTTPShouldUsePipelining(): boolean
+```
+
+**Return Value:**
+
+- `boolean`: 是否使用。
+
+> 建议：需要设置 method/header/body 等可变字段时，直接使用 [NSMutableURLRequest](/reference/foundation/ns-mutable-url-request/)。

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

@@ -0,0 +1,97 @@
+---
+title: NSURLResponse
+description: URL 响应对象，包含 MIMEType、编码、建议文件名等元信息。
+---
+
+`NSURLResponse` 是 URL 请求的响应对象基类。HTTP 响应通常会是其子类 `NSHTTPURLResponse`。
+
+## 实例成员 (Instance members)
+
+### `initWithURLMIMETypeExpectedContentLengthTextEncodingName`
+
+初始化响应实例。
+
+```javascript
+initWithURLMIMETypeExpectedContentLengthTextEncodingName(url: NSURL, mimeType: string, length: number, name: string): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `url` | `NSURL` | 响应 URL。 |
+| `mimeType` | `string` | MIME 类型。 |
+| `length` | `number` | 预期内容长度。 |
+| `name` | `string` | 文本编码名。 |
+
+**Return Value:**
+
+- 无。
+
+### `URL`
+
+响应 URL。
+
+```javascript
+URL(): NSURL
+```
+
+**Return Value:**
+
+- `NSURL`: 响应 URL。
+
+### `MIMEType`
+
+MIME 类型。
+
+```javascript
+MIMEType(): string
+```
+
+**Return Value:**
+
+- `string`: MIME 类型。
+
+### `expectedContentLength`
+
+预期内容长度（字节）。
+
+```javascript
+expectedContentLength(): number
+```
+
+**Return Value:**
+
+- `number`: 长度。
+
+### `textEncodingName`
+
+文本编码名。
+
+```javascript
+textEncodingName(): string
+```
+
+**Return Value:**
+
+- `string`: 编码名。
+
+### `suggestedFilename`
+
+建议保存文件名。
+
+```javascript
+suggestedFilename(): string
+```
+
+**Return Value:**
+
+- `string`: 建议文件名。
+
+## 类成员 (Class members)
+
+当前运行时未额外暴露 `NSURLResponse` 的类成员。
+
+## 相关
+
+- [NSHTTPURLResponse](/reference/foundation/ns-http-url-response/)

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

@@ -0,0 +1,31 @@
+---
+title: NSURL
+description: URL 对象，用于网页、文件路径与 Application.openURL。
+---
+
+用于表示 URL（网页或本地文件路径）。可通过 `Application.sharedInstance().openURL(url)` 打开网页或 App URL Scheme。
+
+## 类成员 (Class members)
+
+### 创建
+
+| 方法 | 参数 | 返回值 | 说明 |
+|------|------|--------|------|
+| `URLWithString(URLString)` | URLString: string | NSURL | 从字符串创建（如 "https://..."）。 |
+| `URLWithStringRelativeToURL(URLString, baseURL)` | URLString, baseURL | NSURL | 相对 URL。 |
+| `fileURLWithPath(path)` | path: string | NSURL | 从文件路径创建。 |
+| `fileURLWithPathIsDirectory(path, isDir)` | path: string, isDir: boolean | NSURL | 文件 URL，可指定是否目录。 |
+
+## 实例成员 (Instance members)
+
+### 属性（常用）
+
+| 属性 | 类型 | 说明 |
+|------|------|------|
+| `path` | string | 路径部分。 |
+| `absoluteString` | string | 完整 URL 字符串。 |
+| `host` / `scheme` / `query` / `fragment` | string | URL 组成部分。 |
+
+## 相关
+
+- [Application.openURL](/reference/global/application/)