nanos-lint 2.4.0 → 2.6.0

package/dist/cli-r8LDolDk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-r8LDolDk.d.ts","names":[],"sources":["../node_modules/commander/typings/index.d.ts","../src/cli.ts"],"x_google_ignoreList":[0],"mappings":"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"}
+{"version":3,"file":"cli-r8LDolDk.d.ts","names":[],"sources":["../node_modules/commander/typings/index.d.ts","../src/cli.ts"],"x_google_ignoreList":[0],"mappings":";;;;;;;;;;KAWK,aAAa,aAAa,oCAC3B,eACC,WAAW;cAEH,uBAAuB;EAClC;EACA;EACA;EACA;;;;;;;EAQA,YAAY,kBAAkB,cAAc;;UAY7B;;;EAGf;;EAEA;;cAGW;EACX;EACA;EACA;EACA;EACA;EACA,YAAY,GAAG,eAAe,UAAU,MAAM;EAC9C;;;;;;EAOA,YAAY,aAAa;;;;EAKzB;;;;EAKA,QAAQ,gBAAgB;;;;EAKxB,UAAU,GAAG,KAAK,eAAe,UAAU,MAAM;;;;EAKjD,QAAQ;;;;EAKR;;;;EAKA;;cAGW;EACX;EACA;EAEA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,YAAY,GAAG,eAAe,UAAU,MAAM;EAC9C;EACA;EACA;EAEA,YAAY,eAAe;;;;EAK3B,QAAQ,gBAAgB;;;;;;;;;;;EAYxB,OAAO;;;;;;;;;;;EAYP,UAAU;;;;;;;;;;;EAYV,QAAQ,cAAc;;;;;;;EAQtB,IAAI;;;;EAKJ,UAAU,GAAG,KAAK,eAAe,UAAU,MAAM;;;;EAKjD,oBAAoB;;;;EAKpB,SAAS;;;;EAKT,QAAQ;;;;EAKR;;;;;EAMA;;;;EAKA,UAAU;;;;;;EAOV;;cAGW;;EAEX;EACA;EACA;EACA;EACA;EAEA;;;;;;;EAQA,eAAe;IACb;IACA;IACA;;;EAIF,eAAe,KAAK;;EAEpB,sBAAsB,KAAK;;EAE3B,WAAW,QAAQ;;EAEnB,kBAAkB,QAAQ;;EAE1B,aAAa,UAAU;;EAEvB,oBAAoB,UAAU;;EAG9B,aAAa,KAAK;;EAElB,mBAAmB,KAAK;;EAGxB,gBAAgB,KAAK,UAAU;;EAE/B,eAAe,KAAK,UAAU;;EAE9B,qBAAqB,KAAK,UAAU;;EAEpC,iBAAiB,KAAK,UAAU;;EAGhC,4BAA4B,KAAK,SAAS,QAAQ;;EAElD,wBAAwB,KAAK,SAAS,QAAQ;;EAE9C,8BAA8B,KAAK,SAAS,QAAQ;;EAEpD,0BAA0B,KAAK,SAAS,QAAQ;;EAGhD,aAAa;;EAGb,WAAW;;EAGX,WAAW;;EAEX,iBAAiB;EAEjB,wBAAwB;EACxB,uBAAuB;EACvB,2BAA2B;EAC3B,yBAAyB;;EAEzB,qBAAqB;EAErB,gBAAgB;EAChB,oBAAoB;EACpB,kBAAkB;;EAGlB,gBAAgB;;EAEhB,oBAAoB;;EAEpB,kBAAkB;;EAGlB,SAAS,KAAK,SAAS,QAAQ;;;;;EAM/B,QAAQ,aAAa;;EAGrB,aAAa;;;;;;;;EASb,WACE,cACA,mBACA,qBACA,QAAQ;;;;EAMV,eAAe,iBAAiB,iBAAiB,QAAQ;;;;EAKzD,WAAW,UAAU,UAAU,QAC7B,eAAe,KACf,cAAc,KACd,WAAW,MAAM,eAChB,YAAY;;EAGf,WAAW,KAAK,SAAS,QAAQ;;KAEvB,oBAAoB,QAAQ;UAEvB;EACf;;UAEe;;EAEf;;UAEe;;EAEf;EACA,SAAS;;UAEM;EACf,UAAU;EACV,UAAU;EACV,aAAa,aAAa,QAAQ;EAElC;EACA;EAEA;EACA;EACA,YAAY;;KAGF;KACA;;KAEA,oBACR;KAGQ,eAAe;cAEd;EACX;EACA;WACS,mBAAmB;WACnB,kBAAkB;WAClB,8BAA8B;EACvC,QAAQ;EAER,YAAY;;;;;;;;;EAUZ,QAAQ,aAAa,gBAAgB;;;;EAIrC;;;;;;;;;;;;;;;;;;;;;EAsBA,QACE,qBACA,OAAO,iBACN;;;;;;;;;;;;;;;;;;;EAmBH,QACE,qBACA,qBACA,OAAO;;;;;;;EAST,cAAc,gBAAgB;;;;;;;;EAS9B,WAAW,KAAK,SAAS,OAAO;;;;;;;EAQhC,eAAe,cAAc,uBAAuB;;;;;;;;;;;;;;;EAgBpD,SAAS,GACP,eACA,qBACA,WAAW,eAAe,UAAU,MAAM,GAC1C,eAAe;EAEjB,SAAS,cAAc,sBAAsB;;;;;;EAO7C,YAAY,KAAK;;;;;;;;;;;;;EAcjB,UAAU;;;;;;;;;;;;EAaV,YAAY,qBAAqB;EACjC,YAAY;;;;EAKZ,eAAe,KAAK;;EAEpB,eAAe,qBAAqB;;EAEpC,eAAe;;;;EAKf,KACE,OAAO,WACP,WACE,aAAa,SACb,eAAe,mBACL;;;;EAMd,aAAa,YAAY,KAAK;;;;EAK9B,MAAM,iBAAiB,eAAe;;;;;EAMtC,cAAc;;;;;EAMd,cAAc,eAAe;;EAE7B,iBAAiB;;;;;;;;;;;;;;;;;EAkBjB,gBAAgB,eAAe;;EAE/B,mBAAmB;;;;;;EAOnB,sBAAsB,eAAe;;;;EAKrC,mBAAmB;;;;EAKnB,yBAAyB;;;;;;;;;;;;;;;;EAiBzB,OAAO,KAAK,eAAe,uBAAuB;;;;;;;;;;;;;;;;;;;;;EAsBlD,OACE,eACA,sBACA;EAEF,OAAO,GACL,eACA,qBACA,WAAW,eAAe,UAAU,MAAM,GAC1C,eAAe;;EAGjB,OACE,eACA,qBACA,QAAQ,QACR;;;;;;;EASF,eACE,eACA,sBACA;EAEF,eAAe,GACb,eACA,qBACA,WAAW,eAAe,UAAU,MAAM,GAC1C,eAAe;;EAGjB,eACE,eACA,qBACA,QAAQ,QACR;;;;;;;EAUF,aAAa,eAAe,uBAAuB;;;;;;EAOnD,UAAU,QAAQ;;;;;;;EAQlB,yBAAyB,UAAU,wBAAwB;EAC3D,yBAAyB,UAAU,cACjC,iCACQ;EACV,yBAAyB;;;;EAKzB,eAAe;;;;EAKf,eAAe,aAAa;;;;EAK5B,yBACE,aACA,gBACA,QAAQ;;;;EAMV,qBAAqB,cAAc;;;;EAKnC,gCAAgC,cAAc;;;;;;;;;;;;;EAc9C,4BAA4B;;;;;;EAO5B,mBAAmB;;;;;;EAOnB,qBAAqB;;;;;;;;;EAUrB,wBAAwB;;;;;;;;;;EAWxB,mBAAmB;;;;;;;;;;;;;;;;;;;;;;EAuBnB,MAAM,0BAA0B,eAAe;;;;;;;;;;;;;;;;;;;;EAqB/C,WACE,0BACA,eAAe,eACd;;;;;;;EAQH;;;;;;;EAQA;;;;;;;;;;;;;EAcA,aAAa,iBAAiB;;;;EAK9B,KAAK,UAAU,iBAAiB;;;;EAKhC,gBAAgB,UAAU,iBAAiB;;;;;;EAQ3C,YAAY;;EAEZ,YAAY,aAAa,iBAAiB;;;;EAI1C;;;;;;EAQA,QAAQ;;;;EAIR;;;;;;;;EASA,MAAM;;;;EAIN;;;;;;;;EASA,QAAQ;;;;EAIR;;;;;;EAOA,MAAM;;;;EAIN;;;;;;EAOA,KAAK;;;;EAIL;;;;;;;;;;;;;;EAeA,iBAAiB;;;;;;;;;;;;;EAcjB,cAAc;;;;EAId;;;;;;EAOA,UAAU;;;;EAIV;;;;;;;;;;;;;EAcA,cAAc;;;;EAId;;;;;;;;;;;;;EAcA,aAAa;;;;EAIb;;;;;;;EAQA,WAAW,UAAU;;EAErB,WAAW,KAAK;;;;EAKhB,gBAAgB,UAAU;;;;;;EAO1B,WAAW,0BAA0B;;;;;EAMrC,cAAc,QAAQ;;;;;;EAOtB,KAAK,UAAU;;EAEf,KAAK,KAAK;;;;;;;EAQV,YAAY,UAAU,qBAAqB;EAC3C,YACE,UAAU,qBACV,OAAO,SAAS;;;;EAMlB,GAAG,wBAAwB,cAAc;;UAG1B;EACf;EACA;;EAEA;;UAEe,iCAAiC;EAChD;;UAGe;EACf;EACA;;;;iBC5jCc,sBAAsB,aAAa;UAoBlC;EACf,eAAe;;iBAGD,cAAc,UAAU,uBAAuB;iBA8KzC,OAAO,kBAAyC;iBAwBtD,kBACd,wBACA"}

