@xaendar/language-core 0.9.18

package/dist/language-core.d.ts

@@ -0,0 +1,89 @@
+import { CompilerOptions, LanguageService } from 'typescript';
+import { TypeCheckResult } from '@xaendar/compiler';
+
+/**
+ * Returns the shared LanguageService, creating it (or recreating it) as
+ * needed. If the given compilerOptions differ from the ones the current
+ * LanguageService was created with, the old instance is disposed and a
+ * fresh one is created — this covers the case where vite.config / tsconfig
+ * changes while the dev server is running.
+ */
+declare function getLanguageService(compilerOptions: CompilerOptions): LanguageService;
+/**
+ * Disposes the current LanguageService and clears all associated state
+ * (virtual files, real file version cache, known root files). Call this
+ * from `configureServer` -> `httpServer.on('close', ...)`, or from
+ * `closeBundle`, to avoid leaking a stale instance across server restarts.
+ */
+declare function disposeLanguageService(): void;
+/**
+ * Registers a real project file as a root file for the Program, so the
+ * LanguageService's module resolver can find it when a virtual shim
+ * imports the corresponding component class.
+ */
+declare function registerRealFile(fileName: string): void;
+/**
+ * Removes a real project file, e.g. when its source DSL file is deleted from
+ * the project or no longer matches the plugin.
+ */
+declare function removeRealFile(filename: string): void;
+/**
+ * Updates (or creates) the virtual shim for the given path, bumping its
+ * version only if the content actually changed — this avoids invalidating
+ * the LanguageService's internal cache for no-op writes.
+ */
+declare function upsertVirtualFile(virtualPath: string, content: string): void;
+/**
+ * Removes a virtual shim, e.g. when its source DSL file is deleted from
+ * the project or no longer matches the plugin.
+ */
+declare function removeVirtualFile(virtualPath: string): void;
+/**
+ * Extracts the class name from the Babel-transpiled JS source.
+
+ *
+ * Babel always emits `class ClassName extends ...` so this is safe to match.
+ * Used to generate a unique name for the per-class CSSStyleSheet variable
+ * that must be declared outside the class body to guarantee it exists before
+ * `connectedCallback` fires.
+ *
+ * @param jsSource - The Babel-transpiled JS source of the component.
+ * @returns The class name, or `__Component` as a safe fallback.
+ */
+declare function extractClassName(jsSource: string): string;
+
+/**
+ * Loads the `tsconfig.json` compilerOptions applicable to the given
+ * directory, using TypeScript's standard config file resolution
+ * (`findConfigFile` walks up parent directories). Falls back to an empty
+ * options object if no config file is found, rather than throwing —
+ * type checking simply runs with default settings in that case.
+ *
+ * @param fromDir - Directory to start searching for `tsconfig.json` from,
+ *   typically the directory of the component file being transformed.
+ */
+declare function loadCompilerOptions(fromDir: string): CompilerOptions;
+
+declare function createShim(componentData: Map<string, string[]>, typecheckBody: TypeCheckResult): {
+    code: string;
+    bodyLineOffset: number;
+    path: string;
+    classNames: string[];
+};
+/**
+ * Extracts the `templateUrl` and `styleUrl` values from the `@WebComponent`
+ * decorator in the component source and resolves them to absolute paths.
+ *
+ * @param jsSource - The raw TypeScript source of the component file.
+ * @param componentDir - The directory containing the component file, used as
+ *   base for resolving relative decorator paths.
+ * @returns An object with the resolved `templatePath` and `stylePath`.
+ *   Either field may be `undefined` when the corresponding decorator
+ *   property is absent.
+ */
+declare function extractDecoratorPaths(jsSource: string, componentDir: string): {
+    templatePath?: string;
+    stylePath?: string;
+};
+
+export { createShim, disposeLanguageService, extractClassName, extractDecoratorPaths, getLanguageService, loadCompilerOptions, registerRealFile, removeRealFile, removeVirtualFile, upsertVirtualFile };

