nanos-lint 2.6.0 → 2.7.0

package/dist/cli.js

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

package/dist/index.d.ts

@@ -157,7 +157,13 @@ export declare function sanitizeLuaLSVersion(raw: string): string | null;
  */
 export declare function escapePowerShellSingleQuote(str: string): string;
 /**
- * Resolves the latest available LuaLS release tag from the GitHub API.
+ * Fetches the latest available LuaLS release tag from the GitHub API.
+ * Returns null if the request fails, times out, or receives an invalid tag.
+ */
+export declare function fetchLatestLuaLSVersionFromGitHub(): Promise<string | null>;
+/**
+ * Resolves the latest available LuaLS release tag from the GitHub API,
+ * falling back to FALLBACK_LUALS_VERSION if offline or unreachable.
  */
 export declare function resolveLatestLuaLSVersion(): Promise<string>;
 /**
@@ -173,14 +179,50 @@ export interface PlatformInfo {
   binaryRelativePath: string;
 }
 export declare function getPlatformInfo(version?: string): PlatformInfo;
-export declare function getCacheDir(version?: string): string;
+export declare function getBaseLuaLSCacheDir(): string;
+/**
+ * Cache directory of a LuaLS version. `baseCacheDir` defaults to the system
+ * cache and can be overridden to keep a caller isolated from it.
+ */
+export declare function getCacheDir(version?: string, baseCacheDir?: string): string;
 /**
  * Returns the legacy cache directory used in nanos-lint <= 2.2.1.
  */
 export declare function getLegacyCacheDir(version?: string): string;
+export declare const LUALS_METADATA_FILENAME = "metadata.json";
+export interface LuaLSMetadata {
+  lastCheckedWeek: string;
+  latestVersion: string;
+  lastCheckedDate?: string;
+}
+/**
+ * Calculates the ISO 8601 week string for a given date in the format 'YYYY-Www' (e.g. '2026-W39').
+ */
+export declare function getIsoWeek(d?: Date): string;
+export declare function getLuaLSMetadataPath(baseCacheDir?: string): string;
+export declare function readLuaLSMetadata(baseCacheDir?: string): LuaLSMetadata | null;
+export declare function writeLuaLSMetadata(metadata: LuaLSMetadata, baseCacheDir?: string): void;
+/**
+ * Lists all cached LuaLS versions in baseCacheDir that have a valid .complete marker
+ * and a functional executable binary.
+ */
+export declare function listCachedLuaLSVersions(baseCacheDir?: string): string[];
+/**
+ * Removes older cached LuaLS version directories, preserving keepVersion,
+ * hidden/temporary directories, and metadata files.
+ */
+export declare function cleanupOldCachedLuaLSVersions(keepVersion: string, baseCacheDir?: string): string[];
 export interface DownloadOptions {
   quiet?: boolean;
+  reuseExisting?: boolean;
+  /** Base directory searched for an installed copy when reusing. Defaults to the system cache. */
+  cacheDir?: string;
 }
+/**
+ * Locates an existing, valid LuaLS directory for the specified version in the
+ * primary cache (`baseCacheDir`), the legacy cache, or the package root.
+ */
+export declare function findExistingLuaLSDir(version: string, baseCacheDir?: string): string | null;
 /**
  * Verifies that a LuaLS binary exists, has non-trivial size, and is executable.
  */
@@ -188,6 +230,10 @@ export declare function isBinaryValid(binaryPath: string): boolean;
 export declare function downloadAndExtractLuaLS(version?: string, targetDir?: string, options?: DownloadOptions): Promise<string>;
 export interface ResolveLuaLSOptions {
   quiet?: boolean;
+  /** Cache base directory (version directories, metadata, temp extraction). Defaults to the system cache. */
+  cacheDir?: string;
+  /** Set to `false` to always fetch the archive instead of reusing an installed copy. */
+  reuseExisting?: boolean;
 }
 export declare function resolveLuaLSBinary(version?: string, options?: ResolveLuaLSOptions): Promise<string>;
 export declare function runLuaLSCheck(targetPath: string, configPath: string, options: CheckOptions): Promise<CheckResult>;
@@ -340,5 +386,27 @@ export interface ResolveAnnotationsOptions {
  */
 export declare function resolveAnnotations(options?: ResolveAnnotationsOptions): Promise<string>;
 //#endregion
+//#region src/logger.d.ts
+export type LogLevel = "silent" | "error" | "warn" | "info" | "debug";
+export declare const LOG_LEVELS: ReadonlyArray<LogLevel>;
+export declare const LOG_LEVEL_PRIORITY: Record<LogLevel, number>;
+export declare const DEFAULT_LOG_LEVEL: LogLevel;
+export declare function isValidLogLevel(level: string): level is LogLevel;
+export declare function parseLogLevel(raw?: string | null): LogLevel;
+export declare class Logger {
+  private level;
+  constructor(initialLevel?: LogLevel);
+  setLevel(level: LogLevel): void;
+  getLevel(): LogLevel;
+  isEnabledFor(level: LogLevel): boolean;
+  /** Whether command results should be written; only `silent` disables them. */
+  isOutputEnabled(): boolean;
+  error(...args: unknown[]): void;
+  warn(...args: unknown[]): void;
+  info(...args: unknown[]): void;
+  debug(...args: unknown[]): void;
+}
+export declare const logger: Logger;
+//#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","../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"}
+{"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","../src/logger.ts"],"x_google_ignoreList":[4],"mappings":"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"}

