@flint.fyi/vue-language 0.0.1 → 0.1.0

package/LICENSE.md

@@ -0,0 +1,20 @@
+# MIT License
+
+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/README.md

@@ -1,45 +1,9 @@
-# @flint.fyi/vue-language
+<h1 align="center"><code>@flint.fyi/vue-language</code></h1>
 
-## ⚠️ IMPORTANT NOTICE ⚠️
+<p align="center">
+	[Experimental] Vue.js language for Flint.
+	❤️‍🔥
+</p>
 
-**This package is created solely for the purpose of setting up OIDC (OpenID Connect) trusted publishing with npm.**
-
-This is **NOT** a functional package and contains **NO** code or functionality beyond the OIDC setup configuration.
-
-## Purpose
-
-This package exists to:
-1. Configure OIDC trusted publishing for the package name `@flint.fyi/vue-language`
-2. Enable secure, token-less publishing from CI/CD workflows
-3. Establish provenance for packages published under this name
-
-## What is OIDC Trusted Publishing?
-
-OIDC trusted publishing allows package maintainers to publish packages directly from their CI/CD workflows without needing to manage npm access tokens. Instead, it uses OpenID Connect to establish trust between the CI/CD provider (like GitHub Actions) and npm.
-
-## Setup Instructions
-
-To properly configure OIDC trusted publishing for this package:
-
-1. Go to [npmjs.com](https://www.npmjs.com/) and navigate to your package settings
-2. Configure the trusted publisher (e.g., GitHub Actions)
-3. Specify the repository and workflow that should be allowed to publish
-4. Use the configured workflow to publish your actual package
-
-## DO NOT USE THIS PACKAGE
-
-This package is a placeholder for OIDC configuration only. It:
-- Contains no executable code
-- Provides no functionality
-- Should not be installed as a dependency
-- Exists only for administrative purposes
-
-## More Information
-
-For more details about npm's trusted publishing feature, see:
-- [npm Trusted Publishing Documentation](https://docs.npmjs.com/generating-provenance-statements)
-- [GitHub Actions OIDC Documentation](https://docs.github.com/en/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect)
-
----
-
-**Maintained for OIDC setup purposes only**
+This is an internal package for Flint.
+Documentation will eventually be added.

package/lib/extractTemplateDirectives.d.ts

@@ -0,0 +1,4 @@
+import type { ExtractedDirective } from "@flint.fyi/typescript-language";
+import { type RootNode } from "@vue/compiler-dom";
+export declare function extractTemplateDirectives(ast: RootNode): ExtractedDirective[];
+//# sourceMappingURL=extractTemplateDirectives.d.ts.map

package/lib/extractTemplateDirectives.js

@@ -0,0 +1,38 @@
+import { nullThrows } from "@flint.fyi/utils";
+import { NodeTypes } from "@vue/compiler-dom";
+//#region src/extractTemplateDirectives.ts
+function extractTemplateDirectives(ast) {
+	const directives = [];
+	function visitTemplate(elem) {
+		if (elem.type === NodeTypes.ELEMENT) {
+			for (const child of elem.children) visitTemplate(child);
+			return;
+		}
+		if (elem.type !== NodeTypes.COMMENT) return;
+		const match = /\s*flint-(\S+)(?:\s+(.+))?/.exec(elem.content);
+		if (match == null) return;
+		const [, type, selection] = match;
+		directives.push({
+			range: {
+				begin: {
+					column: elem.loc.start.column - 1,
+					line: elem.loc.start.line - 1,
+					raw: elem.loc.start.offset
+				},
+				end: {
+					column: elem.loc.end.column - 1,
+					line: elem.loc.end.line - 1,
+					raw: elem.loc.end.offset
+				}
+			},
+			selection: nullThrows(selection, "Expected RegExp to provide second capturing group"),
+			type: nullThrows(type, "Expected RegExp to provide first capturing group")
+		});
+	}
+	for (const child of ast.children) visitTemplate(child);
+	return directives;
+}
+//#endregion
+export { extractTemplateDirectives };
+
+//# sourceMappingURL=extractTemplateDirectives.js.map

package/lib/index.d.ts

@@ -0,0 +1,2 @@
+import { vueLanguage } from "./language.js";
+export { vueLanguage };

package/lib/index.js

@@ -0,0 +1,2 @@
+import { vueLanguage } from "./language.js";
+export { vueLanguage };

package/lib/language.d.ts

@@ -0,0 +1,20 @@
+import * as _flint_fyi_volar_language0 from "@flint.fyi/volar-language";
+import { RootNode } from "@vue/compiler-dom";
+import { VueVirtualCode, tsCodegen } from "@vue/language-core";
+import * as _flint_fyi_typescript_language0 from "@flint.fyi/typescript-language";
+import { Mapper } from "@volar/language-core";
+
+//#region src/language.d.ts
+interface VueServices {
+  vue: {
+    codegen: VueCodegen;
+    map: Mapper;
+    sfc: RootNode;
+    virtualCode: VueVirtualCode;
+  };
+}
+type VueCodegen = typeof tsCodegen extends WeakMap<WeakKey, infer V> ? V : never;
+declare const vueLanguage: _flint_fyi_volar_language0.Language<_flint_fyi_typescript_language0.TypeScriptNodesByName, Partial<VueServices> & _flint_fyi_typescript_language0.TypeScriptFileServices>;
+//#endregion
+export { vueLanguage };
+//# sourceMappingURL=language.d.ts.map

package/lib/language.js

@@ -0,0 +1,50 @@
+import { extractTemplateDirectives } from "./extractTemplateDirectives.js";
+import { vueParsingErrorsToLanguageReports } from "./vueParsingErrorsToLanguageReports.js";
+import { setTSExtraSupportedExtensions } from "@flint.fyi/ts-patch";
+import { assert, nullThrows } from "@flint.fyi/utils";
+import { createVolarBasedLanguage } from "@flint.fyi/volar-language";
+import { NodeTypes, parse } from "@vue/compiler-dom";
+import { VueVirtualCode, createParsedCommandLine, createParsedCommandLineByJson, createVueLanguagePlugin, tsCodegen } from "@vue/language-core";
+//#region src/language.ts
+setTSExtraSupportedExtensions([".vue"]);
+const vueLanguage = createVolarBasedLanguage((ts, options) => {
+	const { configFilePath } = options.options;
+	const host = options.host ? {
+		...options.host,
+		useCaseSensitiveFileNames: options.host.useCaseSensitiveFileNames()
+	} : ts.sys;
+	const vueCompilerOptions = (typeof configFilePath === "string" ? createParsedCommandLine(ts, host, configFilePath.replaceAll("\\", "/")) : createParsedCommandLineByJson(ts, host, host.getCurrentDirectory(), {})).vueOptions;
+	return {
+		createFile({ data, serviceScript, sourceFile, sourceScript, volarLanguage }) {
+			const sourceText = sourceScript.snapshot.getText(0, sourceScript.snapshot.getLength());
+			const virtualCode = sourceScript.generated.root;
+			assert(virtualCode instanceof VueVirtualCode, "Expected sourceScript.generated.root to be VueServiceCode");
+			const codegen = nullThrows(tsCodegen.get(virtualCode.sfc), `tsCodegen for ${data.filePathAbsolute} is undefined`);
+			const map = volarLanguage.maps.get(serviceScript.code, sourceScript);
+			const sfcAst = parse(sourceText, {
+				comments: true,
+				expressionPlugins: ["typescript"],
+				onError: () => {},
+				parseMode: "html"
+			});
+			return {
+				directives: extractTemplateDirectives(sfcAst),
+				extraContext: { vue: {
+					codegen,
+					map,
+					sfc: sfcAst,
+					virtualCode
+				} },
+				firstStatementPosition: sfcAst.children.find((c) => c.type !== NodeTypes.COMMENT)?.loc.start.offset ?? sourceText.length,
+				getLanguageReports() {
+					return vueParsingErrorsToLanguageReports(sourceFile.fileName.startsWith("./") ? sourceFile.fileName.slice(2) : sourceFile.fileName.slice(process.cwd().length + 1), virtualCode.vueSfc?.errors ?? []);
+				}
+			};
+		},
+		languagePlugins: [createVueLanguagePlugin(ts, options.options, vueCompilerOptions, (id) => id)]
+	};
+});
+//#endregion
+export { vueLanguage };
+
+//# sourceMappingURL=language.js.map

package/lib/vueParsingErrorsToLanguageReports.d.ts

@@ -0,0 +1,4 @@
+import type { LanguageReports } from "@flint.fyi/core";
+import type { CompilerError } from "@vue/compiler-dom";
+export declare function vueParsingErrorsToLanguageReports(fileName: string, errors: (CompilerError | SyntaxError)[]): LanguageReports;
+//# sourceMappingURL=vueParsingErrorsToLanguageReports.d.ts.map

package/lib/vueParsingErrorsToLanguageReports.js

@@ -0,0 +1,19 @@
+//#region src/vueParsingErrorsToLanguageReports.ts
+function vueParsingErrorsToLanguageReports(fileName, errors) {
+	return errors.map((error) => {
+		let code = "VUE";
+		let loc = "";
+		if ("code" in error) {
+			code += error.code.toString();
+			loc = error.loc != null ? `:${error.loc.start.line}:${error.loc.start.column}` : "";
+		}
+		return {
+			code,
+			text: `${fileName}${loc} - ${code}: ${error.name} - ${error.message}`
+		};
+	});
+}
+//#endregion
+export { vueParsingErrorsToLanguageReports };
+
+//# sourceMappingURL=vueParsingErrorsToLanguageReports.js.map

package/package.json

@@ -1,10 +1,49 @@
 {
   "name": "@flint.fyi/vue-language",
-  "version": "0.0.1",
-  "description": "OIDC trusted publishing setup package for @flint.fyi/vue-language",
-  "keywords": [
-    "oidc",
-    "trusted-publishing",
-    "setup"
-  ]
-}
+  "version": "0.1.0",
+  "description": "[Experimental] Vue.js language for Flint.",
+  "homepage": "https://flint.fyi",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/flint-fyi/flint.git",
+    "directory": "packages/vue-language"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "JoshuaKGoldberg",
+    "email": "npm@joshuakgoldberg.com"
+  },
+  "sideEffects": true,
+  "type": "module",
+  "exports": {
+    ".": "./lib/index.js"
+  },
+  "files": [
+    "lib/",
+    "!lib/**/*.map"
+  ],
+  "dependencies": {
+    "@volar/language-core": "2.4.28",
+    "@vue/compiler-dom": "^3.5.0",
+    "@vue/language-core": "3.2.1",
+    "typescript": "^5.9.0 || ^6.0.0",
+    "@flint.fyi/ts-patch": "^0.13.5",
+    "@flint.fyi/utils": "^0.14.1",
+    "@flint.fyi/typescript-language": "^0.18.0",
+    "@flint.fyi/volar-language": "^0.1.0"
+  },
+  "devDependencies": {
+    "tsdown": "0.21.0",
+    "vitest": "4.1.0",
+    "@flint.fyi/core": "^0.21.0"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "test": "vitest --project vue-language"
+  }
+}