WIP: Next

.gitignore

@@ -2,3 +2,4 @@
 /node_modules
 /.vscode
 dist
+public

CHANGELOG.md

@@ -2,6 +2,288 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+## [0.8.0-next.30](https://github.com/sossejs/sosse/compare/v0.8.0-next.29...v0.8.0-next.30) (2021-03-08)
+
+
+### Features
+
+* minor update dependencies ([ab9cb41](https://github.com/sossejs/sosse/commit/ab9cb41010d83d52571a8914100a420f6072c346))
+
+
+### Bug Fixes
+
+* enable preserveSymlinks in rollup ([f4d1926](https://github.com/sossejs/sosse/commit/f4d192602f096647c1aae3a227964cc16a047a97))
+
+## [0.8.0-next.29](https://github.com/sossejs/sosse/compare/v0.8.0-next.28...v0.8.0-next.29) (2021-02-10)
+
+
+### Bug Fixes
+
+* **core:** wait for imagemin promise during parent resolveId ([434f38a](https://github.com/sossejs/sosse/commit/434f38a5f7e39fa3e7171c5138d6bcac044e869d))
+
+## [0.8.0-next.28](https://github.com/sossejs/sosse/compare/v0.8.0-next.27...v0.8.0-next.28) (2021-02-10)
+
+
+### Features
+
+* **core:** implement jpg, png image optimization ([61aa7c1](https://github.com/sossejs/sosse/commit/61aa7c12e93e5250626abe149ffa6247bdcea142))
+* **iso:** add ssrContainer prop to interactive components ([72f6879](https://github.com/sossejs/sosse/commit/72f687936b2031360e9ceeb85cfd4ca647364e39))
+
+## [0.8.0-next.27](https://github.com/sossejs/sosse/compare/v0.8.0-next.26...v0.8.0-next.27) (2021-02-07)
+
+
+### Features
+
+* encode interactive comp props with base64 ([29b36d3](https://github.com/sossejs/sosse/commit/29b36d37857e3cc013148b1d4c9ba9f669eecc7f))
+
+## [0.8.0-next.26](https://github.com/sossejs/sosse/compare/v0.8.0-next.25...v0.8.0-next.26) (2021-01-16)
+
+
+### Bug Fixes
+
+* process submodules and nested imports from bundledDependencies ([6ecbf0d](https://github.com/sossejs/sosse/commit/6ecbf0d766b80fddf0533e711676010efc25031b))
+
+## [0.8.0-next.25](https://github.com/sossejs/sosse/compare/v0.8.0-next.24...v0.8.0-next.25) (2021-01-16)
+
+
+### Features
+
+* process client dependencies for the server bundle ([2445257](https://github.com/sossejs/sosse/commit/2445257edc489b816821aca6a09befaa2588c67e))
+
+## [0.8.0-next.24](https://github.com/sossejs/sosse/compare/v0.8.0-next.23...v0.8.0-next.24) (2021-01-08)
+
+
+### Features
+
+* update preact to 10.5.9 and update dev dependencies ([98bd1aa](https://github.com/sossejs/sosse/commit/98bd1aa6a87b3ebde0029b78ff22d0b21bb3617f))
+
+
+### Bug Fixes
+
+* **iso:** readd own preact hydration switch, update preact-iso imports ([0fc0573](https://github.com/sossejs/sosse/commit/0fc0573fd8bf444a48f9e1e5362881ca03e34093))
+
+## [0.8.0-next.23](https://github.com/sossejs/sosse/compare/v0.8.0-next.22...v0.8.0-next.23) (2021-01-07)
+
+
+### Features
+
+* disable unused import warning for server ([6c2c779](https://github.com/sossejs/sosse/commit/6c2c779cb5cb0e395d8418a5cfceaea8ac83ba2c))
+* revive scroll position after live reload ([72db323](https://github.com/sossejs/sosse/commit/72db3231ab6cbf13e50fa3951e8a77e648b0743c))
+
+## [0.8.0-next.22](https://github.com/sossejs/sosse/compare/v0.8.0-next.21...v0.8.0-next.22) (2021-01-01)
+
+
+### Features
+
+* catch listen errors ([cfd7798](https://github.com/sossejs/sosse/commit/cfd7798f6ee5330b1a3f780ea544b66560ed2f7e))
+* implement url and svgr rollup plugins ([81bc04c](https://github.com/sossejs/sosse/commit/81bc04c303d1725e4db8319b24ee26816bee51da))
+
+## [0.8.0-next.21](https://github.com/sossejs/sosse/compare/v0.8.0-next.20...v0.8.0-next.21) (2020-12-30)
+
+
+### Features
+
+* add lang, className, viewport and description props to Html ([2f78526](https://github.com/sossejs/sosse/commit/2f78526ba6f71bf13082dccd9d4f6f5f639210d3))
+
+## [0.8.0-next.20](https://github.com/sossejs/sosse/compare/v0.8.0-next.19...v0.8.0-next.20) (2020-12-30)
+
+
+### Features
+
+* add isDev to postcss ctx ([88ae6d9](https://github.com/sossejs/sosse/commit/88ae6d98cfafc1ad00233f7511ec51d6bb8d08ae))
+
+## [0.8.0-next.19](https://github.com/sossejs/sosse/compare/v0.8.0-next.18...v0.8.0-next.19) (2020-12-30)
+
+
+### Features
+
+* implement css minification ([f890e19](https://github.com/sossejs/sosse/commit/f890e19cc7cf9919b3e39bf85b8724f2d9e040ab))
+
+## [0.8.0-next.18](https://github.com/sossejs/sosse/compare/v0.8.0-next.17...v0.8.0-next.18) (2020-12-30)
+
+
+### ⚠ BREAKING CHANGES
+
+* rework isDev env and add cli -p option
+
+### Features
+
+* rework isDev env and add cli -p option ([0ab0ac2](https://github.com/sossejs/sosse/commit/0ab0ac28344784e9651d2291dca75e0f5d513db8))
+
+
+### Bug Fixes
+
+* always use hydrate from preact-iso for client rendering ([fb58ae5](https://github.com/sossejs/sosse/commit/fb58ae55b0e418f9730923b870fe5226a0ccbd19))
+* use terser for production client builds ([1dcd1ea](https://github.com/sossejs/sosse/commit/1dcd1ea120f2d0f270f06736b7660385a7b21474))
+
+## [0.8.0-next.17](https://github.com/sossejs/sosse/compare/v0.8.0-next.16...v0.8.0-next.17) (2020-12-29)
+
+
+### Bug Fixes
+
+* correct production clientAssets css path ([0b1899f](https://github.com/sossejs/sosse/commit/0b1899f0422ecedc1ae088aae9909801207a6bea))
+
+## [0.8.0-next.16](https://github.com/sossejs/sosse/compare/v0.8.0-next.15...v0.8.0-next.16) (2020-12-29)
+
+
+### ⚠ BREAKING CHANGES
+
+* add SOSSE rollup build globals
+* rework html and render functions
+
+### Features
+
+* add SOSSE rollup build globals ([a7a57ef](https://github.com/sossejs/sosse/commit/a7a57ef0de7cd582c7a2422910dc647c51d3be7c))
+* implement source-map-support ([0f2f509](https://github.com/sossejs/sosse/commit/0f2f50983052639f7ec83861b4c6d694913b52af))
+* rework html and render functions ([36df444](https://github.com/sossejs/sosse/commit/36df44421a2514f2b55e33a146c739a5738ff5ca))
+
+
+### Bug Fixes
+
+* move preact-iso isodata into body ([7e13678](https://github.com/sossejs/sosse/commit/7e13678f58215973de1031f1e7f5497a44081780))
+
+## [0.8.0-next.15](https://github.com/sossejs/sosse/compare/v0.8.0-next.14...v0.8.0-next.15) (2020-12-25)
+
+
+### Bug Fixes
+
+* ignore subfolders in client assets ([7d2f6d2](https://github.com/sossejs/sosse/commit/7d2f6d235225d6323ab0d6f3352829d5ecbe2170))
+
+## [0.8.0-next.14](https://github.com/sossejs/sosse/compare/v0.8.0-next.13...v0.8.0-next.14) (2020-12-25)
+
+
+### Features
+
+* add fastify decorate and serverFactory ([bd0619e](https://github.com/sossejs/sosse/commit/bd0619e43d6e8cbd5383b10b5e918a2783170fb9))
+
+## [0.8.0-next.13](https://github.com/sossejs/sosse/compare/v0.8.0-next.12...v0.8.0-next.13) (2020-12-24)
+
+
+### Bug Fixes
+
+* move not bundleable dependencies out of dev ([a0e36c3](https://github.com/sossejs/sosse/commit/a0e36c30a53d9d344a43b7dddb56e165d83f5dc3))
+
+## [0.8.0-next.12](https://github.com/sossejs/sosse/compare/v0.8.0-next.11...v0.8.0-next.12) (2020-12-24)
+
+
+### Bug Fixes
+
+* upgrade to current microbundle and fix types dist ([30286f3](https://github.com/sossejs/sosse/commit/30286f3c53ccceb412531fa6a069313b7bd7ac61))
+
+## [0.8.0-next.11](https://github.com/sossejs/sosse/compare/v0.8.0-next.10...v0.8.0-next.11) (2020-12-24)
+
+
+### ⚠ BREAKING CHANGES
+
+* rework preact components and ssr with preact-iso
+* rename uni module to iso
+
+### Features
+
+* rework ctx html functions ([5c4695b](https://github.com/sossejs/sosse/commit/5c4695b1996030a9822a2b097c9c53b80c611cd9))
+* rework preact components and ssr with preact-iso ([cc1d948](https://github.com/sossejs/sosse/commit/cc1d948ff45486fbbc02588168889d43d5492344))
+
+
+* rename uni module to iso ([e778555](https://github.com/sossejs/sosse/commit/e778555a9f2f1da94b6483a654959a14fa579e05))
+
+## [0.8.0-next.10](https://github.com/sossejs/sosse/compare/v0.8.0-next.9...v0.8.0-next.10) (2020-12-16)
+
+## [0.8.0-next.9](https://github.com/sossejs/sosse/compare/v0.8.0-next.8...v0.8.0-next.9) (2020-12-13)
+
+
+### Features
+
+* update sosse init template ([a8d1554](https://github.com/sossejs/sosse/commit/a8d15547b5ceb3812b9654b6986c541cf3290599))
+
+
+### Bug Fixes
+
+* dont clear node_modules from require cache ([c9297d0](https://github.com/sossejs/sosse/commit/c9297d099262a2e5df25fb62786cc14f0185a867))
+
+## [0.8.0-next.8](https://github.com/sossejs/sosse/compare/v0.8.0-next.7...v0.8.0-next.8) (2020-12-13)
+
+
+### Bug Fixes
+
+* improve ctx event listeners memory usage ([b7488b8](https://github.com/sossejs/sosse/commit/b7488b8d4bf9822d32a12a4409d361a11b571815))
+* only cache clear modules from the project folder ([5519d9a](https://github.com/sossejs/sosse/commit/5519d9a0210812e5628ad839a98880238b0b6208))
+
+## [0.8.0-next.7](https://github.com/sossejs/sosse/compare/v0.8.0-next.6...v0.8.0-next.7) (2020-09-16)
+
+
+### Features
+
+* export Ctx for consumption ([3b3cb6f](https://github.com/sossejs/sosse/commit/3b3cb6ff5424d53c0b09f5cd71328b49a998b93e))
+
+## [0.8.0-next.6](https://github.com/sossejs/sosse/compare/v0.8.0-next.5...v0.8.0-next.6) (2020-09-16)
+
+
+### ⚠ BREAKING CHANGES
+
+* move context depended functions to context
+
+### Features
+
+* **html:** add data param and remove side effect based data ([b564757](https://github.com/sossejs/sosse/commit/b56475798206b57e247f6108172fb61d9ff86f81))
+* move context depended functions to context ([df8ae5c](https://github.com/sossejs/sosse/commit/df8ae5c73418d6322bc8b25ff80ca9c625e26e15))
+
+## [0.8.0-next.5](https://github.com/sossejs/sosse/compare/v0.8.0-next.4...v0.8.0-next.5) (2020-08-18)
+
+## [0.8.0-next.4](https://github.com/sossejs/sosse/compare/v0.8.0-next.3...v0.8.0-next.4) (2020-08-18)
+
+
+### ⚠ BREAKING CHANGES
+
+* only replace NODE_ENV in client bundles
+* remove sosseDev ref from ctx assets
+* split assets into js and css
+
+### Features
+
+* split assets into js and css ([3e73b38](https://github.com/sossejs/sosse/commit/3e73b3880bd3d9de771f209974e703f6a904be09))
+* try to build the server in production when main is missing ([09d12c9](https://github.com/sossejs/sosse/commit/09d12c93c13bce928d6bfaf39b8dfa970be79219))
+
+
+### Bug Fixes
+
+* dont bundle client if assets already exist ([338ea4a](https://github.com/sossejs/sosse/commit/338ea4a14c4d57d623073b762b08c0f919271267))
+
+
+* only replace NODE_ENV in client bundles ([d754f13](https://github.com/sossejs/sosse/commit/d754f130647f2e72c97bad0a9645ab7c2465edf8))
+* remove sosseDev ref from ctx assets ([3738e09](https://github.com/sossejs/sosse/commit/3738e090dd4ea843d05915d8ca62cab6bd975b89))
+
+## [0.8.0-next.3](https://github.com/sossejs/sosse/compare/v0.8.0-next.2...v0.8.0-next.3) (2020-08-09)
+
+
+### ⚠ BREAKING CHANGES
+
+* remove html attribute from asset, but add path and props
+
+### Features
+
+* export Asset type ([277fe97](https://github.com/sossejs/sosse/commit/277fe970648a6830103458ce6869f3f6d6438592))
+* remove html attribute from asset, but add path and props ([d74a895](https://github.com/sossejs/sosse/commit/d74a8956fb789ac457e4aa6a007810dadf86f1d1))
+
+## [0.8.0-next.2](https://github.com/sossejs/sosse/compare/v0.8.0-next.1...v0.8.0-next.2) (2020-08-05)
+
+
+### Bug Fixes
+
+* **create-type-proxies:** resolve module dts path with moduleName ([5c95a05](https://github.com/sossejs/sosse/commit/5c95a05f794086f774585b70e5db78e0671a67a6))
+
+## [0.8.0-next.1](https://github.com/sossejs/sosse/compare/v0.8.0-next.0...v0.8.0-next.1) (2020-08-05)
+
+## [0.8.0-next.0](https://github.com/sossejs/sosse/compare/v0.7.2...v0.8.0-next.0) (2020-08-03)
+
+
+### ⚠ BREAKING CHANGES
+
+* implement sosse api and cli, rework hsr api
+
+### Features
+
+* implement sosse api and cli, rework hsr api ([d295db4](https://github.com/sossejs/sosse/commit/d295db472f533f9fd74bcc3e14b586d6efffaba0))
+
 ### [0.7.2](https://github.com/sossejs/sosse/compare/v0.7.1...v0.7.2) (2020-07-25)
 
 ### [0.7.1](https://github.com/sossejs/sosse/compare/v0.7.0...v0.7.1) (2020-07-18)

README.md

@@ -1,20 +1,59 @@
 # [🥣 Sosse](https://github.com/sossejs/sosse)
 
+Composable toolkit for full-stack node web servers with Preact:
+
+- 🔥 Hot server restart
+- 🔄 Live reload
+- 🖨 Output server errors in browser
+- ⚛️ Interactive Preact components
+- 🌊 CSS server side rendering with [Otion](https://github.com/kripod/otion)
+- 📦 Bundling JS with [Rollup](https://github.com/rollup/rollup)
+
+## 🤓 [Getting started](https://github.com/sossejs/sosse/blob/next/docs/getting_started.md)
+
 [![](assets/badge.license.svg)](https://opensource.org/licenses/MIT)
 [![](assets/badge.npm.svg)](https://www.npmjs.com/package/sosse)
 [![](assets/badge.style.svg)](https://prettier.io/)
 
 ---
 
-Spice your servers up with a lil Sosse
+## TLDR
 
-Usage examples can be found in the [Getting started](https://github.com/sossejs/sosse/blob/master/docs/getting_started.md) section.
+- At its core Sosse is a wrapper around node's native http server which can be replaced one-to-one
+- This wrapper is used as a base to incrementally integrate Devtooling like "Live reload" and server features like "Server side rendering"
 
-## Features:
+## Architecture
 
-- 🔥 Hot server restart
-- 🔄 Live reload
-- 🖨 Outputs server errors in browser
-- ⚛️ Interactive (p)react components
-- 🌊 Css Serverside Rendering with [Otion](https://github.com/kripod/otion)
-- 📦 Bundling client assets with [Microbundle](https://github.com/developit/microbundle)
+- Explicitly **not** a single page application framework
+- Routing:
+  - Implemented on the server
+  - [Express](https://github.com/expressjs/expressjs.com), [Fastify](https://github.com/fastify/fastify) and others can be used as server routing solution
+    - Sosse does not predetermine a specific routing library, nor does it require one
+- Rendering HTML:
+  - [Preact](https://github.com/preactjs/preact) is used as the view layer
+  - Static components are directly rendered on the server
+  - Dynamic components are rendered on the client
+    - Static parts from dynamic components can be prerendered on the server
+- Rendering CSS:
+  - The recommended CSS in JS solution is [Otion](https://github.com/kripod/otion)
+  - CSS files and modules are supported for client side rendering and are processed with [PostCSS](https://github.com/postcss/postcss)
+- JS Bundling / Transpilation:
+  - Done for the client & server
+  - Convention over configuration
+  - Sosse handles the bundling (with Rollup)
+  - Stay away from Sosse if you have very specific requirements about how to bundle your JS
+
+## Main use case
+
+Small - middle sized, but quickly growing and changing web projects with a strong focus on a composable UI, are the main target for Sosse.
+
+Setting up a component driven web site has generally a high abstraction cost. As an example I want to mention [Next.js](https://github.com/vercel/next.js), a really powerful full-stack react framework. This power comes at a price: In the best case you only have to implement a couple things like routes and redirects in the "Next.js"-way, and in the worst case it will hit you in the business logic and you have to accept unexpected trade-offs.
+
+Sosse tries to avoid typical framework-like trade-offs by limitting its feature-set, architectural style and defining clear boundaries.
+
+# Ideas for the future
+
+- CSS server side rendering support
+  - Currently css files can be imported on both client and server, but importing them on the server does not do anything to the client
+  - Proper ssr support would mean that only the needed css styles would be rendered in the document, we would need to implement something similar as described here: https://github.com/egoist/rollup-plugin-postcss/issues/177
+  - An alternative would be to attach a full bundled css file, but that fails with this issue: https://github.com/rollup/rollup/issues/3669