create-riebeckite 0.0.18 → 0.0.19

package/README.md

@@ -7,7 +7,7 @@ Create a new Riebeckite site from an official starter preset.
 ## Usage
 
 Interactive (recommended): run without arguments and answer the prompts for
-the project name, preset, content source, and deployment.
+the project name, preset, project files, content source, and deployment.
 
 ```sh
 npx create-riebeckite
@@ -30,6 +30,7 @@ The prompts ask, in order:
 | --- | --- | --- |
 | Project name | the folder to create (empty input uses the default name) | any name, e.g. `my-site` |
 | Preset | `starter`, `minimal`, `showcase`, `empty` | `starter` for most sites |
+| Project files | `.editorconfig`, `.gitattributes`, `biome.json`, `.npmrc`, `.vscode/settings.json` | the recommended set is pre-selected |
 | Content source | `This project`, `Separate GitHub repository` | `This project` to start |
 | Deployment | `GitHub Actions + Cloudflare Workers`, `Not now` | `Not now` for local development |
 
@@ -45,6 +46,7 @@ Deployment can be added later, described in
 | --- | --- |
 | `[directory]` | Directory to scaffold into (default: the current directory) |
 | `--preset <name>` | Starter composition, e.g. `showcase` (default: `starter`) |
+| `--utilities <names>` | Comma-separated project files to generate: `editorconfig`, `gitattributes`, `biome`, `npmrc`, `vscode`, or `none` (default: `editorconfig,gitattributes,biome`) |
 | `--force` | Scaffold even when the target directory is not empty |
 | `--list-presets` | Print the available presets and their descriptions, then exit |
 | `--github-actions` | Generate the Cloudflare deployment workflow |
@@ -57,6 +59,27 @@ For example, scaffold the complete feature tour:
 npx create-riebeckite my-site --preset showcase
 ```
 
+## Project files
+
+Alongside the preset, `create-riebeckite` writes optional project files. In
+interactive mode the `Extra project files` prompt pre-selects the recommended
+set; toggle any of them there. Non-interactive runs select them with a
+comma-separated `--utilities` value.
+
+| Name | File | Default |
+| --- | --- | --- |
+| `editorconfig` | `.editorconfig` | yes |
+| `gitattributes` | `.gitattributes` | yes |
+| `biome` | `biome.json` | yes |
+| `npmrc` | `.npmrc` | no |
+| `vscode` | `.vscode/settings.json` | no |
+
+Pass `none` to write no project files, or list the ones you want:
+
+```sh
+npx create-riebeckite my-site --utilities editorconfig,npmrc,vscode
+```
+
 ## External content repository
 
 To use a separate content repository and deploy after its `main` branch is

package/README_ja.md

@@ -8,7 +8,7 @@ CLI ツールです。
 ## 使い方
 
 対話モード（推奨）: 引数なしで実行すると、プロジェクト名・preset・
-コンテンツの格納場所・デプロイについて順に確認します。
+プロジェクトファイル・コンテンツの格納場所・デプロイについて順に確認します。
 
 ```sh
 npx create-riebeckite
@@ -31,6 +31,7 @@ npm exec riebeckite build
 | --- | --- | --- |
 | Project name | 作るフォルダ名（空なら既定の名前） | 任意。例: `my-site` |
 | Preset | `starter`、`minimal`、`showcase`、`empty` | 大半のサイトは `starter` |
+| Project files | `.editorconfig`、`.gitattributes`、`biome.json`、`.npmrc`、`.vscode/settings.json` | 推奨セットをあらかじめ選択 |
 | Content source | `This project`、`Separate GitHub repository` | 最初は `This project` |
 | デプロイ設定 | `GitHub Actions + Cloudflare Workers`、`Not now` | 手元で試すなら `Not now` |
 
@@ -42,6 +43,7 @@ npm exec riebeckite build
 | --- | --- |
 | `[directory]` | 生成先ディレクトリ（既定はカレントディレクトリ） |
 | `--preset <name>` | 使用するスターター構成（既定は `starter`） |
+| `--utilities <names>` | 生成するプロジェクトファイルをカンマ区切りで指定する（`editorconfig`、`gitattributes`、`biome`、`npmrc`、`vscode`、または `none`。既定は `editorconfig,gitattributes,biome`） |
 | `--force` | 空でないディレクトリにも展開する |
 | `--list-presets` | 利用可能な preset と説明を一覧表示して終了する |
 | `--github-actions` | Cloudflare へのデプロイ workflow を生成する |
@@ -54,6 +56,28 @@ npm exec riebeckite build
 npx create-riebeckite my-site --preset showcase
 ```
 
