nanos-lint 3.1.0 → 3.2.1

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

@@ -1 +1 @@
-{"version":3,"file":"cli-dxsaVVVq.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-dxsaVVVq.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;;;;;iBCziCc,sBAAsB,aAAa;UAuBlC;EACf,eAAe;;;iBAID,cAAc,UAAU,uBAAuB;;iBAkVzC,OAAO,kBAAyC;;iBAgEtD,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-Cb3wLBCr.js";
+import { i as runCLI, n as createProgram, r as isDirectExecution, t as collectIgnorePatterns } from "./cli-I16SeKRK.js";
 export { collectIgnorePatterns, createProgram, isDirectExecution, runCLI };

package/dist/index.d.ts

@@ -212,7 +212,7 @@ type RealmPassName = "client" | "server" | "shared";
  * and a realm-specific class table is dropped from the other realm unless it still has
  * instance members there.
  */
-export declare function splitAnnotationsByRealm(text: string): {
+export declare function splitAnnotationsByRealm(text: string, onProgress?: () => void): {
   client: string;
   server: string;
 };
@@ -406,6 +406,8 @@ export declare function validateArchiveMembers(archivePath: string): Promise<{
  * user-supplied `LUALS_BIN` may legitimately be a small wrapper script.
  */
 export declare const MIN_DOWNLOADED_BINARY_SIZE_BYTES = 100000;
+/** Propagates blocked LuaLS execution or cache access without triggering repair. */
+export declare function rethrowLuaLSPermissionError(err: unknown, targetPath: string, operation?: "execute" | "access"): void;
 /**
  * Verifies that a downloaded or cached LuaLS binary exists, has non-trivial
  * size, and is executable.
@@ -433,14 +435,22 @@ export declare function isBinaryRunnable(binaryPath: string): boolean;
  */
 export declare function assertValidLuaLSBinary(binaryPath: string, source: string): string;
 //#endregion
-//#region src/luals/download.d.ts
-export declare const DOWNLOAD_TIMEOUT_MS = 120000;
-export declare const MAX_ARCHIVE_SIZE_BYTES: number;
-export declare const ALLOWED_DOWNLOAD_DOMAINS: readonly string[];
+//#region src/download-guard.d.ts
 /**
- * Validates that a download URL uses HTTPS and targets an allowlisted host.
+ * Shared transport policy for every outbound download performed by nanos-lint.
+ *
+ * `SECURITY.md` requires download requests *and* HTTP redirects to use HTTPS and to stay on
+ * GitHub infrastructure. Redirects are therefore resolved hop by hop in `"manual"` mode: the
+ * default `"follow"` mode contacts the redirect target before any check can run, which would
+ * let a redirect downgrade to plaintext `http://` or reach an internal address.
  */
+export declare const ALLOWED_DOWNLOAD_DOMAINS: readonly string[];
+/** Validates that a URL uses HTTPS and targets an allowlisted GitHub host. */
 export declare function isAllowedDownloadUrl(urlString: string): boolean;
+//#endregion
+//#region src/luals/download.d.ts
+export declare const DOWNLOAD_TIMEOUT_MS = 120000;
+export declare const MAX_ARCHIVE_SIZE_BYTES: number;
 /**
  * Calculates the SHA-256 hash of a file on disk in bounded memory.
  */
@@ -449,6 +459,8 @@ export declare function computeFileSha256(filePath: string): string;
  * Enforces a maximum byte count on an asynchronous download stream.
  */
 export declare function limitDownloadStream(source: AsyncIterable<Uint8Array | Buffer>): AsyncGenerator<Uint8Array | Buffer, void, unknown>;
+/** Reports cumulative transferred bytes while passing a download stream through unchanged. */
+export declare function trackDownloadProgress(source: AsyncIterable<Uint8Array | Buffer>, onProgress: (transferred: number) => void): AsyncGenerator<Uint8Array | Buffer, void, unknown>;
 export interface DownloadOptions {
   reuseExisting?: boolean;
   /** Base directory searched for an installed copy when reusing. Defaults to the system cache. */
@@ -665,17 +677,27 @@ 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;
+/** Stream carrying `info`/`debug` diagnostics; `stderr` keeps stdout machine-readable. */
+export type DiagnosticStream = "stdout" | "stderr";
 /** Validates whether a string corresponds to a recognized log level. */
 export declare function isValidLogLevel(level: string): level is LogLevel;
 /** Parses a string into a valid LogLevel, defaulting to 'warn'. */
 export declare function parseLogLevel(raw?: string | null): LogLevel;
 export declare class Logger {
   private level;
+  private diagnosticStream;
   constructor(initialLevel?: LogLevel);
   /** Sets the active minimum logging level. */
   setLevel(level: LogLevel): void;
   /** Returns the current active log level. */
   getLevel(): LogLevel;
+  /**
+   * Selects the stream used by `info`/`debug`. Machine-readable formats switch this to
+   * `stderr`, so a report on stdout is never interleaved with diagnostic lines.
+   */
+  setDiagnosticStream(stream: DiagnosticStream): void;
+  /** Returns the stream used by `info`/`debug`. */
+  getDiagnosticStream(): DiagnosticStream;
   /** Checks if a message at the specified level should be emitted. */
   isEnabledFor(level: LogLevel): boolean;
   /** Whether command results should be written; only `silent` disables them. */
@@ -684,10 +706,12 @@ export declare class Logger {
   error(...args: unknown[]): void;
   /** Logs a warning-level message to stderr. */
   warn(...args: unknown[]): void;
-  /** Logs an informational message to stdout. */
+  /** Logs an informational message to stdout, or to stderr when stdout carries a report. */
   info(...args: unknown[]): void;
-  /** Logs a debug-level diagnostic message to stdout. */
+  /** Logs a debug-level diagnostic message to stdout, or to stderr when stdout carries a report. */
   debug(...args: unknown[]): void;
+  /** Writes an `info`/`debug` diagnostic on the configured stream. */
+  private emitDiagnostic;
 }
 export declare const logger: Logger;
 //#endregion
@@ -797,5 +821,63 @@ export interface ResolvedDependencyRealms {
  */
 export declare function resolvePackageDependencies(root: string, userConfig: LuaRCConfig, cliDeps?: string[]): ResolvedDependencyRealms;
 //#endregion
+//#region src/terminal-progress.d.ts
+/** Minimum delay between two terminal redraws (about ten frames per second). */
+export declare const PROGRESS_THROTTLE_MS = 100;
+/** Braille frames cycled while an indeterminate operation runs. */
+export declare const SPINNER_FRAMES: readonly string[];
+/** Fractions of a transfer logged as milestones when no terminal can be redrawn. */
+export declare const PROGRESS_MILESTONES: readonly number[];
+/** Redraw policy: `auto` follows terminal detection, `off` forces log milestones. */
+export type ProgressMode = "auto" | "off";
+/** Terminal stream receiving progress frames, mirroring the parts of `tty.WriteStream` used. */
+export interface ProgressStream {
+  write(chunk: string): unknown;
+  columns?: number | undefined;
+  isTTY?: boolean | undefined;
+}
+/** Options shared by progress bars and spinners. */
+export interface ProgressOptions {
+  label: string;
+  total?: number | undefined;
+  stream?: ProgressStream | undefined;
+  interactive?: boolean | undefined;
+  announce?: boolean | undefined;
+  now?: (() => number) | undefined;
+  throttleMs?: number | undefined;
+}
+export type ProgressBarOptions = ProgressOptions;
+/** Handle to a running byte progress bar. */
+export interface ProgressBarHandle {
+  update(transferred: number, total?: number): void;
+  finish(message?: string): void;
+  fail(message?: string): void;
+}
+/** Handle to a running indeterminate spinner. */
+export interface SpinnerHandle {
+  start(): void;
+  tick(): void;
+  updateText(label: string): void;
+  stop(message?: string): void;
+  fail(message?: string): void;
+}
+/** Sets the redraw policy used by every progress display created afterwards. */
+export declare function setProgressMode(mode: ProgressMode): void;
+/** Returns the current redraw policy. */
+export declare function getProgressMode(): ProgressMode;
+/**
+ * Returns whether dynamic redrawing is allowed for the given environment and terminal.
+ * Non-interactive environments get single-line milestones instead of carriage returns.
+ */
+export declare function isProgressInteractive(env?: NodeJS.ProcessEnv, isTTY?: boolean | undefined): boolean;
+/** Restores the cursor and abandons the active progress line; safe to call at any time. */
+export declare function restoreTerminal(): void;
+/** Formats a completed transfer as size, duration and average speed. */
+export declare function formatTransferSummary(bytes: number, elapsedMs: number): string;
+/** Creates a byte progress bar; without a terminal it logs start, milestones and completion. */
+export declare function createProgressBar(options: ProgressBarOptions): ProgressBarHandle;
+/** Creates an indeterminate spinner driven by a timer and by manual ticks from sync loops. */
+export declare function createSpinner(options: ProgressOptions): SpinnerHandle;
+//#endregion
 export { CreateProgramOptions, type DerivedRealmAnnotations, type RealmPassName, collectIgnorePatterns, createProgram, isDirectExecution, runCLI };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":["_$env_paths0.Paths"],"sources":["../src/types.ts","../src/config.ts","../src/annotations-realms.ts","../src/realms.ts","../src/luals/version.ts","../src/luals/platform.ts","../src/luals/cache.ts","../src/luals/validation.ts","../src/luals/download.ts","../src/luals/files.ts","../src/luals/runner.ts","../src/reporter.ts","../node_modules/env-paths/index.d.ts","../src/paths.ts","../src/annotations-metadata.ts","../src/annotations-download.ts","../src/annotations.ts","../src/logger.ts","../src/errors.ts","../src/cache-status.ts","../src/target-resolver.ts","../src/deps.ts"],"x_google_ignoreList":[12],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":["_$env_paths0.Paths"],"sources":["../src/types.ts","../src/config.ts","../src/annotations-realms.ts","../src/realms.ts","../src/luals/version.ts","../src/luals/platform.ts","../src/luals/cache.ts","../src/luals/validation.ts","../src/download-guard.ts","../src/luals/download.ts","../src/luals/files.ts","../src/luals/runner.ts","../src/reporter.ts","../node_modules/env-paths/index.d.ts","../src/paths.ts","../src/annotations-metadata.ts","../src/annotations-download.ts","../src/annotations.ts","../src/logger.ts","../src/errors.ts","../src/cache-status.ts","../src/target-resolver.ts","../src/deps.ts","../src/terminal-progress.ts"],"x_google_ignoreList":[13],"mappings":"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"}

package/dist/index.js

@@ -1,2 +1,2 @@
-import { $ as ALLOWED_DOWNLOAD_DOMAINS, $t as stripJsonComments, A as formatProblemSummary, At as getPlatformInfo, B as resolvePackageDependencies, Bt as VALID_LUALS_DIAGNOSTIC_CODES, C as getCachedAnnotationsFilePath, Ct as inspectZipMembers, D as updateLastCheckedDate, Dt as isZipArchive, E as readAnnotationsMetadata, Et as isGzipArchive, F as shouldEnableColor, Ft as resolveLuaLSVersion, G as computeUnrequestedExclusions, Gt as getPackageRoot, H as runLuaLSCheck, Ht as getDefaultAnnotationsPath, I as collectRealmFiles, It as sanitizeLuaLSVersion, J as findProjectRoot, Jt as loadUserConfig, K as filterReportByTargetPaths, Kt as initWorkspace, L as planRealmCheck, Lt as deriveRealmAnnotationFiles, M as formatSeverityBadge, Mt as FALLBACK_LUALS_VERSION, N as getColors, Nt as fetchLatestLuaLSVersionFromGitHub, O as formatGitHubAnnotations, Ot as parseTarTvSize, P as pluralize, Pt as resolveLatestLuaLSVersion, Q as resolveCheckTargets, Qt as resolveWorkspaceConfig, R as runRealmAwareCheck, Rt as splitAnnotationsByRealm, S as getAnnotationsMetadataFilePath, St as getTarBinary, T as isAnnotationsValid, Tt as isBinaryValid, U as countCheckedFiles, Ut as getDefaultTemplatePath, V as resolveLuaLSBinary, Vt as buildWorkspaceConfig, W as listCheckedFiles, Wt as getDefinitionsDir, X as isFilesystemRoot, Xt as parseJsonc, Y as getCanonicalPath, Yt as mergeConfigs, Z as matchesTargetPaths, Zt as resolveRealmMappings, _ as MAX_ANNOTATIONS_SIZE_BYTES, _n as logger, _t as MAX_ARCHIVE_MEMBER_COUNT, a as formatCacheStatusPretty, an as LuaLSError, at as limitDownloadStream, b as MIN_ANNOTATIONS_SIZE_BYTES, bt as assertValidLuaLSBinary, c as DOCGEN_BRANCH, cn as formatBytes, ct as findExistingLuaLSDir, d as RAW_ANNOTATIONS_URL, dn as fileUriToPath, dt as getIsoWeek, en as stripTrailingSlashes, et as DOWNLOAD_TIMEOUT_MS, f as downloadAndCacheAnnotations, fn as DEFAULT_LOG_LEVEL, ft as getLuaLSMetadataPath, g as ANNOTATIONS_FILENAME, gn as isValidLogLevel, gt as writeLuaLSMetadata, h as getRawAnnotationsUrl, hn as Logger, ht as readLuaLSMetadata, i as runCLI, in as ConfigError, it as isAllowedDownloadUrl, j as formatReport, jt as DEFAULT_LUALS_VERSION, k as formatPretty, kt as validateArchiveMembers, l as DOCGEN_REPO, ln as getDirectorySize, lt as getBaseLuaLSCacheDir, m as fetchRawAnnotationsContent, mn as LOG_LEVEL_PRIORITY, mt as listCachedLuaLSVersions, n as createProgram, nn as AnnotationsError, nt as computeFileSha256, o as getCacheStatus, on as NanosLintError, ot as LUALS_METADATA_FILENAME, p as fetchLatestCommitId, pn as LOG_LEVELS, pt as listCachedLuaLSVersionDirs, q as findCommonAncestorDirectory, qt as loadConfigFile, r as isDirectExecution, rn as CacheError, rt as downloadAndExtractLuaLS, s as resolveAnnotations, sn as cleanCache, st as cleanupOldCachedLuaLSVersions, t as collectIgnorePatterns, tn as writeTempConfig, tt as MAX_ARCHIVE_SIZE_BYTES, u as GITHUB_COMMITS_API, un as systemPaths, ut as getCacheDir, v as MAX_COMMIT_JSON_SIZE_BYTES, vn as parseLogLevel, vt as MAX_DECOMPRESSED_SIZE_BYTES, w as getTodayDateString, wt as isBinaryRunnable, x as getAnnotationsCacheDir, xt as escapePowerShellSingleQuote, y as METADATA_FILENAME, yt as MIN_DOWNLOADED_BINARY_SIZE_BYTES, z as collectDeps, zt as DEFAULT_REALM_MAPPINGS } from "./cli-Cb3wLBCr.js";
-export { ALLOWED_DOWNLOAD_DOMAINS, ANNOTATIONS_FILENAME, AnnotationsError, CacheError, ConfigError, DEFAULT_LOG_LEVEL, DEFAULT_LUALS_VERSION, DEFAULT_REALM_MAPPINGS, DOCGEN_BRANCH, DOCGEN_REPO, DOWNLOAD_TIMEOUT_MS, FALLBACK_LUALS_VERSION, GITHUB_COMMITS_API, LOG_LEVELS, LOG_LEVEL_PRIORITY, LUALS_METADATA_FILENAME, Logger, LuaLSError, MAX_ANNOTATIONS_SIZE_BYTES, MAX_ARCHIVE_MEMBER_COUNT, MAX_ARCHIVE_SIZE_BYTES, MAX_COMMIT_JSON_SIZE_BYTES, MAX_DECOMPRESSED_SIZE_BYTES, METADATA_FILENAME, MIN_ANNOTATIONS_SIZE_BYTES, MIN_DOWNLOADED_BINARY_SIZE_BYTES, NanosLintError, RAW_ANNOTATIONS_URL, VALID_LUALS_DIAGNOSTIC_CODES, assertValidLuaLSBinary, buildWorkspaceConfig, cleanCache, cleanupOldCachedLuaLSVersions, collectDeps, collectIgnorePatterns, collectRealmFiles, computeFileSha256, computeUnrequestedExclusions, countCheckedFiles, createProgram, deriveRealmAnnotationFiles, downloadAndCacheAnnotations, downloadAndExtractLuaLS, escapePowerShellSingleQuote, fetchLatestCommitId, fetchLatestLuaLSVersionFromGitHub, fetchRawAnnotationsContent, fileUriToPath, filterReportByTargetPaths, findCommonAncestorDirectory, findExistingLuaLSDir, findProjectRoot, formatBytes, formatCacheStatusPretty, formatGitHubAnnotations, formatPretty, formatProblemSummary, formatReport, formatSeverityBadge, getAnnotationsCacheDir, getAnnotationsMetadataFilePath, getBaseLuaLSCacheDir, getCacheDir, getCacheStatus, getCachedAnnotationsFilePath, getCanonicalPath, getColors, getDefaultAnnotationsPath, getDefaultTemplatePath, getDefinitionsDir, getDirectorySize, getIsoWeek, getLuaLSMetadataPath, getPackageRoot, getPlatformInfo, getRawAnnotationsUrl, getTarBinary, getTodayDateString, initWorkspace, inspectZipMembers, isAllowedDownloadUrl, isAnnotationsValid, isBinaryRunnable, isBinaryValid, isDirectExecution, isFilesystemRoot, isGzipArchive, isValidLogLevel, isZipArchive, limitDownloadStream, listCachedLuaLSVersionDirs, listCachedLuaLSVersions, listCheckedFiles, loadConfigFile, loadUserConfig, logger, matchesTargetPaths, mergeConfigs, parseJsonc, parseLogLevel, parseTarTvSize, planRealmCheck, pluralize, readAnnotationsMetadata, readLuaLSMetadata, resolveAnnotations, resolveCheckTargets, resolveLatestLuaLSVersion, resolveLuaLSBinary, resolveLuaLSVersion, resolvePackageDependencies, resolveRealmMappings, resolveWorkspaceConfig, runCLI, runLuaLSCheck, runRealmAwareCheck, sanitizeLuaLSVersion, shouldEnableColor, splitAnnotationsByRealm, stripJsonComments, stripTrailingSlashes, systemPaths, updateLastCheckedDate, validateArchiveMembers, writeLuaLSMetadata, writeTempConfig };
+import { $ as DOWNLOAD_TIMEOUT_MS, $t as buildWorkspaceConfig, A as formatProblemSummary, An as parseLogLevel, At as getPlatformInfo, B as resolvePackageDependencies, Bt as splitAnnotationsByRealm, C as getCachedAnnotationsFilePath, Cn as fileUriToPath, Ct as isBinaryRunnable, D as updateLastCheckedDate, Dn as Logger, Dt as parseTarTvSize, E as readAnnotationsMetadata, En as LOG_LEVEL_PRIORITY, Et as isZipArchive, F as shouldEnableColor, Ft as resolveLuaLSVersion, G as computeUnrequestedExclusions, Gt as createSpinner, H as runLuaLSCheck, Ht as PROGRESS_THROTTLE_MS, I as collectRealmFiles, It as sanitizeLuaLSVersion, J as findProjectRoot, Jt as isProgressInteractive, K as filterReportByTargetPaths, Kt as formatTransferSummary, L as planRealmCheck, Lt as ALLOWED_DOWNLOAD_DOMAINS, M as formatSeverityBadge, Mt as FALLBACK_LUALS_VERSION, N as getColors, Nt as fetchLatestLuaLSVersionFromGitHub, O as formatGitHubAnnotations, On as isValidLogLevel, Ot as rethrowLuaLSPermissionError, P as pluralize, Pt as resolveLatestLuaLSVersion, Q as resolveCheckTargets, Qt as VALID_LUALS_DIAGNOSTIC_CODES, R as runRealmAwareCheck, Rt as isAllowedDownloadUrl, S as getAnnotationsMetadataFilePath, Sn as systemPaths, St as inspectZipMembers, T as isAnnotationsValid, Tn as LOG_LEVELS, Tt as isGzipArchive, U as countCheckedFiles, Ut as SPINNER_FRAMES, V as resolveLuaLSBinary, Vt as PROGRESS_MILESTONES, W as listCheckedFiles, Wt as createProgressBar, X as isFilesystemRoot, Xt as setProgressMode, Y as getCanonicalPath, Yt as restoreTerminal, Z as matchesTargetPaths, Zt as DEFAULT_REALM_MAPPINGS, _ as MAX_ANNOTATIONS_SIZE_BYTES, _n as LuaLSError, _t as MAX_DECOMPRESSED_SIZE_BYTES, a as formatCacheStatusPretty, an as loadConfigFile, at as LUALS_METADATA_FILENAME, b as MIN_ANNOTATIONS_SIZE_BYTES, bn as formatBytes, bt as escapePowerShellSingleQuote, c as DOCGEN_BRANCH, cn as parseJsonc, ct as getBaseLuaLSCacheDir, d as RAW_ANNOTATIONS_URL, dn as stripJsonComments, dt as getLuaLSMetadataPath, en as getDefaultAnnotationsPath, et as MAX_ARCHIVE_SIZE_BYTES, f as downloadAndCacheAnnotations, fn as stripTrailingSlashes, ft as listCachedLuaLSVersionDirs, g as ANNOTATIONS_FILENAME, gn as ConfigError, gt as MAX_ARCHIVE_MEMBER_COUNT, h as getRawAnnotationsUrl, hn as CacheError, ht as writeLuaLSMetadata, i as runCLI, in as initWorkspace, it as trackDownloadProgress, j as formatReport, jt as DEFAULT_LUALS_VERSION, k as formatPretty, kn as logger, kt as validateArchiveMembers, l as DOCGEN_REPO, ln as resolveRealmMappings, lt as getCacheDir, m as fetchRawAnnotationsContent, mn as AnnotationsError, mt as readLuaLSMetadata, n as createProgram, nn as getDefinitionsDir, nt as downloadAndExtractLuaLS, o as getCacheStatus, on as loadUserConfig, ot as cleanupOldCachedLuaLSVersions, p as fetchLatestCommitId, pn as writeTempConfig, pt as listCachedLuaLSVersions, q as findCommonAncestorDirectory, qt as getProgressMode, r as isDirectExecution, rn as getPackageRoot, rt as limitDownloadStream, s as resolveAnnotations, sn as mergeConfigs, st as findExistingLuaLSDir, t as collectIgnorePatterns, tn as getDefaultTemplatePath, tt as computeFileSha256, u as GITHUB_COMMITS_API, un as resolveWorkspaceConfig, ut as getIsoWeek, v as MAX_COMMIT_JSON_SIZE_BYTES, vn as NanosLintError, vt as MIN_DOWNLOADED_BINARY_SIZE_BYTES, w as getTodayDateString, wn as DEFAULT_LOG_LEVEL, wt as isBinaryValid, x as getAnnotationsCacheDir, xn as getDirectorySize, xt as getTarBinary, y as METADATA_FILENAME, yn as cleanCache, yt as assertValidLuaLSBinary, z as collectDeps, zt as deriveRealmAnnotationFiles } from "./cli-I16SeKRK.js";
+export { ALLOWED_DOWNLOAD_DOMAINS, ANNOTATIONS_FILENAME, AnnotationsError, CacheError, ConfigError, DEFAULT_LOG_LEVEL, DEFAULT_LUALS_VERSION, DEFAULT_REALM_MAPPINGS, DOCGEN_BRANCH, DOCGEN_REPO, DOWNLOAD_TIMEOUT_MS, FALLBACK_LUALS_VERSION, GITHUB_COMMITS_API, LOG_LEVELS, LOG_LEVEL_PRIORITY, LUALS_METADATA_FILENAME, Logger, LuaLSError, MAX_ANNOTATIONS_SIZE_BYTES, MAX_ARCHIVE_MEMBER_COUNT, MAX_ARCHIVE_SIZE_BYTES, MAX_COMMIT_JSON_SIZE_BYTES, MAX_DECOMPRESSED_SIZE_BYTES, METADATA_FILENAME, MIN_ANNOTATIONS_SIZE_BYTES, MIN_DOWNLOADED_BINARY_SIZE_BYTES, NanosLintError, PROGRESS_MILESTONES, PROGRESS_THROTTLE_MS, RAW_ANNOTATIONS_URL, SPINNER_FRAMES, VALID_LUALS_DIAGNOSTIC_CODES, assertValidLuaLSBinary, buildWorkspaceConfig, cleanCache, cleanupOldCachedLuaLSVersions, collectDeps, collectIgnorePatterns, collectRealmFiles, computeFileSha256, computeUnrequestedExclusions, countCheckedFiles, createProgram, createProgressBar, createSpinner, deriveRealmAnnotationFiles, downloadAndCacheAnnotations, downloadAndExtractLuaLS, escapePowerShellSingleQuote, fetchLatestCommitId, fetchLatestLuaLSVersionFromGitHub, fetchRawAnnotationsContent, fileUriToPath, filterReportByTargetPaths, findCommonAncestorDirectory, findExistingLuaLSDir, findProjectRoot, formatBytes, formatCacheStatusPretty, formatGitHubAnnotations, formatPretty, formatProblemSummary, formatReport, formatSeverityBadge, formatTransferSummary, getAnnotationsCacheDir, getAnnotationsMetadataFilePath, getBaseLuaLSCacheDir, getCacheDir, getCacheStatus, getCachedAnnotationsFilePath, getCanonicalPath, getColors, getDefaultAnnotationsPath, getDefaultTemplatePath, getDefinitionsDir, getDirectorySize, getIsoWeek, getLuaLSMetadataPath, getPackageRoot, getPlatformInfo, getProgressMode, getRawAnnotationsUrl, getTarBinary, getTodayDateString, initWorkspace, inspectZipMembers, isAllowedDownloadUrl, isAnnotationsValid, isBinaryRunnable, isBinaryValid, isDirectExecution, isFilesystemRoot, isGzipArchive, isProgressInteractive, isValidLogLevel, isZipArchive, limitDownloadStream, listCachedLuaLSVersionDirs, listCachedLuaLSVersions, listCheckedFiles, loadConfigFile, loadUserConfig, logger, matchesTargetPaths, mergeConfigs, parseJsonc, parseLogLevel, parseTarTvSize, planRealmCheck, pluralize, readAnnotationsMetadata, readLuaLSMetadata, resolveAnnotations, resolveCheckTargets, resolveLatestLuaLSVersion, resolveLuaLSBinary, resolveLuaLSVersion, resolvePackageDependencies, resolveRealmMappings, resolveWorkspaceConfig, restoreTerminal, rethrowLuaLSPermissionError, runCLI, runLuaLSCheck, runRealmAwareCheck, sanitizeLuaLSVersion, setProgressMode, shouldEnableColor, splitAnnotationsByRealm, stripJsonComments, stripTrailingSlashes, systemPaths, trackDownloadProgress, updateLastCheckedDate, validateArchiveMembers, writeLuaLSMetadata, writeTempConfig };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nanos-lint",
-  "version": "3.1.0",
+  "version": "3.2.1",
   "description": "Linter and type-checker for nanos world Lua scripts powered by LuaLS",
   "keywords": [
     "nanos-world",
@@ -57,7 +57,7 @@
     "@types/node": "^26.6.2",
     "@typescript-eslint/eslint-plugin": "^8.70.1",
     "@typescript-eslint/parser": "^8.70.1",
-    "@vitest/coverage-v8": "^5.0.2",
+    "@vitest/coverage-v8": "^5.0.3",
     "commander": "^15.0.0",
     "dependency-cruiser": "^18.4.0",
     "env-paths": "^4.0.0",
@@ -70,7 +70,7 @@
     "tsx": "^4.23.15",
     "typescript": "^6.0.3",
     "typescript-eslint": "^8.70.1",
-    "vitest": "^5.0.2"
+    "vitest": "^5.0.3"
   },
   "engines": {
     "node": ">=24.0.0"