@human-synthesis/norns-core 0.0.4 → 0.0.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@human-synthesis/norns-core",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "Norns core — Svelte with CoffeeScript, Pug, and UnoCSS preconfigured",
   "license": "MIT",
   "author": "Human Synthesis",
@@ -25,6 +25,7 @@
     "vite": "^5.0.0 || ^6.0.0"
   },
   "dependencies": {
+    "@unocss/extractor-pug": "^0.65.0 || ^66.0.0",
     "acorn": "^8.14.0",
     "coffeescript": "^2.7.0",
     "magic-string": "^0.30.10",

package/src/uno.js

@@ -7,17 +7,30 @@ import {
 	transformerDirectives,
 	transformerVariantGroup
 } from 'unocss';
+import extractorPug from '@unocss/extractor-pug';
+
+const NORN_PIPELINE = [
+	/\.(vue|svelte|[jt]sx|mdx?|astro|elm|php|phtml|html)($|\?)/,
+	/\.(norn|coffee)($|\?)/
+];
 
 /**
- * Norns UnoCSS Vite plugin with a sensible preset stack.
+ * Norns UnoCSS Vite plugin.
  *
- * Includes transformerDirectives (so `@apply` works in `<style>` blocks)
- * and transformerVariantGroup (so `class="hover:(text-blue underline)"`
- * shorthand works).
+ * Defaults baked in for the Norns stack:
+ * - presets: Uno + Attributify + Icons + Typography
+ * - transformers: Directives (`@apply`) + VariantGroup
+ * - extractor: extractor-pug, so Pug class shorthand inside `.svelte` and
+ *   `.norn` files is recognized
+ * - content pipeline includes `.norn` and `.coffee`
+ * - hmrTopLevelAwait: false to avoid a TDZ error in WebKit/Safari when
+ *   `virtual:uno.css` is imported from a SvelteKit route module
  *
- * Defaults `hmrTopLevelAwait: false` to avoid a TDZ
- * "Cannot access 'component' before initialization" error in WebKit/Safari
- * when importing 'virtual:uno.css' from a SvelteKit layout/page module.
+ * **Naming caveat for shortcuts:** avoid names starting with a CSS
+ * pseudo-class prefix (`hover-`, `focus-`, `link-`, `active-`, `visited-`,
+ * `disabled-`, `checked-`, etc.) — UnoCSS parses those as variant + utility,
+ * not as a shortcut name. Use `nav-link`, `lk-muted`, etc. instead of
+ * `link-muted`.
  *
  * @param {import('unocss/vite').VitePluginConfig} [options]
  */
@@ -25,6 +38,8 @@ export function nornsUno(options = {}) {
 	const {
 		presets = [],
 		transformers = [],
+		extractors = [],
+		content = {},
 		hmrTopLevelAwait = false,
 		...rest
 	} = options;
@@ -37,6 +52,14 @@ export function nornsUno(options = {}) {
 			...presets
 		],
 		transformers: [transformerDirectives(), transformerVariantGroup(), ...transformers],
+		extractors: [extractorPug(), ...extractors],
+		content: {
+			pipeline: {
+				include: NORN_PIPELINE,
+				...(content.pipeline ?? {})
+			},
+			...content
+		},
 		hmrTopLevelAwait,
 		...rest
 	});