nanos-lint 2.8.2 → 3.0.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":"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"}

package/dist/cli.js

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

package/dist/index.d.ts

@@ -27,7 +27,6 @@ export interface CheckOptions {
   lualsVersion?: string;
   format?: "pretty" | "json" | "github";
   failOnError?: boolean;
-  quiet?: boolean;
   lualsBin?: string;
   ignore?: string[];
 }
@@ -40,6 +39,14 @@ export interface CheckResult {
   totalFilesChecked?: number;
   diagnostics: DiagnosticReport;
 }
+/** Execution realm of a nanos world script, as loaded by the server or client VM. */
+export type RealmName = "client" | "server" | "shared" | "global";
+/** nanos-lint specific settings embedded in `.luarc.json` under the `nanos` key. */
+export interface NanosConfig {
+  /** Maps glob patterns (relative to the checked root) to realm names. */
+  realms?: Record<string, RealmName>;
+  [key: string]: unknown;
+}
 export interface LuaRCConfig {
   $schema?: string;
   runtime?: {
@@ -66,6 +73,7 @@ export interface LuaRCConfig {
     neededFileStatus?: Record<string, string>;
     [key: string]: unknown;
   };
+  nanos?: NanosConfig;
   [key: string]: unknown;
 }
 /**
@@ -131,13 +139,48 @@ export interface ResolveWorkspaceConfigOptions {
   annotationsPath?: string;
 }
 /**
- * Discovers any existing workspace configuration and returns the path to an active
- * configuration file with nanos definitions properly injected.
+ * Loads the user workspace configuration from `--config` or `<workspace>/.luarc.json`,
+ * returning an empty object when neither exists. Parse failures are reported with the
+ * offending path so a broken `.luarc.json` is never silently ignored.
+ */
+export declare function loadUserConfig(workspacePath: string, customConfigPath?: string): LuaRCConfig;
+/** Writes a merged configuration to a unique temporary file and returns its path. */
+export declare function writeTempConfig(config: LuaRCConfig): string;
+/**
+ * Discovers any existing workspace configuration and merges it with the nanos template,
+ * returning a LuaLS-ready configuration object without writing anything to disk.
+ */
+export declare function buildWorkspaceConfig(workspacePath: string, customConfigPath?: string, options?: ResolveWorkspaceConfigOptions): LuaRCConfig;
+/**
+ * Builds the merged workspace configuration for a single standard LuaLS pass and writes
+ * it to a temporary file (deleted by the caller after the run).
  */
 export declare function resolveWorkspaceConfig(workspacePath: string, customConfigPath?: string, options?: ResolveWorkspaceConfigOptions): {
   configPath: string;
   isTemp: boolean;
 };
+/** A glob pattern (relative to the checked root) bound to an execution realm. */
+export interface RealmMapping {
+  pattern: string;
+  realm: "client" | "server" | "shared";
+}
+/** Conventional nanos world package layout used when `nanos.realms` is omitted. */
+export declare const DEFAULT_REALM_MAPPINGS: ReadonlyArray<RealmMapping>;
+export interface ResolvedRealmMappings {
+  /** `false` when the user explicitly disabled realms with `nanos.realms: {}`. */
+  enabled: boolean;
+  mappings: RealmMapping[];
+}
+/**
+ * Resolves the realm mappings declared in `nanos.realms`.
+ *
+ * - The key is omitted: the conventional `Server/**`, `Client/**`, `Shared/**` layout is
+ *   used, and realms only activate when those patterns actually match files (#15, #35).
+ * - The key is `{}`: realms are disabled and a single standard pass runs.
+ * - Otherwise the declared mapping replaces the defaults, and `global` is accepted as an
+ *   alias of `shared`. Unusable entries are dropped with a warning.
+ */
+export declare function resolveRealmMappings(userConfig: LuaRCConfig): ResolvedRealmMappings;
 export interface InitWorkspaceOptions {
   force?: boolean;
   annotationsPath?: string;
@@ -147,6 +190,82 @@ export interface InitWorkspaceOptions {
  */
 export declare function initWorkspace(workspacePath: string, options?: InitWorkspaceOptions): string;
 //#endregion
+//#region src/annotations-realms.d.ts
+/** Realm name used by a pass; `global` is normalized to `shared` before this point. */
+type RealmPassName = "client" | "server" | "shared";
+/**
+ * Splits a nanos world `annotations.lua` into realm-scoped libraries (#15).
+ *
+ * Upstream marks every declaration with a side image, so the split is data-driven:
+ * `both`/`authority` stay in every realm, `client-only` and `server-only` are restricted
+ * to their own realm, unmarked declarations inherit their class or sibling member realm,
+ * 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): {
+  client: string;
+  server: string;
+};
+interface DerivedRealmAnnotations {
+  client: string;
+  server: string;
+}
+/**
+ * Derives `annotations.client.lua` and `annotations.server.lua` from the resolved
+ * annotations file, caching them under the system cache keyed by the source revision.
+ * A concurrent derivation is safe: files are written atomically (#7).
+ */
+export declare function deriveRealmAnnotationFiles(annotationsPath: string, cacheDir?: string): DerivedRealmAnnotations;
+//#endregion
+//#region src/realms.d.ts
+/** `--realm` selection: `all` runs every pass, others keep the shared pass too. */
+export type RealmSelection = "all" | RealmPassName;
+export interface RealmFileSets {
+  client: string[];
+  server: string[];
+  /** Files matched by a shared/global pattern. */
+  shared: string[];
+  /** Files matched by no pattern: they are checked with full context. */
+  unmatched: string[];
+}
+/**
+ * Assigns every checked Lua file to a realm, returning the paths exactly as they are on
+ * disk (comparisons are case-insensitive on Windows). The last matching `nanos.realms`
+ * entry wins, and files matched by no entry belong to the shared (full-context) pass.
+ */
+export declare function collectRealmFiles(root: string, mappings: RealmMapping[], checkedFiles: string[]): RealmFileSets;
+export interface RealmPass {
+  realm: RealmPassName;
+  configPath: string;
+  /** Workspace-relative files whose diagnostics belong to this pass. */
+  reportFiles: Set<string>;
+}
+export interface RealmCheckPlan {
+  baseConfigPath: string;
+  passes: RealmPass[];
+  cleanup: () => void;
+}
+export interface PlanRealmCheckOptions {
+  targetPath: string;
+  userConfig: LuaRCConfig;
+  selection: RealmSelection;
+  annotationsPath: string;
+  customConfigPath?: string;
+  ignore?: string[];
+}
+/**
+ * Plans realm-aware checking for a target. Returns `null` when a single standard pass is
+ * the right answer: realms disabled, the target is a file, or no configured realm pattern
+ * matches a checked Lua file.
+ */
+export declare function planRealmCheck(options: PlanRealmCheckOptions): RealmCheckPlan | null;
+/**
+ * Runs every planned realm pass, merges the per-realm reports into one result, and
+ * recomputes the totals. Shared files are reported by the full-context pass only, so a
+ * file never yields duplicate diagnostics.
+ */
+export declare function runRealmAwareCheck(plan: RealmCheckPlan, targetPath: string, options: CheckOptions): Promise<CheckResult>;
+//#endregion
 //#region src/luals/version.d.ts
 export declare const FALLBACK_LUALS_VERSION = "3.19.1";
 export declare const DEFAULT_LUALS_VERSION = "latest";
@@ -190,10 +309,6 @@ export declare function getBaseLuaLSCacheDir(): string;
  * 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;
@@ -208,7 +323,10 @@ export declare function getIsoWeek(d?: Date): string;
 export declare function getLuaLSMetadataPath(baseCacheDir?: string): string;
 /** Reads and parses the LuaLS metadata.json file, purging corrupted or invalid files automatically. */
 export declare function readLuaLSMetadata(baseCacheDir?: string): LuaLSMetadata | null;
-/** Writes metadata.json containing the latest checked version and timestamp. */
+/**
+ * Writes metadata.json containing the latest checked version and timestamp.
+ * The write is atomic (#7), so a parallel reader never observes a half-written file.
+ */
 export declare function writeLuaLSMetadata(metadata: LuaLSMetadata, baseCacheDir?: string): void;
 /**
  * Lists all candidate LuaLS version directories under baseCacheDir without running
@@ -227,7 +345,7 @@ export declare function listCachedLuaLSVersions(baseCacheDir?: string): string[]
 export declare function cleanupOldCachedLuaLSVersions(keepVersion: string, baseCacheDir?: string): string[];
 /**
  * Locates an existing, valid LuaLS directory for the specified version in the
- * primary cache (`baseCacheDir`), the legacy cache, or the package root.
+ * primary cache (`baseCacheDir`) or the package root.
  */
 export declare function findExistingLuaLSDir(version: string, baseCacheDir?: string): string | null;
 //#endregion
@@ -250,7 +368,12 @@ export declare const MAX_ARCHIVE_MEMBER_COUNT = 10000;
 export declare function parseTarTvSize(line: string): number;
 /** Locates the platform tar executable path, checking System32 on Windows. */
 export declare function getTarBinary(): string;
-/** Pre-inspects a ZIP archive's central directory to enforce extraction safety constraints (#31). */
+/**
+ * Pre-inspects a ZIP archive's central directory to enforce extraction safety
+ * constraints (#31). Fails closed: the directory is walked record by record and
+ * rejected unless the walk terminates on a valid end record, matches the
+ * declared member count and central directory size, and holds at least one member.
+ */
 export declare function inspectZipMembers(archivePath: string): {
   memberCount: number;
   totalDeclaredSize: number;
@@ -315,21 +438,31 @@ export declare function computeFileSha256(filePath: string): string;
  */
 export declare function limitDownloadStream(source: AsyncIterable<Uint8Array | Buffer>): AsyncGenerator<Uint8Array | Buffer, void, unknown>;
 export interface DownloadOptions {
-  quiet?: boolean;
   reuseExisting?: boolean;
   /** Base directory searched for an installed copy when reusing. Defaults to the system cache. */
   cacheDir?: string;
 }
-/** Downloads, verifies, and extracts the LuaLS release archive for the current platform. */
+/**
+ * Downloads, verifies, and extracts the LuaLS release archive for the current platform.
+ *
+ * Concurrent callers targeting the same cache directory serialize on a version lock
+ * (`.luals-<version>.lock`) and the completion check is repeated once the lock is held,
+ * so exactly one worker downloads while the others reuse the promoted directory (#7).
+ */
 export declare function downloadAndExtractLuaLS(version?: string, targetDir?: string, options?: DownloadOptions): Promise<string>;
 //#endregion
 //#region src/luals/files.d.ts
+/**
+ * Lists the Lua files LuaLS checks under `targetPath` as slash-normalized relative paths,
+ * honoring `workspace.ignoreDir` and `files.exclude` (#27). Absolute paths are returned
+ * for single-file targets, and an empty list is returned when the walk fails.
+ */
+export declare function listCheckedFiles(targetPath: string, configPath?: string): string[];
 /** Counts candidate Lua files within targetPath, taking workspace ignoreDir and files.exclude into account (#27). */
 export declare function countCheckedFiles(targetPath: string, configPath?: string): number;
 //#endregion
 //#region src/luals/runner.d.ts
 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. */
@@ -492,16 +625,18 @@ export declare function fetchLatestCommitId(): Promise<string | null>;
 export declare function getRawAnnotationsUrl(commitSha?: string): string;
 /** Downloads raw annotations.lua content from GitHub raw content endpoints. */
 export declare function fetchRawAnnotationsContent(commitSha?: string): Promise<string>;
-/** Downloads annotations.lua and writes metadata in a chained atomic transaction with rollback. */
-export declare function downloadAndCacheAnnotations(commitId: string, cacheDir?: string, options?: {
-  quiet?: boolean;
-}): Promise<string>;
+/**
+ * Downloads annotations.lua and writes it with its metadata inside an exclusive cache
+ * lock (`.annotations.lock`). The completion check is repeated once the lock is held, so
+ * parallel callers reuse the file a concurrent worker just wrote instead of racing on
+ * the same paths, and both files are replaced atomically (#7).
+ */
+export declare function downloadAndCacheAnnotations(commitId: string, cacheDir?: string): Promise<string>;
 //#endregion
 //#region src/annotations.d.ts
 export interface ResolveAnnotationsOptions {
   customPath?: string;
   cacheDir?: string;
-  quiet?: boolean;
 }
 /**
  * Resolves the nanos world annotations.lua definitions file path.
@@ -600,5 +735,5 @@ export declare function getCacheStatus(baseCacheDir?: string): CacheStatusReport
 /** Formats a cache status report into human-readable terminal output. */
 export declare function formatCacheStatusPretty(report: CacheStatusReport): string;
 //#endregion
-export { CreateProgramOptions, collectIgnorePatterns, createProgram, isDirectExecution, runCLI };
+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":[],"sources":["../src/types.ts","../src/config.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"],"x_google_ignoreList":[10],"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/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"],"x_google_ignoreList":[12],"mappings":"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"}

package/dist/index.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nanos-lint",
-  "version": "2.8.2",
+  "version": "3.0.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.1",
+    "@vitest/coverage-v8": "^5.0.2",
     "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.1"
+    "vitest": "^5.0.2"
   },
   "engines": {
     "node": ">=24.0.0"

package/templates/.luarc.json

@@ -38,5 +38,12 @@
       "unused-local": "Warning",
       "unused-vararg": "Warning"
     }
+  },
+  "nanos": {
+    "realms": {
+      "Server/**": "server",
+      "Client/**": "client",
+      "Shared/**": "shared"
+    }
   }
 }