@human-synthesis/norns 0.0.13 → 0.0.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@human-synthesis/norns",
-  "version": "0.0.13",
+  "version": "0.0.15",
   "description": "Norns — SvelteKit with Civet, Pug, and the .n / .civet / .c file extensions",
   "license": "MIT",
   "author": "Daniel Teodoroiu (https://humansynthesis.ai)",

package/src/vite.js

@@ -198,17 +198,21 @@ async function walkNFiles(dir, ext, out = []) {
  * @param {object} [options]
  * @param {string} [options.root]     Directory to scan (default `src`).
  * @param {string} [options.ext]      File extension (default `.n`).
- * @param {string} [options.outFile]  Sidecar path relative to root
- *                                    (default `.tailwind-pug-classes.html`).
- *                                    Reference it from your CSS with:
- *                                      @source "./.tailwind-pug-classes.html";
+ * @param {string} [options.outFile]  Sidecar path relative to the project
+ *                                    root. The path is taken verbatim. Defaults
+ *                                    to `node_modules/.cache/norns/tailwind-pug-classes.html`
+ *                                    — node_modules is gitignored everywhere
+ *                                    and `.cache/` is the conventional spot
+ *                                    for build artifacts. Reference it from
+ *                                    your CSS via `@source` with a path
+ *                                    relative to the importing CSS file.
  *
  * @returns {import('vite').Plugin}
  */
 export function pugTailwindExtract({
 	root = 'src',
 	ext = '.n',
-	outFile = '.tailwind-pug-classes.html'
+	outFile = 'node_modules/.cache/norns/tailwind-pug-classes.html'
 } = {}) {
 	let projectRoot = process.cwd();
 	const fileClasses = new Map(); // absolute path -> Set<string>
@@ -222,7 +226,10 @@ export function pugTailwindExtract({
 		const html =
 			'<!-- AUTO-GENERATED by @human-synthesis/norns/vite pugTailwindExtract. Do not edit. -->\n' +
 			`<div class="${sorted.join(' ')}"></div>\n`;
-		const out = join(projectRoot, root, outFile);
+		// `outFile` is resolved from `projectRoot` directly; it doesn't get
+		// joined with `root` (the scan dir). Lets the sidecar live anywhere —
+		// inside src/, in a cache dir like `.norns/`, wherever.
+		const out = join(projectRoot, outFile);
 		await mkdir(dirname(out), { recursive: true });
 		await writeFile(out, html, 'utf8');
 	}