@kubb/core 4.32.4 → 4.33.1

package/dist/utils.d.ts

@@ -1,290 +0,0 @@
-import { t as __name } from "./chunk--u3MIqq1.js";
-import { A as AsyncEventEmitter, E as PossiblePromise, S as UserConfig, n as Config } from "./types-f_no0d7G.js";
-import { a as getBarrelFiles, n as PackageManagerName, o as CLIOptions, r as detectPackageManager, s as defineConfig, t as PackageManagerInfo } from "./packageManager-_7I0WFQU.js";
-
-//#region src/utils/buildJSDoc.d.ts
-/**
- * Builds a JSDoc comment block with custom indentation.
- * @param comments - Array of comment strings to include in the JSDoc block
- * @param options - Configuration options for formatting
- * @returns Formatted JSDoc string or fallback string if no comments
- */
-declare function buildJSDoc(comments: Array<string>, options?: {
-  /**
-   * String to use for indenting each line of the JSDoc comment
-   * @default '   * ' (3 spaces + asterisk + space)
-   */
-  indent?: string;
-  /**
-   * String to append after the closing JSDoc tag
-   * @default '\n  ' (newline + 2 spaces)
-   */
-  suffix?: string;
-  /**
-   * String to return when there are no comments
-   * @default '  ' (2 spaces)
-   */
-  fallback?: string;
-}): string;
-//#endregion
-//#region src/utils/Cache.d.ts
-declare class Cache<T> {
-  #private;
-  get(key: string): Promise<T | null>;
-  set(key: string, value: T): Promise<void>;
-  delete(key: string): Promise<void>;
-  clear(): Promise<void>;
-  keys(): Promise<string[]>;
-  values(): Promise<T[]>;
-  flush(): Promise<void>;
-}
-//#endregion
-//#region src/utils/checkOnlineStatus.d.ts
-/**
- * Check if the system has internet connectivity
- * Uses DNS lookup to well-known stable domains as a lightweight connectivity test
- */
-declare function isOnline(): Promise<boolean>;
-/**
- * Execute a function only if online, otherwise silently skip
- */
-declare function executeIfOnline<T>(fn: () => Promise<T>): Promise<T | null>;
-//#endregion
-//#region src/utils/FunctionParams.d.ts
-type FunctionParamsASTWithoutType = {
-  name?: string;
-  type?: string;
-  /**
-   * @default true
-   */
-  required?: boolean;
-  /**
-   * @default true
-   */
-  enabled?: boolean;
-  default?: string;
-};
-type FunctionParamsASTWithType = {
-  name?: never;
-  type: string;
-  /**
-   * @default true
-   */
-  required?: boolean;
-  /**
-   * @default true
-   */
-  enabled?: boolean;
-  default?: string;
-};
-/**
- * @deprecated
- */
-type FunctionParamsAST = FunctionParamsASTWithoutType | FunctionParamsASTWithType;
-/**
- * @deprecated
- */
-declare class FunctionParams {
-  #private;
-  constructor();
-  get items(): FunctionParamsAST[];
-  add(item: FunctionParamsAST | Array<FunctionParamsAST | FunctionParamsAST[] | undefined> | undefined): FunctionParams;
-  static toObject(items: FunctionParamsAST[]): FunctionParamsAST;
-  toObject(): FunctionParamsAST;
-  static toString(items: (FunctionParamsAST | FunctionParamsAST[])[]): string;
-  toString(): string;
-}
-//#endregion
-//#region src/utils/formatHrtime.d.ts
-/**
- * Calculates elapsed time in milliseconds from a high-resolution start time.
- * Rounds to 2 decimal places to provide sub-millisecond precision without noise.
- */
-declare function getElapsedMs(hrStart: [number, number]): number;
-/**
- * Converts a millisecond duration into a human-readable string.
- * Adjusts units (ms, s, m s) based on the magnitude of the duration.
- */
-declare function formatMs(ms: number): string;
-/**
- * Convenience helper to get and format elapsed time in one step.
- */
-declare function formatHrtime(hrStart: [number, number]): string;
-//#endregion
-//#region src/utils/formatters.d.ts
-declare const formatters: {
-  readonly prettier: {
-    readonly command: "prettier";
-    readonly args: (outputPath: string) => string[];
-    readonly errorMessage: "Prettier not found";
-  };
-  readonly biome: {
-    readonly command: "biome";
-    readonly args: (outputPath: string) => string[];
-    readonly errorMessage: "Biome not found";
-  };
-  readonly oxfmt: {
-    readonly command: "oxfmt";
-    readonly args: (outputPath: string) => string[];
-    readonly errorMessage: "Oxfmt not found";
-  };
-};
-type Formatter = keyof typeof formatters;
-/**
- * Detect which formatter is available in the system.
- *
- * @returns Promise that resolves to the first available formatter or undefined if none are found
- *
- * @remarks
- * Checks in order of preference: biome, oxfmt, prettier.
- * Uses the `--version` flag to detect if each formatter command is available.
- * This is a reliable method as all supported formatters implement this flag.
- *
- * @example
- * ```typescript
- * const formatter = await detectFormatter()
- * if (formatter) {
- *   console.log(`Using ${formatter} for formatting`)
- * } else {
- *   console.log('No formatter found')
- * }
- * ```
- */
-declare function detectFormatter(): Promise<Formatter | undefined>;
-//#endregion
-//#region src/utils/getConfigs.d.ts
-/**
- * Converting UserConfig to Config Array without a change in the object beside the JSON convert.
- */
-declare function getConfigs(config: ReturnType<typeof defineConfig> | UserConfig, args: CLIOptions): Promise<Array<Config>>;
-//#endregion
-//#region src/utils/getNestedAccessor.d.ts
-/**
- * Converts a param path (string with dot notation or array of strings) to a JavaScript accessor expression.
- * @param param - The param path, e.g., 'pagination.next.id' or ['pagination', 'next', 'id']
- * @param accessor - The base accessor, e.g., 'lastPage' or 'firstPage'
- * @returns A JavaScript accessor expression, e.g., "lastPage?.['pagination']?.['next']?.['id']", or undefined if param is empty
- *
- * @example
- * ```ts
- * getNestedAccessor('pagination.next.id', 'lastPage')
- * // returns: "lastPage?.['pagination']?.['next']?.['id']"
- *
- * getNestedAccessor(['pagination', 'next', 'id'], 'lastPage')
- * // returns: "lastPage?.['pagination']?.['next']?.['id']"
- *
- * getNestedAccessor('', 'lastPage')
- * // returns: undefined
- * ```
- */
-declare function getNestedAccessor(param: string | string[], accessor: string): string | undefined;
-//#endregion
-//#region src/utils/linters.d.ts
-declare const linters: {
-  readonly eslint: {
-    readonly command: "eslint";
-    readonly args: (outputPath: string) => string[];
-    readonly errorMessage: "Eslint not found";
-  };
-  readonly biome: {
-    readonly command: "biome";
-    readonly args: (outputPath: string) => string[];
-    readonly errorMessage: "Biome not found";
-  };
-  readonly oxlint: {
-    readonly command: "oxlint";
-    readonly args: (outputPath: string) => string[];
-    readonly errorMessage: "Oxlint not found";
-  };
-};
-type Linter = keyof typeof linters;
-declare function detectLinter(): Promise<Linter | undefined>;
-//#endregion
-//#region src/utils/promise.d.ts
-declare function isPromise<T>(result: PossiblePromise<T>): result is Promise<T>;
-declare function isPromiseFulfilledResult<T = unknown>(result: PromiseSettledResult<unknown>): result is PromiseFulfilledResult<T>;
-declare function isPromiseRejectedResult<T>(result: PromiseSettledResult<unknown>): result is Omit<PromiseRejectedResult, 'reason'> & {
-  reason: T;
-};
-//#endregion
-//#region src/utils/renderTemplate.d.ts
-declare function renderTemplate<TData extends Record<string, unknown> = Record<string, unknown>>(template: string, data?: TData | undefined): string;
-//#endregion
-//#region src/utils/serializePluginOptions.d.ts
-/**
- * Serialize plugin options for safe JSON transport.
- * Strips functions, symbols, and undefined values recursively.
- */
-declare function serializePluginOptions<TOptions extends object = object>(options: TOptions): TOptions;
-//#endregion
-//#region src/utils/timeout.d.ts
-declare function timeout(ms: number): Promise<unknown>;
-//#endregion
-//#region src/utils/tokenize.d.ts
-/** Shell-like tokenizer: splits a command string respecting single/double quotes. */
-declare function tokenize(command: string): string[];
-//#endregion
-//#region src/utils/URLPath.d.ts
-type URLObject = {
-  url: string;
-  params?: Record<string, string>;
-};
-type ObjectOptions = {
-  type?: 'path' | 'template';
-  replacer?: (pathParam: string) => string;
-  stringify?: boolean;
-};
-type Options = {
-  casing?: 'camelcase';
-};
-declare class URLPath {
-  #private;
-  path: string;
-  constructor(path: string, options?: Options);
-  /**
-   * Convert Swagger path to URLPath(syntax of Express)
-   * @example /pet/{petId} => /pet/:petId
-   */
-  get URL(): string;
-  get isURL(): boolean;
-  /**
-   * Convert Swagger path to template literals/ template strings(camelcase)
-   * @example /pet/{petId} => `/pet/${petId}`
-   * @example /account/monetary-accountID => `/account/${monetaryAccountId}`
-   * @example /account/userID => `/account/${userId}`
-   */
-  get template(): string;
-  get object(): URLObject | string;
-  get params(): Record<string, string> | undefined;
-  toObject({
-    type,
-    replacer,
-    stringify
-  }?: ObjectOptions): URLObject | string;
-  /**
-   * Convert Swagger path to template literals/ template strings(camelcase)
-   * @example /pet/{petId} => `/pet/${petId}`
-   * @example /account/monetary-accountID => `/account/${monetaryAccountId}`
-   * @example /account/userID => `/account/${userId}`
-   */
-  toTemplateString({
-    prefix,
-    replacer
-  }?: {
-    prefix?: string;
-    replacer?: (pathParam: string) => string;
-  }): string;
-  getParams(replacer?: (pathParam: string) => string): Record<string, string> | undefined;
-  /**
-   * Convert Swagger path to URLPath(syntax of Express)
-   * @example /pet/{petId} => /pet/:petId
-   */
-  toURLPath(): string;
-}
-//#endregion
-//#region src/utils/uniqueName.d.ts
-declare function getUniqueName(originalName: string, data: Record<string, number>): string;
-declare function setUniqueName(originalName: string, data: Record<string, number>): string;
-//#endregion
-export { AsyncEventEmitter, Cache, FunctionParams, type FunctionParamsAST, type PackageManagerInfo, type PackageManagerName, type URLObject, URLPath, buildJSDoc, detectFormatter, detectLinter, detectPackageManager, executeIfOnline, formatHrtime, formatMs, formatters, getBarrelFiles, getConfigs, getElapsedMs, getNestedAccessor, getUniqueName, isOnline, isPromise, isPromiseFulfilledResult, isPromiseRejectedResult, linters, renderTemplate, serializePluginOptions, setUniqueName, timeout, tokenize };
-//# sourceMappingURL=utils.d.ts.map

