@webgal/language-service 0.0.2-alpha.5 → 0.0.3-alpha.0

package/README.en.md

@@ -0,0 +1,15 @@
+# @webgal/language-service
+
+English | [中文](./README.md) 
+
+WebGAL language service integration package, providing capabilities such as Monaco initialization, syntax and theme resources, VFS, and client processors.
+
+## Install
+
+```bash
+npm i @webgal/language-service
+```
+
+## Repository
+
+https://github.com/xiaoxustudio/webgal-language-tools/tree/main/packages/language-service

package/README.md

@@ -0,0 +1,15 @@
+# @webgal/language-service
+
+[English](./README.en.md) | 中文
+
+WebGAL 语言服务集成包，提供 Monaco 初始化、语法与主题资源、VFS 与客户端处理器等能力。
+
+## 安装
+
+```bash
+npm i @webgal/language-service
+```
+
+## 仓库
+
+https://github.com/xiaoxustudio/webgal-language-tools/tree/main/packages/language-service

package/build/{client-handlers-niazfK9_.mjs → client-handlers--qNaay52.mjs}

@@ -1,4 +1,4 @@
-import { t as getState } from "./providerState-DrFcJbqe.mjs";
+import { t as getState } from "./providerState-_ZvKXErw.mjs";
 import { FileType } from "@volar/language-service";
 import { URI } from "vscode-uri";
 
@@ -33,6 +33,12 @@ const toVfsPath = (value) => value.startsWith("file://") ? uriToPath(value) : va
 
 //#endregion
 //#region src/vfs/adapter.ts
