@jk2908/cxx 0.1.9 → 0.2.0

package/dist/config.d.ts

@@ -0,0 +1,5 @@
+export declare const NAME = "cxx";
+export declare const PKG_NAME = "@jk2908/cxx";
+export declare const GENERATED_DIR = ".cxx";
+export declare const AUTOGEN_MSG = "// auto-generated by cxx";
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,IAAI,QAAQ,CAAA;AACzB,eAAO,MAAM,QAAQ,gBAAoB,CAAA;AACzC,eAAO,MAAM,aAAa,SAAa,CAAA;AACvC,eAAO,MAAM,WAAW,6BAAiC,CAAA"}

package/dist/index.d.ts

@@ -1,9 +1,41 @@
-declare module 'react' {
-    interface StyleHTMLAttributes<T> extends React.HTMLAttributes<T> {
-        href?: string;
-        precedence?: 'low' | 'medium' | 'high';
-    }
+import type { BuildContext, Cxx, PluginConfig, Tags } from './types.js';
+/**
+ * Returns whether the error was caused by a missing file or directory
+ */
+export declare function isENOENT(err: unknown): boolean;
+/**
+ * Write a file only if the content has changed since the last build
+ */
+export declare function maybeWrite(filePath: string, content: string): Promise<boolean>;
+export declare class TagDuplicateError extends Error {
+    constructor(tag: string);
 }
-declare const cxx: (_: TemplateStringsArray) => readonly ["", Record<string, string>, ""];
-
-export { cxx };
+/**
+ * Transform `cxx` templates in one source file and collect any exported tag types
+ */
+export declare function collect(source: string, id: string, config: PluginConfig): {
+    source: string;
+    template: string;
+    tags: Tags;
+} | {
+    template: string;
+    tags: Tags;
+};
+/**
+ * Write the generated declaration file for the current set of collected tags
+ */
+export declare function writeTypes(tags: Tags): Promise<void>;
+/**
+ * Render collected tags as a module augmentation for the package entrypoint
+ */
+export declare function tagsToType(tags: Tags): string;
+/**
+ * Merge per-file tag maps into one application-wide tag map
+ */
+export declare function flattenTags(tagsByFile: BuildContext['tagsByFile']): Map<string, string[]>;
+/**
+ * Build-time template tag placeholder used by the transform to emit CSS, classes and href values
+ */
+export declare const cxx: Cxx;
+export declare const css: Cxx;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,YAAY,EAAU,IAAI,EAAE,MAAM,YAAY,CAAA;AAiB/E;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,WAEpC;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,oBAyBjE;AAeD,qBAAa,iBAAkB,SAAQ,KAAK;gBAC/B,GAAG,EAAE,MAAM;CAGvB;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY;YAnE5B,MAAM;cAAY,MAAM;UAAQ,IAAI;;;;EA0H/E;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,IAAI,iBA2B1C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,UAepC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,YAAY,CAAC,YAAY,CAAC,yBAWjE;AAED;;GAEG;AACH,eAAO,MAAM,GAAG,EAAE,GAQhB,CAAA;AAEF,eAAO,MAAM,GAAG,KAAM,CAAA"}

package/dist/index.js

@@ -1,7 +1,197 @@
-const cxx = (_)=>[
-        '',
-        {},
-        ''
-    ];
+// src/index.ts
+import { createHash } from "node:crypto";
+import fs from "node:fs/promises";
+import path from "node:path";
+import { transform } from "lightningcss";
 
-export { cxx };
+// src/config.ts
+var NAME = "cxx";
+var PKG_NAME = `@jk2908/${NAME}`;
+var GENERATED_DIR = `.${NAME}`;
+var AUTOGEN_MSG = `// auto-generated by ${NAME}`;
+
+// src/lru.ts
+var CACHE_MAX_SIZE = 100;
+
+class LruCache {
+  #cache = new Map;
+  #maxSize;
+  constructor(maxSize = CACHE_MAX_SIZE) {
+    this.#maxSize = maxSize;
+  }
+  get size() {
+    return this.#cache.size;
+  }
+  get(key) {
+    const cached = this.#cache.get(key);
+    if (this.#cache.has(key))
+      this.set(key, cached);
+    return cached;
+  }
+  set(key, value) {
+    this.#cache.delete(key);
+    if (this.#cache.size >= this.#maxSize) {
+      const lru = this.#cache.keys().next().value;
+      if (lru !== undefined)
+        this.#cache.delete(lru);
+    }
+    this.#cache.set(key, value);
+  }
+  delete(key) {
+    return this.#cache.delete(key);
+  }
+  clear() {
+    return this.#cache.clear();
+  }
+}
+
+// src/utils.ts
+function capitalise(str) {
+  return str.charAt(0).toUpperCase() + str.slice(1);
+}
+function pascalise(str) {
+  return str.split(/[ _-]+/).map(capitalise).join("");
+}
+function debounce(fn, wait) {
+  let timeoutId = null;
+  return (...args) => {
+    if (timeoutId) {
+      clearTimeout(timeoutId);
+    }
+    timeoutId = setTimeout(() => {
+      fn.apply(null, args);
+    }, wait);
+  };
+}
+
+// src/index.ts
+var collectCache = new LruCache;
+var fileCache = new LruCache;
+function isENOENT(err) {
+  return err instanceof Error && "code" in err && err.code === "ENOENT";
+}
+async function maybeWrite(filePath, content) {
+  const cached = fileCache.get(filePath);
+  if (cached !== content) {
+    await fs.writeFile(filePath, content);
+    fileCache.set(filePath, content);
+    return true;
+  }
+  try {
+    if (await fs.readFile(filePath, "utf-8") === content) {
+      fileCache.set(filePath, content);
+      return false;
+    }
+  } catch (err) {
+    if (!isENOENT(err))
+      throw err;
+  }
+  await fs.writeFile(filePath, content);
+  fileCache.set(filePath, content);
+  return true;
+}
+var regex = /(?:const|var|let)\s*\[(\w+|)\s*,?\s*(\w+|)\s*,?\s*(\w+|)\s*\]\s*=\s*cxx(?:\s*`([\s\S]*?)`|\s*\.\s*tag(?:\s*<[^>]+>)?\s*\(\s*(['"])(.*?)\5\s*\)\s*`([\s\S]*?)`)/gm;
+function hashCss(code) {
+  return `cxx-${createHash("sha256").update(code).digest("base64url").slice(0, 12)}`;
+}
+
+class TagDuplicateError extends Error {
+  constructor(tag) {
+    super(`Tag ${tag} has already been seen. Tags must be unique across your application`);
+  }
+}
+function collect(source, id, config) {
+  const tags = new Map;
+  const cached = collectCache.get(id);
+  if (cached?.source === source)
+    return cached;
+  const template = source.replace(regex, (_match, varOne, varTwo, varThree, plainCss, _quote, tag, taggedCss) => {
+    const css = plainCss ?? taggedCss;
+    const { code, exports = {} } = transform({
+      minify: true,
+      cssModules: true,
+      filename: id,
+      code: new TextEncoder().encode(css)
+    });
+    const href = hashCss(code);
+    const styles = Object.fromEntries(Object.entries(exports).map(([k, v]) => [k, v.name]));
+    if (tag) {
+      const suffix = typeof config.typeSuffix === "string" ? config.typeSuffix : config.typeSuffix === false ? "" : "Classes";
+      const tagWithSuffix = pascalise(`${tag}${suffix}`);
+      if (tags.has(tagWithSuffix))
+        throw new TagDuplicateError(tagWithSuffix);
+      tags.set(tagWithSuffix, Object.keys(styles));
+    }
+    return [
+      varOne && `const ${varOne} = \`${code}\``,
+      varTwo && `const ${varTwo} = ${JSON.stringify(styles)}`,
+      varThree && `const ${varThree} = \`${href}\``
+    ].filter(Boolean).join(`
+`);
+  });
+  collectCache.set(id, { source, template, tags });
+  return {
+    template,
+    tags
+  };
+}
+async function writeTypes(tags) {
+  const filePath = path.join(GENERATED_DIR, "index.d.ts");
+  if (!tags.size) {
+    try {
+      await fs.rm(filePath, { force: true });
+      fileCache.delete(filePath);
+    } catch (err) {
+      if (!isENOENT(err))
+        throw err;
+    }
+    return;
+  }
+  await fs.mkdir(GENERATED_DIR, { recursive: true });
+  await maybeWrite(filePath, `${AUTOGEN_MSG}
+
+			import '${PKG_NAME}'
+
+			declare module '${PKG_NAME}' {
+				${tagsToType(tags)}
+			}
+		`);
+}
+function tagsToType(tags) {
+  return [...tags].map(([tag, classes]) => `
+		export type ${tag} = ${classes.length > 0 ? classes.toSorted((a, b) => a.length - b.length).map((c) => `'${c}'`).join(" | ") : "never"}
+	`).join(`
+`);
+}
+function flattenTags(tagsByFile) {
+  const tags = new Map;
+  for (const fileTags of tagsByFile.values()) {
+    for (const [name, classes] of fileTags) {
+      if (tags.has(name))
+        throw new TagDuplicateError(name);
+      tags.set(name, classes);
+    }
+  }
+  return tags;
+}
+var cxx = Object.assign((_) => ["", {}, ""], {
+  tag: (_) => (_strings) => [
+    "",
+    {},
+    ""
+  ]
+});
+var css = cxx;
+export {
+  writeTypes,
+  tagsToType,
+  maybeWrite,
+  isENOENT,
+  flattenTags,
+  cxx,
+  css,
+  collect,
+  TagDuplicateError
+};
+
+//# debugId=6D86A21ED341F54864756E2164756E21

package/dist/index.js.map

@@ -0,0 +1,13 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts", "../src/config.ts", "../src/lru.ts", "../src/utils.ts"],
+  "sourcesContent": [
+    "import { createHash } from 'node:crypto'\nimport fs from 'node:fs/promises'\nimport path from 'node:path'\n\nimport { transform } from 'lightningcss'\n\nimport type { BuildContext, Cxx, PluginConfig, Result, Tags } from './types.js'\nimport { AUTOGEN_MSG, GENERATED_DIR, PKG_NAME } from './config.js'\nimport { LruCache } from './lru.js'\nimport { pascalise } from './utils.js'\n\n/**\n * LRU cache of `collect` results by file id and last seen source so watcher and transform can\n * reuse the same parsed template/tags\n */\nconst collectCache = new LruCache<{ source: string; template: string; tags: Tags }>()\n\n/**\n * LRU cache for file content. Stores the last written content per file path so `maybeWrite`\n * can skip disk i/o when nothing has changed\n */\nconst fileCache = new LruCache<string>()\n\n/**\n * Returns whether the error was caused by a missing file or directory\n */\nexport function isENOENT(err: unknown) {\n\treturn err instanceof Error && 'code' in err && err.code === 'ENOENT'\n}\n\n/**\n * Write a file only if the content has changed since the last build\n */\nexport async function maybeWrite(filePath: string, content: string) {\n\tconst cached = fileCache.get(filePath)\n\n\tif (cached !== content) {\n\t\t// cache says content changed, write without reading\n\t\tawait fs.writeFile(filePath, content)\n\t\tfileCache.set(filePath, content)\n\n\t\treturn true\n\t}\n\n\t// cache miss or cache hit with same content — verify on disk\n\ttry {\n\t\tif ((await fs.readFile(filePath, 'utf-8')) === content) {\n\t\t\tfileCache.set(filePath, content)\n\t\t\treturn false\n\t\t}\n\t} catch (err) {\n\t\tif (!isENOENT(err)) throw err\n\t}\n\n\tawait fs.writeFile(filePath, content)\n\tfileCache.set(filePath, content)\n\n\treturn true\n}\n\n// matches `[css, classes, href] = cxx\\`...\\`` and `cxx.tag<T>('name')\\`...\\``\n// capture groups: 1-3 assigned variable names, 4 plain css body, 5 quote\n// kind, 6 tag name, 7 tagged css body\nconst regex =\n\t/(?:const|var|let)\\s*\\[(\\w+|)\\s*,?\\s*(\\w+|)\\s*,?\\s*(\\w+|)\\s*\\]\\s*=\\s*cxx(?:\\s*`([\\s\\S]*?)`|\\s*\\.\\s*tag(?:\\s*<[^>]+>)?\\s*\\(\\s*(['\"])(.*?)\\5\\s*\\)\\s*`([\\s\\S]*?)`)/gm\n\n/**\n * Hash transformed CSS into a stable href for style deduplication\n */\nfunction hashCss(code: Uint8Array) {\n\treturn `cxx-${createHash('sha256').update(code).digest('base64url').slice(0, 12)}`\n}\n\nexport class TagDuplicateError extends Error {\n\tconstructor(tag: string) {\n\t\tsuper(`Tag ${tag} has already been seen. Tags must be unique across your application`)\n\t}\n}\n\n/**\n * Transform `cxx` templates in one source file and collect any exported tag types\n */\nexport function collect(source: string, id: string, config: PluginConfig) {\n\tconst tags: Tags = new Map()\n\n\tconst cached = collectCache.get(id)\n\tif (cached?.source === source) return cached\n\n\tconst template = source.replace(\n\t\tregex,\n\t\t(_match, varOne, varTwo, varThree, plainCss, _quote, tag, taggedCss) => {\n\t\t\tconst css = plainCss ?? taggedCss\n\n\t\t\tconst { code, exports = {} } = transform({\n\t\t\t\tminify: true,\n\t\t\t\tcssModules: true,\n\t\t\t\tfilename: id,\n\t\t\t\tcode: new TextEncoder().encode(css),\n\t\t\t})\n\n\t\t\tconst href = hashCss(code)\n\t\t\tconst styles = Object.fromEntries(\n\t\t\t\tObject.entries(exports).map(([k, v]) => [k, v.name]),\n\t\t\t)\n\n\t\t\tif (tag) {\n\t\t\t\tconst suffix =\n\t\t\t\t\ttypeof config.typeSuffix === 'string'\n\t\t\t\t\t\t? config.typeSuffix\n\t\t\t\t\t\t: config.typeSuffix === false\n\t\t\t\t\t\t\t? ''\n\t\t\t\t\t\t\t: 'Classes'\n\t\t\t\tconst tagWithSuffix = pascalise(`${tag}${suffix}`)\n\n\t\t\t\tif (tags.has(tagWithSuffix)) throw new TagDuplicateError(tagWithSuffix)\n\n\t\t\t\t// side effect but neccessary\n\t\t\t\ttags.set(tagWithSuffix, Object.keys(styles))\n\t\t\t}\n\n\t\t\treturn [\n\t\t\t\tvarOne && `const ${varOne} = \\`${code}\\``,\n\t\t\t\tvarTwo && `const ${varTwo} = ${JSON.stringify(styles)}`,\n\t\t\t\tvarThree && `const ${varThree} = \\`${href}\\``,\n\t\t\t]\n\t\t\t\t.filter(Boolean)\n\t\t\t\t.join('\\n')\n\t\t},\n\t)\n\n\t// cache\n\tcollectCache.set(id, { source, template, tags })\n\n\treturn {\n\t\ttemplate,\n\t\ttags,\n\t}\n}\n\n/**\n * Write the generated declaration file for the current set of collected tags\n */\nexport async function writeTypes(tags: Tags) {\n\tconst filePath = path.join(GENERATED_DIR, 'index.d.ts')\n\n\tif (!tags.size) {\n\t\ttry {\n\t\t\tawait fs.rm(filePath, { force: true })\n\t\t\tfileCache.delete(filePath)\n\t\t} catch (err) {\n\t\t\tif (!isENOENT(err)) throw err\n\t\t}\n\n\t\treturn\n\t}\n\n\tawait fs.mkdir(GENERATED_DIR, { recursive: true })\n\n\tawait maybeWrite(\n\t\tfilePath,\n\t\t`${AUTOGEN_MSG}\n\n\t\t\timport '${PKG_NAME}'\n\n\t\t\tdeclare module '${PKG_NAME}' {\n\t\t\t\t${tagsToType(tags)}\n\t\t\t}\n\t\t`,\n\t)\n}\n\n/**\n * Render collected tags as a module augmentation for the package entrypoint\n */\nexport function tagsToType(tags: Tags) {\n\treturn [...tags]\n\t\t.map(\n\t\t\t([tag, classes]) => `\n\t\texport type ${tag} = ${\n\t\t\tclasses.length > 0\n\t\t\t\t? classes\n\t\t\t\t\t\t.toSorted((a, b) => a.length - b.length)\n\t\t\t\t\t\t.map(c => `'${c}'`)\n\t\t\t\t\t\t.join(' | ')\n\t\t\t\t: 'never'\n\t\t}\n\t`,\n\t\t)\n\t\t.join('\\n')\n}\n\n/**\n * Merge per-file tag maps into one application-wide tag map\n */\nexport function flattenTags(tagsByFile: BuildContext['tagsByFile']) {\n\tconst tags = new Map<string, string[]>()\n\n\tfor (const fileTags of tagsByFile.values()) {\n\t\tfor (const [name, classes] of fileTags) {\n\t\t\tif (tags.has(name)) throw new TagDuplicateError(name)\n\t\t\ttags.set(name, classes)\n\t\t}\n\t}\n\n\treturn tags\n}\n\n/**\n * Build-time template tag placeholder used by the transform to emit CSS, classes and href values\n */\nexport const cxx: Cxx = Object.assign((_: TemplateStringsArray): Result => ['', {}, ''], {\n\ttag:\n\t\t<ClassName extends string = string>(_: string) =>\n\t\t(_strings: TemplateStringsArray): Result<ClassName> => [\n\t\t\t'',\n\t\t\t{} as Readonly<Record<ClassName, string>>,\n\t\t\t'',\n\t\t],\n})\n\nexport const css = cxx\n",
+    "export const NAME = 'cxx'\nexport const PKG_NAME = `@jk2908/${NAME}`\nexport const GENERATED_DIR = `.${NAME}`\nexport const AUTOGEN_MSG = `// auto-generated by ${NAME}`\n",
+    "export const CACHE_MAX_SIZE = 100\n\nexport class LruCache<T> {\n\t#cache: Map<string, T> = new Map()\n\t#maxSize: number\n\n\tconstructor(maxSize = CACHE_MAX_SIZE) {\n\t\tthis.#maxSize = maxSize\n\t}\n\n\tget size() {\n\t\treturn this.#cache.size\n\t}\n\n\t/**\n\t * Retrieve a cached value and promote it to most-recently-used so it won't\n\t * be evicted while still actively referenced\n\t */\n\tget(key: string) {\n\t\tconst cached = this.#cache.get(key)\n\t\tif (this.#cache.has(key)) this.set(key, cached as T)\n\n\t\treturn cached\n\t}\n\n\t/**\n\t * Promote an existing cache entry to most-recently-used by deleting and\n\t * re-inserting it, which moves it to the end of the Map's iteration\n\t * order. If the cache is at capacity, evict the least recently used\n\t * entry (front) before inserting\n\t */\n\tset(key: string, value: T) {\n\t\t// drop any existing entry\n\t\tthis.#cache.delete(key)\n\n\t\tif (this.#cache.size >= this.#maxSize) {\n\t\t\tconst lru = this.#cache.keys().next().value\n\t\t\tif (lru !== undefined) this.#cache.delete(lru)\n\t\t}\n\n\t\tthis.#cache.set(key, value)\n\t}\n\n\tdelete(key: string) {\n\t\treturn this.#cache.delete(key)\n\t}\n\n\tclear() {\n\t\treturn this.#cache.clear()\n\t}\n}\n",
+    "export function capitalise(str: string) {\n\treturn str.charAt(0).toUpperCase() + str.slice(1)\n}\n\nexport function pascalise(str: string) {\n\treturn str\n\t\t.split(/[ _-]+/)\n\t\t.map(capitalise)\n\t\t.join('')\n}\n\nexport function debounce<T extends unknown[]>(fn: (...args: T) => void, wait: number) {\n\tlet timeoutId: ReturnType<typeof setTimeout> | null = null\n\n\treturn (...args: T) => {\n\t\tif (timeoutId) {\n\t\t\tclearTimeout(timeoutId)\n\t\t}\n\n\t\ttimeoutId = setTimeout(() => {\n\t\t\tfn.apply(null, args)\n\t\t}, wait)\n\t}\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "6D86A21ED341F54864756E2164756E21",
+  "names": []
+}

package/dist/logger.d.ts

@@ -0,0 +1,54 @@
+declare const LEVELS: {
+    readonly debug: 0;
+    readonly info: 1;
+    readonly warn: 2;
+    readonly error: 3;
+    readonly fatal: 4;
+};
+export type LogLevel = keyof typeof LEVELS;
+/**
+ * Log messages with different severity levels
+ */
+export declare class Logger {
+    #private;
+    name?: string | undefined;
+    constructor(level?: LogLevel, name?: string | undefined);
+    static set defaultLevel(level: LogLevel);
+    static get defaultLevel(): LogLevel;
+    /**
+     * Convert a value to an Error instance
+     */
+    static toError(err: unknown): Error;
+    /**
+     * Stringify the error for logging
+     */
+    static print(err: unknown): string;
+    set level(level: LogLevel);
+    get level(): LogLevel;
+    /**
+     * Log a message with a specific level
+     */
+    log(level: LogLevel, message: string, error?: Error): void;
+    /**
+     * Log a debug message
+     */
+    debug(...messages: string[]): void;
+    /**
+     * Log an info message
+     */
+    info(...messages: string[]): void;
+    /**
+     * Log a warning message
+     */
+    warn(...messages: string[]): void;
+    /**
+     * Log an error message
+     */
+    error(message: string, error?: unknown): void;
+    /**
+     * Log a fatal error message
+     */
+    fatal(message: string, error?: unknown): void;
+}
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,MAAM;;;;;;CAMF,CAAA;AAEV,MAAM,MAAM,QAAQ,GAAG,MAAM,OAAO,MAAM,CAAA;AAe1C;;GAEG;AACH,qBAAa,MAAM;;IAOV,IAAI,CAAC,EAAE,MAAM;gBADpB,KAAK,CAAC,EAAE,QAAQ,EACT,IAAI,CAAC,EAAE,MAAM,YAAA;IAKrB,MAAM,KAAK,YAAY,CAAC,KAAK,EAAE,QAAQ,EAEtC;IAED,MAAM,KAAK,YAAY,IAJQ,QAAQ,CAMtC;IAED;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO;IAI3B;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,OAAO;IAoBzB,IAAI,KAAK,CAAC,KAAK,EAAE,QAAQ,EAExB;IAED,IAAI,KAAK,IAJQ,QAAQ,CAMxB;IAED;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;IA6BnD;;OAEG;IACH,KAAK,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE;IAI3B;;OAEG;IACH,IAAI,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE;IAI1B;;OAEG;IACH,IAAI,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE;IAI1B;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;IAItC;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAGtC"}

package/dist/lru.d.ts

@@ -0,0 +1,21 @@
+export declare const CACHE_MAX_SIZE = 100;
+export declare class LruCache<T> {
+    #private;
+    constructor(maxSize?: number);
+    get size(): number;
+    /**
+     * Retrieve a cached value and promote it to most-recently-used so it won't
+     * be evicted while still actively referenced
+     */
+    get(key: string): T | undefined;
+    /**
+     * Promote an existing cache entry to most-recently-used by deleting and
+     * re-inserting it, which moves it to the end of the Map's iteration
+     * order. If the cache is at capacity, evict the least recently used
+     * entry (front) before inserting
+     */
+    set(key: string, value: T): void;
+    delete(key: string): boolean;
+    clear(): void;
+}
+//# sourceMappingURL=lru.d.ts.map

package/dist/lru.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lru.d.ts","sourceRoot":"","sources":["../src/lru.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,MAAM,CAAA;AAEjC,qBAAa,QAAQ,CAAC,CAAC;;gBAIV,OAAO,SAAiB;IAIpC,IAAI,IAAI,WAEP;IAED;;;OAGG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM;IAOf;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAYzB,MAAM,CAAC,GAAG,EAAE,MAAM;IAIlB,KAAK;CAGL"}