package/dist/language-core.js

@@ -0,0 +1,2 @@
+import{statSync as v}from"fs";import{createDocumentRegistry as S,createLanguageService as F,getDefaultLibFilePath as C,ScriptSnapshot as h,sys as s}from"typescript";var i=new Map,p=new Map,l=new Set,a,c;function A(e){let t=c&&JSON.stringify(c)!==JSON.stringify(e);return a&&t&&O(),c=e,a??=F(L(()=>[...l]),S()),a}function L(e){return{getScriptFileNames:()=>[...e(),...i.keys()],getScriptVersion(t){let r=i.get(t);return r?String(r.version):b(t)},getScriptSnapshot(t){let r=i.get(t);if(r)return h.fromString(r.content);if(!s.fileExists(t))return;let n=s.readFile(t);if(n!==void 0)return h.fromString(n)},getCurrentDirectory:()=>process.cwd(),getCompilationSettings:()=>c??{},getDefaultLibFileName:t=>C(t),fileExists(t){return i.has(t)||s.fileExists(t)},readFile(t){let r=i.get(t);return r?r.content:s.readFile(t)},readDirectory:s.readDirectory,directoryExists:s.directoryExists,getDirectories:s.getDirectories,realpath:s.realpath}}function O(){a.dispose(),a=void 0,c=void 0,i.clear(),p.clear(),l.clear()}function H(e){l.add(e)}function J(e){l.delete(e)}function b(e){try{let t=v(e),r=String(t.mtimeMs);return p.set(e,r),r}catch{return p.get(e)??"0"}}function y(e,t){let r=i.get(e);r?.content!==t&&i.set(e,{content:t,version:(r?.version??0)+1})}function T(e){i.delete(e)}function N(e){return e.match(/class\s+(\w+)\s+extends/)?.[1]??"__Component"}import{dirname as E}from"path";import{findConfigFile as V,sys as f,readConfigFile as w,parseJsonConfigFileContent as P}from"typescript";function I(e){let t=V(e,f.fileExists,"tsconfig.json");if(!t)return{};let r=w(t,f.readFile);return P(r.config,f,E(t)).options}import{basename as D,extname as R,resolve as x}from"path";function X(e,t){let r=Array.from(e.entries()),n=`${r[0][0]}.__typecheck__.ts`,o=_(r,n,t.text);return y(n,o.code),o}function _(e,t,r){let n=e.length+3,o=new Array(n).fill(""),u=new Array;for(let g=0;g<e.length;g++){let[d,m]=e[g];u.push(...m),o[g]=`import { ${m.join(", ")} } from './${D(d,R(d))}';`}return o[n-2]=`declare const root: ${u.join(" & ")};`,{code:[...o,r].join(`
+`),bodyLineOffset:n,path:t,classNames:u}}function Y(e,t){let r=e.match(/templateUrl\s*:\s*["'](.+?)["']/)?.[1],n=e.match(/styleUrl\s*:\s*["'](.+?)["']/)?.[1];return{templatePath:r?x(t,r):void 0,stylePath:n?x(t,n):void 0}}export{X as createShim,O as disposeLanguageService,N as extractClassName,Y as extractDecoratorPaths,A as getLanguageService,I as loadCompilerOptions,H as registerRealFile,J as removeRealFile,T as removeVirtualFile,y as upsertVirtualFile};

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@xaendar/language-core",
+  "version": "0.9.18",
+  "description": "A library containing common functionalities for build tools and language service",
+  "author": "Kaitenjo",
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/language-core.d.ts",
+      "import": "./dist/language-core.js",
+      "require": "./dist/language-core.js"
+    }
+  },
+  "main": "./dist/language-core.js",
+  "types": "./dist/language-core.d.ts",
+  "dependencies": {
+    "@xaendar/compiler": "0.9.18",
+    "typescript": "^6.0.3"
+  }
+}