mn-docs-mcp 0.1.0

package/src/content/docs/reference/utility/sqlite-result-set.md

@@ -0,0 +1,266 @@
+---
+title: SQLiteResultSet
+description: SQLite 查询结果集（JSBSQLiteResultSet），用于逐行读取列值。
+---
+
+`SQLiteResultSet` 是查询结果集对象，支持 `next()` 迭代与按列名/列索引读取数据。
+
+## 实例成员 (Instance members)
+
+### 属性
+
+| 属性 | 类型 | 说明 |
+| :--- | :--- | :--- |
+| `query` | `string` | 查询 SQL。 |
+| `columnNameToIndexMap` | `object` | 列名到索引的映射。 |
+| `statement` | `SQLiteStatement` | 关联的语句对象。 |
+
+### `next`
+
+移动到下一行。
+
+```javascript
+next(): boolean
+```
+
+**Return Value:**
+
+- `boolean`: 是否有下一行。
+
+### `nextWithError`
+
+移动到下一行并接收错误。
+
+```javascript
+nextWithError(outErr: any): boolean
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `outErr` | `any` | 输出参数，接收错误。 |
+
+**Return Value:**
+
+- `boolean`: 是否有下一行。
+
+### `hasAnotherRow`
+
+是否还有下一行。
+
+```javascript
+hasAnotherRow(): boolean
+```
+
+**Return Value:**
+
+- `boolean`: 是否还有行。
+
+### `columnCount`
+
+列数。
+
+```javascript
+columnCount(): number
+```
+
+**Return Value:**
+
+- `number`: 列数。
+
+### `columnIndexForName`
+
+列名对应的索引。
+
+```javascript
+columnIndexForName(name: string): number
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `name` | `string` | 列名。 |
+
+**Return Value:**
+
+- `number`: 列索引。
+
+### `columnNameForIndex`
+
+索引对应的列名。
+
+```javascript
+columnNameForIndex(index: number): string
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `index` | `number` | 列索引。 |
+
+**Return Value:**
+
+- `string`: 列名。
+
+### `intForColumn`
+
+按列名取 int。
+
+```javascript
+intForColumn(name: string): number
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `name` | `string` | 列名。 |
+
+**Return Value:**
+
+- `number`: 整数值。
+
+### `longForColumn`
+
+按列名取 long。
+
+```javascript
+longForColumn(name: string): number
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `name` | `string` | 列名。 |
+
+**Return Value:**
+
+- `number`: 长整值。
+
+### `doubleForColumn`
+
+按列名取 double。
+
+```javascript
+doubleForColumn(name: string): number
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `name` | `string` | 列名。 |
+
+**Return Value:**
+
+- `number`: 双精度值。
+
+### `stringForColumn`
+
+按列名取 string。
+
+```javascript
+stringForColumn(name: string): string
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `name` | `string` | 列名。 |
+
+**Return Value:**
+
+- `string`: 字符串值。
+
+### `dataForColumn`
+
+按列名取 NSData。
+
+```javascript
+dataForColumn(name: string): NSData
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `name` | `string` | 列名。 |
+
+**Return Value:**
+
+- `NSData`: 数据值。
+
+### `dateForColumn`
+
+按列名取日期。
+
+```javascript
+dateForColumn(name: string): NSDate
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `name` | `string` | 列名。 |
+
+**Return Value:**
+
+- `NSDate`: 日期值。
+
+### `objectForKeyedSubscript`
+
+按列名取值（下标访问）。
+
+```javascript
+objectForKeyedSubscript(name: string): any
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `name` | `string` | 列名。 |
+
+**Return Value:**
+
+- `any`: 列值。
+
+### `objectAtIndexedSubscript`
+
+按列索引取值（下标访问）。
+
+```javascript
+objectAtIndexedSubscript(index: number): any
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `index` | `number` | 列索引。 |
+
+**Return Value:**
+
+- `any`: 列值。
+
+### `resultDictionary`
+
+当前行转为字典（列名→值）。
+
+```javascript
+resultDictionary(): NSDictionary
+```
+
+**Return Value:**
+
+- `NSDictionary`: 当前行字典。
+
+## 类成员 (Class members)
+
+当前运行时未额外暴露 `SQLiteResultSet` 的类成员。

package/src/content/docs/reference/utility/sqlite-statement.md

@@ -0,0 +1,44 @@
+---
+title: SQLiteStatement
+description: SQLite 语句对象（JSBSQLiteStatement），用于缓存/复用预编译语句。
+---
+
+`SQLiteStatement` 表示一个 SQLite 语句对象，通常由 SQLite 库内部管理与缓存。
+
+## 实例成员 (Instance members)
+
+### 属性
+
+| 属性 | 类型 | 说明 |
+| :--- | :--- | :--- |
+| `useCount` | `number` | 使用次数。 |
+| `query` | `string` | 查询 SQL。 |
+| `inUse` | `boolean` | 是否正在使用。 |
+
+### `close`
+
+关闭语句并释放资源。
+
+```javascript
+close(): void
+```
+
+**Return Value:**
+
+- 无。
+
+### `reset`
+
+重置语句以便再次执行。
+
+```javascript
+reset(): void
+```
+
+**Return Value:**
+
+- 无。
+
+## 类成员 (Class members)
+
+当前运行时未额外暴露 `SQLiteStatement` 的类成员。

package/src/content/docs/reference/utility/undo-manager.md

@@ -0,0 +1,89 @@
+---
+title: UndoManager
+description: 撤销管理，修改笔记数据时应用 undoGrouping 以支持撤销并刷新界面。
+---
+
+修改笔记/笔记本数据时，应使用 `undoGrouping(actionName, topicid, block)` 包裹修改逻辑，以便支持撤销并在块执行后刷新界面。通过 `UndoManager.sharedInstance()` 获取（类型为 JSBUndoManager）。
+
+## 类成员 (Class members)
+
+### `sharedInstance`
+
+获取全局 UndoManager。
+
+```javascript
+static sharedInstance(): JSBUndoManager
+```
+
+**Return Value:**
+
+- `JSBUndoManager`: 单例对象。
+
+## 实例成员 (Instance members)
+
+### 方法
+
+### `undoGrouping`
+
+在指定笔记本下执行 block，作为一次可撤销操作；执行后界面会刷新。
+
+```javascript
+undoGrouping(actionName: string, topicid: string, block: () => void): void
+```
+
+**Parameters:**
+
+| Name | Type | Description |
+| :--- | :--- | :--- |
+| `actionName` | `string` | 操作名称（显示在撤销菜单中）。 |
+| `topicid` | `string` | 笔记本 ID (`inNotebook`)。 |
+| `block` | `() => void` | 执行修改逻辑的回调函数。 |
+
+### `undo`
+
+执行撤销。
+
+```javascript
+undo(): void
+```
+
+### `redo`
+
+执行重做。
+
+```javascript
+redo(): void
+```
+
+### `canUndo`
+
+是否可撤销。
+
+```javascript
+canUndo(): boolean
+```
+
+### `canRedo`
+
+是否可重做。
+
+```javascript
+canRedo(): boolean
+```
+
+### `clearAll`
+
+清空撤销栈。
+
+```javascript
+clearAll(): void
+```
+
+## 使用示例
+
+修改笔记标题时，先取笔记本 ID（如 note.notebookId），再在 block 内修改 note.noteTitle，块外可调用 `Application.sharedInstance().refreshAfterDBChanged(topicid)`（若需）。
+
+## 相关
+
+- [Database](/reference/global/database/)、[MbBookNote](/reference/marginnote/mb-book-note/)
+- [教程：笔记与数据库](/guides/notes-and-database/)

package/src/content/docs/reference/utility/zip-archive.md

@@ -0,0 +1,29 @@
+---
+title: ZipArchive
+description: 压缩与解压 ZIP 文件（JSBSSZipArchive）。
+---
+
+协议名为 JSBSSZipArchive，用于 ZIP 的创建与解压。
+
+## 类成员 (Class members)
+
+| 方法 | 参数 | 返回值 | 说明 |
+|------|------|--------|------|
+| `unzipFileAtPathToDestination(path, destination)` | path, destination: string | boolean | 解压到目录。 |
+| `unzipFileAtPathToDestinationOverwritePassword(path, destination, overwrite, password)` | path, destination, overwrite: boolean, password: string | boolean | 解压并可覆盖、带密码。 |
+| `createZipFileAtPathWithFilesAtPaths(path, filenames)` | path: string, filenames: NSArray | boolean | 将多个文件打包为 ZIP。 |
+| `createZipFileAtPathWithContentsOfDirectory(path, directoryPath)` | path, directoryPath: string | boolean | 将目录打包为 ZIP。 |
+
+## 实例成员 (Instance members)
+
+| 方法 | 说明 |
+|------|------|
+| `initWithPath(path)` | 创建实例，path 为 ZIP 路径。 |
+| `open()` | 打开准备写入。 |
+| `writeFile(path)` | 写入文件。 |
+| `writeDataFilename(data, filename)` | 写入 NSData 并指定文件名。 |
+| `close()` | 关闭。 |
+
+## 相关
+
+- [NSFileManager](/reference/foundation/ns-file-manager/)

package/src/content.config.ts

@@ -0,0 +1,7 @@
+import { defineCollection } from 'astro:content';
+import { docsLoader } from '@astrojs/starlight/loaders';
+import { docsSchema } from '@astrojs/starlight/schema';
+
+export const collections = {
+	docs: defineCollection({ loader: docsLoader(), schema: docsSchema() }),
+};

package/src/definitions/Foundation/JSBFoundation.h

@@ -0,0 +1,9 @@
+@import Foundation;
+
+@class JSContext;
+
+@interface JSBFoundation : NSObject
+
++ (void)addScriptingSupportToContext:(JSContext *)context;
+
+@end