feat: engine

Author: daKmoR

.eleventyignore

@@ -12,3 +12,7 @@ __output
 __output-dev
 
 docs/_merged*
+*-mdjs-generated.js
+
+/packages/engine/test-node/fixtures/06-error-handling/01-page-error/docs/index.rocket.js
+/packages/engine/test-node/fixtures/03b-format-markdown/c01-md-in-js-to-md-html/md-in-js.js

.eslintignore

@@ -1,6 +1,5 @@
 ## editors
 /.idea
-/.vscode
 
 ## system files
 .DS_Store
@@ -28,9 +27,7 @@ stats.html
 *.tsbuildinfo
 
 ## Rocket ignore files (need to be the full relative path to the folders)
-docs/_merged_data/
-docs/_merged_assets/
-docs/_merged_includes/
+*-mdjs-generated.js
 _site
 _site-dev
 
@@ -40,3 +37,4 @@ _merged_assets
 _merged_includes
 __output
 __output-dev
+docs_backup

.gitignore

@@ -1 +1 @@
-v14
+v16

.nvmrc

@@ -0,0 +1,7 @@
+{
+// See http://go.microsoft.com/fwlink/?LinkId=827846
+// for the documentation about the extensions.json format
+"recommendations": [
+"dbaeumer.vscode-eslint"
+]
+}

.vscode/extensions.json

@@ -0,0 +1,34 @@
+// A launch configuration that compiles the extension and then opens it inside a new window
+// Use IntelliSense to learn about possible attributes.
+// Hover to view descriptions of existing attributes.
+// For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+{
+"version": "0.2.0",
+"configurations": [
+{
+"name": "Run Web Dev Server Extension",
+"type": "extensionHost",
+"request": "launch",
+"args": [
+"--extensionDevelopmentPath=${workspaceFolder}/packages/vscode-rocket"
+],
+"outFiles": [
+"${workspaceFolder}/packages/vscode-rocket/out/**/*.js"
+],
+"preLaunchTask": "Compile vscode-rocket"
+},
+{
+"name": "Extension Tests",
+"type": "extensionHost",
+"request": "launch",
+"args": [
+"--extensionDevelopmentPath=${workspaceFolder}",
+"--extensionTestsPath=${workspaceFolder}/out/test/suite/index"
+],
+"outFiles": [
+"${workspaceFolder}/out/test/**/*.js"
+],
+"preLaunchTask": "${defaultBuildTask}"
+}
+]
+}

.vscode/launch.json

@@ -0,0 +1,11 @@
+{
+ "gitdoc.enabled": false,
+ "typescript.tsdk": "node_modules/typescript/lib",
+ "files.exclude": {
+ "**/*-mdjs-generated.js": false,
+ },
+ "search.exclude": {
+ "**/*-mdjs-generated.js": true,
+ "**/dist-types": true,
+ }
+}

.vscode/settings.json

@@ -0,0 +1,29 @@
+// See https://go.microsoft.com/fwlink/?LinkId=733558
+// for the documentation about the tasks.json format
+{
+"version": "2.0.0",
+"tasks": [
+ {
+ "type": "npm",
+ "script": "watch",
+ "problemMatcher": "$tsc-watch",
+ "isBackground": true,
+ "presentation": {
+ "reveal": "never"
+ },
+ "group": {
+ "kind": "build",
+ "isDefault": true
+ }
+ },
+ {
+ "label": "Compile vscode-rocket",
+ "type": "npm",
+ "script": "compile",
+ "path": "packages/vscode-rocket/",
+ "group": "build",
+ "problemMatcher": [],
+ "detail": "tsc -p ./"
+ }
+ ]
+}

.vscode/tasks.json

@@ -38,7 +38,7 @@
 
 **The modern web setup for static sites with a sprinkle of JavaScript!**
 
-- **Meta Framework:** Build on top of giants like <a href="https://www.11ty.dev/">Eleventy</a>, <a href="https://rollupjs.org/">Rollup</a>, and <a href="https://www.modern-web.dev/">Modern Web</a>.
+- **Meta Framework:** Build on top of giants like <a href="https://lit.dev/">Lit</a>, <a href="https://rollupjs.org/">Rollup</a> and <a href="https://www.modern-web.dev/">Modern Web</a>.
 - **Powerful Default Template:** Provide content and you are ready to go.
 - **Small:** No overblown tools or frontend frameworks, add JavaScript and/or Web Components only on pages where needed..
 
@@ -55,6 +55,16 @@ You can still tweak every detail of every underlying tool that gets used.
 
 Rocket is part of the [Modern Web Family](https://twitter.com/modern_web_dev).
 
+## Quick Start
+
+```
+mkdir test-rocket
+cd test-rocket
+npm init -y
+npm i @rocket/cli@alpha @rocket/launch@alpha @11ty/eleventy-cache-assets typescript
+npx rocket init
+```
+
 ## 🤝 Contributing
 
 We are always looking for contributors of all skill levels! If you're looking to ease your way into the project, try out a [good first issue](https://github.com/modernweb-dev/rocket/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22).

README.md

@@ -0,0 +1,39 @@
+## Features
+
+- ssr render can just be a string concat
+- recursive rendering of lit / html / and markdown
+ - "import" markdown with frontmatter
+- mdjs update to unified v10 AND go esm only (only cjs pkg we have now)
+
+## Nice to have
+
+- Add "menuExclude" => to actually exclude the menu item
+
+## Bugs
+
+- write to `_site-dev` instead of `_site` while using `rocket start`
+- nested `recursive.data.js` do not overwrite the parent data
+- support <!-- asdf --> in markdown
+
+## Error Handling
+
+- make error nice for parent page not found in index => auto generate page? 🤔
+
+## Examples
+
+- docs site, blog (simple), blog (complex), minimal
+- add stackblitz/codesandbox examples => does not work because of `@parcel/watcher` https://github.com/parcel-bundler/watcher/issues/99
+
+- Example: export variable and use it in rendering
+- Example: fetch data from an api and display it
+- Example: usage of image
+
+## later
+
+- support `@change` in markdown
+- support "hey ${foo.map(f => `${f} + 1`)}"
+- ENGINE: Rename "options.docsDir" to "options.inputDir"
+
+## consider
+
+- Replace magic "resolve:pkg/foo.css" with a directive `${resolve()}`?