package/dist/index.js

@@ -1,2 +1,2 @@
-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 };
+import { $ as getDefaultAnnotationsPath, A as FALLBACK_LUALS_VERSION, B as getIsoWeek, C as formatProblemSummary, D as pluralize, E as getColors, F as escapePowerShellSingleQuote, G as listCachedLuaLSVersions, H as getLuaLSMetadataPath, I as fetchLatestLuaLSVersionFromGitHub, J as resolveLuaLSBinary, K as readLuaLSMetadata, L as findExistingLuaLSDir, M as cleanupOldCachedLuaLSVersions, N as countCheckedFiles, O as shouldEnableColor, P as downloadAndExtractLuaLS, Q as writeLuaLSMetadata, R as getBaseLuaLSCacheDir, S as formatPretty, T as formatSeverityBadge, U as getPlatformInfo, V as getLegacyCacheDir, W as isBinaryValid, X as runLuaLSCheck, Y as resolveLuaLSVersion, Z as sanitizeLuaLSVersion, _ as getTodayDateString, _t as isValidLogLevel, a as ANNOTATIONS_FILENAME, at as mergeConfigs, b as updateLastCheckedDate, c as GITHUB_COMMITS_API, ct as stripJsonComments, d as downloadAndCacheAnnotations, dt as systemPaths, et as getDefaultTemplatePath, f as fetchLatestCommitId, ft as fileUriToPath, g as getCachedAnnotationsFilePath, gt as Logger, h as getAnnotationsMetadataFilePath, ht as LOG_LEVEL_PRIORITY, i as runCLI, it as loadConfigFile, j as LUALS_METADATA_FILENAME, k as DEFAULT_LUALS_VERSION, l as METADATA_FILENAME, lt as stripTrailingSlashes, m as getAnnotationsCacheDir, mt as LOG_LEVELS, n as createProgram, nt as getPackageRoot, o as DOCGEN_BRANCH, ot as parseJsonc, p as fetchRawAnnotationsContent, pt as DEFAULT_LOG_LEVEL, q as resolveLatestLuaLSVersion, r as isDirectExecution, rt as initWorkspace, s as DOCGEN_REPO, st as resolveWorkspaceConfig, t as collectIgnorePatterns, tt as getDefinitionsDir, u as RAW_ANNOTATIONS_URL, ut as cleanCache, v as readAnnotationsMetadata, vt as logger, w as formatReport, x as formatGitHubAnnotations, y as resolveAnnotations, yt as parseLogLevel, z as getCacheDir } from "./cli-sEO_MZ-K.js";
+export { ANNOTATIONS_FILENAME, DEFAULT_LOG_LEVEL, DEFAULT_LUALS_VERSION, DOCGEN_BRANCH, DOCGEN_REPO, FALLBACK_LUALS_VERSION, GITHUB_COMMITS_API, LOG_LEVELS, LOG_LEVEL_PRIORITY, LUALS_METADATA_FILENAME, Logger, METADATA_FILENAME, RAW_ANNOTATIONS_URL, cleanCache, cleanupOldCachedLuaLSVersions, collectIgnorePatterns, countCheckedFiles, createProgram, downloadAndCacheAnnotations, downloadAndExtractLuaLS, escapePowerShellSingleQuote, fetchLatestCommitId, fetchLatestLuaLSVersionFromGitHub, fetchRawAnnotationsContent, fileUriToPath, findExistingLuaLSDir, formatGitHubAnnotations, formatPretty, formatProblemSummary, formatReport, formatSeverityBadge, getAnnotationsCacheDir, getAnnotationsMetadataFilePath, getBaseLuaLSCacheDir, getCacheDir, getCachedAnnotationsFilePath, getColors, getDefaultAnnotationsPath, getDefaultTemplatePath, getDefinitionsDir, getIsoWeek, getLegacyCacheDir, getLuaLSMetadataPath, getPackageRoot, getPlatformInfo, getTodayDateString, initWorkspace, isBinaryValid, isDirectExecution, isValidLogLevel, listCachedLuaLSVersions, loadConfigFile, logger, mergeConfigs, parseJsonc, parseLogLevel, pluralize, readAnnotationsMetadata, readLuaLSMetadata, resolveAnnotations, resolveLatestLuaLSVersion, resolveLuaLSBinary, resolveLuaLSVersion, resolveWorkspaceConfig, runCLI, runLuaLSCheck, sanitizeLuaLSVersion, shouldEnableColor, stripJsonComments, stripTrailingSlashes, systemPaths, updateLastCheckedDate, writeLuaLSMetadata };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nanos-lint",
-  "version": "2.6.0",
+  "version": "2.7.0",
   "description": "Linter and type-checker for nanos world Lua scripts powered by LuaLS",
   "keywords": [
     "nanos-world",