package/dist/cli.js

@@ -1,2 +1,2 @@
-import { i as runCLI, n as createProgram, r as isDirectExecution, t as collectIgnorePatterns } from "./cli-kmHD4epr.js";
+import { i as runCLI, n as createProgram, r as isDirectExecution, t as collectIgnorePatterns } from "./cli-5LLXRlN7.js";
 export { collectIgnorePatterns, createProgram, isDirectExecution, runCLI };

package/dist/index.d.ts

@@ -78,6 +78,11 @@ export declare function fileUriToPath(uri: string): string;
  * Finds the package root directory across both development (src/) and production (dist/) environments.
  */
 export declare function getPackageRoot(): string;
+export declare function getDefaultAnnotationsPath(): string;
+/**
+ * @deprecated Use getDefaultAnnotationsPath() instead.
+ * Returns the directory containing the resolved annotations.lua file.
+ */
 export declare function getDefinitionsDir(): string;
 export declare function getDefaultTemplatePath(): string;
 /**
@@ -86,17 +91,32 @@ export declare function getDefaultTemplatePath(): string;
 export declare function stripJsonComments(text: string): string;
 export declare function parseJsonc<T = unknown>(text: string): T;
 export declare function loadConfigFile(filePath: string): LuaRCConfig;
+/**
+ * Removes trailing `/` characters from a path-like string.
+ *
+ * Implemented with a scan instead of a `\/+$` regular expression: on inputs made
+ * of many slashes that do not end in a slash, a backtracking engine retries the
+ * repetition at every offset, which is quadratic in the input length
+ * (CodeQL: js/polynomial-redos).
+ */
+export declare function stripTrailingSlashes(value: string): string;
 export interface MergeConfigOptions {
   cliIgnore?: string[];
 }
 /**
  * Merges a base nanos configuration with a workspace override configuration.
- * Guarantees that the nanos definitions directory is included in workspace.library,
+ * Guarantees that nanos API annotations are included in workspace.library,
  * and standardizes paths for LuaLS.
+ *
+ * @param base Base configuration template
+ * @param override Workspace override configuration
+ * @param definitionsPath Path to annotations.lua file or directory containing it
+ * @param options Additional merge options
  */
