@jk2908/cxx 0.2.3 → 0.2.6

package/README.md

@@ -98,7 +98,7 @@ See [CHANGELOG.md](./CHANGELOG.md) for release notes.
 
 ## Syntax highlighting
 
-The [`vscode-cxx`](../vscode-cxx) extension provides syntax highlighting for `cxx` and `cxx.tag()` tagged template literals in VS Code. See its [README](../vscode-cxx) for install instructions.
+The [`vscode-cxx`](https://github.com/jk2908/cxx/tree/main/packages/vscode-cxx) extension provides syntax highlighting for `cxx` and `cxx.tag()` tagged template literals in VS Code. See its [README](https://github.com/jk2908/cxx/tree/main/packages/vscode-cxx) for install instructions.
 
 ## License
 

package/dist/build.d.ts

@@ -0,0 +1,37 @@
+import type { BuildContext, 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 DuplicateTagError extends Error {
+    name: string;
+    constructor(tag: string);
+}
+/**
+ * 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[]>;
+//# sourceMappingURL=build.d.ts.map

package/dist/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAiBlE;;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;IAC3C,IAAI,SAAsB;gBAEd,GAAG,EAAE,MAAM;CAGvB;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY;YArE5B,MAAM;cAAY,MAAM;UAAQ,IAAI;;;;EA4H/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"}

package/dist/build.js

@@ -0,0 +1,188 @@
+// src/build.ts
+import { createHash } from "node:crypto";
+import fs from "node:fs/promises";
+import path from "node:path";
+import { transform } from "lightningcss";
+
+// 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/build.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 DuplicateTagError extends Error {
+  name = "DuplicateTagError";
+  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 DuplicateTagError(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 DuplicateTagError(name);
+      tags.set(name, classes);
+    }
+  }
+  return tags;
+}
+export {
+  writeTypes,
+  tagsToType,
+  maybeWrite,
+  isENOENT,
+  flattenTags,
+  collect,
+  DuplicateTagError
+};
+
+//# debugId=ADE632508CD5BB0264756E2164756E21

package/dist/build.js.map

@@ -0,0 +1,13 @@
+{
+  "version": 3,
+  "sources": ["../src/build.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, PluginConfig, 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 DuplicateTagError extends Error {\n\tname = 'DuplicateTagError'\n\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 DuplicateTagError(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 DuplicateTagError(name)\n\t\t\ttags.set(name, classes)\n\t\t}\n\t}\n\n\treturn tags\n}\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": "ADE632508CD5BB0264756E2164756E21",
+  "names": []
+}

package/dist/index.d.ts

@@ -1,40 +1,7 @@
-import type { BuildContext, Cxx, PluginConfig, Tags } from './types.js';
+import type { Cxx } from './types.js';
+export type { Cxx, Result, Tag } 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);
-}
-/**
- * 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
+ * Build-time template tag placeholder used by the transform to emit CSS, classes and href values.
  */
 export declare const cxx: Cxx;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAU,MAAM,YAAY,CAAA;AAE7C,YAAY,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,YAAY,CAAA;AAElD;;GAEG;AACH,eAAO,MAAM,GAAG,EAAE,GAQhB,CAAA"}

package/dist/index.js

@@ -1,179 +1,4 @@
 // src/index.ts
-import { createHash } from "node:crypto";
-import fs from "node:fs/promises";
-import path from "node:path";
-import { transform } from "lightningcss";
-
-// 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) => [
     "",
@@ -182,14 +7,7 @@ var cxx = Object.assign((_) => ["", {}, ""], {
   ]
 });
 export {
-  writeTypes,
-  tagsToType,
-  maybeWrite,
-  isENOENT,
-  flattenTags,
-  cxx,
-  collect,
-  TagDuplicateError
+  cxx
 };
 
-//# debugId=D5DA13CCB4684E3C64756E2164756E21
+//# debugId=40D13C798825EC8F64756E2164756E21

package/dist/index.js.map

@@ -1,13 +1,10 @@
 {
   "version": 3,
-  "sources": ["../src/index.ts", "../src/config.ts", "../src/lru.ts", "../src/utils.ts"],
+  "sources": ["../src/index.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",
-    "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"
+    "import type { Cxx, Result } from './types.js'\n\nexport type { Cxx, Result, Tag } from './types.js'\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"
   ],
-  "mappings": "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",
-  "debugId": "D5DA13CCB4684E3C64756E2164756E21",
+  "mappings": ";AAOO,IAAM,MAAW,OAAO,OAAO,CAAC,MAAoC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG;AAAA,EACxF,KACC,CAAoC,MACpC,CAAC,aAAsD;AAAA,IACtD;AAAA,IACA,CAAC;AAAA,IACD;AAAA,EACD;AACF,CAAC;",
+  "debugId": "40D13C798825EC8F64756E2164756E21",
   "names": []
 }

package/dist/logger.d.ts

@@ -7,7 +7,7 @@ declare const LEVELS: {
 };
 export type LogLevel = keyof typeof LEVELS;
 /**
- * Log messages with different severity levels
+ * Log messages with different severity levels.
  */
 export declare class Logger {
     #private;
@@ -16,37 +16,37 @@ export declare class Logger {
     static set defaultLevel(level: LogLevel);
     static get defaultLevel(): LogLevel;
     /**
-     * Convert a value to an Error instance
+     * Convert a value to an Error instance.
      */
     static toError(err: unknown): Error;
     /**
-     * Stringify the error for logging
+     * 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 a message with a specific level.
      */
     log(level: LogLevel, message: string, error?: Error): void;
     /**
-     * Log a debug message
+     * Log a debug message.
      */
     debug(...messages: string[]): void;
     /**
-     * Log an info message
+     * Log an info message.
      */
     info(...messages: string[]): void;
     /**
-     * Log a warning message
+     * Log a warning message.
      */
     warn(...messages: string[]): void;
     /**
-     * Log an error message
+     * Log an error message.
      */
     error(message: string, error?: unknown): void;
     /**
-     * Log a fatal error message
+     * Log a fatal error message.
      */
     fatal(message: string, error?: unknown): void;
 }

package/dist/lru.d.ts

@@ -5,14 +5,14 @@ export declare class LruCache<T> {
     get size(): number;
     /**
      * Retrieve a cached value and promote it to most-recently-used so it won't
-     * be evicted while still actively referenced
+     * 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
+     * entry (front) before inserting.
      */
     set(key: string, value: T): void;
     delete(key: string): boolean;