@socketsecurity/lib 5.28.0 → 6.0.0

package/dist/strings.js

@@ -1,218 +0,0 @@
-"use strict";
-/* Socket Lib - Built with esbuild */
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var strings_exports = {};
-__export(strings_exports, {
-  ansiRegex: () => import_ansi.ansiRegex,
-  applyLinePrefix: () => applyLinePrefix,
-  centerText: () => centerText,
-  fromCharCode: () => fromCharCode,
-  indentString: () => indentString,
-  isBlankString: () => isBlankString,
-  isNonEmptyString: () => isNonEmptyString,
-  repeatString: () => repeatString,
-  search: () => search,
-  stringWidth: () => stringWidth,
-  stripAnsi: () => import_ansi.stripAnsi,
-  stripBom: () => stripBom,
-  toKebabCase: () => toKebabCase,
-  trimNewlines: () => trimNewlines
-});
-module.exports = __toCommonJS(strings_exports);
-var import_ansi = require("./ansi");
-var import_primordials = require("./primordials");
-let _eastAsianWidth;
-// @__NO_SIDE_EFFECTS__
-function getEastAsianWidth() {
-  if (_eastAsianWidth === void 0) {
-    _eastAsianWidth = require("./external/get-east-asian-width").eastAsianWidth;
-  }
-  return _eastAsianWidth;
-}
-const fromCharCode = String.fromCharCode;
-// @__NO_SIDE_EFFECTS__
-function applyLinePrefix(str, options) {
-  const { prefix = "" } = {
-    __proto__: null,
-    ...options
-  };
-  return prefix.length ? `${prefix}${(0, import_primordials.StringPrototypeIncludes)(str, "\n") ? str.replace(/\n/g, `
-${prefix}`) : str}` : str;
-}
-// @__NO_SIDE_EFFECTS__
-function centerText(text, width) {
-  const textLength = (0, import_ansi.stripAnsi)(text).length;
-  if (textLength >= width) {
-    return text;
-  }
-  const padding = width - textLength;
-  const leftPad = (0, import_primordials.MathFloor)(padding / 2);
-  const rightPad = padding - leftPad;
-  return " ".repeat(leftPad) + text + " ".repeat(rightPad);
-}
-// @__NO_SIDE_EFFECTS__
-function indentString(str, options) {
-  const { count = 1 } = { __proto__: null, ...options };
-  return str.replace(/^(?!\s*$)/gm, " ".repeat(count));
-}
-// @__NO_SIDE_EFFECTS__
-function isBlankString(value) {
-  return typeof value === "string" && (!value.length || /^\s+$/.test(value));
-}
-// @__NO_SIDE_EFFECTS__
-function isNonEmptyString(value) {
-  return typeof value === "string" && value.length > 0;
-}
-// @__NO_SIDE_EFFECTS__
-function repeatString(str, count) {
-  if (count <= 0) {
-    return "";
-  }
-  return (0, import_primordials.StringPrototypeRepeat)(str, count);
-}
-// @__NO_SIDE_EFFECTS__
-function search(str, regexp, options) {
-  const { fromIndex = 0 } = { __proto__: null, ...options };
-  const { length } = str;
-  if (fromIndex >= length) {
-    return -1;
-  }
-  if (fromIndex === 0) {
-    return (0, import_primordials.StringPrototypeSearch)(str, regexp);
-  }
-  const offset = fromIndex < 0 ? (0, import_primordials.MathMax)(length + fromIndex, 0) : fromIndex;
-  const result = (0, import_primordials.StringPrototypeSlice)(str, offset).search(regexp);
-  return result === -1 ? -1 : result + offset;
-}
-const segmenter = new Intl.Segmenter();
-let zeroWidthClusterRegex;
-let leadingNonPrintingRegex;
-let emojiRegex;
-try {
-  zeroWidthClusterRegex = new RegExp("^(?:\\p{Default_Ignorable_Code_Point}|\\p{Control}|\\p{Mark}|\\p{Surrogate})+$", "v");
-  leadingNonPrintingRegex = new RegExp("^[\\p{Default_Ignorable_Code_Point}\\p{Control}\\p{Format}\\p{Mark}\\p{Surrogate}]+", "v");
-  emojiRegex = new RegExp("^\\p{RGI_Emoji}$", "v");
-} catch {
-  zeroWidthClusterRegex = new RegExp("^(?:\\p{Default_Ignorable_Code_Point}|\\p{Control}|\\p{Mark})+$", "u");
-  leadingNonPrintingRegex = /^[\p{Default_Ignorable_Code_Point}\p{Control}\p{Format}\p{Mark}]+/u;
-  emojiRegex = new RegExp("^\\p{Extended_Pictographic}$", "u");
-}
-// @__NO_SIDE_EFFECTS__
-function stringWidth(text) {
-  if (typeof text !== "string" || !text.length) {
-    return 0;
-  }
-  const plainText = (0, import_ansi.stripAnsi)(text);
-  if (!plainText.length) {
-    return 0;
-  }
-  let width = 0;
-  const eastAsianWidthOptions = { ambiguousAsWide: false };
-  const eastAsianWidth = /* @__PURE__ */ getEastAsianWidth();
-  for (const { segment } of segmenter.segment(plainText)) {
-    if ((0, import_primordials.RegExpPrototypeTest)(zeroWidthClusterRegex, segment)) {
-      continue;
-    }
-    if ((0, import_primordials.RegExpPrototypeTest)(emojiRegex, segment)) {
-      width += 2;
-      continue;
-    }
-    const baseSegment = segment.replace(leadingNonPrintingRegex, "");
-    const codePoint = (0, import_primordials.StringPrototypeCodePointAt)(baseSegment, 0);
-    if (codePoint === void 0) {
-      continue;
-    }
-    width += eastAsianWidth(codePoint, eastAsianWidthOptions);
-    if (segment.length > 1) {
-      for (const char of segment.slice(1)) {
-        const charCode = (0, import_primordials.StringPrototypeCharCodeAt)(char, 0);
-        if (charCode >= 65280 && charCode <= 65519) {
-          const trailingCodePoint = (0, import_primordials.StringPrototypeCodePointAt)(char, 0);
-          if (trailingCodePoint !== void 0) {
-            width += eastAsianWidth(trailingCodePoint, eastAsianWidthOptions);
-          }
-        }
-      }
-    }
-  }
-  return width;
-}
-// @__NO_SIDE_EFFECTS__
-function stripBom(str) {
-  return str.length > 0 && (0, import_primordials.StringPrototypeCharCodeAt)(str, 0) === 65279 ? (0, import_primordials.StringPrototypeSlice)(str, 1) : str;
-}
-// @__NO_SIDE_EFFECTS__
-function toKebabCase(str) {
-  if (!str.length) {
-    return str;
-  }
-  return (0, import_primordials.StringPrototypeReplace)(str, /([a-z]+[0-9]*)([A-Z])/g, "$1-$2").replace(/_/g, "-").toLowerCase();
-}
-// @__NO_SIDE_EFFECTS__
-function trimNewlines(str) {
-  const { length } = str;
-  if (length === 0) {
-    return str;
-  }
-  const first = (0, import_primordials.StringPrototypeCharCodeAt)(str, 0);
-  const noFirstNewline = first !== 13 && first !== 10;
-  if (length === 1) {
-    return noFirstNewline ? str : "";
-  }
-  const last = (0, import_primordials.StringPrototypeCharCodeAt)(str, length - 1);
-  const noLastNewline = last !== 13 && last !== 10;
-  if (noFirstNewline && noLastNewline) {
-    return str;
-  }
-  let start = 0;
-  let end = length;
-  while (start < end) {
-    const code = (0, import_primordials.StringPrototypeCharCodeAt)(str, start);
-    if (code !== 13 && code !== 10) {
-      break;
-    }
-    start += 1;
-  }
-  while (end > start) {
-    const code = (0, import_primordials.StringPrototypeCharCodeAt)(str, end - 1);
-    if (code !== 13 && code !== 10) {
-      break;
-    }
-    end -= 1;
-  }
-  return start === 0 && end === length ? str : (0, import_primordials.StringPrototypeSlice)(str, start, end);
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  ansiRegex,
-  applyLinePrefix,
-  centerText,
-  fromCharCode,
-  indentString,
-  isBlankString,
-  isNonEmptyString,
-  repeatString,
-  search,
-  stringWidth,
-  stripAnsi,
-  stripBom,
-  toKebabCase,
-  trimNewlines
-});

