@nitro-bolt/scratchblocks 1.1.0 → 1.1.2

package/README.md

@@ -1,22 +1,21 @@
-This fork adds NitroBolt's scratch-blocks related changes
-
-Some examples:
-```text
-{object value}
-[array value]
-use object {} and array []
-
-first row \n second row
-values (one) (two) @delInput @addInput
-```
-
-At the start of a line, `{...}` and `[...]` create object and array blocks.
-Overrides remain inside the delimiters, for example
-`[array value :: #4D5057]`.
-Inside a block, empty `{}` and `[]` create object and array input slots.
-Use `[ ]` when an empty text input is needed.
-`\n` starts a new visual row inside the same block. `@delInput` and
-`@addInput` draw the left and right extendable-input controls independently.
+This fork adds NitroBolt's scratch-blocks features:
+
+- Object blocks use `{object value}` and object inputs use `{}`.
+- Array blocks use `[array value]` and array inputs use `[]`.
+- Overrides stay inside object and array block delimiters, such as
+  `[array value :: #4D5057]`.
+- Use `[ ]` when an empty text input is needed instead of an array input.
+- `\n` starts a new visual row inside the same block.
+- `@delInput` and `@addInput` render the two extendable-input controls
+  independently.
+- `c-block` makes a custom block C-shaped. Put the branch on the following
+  lines and close it with `end`:
+
+  ```text
+  new function [] :: #FF894D c-block
+    say [Hello!]
+  end
+  ```
 
 <!--
 Make pictures of Scratch blocks from text.
@@ -83,7 +82,7 @@ Make sure this appears at the end of the page (just before the closing `</body>`
 ```js
 <script>
 scratchblocks.renderMatching('pre.blocks', {
-  style:     'scratch3',   // Optional; Scratch 3 is the only supported style.
+  style:     'scratch3',   // Optional; Scratch 3 is the only supported style.
   languages: ['en', 'de'], // Optional, defaults to ['en'].
   scale: 1,                // Optional, defaults to 1
 });
@@ -91,8 +90,8 @@ scratchblocks.renderMatching('pre.blocks', {
 ```
 The `renderMatching()` function takes a CSS-style selector for the elements that contain scratchblocks code: we use `pre.blocks` to target `pre` tags with the class `blocks`.
 
-The `style` option controls how the blocks appear. `scratch3` and
-`scratch3-high-contrast` are supported.
+The `style` option controls how the blocks appear. `scratch3` and
+`scratch3-high-contrast` are supported.
 
 ### Inline blocks