remove code-group from examples

Author: marshallswain

content/pinion/docs/composability.md

@@ -10,8 +10,6 @@ This chapter shows how to test generators, use them programmatically in CLI tool
 
 Another generator can be directly imported and run like any other tasks:
 
-::: code-group
-
 ```ts [generators/app.tpl.ts]
 import { PinionContext, exec } from '@featherscloud/pinion'
 import { generate as generateReadme } from './readme.tpl'
@@ -48,16 +46,12 @@ export function generate(init: Context) {
 }
 ```
 
-:::
-
 ```sh
 npx pinion generators/app.tpl.ts
 ```
 
 The [runGenerators](./api.md#rungenerators) tasks also allows to run all `.tpl.ts` generators in a folder in alphabetical order using the current context.
 
-::: code-group
-
 ```ts [generators/app.tpl.ts]
 // Get current file and directory in an ES module
 import { fileURLToPath } from 'node:url'
@@ -108,8 +102,6 @@ export function generate(init: Context) {
 }
 ```
 
-:::
-
 ## Embedability
 
 Since a generator is just a function that can be called anywhere, Pinion generators can be composed, tested or used programatically e.g. in your own CLI tools just by importing the file, initialising a context and calling the generator:
@@ -137,8 +129,6 @@ npx pinion generators/app.tpl.ts
 
 Similar to an embedded generator, automated tests can be written by initializing the context - usually with a temporary path - and passing all context variables necessary to [skip user prompts](./user-input.md#prompting):
 
-::: code-group
-
 ```ts [tests/readme.tpl.test.ts]
 import { describe, it } from 'node:test'
 import assert from 'node:assert'
@@ -221,8 +211,6 @@ export function generate(init: Context) {
 }
 ```
 
-:::
-
 ```sh
 node --import tsx --test test/readme.tpl.test.ts
 ```

content/pinion/docs/generators.md

@@ -6,8 +6,6 @@ outline: deep
 
 A Pinion generator is any file that has a `generate` export which takes a context and returns a Promise with that context. In its most basic form a Pinion generator looks like this:
 
-::: code-group
-
 ```ts [generators/empty.tpl.ts]
 import { PinionContext } from '@featherscloud/pinion'
 
@@ -18,8 +16,6 @@ interface Context extends PinionContext {}
 export const generate = (init: Context) => Promise.resolve(init)
 ```
 
-:::
-
 ```sh
 npx pinion generators/empty.tpl.ts
 ```
@@ -92,6 +88,8 @@ Let's review key lines to see how to further define `Context`:
 
 <!--@include: ./shared/context-extending-1.md-->
 
+:embed-markdown{collection="pinionShared" path="pinion/shared/context-extending-1"}
+
 The above example is a bit contrived because we can use TypeScript functions directly in templates. It's not necessary to define variables outside of templates like it is with other generator tools.
 
 The concept to be learned is that you can add properties to `context` in the promise and they will be available in the template. This would be more useful if we extracted the function into its own module and reused it in multiple generators.
@@ -102,8 +100,6 @@ What's really cool is that there's no special magic to learn. To make a reusable
 
 A task is any step within the `generate` function. Pinion tasks rely on functional programming through `Promise.then` chains. You can follow each step in the generator and they are still bundled as a testable and embedable plain function.
 
-::: code-group
-
 ```ts [generators/tasks.tpl.ts]
 import { PinionContext, prompt } from '@featherscloud/pinion'
 
@@ -151,8 +147,6 @@ export function generate(init: Context) {
 }
 ```
 
-:::
-
 ```sh
 npx pinion generators/tasks.tpl.ts
 ```

content/pinion/docs/index.md

@@ -31,7 +31,7 @@ A Pinion generator has two ingredients:
 
 The following file generates a basic `readme.md` from a TypeScript template string:
 
-<!--@include: ./shared/quick-start-1-basics.md-->
+:embed-markdown{collection="pinionShared" path="pinion/shared/quick-start-1-basics"}
 
 Once you ran the command, you can find your `readme.md` file in the current directory.
 
@@ -41,7 +41,7 @@ Pinion comes with a `prompt` utility that works with your typed context. Let's g
 
 You can ask questions from the command line with the [prompt](./generators.md#prompt) task:
 
-<!--@include: ./shared/quick-start-2-user-input.md-->
+:embed-markdown{collection="pinionShared" path="pinion/shared/quick-start-2-user-input"}
 
 Pinion uses [Inquirer](https://www.npmjs.com/package/inquirer) under the hood to ask questions. The `prompt` task takes an array or object of [Inquirer questions](https://www.npmjs.com/package/inquirer#question) and returns a function that takes a context and returns a promise with the updated context. We can then use this context in the next step to render our template with the answers.
 

content/pinion/docs/templates.md

@@ -16,8 +16,6 @@ There are three main helpers for working with file pointers:
 
 The following example asks for the path the `readme.md` file should be generated in and then puts the path together dynamically based on the context:
 
-::: code-group
-
 ```ts [generators/readme.tpl.ts]
 import {
   PinionContext,
@@ -74,8 +72,6 @@ export function generate(init: Context) {
 }
 ```
 
-:::
-
 ```sh
 npx pinion generators/readme.tpl.ts
 ```
@@ -91,8 +87,6 @@ While you could use them in your own tasks, Pinion tries to avoid difficult-to-d
 
 It also allows composing templates by splitting them up into separate functions, and you have the entire JavaScript ecosystem (like [Lodash](https://lodash.com/)) available as helpers:
 
-::: code-group
-
 ```ts [generators/readme.tpl.ts]
 import { upperFirst } from 'lodash'
 import { PinionContext, renderTemplate, toFile } from '@featherscloud/pinion'
@@ -128,8 +122,6 @@ export function generate(init: Context) {
 }
 ```
 
-:::
-
 ```sh
 npx pinion generators/readme.tpl.ts
 ```
@@ -153,8 +145,6 @@ This is done by passing a template and an injection point to the `inject` task.
 
 The following example generates a TypeScript Express middleware and imports and registers it in `src/app.ts`:
 
-::: code-group
-
 ```ts [generators/middleware.tpl.ts]
 import {
   PinionContext,
@@ -221,8 +211,6 @@ const app = express()
 export { app }
 ```
 
-:::
-
 ```sh
 npx pinion generators/middleware.tpl.ts
 ```

content/pinion/docs/user-input.md

@@ -10,8 +10,6 @@ This section shows how to handle user input through prompts and CLI arguments.
 
 As [we have seen before](./index.md#asking-questions), the [prompt](./api.md#prompt) task allows to ask questions from the command line using the [Inquirer](https://www.npmjs.com/package/inquirer) library. It gets passed a [list of Inquirer questions](https://www.npmjs.com/package/inquirer#question) that can also be put together based on the current context. This can be used to e.g. ask questions conditionally or skip them if the value is already passed (e.g. in an automated test):
 
-::: code-group
-
 ```ts [generators/readme.tpl.ts]
 import {
   PinionContext,
@@ -63,8 +61,6 @@ export function generate(init: Context) {
 }
 ```
 
-:::
-
 ```sh
 npx pinion generators/readme.tpl.ts
 ```
@@ -79,8 +75,6 @@ npx pinion generators/readme.ts --description hello something
 
 `context.argv` would be `['--description', 'hello', 'something']`. You can parse the list yourself and Pinion also ships with a [commander task](./api.md#commander) that uses the `commander` module to create command-line interfaces. The following example adds `--name` and `--description` command line arguments and skips prompting the user if it is passed.
 
-::: code-group
-
 ```ts [generators/readme.tpl.ts]
 import {
   Command,
@@ -141,8 +135,6 @@ export function generate(init: Context) {
 }
 ```
 
-:::
-
 ```sh
 npx pinion generators/readme.tpl.ts --name Test --description "The description from the command line"
 ```

content/pinion/shared/context-extending-1.md

@@ -1,5 +1,3 @@
-::: code-group
-
 ```ts:line-numbers {5,9,14,22} [generators/readme.tpl.ts]
 import { PinionContext, toFile, renderTemplate } from '@featherscloud/pinion'
 
@@ -28,8 +26,6 @@ export const generate = (init: Context) => Promise.resolve(init)
   .then(renderTemplate(readme, toFile('readme.md')))
 ```
 
-:::
-
 ```sh
 npx pinion generators/readme.tpl.ts
 ```

content/pinion/shared/quick-start-1-basics.md

@@ -1,5 +1,3 @@
-::: code-group
-
 ```ts [generators/readme.tpl.ts]
 import { PinionContext, renderTemplate, toFile } from '@featherscloud/pinion'
 
@@ -22,8 +20,6 @@ export function generate(init: Context) {
 }
 ```
 
-:::
-
 ```sh
 npx pinion generators/readme.tpl.ts
 ```

content/pinion/shared/quick-start-2-user-input.md

@@ -1,5 +1,3 @@
-::: code-group
-
 ```ts{7-8,25-34} [generators/readme.tpl.ts]
 import {
   PinionContext, renderTemplate, toFile, prompt
@@ -40,8 +38,6 @@ export const generate = (init: Context) => Promise.resolve(init)
   .then(renderTemplate(readme, toFile('readme.md')))
 ```
 
-:::
-
 ```sh
 npx pinion generators/readme.tpl.ts
 ```