package/dist/suppress-warnings.d.ts

@@ -1,81 +0,0 @@
-/**
- * @fileoverview Utilities to suppress specific process warnings.
- */
-/**
- * Restore the original process.emitWarning function.
- * Call this to re-enable all warnings after suppressing them.
- *
- * @example
- * ```typescript
- * suppressMaxListenersWarning()
- * // ... do work ...
- * restoreWarnings() // Re-enable all warnings
- * ```
- */
-export declare function restoreWarnings(): void;
-/**
- * Set max listeners on an EventTarget (like AbortSignal) to avoid TypeError.
- *
- * By manually setting `kMaxEventTargetListeners` on the target we avoid:
- *   TypeError [ERR_INVALID_ARG_TYPE]: The "emitter" argument must be an
- *   instance of EventEmitter or EventTarget. Received an instance of
- *   AbortSignal
- *
- * in some patch releases of Node 18-23 when calling events.getMaxListeners().
- * See https://github.com/nodejs/node/pull/56807.
- *
- * Instead of calling events.setMaxListeners(n, target) we set the symbol
- * property directly to avoid depending on 'node:events' module.
- *
- * @param target - The EventTarget or AbortSignal to configure
- * @param maxListeners - Maximum number of listeners (defaults to 10, the Node.js default)
- *
- * @example
- * import { setMaxEventTargetListeners } from '@socketsecurity/lib/suppress-warnings'
- *
- * const controller = new AbortController()
- * setMaxEventTargetListeners(controller.signal)
- */
-export declare function setMaxEventTargetListeners(target: EventTarget | AbortSignal | undefined, maxListeners?: number): void;
-/**
- * Suppress MaxListenersExceededWarning messages.
- * This is useful in tests or scripts where multiple listeners are expected.
- *
- * @example
- * import { suppressMaxListenersWarning } from '@socketsecurity/lib/suppress-warnings'
- *
- * suppressMaxListenersWarning()
- */
-/**
- * Silence `MaxListenersExceededWarning` messages from `process.emitWarning`.
- * Installs a single shared wrapper around `process.emitWarning` on first call
- * so repeat invocations are cheap.
- */
-export declare function suppressMaxListenersWarning(): void;
-/**
- * Suppress all process warnings of a specific type.
- *
- * @param warningType - The warning type to suppress (e.g., 'DeprecationWarning', 'ExperimentalWarning')
- *
- * @example
- * import { suppressWarningType } from '@socketsecurity/lib/suppress-warnings'
- *
- * suppressWarningType('ExperimentalWarning')
- */
-export declare function suppressWarningType(warningType: string): void;
-/**
- * Suppress warnings temporarily within a callback.
- *
- * @param warningType - The warning type to suppress
- * @param callback - Function to execute with warnings suppressed
- * @returns The result of the callback
- *
- * @example
- * import { withSuppressedWarnings } from '@socketsecurity/lib/suppress-warnings'
- *
- * const result = await withSuppressedWarnings('ExperimentalWarning', async () => {
- *   // Code that triggers experimental warnings
- *   return someValue
- * })
- */
-export declare function withSuppressedWarnings<T>(warningType: string, callback: () => T | Promise<T>): Promise<T>;

