marko 5.34.5 → 5.35.0

package/dist/runtime/helpers/tags-compat/runtime-dom.js

@@ -82,8 +82,13 @@ exports.p = function (domCompat) {
   domCompat.patchConditionals((conditional) => (...args) => {
     const signal = conditional(...args);
     const skipAttrs = args.length <= 1;
-    return (scope, renderer, clean) => {
-      return signal(scope, create5to6Renderer(renderer, skipAttrs), clean);
+    return (scope, rendererOrOp) => {
+      return signal(
+        scope,
+        domCompat.isOp(rendererOrOp) ?
+        rendererOrOp :
+        create5to6Renderer(rendererOrOp, skipAttrs)
+      );
     };
   });
 
@@ -124,8 +129,8 @@ exports.p = function (domCompat) {
               _j_(null, null, realFragment);
               return realFragment;
             },
-            (scope, input, clean) => {
-              if (clean) return;
+            (scope, input) => {
+              if (domCompat.isOp(input)) return;
               renderAndMorph(scope, rendererFromAnywhere, renderer, input);
             }
           );

package/docs/compiler.md

@@ -206,6 +206,13 @@ Default: [environment based](https://github.com/marko-js/marko/blob/0f212897d2d3
 
 Enables production mode optimizations.
 
+#### `optimizedRegistryIds`
+
+Type: `Map<string, string>`<br>
+Default: `undefined`
+
+If `optimize` is enabled you can provide a Map which the compiler will use to store shorter registry/template id's in. This can only be used if the same `optimizedRegistryIds` are used for both server and client compilations.
+
 #### `resolveVirtualDependency`
 
 Type:

package/docs/getting-started.md

@@ -1,6 +1,22 @@
 # Getting started
 
-The easiest way to get started with Marko is to use the [Try Online](https://markojs.com/try-online) feature. You can just open it in another tab and follow along. If you'd rather develop locally, check out the [Installation](./installing.md) page.
+## Setup
+
+### Marko Run (Recommended)
+
+[Marko Run](https://github.com/marko-js/run) makes it easy to get started with little to no config and is the recommended starting point for a new Marko project.
+
+To set up your project:
+
+1. `npm init marko -- -t basic`
+2. `cd ./<PROJECT_NAME>`
+3. `npm run dev`
+
+Open `src/routes/_index/+page.marko` in your editor to change the index page. See the [routing documentation](https://github.com/marko-js/run#file-based-routing) to learn how to add additional pages to your project.
+
+### Other setups
+
+If you just want to test out Marko in your browser, use the [Try Online](https://markojs.com/try-online) feature. You can open it in another tab and follow along. For other setups, check out the [Installation](./installing.md) page.
 
 ## Hello world
 

package/docs/installing.md

@@ -9,10 +9,10 @@ If you just want to play around with Marko in the browser, head on over to our [
 If you're starting from scratch, you can use Marko's [CLI](https://github.com/marko-js/cli) commands to quickly create a starter app:
 
 ```bash
-npx @marko/create
+npm init marko
 ```
 
-This will use an interactive [CLI](https://github.com/marko-js/cli) to automatically create a project for you using the pre-made starter template of your choosing. The `basic` template is the most minimal and the easiest way to get started. It uses our batteries-included `@marko/build` and `@marko/serve` tools that handle building, bundling, and serving your web application. These projects are config-free with built-in file based routing and automatic code reloading.
+This will use an interactive [CLI](https://github.com/marko-js/cli) to automatically create a project for you using the pre-made starter template of your choosing. The `basic` template is the most minimal and the easiest way to get started. It uses our recommended app framework [Marko Run](https://github.com/marko-js/run) that handles building, bundling, and serving your web application. These projects are config-free with built-in file based routing and automatic code reloading.
 
 ## Custom Bundling
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "marko",
-  "version": "5.34.5",
+  "version": "5.35.0",
   "description": "UI Components + streaming, async, high performance, HTML templating for Node.js and the browser.",
   "keywords": [
     "front-end",
@@ -64,7 +64,7 @@
     "build": "babel ./src --out-dir ./dist --extensions .js --copy-files --config-file ../../babel.config.js --env-name=production"
   },
   "dependencies": {
-    "@marko/compiler": "^5.36.2",
+    "@marko/compiler": "^5.37.0",
     "@marko/translator-default": "^6.0.1",
     "app-module-path": "^2.2.0",
     "argly": "^1.2.0",

package/src/runtime/helpers/tags-compat/runtime-dom.js

@@ -82,8 +82,13 @@ exports.p = function (domCompat) {
   domCompat.patchConditionals((conditional) => (...args) => {
     const signal = conditional(...args);
     const skipAttrs = args.length <= 1;
-    return (scope, renderer, clean) => {
-      return signal(scope, create5to6Renderer(renderer, skipAttrs), clean);
+    return (scope, rendererOrOp) => {
+      return signal(
+        scope,
+        domCompat.isOp(rendererOrOp)
+          ? rendererOrOp
+          : create5to6Renderer(rendererOrOp, skipAttrs),
+      );
     };
   });
 
@@ -124,8 +129,8 @@ exports.p = function (domCompat) {
               ___createFragmentNode(null, null, realFragment);
               return realFragment;
             },
-            (scope, input, clean) => {
-              if (clean) return;
+            (scope, input) => {
+              if (domCompat.isOp(input)) return;
               renderAndMorph(scope, rendererFromAnywhere, renderer, input);
             },
           );