restructure theme css

go/jsruntime/doc.go

@@ -1,6 +1,10 @@
 // Package jsruntime is the JS/TS tree of kjol: the Solid component kit, the
-// vendored Solid runtime, the FontAwesome SVG source kit, the shared Tailwind
-// @theme scaffold, and the generic TS scaffolding (auth, hooks, ssr, utils).
+// vendored Solid runtime, the FontAwesome SVG source kit, and the generic TS
+// scaffolding (auth, hooks, ssr, utils).
+//
+// The shared Tailwind design tokens are NOT here — they live in kjol/tw as the
+// extension layer (tw/kjol_theme.css), which the Tailwind engine layers between
+// its own defaults and an app's brand. See tw.CompileApp.
 //
 // It holds no Go beyond this file. The package exists so the tree has a stable
 // home inside the Go module rather than a sibling directory the build has to go
@@ -26,9 +30,6 @@
 //	          per-app registry (@appgen/faIcons); the registry is app-owned and is
 //	          not committed here. An app's own frontend/icons is searched first, so
 //	          an app with a fuller kit keeps it (see jsbundler.iconsDirs).
-//	styles/   theme.css — the @theme scaffold + :root fa vars, prepended to the
-//	          app's brand style.css by the bundler. Brand color/font tokens stay
-//	          app-side.
 //
 // The rest (auth/ hooks/ ssr/ utils/ env.ts basic.ts finance.ts superfun.ts) is
 // generic TS scaffolding; apps import it as @kjol/*. Concrete permission