package/dist/tables.d.ts

@@ -1,73 +0,0 @@
-/**
- * @fileoverview Table formatting utilities for CLI applications.
- * Provides ASCII table rendering with borders, alignment, and colors.
- */
-export type ColumnAlignment = 'left' | 'right' | 'center';
-/**
- * Table column configuration.
- */
-export type TableColumn = {
-    key: string;
-    header: string;
-    align?: ColumnAlignment | undefined;
-    width?: number | undefined;
-    color?: ((value: string) => string) | undefined;
-};
-/**
- * Format data as a simple table without borders.
- * Lighter weight alternative to formatTable().
- *
- * @param data - Array of data objects
- * @param columns - Column configuration
- * @returns Formatted table string
- *
- * @example
- * import { formatSimpleTable } from '@socketsecurity/lib/tables'
- * import colors from 'yoctocolors-cjs'
- *
- * const data = [
- *   { name: 'lodash', version: '4.17.21' },
- *   { name: 'react', version: '18.2.0' },
- * ]
- * const columns = [
- *   { key: 'name', header: 'Package' },
- *   { key: 'version', header: 'Version' },
- * ]
- * console.log(formatSimpleTable(data, columns))
- * // Output:
- * // Package  Version
- * // ───────  ───────
- * // lodash   4.17.21
- * // react    18.2.0
- */
-export declare function formatSimpleTable(data: Array<Record<string, unknown>>, columns: TableColumn[]): string;
-/**
- * Format data as an ASCII table with borders.
- *
- * @param data - Array of data objects
- * @param columns - Column configuration
- * @returns Formatted table string
- *
- * @example
- * import { formatTable } from '@socketsecurity/lib/tables'
- * import colors from 'yoctocolors-cjs'
- *
- * const data = [
- *   { name: 'lodash', version: '4.17.21', issues: 0 },
- *   { name: 'react', version: '18.2.0', issues: 2 },
- * ]
- * const columns = [
- *   { key: 'name', header: 'Package' },
- *   { key: 'version', header: 'Version', align: 'center' },
- *   { key: 'issues', header: 'Issues', align: 'right', color: (v) => v === '0' ? colors.green(v) : colors.red(v) },
- * ]
- * console.log(formatTable(data, columns))
- * // Output:
- * // ┌─────────┬─────────┬────────┐
- * // │ Package │ Version │ Issues │
- * // ├─────────┼─────────┼────────┤
- * // │ lodash  │ 4.17.21 │      0 │
- * // │ react   │ 18.2.0  │      2 │
- * // └─────────┴─────────┴────────┘
- */
-export declare function formatTable(data: Array<Record<string, unknown>>, columns: TableColumn[]): string;