-export declare function mergeConfigs(base: LuaRCConfig, override?: LuaRCConfig, definitionsDir?: string, options?: MergeConfigOptions): LuaRCConfig;
+export declare function mergeConfigs(base: LuaRCConfig, override?: LuaRCConfig, definitionsPath?: string, options?: MergeConfigOptions): LuaRCConfig;
 export interface ResolveWorkspaceConfigOptions {
   ignore?: string[];
+  annotationsPath?: string;
 }
 /**
  * Discovers any existing workspace configuration and returns the path to an active
@@ -108,6 +128,7 @@ export declare function resolveWorkspaceConfig(workspacePath: string, customConf
 };
 export interface InitWorkspaceOptions {
   force?: boolean;
+  annotationsPath?: string;
 }
 /**
  * Initializes a new .luarc.json in a workspace.
@@ -117,6 +138,20 @@ export declare function initWorkspace(workspacePath: string, options?: InitWorks
 //#region src/luals.d.ts
 export declare const FALLBACK_LUALS_VERSION = "3.19.1";
 export declare const DEFAULT_LUALS_VERSION = "latest";
+/**
+ * Validates a LuaLS version/tag and rebuilds it from the allow-list above.
+ *
+ * Version strings originate from untrusted sources: the GitHub releases API
+ * response and user supplied `--luals-version` arguments. They are interpolated
+ * into cache directory paths, download URLs, and the path of the binary that is
+ * eventually executed, so they must be constrained to a single safe path
+ * segment. Rebuilding the value character by character guarantees the returned
+ * string only ever contains allow-listed characters (CodeQL: js/command-line-injection).
+ *
+ * @returns the normalized version (a single leading `v` is dropped), or `null`
+ *          when the input cannot be used as a version tag.
+ */
+export declare function sanitizeLuaLSVersion(raw: string): string | null;
 /**
  * Escapes single quotes for safe PowerShell single-quoted string interpolation.
  */