+## Project files
+
+preset とは別に、`create-riebeckite` は任意のプロジェクトファイルを生成します。
+対話モードでは `Extra project files` の質問で推奨セットがあらかじめ選択されて
+いるので、そこから個別に切り替えられます。非対話で実行する場合は、
+カンマ区切りの `--utilities` で選択します。
+
+| 名前 | ファイル | 既定 |
+| --- | --- | --- |
+| `editorconfig` | `.editorconfig` | 生成する |
+| `gitattributes` | `.gitattributes` | 生成する |
+| `biome` | `biome.json` | 生成する |
+| `npmrc` | `.npmrc` | 生成しない |
+| `vscode` | `.vscode/settings.json` | 生成しない |
+
+`none` を渡すとプロジェクトファイルを一切生成しません。個別に選ぶ場合は
+次のように指定します。
+
+```sh
+npx create-riebeckite my-site --utilities editorconfig,npmrc,vscode
+```
+
 ## External content repository
 
 別の記事リポジトリを使い、その `main` への push でデプロイする場合は、共通の

package/dist/src/arguments.d.ts

@@ -1,9 +1,11 @@
 import type { ScaffoldDeployment } from "./scaffold/options.js";
 import { type ScaffoldPresetName } from "./scaffold/presets.js";
+import { type ScaffoldUtilityName } from "./scaffold/utilities.js";
 export type CreateRiebeckiteOptions = {
     readonly directory: string;
     readonly force: boolean;
     readonly preset: ScaffoldPresetName;
+    readonly utilities: readonly ScaffoldUtilityName[];
     readonly listPresets: boolean;
     readonly deployment: ScaffoldDeployment;
 };

package/dist/src/index.js

@@ -774,11 +774,95 @@ function resolveScaffoldPreset(value) {
   return preset;
 }
 