package/dist/tables.js

@@ -1,133 +0,0 @@
-"use strict";
-/* Socket Lib - Built with esbuild */
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var tables_exports = {};
-__export(tables_exports, {
-  formatSimpleTable: () => formatSimpleTable,
-  formatTable: () => formatTable
-});
-module.exports = __toCommonJS(tables_exports);
-var import_yoctocolors_cjs = __toESM(require("./external/yoctocolors-cjs"));
-var import_strings = require("./strings");
-var import_primordials = require("./primordials");
-function displayWidth(text) {
-  return (0, import_strings.stringWidth)(text);
-}
-function padText(text, width, align = "left") {
-  const textWidth = displayWidth(text);
-  const padding = (0, import_primordials.MathMax)(0, width - textWidth);
-  switch (align) {
-    case "right":
-      return " ".repeat(padding) + text;
-    case "center": {
-      const leftPad = Math.floor(padding / 2);
-      const rightPad = padding - leftPad;
-      return " ".repeat(leftPad) + text + " ".repeat(rightPad);
-    }
-    default:
-      return text + " ".repeat(padding);
-  }
-}
-function formatSimpleTable(data, columns) {
-  if (data.length === 0) {
-    return "(no data)";
-  }
-  const widths = columns.map((col) => {
-    const headerWidth = displayWidth(col.header);
-    const maxDataWidth = (0, import_primordials.MathMax)(
-      ...data.map((row) => displayWidth(String(row[col.key] ?? "")))
-    );
-    return col.width ?? (0, import_primordials.MathMax)(headerWidth, maxDataWidth);
-  });
-  const lines = [];
-  const headerCells = columns.map(
-    (col, i) => padText(import_yoctocolors_cjs.default.bold(col.header), widths[i], col.align)
-  );
-  (0, import_primordials.ArrayPrototypePush)(lines, headerCells.join("  "));
-  const separators = widths.map((w) => import_yoctocolors_cjs.default.dim("\u2500".repeat(w)));
-  (0, import_primordials.ArrayPrototypePush)(lines, separators.join("  "));
-  for (const row of data) {
-    const cells = columns.map((col, i) => {
-      let value = String(row[col.key] ?? "");
-      if (col.color) {
-        value = col.color(value);
-      }
-      return padText(value, widths[i], col.align);
-    });
-    (0, import_primordials.ArrayPrototypePush)(lines, cells.join("  "));
-  }
-  return lines.join("\n");
-}
-function formatTable(data, columns) {
-  if (data.length === 0) {
-    return "(no data)";
-  }
-  const widths = columns.map((col) => {
-    const headerWidth = displayWidth(col.header);
-    const maxDataWidth = (0, import_primordials.MathMax)(
-      ...data.map((row) => displayWidth(String(row[col.key] ?? "")))
-    );
-    return col.width ?? (0, import_primordials.MathMax)(headerWidth, maxDataWidth);
-  });
-  const lines = [];
-  const topBorder = `\u250C\u2500${widths.map((w) => "\u2500".repeat(w)).join("\u2500\u252C\u2500")}\u2500\u2510`;
-  (0, import_primordials.ArrayPrototypePush)(lines, import_yoctocolors_cjs.default.dim(topBorder));
-  const headerCells = columns.map((col, i) => {
-    const text = import_yoctocolors_cjs.default.bold(col.header);
-    return padText(text, widths[i], col.align);
-  });
-  (0, import_primordials.ArrayPrototypePush)(
-    lines,
-    import_yoctocolors_cjs.default.dim("\u2502 ") + headerCells.join(import_yoctocolors_cjs.default.dim(" \u2502 ")) + import_yoctocolors_cjs.default.dim(" \u2502")
-  );
-  const headerSep = `\u251C\u2500${widths.map((w) => "\u2500".repeat(w)).join("\u2500\u253C\u2500")}\u2500\u2524`;
-  (0, import_primordials.ArrayPrototypePush)(lines, import_yoctocolors_cjs.default.dim(headerSep));
-  for (const row of data) {
-    const cells = columns.map((col, i) => {
-      let value = String(row[col.key] ?? "");
-      if (col.color) {
-        value = col.color(value);
-      }
-      return padText(value, widths[i], col.align);
-    });
-    (0, import_primordials.ArrayPrototypePush)(
-      lines,
-      import_yoctocolors_cjs.default.dim("\u2502 ") + cells.join(import_yoctocolors_cjs.default.dim(" \u2502 ")) + import_yoctocolors_cjs.default.dim(" \u2502")
-    );
-  }
-  const bottomBorder = `\u2514\u2500${widths.map((w) => "\u2500".repeat(w)).join("\u2500\u2534\u2500")}\u2500\u2518`;
-  (0, import_primordials.ArrayPrototypePush)(lines, import_yoctocolors_cjs.default.dim(bottomBorder));
-  return lines.join("\n");
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  formatSimpleTable,
-  formatTable
-});