+/**
+* 创建虚拟文件系统适配器
+* 将Volar可写文件系统封装为统一的虚拟文件系统接口
+* @param fs - Volar可写文件系统实例
+* @returns 返回虚拟文件系统实例，提供文件读写、目录操作等功能
+*/
 function createVirtualFileSystem(fs) {
 	const root = fs.root;
 	return {
@@ -116,6 +122,14 @@ function createVirtualFileSystem(fs) {
 		onDidChange: (listener) => fs.onDidChange(listener)
 	};
 }
+/**
+* 创建Volar文件系统适配器
+* 将虚拟文件系统封装为Volar语言服务所需的FileSystem接口
+* @param vfs - 虚拟文件系统实例
+* @param options - 配置选项
+* @param options.uriToPath - 可选的URI到路径的转换函数，默认使用内置的转换函数
+* @returns 返回符合Volar FileSystem接口的文件系统实例
+*/
 function createVolarFileSystem(vfs, options) {
 	const uriToPathImpl = options?.uriToPath ?? ((uri) => uriToPath(uri));
 	return {
@@ -145,6 +159,14 @@ function createVolarFileSystem(vfs, options) {
 
 //#endregion
 //#region src/vfs/memory.ts
+/**
+* 创建基于内存的Volar可写文件系统
+* 该文件系统将所有文件和目录存储在内存中，不持久化到磁盘
+* @param options - 配置选项
+* @param options.root - 根目录路径，默认为"/"
+* @param options.tree - 可选的初始虚拟文件树结构
+* @returns 返回Volar可写文件系统实例，支持文件读写、目录操作和变更监听
+*/
 function createMemoryVolarFileSystem(options) {
 	const root = normalizePath(toVfsPath(options?.root ?? "/"));
 	let rootEntry = options?.tree && options.tree.type === "dir" ? options.tree : {
@@ -298,6 +320,12 @@ function createMemoryVolarFileSystem(options) {
 
 //#endregion
 //#region src/client-handlers.ts
+/**
+* 创建Webgal客户端处理器
+*
+* @param options - 创建处理器的配置选项
+* @returns 返回一个包含各种客户端处理器方法的对象
+*/
 function createWebgalClientHandlers(options) {
 	const normalizeChange = (change) => {
 		if (change.type === "writeFile") return {
@@ -324,7 +352,10 @@ function createWebgalClientHandlers(options) {
 		"workspace/documentLink/refresh": () => null,
 		"client/showTip": options.showTip ?? (() => null),
 		"client/currentDirectory": () => options.vfs.currentDirectory(),
-		"client/FJoin": (args) => options.vfs.join(...Array.isArray(args) ? args : [args]),
+		"client/FJoin": (args) => {
+			const parts = Array.isArray(args) ? args : [args];
+			return options.vfs.join(...parts.map(toVfsPath));
+		},
 		"client/FStat": (path) => options.vfs.stat(toVfsPath(path)),
 		"client/findFile": ([startPath, targetName]) => options.vfs.findFile(toVfsPath(startPath), targetName),
 		"client/goPropertyDoc": options.goPropertyDoc ?? ((path) => getState(path)),
@@ -342,6 +373,12 @@ function createWebgalClientHandlers(options) {
 		...options.overrides ?? {}
 	};
 }
+/**
+* 注册WebGal客户端处理器
+*
+* @param client - 语言客户端实例，实现了LanguageClientLike接口
+* @param handlers - WebGal客户端处理器的可选映射对象，包含要注册的各种处理器方法
+*/
 function registerWebgalClientHandlers(client, handlers) {
 	for (const [method, handler] of Object.entries(handlers)) client.onRequest(method, handler);
 }

package/build/{client-handlers-B-uz20CX.cjs → client-handlers-bQ116UIT.cjs}

@@ -1,5 +1,5 @@
 const require_chunk = require('./chunk-C0xms8kb.cjs');
-const require_providerState = require('./providerState-Du_Ge3bW.cjs');
+const require_providerState = require('./providerState-Dip2XHx4.cjs');
 let _volar_language_service = require("@volar/language-service");
 let vscode_uri = require("vscode-uri");
 
@@ -34,6 +34,12 @@ const toVfsPath = (value) => value.startsWith("file://") ? uriToPath(value) : va
 
 //#endregion
 //#region src/vfs/adapter.ts
+/**
+* 创建虚拟文件系统适配器
+* 将Volar可写文件系统封装为统一的虚拟文件系统接口
+* @param fs - Volar可写文件系统实例
+* @returns 返回虚拟文件系统实例，提供文件读写、目录操作等功能
+*/
 function createVirtualFileSystem(fs) {
 	const root = fs.root;
 	return {
@@ -117,6 +123,14 @@ function createVirtualFileSystem(fs) {
 		onDidChange: (listener) => fs.onDidChange(listener)
 	};
 }
+/**
+* 创建Volar文件系统适配器
+* 将虚拟文件系统封装为Volar语言服务所需的FileSystem接口
+* @param vfs - 虚拟文件系统实例
+* @param options - 配置选项
+* @param options.uriToPath - 可选的URI到路径的转换函数，默认使用内置的转换函数
+* @returns 返回符合Volar FileSystem接口的文件系统实例
+*/
 function createVolarFileSystem(vfs, options) {
 	const uriToPathImpl = options?.uriToPath ?? ((uri) => uriToPath(uri));
 	return {
@@ -146,6 +160,14 @@ function createVolarFileSystem(vfs, options) {
 
 //#endregion
 //#region src/vfs/memory.ts
+/**
+* 创建基于内存的Volar可写文件系统
+* 该文件系统将所有文件和目录存储在内存中，不持久化到磁盘
+* @param options - 配置选项
+* @param options.root - 根目录路径，默认为"/"
+* @param options.tree - 可选的初始虚拟文件树结构
+* @returns 返回Volar可写文件系统实例，支持文件读写、目录操作和变更监听
+*/
 function createMemoryVolarFileSystem(options) {
 	const root = normalizePath(toVfsPath(options?.root ?? "/"));
 	let rootEntry = options?.tree && options.tree.type === "dir" ? options.tree : {
@@ -299,6 +321,12 @@ function createMemoryVolarFileSystem(options) {
 
 //#endregion
 //#region src/client-handlers.ts
+/**
+* 创建Webgal客户端处理器
+*
+* @param options - 创建处理器的配置选项
+* @returns 返回一个包含各种客户端处理器方法的对象
+*/
 function createWebgalClientHandlers(options) {
 	const normalizeChange = (change) => {
 		if (change.type === "writeFile") return {
@@ -325,7 +353,10 @@ function createWebgalClientHandlers(options) {
 		"workspace/documentLink/refresh": () => null,
 		"client/showTip": options.showTip ?? (() => null),
 		"client/currentDirectory": () => options.vfs.currentDirectory(),
-		"client/FJoin": (args) => options.vfs.join(...Array.isArray(args) ? args : [args]),
+		"client/FJoin": (args) => {
+			const parts = Array.isArray(args) ? args : [args];
+			return options.vfs.join(...parts.map(toVfsPath));
+		},
 		"client/FStat": (path) => options.vfs.stat(toVfsPath(path)),
 		"client/findFile": ([startPath, targetName]) => options.vfs.findFile(toVfsPath(startPath), targetName),
 		"client/goPropertyDoc": options.goPropertyDoc ?? ((path) => require_providerState.getState(path)),
@@ -343,6 +374,12 @@ function createWebgalClientHandlers(options) {
 		...options.overrides ?? {}
 	};
 }
+/**
+* 注册WebGal客户端处理器
+*
+* @param client - 语言客户端实例，实现了LanguageClientLike接口
+* @param handlers - WebGal客户端处理器的可选映射对象，包含要注册的各种处理器方法
+*/
 function registerWebgalClientHandlers(client, handlers) {
 	for (const [method, handler] of Object.entries(handlers)) client.onRequest(method, handler);
 }

package/build/index-Bbu_H5AG.d.mts

@@ -0,0 +1,46 @@
+import { c as VirtualFileSystem, d as VolarWritableFileSystem, o as VirtualEntry } from "./types-B7zc-Eke.mjs";
+import { FileSystem } from "@volar/language-service";
+import { URI } from "vscode-uri";
+
+//#region src/vfs/adapter.d.ts
+/**
+ * 创建虚拟文件系统适配器
+ * 将Volar可写文件系统封装为统一的虚拟文件系统接口
+ * @param fs - Volar可写文件系统实例
+ * @returns 返回虚拟文件系统实例，提供文件读写、目录操作等功能
+ */
+declare function createVirtualFileSystem(fs: VolarWritableFileSystem): VirtualFileSystem;
+/**
+ * 创建Volar文件系统适配器
+ * 将虚拟文件系统封装为Volar语言服务所需的FileSystem接口
+ * @param vfs - 虚拟文件系统实例
+ * @param options - 配置选项
+ * @param options.uriToPath - 可选的URI到路径的转换函数，默认使用内置的转换函数
+ * @returns 返回符合Volar FileSystem接口的文件系统实例
+ */
+declare function createVolarFileSystem(vfs: VirtualFileSystem, options?: {
+  uriToPath?: (uri: URI) => string;
+}): FileSystem;
+//#endregion
+//#region src/vfs/memory.d.ts
+/**
+ * 创建基于内存的Volar可写文件系统
+ * 该文件系统将所有文件和目录存储在内存中，不持久化到磁盘
+ * @param options - 配置选项
+ * @param options.root - 根目录路径，默认为"/"
+ * @param options.tree - 可选的初始虚拟文件树结构
+ * @returns 返回Volar可写文件系统实例，支持文件读写、目录操作和变更监听
+ */
+declare function createMemoryVolarFileSystem(options?: {
+  root?: string;
+  tree?: VirtualEntry;
+}): VolarWritableFileSystem;
+//#endregion
+//#region src/vfs/utils.d.ts
+declare const normalizePath: (input: string) => string;
+declare const joinPaths: (...parts: string[]) => string;
+declare const uriToPath: (value: string | URI) => string;
+declare const pathToUri: (path: string) => URI;
+declare const toVfsPath: (value: string) => string;
+//#endregion
+export { uriToPath as a, createVolarFileSystem as c, toVfsPath as i, normalizePath as n, createMemoryVolarFileSystem as o, pathToUri as r, createVirtualFileSystem as s, joinPaths as t };

package/build/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_client_handlers = require('./client-handlers-B-uz20CX.cjs');
+const require_client_handlers = require('./client-handlers-bQ116UIT.cjs');
 
 exports.createMemoryVolarFileSystem = require_client_handlers.createMemoryVolarFileSystem;
 exports.createVirtualFileSystem = require_client_handlers.createVirtualFileSystem;

package/build/index.d.cts

@@ -1,14 +1,36 @@
-import { a as VirtualDirectoryEntry, c as VirtualFileSystem, d as VolarWritableFileSystem, f as WebgalClientHandlers, i as MaybePromise, l as VirtualFileSystemChange, n as DirectoryEntry, o as VirtualEntry, r as LanguageClientLike, s as VirtualFileEntry, t as CreateWebgalClientHandlersOptions, u as VirtualFileSystemChangeListener } from "./types-BPQnQEAd.cjs";
+import { a as VirtualDirectoryEntry, c as VirtualFileSystem, d as VolarWritableFileSystem, f as WebgalClientHandlers, i as MaybePromise, l as VirtualFileSystemChange, n as DirectoryEntry, o as VirtualEntry, r as LanguageClientLike, s as VirtualFileEntry, t as CreateWebgalClientHandlersOptions, u as VirtualFileSystemChangeListener } from "./types-DwRo8Zlp.cjs";
 import { FileSystem } from "@volar/language-service";
 import { URI } from "vscode-uri";
 
 //#region src/vfs/adapter.d.ts
+/**
+ * 创建虚拟文件系统适配器
+ * 将Volar可写文件系统封装为统一的虚拟文件系统接口
+ * @param fs - Volar可写文件系统实例
+ * @returns 返回虚拟文件系统实例，提供文件读写、目录操作等功能
+ */
 declare function createVirtualFileSystem(fs: VolarWritableFileSystem): VirtualFileSystem;
+/**
+ * 创建Volar文件系统适配器
+ * 将虚拟文件系统封装为Volar语言服务所需的FileSystem接口
+ * @param vfs - 虚拟文件系统实例
+ * @param options - 配置选项
+ * @param options.uriToPath - 可选的URI到路径的转换函数，默认使用内置的转换函数
+ * @returns 返回符合Volar FileSystem接口的文件系统实例
+ */
 declare function createVolarFileSystem(vfs: VirtualFileSystem, options?: {
   uriToPath?: (uri: URI) => string;
 }): FileSystem;
 //#endregion
 //#region src/vfs/memory.d.ts
+/**
+ * 创建基于内存的Volar可写文件系统
+ * 该文件系统将所有文件和目录存储在内存中，不持久化到磁盘
+ * @param options - 配置选项
+ * @param options.root - 根目录路径，默认为"/"
+ * @param options.tree - 可选的初始虚拟文件树结构
+ * @returns 返回Volar可写文件系统实例，支持文件读写、目录操作和变更监听
+ */
 declare function createMemoryVolarFileSystem(options?: {
   root?: string;
   tree?: VirtualEntry;
@@ -22,7 +44,19 @@ declare const pathToUri: (path: string) => URI;
 declare const toVfsPath: (value: string) => string;
 //#endregion
 //#region src/client-handlers.d.ts
+/**
+ * 创建Webgal客户端处理器
+ *
+ * @param options - 创建处理器的配置选项
+ * @returns 返回一个包含各种客户端处理器方法的对象
+ */
 declare function createWebgalClientHandlers(options: CreateWebgalClientHandlersOptions): WebgalClientHandlers;
+/**
+ * 注册WebGal客户端处理器
+ *
+ * @param client - 语言客户端实例，实现了LanguageClientLike接口
+ * @param handlers - WebGal客户端处理器的可选映射对象，包含要注册的各种处理器方法
+ */
 declare function registerWebgalClientHandlers(client: LanguageClientLike, handlers: Partial<WebgalClientHandlers>): void;
 //#endregion
 export { CreateWebgalClientHandlersOptions, DirectoryEntry, LanguageClientLike, MaybePromise, VirtualDirectoryEntry, VirtualEntry, VirtualFileEntry, VirtualFileSystem, VirtualFileSystemChange, VirtualFileSystemChangeListener, VolarWritableFileSystem, WebgalClientHandlers, createMemoryVolarFileSystem, createVirtualFileSystem, createVolarFileSystem, createWebgalClientHandlers, joinPaths, normalizePath, pathToUri, registerWebgalClientHandlers, toVfsPath, uriToPath };

package/build/index.d.mts

@@ -1,8 +1,20 @@
-import { a as VirtualDirectoryEntry, c as VirtualFileSystem, d as VolarWritableFileSystem, f as WebgalClientHandlers, i as MaybePromise, l as VirtualFileSystemChange, n as DirectoryEntry, o as VirtualEntry, r as LanguageClientLike, s as VirtualFileEntry, t as CreateWebgalClientHandlersOptions, u as VirtualFileSystemChangeListener } from "./types-CBH-p_Iu.mjs";
-import { a as uriToPath, c as createVolarFileSystem, i as toVfsPath, n as normalizePath, o as createMemoryVolarFileSystem, r as pathToUri, s as createVirtualFileSystem, t as joinPaths } from "./index-BF2WhBpG.mjs";
+import { a as VirtualDirectoryEntry, c as VirtualFileSystem, d as VolarWritableFileSystem, f as WebgalClientHandlers, i as MaybePromise, l as VirtualFileSystemChange, n as DirectoryEntry, o as VirtualEntry, r as LanguageClientLike, s as VirtualFileEntry, t as CreateWebgalClientHandlersOptions, u as VirtualFileSystemChangeListener } from "./types-B7zc-Eke.mjs";
+import { a as uriToPath, c as createVolarFileSystem, i as toVfsPath, n as normalizePath, o as createMemoryVolarFileSystem, r as pathToUri, s as createVirtualFileSystem, t as joinPaths } from "./index-Bbu_H5AG.mjs";
 
 //#region src/client-handlers.d.ts
+/**
+ * 创建Webgal客户端处理器
+ *
+ * @param options - 创建处理器的配置选项
+ * @returns 返回一个包含各种客户端处理器方法的对象
+ */
 declare function createWebgalClientHandlers(options: CreateWebgalClientHandlersOptions): WebgalClientHandlers;
+/**
+ * 注册WebGal客户端处理器
+ *
+ * @param client - 语言客户端实例，实现了LanguageClientLike接口
+ * @param handlers - WebGal客户端处理器的可选映射对象，包含要注册的各种处理器方法
+ */
 declare function registerWebgalClientHandlers(client: LanguageClientLike, handlers: Partial<WebgalClientHandlers>): void;
 //#endregion
 export { CreateWebgalClientHandlersOptions, DirectoryEntry, LanguageClientLike, MaybePromise, VirtualDirectoryEntry, VirtualEntry, VirtualFileEntry, VirtualFileSystem, VirtualFileSystemChange, VirtualFileSystemChangeListener, VolarWritableFileSystem, WebgalClientHandlers, createMemoryVolarFileSystem, createVirtualFileSystem, createVolarFileSystem, createWebgalClientHandlers, joinPaths, normalizePath, pathToUri, registerWebgalClientHandlers, toVfsPath, uriToPath };

package/build/index.mjs

@@ -1,3 +1,3 @@
-import { a as createVolarFileSystem, c as pathToUri, i as createVirtualFileSystem, l as toVfsPath, n as registerWebgalClientHandlers, o as joinPaths, r as createMemoryVolarFileSystem, s as normalizePath, t as createWebgalClientHandlers, u as uriToPath } from "./client-handlers-niazfK9_.mjs";
+import { a as createVolarFileSystem, c as pathToUri, i as createVirtualFileSystem, l as toVfsPath, n as registerWebgalClientHandlers, o as joinPaths, r as createMemoryVolarFileSystem, s as normalizePath, t as createWebgalClientHandlers, u as uriToPath } from "./client-handlers--qNaay52.mjs";
 
 export { createMemoryVolarFileSystem, createVirtualFileSystem, createVolarFileSystem, createWebgalClientHandlers, joinPaths, normalizePath, pathToUri, registerWebgalClientHandlers, toVfsPath, uriToPath };

package/build/{language-configuration-DsFXNyL0.cjs → language-configuration-B87E1z9X.cjs}

@@ -187,10 +187,6 @@ var language_configuration_default = {
 			"close": "`",
 			"notIn": ["string", "comment"]
 		},
-		{
-			"open": ":",
-			"close": ";"
-		},
 		{
 			"open": ";area",
 			"close": ";endarea"

package/build/{language-configuration-BpugOv-W.mjs → language-configuration-DEifwmtM.mjs}

@@ -186,10 +186,6 @@ var language_configuration_default = {
 			"close": "`",
 			"notIn": ["string", "comment"]
 		},
-		{
-			"open": ":",
-			"close": ";"
-		},
 		{
 			"open": ";area",
 			"close": ";endarea"

package/build/monaco/index.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_chunk = require('../chunk-C0xms8kb.cjs');
-const require_client_handlers = require('../client-handlers-B-uz20CX.cjs');
+const require_client_handlers = require('../client-handlers-bQ116UIT.cjs');
 const require_syntaxes = require('../syntaxes.cjs');
 const require_themes = require('../themes.cjs');
 let vscode_ws_jsonrpc = require("vscode-ws-jsonrpc");
@@ -15,11 +15,28 @@ _codingame_monaco_vscode_theme_service_override = require_chunk.__toESM(_codinga
 let _codingame_monaco_vscode_textmate_service_override = require("@codingame/monaco-vscode-textmate-service-override");
 _codingame_monaco_vscode_textmate_service_override = require_chunk.__toESM(_codingame_monaco_vscode_textmate_service_override);
 require("vscode/localExtensionHost");
+let monaco_editor = require("monaco-editor");
+monaco_editor = require_chunk.__toESM(monaco_editor);
 
 //#region src/monaco/monaco.ts
+/**
+* 创建虚拟文件系统
+* @param options - 配置选项
+* @param options.root - 根目录路径，默认为 "file:///"
+* @param options.tree -  可选的虚拟文件树结构
+* @returns 返回一个虚拟文件系统实例
+*/
 function createMemoryFileSystem(options) {
 	return require_client_handlers.createVirtualFileSystem(require_client_handlers.createMemoryVolarFileSystem(options));
 }
+/**
+* 创建WebGAL Monaco语言客户端（WebSocket连接模式）
+* @param options - 配置选项
+* @param options.languageServerUrl - 语言服务器WebSocket URL
+* @param options.editor - Monaco编辑器实例
+* @param options.virtualFileSystem - 可选的虚拟文件系统，未提供时将创建默认的内存文件系统
+* @returns 返回包含WebSocket连接和虚拟文件系统的对象
+*/
 const createWebgalMonacoLanguageClient = (options) => {
 	const { languageServerUrl, editor } = options;
 	const editorInstance = editor;
@@ -47,6 +64,14 @@ const createWebgalMonacoLanguageClient = (options) => {
 		vfs
 	};
 };
+/**
+* 创建WebGAL Monaco语言客户端（Worker模式）
+* @param options - 配置选项
+* @param options.editor - Monaco编辑器实例
+* @param options.worker - Web Worker实例
+* @param options.virtualFileSystem - 可选的虚拟文件系统，未提供时将创建默认的内存文件系统
+* @returns 返回包含Worker实例和虚拟文件系统的对象
+*/
 const createWebgalMonacoLanguageClientWithWorker = (options) => {
 	const { worker, editor } = options;
 	const editorInstance = editor;
@@ -138,6 +163,10 @@ const createLanguageClient = (messageTransports, options) => {
 //#endregion
 //#region src/monaco/monaco-init.ts
 let initPromise = null;
+/**
+* 初始化资源映射对象
+* 包含WebGAL语言服务所需的语法高亮、语言配置和主题等资源
+*/
 const initResources = {
 	"./webgal.tmLanguage.json": require_syntaxes.webgalGrammar,
 	"./webgal-config.tmLanguage.json": require_syntaxes.webgalConfigGrammar,
@@ -145,6 +174,12 @@ const initResources = {
 	"./dark.json": require_themes.webgalDarkTheme,
 	"./white.json": require_themes.webgalWhiteTheme
 };
+/**
+* 初始化WebGAL Monaco编辑器环境
+* 该函数会注册WebGAL语言扩展、语法高亮、主题配置等，并初始化Monaco编辑器的服务
+* 使用单例模式，多次调用只会执行一次初始化
+* @returns Promise<void> 初始化完成的Promise
+*/
 async function initWebgalMonaco() {
 	if (initPromise) return initPromise;
 	initPromise = (async () => {
@@ -197,9 +232,148 @@ async function initWebgalMonaco() {
 	return initPromise;
 }
 
+//#endregion
+//#region src/monaco/workspace.ts
+/**
+* 规范化根URI，将输入的路径或文件URI转换为标准的URI格式
+*
+* @param value - 输入的路径字符串，可以是普通路径或file URI
+* @returns 标准化的URI字符串
+*/
+const normalizeRootUri = (value) => {
+	if (value.startsWith("file://")) return require_client_handlers.pathToUri(require_client_handlers.uriToPath(value)).toString();
+	return require_client_handlers.pathToUri(value).toString();
+};
+/**
+* 创建一个Webgal Monaco工作区实例
+*
+* @param options - 创建工作区所需的配置选项
+* @returns 返回一个包含各种操作方法的WebgalMonacoWorkspace对象
+*/
+const createWebgalMonacoWorkspace = (options) => {
+	const { editor, vfs } = options;
+	const getLanguageFromPath = options.getLanguageFromPath ?? ((path) => path.toLowerCase().endsWith("config.txt") ? "webgal-config" : "webgal");
+	let rootPath = normalizeRootUri(options.rootPath ?? vfs.root);
+	let rootPathForJoin = require_client_handlers.normalizePath(rootPath.startsWith("file://") ? require_client_handlers.uriToPath(rootPath) : rootPath);
+	let activePath = null;
+	let skipWrite = false;
+	const activePathListeners = /* @__PURE__ */ new Set();
+	if (options.onActivePathChange) activePathListeners.add(options.onActivePathChange);
+	const toFileUri = (value) => {
+		const trimmed = value.trim();
+		if (!trimmed) return null;
+		if (trimmed.startsWith("file://")) return require_client_handlers.pathToUri(require_client_handlers.uriToPath(trimmed)).toString();
+		if (trimmed.startsWith("/")) return require_client_handlers.pathToUri(require_client_handlers.normalizePath(trimmed)).toString();
+		return require_client_handlers.pathToUri(require_client_handlers.joinPaths(rootPathForJoin, trimmed)).toString();
+	};
+	const getDisplayPath = (path) => {
+		const normalizedPath = require_client_handlers.normalizePath(path.startsWith("file://") ? require_client_handlers.uriToPath(path) : path);
+		if (normalizedPath === rootPathForJoin) return "";
+		if (normalizedPath.startsWith(`${rootPathForJoin}/`)) return normalizedPath.slice(rootPathForJoin.length + 1);
+		return normalizedPath;
+	};
+	const openFile = async (path) => {
+		const normalizedPath = toFileUri(path);
+		if (!normalizedPath) return false;
+		const content = await vfs.readFile(normalizedPath);
+		if (content === null) return false;
+		const uri = monaco_editor.Uri.parse(normalizedPath);
+		let model = monaco_editor.editor.getModel(uri);
+		if (!model) model = monaco_editor.editor.createModel(content, getLanguageFromPath(normalizedPath), uri);
+		else model.setValue(content);
+		skipWrite = true;
+		editor.setModel(model);
+		skipWrite = false;
+		activePath = normalizedPath;
+		activePathListeners.forEach((listener) => listener(activePath));
+		return true;
+	};
+	const parseFragment = (fragment) => {
+		const trimmed = fragment.trim();
+		if (!trimmed) return null;
+		if (trimmed.includes("=")) {
+			const params = new URLSearchParams(trimmed);
+			const lineValue = params.get("line") ?? params.get("L");
+			const columnValue = params.get("column") ?? params.get("col") ?? params.get("C");
+			const lineNumber = lineValue ? Number(lineValue) : NaN;
+			const column = columnValue ? Number(columnValue) : NaN;
+			if (!Number.isNaN(lineNumber) && lineNumber > 0) return {
+				lineNumber,
+				column: Number.isNaN(column) ? void 0 : column
+			};
+		}
+		const match = trimmed.match(/^L?(\d+)(?:[,.:](\d+))?$/i);
+		if (!match) return null;
+		const lineNumber = Number(match[1]);
+		const column = match[2] ? Number(match[2]) : void 0;
+		if (Number.isNaN(lineNumber) || lineNumber <= 0) return null;
+		return {
+			lineNumber,
+			column
+		};
+	};
+	const openExternalLink = (uri) => {
+		const scheme = uri.scheme.toLowerCase();
+		if (scheme !== "http" && scheme !== "https") return false;
+		if (typeof window === "undefined" || !window.open) return false;
+		window.open(uri.toString(), "_blank", "noopener,noreferrer");
+		return true;
+	};
+	const linkOpener = monaco_editor.editor.registerLinkOpener({ open: async (resource) => {
+		const scheme = resource.scheme.toLowerCase();
+		if (scheme === "http" || scheme === "https") return openExternalLink(resource);
+		if (scheme !== "file") return false;
+		if (!await openFile(resource.with({ fragment: "" }).toString())) return false;
+		const location = parseFragment(resource.fragment);
+		if (location) {
+			const position = {
+				lineNumber: location.lineNumber,
+				column: location.column ?? 1
+			};
+			editor.setPosition(position);
+			editor.revealPositionInCenter(position);
+			editor.focus();
+		}
+		return true;
+	} });
+	const changeListener = editor.onDidChangeModelContent(() => {
+		if (skipWrite) return;
+		if (!activePath) return;
+		vfs.writeFile(activePath, editor.getValue());
+	});
+	return {
+		toFileUri,
+		getDisplayPath,
+		getLanguageFromPath,
+		getActivePath: () => activePath,
+		setActivePath: (path) => {
+			activePath = path;
+			activePathListeners.forEach((listener) => listener(activePath));
+		},
+		onActivePathChange: (listener) => {
+			activePathListeners.add(listener);
+			return () => {
+				activePathListeners.delete(listener);
+			};
+		},
+		setRootPath: (nextRootPath) => {
+			rootPath = normalizeRootUri(nextRootPath);
+			rootPathForJoin = require_client_handlers.normalizePath(rootPath.startsWith("file://") ? require_client_handlers.uriToPath(rootPath) : rootPath);
+		},
+		openFile,
+		dispose: () => {
+			linkOpener.dispose();
+			changeListener.dispose();
+			activePathListeners.clear();
+		}
+	};
+};
+
 //#endregion
 exports.createMemoryFileSystem = createMemoryFileSystem;
 exports.createWebgalMonacoLanguageClient = createWebgalMonacoLanguageClient;
 exports.createWebgalMonacoLanguageClientWithWorker = createWebgalMonacoLanguageClientWithWorker;
+exports.createWebgalMonacoWorkspace = createWebgalMonacoWorkspace;
 exports.initResources = initResources;
-exports.initWebgalMonaco = initWebgalMonaco;
+exports.initWebgalMonaco = initWebgalMonaco;
+exports.normalizeRootUri = normalizeRootUri;