@human-synthesis/norns 0.0.1

package/LICENSE

@@ -0,0 +1,27 @@
+MIT License
+
+Copyright (c) 2026 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
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+This package is part of the Norns framework, which builds on SvelteKit
+(https://github.com/sveltejs/kit) and Svelte (https://github.com/sveltejs/svelte),
+Copyright (c) Svelte Contributors, MIT licensed.

package/README.md

@@ -0,0 +1,69 @@
+# @human-synthesis/norns
+
+SvelteKit with CoffeeScript, Pug, and UnoCSS preconfigured.
+
+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.).
+
+## Install
+
+```sh
+pnpm add -D @human-synthesis/norns @sveltejs/kit svelte unocss vite
+```
+
+## Usage
+
+`svelte.config.js`:
+
+```js
+import { nornsConfig } from '@human-synthesis/norns/config';
+
+export default nornsConfig({
+  // your overrides here, e.g.:
+  // kit: { adapter: adapterNode() }
+});
+```
+
+`vite.config.js`:
+
+```js
+import { defineConfig } from 'vite';
+import { sveltekit } from '@sveltejs/kit/vite';
+import { nornsCoffeePlugin, nornsUno } from '@human-synthesis/norns';
+
+export default defineConfig({
+  plugins: [nornsCoffeePlugin(), nornsUno(), 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`:
+
+```coffee
+export load = ->
+  name: 'Norns'
+```
+
+## License & attribution
+
+MIT © Human Synthesis. Built on top of [SvelteKit](https://github.com/sveltejs/kit) and [Svelte](https://github.com/sveltejs/svelte) © Svelte Contributors, MIT licensed.

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@human-synthesis/norns",
+  "version": "0.0.1",
+  "description": "Norns — SvelteKit with CoffeeScript, Pug, and UnoCSS preconfigured",
+  "license": "MIT",
+  "author": "Human Synthesis",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/human-synthesis/norns.git"
+  },
+  "files": [
+    "src",
+    "README.md"
+  ],
+  "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.1",
+    "coffeescript": "^2.7.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/config.js

@@ -0,0 +1,23 @@
+import { nornsPreprocess } from '@human-synthesis/norns-core/preprocess';
+
+/**
+ * Build a SvelteKit config preconfigured for Norns: Coffee/Pug preprocessing
+ * and `.coffee` recognized as a SvelteKit module extension (so files like
+ * `+page.coffee` and `hooks.server.coffee` work).
+ *
+ * Spread your own overrides at the call site to extend or replace defaults.
+ *
+ * @param {import('@sveltejs/kit').Config} [overrides]
+ * @returns {import('@sveltejs/kit').Config}
+ */
+export function nornsConfig(overrides = {}) {
+	const { kit: kitOverrides = {}, preprocess: preprocessOverride, ...rest } = overrides;
+	return {
+		preprocess: preprocessOverride ?? nornsPreprocess(),
+		kit: {
+			moduleExtensions: ['.js', '.ts', '.coffee'],
+			...kitOverrides
+		},
+		...rest
+	};
+}

package/src/index.js

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

package/src/preprocess.js

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

package/src/uno.js

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

package/src/vite.js

@@ -0,0 +1,29 @@
+import { readFile } from 'node:fs/promises';
+import CoffeeScript from 'coffeescript';
+
+/**
+ * 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.
+ *
+ * @returns {import('vite').Plugin}
+ */
+export function nornsCoffeePlugin() {
+	return {
+		name: 'norns:coffee',
+		enforce: 'pre',
+		async load(id) {
+			const [path] = id.split('?');
+			if (!path.endsWith('.coffee')) return null;
+			const source = await readFile(path, 'utf8');
+			const { js, sourceMap } = CoffeeScript.compile(source, {
+				bare: true,
+				sourceMap: true,
+				inlineMap: false,
+				filename: path
+			});
+			return { code: js, map: sourceMap?.generate?.() ?? null };
+		}
+	};
+}