+// src/scaffold/utilities.ts
+var SCAFFOLD_UTILITY_NAMES = [
+  "editorconfig",
+  "gitattributes",
+  "biome",
+  "npmrc",
+  "vscode"
+];
+var SCAFFOLD_UTILITIES = [
+  {
+    name: "editorconfig",
+    label: ".editorconfig",
+    description: "Shared editor indentation, newline, and encoding defaults."
+  },
+  {
+    name: "gitattributes",
+    label: ".gitattributes",
+    description: "Line-ending normalization and text detection for Git."
+  },
+  {
+    name: "biome",
+    label: "biome.json",
+    description: "Biome formatter and linter configuration."
+  },
+  {
+    name: "npmrc",
+    label: ".npmrc",
+    description: "npm settings such as exact dependency versions."
+  },
+  {
+    name: "vscode",
+    label: ".vscode/settings.json",
+    description: "Recommended VS Code workspace settings."
+  }
+];
+var SCAFFOLD_DEFAULT_UTILITIES = [
+  "editorconfig",
+  "gitattributes",
+  "biome"
+];
+var SCAFFOLD_NO_UTILITIES = "none";
+function isScaffoldUtilityName(value) {
+  return SCAFFOLD_UTILITY_NAMES.includes(value);
+}
+function parseScaffoldUtilities(value) {
+  const tokens = value.split(",").map((token) => token.trim()).filter((token) => token.length > 0);
+  if (tokens.length === 0) {
+    throw new Error(
+      "--utilities requires a comma-separated list of utility names."
+    );
+  }
+  if (tokens.length === 1 && tokens[0] === SCAFFOLD_NO_UTILITIES) {
+    return [];
+  }
+  const utilities = [];
+  for (const token of tokens) {
+    if (token === SCAFFOLD_NO_UTILITIES) {
+      throw new Error(
+        `"${SCAFFOLD_NO_UTILITIES}" cannot be combined with other utility names.`
+      );
+    }
+    if (!isScaffoldUtilityName(token)) {
+      throw new Error(
+        `Unknown utility: ${token}. Available utilities: ${SCAFFOLD_UTILITY_NAMES.join(", ")}, ${SCAFFOLD_NO_UTILITIES}.`
+      );
+    }
+    if (!utilities.includes(token)) utilities.push(token);
+  }
+  return utilities;
+}
+function utilityTemplateFiles(utilities) {
+  const seen = /* @__PURE__ */ new Set();
+  const files = [];
+  for (const name of utilities) {
+    for (const file of copyTemplateTree(`utilities/${name}`)) {
+      if (seen.has(file.path)) continue;
+      seen.add(file.path);
+      files.push(file);
+    }
+  }
+  return files;
+}
+
 // src/arguments.ts
 function parseArguments(arguments_) {
   let directory;
   let force = false;
   let preset;
+  let utilities;
   let listPresets = false;
   let githubActions = false;
   let contentRepository;
@@ -818,12 +902,23 @@ function parseArguments(arguments_) {
       index += 1;
       continue;
     }
+    if (argument === "--utilities") {
+      const value = arguments_[index + 1];
+      if (value === void 0 || value.startsWith("-")) {
+        throw new Error(
+          "--utilities requires a comma-separated list of utility names."
+        );
+      }
+      utilities = parseScaffoldUtilities(value);
+      index += 1;
+      continue;
+    }
     if (argument.startsWith("-")) {
       throw new Error(`Unknown option: ${argument}`);
     }
     if (directory !== void 0) {
       throw new Error(
-        "Usage: create-riebeckite [directory] [--preset <name>] [--github-actions] [--content-repository <owner/repository>] [--site-repository <owner/repository>] [--force]"
+        "Usage: create-riebeckite [directory] [--preset <name>] [--utilities <names>] [--github-actions] [--content-repository <owner/repository>] [--site-repository <owner/repository>] [--force]"
       );
     }
     directory = argument;
@@ -832,6 +927,7 @@ function parseArguments(arguments_) {
     directory: directory ?? ".",
     force,
     preset: preset ?? "starter",
+    utilities: utilities ?? SCAFFOLD_DEFAULT_UTILITIES,
     listPresets,
     deployment: scaffoldDeploymentFromFlags({
       githubActions,
@@ -849,7 +945,7 @@ function printPresets() {
 }
 
 // src/interactive.ts
-import { isCancel, log, select, text } from "@clack/prompts";
+import { isCancel, log, multiselect, select, text } from "@clack/prompts";
 var DEFAULT_DIRECTORY = "my-riebeckite-site";
 var DEFAULT_INTERACTIVE_DEPLOYMENT = "none";
 function interactiveAnswersToOptions(answers) {
@@ -857,6 +953,7 @@ function interactiveAnswersToOptions(answers) {
     directory: answers.directory,
     force: false,
     preset: answers.preset,
+    utilities: answers.utilities,
     listPresets: false,
     deployment: deploymentFromAnswers(answers)
   };
@@ -898,6 +995,17 @@ async function promptInteractiveAnswers() {
     }))
   });
   if (isCancel(preset)) return null;
+  const utilities = await multiselect({
+    message: "Extra project files",
+    options: SCAFFOLD_UTILITIES.map(({ name, label, description }) => ({
+      value: name,
+      label,
+      hint: description
+    })),
+    initialValues: [...SCAFFOLD_DEFAULT_UTILITIES],
+    required: false
+  });
+  if (isCancel(utilities)) return null;
   const contentSource = await select({
     message: "Where will you write content?",
     initialValue: "local",
@@ -925,6 +1033,7 @@ async function promptInteractiveAnswers() {
     answers = {
       directory,
       preset,
+      utilities,
       contentSource,
       contentRepository: contentRepository.trim(),
       siteRepository: siteRepository.trim()
@@ -948,7 +1057,7 @@ async function promptInteractiveAnswers() {
       ]
     });
     if (isCancel(deployment)) return null;
-    answers = { directory, preset, contentSource, deployment };
+    answers = { directory, preset, utilities, contentSource, deployment };
   }
   log.step("Creating Riebeckite site...");
   return answers;
@@ -2480,7 +2589,7 @@ function referenceThemesContent(preset) {
 }
 
 // src/scaffold/version.ts
-var RIEBECKITE_VERSION = "^0.0.18";
+var RIEBECKITE_VERSION = "^0.0.19";
 
 // src/scaffold/templates.ts
 function siteTemplateFiles(preset, variables, options = {}) {
@@ -2491,6 +2600,7 @@ function siteTemplateFiles(preset, variables, options = {}) {
       content: riebeckiteConfig(preset, variables)
     },
     ...copyTemplateTree("base"),
+    ...utilityTemplateFiles(options.utilities ?? SCAFFOLD_DEFAULT_UTILITIES),
     ...copyTemplateTree(
       `presets/${preset.name}`,
       {},
@@ -3348,7 +3458,8 @@ async function scaffoldRiebeckiteSite(options) {
   }
   const files = [
     ...siteTemplateFiles(preset, templateVariables(options, targetDirectory), {
-      cloudflareWorkers: deployment.type === "cloudflare-workers"
+      cloudflareWorkers: deployment.type === "cloudflare-workers",
+      utilities: options.utilities
     }),
     ...deploymentTemplateOrConfig(deployment, targetDirectory)
   ];
@@ -3441,6 +3552,7 @@ async function runCreateRiebeckite(arguments_) {
       targetDirectory,
       overwrite: options.force,
       preset: options.preset,
+      utilities: options.utilities,
       deployment: options.deployment
     });
   } catch (error) {

package/dist/src/interactive.d.ts

@@ -1,16 +1,19 @@
 import type { CreateRiebeckiteOptions } from "./arguments.js";
 import { type ScaffoldPresetName } from "./scaffold/presets.js";
+import { type ScaffoldUtilityName } from "./scaffold/utilities.js";
 export declare const DEFAULT_INTERACTIVE_DEPLOYMENT: InteractiveDeployment;
 export type InteractiveContentSource = "local" | "external";
 export type InteractiveDeployment = "cloudflare" | "github-actions" | "none";
 export type InteractiveAnswers = {
     readonly directory: string;
     readonly preset: ScaffoldPresetName;
+    readonly utilities: readonly ScaffoldUtilityName[];
     readonly contentSource: "local";
     readonly deployment: InteractiveDeployment;
 } | {
     readonly directory: string;
     readonly preset: ScaffoldPresetName;
+    readonly utilities: readonly ScaffoldUtilityName[];
     readonly contentSource: "external";
     readonly contentRepository: string;
     readonly siteRepository: string;

package/dist/src/scaffold/index.d.ts

@@ -3,5 +3,6 @@ export { deploymentWorkflow, scaffoldDeploymentFromFlags, } from "./deployment.j
 export { formatScaffoldNextSteps, type ScaffoldNextStepsOptions, } from "./next-steps.js";
 export { type ScaffoldContentSource, type ScaffoldDeployment, type ScaffoldDeploymentFlags, ScaffoldSiteError, type ScaffoldSiteMetadata, type ScaffoldSiteOptions, type ScaffoldSiteResult, } from "./options.js";
 export { isScaffoldPresetName, SCAFFOLD_DEFAULT_PRESET, SCAFFOLD_PRESETS, type ScaffoldPresetName, type ScaffoldPresetSummary, } from "./presets.js";
+export { isScaffoldUtilityName, parseScaffoldUtilities, SCAFFOLD_DEFAULT_UTILITIES, SCAFFOLD_UTILITIES, SCAFFOLD_UTILITY_NAMES, type ScaffoldUtilityName, type ScaffoldUtilitySummary, } from "./utilities.js";
 export { GITHUB_ACTIONS_SECRETS, wranglerConfigForDirectory, } from "./wrangler-defaults.js";
 export declare function scaffoldRiebeckiteSite(options: ScaffoldSiteOptions): Promise<ScaffoldSiteResult>;

package/dist/src/scaffold/index.js

@@ -2175,8 +2175,91 @@ function referenceThemesContent(preset) {
   return lines.join("\n");
 }
 
+// src/scaffold/utilities.ts
+var SCAFFOLD_UTILITY_NAMES = [
+  "editorconfig",
+  "gitattributes",
+  "biome",
+  "npmrc",
+  "vscode"
+];
+var SCAFFOLD_UTILITIES = [
+  {
+    name: "editorconfig",
+    label: ".editorconfig",
+    description: "Shared editor indentation, newline, and encoding defaults."
+  },
+  {
+    name: "gitattributes",
+    label: ".gitattributes",
+    description: "Line-ending normalization and text detection for Git."
+  },
+  {
+    name: "biome",
+    label: "biome.json",
+    description: "Biome formatter and linter configuration."
+  },
+  {
+    name: "npmrc",
+    label: ".npmrc",
+    description: "npm settings such as exact dependency versions."
+  },
+  {
+    name: "vscode",
+    label: ".vscode/settings.json",
+    description: "Recommended VS Code workspace settings."
+  }
+];
+var SCAFFOLD_DEFAULT_UTILITIES = [
+  "editorconfig",
+  "gitattributes",
+  "biome"
+];
+var SCAFFOLD_NO_UTILITIES = "none";
+function isScaffoldUtilityName(value) {
+  return SCAFFOLD_UTILITY_NAMES.includes(value);
+}
+function parseScaffoldUtilities(value) {
+  const tokens = value.split(",").map((token) => token.trim()).filter((token) => token.length > 0);
+  if (tokens.length === 0) {
+    throw new Error(
+      "--utilities requires a comma-separated list of utility names."
+    );
+  }
+  if (tokens.length === 1 && tokens[0] === SCAFFOLD_NO_UTILITIES) {
+    return [];
+  }
+  const utilities = [];
+  for (const token of tokens) {
+    if (token === SCAFFOLD_NO_UTILITIES) {
+      throw new Error(
+        `"${SCAFFOLD_NO_UTILITIES}" cannot be combined with other utility names.`
+      );
+    }
+    if (!isScaffoldUtilityName(token)) {
+      throw new Error(
+        `Unknown utility: ${token}. Available utilities: ${SCAFFOLD_UTILITY_NAMES.join(", ")}, ${SCAFFOLD_NO_UTILITIES}.`
+      );
+    }
+    if (!utilities.includes(token)) utilities.push(token);
+  }
+  return utilities;
+}
+function utilityTemplateFiles(utilities) {
+  const seen = /* @__PURE__ */ new Set();
+  const files = [];
+  for (const name of utilities) {
+    for (const file of copyTemplateTree(`utilities/${name}`)) {
+      if (seen.has(file.path)) continue;
+      seen.add(file.path);
+      files.push(file);
+    }
+  }
+  return files;
+}
+
 // src/scaffold/version.ts
-var RIEBECKITE_VERSION = "^0.0.18";
+var RIEBECKITE_VERSION = "^0.0.19";
 
 // src/scaffold/templates.ts
 function siteTemplateFiles(preset, variables, options = {}) {
@@ -2187,6 +2270,7 @@ function siteTemplateFiles(preset, variables, options = {}) {
       content: riebeckiteConfig(preset, variables)
     },
     ...copyTemplateTree("base"),
+    ...utilityTemplateFiles(options.utilities ?? SCAFFOLD_DEFAULT_UTILITIES),
     ...copyTemplateTree(
       `presets/${preset.name}`,
       {},
@@ -3044,7 +3128,8 @@ async function scaffoldRiebeckiteSite(options) {
   }
   const files = [
     ...siteTemplateFiles(preset, templateVariables(options, targetDirectory), {
-      cloudflareWorkers: deployment.type === "cloudflare-workers"
+      cloudflareWorkers: deployment.type === "cloudflare-workers",
+      utilities: options.utilities
     }),
     ...deploymentTemplateOrConfig(deployment, targetDirectory)
   ];
@@ -3123,11 +3208,16 @@ function isNotFoundError(error) {
 export {
   GITHUB_ACTIONS_SECRETS,
   SCAFFOLD_DEFAULT_PRESET,
+  SCAFFOLD_DEFAULT_UTILITIES,
   SCAFFOLD_PRESETS,
+  SCAFFOLD_UTILITIES,
+  SCAFFOLD_UTILITY_NAMES,
   ScaffoldSiteError,
   deploymentWorkflow,
   formatScaffoldNextSteps,
   isScaffoldPresetName,
+  isScaffoldUtilityName,
+  parseScaffoldUtilities,
   scaffoldDeploymentFromFlags,
   scaffoldRiebeckiteSite,
   wranglerConfigForDirectory

package/dist/src/scaffold/options.d.ts

@@ -1,4 +1,5 @@
 import type { ScaffoldPresetName } from "./presets.js";
+import type { ScaffoldUtilityName } from "./utilities.js";
 export type ScaffoldSiteMetadata = {
     readonly title?: string;
     readonly description?: string;
@@ -25,6 +26,7 @@ export type ScaffoldSiteOptions = {
     readonly name?: string;
     readonly site?: ScaffoldSiteMetadata;
     readonly preset?: ScaffoldPresetName;
+    readonly utilities?: readonly ScaffoldUtilityName[];
     readonly deployment?: ScaffoldDeployment;
     readonly overwrite?: boolean;
 };

package/dist/src/scaffold/templates.d.ts

@@ -1,4 +1,5 @@
 import { type ScaffoldOptionContext, type ScaffoldOptions, type ScaffoldPreset } from "./presets.js";
+import { type ScaffoldUtilityName } from "./utilities.js";
 export type SiteTemplateVariables = {
     readonly name: string;
     readonly title: string;
@@ -9,6 +10,7 @@ export type SiteTemplateVariables = {
 };
 export type SiteTemplateOptions = {
     readonly cloudflareWorkers?: boolean;
+    readonly utilities?: readonly ScaffoldUtilityName[];
 };
 export type SiteTemplateFile = {
     readonly path: string;

package/dist/src/scaffold/utilities.d.ts

@@ -0,0 +1,14 @@
+import type { SiteTemplateFile } from "./templates.js";
+export declare const SCAFFOLD_UTILITY_NAMES: readonly ["editorconfig", "gitattributes", "biome", "npmrc", "vscode"];
+export type ScaffoldUtilityName = (typeof SCAFFOLD_UTILITY_NAMES)[number];
+export type ScaffoldUtilitySummary = {
+    readonly name: ScaffoldUtilityName;
+    readonly label: string;
+    readonly description: string;
+};
+export declare const SCAFFOLD_UTILITIES: readonly ScaffoldUtilitySummary[];
+export declare const SCAFFOLD_DEFAULT_UTILITIES: readonly ScaffoldUtilityName[];
+export declare const SCAFFOLD_NO_UTILITIES = "none";
+export declare function isScaffoldUtilityName(value: string): value is ScaffoldUtilityName;
+export declare function parseScaffoldUtilities(value: string): readonly ScaffoldUtilityName[];
+export declare function utilityTemplateFiles(utilities: readonly ScaffoldUtilityName[]): readonly SiteTemplateFile[];

package/dist/src/scaffold/version.d.ts

@@ -1 +1 @@
-export declare const RIEBECKITE_VERSION = "^0.0.18";
+export declare const RIEBECKITE_VERSION = "^0.0.19";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-riebeckite",
-  "version": "0.0.18",
+  "version": "0.0.19",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./dist/src/index.js",
@@ -39,7 +39,7 @@
   },
   "devDependencies": {
     "esbuild": "^0.28.2",
-    "@riebeckite/test": "0.0.18"
+    "@riebeckite/test": "0.0.19"
   },
   "repository": {
     "type": "git",

package/templates/scaffold/presets/minimal/app/components/article.tsx

@@ -1,65 +1,47 @@
-import type { PostContent } from "@riebeckite/core";
-import { Article, ArticleContent, ArticleLayout } from "@riebeckite/honox/ui";
+import type { ContentBodySlots, PostContent } from "@riebeckite/core";
+import {
+  Article,
+  ArticleBody,
+  ArticleContent,
+  ArticleLayout,
+  ContentSlot,
+} from "@riebeckite/honox/ui";
 
 export function SiteArticle({
   post,
   bodySlots,
   asideContent,
-  afterContent,
-  footerContent,
 }: {
   post: PostContent;
-  bodySlots?: Readonly<Record<string, string>>;
+  bodySlots?: ContentBodySlots;
   asideContent?: unknown;
-  afterContent?: unknown;
-  footerContent?: unknown;
 }) {
   return (
     <Article class="site-article">
       <ArticleLayout>
         {asideContent}
-        {bodySlots?.["article.aside"] ? (
-          <div
-            class="site-article__aside"
-            dangerouslySetInnerHTML={{ __html: bodySlots["article.aside"] }}
-          />
-        ) : null}
+
+        <ContentSlot
+          slots={bodySlots}
+          name="article.aside"
+          class="site-article__aside"
+        />
+
         <ArticleContent>
-          {bodySlots?.["article.header"] ? (
-            <div
-              class="site-article__header"
-              dangerouslySetInnerHTML={{ __html: bodySlots["article.header"] }}
-            />
-          ) : null}
-          {bodySlots?.["article.metadata"] ? (
-            <div
-              class="site-article__metadata"
-              dangerouslySetInnerHTML={{ __html: bodySlots["article.metadata"] }}
-            />
-          ) : null}
-          {bodySlots?.["article.before-content"] ? (
-            <div
-              class="site-article__before-content"
-              dangerouslySetInnerHTML={{ __html: bodySlots["article.before-content"] }}
-            />
-          ) : null}
-          <div dangerouslySetInnerHTML={{ __html: post.html ?? "" }} />
-          {afterContent}
-          {bodySlots?.["article.after-content"] ? (
-            <div
-              class="site-article__after-content"
-              dangerouslySetInnerHTML={{ __html: bodySlots["article.after-content"] }}
-            />
-          ) : null}
+          <ContentSlot slots={bodySlots} name="article.header" />
+          <ContentSlot slots={bodySlots} name="article.metadata" />
+          <ContentSlot slots={bodySlots} name="article.before-content" />
+
+          <ArticleBody html={post.html ?? ""} />
+
+          <ContentSlot slots={bodySlots} name="article.after-content" />
         </ArticleContent>
-        {bodySlots?.["article.footer"] || footerContent ? (
-          <div class="site-article__footer">
-            {bodySlots?.["article.footer"] ? (
-              <div dangerouslySetInnerHTML={{ __html: bodySlots["article.footer"] }} />
-            ) : null}
-            {footerContent}
-          </div>
-        ) : null}
+
+        <ContentSlot
+          slots={bodySlots}
+          name="article.footer"
+          class="site-article__footer"
+        />
       </ArticleLayout>
     </Article>
   );

package/templates/scaffold/presets/minimal/app/style.css

@@ -32,10 +32,11 @@ body {
   display: grid;
   grid-template-columns: minmax(0, var(--rb-layout-article-max, 48rem));
   justify-content: center;
-  gap: var(--rb-layout-gap, 2rem);
+  column-gap: var(--rb-layout-gap, 2rem);
 }
 
-.rb-article-body {
+.rb-article-body,
+.site-article__footer {
   min-width: 0;
   padding-inline: var(--rb-space-2, 1rem);
 }
@@ -44,10 +45,6 @@ body {
   display: none;
 }
 
-.site-article__footer {
-  min-width: 0;
-}
-
 @media (min-width: 88rem) {
   :is(:root, .rb-theme-root)[data-article-layout="article"] .rb-article-layout {
     grid-template-columns: minmax(0, var(--rb-layout-article-max, 48rem));

package/templates/scaffold/presets/showcase/app/components/article.tsx

@@ -1,5 +1,13 @@
-import type { PostContent } from "@riebeckite/core";
-import { Article, ArticleContent, ArticleLayout } from "@riebeckite/honox/ui";
+import type { ContentBodySlots, PostContent } from "@riebeckite/core";
+import {
+  Article,
+  ArticleBody,
+  ArticleContent,
+  ArticleFooter,
+  ArticleLayout,
+  ContentSlot,
+  hasSlot,
+} from "@riebeckite/honox/ui";
 
 export function SiteArticle({
   post,
@@ -9,7 +17,7 @@ export function SiteArticle({
   footerContent,
 }: {
   post: PostContent;
-  bodySlots?: Readonly<Record<string, string>>;
+  bodySlots?: ContentBodySlots;
   asideContent?: unknown;
   afterContent?: unknown;
   footerContent?: unknown;
@@ -18,47 +26,30 @@ export function SiteArticle({
     <Article class="site-article">
       <ArticleLayout>
         {asideContent}
-        {bodySlots?.["article.aside"] ? (
-          <div
-            class="site-article__aside"
-            dangerouslySetInnerHTML={{ __html: bodySlots["article.aside"] }}
-          />
-        ) : null}
+
+        <ContentSlot
+          slots={bodySlots}
+          name="article.aside"
+          class="site-article__aside"
+        />
+
         <ArticleContent>
-          {bodySlots?.["article.header"] ? (
-            <div
-              class="site-article__header"
-              dangerouslySetInnerHTML={{ __html: bodySlots["article.header"] }}
-            />
-          ) : null}
-          {bodySlots?.["article.metadata"] ? (
-            <div
-              class="site-article__metadata"
-              dangerouslySetInnerHTML={{ __html: bodySlots["article.metadata"] }}
-            />
-          ) : null}
-          {bodySlots?.["article.before-content"] ? (
-            <div
-              class="site-article__before-content"
-              dangerouslySetInnerHTML={{ __html: bodySlots["article.before-content"] }}
-            />
-          ) : null}
-          <div dangerouslySetInnerHTML={{ __html: post.html ?? "" }} />
+          <ContentSlot slots={bodySlots} name="article.header" />
+          <ContentSlot slots={bodySlots} name="article.metadata" />
+          <ContentSlot slots={bodySlots} name="article.before-content" />
+
+          <ArticleBody html={post.html ?? ""} />
+
           {afterContent}
-          {bodySlots?.["article.after-content"] ? (
-            <div
-              class="site-article__after-content"
-              dangerouslySetInnerHTML={{ __html: bodySlots["article.after-content"] }}
-            />
-          ) : null}
+
+          <ContentSlot slots={bodySlots} name="article.after-content" />
         </ArticleContent>
-        {bodySlots?.["article.footer"] || footerContent ? (
-          <div class="site-article__footer">
-            {bodySlots?.["article.footer"] ? (
-              <div dangerouslySetInnerHTML={{ __html: bodySlots["article.footer"] }} />
-            ) : null}
+
+        {hasSlot(bodySlots, "article.footer") || footerContent ? (
+          <ArticleFooter class="site-article__footer">
+            <ContentSlot slots={bodySlots} name="article.footer" />
             {footerContent}
-          </div>
+          </ArticleFooter>
         ) : null}
       </ArticleLayout>
     </Article>

package/templates/scaffold/presets/showcase/app/style.css

@@ -175,10 +175,11 @@ body {
   display: grid;
   grid-template-columns: minmax(0, var(--rb-layout-article-max, 48rem));
   justify-content: center;
-  gap: var(--rb-layout-gap, 2rem);
+  column-gap: var(--rb-layout-gap, 2rem);
 }
 
-.rb-article-body {
+.rb-article-body,
+.site-article__footer {
   min-width: 0;
   padding-inline: var(--rb-space-2, 1rem);
 }
@@ -187,10 +188,6 @@ body {
   display: none;
 }
 
-.site-article__footer {
-  min-width: 0;
-}
-
 @media (min-width: 88rem) {
   :is(:root, .rb-theme-root)[data-article-layout="article"] .rb-article-layout {
     grid-template-columns: minmax(0, var(--rb-layout-article-max, 48rem));

package/templates/scaffold/presets/starter/app/components/article.tsx

@@ -1,5 +1,13 @@
-import type { PostContent } from "@riebeckite/core";
-import { Article, ArticleContent, ArticleLayout } from "@riebeckite/honox/ui";
+import type { ContentBodySlots, PostContent } from "@riebeckite/core";
+import {
+  Article,
+  ArticleBody,
+  ArticleContent,
+  ArticleFooter,
+  ArticleLayout,
+  ContentSlot,
+  hasSlot,
+} from "@riebeckite/honox/ui";
 
 export function SiteArticle({
   post,
@@ -9,7 +17,7 @@ export function SiteArticle({
   footerContent,
 }: {
   post: PostContent;
-  bodySlots?: Readonly<Record<string, string>>;
+  bodySlots?: ContentBodySlots;
   asideContent?: unknown;
   afterContent?: unknown;
   footerContent?: unknown;
@@ -18,47 +26,30 @@ export function SiteArticle({
     <Article class="site-article">
       <ArticleLayout>
         {asideContent}
-        {bodySlots?.["article.aside"] ? (
-          <div
-            class="site-article__aside"
-            dangerouslySetInnerHTML={{ __html: bodySlots["article.aside"] }}
-          />
-        ) : null}
+
+        <ContentSlot
+          slots={bodySlots}
+          name="article.aside"
+          class="site-article__aside"
+        />
+
         <ArticleContent>
-          {bodySlots?.["article.header"] ? (
-            <div
-              class="site-article__header"
-              dangerouslySetInnerHTML={{ __html: bodySlots["article.header"] }}
-            />
-          ) : null}
-          {bodySlots?.["article.metadata"] ? (
-            <div
-              class="site-article__metadata"
-              dangerouslySetInnerHTML={{ __html: bodySlots["article.metadata"] }}
-            />
-          ) : null}
-          {bodySlots?.["article.before-content"] ? (
-            <div
-              class="site-article__before-content"
-              dangerouslySetInnerHTML={{ __html: bodySlots["article.before-content"] }}
-            />
-          ) : null}
-          <div dangerouslySetInnerHTML={{ __html: post.html ?? "" }} />
+          <ContentSlot slots={bodySlots} name="article.header" />
+          <ContentSlot slots={bodySlots} name="article.metadata" />
+          <ContentSlot slots={bodySlots} name="article.before-content" />
+
+          <ArticleBody html={post.html ?? ""} />
+
           {afterContent}
-          {bodySlots?.["article.after-content"] ? (
-            <div
-              class="site-article__after-content"
-              dangerouslySetInnerHTML={{ __html: bodySlots["article.after-content"] }}
-            />
-          ) : null}
+
+          <ContentSlot slots={bodySlots} name="article.after-content" />
         </ArticleContent>
-        {bodySlots?.["article.footer"] || footerContent ? (
-          <div class="site-article__footer">
-            {bodySlots?.["article.footer"] ? (
-              <div dangerouslySetInnerHTML={{ __html: bodySlots["article.footer"] }} />
-            ) : null}
+
+        {hasSlot(bodySlots, "article.footer") || footerContent ? (
+          <ArticleFooter class="site-article__footer">
+            <ContentSlot slots={bodySlots} name="article.footer" />
             {footerContent}
-          </div>
+          </ArticleFooter>
         ) : null}
       </ArticleLayout>
     </Article>

package/templates/scaffold/presets/starter/app/style.css

@@ -175,10 +175,11 @@ body {
   display: grid;
   grid-template-columns: minmax(0, var(--rb-layout-article-max, 48rem));
   justify-content: center;
-  gap: var(--rb-layout-gap, 2rem);
+  column-gap: var(--rb-layout-gap, 2rem);
 }
 
-.rb-article-body {
+.rb-article-body,
+.site-article__footer {
   min-width: 0;
   padding-inline: var(--rb-space-2, 1rem);
 }
@@ -187,10 +188,6 @@ body {
   display: none;
 }
 
-.site-article__footer {
-  min-width: 0;
-}
-
 @media (min-width: 88rem) {
   :is(:root, .rb-theme-root)[data-article-layout="article"] .rb-article-layout {
     grid-template-columns: minmax(0, var(--rb-layout-article-max, 48rem));

package/templates/scaffold/utilities/biome/biome.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.4.16/schema.json",
+  "root": false,
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineWidth": 80
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true
+    }
+  },
+  "javascript": {
+    "formatter": {
+      "quoteStyle": "double",
+      "semicolons": "always"
+    }
+  }
+}

package/templates/scaffold/utilities/editorconfig/.editorconfig

@@ -0,0 +1,12 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+indent_style = space
+indent_size = 2
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false

package/templates/scaffold/utilities/gitattributes/.gitattributes

@@ -0,0 +1,5 @@
+* text=auto eol=lf
+
+*.png binary
+*.ico binary
+*.pdf binary

package/templates/scaffold/utilities/vscode/.vscode/settings.json

@@ -0,0 +1,6 @@
+{
+  "editor.formatOnSave": true,
+  "files.eol": "\n",
+  "files.insertFinalNewline": true,
+  "files.trimTrailingWhitespace": true
+}