@@ -127,6 +162,8 @@ export declare function escapePowerShellSingleQuote(str: string): string;
 export declare function resolveLatestLuaLSVersion(): Promise<string>;
 /**
  * Resolves a version string ("latest" -> actual tag).
+ *
+ * @throws when an explicitly requested version is not a valid tag.
  */
 export declare function resolveLuaLSVersion(version?: string): Promise<string>;
 export interface PlatformInfo {
@@ -137,6 +174,10 @@ export interface PlatformInfo {
 }
 export declare function getPlatformInfo(version?: string): PlatformInfo;
 export declare function getCacheDir(version?: string): string;
+/**
+ * Returns the legacy cache directory used in nanos-lint <= 2.2.1.
+ */
+export declare function getLegacyCacheDir(version?: string): string;
 export interface DownloadOptions {
   quiet?: boolean;
 }
@@ -180,5 +221,124 @@ export declare function formatPretty(result: CheckResult, cwd?: string, useColor
 export declare function formatGitHubAnnotations(result: CheckResult, cwd?: string): string;
 export declare function formatReport(result: CheckResult, format?: "pretty" | "json" | "github", cwd?: string, useColor?: boolean): string;
 //#endregion
+//#region node_modules/env-paths/index.d.ts
+type Paths = {
+  /**
+	Directory for data files.
+
+	Example locations (with the default `nodejs` suffix):
+
+	- macOS: `~/Library/Application Support/MyApp-nodejs`
+	- Windows: `%LOCALAPPDATA%\MyApp-nodejs\Data` (for example, `C:\Users\USERNAME\AppData\Local\MyApp-nodejs\Data`)
+	- Linux: `~/.local/share/MyApp-nodejs` (or `$XDG_DATA_HOME/MyApp-nodejs`)
+	*/
+  readonly data: string;
+  /**
+	Directory for config files.
+
+	Example locations (with the default `nodejs` suffix):
+
+	- macOS: `~/Library/Preferences/MyApp-nodejs`
+	- Windows: `%APPDATA%\MyApp-nodejs\Config` (for example, `C:\Users\USERNAME\AppData\Roaming\MyApp-nodejs\Config`)
+	- Linux: `~/.config/MyApp-nodejs` (or `$XDG_CONFIG_HOME/MyApp-nodejs`)
+	*/
+  readonly config: string;
+  /**
+	Directory for non-essential data files.
+
+	Example locations (with the default `nodejs` suffix):
+
+	- macOS: `~/Library/Caches/MyApp-nodejs`
+	- Windows: `%LOCALAPPDATA%\MyApp-nodejs\Cache` (for example, `C:\Users\USERNAME\AppData\Local\MyApp-nodejs\Cache`)
+	- Linux: `~/.cache/MyApp-nodejs` (or `$XDG_CACHE_HOME/MyApp-nodejs`)
+	*/
+  readonly cache: string;
+  /**
+	Directory for log files.
+
+	Example locations (with the default `nodejs` suffix):
+
+	- macOS: `~/Library/Logs/MyApp-nodejs`
+	- Windows: `%LOCALAPPDATA%\MyApp-nodejs\Log` (for example, `C:\Users\USERNAME\AppData\Local\MyApp-nodejs\Log`)
+	- Linux: `~/.local/state/MyApp-nodejs` (or `$XDG_STATE_HOME/MyApp-nodejs`)
+	*/
+  readonly log: string;
+  /**
+	Directory for temporary files.
+
+	Example locations (with the default `nodejs` suffix):
+
+	- macOS: `/var/folders/jf/f2twvvvs5jl_m49tf034ffpw0000gn/T/MyApp-nodejs`
+	- Windows: `%LOCALAPPDATA%\Temp\MyApp-nodejs` (for example, `C:\Users\USERNAME\AppData\Local\Temp\MyApp-nodejs`)
+	- Linux: `/tmp/USERNAME/MyApp-nodejs`
+	*/
+  readonly temp: string;
+};
+//#endregion
+//#region src/paths.d.ts
+/**
+ * System paths resolved for nanos-lint using cross-platform conventions
+ * provided by env-paths (XDG on Linux, %LOCALAPPDATA%/%APPDATA% on Windows, ~/Library on macOS).
+ */
+export declare const systemPaths: Paths;
+/**
+ * Clears the nanos-lint cache directory.
+ * Returns the path of the cleared cache directory, or null if it did not exist.
+ */
+export declare function cleanCache(targetDir?: string): string | null;
+//#endregion
+//#region src/annotations.d.ts
+export declare const DOCGEN_REPO = "nanos-world/vscode-extension";
+export declare const DOCGEN_BRANCH = "docgen-output";
+export declare const RAW_ANNOTATIONS_URL = "https://raw.githubusercontent.com/nanos-world/vscode-extension/refs/heads/docgen-output/annotations.lua";
+export declare const GITHUB_COMMITS_API = "https://api.github.com/repos/nanos-world/vscode-extension/commits/docgen-output";
+export interface AnnotationsDate {
+  year: number;
+  month: number;
+  day: number;
+}
+export interface AnnotationsMetadata {
+  commitId: string;
+  lastChecked: string;
+  date: AnnotationsDate;
+}
+export declare const ANNOTATIONS_FILENAME = "annotations.lua";
+export declare const METADATA_FILENAME = "metadata.json";
+export declare function getTodayDateString(d?: Date): {
+  dateStr: string;
+  dateObj: AnnotationsDate;
+};
+export declare function getAnnotationsCacheDir(): string;
+export declare function getCachedAnnotationsFilePath(): string;
+export declare function getAnnotationsMetadataFilePath(): string;
+export declare function readAnnotationsMetadata(cacheDir?: string): AnnotationsMetadata | null;
+export declare function fetchLatestCommitId(): Promise<string | null>;
+export declare function fetchRawAnnotationsContent(): Promise<string>;
+/**
+ * Updates the metadata lastChecked date atomically without modifying annotations.lua.
+ */
+export declare function updateLastCheckedDate(commitId: string, cacheDir?: string): AnnotationsMetadata;
+/**
+ * Downloads annotations.lua, writes it and the new metadata in a chained atomic transaction.
+ * If any step fails, the previous cache state is reverted.
+ */
+export declare function downloadAndCacheAnnotations(commitId: string, cacheDir?: string, options?: {
+  quiet?: boolean;
+}): Promise<string>;
+export interface ResolveAnnotationsOptions {
+  customPath?: string;
+  cacheDir?: string;
+  quiet?: boolean;
+}
+/**
+ * Resolves the nanos world annotations.lua definitions file path.
+ * Resolution precedence:
+ * 1. CLI option (`customPath`)
+ * 2. Environment variable (`NANOS_ANNOTATIONS_PATH` or `NANOS_ANNOTATIONS`)
+ * 3. Bundled inside package root (`annotations.lua`)
+ * 4. User cache (checked once per day from upstream GitHub)
+ */
+export declare function resolveAnnotations(options?: ResolveAnnotationsOptions): Promise<string>;
+//#endregion
 export { CreateProgramOptions, collectIgnorePatterns, createProgram, isDirectExecution, runCLI };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/types.ts","../src/config.ts","../src/luals.ts","../src/reporter.ts"],"mappings":";;YAEY;YACA;iBAEK;EACf;IACE;IACA;;EAEF;IACE;IACA;;;iBAIa;EACf,OAAO;EACP,UAAU;EACV;EACA;EACA;;YAGU,mBAAmB,eAAe;iBAE7B;EACf;EACA,aAAa;EACb;EACA;EACA;EACA;EACA;EACA;EACA;;iBAGe;EACf;EACA;EACA;EACA;EACA;EACA;EACA,aAAa;;iBAGE;EACf;EACA;IACE;IACA;KACC;;EAEH;IACE;IACA;IACA;KACC;;EAEH;IACE;KACC;;EAEH;IACE;IACA;IACA;IACA,WAAW;IACX,mBAAmB;KAClB;;GAEF;;;;;;wBAOa,cAAc;;;;;;wBCnEd;wBAWA;wBAKA;;;;wBAQA,kBAAkB;wBAKlB,WAAW,aAAa,eAAe;wBAavC,eAAe,mBAAmB;iBAQjC;EACf;;;;;;;wBAQc,aACd,MAAM,aACN,WAAU,aACV,yBACA,UAAU,qBACT;iBAsGc;EACf;;;;;;wBAOc,uBACd,uBACA,2BACA,UAAU;EACP;EAAoB;;iBA2ER;EACf;;;;;wBAMc,cAAc,uBAAuB,UAAU;;;qBCtQlD;qBACA;;;;wBAKG,4BAA4B;;;;wBAOtB,6BAA6B;;;;wBA4B7B,oBAAoB,mBAAmB;iBAO5C;EACf;EACA;EACA;EACA;;wBAGc,gBAAgB,mBAA2C;wBAiD3D,YAAY;iBASX;EACf;;;;;wBAMc,cAAc;wBAoBR,wBACpB,kBACA,oBACA,UAAU,kBACT;iBAqKc;EACf;;wBAGoB,mBACpB,kBACA,UAAU,sBACT;wBA0DmB,cACpB,oBACA,oBACA,SAAS,eACR,QAAQ;;;;wBA+HK,kBAAkB,oBAAoB;;;;;;;wBCpftC;wBAUA,UAAU;;;;;;;;;;;;wBA6BV,oBACd,kBACA;wBAgBc,UAAU,eAAe,kBAAkB;wBAI3C,qBACd,uBACA,gBACA,kBACA;wBAqBc,aACd,QAAQ,aACR,cACA;wBAiFc,wBAAwB,QAAQ,aAAa;wBAsC7C,aACd,QAAQ,aACR,uCACA,cACA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/types.ts","../src/config.ts","../src/luals.ts","../src/reporter.ts","../node_modules/env-paths/index.d.ts","../src/paths.ts","../src/annotations.ts"],"x_google_ignoreList":[4],"mappings":";;YAEY;YACA;iBAEK;EACf;IACE;IACA;;EAEF;IACE;IACA;;;iBAIa;EACf,OAAO;EACP,UAAU;EACV;EACA;EACA;;YAGU,mBAAmB,eAAe;iBAE7B;EACf;EACA,aAAa;EACb;EACA;EACA;EACA;EACA;EACA;EACA;;iBAGe;EACf;EACA;EACA;EACA;EACA;EACA;EACA,aAAa;;iBAGE;EACf;EACA;IACE;IACA;KACC;;EAEH;IACE;IACA;IACA;KACC;;EAEH;IACE;KACC;;EAEH;IACE;IACA;IACA;IACA,WAAW;IACX,mBAAmB;KAClB;;GAEF;;;;;;wBAOa,cAAc;;;;;;wBCnEd;wBAWA;;;;;wBAmBA;wBAIA;;;;wBAQA,kBAAkB;wBAKlB,WAAW,aAAa,eAAe;wBAavC,eAAe,mBAAmB;;;;;;;;;wBAgBlC,qBAAqB;iBAQpB;EACf;;;;;;;;;;;;wBAac,aACd,MAAM,aACN,WAAU,aACV,0BACA,UAAU,qBACT;iBAmHc;EACf;EACA;;;;;;wBAOc,uBACd,uBACA,2BACA,UAAU;EACP;EAAoB;;iBA6ER;EACf;EACA;;;;;wBAMc,cAAc,uBAAuB,UAAU;;;qBC7TlD;qBACA;;;;;;;;;;;;;;wBA0BG,qBAAqB;;;;wBAkCrB,4BAA4B;;;;wBAOtB,6BAA6B;;;;;;wBAgC7B,oBAAoB,mBAAmB;iBAa5C;EACf;EACA;EACA;EACA;;wBAGc,gBAAgB,mBAA2C;wBAiD3D,YAAY;;;;wBAOZ,kBAAkB;iBAQjB;EACf;;;;;wBAMc,cAAc;wBAoBR,wBACpB,kBACA,oBACA,UAAU,kBACT;iBA4Kc;EACf;;wBAGoB,mBACpB,kBACA,UAAU,sBACT;wBAwGmB,cACpB,oBACA,oBACA,SAAS,eACR,QAAQ;;;;wBA+HK,kBAAkB,oBAAoB;;;;;;;wBCjnBtC;wBAUA,UAAU;;;;;;;;;;;;wBA6BV,oBACd,kBACA;wBAgBc,UAAU,eAAe,kBAAkB;wBAI3C,qBACd,uBACA,gBACA,kBACA;wBAqBc,aACd,QAAQ,aACR,cACA;wBAiFc,wBAAwB,QAAQ,aAAa;wBAsC7C,aACd,QAAQ,aACR,uCACA,cACA;;;KCzNU;;;;;;;;;;WAUF;;;;;;;;;;WAWA;;;;;;;;;;WAWA;;;;;;;;;;WAWA;;;;;;;;;;WAWA;;;;;;;;qBC1DG,aAAA;;;;;wBAMG,WAAW;;;qBCPd;qBACA;qBACA;qBAEA;iBAGI;EACf;EACA;EACA;;iBAGe;EACf;EACA;EACA,MAAM;;qBAGK;qBACA;wBAEG,mBAAmB,IAAG;EAAsB;EAAiB,SAAS;;wBAWtE;wBAIA;wBAIA;wBAIA,wBAAwB,oBAA8C;wBAiBhE,uBAAuB;wBAsBvB,8BAA8B;;;;wBAkCpC,sBACd,kBACA,oBACC;;;;;wBAgCmB,4BACpB,kBACA,mBACA;EAAY;IACX;iBAiHc;EACf;EACA;EACA;;;;;;;;;;wBAWoB,mBAAmB,UAAS,4BAAiC"}

package/dist/index.js

@@ -1,2 +1,2 @@
-import { A as mergeConfigs, C as resolveLuaLSVersion, D as getPackageRoot, E as getDefinitionsDir, M as resolveWorkspaceConfig, N as stripJsonComments, O as initWorkspace, P as fileUriToPath, S as resolveLuaLSBinary, T as getDefaultTemplatePath, _ as escapePowerShellSingleQuote, a as formatGitHubAnnotations, b as isBinaryValid, c as formatReport, d as pluralize, f as shouldEnableColor, g as downloadAndExtractLuaLS, h as countCheckedFiles, i as runCLI, j as parseJsonc, k as loadConfigFile, l as formatSeverityBadge, m as FALLBACK_LUALS_VERSION, n as createProgram, o as formatPretty, p as DEFAULT_LUALS_VERSION, r as isDirectExecution, s as formatProblemSummary, t as collectIgnorePatterns, u as getColors, v as getCacheDir, w as runLuaLSCheck, x as resolveLatestLuaLSVersion, y as getPlatformInfo } from "./cli-kmHD4epr.js";
-export { DEFAULT_LUALS_VERSION, FALLBACK_LUALS_VERSION, collectIgnorePatterns, countCheckedFiles, createProgram, downloadAndExtractLuaLS, escapePowerShellSingleQuote, fileUriToPath, formatGitHubAnnotations, formatPretty, formatProblemSummary, formatReport, formatSeverityBadge, getCacheDir, getColors, getDefaultTemplatePath, getDefinitionsDir, getPackageRoot, getPlatformInfo, initWorkspace, isBinaryValid, isDirectExecution, loadConfigFile, mergeConfigs, parseJsonc, pluralize, resolveLatestLuaLSVersion, resolveLuaLSBinary, resolveLuaLSVersion, resolveWorkspaceConfig, runCLI, runLuaLSCheck, shouldEnableColor, stripJsonComments };
+import { $ as stripTrailingSlashes, A as FALLBACK_LUALS_VERSION, B as resolveLuaLSVersion, C as formatProblemSummary, D as pluralize, E as getColors, F as getLegacyCacheDir, G as getDefinitionsDir, H as sanitizeLuaLSVersion, I as getPlatformInfo, J as loadConfigFile, K as getPackageRoot, L as isBinaryValid, M as downloadAndExtractLuaLS, N as escapePowerShellSingleQuote, O as shouldEnableColor, P as getCacheDir, Q as stripJsonComments, R as resolveLatestLuaLSVersion, S as formatPretty, T as formatSeverityBadge, U as getDefaultAnnotationsPath, V as runLuaLSCheck, W as getDefaultTemplatePath, X as parseJsonc, Y as mergeConfigs, Z as resolveWorkspaceConfig, _ as getTodayDateString, a as ANNOTATIONS_FILENAME, b as updateLastCheckedDate, c as GITHUB_COMMITS_API, d as downloadAndCacheAnnotations, et as cleanCache, f as fetchLatestCommitId, g as getCachedAnnotationsFilePath, h as getAnnotationsMetadataFilePath, i as runCLI, j as countCheckedFiles, k as DEFAULT_LUALS_VERSION, l as METADATA_FILENAME, m as getAnnotationsCacheDir, n as createProgram, nt as fileUriToPath, o as DOCGEN_BRANCH, p as fetchRawAnnotationsContent, q as initWorkspace, r as isDirectExecution, s as DOCGEN_REPO, t as collectIgnorePatterns, tt as systemPaths, u as RAW_ANNOTATIONS_URL, v as readAnnotationsMetadata, w as formatReport, x as formatGitHubAnnotations, y as resolveAnnotations, z as resolveLuaLSBinary } from "./cli-5LLXRlN7.js";
+export { ANNOTATIONS_FILENAME, DEFAULT_LUALS_VERSION, DOCGEN_BRANCH, DOCGEN_REPO, FALLBACK_LUALS_VERSION, GITHUB_COMMITS_API, METADATA_FILENAME, RAW_ANNOTATIONS_URL, cleanCache, collectIgnorePatterns, countCheckedFiles, createProgram, downloadAndCacheAnnotations, downloadAndExtractLuaLS, escapePowerShellSingleQuote, fetchLatestCommitId, fetchRawAnnotationsContent, fileUriToPath, formatGitHubAnnotations, formatPretty, formatProblemSummary, formatReport, formatSeverityBadge, getAnnotationsCacheDir, getAnnotationsMetadataFilePath, getCacheDir, getCachedAnnotationsFilePath, getColors, getDefaultAnnotationsPath, getDefaultTemplatePath, getDefinitionsDir, getLegacyCacheDir, getPackageRoot, getPlatformInfo, getTodayDateString, initWorkspace, isBinaryValid, isDirectExecution, loadConfigFile, mergeConfigs, parseJsonc, pluralize, readAnnotationsMetadata, resolveAnnotations, resolveLatestLuaLSVersion, resolveLuaLSBinary, resolveLuaLSVersion, resolveWorkspaceConfig, runCLI, runLuaLSCheck, sanitizeLuaLSVersion, shouldEnableColor, stripJsonComments, stripTrailingSlashes, systemPaths, updateLastCheckedDate };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nanos-lint",
-  "version": "2.4.0",
+  "version": "2.6.0",
   "description": "Linter and type-checker for nanos world Lua scripts powered by LuaLS",
   "keywords": [
     "nanos-world",
@@ -30,7 +30,6 @@
   "files": [
     "bin",
     "dist",
-    "vendor/nanos-world-vscode-extension/annotations.lua",
     "templates",
     "action.yml",
     "README.md",
@@ -42,14 +41,18 @@
     "lint": "eslint \"src/**/*.ts\" \"tests/**/*.ts\" --max-warnings=0",
     "lint:fix": "eslint \"src/**/*.ts\" \"tests/**/*.ts\" --fix --max-warnings=0",
     "test": "vitest run",
-    "test:watch": "vitest"
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "prepare": "node -e \"try { require('node:child_process').execSync('git config core.hooksPath .githooks'); } catch {}\""
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
     "@types/node": "^26.6.2",
     "@typescript-eslint/eslint-plugin": "^8.70.1",
     "@typescript-eslint/parser": "^8.70.1",
+    "@vitest/coverage-v8": "^5.0.1",
     "commander": "^15.0.0",
+    "env-paths": "^4.0.0",
     "eslint": "^10.11.0",
     "jsonc-parser": "^3.3.1",
     "tsdown": "^0.23.0",