refactor: move core to @mizu/render, and normalize docs

Author: lowlighter

.github/labeler.yml

@@ -11,9 +11,9 @@ meta:
           - vercel.json
 
 # Mizu core engine and end-user API
-core:
+engine:
   - changed-files:
-      - any-glob-to-any-file: "@mizu/mizu/core/**"
+      - any-glob-to-any-file: "@mizu/render/engine/**"
 api:
   - changed-files:
       - any-glob-to-any-file: "@mizu/render/**"

.github/tools/mod_html_to_readme_md.ts

@@ -1,5 +1,5 @@
 // Imports
-import { Window } from "@mizu/mizu/core/vdom"
+import { Window } from "@mizu/render/engine/vdom"
 import { dirname, join } from "@std/path"
 import { expandGlob } from "@std/fs"
 import { Logger } from "@libs/logger"
@@ -39,7 +39,7 @@ export async function htmlToMd(html: string) {
         }
         content.push(table.join("\n"))
         content.push(toMarkdown(Array.from(directive.querySelectorAll("[\\#description]"))))
-        directive.querySelectorAll("[\\#example]").forEach((example) => content.push(`\`\`\`html\n${unindent(example.innerHTML).trim()}\n\`\`\``))
+        directive.querySelectorAll("[\\#example]").forEach((example) => content.push(`\`\`\`html\n${unindent(example.innerHTML.replace(/=""/g, "")).trim()}\n\`\`\``))
 
         // Notes
         if (directive.querySelector("[\\#note]")) {

@mizu/bind/README.md

@@ -4,7 +4,7 @@
 | ------------------------------------- | ---------------- | -------- |
 | ![](https://jsr.io/badges/@mizu/bind) | 51 — `ATTRIBUTE` | Yes      |
 
-Bind an element's `[attribute](https://developer.mozilla.org/docs/Web/HTML/Attributes)` value.
+Bind an element's [`attribute`](https://developer.mozilla.org/docs/Web/HTML/Attributes) value.
 
 ```html
 <a :href="url">
@@ -20,21 +20,21 @@ Bind an element's `[attribute](https://developer.mozilla.org/docs/Web/HTML/Attri
 > [!WARNING] [`:class`](#bind-class) and [`:style`](#bind-style) have specific handling described below.
 
 > [!NOTE]
-> Multiple attributes can be bound in a single directive using the empty shorthand `:="object"` _(e.g. `:="{ foo: 'bar', bar: true }"`)_.
+> Bind multiple attributes in a single directive using the shorthand `:="object"` _(e.g. `:="{ foo: 'bar', bar: true }"`)_.
 
 > [!NOTE]
-> Any [boolean attribute defined by the HTML spec](https://html.spec.whatwg.org/#attributes-3) is handled accordingly (removed from the element when falsy).
+> Boolean attributes defined by the [HTML spec](https://html.spec.whatwg.org/#attributes-3) are handled accordingly (removed when falsy).
 
 > [!NOTE]
-> Bound attributes with `null` or `undefined` values are removed from the element.
+> Attributes with `null` or `undefined` values are removed.
 
 # `:class="value"`
 
 | Version                               | Phase            | Multiple |
 | ------------------------------------- | ---------------- | -------- |
 | ![](https://jsr.io/badges/@mizu/bind) | 51 — `ATTRIBUTE` | Yes      |
 
-Bind an element's `[class](https://developer.mozilla.org/docs/Web/HTML/Global_attributes/class)` attribute.
+Bind an element's [`class`](https://developer.mozilla.org/docs/Web/HTML/Global_attributes/class) attribute.
 
 ```html
 <p :class="{ foo: true, bar: false }">
@@ -45,14 +45,14 @@ Bind an element's `[class](https://developer.mozilla.org/docs/Web/HTML/Global_at
 ## Notes
 
 > [!NOTE]
-> Evaluated expression can be either be:
+> The expression can be:
 >
-> - A `string` of space-separated class names _(e.g. `"foo bar"`)_.
-> - A `Record<PropertyKey, boolean>` of class names mapped to their current state _(e.g. `{ foo: true, bar: false }`)_.
-> - An `Array` of any of the listed supported types _(e.g. `[ "foo", { bar: false }, [] ]`)_.
+> - A `string` of space-separated class names _(e.g., `"foo bar"`)_.
+> - A `Record<PropertyKey, boolean>` mapping class names to their state _(e.g., `{ foo: true, bar: false }`)_.
+> - An `Array` of the supported types _(e.g., `[ "foo", { bar: false }, [] ]`)_.
 
 > [!NOTE]
-> Initial `class` attribute value is preserved.
+> The initial `class` attribute value is preserved.
 
 > [!NOTE]
 > Class names with at least one [truthy value](https://developer.mozilla.org/en-US/docs/Glossary/Truthy) are treated as active.
@@ -63,7 +63,7 @@ Bind an element's `[class](https://developer.mozilla.org/docs/Web/HTML/Global_at
 | ------------------------------------- | ---------------- | -------- |
 | ![](https://jsr.io/badges/@mizu/bind) | 51 — `ATTRIBUTE` | Yes      |
 
-Bind an element's `[style](https://developer.mozilla.org/docs/Web/HTML/Global_attributes/style)` attribute.
+Bind an element's [`style`](https://developer.mozilla.org/docs/Web/HTML/Global_attributes/style) attribute.
 
 ```html
 <p :style="{ color: 'salmon' }">
@@ -74,16 +74,16 @@ Bind an element's `[style](https://developer.mozilla.org/docs/Web/HTML/Global_at
 ## Notes
 
 > [!NOTE]
-> Evaluated expression can be either be:
+> The expression can be:
 >
-> - A `string` supported by [`HTMLElement.style.cssText`](https://developer.mozilla.org/docs/Web/API/CSSStyleDeclaration/cssText) _(e.g. `"color: blue;"`)_.
-> - A `Record<PropertyKey, unknown>` of CSS properties mapped to their current value _(e.g. `{ backgroundColor: "red", "border-color": "green", width: 1 }`)_.
->   - [« camelCase »](https://developer.mozilla.org/docs/Glossary/Camel_case) may be used inplace of [« kebab-case »](https://developer.mozilla.org/docs/Glossary/Kebab_case) to avoid escaping CSS properties names.
->   - Values of type `number` are implicitely converted to `px` unit whenever applicable _( [`HTMLElement.style.setProperty()`](https://developer.mozilla.org/docs/Web/API/CSSStyleDeclaration/setProperty) will be called again with `"px"` appended)_.
-> - An `Array` of any of the listed supported types _(e.g. `[ "color: blue", { backgroundColor: "red" }, [] ]`)_.
+> - A `string` supported by [`HTMLElement.style.cssText`](https://developer.mozilla.org/docs/Web/API/CSSStyleDeclaration/cssText) _(e.g., `"color: blue;"`)_.
+> - A `Record<PropertyKey, unknown>` mapping CSS properties to their values _(e.g., `{ backgroundColor: "red", "border-color": "green", width: 1 }`)_.
+>   - Use [« camelCase »](https://developer.mozilla.org/docs/Glossary/Camel_case) instead of [« kebab-case »](https://developer.mozilla.org/docs/Glossary/Kebab_case) to avoid escaping CSS property names.
+>   - Values of type `number` are implicitly converted to `px` units when applicable _( [`HTMLElement.style.setProperty()`](https://developer.mozilla.org/docs/Web/API/CSSStyleDeclaration/setProperty) will be called with `"px"` appended)_.
+> - An `Array` of the supported types _(e.g., `[ "color: blue", { backgroundColor: "red" }, [] ]`)_.
 
 > [!NOTE]
-> Initial `style` attribute value is preserved.
+> The initial `style` attribute value is preserved.
 
 > [!NOTE]
-> Specified CSS properties values are processed in the order they are defined, regardless of whether they were marked as [`!important`](https://developer.mozilla.org/docs/Web/CSS/important).
+> CSS properties are processed in the order they are defined, regardless of [`!important`](https://developer.mozilla.org/docs/Web/CSS/important).

@mizu/bind/mod.html

@@ -1,7 +1,7 @@
 <mizu-directive id="bind" directory="bind">
   <code #name><span class="hljs-keyword">:</span><span class="hljs-meta underline-dotted">attribute</span><wbr /><span class="muted">="value"</span></code>
   <p #description>
-    Bind an element's <code><a href="https://developer.mozilla.org/docs/Web/HTML/Attributes">attribute</a></code> value.
+    Bind an element's <a href="https://developer.mozilla.org/docs/Web/HTML/Attributes"><code>attribute</code></a> value.
   </p>
   <code #example *skip>
     <a :href="url">
@@ -15,43 +15,43 @@
     <a href="#bind-class"><code class="hljs-keyword">:class</code></a> and <a href="#bind-style"><code class="hljs-keyword">:style</code></a> have specific handling described below.
   </mizu-warn>
   <mizu-note #note>
-    Multiple attributes can be bound in a single directive using the empty shorthand <code><span class="hljs-keyword">:</span><span class="muted">="object"</span></code>
-    <i>(e.g. <code>:="{ foo: 'bar', bar: true }"</code>)</i>.
+    Bind multiple attributes in a single directive using the shorthand <code><span class="hljs-keyword">:</span><span class="muted">="object"</span></code>
+    <i>(e.g. <code><span class="hljs-keyword">:</span>="{ foo: 'bar', bar: true }"</code>)</i>.
   </mizu-note>
   <mizu-note #note>
-    Any <a href="https://html.spec.whatwg.org/#attributes-3">boolean attribute defined by the HTML spec</a> is handled accordingly (removed from the element when falsy).
+    Boolean attributes defined by the <a href="https://html.spec.whatwg.org/#attributes-3">HTML spec</a> are handled accordingly (removed when falsy).
   </mizu-note>
   <mizu-note #note>
-    Bound attributes with <code>null</code> or <code>undefined</code> values are removed from the element.
+    Attributes with <code>null</code> or <code>undefined</code> values are removed.
   </mizu-note>
 </mizu-directive>
 
 <mizu-directive id="bind-class" directory="bind">
   <code #name><span class="hljs-keyword">:class</span><wbr /><span class="muted">="value"</span></code>
   <p #description>
-    Bind an element's <code><a href="https://developer.mozilla.org/docs/Web/HTML/Global_attributes/class">class</a></code> attribute.
+    Bind an element's <a href="https://developer.mozilla.org/docs/Web/HTML/Global_attributes/class"><code>class</code></a> attribute.
   </p>
   <code #example *skip>
     <p :class="{ foo: true, bar: false }">
       <!--...-->
     </p>
   </code>
   <mizu-note #note>
-    Evaluated expression can be either be:
+    The expression can be:
     <ul>
       <li>
-        A <code>string</code> of space-separated class names <i>(e.g. <code>"foo bar"</code>)</i>.
+        A <code>string</code> of space-separated class names <i>(e.g., <code>"foo bar"</code>)</i>.
       </li>
       <li>
-        A <code>Record&lt;PropertyKey, boolean&gt;</code> of class names mapped to their current state <i>(e.g. <code>{ foo: true, bar: false }</code>)</i>.
+        A <code>Record&lt;PropertyKey, boolean&gt;</code> mapping class names to their state <i>(e.g., <code>{ foo: true, bar: false }</code>)</i>.
       </li>
       <li>
-        An <code>Array</code> of any of the listed supported types <i>(e.g. <code>[ "foo", { bar: false }, [] ]</code>)</i>.
+        An <code>Array</code> of the supported types <i>(e.g., <code>[ "foo", { bar: false }, [] ]</code>)</i>.
       </li>
     </ul>
   </mizu-note>
   <mizu-note #note>
-    Initial <code>class</code> attribute value is preserved.
+    The initial <code>class</code> attribute value is preserved.
   </mizu-note>
   <mizu-note #note>
     Class names with at least one <a href="https://developer.mozilla.org/en-US/docs/Glossary/Truthy">truthy value</a> are treated as active.
@@ -61,41 +61,41 @@
 <mizu-directive id="bind-style" directory="bind">
   <code #name><span class="hljs-keyword">:style</span><wbr /><span class="muted">="value"</span></code>
   <p #description>
-    Bind an element's <code><a href="https://developer.mozilla.org/docs/Web/HTML/Global_attributes/style">style</a></code> attribute.
+    Bind an element's <a href="https://developer.mozilla.org/docs/Web/HTML/Global_attributes/style"><code>style</code></a> attribute.
   </p>
   <code #example *skip>
     <p :style="{ color: 'salmon' }">
       <!--...-->
     </p>
   </code>
   <mizu-note #note>
-    Evaluated expression can be either be:
+    The expression can be:
     <ul>
       <li>
         A <code>string</code> supported by <a href="https://developer.mozilla.org/docs/Web/API/CSSStyleDeclaration/cssText"><code>HTMLElement.style.cssText</code></a>
-        <i>(e.g. <code>"color: blue;"</code>)</i>.
+        <i>(e.g., <code>"color: blue;"</code>)</i>.
       </li>
       <li>
-        A <code>Record&lt;PropertyKey, unknown&gt;</code> of CSS properties mapped to their current value <i>(e.g. <code>{ backgroundColor: "red", "border-color": "green", width: 1 }</code>)</i>.
+        A <code>Record&lt;PropertyKey, unknown&gt;</code> mapping CSS properties to their values <i>(e.g., <code>{ backgroundColor: "red", "border-color": "green", width: 1 }</code>)</i>.
         <ul>
           <li>
-            <a href="https://developer.mozilla.org/docs/Glossary/Camel_case"><q>camelCase</q></a> may be used inplace of <a href="https://developer.mozilla.org/docs/Glossary/Kebab_case"><q>kebab-case</q></a> to avoid escaping CSS properties names.
+            Use <a href="https://developer.mozilla.org/docs/Glossary/Camel_case"><q>camelCase</q></a> instead of <a href="https://developer.mozilla.org/docs/Glossary/Kebab_case"><q>kebab-case</q></a> to avoid escaping CSS property names.
           </li>
           <li>
-            Values of type <code>number</code> are implicitely converted to <code>px</code> unit whenever applicable <i>(<a href="https://developer.mozilla.org/docs/Web/API/CSSStyleDeclaration/setProperty"><code>HTMLElement.style.setProperty()</code></a> will be called again with
-              <code>"px"</code> appended)</i>.
+            Values of type <code>number</code> are implicitly converted to <code>px</code> units when applicable <i>(<a href="https://developer.mozilla.org/docs/Web/API/CSSStyleDeclaration/setProperty"><code>HTMLElement.style.setProperty()</code></a> will be called with <code
+              >"px"</code> appended)</i>.
           </li>
         </ul>
       </li>
       <li>
-        An <code>Array</code> of any of the listed supported types <i>(e.g. <code>[ "color: blue", { backgroundColor: "red" }, [] ]</code>)</i>.
+        An <code>Array</code> of the supported types <i>(e.g., <code>[ "color: blue", { backgroundColor: "red" }, [] ]</code>)</i>.
       </li>
     </ul>
   </mizu-note>
   <mizu-note #note>
-    Initial <code>style</code> attribute value is preserved.
+    The initial <code>style</code> attribute value is preserved.
   </mizu-note>
   <mizu-note #note>
-    Specified CSS properties values are processed in the order they are defined, regardless of whether they were marked as <a href="https://developer.mozilla.org/docs/Web/CSS/important"><code>!important</code></a>.
+    CSS properties are processed in the order they are defined, regardless of <a href="https://developer.mozilla.org/docs/Web/CSS/important"><code>!important</code></a>.
   </mizu-note>
 </mizu-directive>

@mizu/bind/mod.ts

@@ -1,7 +1,7 @@
 // Imports
-import { type Cache, type Directive, Phase } from "@mizu/mizu/core/engine"
+import { type Cache, type Directive, Phase } from "@mizu/render/engine"
 import { boolean } from "./boolean.ts"
-export type * from "@mizu/mizu/core/engine"
+export type * from "@mizu/render/engine"
 
 /** `:bind` directive. */
 export const _bind = {

@mizu/bind/mod_test.ts

@@ -1 +1 @@
-await import("@mizu/mizu/core/testing").then(({ test }) => test(import.meta))
+await import("@mizu/render/engine/testing").then(({ test }) => test(import.meta))

@mizu/clean/README.md

@@ -7,7 +7,7 @@
 Clean up the element and its children from specified content.
 
 ```html
-<div *clean="">
+<div *clean>
   <!--...-->
 </div>
 ```
@@ -16,16 +16,16 @@ Clean up the element and its children from specified content.
 
 ### `.comments[boolean]`
 
-Clean up all [`Comment`](https://developer.mozilla.org/docs/Web/API/Comment) nodes from subtree.
+Remove all [`Comment`](https://developer.mozilla.org/docs/Web/API/Comment) nodes within the subtree.
 
 ### `.spaces[boolean]`
 
-Clean up all spaces (except non-breaking spaces [`&nbsp;`](https://developer.mozilla.org/docs/Glossary/Character_reference)) from subtree.
+Remove all spaces (except non-breaking spaces [`&nbsp;`](https://developer.mozilla.org/docs/Glossary/Character_reference)) within the subtree.
 
 ### `.templates[boolean]`
 
-Clean up all [`<template>`](https://developer.mozilla.org/docs/Web/HTML/Element/template) nodes from subtree **after processing the subtree entirely**.
+Clear all [`<template>`](https://developer.mozilla.org/docs/Web/HTML/Element/template) nodes from the subtree **after fully processing it**.
 
 ### `.directives[boolean]`
 
-Clean up all known directives from subtree **after processing the subtree entirely**. If `.comments` modifier is also enabled, then comments generated by directives will be cleaned up as well.
+Strip all known directives from the subtree **after fully processing it**. If the `.comments` modifier is also enabled, comments generated by directives will be removed as well.

@mizu/clean/mod.html

@@ -9,15 +9,15 @@
     </div>
   </code>
   <mizu-modifier #modifier name="comments">
-    Clean up all <a href="https://developer.mozilla.org/docs/Web/API/Comment"><code>Comment</code></a> nodes from subtree.
+    Remove all <a href="https://developer.mozilla.org/docs/Web/API/Comment"><code>Comment</code></a> nodes within the subtree.
   </mizu-modifier>
   <mizu-modifier #modifier name="spaces">
-    Clean up all spaces (except non-breaking spaces <a href="https://developer.mozilla.org/docs/Glossary/Character_reference"><code>&amp;nbsp;</code></a>) from subtree.
+    Remove all spaces (except non-breaking spaces <a href="https://developer.mozilla.org/docs/Glossary/Character_reference"><code>&amp;nbsp;</code></a>) within the subtree.
   </mizu-modifier>
   <mizu-modifier #modifier name="templates">
-    Clean up all <a href="https://developer.mozilla.org/docs/Web/HTML/Element/template"><code>&lt;template&gt;</code></a> nodes from subtree <strong>after processing the subtree entirely</strong>.
+    Clear all <a href="https://developer.mozilla.org/docs/Web/HTML/Element/template"><code>&lt;template&gt;</code></a> nodes from the subtree <strong>after fully processing it</strong>.
   </mizu-modifier>
   <mizu-modifier #modifier name="directives">
-    Clean up all known directives from subtree <strong>after processing the subtree entirely</strong>. If <code>.comments</code> modifier is also enabled, then comments generated by directives will be cleaned up as well.
+    Strip all known directives from the subtree <strong>after fully processing it</strong>. If the <code class="hljs-meta">.comments</code> modifier is also enabled, comments generated by directives will be removed as well.
   </mizu-modifier>
 </mizu-directive>

@mizu/clean/mod.ts

@@ -1,6 +1,6 @@
 // Imports
-import { type Cache, type Directive, Phase } from "@mizu/mizu/core/engine"
-export type * from "@mizu/mizu/core/engine"
+import { type Cache, type Directive, Phase } from "@mizu/render/engine"
+export type * from "@mizu/render/engine"
 
 /**
  * All spacing characters except non-breaking space.

@mizu/clean/mod_test.ts

@@ -1 +1 @@
-await import("@mizu/mizu/core/testing").then(({ test }) => test(import.meta))
+await import("@mizu/render/engine/testing").then(({ test }) => test(import.meta))