@human-synthesis/norns 0.0.5 → 0.0.6

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Human Synthesis
+Copyright (c) 2026 Daniel Teodoroiu / Human Synthesis
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,16 +1,28 @@
-# @human-synthesis/norns
+# Norns
 
-SvelteKit with CoffeeScript, Pug, and UnoCSS preconfigured.
+**AI-driven software architecture and development framework, based on Svelte.**
 
-Builds on top of [`@human-synthesis/norns-core`](https://github.com/human-synthesis/norns-core) and adds first-class support for `.coffee` SvelteKit special files (`+page.coffee`, `+page.server.coffee`, `hooks.server.coffee`, `+server.coffee`, etc.).
+SvelteKit with Pug, CoffeeScript, and `.n` / `.c` files — preconfigured.
+
+## Stack
+
+- [Svelte 5](https://svelte.dev) — components and runes
+- [SvelteKit 2](https://kit.svelte.dev) — file-system routing, SSR, endpoints
+- [Pug](https://pugjs.org) — templates
+- [CoffeeScript 2](https://coffeescript.org) — script
+- [Tailwind CSS v4](https://tailwindcss.com) — recommended styling
+- [Vite](https://vitejs.dev) — bundler
+- [bun](https://bun.sh) — runtime / package manager
 
 ## Install
 
 ```sh
-pnpm add -D @human-synthesis/norns @sveltejs/kit svelte unocss vite
+bun add -D @human-synthesis/norns @sveltejs/kit svelte
 ```
 
-## Usage
+Or use the [`norns-app`](https://github.com/human-synthesis/norns-app) starter, which has everything wired up.
+
+## Setup
 
 `svelte.config.js`:
 
@@ -18,8 +30,7 @@ pnpm add -D @human-synthesis/norns @sveltejs/kit svelte unocss vite
 import { nornsConfig } from '@human-synthesis/norns/config';
 
 export default nornsConfig({
-  // your overrides here, e.g.:
-  // kit: { adapter: adapterNode() }
+  // your overrides here
 });
 ```
 
@@ -28,42 +39,25 @@ export default nornsConfig({
 ```js
 import { defineConfig } from 'vite';
 import { sveltekit } from '@sveltejs/kit/vite';
-import { nornsCoffeePlugin, nornsUno } from '@human-synthesis/norns';
+import { nornsCoffeePlugin } from '@human-synthesis/norns/vite';
 
 export default defineConfig({
-  plugins: [nornsCoffeePlugin(), nornsUno(), sveltekit()]
+  plugins: [nornsCoffeePlugin(), sveltekit()]
 });
 ```
 
-## What this gives you
-
-- **`.svelte` files** with `<script lang="coffee">`, `<template lang="pug">`, and UnoCSS class attributes
-- **`.coffee` Kit modules** — write `+page.coffee`, `+page.server.coffee`, `+layout.coffee`, `+server.coffee`, `hooks.server.coffee` instead of `.js`/`.ts`
-- **UnoCSS** preset stack (Uno, Attributify, Icons, Typography) wired into Vite
-
-## Example route
-
-`src/routes/+page.svelte`:
-
-```svelte
-<template lang="pug">
-  h1.text-3xl.font-bold Hello {data.name}
-  button(on:click="{() => count++}") count is {count}
-</template>
-
-<script lang="coffee">
-  export let data
-  count = 0
-</script>
-```
-
-`src/routes/+page.server.coffee`:
+`package.json`:
 
-```coffee
-export load = ->
-  name: 'Norns'
+```json
+{
+  "scripts": {
+    "dev": "norns dev",
+    "build": "norns build",
+    "preview": "norns preview"
+  }
+}
 ```
 
-## License & attribution
+## License
 
-MIT © Human Synthesis. Built on top of [SvelteKit](https://github.com/sveltejs/kit) and [Svelte](https://github.com/sveltejs/svelte) © Svelte Contributors, MIT licensed.
+MIT © Daniel Teodoroiu / [Human Synthesis](https://humansynthesis.ai). Built on top of [SvelteKit](https://github.com/sveltejs/kit) and [Svelte](https://github.com/sveltejs/svelte) © Svelte Contributors, MIT licensed.

package/bin/norns.js

@@ -0,0 +1,137 @@
+#!/usr/bin/env node
+import { spawn } from 'node:child_process';
+import { watch, realpathSync, readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { createRequire } from 'node:module';
+
+const FRAMEWORK_PKGS = ['@human-synthesis/norns-core', '@human-synthesis/norns'];
+
+function resolveWorkspaceFrameworkSrcs(root) {
+	const require = createRequire(join(root, 'package.json'));
+	const out = [];
+	for (const pkg of FRAMEWORK_PKGS) {
+		try {
+			const real = realpathSync(require.resolve(`${pkg}/package.json`));
+			const pkgDir = dirname(real);
+			if (!pkgDir.includes(`${join('/', 'node_modules', '/')}`)) {
+				out.push(join(pkgDir, 'src'));
+			}
+		} catch {}
+	}
+	return out;
+}
+
+function findViteBin(root) {
+	const require = createRequire(join(root, 'package.json'));
+	const pkgPath = require.resolve('vite/package.json');
+	const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+	const binEntry = typeof pkg.bin === 'string' ? pkg.bin : pkg.bin?.vite;
+	if (!binEntry) throw new Error('vite package has no bin entry');
+	return join(dirname(pkgPath), binEntry);
+}
+
+function devCommand(passthrough) {
+	const cwd = process.cwd();
+	const viteBin = findViteBin(cwd);
+	const watchSrcs = resolveWorkspaceFrameworkSrcs(cwd);
+
+	let child = null;
+	let restarting = false;
+	let pendingRestart = false;
+
+	function spawnVite() {
+		child = spawn(process.execPath, [viteBin, 'dev', ...passthrough], {
+			cwd,
+			stdio: 'inherit',
+			env: process.env
+		});
+		child.on('exit', (code, signal) => {
+			child = null;
+			if (restarting) {
+				restarting = false;
+				if (pendingRestart) {
+					pendingRestart = false;
+				}
+				spawnVite();
+				return;
+			}
+			process.exit(code ?? (signal ? 1 : 0));
+		});
+	}
+
+	function restart(reason) {
+		if (restarting) {
+			pendingRestart = true;
+			return;
+		}
+		restarting = true;
+		console.log(`\n[norns] ${reason} — respawning vite dev for fresh module cache.\n`);
+		if (child && child.exitCode === null) child.kill('SIGTERM');
+		else spawnVite();
+	}
+
+	let debounce = null;
+	function onChange(file) {
+		clearTimeout(debounce);
+		debounce = setTimeout(() => {
+			restart(`framework source changed (${file})`);
+		}, 100);
+	}
+
+	for (const src of watchSrcs) {
+		try {
+			watch(src, { recursive: true }, (_event, filename) => {
+				if (!filename) return;
+				onChange(join(src, filename));
+			});
+			console.log(`[norns] watching framework src: ${src}`);
+		} catch (err) {
+			console.warn(`[norns] could not watch ${src}: ${err.message}`);
+		}
+	}
+
+	for (const sig of ['SIGINT', 'SIGTERM']) {
+		process.on(sig, () => {
+			if (child && child.exitCode === null) child.kill(sig);
+			else process.exit(0);
+		});
+	}
+
+	spawnVite();
+}
+
+function passthroughCommand(name, passthrough) {
+	const cwd = process.cwd();
+	const viteBin = findViteBin(cwd);
+	const child = spawn(process.execPath, [viteBin, name, ...passthrough], {
+		cwd,
+		stdio: 'inherit',
+		env: process.env
+	});
+	child.on('exit', (code, signal) => process.exit(code ?? (signal ? 1 : 0)));
+}
+
+const [, , cmd = 'dev', ...rest] = process.argv;
+
+switch (cmd) {
+	case 'dev':
+		devCommand(rest);
+		break;
+	case 'build':
+	case 'preview':
+		passthroughCommand(cmd, rest);
+		break;
+	case '-h':
+	case '--help':
+		console.log(`norns <command>
+
+Commands:
+  dev       start vite dev with framework-source watching (default)
+  build     run vite build
+  preview   run vite preview
+`);
+		break;
+	default:
+		console.error(`norns: unknown command "${cmd}"`);
+		process.exit(1);
+}

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@human-synthesis/norns",
-  "version": "0.0.5",
-  "description": "Norns — SvelteKit with CoffeeScript, Pug, and UnoCSS preconfigured",
+  "version": "0.0.6",
+  "description": "Norns — SvelteKit with CoffeeScript, Pug, and the .n / .c file extensions",
   "license": "MIT",
-  "author": "Human Synthesis",
+  "author": "Daniel Teodoroiu (https://humansynthesis.ai)",
   "type": "module",
   "repository": {
     "type": "git",
@@ -11,24 +11,26 @@
   },
   "files": [
     "src",
+    "bin",
     "README.md"
   ],
+  "bin": {
+    "norns": "./bin/norns.js"
+  },
   "exports": {
     ".": "./src/index.js",
     "./config": "./src/config.js",
     "./vite": "./src/vite.js",
     "./preprocess": "./src/preprocess.js",
-    "./uno": "./src/uno.js",
     "./package.json": "./package.json"
   },
   "peerDependencies": {
     "@sveltejs/kit": "^2.0.0",
     "svelte": "^5.0.0",
-    "unocss": "^0.65.0",
     "vite": "^5.0.0 || ^6.0.0"
   },
   "dependencies": {
-    "@human-synthesis/norns-core": "^0.0.5",
+    "@human-synthesis/norns-core": "^0.0.6",
     "coffeescript": "^2.7.0"
   },
   "engines": {

package/src/config.js

@@ -1,10 +1,12 @@
 import { nornsPreprocess } from '@human-synthesis/norns-core/preprocess';
 
 /**
- * Build a SvelteKit config preconfigured for Norns: Coffee/Pug preprocessing,
- * the `.norn` component file extension, and `.coffee` recognized as a
- * SvelteKit module extension (so files like `+page.coffee` and
- * `hooks.server.coffee` work).
+ * Build a SvelteKit config preconfigured for Norns.
+ *
+ * Defaults:
+ * - `extensions: ['.svelte', '.n']`         — both vanilla and Norns components
+ * - `kit.moduleExtensions: ['.js', '.ts', '.c']` — Kit special files (`+page.c` etc.)
+ * - `preprocess: nornsPreprocess()`         — Coffee + Pug + rune fusion + auto-close
  *
  * Spread your own overrides at the call site to extend or replace defaults.
  *
@@ -19,10 +21,10 @@ export function nornsConfig(overrides = {}) {
 		...rest
 	} = overrides;
 	return {
-		extensions: extensionsOverride ?? ['.svelte', '.norn'],
+		extensions: extensionsOverride ?? ['.svelte', '.n'],
 		preprocess: preprocessOverride ?? nornsPreprocess(),
 		kit: {
-			moduleExtensions: ['.js', '.ts', '.coffee'],
+			moduleExtensions: ['.js', '.ts', '.c'],
 			...kitOverrides
 		},
 		...rest

package/src/index.js

@@ -1,4 +1,3 @@
 export { nornsConfig } from './config.js';
 export { nornsCoffeePlugin } from './vite.js';
 export { nornsPreprocess } from './preprocess.js';
-export { nornsUno } from './uno.js';

package/src/vite.js

@@ -1,21 +1,128 @@
-import { readFile } from 'node:fs/promises';
+import { readFile, stat, realpath } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { createRequire } from 'node:module';
 import CoffeeScript from 'coffeescript';
 
+const DEFAULT_EXTENSIONS = ['.mjs', '.js', '.mts', '.ts', '.jsx', '.tsx', '.json'];
+const NORNS_EXTENSIONS = ['.svelte', '.n', '.c'];
+const RESOLVE_EXTENSIONS = [...NORNS_EXTENSIONS, '.ts', '.js'];
+const FRAMEWORK_PKGS = ['@human-synthesis/norns-core', '@human-synthesis/norns'];
+
+async function fileExists(path) {
+	try {
+		const s = await stat(path);
+		return s.isFile();
+	} catch {
+		return false;
+	}
+}
+
+/**
+ * Resolve framework package src dirs that live OUTSIDE the consuming app's
+ * node_modules (i.e. workspace symlinks pointing at sibling repos). Returns
+ * real on-disk paths to watch. Empty array when packages are installed
+ * normally — published consumers never enter this branch.
+ *
+ * @param {string} root
+ * @returns {Promise<string[]>}
+ */
+async function resolveWorkspaceFrameworkSrcs(root) {
+	const require = createRequire(join(root, 'package.json'));
+	const out = [];
+	for (const pkg of FRAMEWORK_PKGS) {
+		try {
+			const pkgJsonPath = require.resolve(`${pkg}/package.json`);
+			const real = await realpath(pkgJsonPath);
+			const pkgDir = dirname(real);
+			// Only watch when the real path resolves outside any node_modules —
+			// that's the workspace-symlink case. A normal install resolves to
+			// a real path inside node_modules and we leave it alone.
+			if (!pkgDir.includes(`${join('/', 'node_modules', '/')}`)) {
+				out.push(join(pkgDir, 'src'));
+			}
+		} catch {
+			// Package not installed (e.g. only norns-core present) — skip.
+		}
+	}
+	return out;
+}
+
 /**
- * Vite plugin that compiles .coffee files to JavaScript.
- * Used so SvelteKit special files like +page.coffee, +page.server.coffee,
- * hooks.server.coffee, and +server.coffee work the same as their .js / .ts
- * counterparts.
+ * Vite plugin that:
+ *  - compiles `.c` files (CoffeeScript) on the fly, so SvelteKit special
+ *    files like `+page.c`, `+page.server.c`, `hooks.server.c`, and
+ *    `+server.c` work the same as their `.js` / `.ts` counterparts;
+ *  - registers `.svelte`, `.n`, and `.c` with Vite's resolver so bare
+ *    imports (`import X from './Foo'`) try those extensions in priority
+ *    order, on top of Vite's defaults;
+ *  - resolves bare-name imports (`import X from 'Foo'`, no `./` prefix) to
+ *    a sibling file when one exists, in the same priority order. Real
+ *    package imports (`'svelte/store'`, `'@scope/pkg'`) are unaffected
+ *    because they contain a slash or scope marker;
+ *  - in workspace-linked dev (sibling repos symlinked into node_modules),
+ *    excludes the framework packages from `optimizeDeps` pre-bundling and
+ *    lifts them out of the default `**\/node_modules\/**` watch ignore so
+ *    Vite reads source on each request and HMR fires. No-op for normal
+ *    (published) installs. The companion `norns dev` CLI handles
+ *    process-level respawn when framework source changes — needed because
+ *    Node's ESM module cache survives `server.restart()`.
  *
  * @returns {import('vite').Plugin}
  */
 export function nornsCoffeePlugin() {
+	/** @type {string[]} */
+	let watchSrcs = [];
 	return {
 		name: 'norns:coffee',
 		enforce: 'pre',
+		async config(_userConfig, { command }) {
+			if (command === 'serve') {
+				watchSrcs = await resolveWorkspaceFrameworkSrcs(process.cwd());
+			}
+			/** @type {import('vite').UserConfig} */
+			const cfg = {
+				resolve: {
+					extensions: [...DEFAULT_EXTENSIONS, ...NORNS_EXTENSIONS]
+				},
+				optimizeDeps: {
+					exclude: [...FRAMEWORK_PKGS]
+				}
+			};
+			if (watchSrcs.length > 0) {
+				cfg.server = {
+					fs: { allow: watchSrcs.map((p) => dirname(p)) },
+					watch: {
+						ignored: [
+							'**/.git/**',
+							(path) => {
+								if (watchSrcs.some((src) => path.startsWith(src))) return false;
+								return path.includes(`${join('/', 'node_modules', '/')}`);
+							}
+						]
+					}
+				};
+			}
+			return cfg;
+		},
+		async resolveId(source, importer) {
+			if (!importer) return null;
+			// Already explicit relative or absolute — let the default resolver run.
+			if (source.startsWith('.') || source.startsWith('/')) return null;
+			// Scoped package or package-with-subpath — treat as a bare module.
+			if (source.startsWith('@') || source.includes('/')) return null;
+
+			// Single bare name — try resolving as a sibling file first, falling
+			// back to the default resolver (node_modules) if nothing matches.
+			const dir = dirname(importer);
+			for (const ext of RESOLVE_EXTENSIONS) {
+				const candidate = join(dir, source + ext);
+				if (await fileExists(candidate)) return candidate;
+			}
+			return null;
+		},
 		async load(id) {
 			const [path] = id.split('?');
-			if (!path.endsWith('.coffee')) return null;
+			if (!path.endsWith('.c')) return null;
 			const source = await readFile(path, 'utf8');
 			const { js, sourceMap } = CoffeeScript.compile(source, {
 				bare: true,

package/src/uno.js

@@ -1 +0,0 @@
-export { nornsUno } from '@human-synthesis/norns-core/uno';