auklet 0.0.16 → 0.0.18

package/dist/css/vite/vitePlugin.js

@@ -8,124 +8,132 @@ const RESOLVED_VIRTUAL_ID_PREFIX = '\0auklet-css:';
 const BROWSER_VIRTUAL_ID_PREFIX = 'auklet-css:';
 const stripQuery = (id) => id.split('?')[0];
 const toResolvedVirtualId = (id) => {
-  if (id.startsWith(RESOLVED_VIRTUAL_ID_PREFIX)) {
-    return id;
-  }
-  if (id.startsWith(BROWSER_VIRTUAL_ID_PREFIX)) {
-    return `${RESOLVED_VIRTUAL_ID_PREFIX}${id.slice(
-      BROWSER_VIRTUAL_ID_PREFIX.length,
-    )}`;
-  }
-  return null;
+    if (id.startsWith(RESOLVED_VIRTUAL_ID_PREFIX)) {
+        return id;
+    }
+    if (id.startsWith(BROWSER_VIRTUAL_ID_PREFIX)) {
+        return `${RESOLVED_VIRTUAL_ID_PREFIX}${id.slice(BROWSER_VIRTUAL_ID_PREFIX.length)}`;
+    }
+    return null;
 };
 const findWorkspaceRoot = (startDir) => {
-  let current = path.resolve(startDir);
-  while (true) {
-    if (fs.existsSync(path.join(current, WORKSPACE_FILE))) {
-      return current;
+    let current = path.resolve(startDir);
+    while (true) {
+        if (fs.existsSync(path.join(current, WORKSPACE_FILE))) {
+            return current;
+        }
+        const parent = path.dirname(current);
+        if (parent === current)
+            return null;
+        current = parent;
     }
-    const parent = path.dirname(current);
-    if (parent === current) return null;
-    current = parent;
-  }
 };
 const createModuleStyleGraph = (options, viteRoot) => {
-  const workspaceRoot =
-    options.workspaceRoot ?? findWorkspaceRoot(viteRoot) ?? process.cwd();
-  return new ModuleStyleGraph({
-    ...options,
-    workspaceRoot,
-  });
+    const mode = options.mode ?? 'package';
+    const root = options.root ?? resolveGraphRoot(mode, viteRoot);
+    return new ModuleStyleGraph({
+        ...options,
+        mode,
+        root,
+    });
+};
+const resolveGraphRoot = (mode, viteRoot) => {
+    if (mode === 'monorepo')
+        return findWorkspaceRoot(viteRoot) ?? process.cwd();
+    return viteRoot;
 };
 const invalidateVirtualModules = (server, graph) => {
-  const modules = [];
-  for (const packageName of graph.getPackageNames()) {
-    for (const entry of ['style.css', 'external.css', 'module.css']) {
-      const module = server.moduleGraph.getModuleById(
-        `${RESOLVED_VIRTUAL_ID_PREFIX}${packageName}/${entry}`,
-      );
-      if (!module) continue;
-      server.moduleGraph.invalidateModule(module);
-      modules.push(module);
+    const modules = [];
+    for (const packageName of graph.getPackageNames()) {
+        for (const entry of ['style.css', 'external.css', 'module.css']) {
+            const module = server.moduleGraph.getModuleById(`${RESOLVED_VIRTUAL_ID_PREFIX}${packageName}/${entry}`);
+            if (!module)
+                continue;
+            server.moduleGraph.invalidateModule(module);
+            modules.push(module);
+        }
     }
-  }
-  return modules;
+    return modules;
 };
 export function aukletStylePlugin(options = {}) {
-  let graph = null;
-  const getGraph = () => {
-    if (!graph) {
-      graph = createModuleStyleGraph(options, process.cwd());
-    }
-    return graph;
-  };
-  const hmr = new AukletStyleHmr(getGraph);
-  return {
-    name: 'auklet-css',
-    apply: 'serve',
-    enforce: 'pre',
-    configResolved(config) {
-      graph = createModuleStyleGraph(options, config.root);
-    },
-    resolveId(id) {
-      const graph = getGraph();
-      const cleanId = stripQuery(id);
-      const resolvedVirtualId = toResolvedVirtualId(cleanId);
-      if (resolvedVirtualId) return resolvedVirtualId;
-      if (cleanId.startsWith(VIRTUAL_ID_PREFIX)) {
-        return `${RESOLVED_VIRTUAL_ID_PREFIX}${cleanId.slice(
-          VIRTUAL_ID_PREFIX.length,
-        )}`;
-      }
-      if (!graph.parsePackageStyleId(cleanId)) return null;
-      return `${RESOLVED_VIRTUAL_ID_PREFIX}${cleanId}`;
-    },
-    async load(id) {
-      if (!id.startsWith(RESOLVED_VIRTUAL_ID_PREFIX)) return null;
-      const originalId = id.slice(RESOLVED_VIRTUAL_ID_PREFIX.length);
-      const graph = getGraph();
-      const parsed = graph.parsePackageStyleId(originalId);
-      if (!parsed) return null;
-      const result = await graph.createPackageStyleCode(parsed);
-      for (const file of result.watchFiles) {
-        hmr.trackVirtualStyleDependency(file, id);
-        this.addWatchFile?.(file);
-      }
-      return result.code;
-    },
-    configureServer(server) {
-      const graph = getGraph();
-      hmr.installFullReloadGuard(server);
-      server.watcher.add(graph.getWatchRoots());
-      const invalidateStyleGraph = (file) => {
-        if (!graph.isSourceGraphFile(file)) return false;
-        invalidateVirtualModules(server, graph);
-        return true;
-      };
-      const reloadStyleGraph = (file) => {
-        if (!invalidateStyleGraph(file)) return;
-        server.ws.send({ type: 'full-reload' });
-      };
-      const handleSourceAddOrUnlink = (file) => {
-        if (graph.isStyleFile(file)) {
-          invalidateStyleGraph(file);
-          return;
-        }
-        reloadStyleGraph(file);
-      };
-      server.watcher.on('add', handleSourceAddOrUnlink);
-      server.watcher.on('unlink', handleSourceAddOrUnlink);
-      server.watcher.on('change', (file) => {
-        if (graph.isStyleConfigFile(file)) {
-          reloadStyleGraph(file);
+    let graph = null;
+    const getGraph = () => {
+        if (!graph) {
+            graph = createModuleStyleGraph(options, process.cwd());
         }
-      });
-    },
-    hotUpdate: {
-      order: 'pre',
-      handler(context) {
-        return hmr.handleStyleHotUpdate(context);
-      },
-    },
-  };
+        return graph;
+    };
+    const hmr = new AukletStyleHmr(getGraph);
+    return {
+        name: 'auklet-css',
+        apply: 'serve',
+        enforce: 'pre',
+        configResolved(config) {
+            graph = createModuleStyleGraph(options, config.root);
+        },
+        resolveId(id) {
+            const graph = getGraph();
+            const cleanId = stripQuery(id);
+            const resolvedVirtualId = toResolvedVirtualId(cleanId);
+            if (resolvedVirtualId)
+                return resolvedVirtualId;
+            if (cleanId.startsWith(VIRTUAL_ID_PREFIX)) {
+                return `${RESOLVED_VIRTUAL_ID_PREFIX}${cleanId.slice(VIRTUAL_ID_PREFIX.length)}`;
+            }
+            if (!graph.parsePackageStyleId(cleanId))
+                return null;
+            return `${RESOLVED_VIRTUAL_ID_PREFIX}${cleanId}`;
+        },
+        async load(id) {
+            if (!id.startsWith(RESOLVED_VIRTUAL_ID_PREFIX))
+                return null;
+            const originalId = id.slice(RESOLVED_VIRTUAL_ID_PREFIX.length);
+            const graph = getGraph();
+            const parsed = graph.parsePackageStyleId(originalId);
+            if (!parsed)
+                return null;
+            const result = await graph.createPackageStyleCode(parsed);
+            for (const file of result.watchFiles) {
+                hmr.trackVirtualStyleDependency(file, id);
+                this.addWatchFile?.(file);
+            }
+            return result.code;
+        },
+        async configureServer(server) {
+            const graph = getGraph();
+            hmr.installFullReloadGuard(server);
+            server.watcher.add(await graph.getWatchRoots());
+            const invalidateStyleGraph = (file) => {
+                if (!graph.isSourceGraphFile(file))
+                    return false;
+                invalidateVirtualModules(server, graph);
+                return true;
+            };
+            const reloadStyleGraph = (file) => {
+                if (!invalidateStyleGraph(file))
+                    return;
+                server.ws.send({ type: 'full-reload' });
+            };
+            const handleSourceAddOrUnlink = (file) => {
+                if (graph.isStyleFile(file)) {
+                    invalidateStyleGraph(file);
+                    return;
+                }
+                reloadStyleGraph(file);
+            };
+            server.watcher.on('add', handleSourceAddOrUnlink);
+            server.watcher.on('unlink', handleSourceAddOrUnlink);
+            server.watcher.on('change', (file) => {
+                if (graph.isStyleConfigFile(file)) {
+                    reloadStyleGraph(file);
+                }
+            });
+        },
+        hotUpdate: {
+            order: 'pre',
+            handler(context) {
+                return hmr.handleStyleHotUpdate(context);
+            },
+        },
+    };
 }

package/dist/css/watch/watcher.d.ts

@@ -1,23 +1,17 @@
-import type {
-  ModuleStyleBuildConfig,
-  ModuleStyleBuildContext,
-} from '#auklet/types';
+import type { ModuleStyleBuildConfig, ModuleStyleBuildContext } from '#auklet/types';
 export declare class ModuleStyleWatcher {
-  private readonly config;
-  private readonly context;
-  private readonly logger?;
-  private timer;
-  private isBuilding;
-  private shouldRebuild;
-  private watcher;
-  constructor(
-    context?: ModuleStyleBuildContext,
-    config?: ModuleStyleBuildConfig,
-  );
-  watch(): Promise<void>;
-  private rebuild;
-  private refreshWatcher;
-  private scheduleBuild;
-  private shouldRebuildForFile;
-  close(): Promise<void>;
+    private readonly config;
+    private readonly context;
+    private readonly logger?;
+    private timer;
+    private isBuilding;
+    private shouldRebuild;
+    private watcher;
+    constructor(context?: ModuleStyleBuildContext, config?: ModuleStyleBuildConfig);
+    watch(): Promise<void>;
+    private rebuild;
+    private refreshWatcher;
+    private scheduleBuild;
+    private shouldRebuildForFile;
+    close(): Promise<void>;
 }

package/dist/css/watch/watcher.js

@@ -3,89 +3,92 @@ import path from 'node:path';
 import chokidar from 'chokidar';
 import { aukletConfigFile, aukletDefaultOptions } from '#auklet/config';
 import { moduleStyleBuildConfig } from '#auklet/css/config';
-import { SOURCE_COMPONENT_MODULE_RE } from '#auklet/css/constants';
+import { SOURCE_MODULE_RE } from '#auklet/css/constants';
 import { ModuleStyleBuilder } from '#auklet/css/production/builder';
 export class ModuleStyleWatcher {
-  config;
-  context;
-  logger;
-  timer = null;
-  isBuilding = false;
-  shouldRebuild = false;
-  watcher = null;
-  constructor(context = {}, config = moduleStyleBuildConfig) {
-    this.config = config;
-    this.context = {
-      packageRoot: process.cwd(),
-      ...context,
-    };
-    this.logger = context.logger;
-  }
-  async watch() {
-    await this.rebuild();
-    this.logger?.log?.('[auklet:css] watch mode ready');
-  }
-  async rebuild() {
-    if (this.isBuilding) {
-      this.shouldRebuild = true;
-      return;
+    config;
+    context;
+    logger;
+    timer = null;
+    isBuilding = false;
+    shouldRebuild = false;
+    watcher = null;
+    constructor(context = {}, config = moduleStyleBuildConfig) {
+        this.config = config;
+        this.context = {
+            packageRoot: process.cwd(),
+            ...context,
+        };
+        this.logger = context.logger;
     }
-    this.isBuilding = true;
-    try {
-      const builder = new ModuleStyleBuilder(this.context, this.config);
-      await builder.build();
-      await this.refreshWatcher();
-    } catch (error) {
-      this.logger?.error?.(error);
-    } finally {
-      this.isBuilding = false;
-      if (this.shouldRebuild) {
-        this.shouldRebuild = false;
-        this.scheduleBuild();
-      }
+    async watch() {
+        await this.rebuild();
+        this.logger?.log?.('[auklet:css] watch mode ready');
+    }
+    async rebuild() {
+        if (this.isBuilding) {
+            this.shouldRebuild = true;
+            return;
+        }
+        this.isBuilding = true;
+        try {
+            const builder = new ModuleStyleBuilder(this.context, this.config);
+            await builder.build();
+            await this.refreshWatcher();
+        }
+        catch (error) {
+            this.logger?.error?.(error);
+        }
+        finally {
+            this.isBuilding = false;
+            if (this.shouldRebuild) {
+                this.shouldRebuild = false;
+                this.scheduleBuild();
+            }
+        }
+    }
+    async refreshWatcher() {
+        const aukletConfig = this.context.aukletConfig ?? {};
+        const sourceDir = this.context.source ?? aukletConfig.source ?? aukletDefaultOptions.source;
+        const sourceRoot = path.join(this.context.packageRoot, sourceDir);
+        const configPath = path.join(this.context.packageRoot, aukletConfigFile);
+        const watchPaths = [sourceRoot, configPath].filter((file) => fs.existsSync(file));
+        await this.watcher?.close();
+        this.watcher = chokidar.watch(watchPaths, {
+            ignoreInitial: true,
+            interval: 300,
+            usePolling: true,
+        });
+        this.watcher.on('all', (_event, file) => {
+            if (typeof file === 'string' && !this.shouldRebuildForFile(file)) {
+                return;
+            }
+            this.scheduleBuild();
+        });
+        this.watcher.on('error', (error) => {
+            this.logger?.error?.(error);
+        });
+    }
+    scheduleBuild() {
+        if (this.timer)
+            clearTimeout(this.timer);
+        this.timer = setTimeout(() => {
+            this.timer = null;
+            this.rebuild().catch((error) => {
+                this.logger?.error?.(error);
+            });
+        }, 80);
+    }
+    shouldRebuildForFile(file) {
+        if (path.basename(file) === aukletConfigFile)
+            return true;
+        if (SOURCE_MODULE_RE.test(file))
+            return true;
+        return this.config.styleExtensions.includes(path.extname(file));
+    }
+    async close() {
+        if (this.timer)
+            clearTimeout(this.timer);
+        await this.watcher?.close();
     }
-  }
-  async refreshWatcher() {
-    const aukletConfig = this.context.aukletConfig ?? {};
-    const sourceDir =
-      this.context.source ?? aukletConfig.source ?? aukletDefaultOptions.source;
-    const sourceRoot = path.join(this.context.packageRoot, sourceDir);
-    const configPath = path.join(this.context.packageRoot, aukletConfigFile);
-    const watchPaths = [sourceRoot, configPath].filter((file) =>
-      fs.existsSync(file),
-    );
-    await this.watcher?.close();
-    this.watcher = chokidar.watch(watchPaths, {
-      ignoreInitial: true,
-      interval: 300,
-      usePolling: true,
-    });
-    this.watcher.on('all', (_event, file) => {
-      if (typeof file === 'string' && !this.shouldRebuildForFile(file)) {
-        return;
-      }
-      this.scheduleBuild();
-    });
-    this.watcher.on('error', (error) => {
-      this.logger?.error?.(error);
-    });
-  }
-  scheduleBuild() {
-    if (this.timer) clearTimeout(this.timer);
-    this.timer = setTimeout(() => {
-      this.timer = null;
-      this.rebuild().catch((error) => {
-        this.logger?.error?.(error);
-      });
-    }, 80);
-  }
-  shouldRebuildForFile(file) {
-    if (path.basename(file) === aukletConfigFile) return true;
-    if (SOURCE_COMPONENT_MODULE_RE.test(file)) return true;
-    return this.config.styleExtensions.includes(path.extname(file));
-  }
-  async close() {
-    if (this.timer) clearTimeout(this.timer);
-    await this.watcher?.close();
-  }
 }

package/dist/index.d.ts

@@ -1,30 +1,8 @@
-export type {
-  AukletConfig,
-  ConfigureTsdown,
-  ConfigureTsdownContext,
-  LoadAukletConfigOptions,
-  ModuleStyleBuildConfig,
-  ModuleStyleBuildContext,
-  ModuleStyleBuildOptions,
-  NormalizedAukletConfig,
-  NormalizedStyleDependencyGroup,
-  PackageBuildFormat,
-  PackageBuildOptions,
-  ResolvedModuleStyleBuildContext,
-  StyleDependencyGroup,
-  StyleOptions,
-} from '#auklet/types';
+export type { AukletConfig, ConfigureTsdown, ConfigureTsdownContext, LoadAukletConfigOptions, ModuleStyleBuildConfig, ModuleStyleBuildContext, ModuleStyleBuildOptions, NormalizedAukletConfig, NormalizedStyleDependencyGroup, PackageBuildFormat, PackageBuildOptions, ResolvedModuleStyleBuildContext, StyleDependencyGroup, StyleOptions, } from '#auklet/types';
 export type { RunTsdownOptions } from '#auklet/build/runTsdown';
 export type { AukletStylePluginOptions } from '#auklet/css/vite/vitePlugin';
-export {
-  aukletDefaultOptions,
-  aukletDefaultStyleDependencyConfig,
-  normalizeAukletConfig,
-} from '#auklet/config';
-export {
-  loadAukletConfig,
-  resolveAukletConfigModule,
-} from '#auklet/configLoader';
+export { aukletDefaultOptions, aukletDefaultStyleDependencyConfig, normalizeAukletConfig, } from '#auklet/config';
+export { loadAukletConfig, resolveAukletConfigModule, } from '#auklet/configLoader';
 export { aukletStylePlugin } from '#auklet/css/vite/vitePlugin';
 export { createTsdownArgs, runTsdown } from '#auklet/build/runTsdown';
 export { ModuleStyleWatcher } from '#auklet/css/watch/watcher';

package/dist/index.js

@@ -1,12 +1,5 @@
-export {
-  aukletDefaultOptions,
-  aukletDefaultStyleDependencyConfig,
-  normalizeAukletConfig,
-} from '#auklet/config';
-export {
-  loadAukletConfig,
-  resolveAukletConfigModule,
-} from '#auklet/configLoader';
+export { aukletDefaultOptions, aukletDefaultStyleDependencyConfig, normalizeAukletConfig, } from '#auklet/config';
+export { loadAukletConfig, resolveAukletConfigModule, } from '#auklet/configLoader';
 export { aukletStylePlugin } from '#auklet/css/vite/vitePlugin';
 export { createTsdownArgs, runTsdown } from '#auklet/build/runTsdown';
 export { ModuleStyleWatcher } from '#auklet/css/watch/watcher';

package/dist/types.d.ts

@@ -1,94 +1,91 @@
 import type { UserConfig } from 'tsdown/config';
 export type StyleDependencyGroup = {
-  entry?: string | Array<string>;
-  themes?: Record<string, string>;
-  components?: string | Array<string>;
+    entry?: string | Array<string>;
+    themes?: Record<string, string>;
+    components?: string | Array<string>;
 };
 export type StyleOptions = {
-  themes?: Record<string, string>;
-  dependencies?: Record<string, StyleDependencyGroup>;
+    themes?: Record<string, string>;
+    dependencies?: Record<string, StyleDependencyGroup>;
 };
 export type NormalizedStyleDependencyGroup = {
-  entry?: string | Array<string>;
-  themes?: Record<string, string>;
-  components?: string | Array<string>;
+    entry?: string | Array<string>;
+    themes?: Record<string, string>;
+    components?: string | Array<string>;
 };
 export interface NormalizedAukletConfig {
-  source: string;
-  output: string;
-  modules: boolean;
-  styles: {
-    themes: Record<string, string>;
-    dependencies: Record<string, NormalizedStyleDependencyGroup>;
-  };
-  build: Required<Pick<PackageBuildOptions, 'formats' | 'target' | 'platform'>>;
+    source: string;
+    output: string;
+    modules: boolean;
+    styles: {
+        themes: Record<string, string>;
+        dependencies: Record<string, NormalizedStyleDependencyGroup>;
+    };
+    build: Required<Pick<PackageBuildOptions, 'formats' | 'target' | 'platform'>>;
 }
 export type PackageBuildFormat = 'cjs' | 'esm' | 'iife';
 export type PackageBuildPlatform = 'node' | 'neutral' | 'browser';
 export type PackageBuildTarget = string | Array<string> | false;
 export type ConfigureTsdownContext = {
-  kind: 'bundle' | 'module';
-  format: PackageBuildFormat;
-  packageRoot: string;
-  output: string;
-  packageName?: string;
+    kind: 'bundle' | 'module';
+    format: PackageBuildFormat;
+    packageRoot: string;
+    output: string;
+    packageName?: string;
 };
-export type ConfigureTsdown = (
-  config: UserConfig,
-  context: ConfigureTsdownContext,
-) => UserConfig;
+export type ConfigureTsdown = (config: UserConfig, context: ConfigureTsdownContext) => UserConfig;
 export type PackageBuildOptions = {
-  formats?: Array<PackageBuildFormat>;
-  target?: PackageBuildTarget;
-  platform?: PackageBuildPlatform;
-  banner?: string;
-  externals?: Array<string>;
-  alias?: Record<string, string>;
-  mainFields?: Array<string>;
-  globals?: Record<string, string>;
-  configureTsdown?: ConfigureTsdown;
-  tsconfig?: string;
+    formats?: Array<PackageBuildFormat>;
+    target?: PackageBuildTarget;
+    platform?: PackageBuildPlatform;
+    banner?: string;
+    externals?: Array<string>;
+    alias?: Record<string, string>;
+    mainFields?: Array<string>;
+    globals?: Record<string, string>;
+    configureTsdown?: ConfigureTsdown;
+    tsconfig?: string;
 };
 export interface AukletConfig {
-  source?: string;
-  output?: string;
-  modules?: boolean;
-  styles?: StyleOptions;
-  build?: PackageBuildOptions;
+    source?: string;
+    output?: string;
+    modules?: boolean;
+    styles?: StyleOptions;
+    build?: PackageBuildOptions;
 }
 export type AukletLogger = {
-  log?: (...args: Array<unknown>) => void;
-  info?: (...args: Array<unknown>) => void;
-  error?: (...args: Array<unknown>) => void;
+    log?: (...args: Array<unknown>) => void;
+    info?: (...args: Array<unknown>) => void;
+    error?: (...args: Array<unknown>) => void;
 };
 export type LoadAukletConfigOptions = {
-  configFile?: string;
-  cacheBust?: boolean;
+    configFile?: string;
+    cacheBust?: boolean;
 };
 export interface ModuleStyleBuildContext {
-  packageRoot?: string;
-  aukletConfig?: AukletConfig;
-  logger?: AukletLogger;
-  source?: string;
-  output?: string;
+    packageRoot?: string;
+    aukletConfig?: AukletConfig;
+    logger?: AukletLogger;
+    source?: string;
+    output?: string;
 }
 export interface ResolvedModuleStyleBuildContext {
-  packageRoot: string;
-  sourceDir: string;
-  outputDir: string;
+    packageRoot: string;
+    sourceDir: string;
+    outputDir: string;
 }
 export type ModuleStyleBuildOptions = {
-  aukletConfig?: AukletConfig;
-  logger?: AukletLogger;
+    aukletConfig?: AukletConfig;
+    logger?: AukletLogger;
 };
 export interface ModuleStyleBuildOutputConfig {
-  outputFormats: Array<string>;
-  styleDir: string;
-  indexStyleFile: string;
-  externalStyleFile: string;
-  moduleStyleFile: string;
+    outputFormats: Array<string>;
+    styleDir: string;
+    indexStyleFile: string;
+    externalStyleFile: string;
+    moduleStyleFile: string;
 }
 export interface ModuleStyleBuildConfig {
-  output: ModuleStyleBuildOutputConfig;
-  styleExtensions: Array<string>;
+    output: ModuleStyleBuildOutputConfig;
+    styleExtensions: Array<string>;
 }

package/dist/utils.d.ts

@@ -1,5 +1,5 @@
-export declare const POSIX_SEPARATOR = '/';
-export declare const IMPORT_LIST_SEPARATOR = ',';
+export declare const POSIX_SEPARATOR = "/";
+export declare const IMPORT_LIST_SEPARATOR = ",";
 export declare const TEST_DIR_NAMES: Set<string>;
 export declare const SOURCE_TEST_RE: RegExp;
 export declare const SOURCE_MODULE_RE: RegExp;
@@ -17,8 +17,4 @@ export declare function toWatchPath(...parts: Array<string>): string;
 export declare function removeExtension(file: string): string;
 export declare function getSourceModuleDir(file: string): string;
 export declare function escapeRegExp(value: string): string;
-export declare function appendUniqueMapValue<K, V>(
-  map: Map<K, Array<V>>,
-  key: K,
-  value: V,
-): void;
+export declare function appendUniqueMapValue<K, V>(map: Map<K, Array<V>>, key: K, value: V): void;