package/dist/utils.js

@@ -1,402 +0,0 @@
-import "./chunk--u3MIqq1.js";
-import { a as formatMs, d as setUniqueName, i as formatHrtime, n as getBarrelFiles, o as getElapsedMs, r as URLPath, s as AsyncEventEmitter, t as detectPackageManager, u as getUniqueName } from "./packageManager-wMCQlgd6.js";
-import { f as camelCase } from "./transformers-BwSpAhvT.js";
-import dns from "node:dns";
-import { sortBy } from "remeda";
-import { x } from "tinyexec";
-//#region src/utils/buildJSDoc.ts
-/**
-* Builds a JSDoc comment block with custom indentation.
-* @param comments - Array of comment strings to include in the JSDoc block
-* @param options - Configuration options for formatting
-* @returns Formatted JSDoc string or fallback string if no comments
-*/
-function buildJSDoc(comments, options = {}) {
-	const { indent = "   * ", suffix = "\n  ", fallback = "  " } = options;
-	if (comments.length === 0) return fallback;
-	return `/**\n${comments.map((c) => `${indent}${c}`).join("\n")}\n   */${suffix}`;
-}
-//#endregion
-//#region src/utils/Cache.ts
-var Cache = class {
-	#buffer = /* @__PURE__ */ new Map();
-	async get(key) {
-		return this.#buffer.get(key) ?? null;
-	}
-	async set(key, value) {
-		this.#buffer.set(key, value);
-	}
-	async delete(key) {
-		this.#buffer.delete(key);
-	}
-	async clear() {
-		this.#buffer.clear();
-	}
-	async keys() {
-		return [...this.#buffer.keys()];
-	}
-	async values() {
-		return [...this.#buffer.values()];
-	}
-	async flush() {}
-};
-//#endregion
-//#region src/utils/checkOnlineStatus.ts
-/**
-* Check if the system has internet connectivity
-* Uses DNS lookup to well-known stable domains as a lightweight connectivity test
-*/
-async function isOnline() {
-	for (const domain of [
-		"dns.google.com",
-		"cloudflare.com",
-		"one.one.one.one"
-	]) try {
-		await dns.promises.resolve(domain);
-		return true;
-	} catch {}
-	return false;
-}
-/**
-* Execute a function only if online, otherwise silently skip
-*/
-async function executeIfOnline(fn) {
-	if (!await isOnline()) return null;
-	try {
-		return await fn();
-	} catch {
-		return null;
-	}
-}
-//#endregion
-//#region src/utils/FunctionParams.ts
-/**
-* @deprecated
-*/
-var FunctionParams = class FunctionParams {
-	#items = [];
-	constructor() {
-		return this;
-	}
-	get items() {
-		return this.#items.flat();
-	}
-	add(item) {
-		if (!item) return this;
-		if (Array.isArray(item)) {
-			item.filter(Boolean).forEach((it) => {
-				this.#items.push(it);
-			});
-			return this;
-		}
-		this.#items.push(item);
-		return this;
-	}
-	static #orderItems(items) {
-		return sortBy(items.filter(Boolean), [(item) => Array.isArray(item), "desc"], [(item) => !Array.isArray(item) && item.default !== void 0, "asc"], [(item) => Array.isArray(item) || (item.required ?? true), "desc"]);
-	}
-	static #addParams(acc, item) {
-		const { enabled = true, name, type, required = true, ...rest } = item;
-		if (!enabled) return acc;
-		if (!name) {
-			acc.push(`${type}${rest.default ? ` = ${rest.default}` : ""}`);
-			return acc;
-		}
-		const parameterName = name.startsWith("{") ? name : camelCase(name);
-		if (type) if (required) acc.push(`${parameterName}: ${type}${rest.default ? ` = ${rest.default}` : ""}`);
-		else acc.push(`${parameterName}?: ${type}`);
-		else acc.push(`${parameterName}`);
-		return acc;
-	}
-	static toObject(items) {
-		let type = [];
-		let name = [];
-		const enabled = items.every((item) => item.enabled) ? items.at(0)?.enabled : true;
-		const required = items.every((item) => item.required) ?? true;
-		items.forEach((item) => {
-			name = FunctionParams.#addParams(name, {
-				...item,
-				type: void 0
-			});
-			if (items.some((item) => item.type)) type = FunctionParams.#addParams(type, item);
-		});
-		return {
-			name: `{ ${name.join(", ")} }`,
-			type: type.length ? `{ ${type.join("; ")} }` : void 0,
-			enabled,
-			required
-		};
-	}
-	toObject() {
-		const items = FunctionParams.#orderItems(this.#items).flat();
-		return FunctionParams.toObject(items);
-	}
-	static toString(items) {
-		return FunctionParams.#orderItems(items).reduce((acc, item) => {
-			if (Array.isArray(item)) {
-				if (item.length <= 0) return acc;
-				const subItems = FunctionParams.#orderItems(item);
-				const objectItem = FunctionParams.toObject(subItems);
-				return FunctionParams.#addParams(acc, objectItem);
-			}
-			return FunctionParams.#addParams(acc, item);
-		}, []).join(", ");
-	}
-	toString() {
-		const items = FunctionParams.#orderItems(this.#items);
-		return FunctionParams.toString(items);
-	}
-};
-//#endregion
-//#region src/utils/formatters.ts
-const formatters = {
-	prettier: {
-		command: "prettier",
-		args: (outputPath) => [
-			"--ignore-unknown",
-			"--write",
-			outputPath
-		],
-		errorMessage: "Prettier not found"
-	},
-	biome: {
-		command: "biome",
-		args: (outputPath) => [
-			"format",
-			"--write",
-			outputPath
-		],
-		errorMessage: "Biome not found"
-	},
-	oxfmt: {
-		command: "oxfmt",
-		args: (outputPath) => [outputPath],
-		errorMessage: "Oxfmt not found"
-	}
-};
-/**
-* Check if a formatter command is available in the system.
-*
-* @param formatter - The formatter to check ('biome', 'prettier', or 'oxfmt')
-* @returns Promise that resolves to true if the formatter is available, false otherwise
-*
-* @remarks
-* This function checks availability by running `<formatter> --version` command.
-* All supported formatters (biome, prettier, oxfmt) implement the --version flag.
-*/
-async function isFormatterAvailable(formatter) {
-	try {
-		await x(formatter, ["--version"], { nodeOptions: { stdio: "ignore" } });
-		return true;
-	} catch {
-		return false;
-	}
-}
-/**
-* Detect which formatter is available in the system.
-*
-* @returns Promise that resolves to the first available formatter or undefined if none are found
-*
-* @remarks
-* Checks in order of preference: biome, oxfmt, prettier.
-* Uses the `--version` flag to detect if each formatter command is available.
-* This is a reliable method as all supported formatters implement this flag.
-*
-* @example
-* ```typescript
-* const formatter = await detectFormatter()
-* if (formatter) {
-*   console.log(`Using ${formatter} for formatting`)
-* } else {
-*   console.log('No formatter found')
-* }
-* ```
-*/
-async function detectFormatter() {
-	for (const formatter of [
-		"biome",
-		"oxfmt",
-		"prettier"
-	]) if (await isFormatterAvailable(formatter)) return formatter;
-}
-//#endregion
-//#region src/utils/getPlugins.ts
-function isJSONPlugins(plugins) {
-	return !!plugins?.some((plugin) => {
-		return Array.isArray(plugin) && typeof plugin?.at(0) === "string";
-	});
-}
-function isObjectPlugins(plugins) {
-	return plugins instanceof Object && !Array.isArray(plugins);
-}
-function getPlugins(plugins) {
-	if (isObjectPlugins(plugins)) throw new Error("Object plugins are not supported anymore, best to use http://kubb.dev/getting-started/configure#json");
-	if (isJSONPlugins(plugins)) throw new Error("JSON plugins are not supported anymore, best to use http://kubb.dev/getting-started/configure#json");
-	return Promise.resolve(plugins);
-}
-//#endregion
-//#region src/utils/promise.ts
-function isPromise(result) {
-	return !!result && typeof result?.then === "function";
-}
-function isPromiseFulfilledResult(result) {
-	return result.status === "fulfilled";
-}
-function isPromiseRejectedResult(result) {
-	return result.status === "rejected";
-}
-//#endregion
-//#region src/utils/getConfigs.ts
-/**
-* Converting UserConfig to Config Array without a change in the object beside the JSON convert.
-*/
-async function getConfigs(config, args) {
-	let kubbUserConfig = Promise.resolve(config);
-	if (typeof config === "function") {
-		const possiblePromise = config(args);
-		if (isPromise(possiblePromise)) kubbUserConfig = possiblePromise;
-		kubbUserConfig = Promise.resolve(possiblePromise);
-	}
-	let JSONConfig = await kubbUserConfig;
-	if (!Array.isArray(JSONConfig)) JSONConfig = [JSONConfig];
-	const results = [];
-	for (const item of JSONConfig) {
-		const plugins = item.plugins ? await getPlugins(item.plugins) : void 0;
-		results.push({
-			...item,
-			plugins
-		});
-	}
-	return results;
-}
-//#endregion
-//#region src/utils/getNestedAccessor.ts
-/**
-* Converts a param path (string with dot notation or array of strings) to a JavaScript accessor expression.
-* @param param - The param path, e.g., 'pagination.next.id' or ['pagination', 'next', 'id']
-* @param accessor - The base accessor, e.g., 'lastPage' or 'firstPage'
-* @returns A JavaScript accessor expression, e.g., "lastPage?.['pagination']?.['next']?.['id']", or undefined if param is empty
-*
-* @example
-* ```ts
-* getNestedAccessor('pagination.next.id', 'lastPage')
-* // returns: "lastPage?.['pagination']?.['next']?.['id']"
-*
-* getNestedAccessor(['pagination', 'next', 'id'], 'lastPage')
-* // returns: "lastPage?.['pagination']?.['next']?.['id']"
-*
-* getNestedAccessor('', 'lastPage')
-* // returns: undefined
-* ```
-*/
-function getNestedAccessor(param, accessor) {
-	const parts = Array.isArray(param) ? param : param.split(".");
-	if (parts.length === 0 || parts.length === 1 && parts[0] === "") return;
-	return parts.reduce((acc, part) => `${acc}?.['${part}']`, accessor);
-}
-//#endregion
-//#region src/utils/linters.ts
-const linters = {
-	eslint: {
-		command: "eslint",
-		args: (outputPath) => [outputPath, "--fix"],
-		errorMessage: "Eslint not found"
-	},
-	biome: {
-		command: "biome",
-		args: (outputPath) => [
-			"lint",
-			"--fix",
-			outputPath
-		],
-		errorMessage: "Biome not found"
-	},
-	oxlint: {
-		command: "oxlint",
-		args: (outputPath) => ["--fix", outputPath],
-		errorMessage: "Oxlint not found"
-	}
-};
-async function isLinterAvailable(linter) {
-	try {
-		await x(linter, ["--version"], { nodeOptions: { stdio: "ignore" } });
-		return true;
-	} catch {
-		return false;
-	}
-}
-async function detectLinter() {
-	for (const linter of [
-		"biome",
-		"oxlint",
-		"eslint"
-	]) if (await isLinterAvailable(linter)) return linter;
-}
-//#endregion
-//#region src/utils/renderTemplate.ts
-function renderTemplate(template, data = void 0) {
-	if (!data || !Object.keys(data).length) return template.replace(/{{(.*?)}}/g, "");
-	return template.match(/{{(.*?)}}/g)?.reduce((prev, curr) => {
-		const index = curr.split(/{{|}}/).filter(Boolean)[0]?.trim();
-		if (index === void 0) return prev;
-		const value = data[index];
-		if (value === void 0) return prev;
-		return prev.replace(curr, () => {
-			if (typeof value === "boolean") return `${value.toString()}` || "false";
-			return value || "";
-		}).trim();
-	}, template) || "";
-}
-//#endregion
-//#region src/utils/serializePluginOptions.ts
-/**
-* Serialize plugin options for safe JSON transport.
-* Strips functions, symbols, and undefined values recursively.
-*/
-function serializePluginOptions(options) {
-	if (options === null || options === void 0) return {};
-	if (typeof options !== "object") return options;
-	if (Array.isArray(options)) return options.map(serializePluginOptions);
-	const serialized = {};
-	for (const [key, value] of Object.entries(options)) {
-		if (typeof value === "function" || typeof value === "symbol" || value === void 0) continue;
-		if (typeof value === "object" && value !== null) serialized[key] = serializePluginOptions(value);
-		else serialized[key] = value;
-	}
-	return serialized;
-}
-//#endregion
-//#region src/utils/timeout.ts
-async function timeout(ms) {
-	return new Promise((resolve) => {
-		const timeout = setTimeout(() => {
-			resolve(timeout);
-		}, ms);
-	}).then((timeout) => {
-		clearTimeout(timeout);
-		return true;
-	});
-}
-//#endregion
-//#region src/utils/tokenize.ts
-/** Shell-like tokenizer: splits a command string respecting single/double quotes. */
-function tokenize(command) {
-	const args = [];
-	let current = "";
-	let quote = "";
-	for (const ch of command) if (quote) if (ch === quote) quote = "";
-	else current += ch;
-	else if (ch === "\"" || ch === "'") quote = ch;
-	else if (ch === " " || ch === "	") {
-		if (current) {
-			args.push(current);
-			current = "";
-		}
-	} else current += ch;
-	if (current) args.push(current);
-	return args;
-}
-//#endregion
-export { AsyncEventEmitter, Cache, FunctionParams, URLPath, buildJSDoc, detectFormatter, detectLinter, detectPackageManager, executeIfOnline, formatHrtime, formatMs, formatters, getBarrelFiles, getConfigs, getElapsedMs, getNestedAccessor, getUniqueName, isOnline, isPromise, isPromiseFulfilledResult, isPromiseRejectedResult, linters, renderTemplate, serializePluginOptions, setUniqueName, timeout, tokenize };
-
-//# sourceMappingURL=utils.js.map