package/dist/temporary-executor.d.ts

@@ -1,20 +0,0 @@
-/**
- * @fileoverview Temporary package executor detection utilities for Socket ecosystem.
- * Identifies and handles temporary execution contexts such as npx, pnpm dlx, and yarn dlx.
- */
-/**
- * Detects if the current process is running in a temporary package execution context
- * such as npm exec, npx, pnpm dlx, or yarn dlx.
- *
- * When package managers run commands via exec/npx/dlx, they execute in temporary directories
- * that are cleaned up after execution. Creating persistent shadows or modifying PATH
- * in these contexts can break subsequent package manager commands.
- *
- * @example
- * ```typescript
- * if (isRunningInTemporaryExecutor()) {
- *   console.log('Running in a temporary executor context')
- * }
- * ```
- */
-export declare function isRunningInTemporaryExecutor(cwd?: string): boolean;

package/dist/themes/utils.d.ts

@@ -1,86 +0,0 @@
-/**
- * @fileoverview Theme utilities — color resolution and composition.
- */
-import type { ColorValue } from '../colors';
-import type { Palette } from '../effects/shimmer';
-import type { ColorReference, Theme, ThemeColors } from './types';
-/**
- * Rainbow gradient colors used for the `'rainbow'` color keyword.
- * 10 hues — cycles through the full color spectrum with smooth transitions.
- */
-export declare const RAINBOW_GRADIENT: Palette;
-/**
- * Create new theme from complete specification.
- *
- * @param config - Theme configuration
- * @returns Theme object
- *
- * @example
- * ```ts
- * const theme = createTheme({
- *   name: 'custom',
- *   displayName: 'Custom',
- *   colors: {
- *     primary: [255, 100, 200],
- *     success: 'greenBright',
- *     error: 'redBright',
- *     warning: 'yellowBright',
- *     info: 'blueBright',
- *     step: 'cyanBright',
- *     text: 'white',
- *     textDim: 'gray',
- *     link: 'cyanBright',
- *     prompt: 'primary'
- *   }
- * })
- * ```
- */
-export declare function createTheme(config: Pick<Theme, 'name' | 'displayName' | 'colors'> & Partial<Omit<Theme, 'name' | 'displayName' | 'colors'>>): Theme;
-/**
- * Extend existing theme with custom overrides.
- * Deep merge of colors and effects.
- *
- * @param base - Base theme
- * @param overrides - Custom overrides
- * @returns Extended theme
- *
- * @example
- * ```ts
- * const custom = extendTheme(SOCKET_THEME, {
- *   name: 'custom',
- *   colors: { primary: [255, 100, 200] }
- * })
- * ```
- */
-export declare function extendTheme(base: Theme, overrides: Partial<Omit<Theme, 'colors'>> & {
-    colors?: Partial<ThemeColors> | undefined;
-}): Theme;
-/**
- * Resolve color reference to concrete value.
- * Handles semantic keywords: 'primary', 'secondary', 'rainbow', 'inherit'
- *
- * @param value - Color reference
- * @param colors - Theme palette
- * @returns Resolved color
- *
- * @example
- * ```ts
- * resolveColor('primary', theme.colors)
- * resolveColor([255, 0, 0], theme.colors)
- * ```
- */
-export declare function resolveColor(value: ColorReference | ColorValue, colors: ThemeColors): ColorValue | 'inherit' | Palette;
-/**
- * Resolve shimmer color with gradient support.
- *
- * @param value - Shimmer color
- * @param theme - Theme context
- * @returns Resolved color
- *
- * @example
- * ```ts
- * resolveShimmerColor('rainbow', theme)
- * resolveShimmerColor('primary', theme)
- * ```
- */
-export declare function resolveShimmerColor(value: ColorReference | ColorValue[] | undefined, theme: Theme): ColorValue | Palette | 'inherit';