@golar/volar 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 auvred <https://github.com/auvred>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+import { Promisable, ServiceCodeError } from "@golar/plugin";
+import { LanguagePlugin, VirtualCode } from "@volar/language-core";
+
+//#region src/index.d.ts
+type VolarLanguagePlugin = LanguagePlugin<string> & {
+  getVirtualCodeErrors?(root: VirtualCode): ServiceCodeError[];
+};
+type CreateVolarPluginOptions = {
+  filename: string;
+  /**
+      * @example ['.vue']
+      */
+  extraFileExtensions: string[];
+  languagePlugins: VolarLanguagePlugin[] | ((cwd: string, configFileName: string | null) => Promisable<VolarLanguagePlugin[]>);
+};
+declare function createVolarPlugin(opts: CreateVolarPluginOptions): void;
+//#endregion
+export { CreateVolarPluginOptions, VolarLanguagePlugin, createVolarPlugin };

package/dist/index.js

@@ -0,0 +1,125 @@
+import { createPlugin } from "@golar/plugin";
+
+//#region src/index.ts
+function createVolarPlugin(opts) {
+	const languagePluginsByProject = /* @__PURE__ */ new Map();
+	createPlugin({
+		filename: opts.filename,
+		extraExtensions: opts.extraFileExtensions,
+		async createServiceCode(cwd, configFileName, fileName, sourceText) {
+			let languagePlugins;
+			if (Array.isArray(opts.languagePlugins)) languagePlugins = opts.languagePlugins;
+			else {
+				const project = `${cwd}::${configFileName}`;
+				let plugins = languagePluginsByProject.get(project);
+				if (plugins == null) languagePluginsByProject.set(project, plugins = opts.languagePlugins(cwd, configFileName));
+				languagePlugins = await plugins;
+			}
+			for (const plugin of languagePlugins) {
+				if (plugin.createVirtualCode == null) continue;
+				const languageId = plugin.getLanguageId(fileName);
+				if (languageId == null) continue;
+				const virtualCode = plugin.createVirtualCode(fileName, languageId, {
+					getLength() {
+						return sourceText.length;
+					},
+					getText(start, end) {
+						return sourceText.slice(start, end);
+					},
+					dispose() {},
+					getChangeRange() {}
+				}, { getAssociatedScript(scriptId) {} });
+				if (virtualCode == null) continue;
+				{
+					const errors = plugin.getVirtualCodeErrors?.(virtualCode);
+					if (errors?.length) return { errors };
+				}
+				const serviceScript = plugin.typescript.getServiceScript(virtualCode);
+				const serviceText = serviceScript.code.snapshot.getText(0, serviceScript.code.snapshot.getLength());
+				const verificationMappings = serviceScript.code.mappings.filter((m) => m.data.verification);
+				const sourceOffsets = /* @__PURE__ */ new Set();
+				const serviceOffsets = /* @__PURE__ */ new Set();
+				for (const m of verificationMappings) {
+					for (const [i, offset] of m.sourceOffsets.entries()) {
+						sourceOffsets.add(offset);
+						sourceOffsets.add(offset + m.lengths[i]);
+					}
+					for (const [i, offset] of m.generatedOffsets.entries()) {
+						serviceOffsets.add(offset);
+						serviceOffsets.add(offset + (m.generatedLengths ?? m.lengths)[i]);
+					}
+					if ("__expectErrorCommentLoc" in m.data) {
+						const [start, end] = m.data.__expectErrorCommentLoc;
+						sourceOffsets.add(start).add(end);
+					}
+				}
+				const serviceCovered = [];
+				const expectErrorMappings = [];
+				const mappings = verificationMappings.flatMap((m) => {
+					return m.sourceOffsets.map((sourceOffset, i) => {
+						const generatedOffset = m.generatedOffsets[i];
+						const sourceLength = m.lengths[i];
+						const generatedLength = m.generatedLengths?.[i] ?? sourceLength;
+						if (generatedLength > 0) serviceCovered.push([generatedOffset, generatedOffset + generatedLength]);
+						if ("__expectErrorCommentLoc" in m.data) {
+							const [start, end] = m.data.__expectErrorCommentLoc;
+							expectErrorMappings.push({
+								sourceOffset: start,
+								serviceOffset: generatedOffset,
+								sourceLength: end - start,
+								serviceLength: generatedLength
+							});
+						}
+						return {
+							sourceOffset,
+							serviceOffset: generatedOffset,
+							sourceLength,
+							serviceLength: generatedLength
+						};
+					});
+				});
+				serviceCovered.sort((a, b) => a[0] - b[0] || a[1] - b[1]);
+				const merged = [];
+				for (const [s, e] of serviceCovered) {
+					const last = merged.at(-1);
+					if (!last) merged.push([s, e]);
+					else if (s <= last[1]) last[1] = Math.max(last[1], e);
+					else merged.push([s, e]);
+				}
+				const ignoreMappings = [];
+				let cursor = 0;
+				for (const [s, e] of merged) {
+					if (s > cursor) ignoreMappings.push({
+						serviceOffset: cursor,
+						serviceLength: s - cursor
+					});
+					cursor = Math.max(cursor, e);
+				}
+				ignoreMappings.push({
+					serviceOffset: cursor,
+					serviceLength: serviceText.length - cursor
+				});
+				return {
+					serviceText,
+					scriptKind: tsScriptKindToGolar(serviceScript?.scriptKind),
+					mappings,
+					ignoreMappings,
+					expectErrorMappings
+				};
+			}
+			throw new Error("Unknown language");
+		}
+	});
+}
+function tsScriptKindToGolar(scriptKind) {
+	switch (scriptKind) {
+		case 1: return "js";
+		case 2: return "jsx";
+		case 3: return "ts";
+		case 4: return "tsx";
+		default: return "ts";
+	}
+}
+
+//#endregion
+export { createVolarPlugin };

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@golar/volar",
+  "version": "0.0.1",
+  "type": "module",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "files": [
+    "./dist"
+  ],
+  "license": "MIT",
+  "author": "auvred <aauvred@gmail.com> (https://github.com/auvred)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/auvred/golar.git",
+    "directory": "packages/volar"
+  },
+  "bugs": "https://github.com/auvred/golar/issues",
+  "homepage": "https://github.com/auvred/golar/tree/main/packages/volar#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@volar/language-core": "^2.4.28",
+    "@golar/plugin": "0.0.1"
+  },
+  "devDependencies": {
+    "@volar/typescript": "^2.4.28"
+  }
+}