@mnaoumov/create-obsidian-plugin 1.0.1 → 1.1.0

package/dist/main.js

@@ -5,7 +5,7 @@ import {
   cancel as cancel3,
   confirm,
   intro,
-  log as log4,
+  log as log5,
   note,
   outro,
   select as select2,
@@ -15,12 +15,12 @@ import {
 import { spawn } from "node:child_process";
 import {
   chmodSync,
-  existsSync as existsSync6,
-  readFileSync as readFileSync6,
+  existsSync as existsSync8,
+  readFileSync as readFileSync8,
   writeFileSync as writeFileSync2
 } from "node:fs";
 import {
-  join as join5,
+  join as join8,
   resolve as resolvePath
 } from "node:path";
 import { compare } from "semver";
@@ -191,38 +191,38 @@ async function promptApiSubset(savedValue) {
   return promptFeature({ defaultOption: new Official(), message: "Obsidian API subset", options: API_SUBSET_OPTIONS, savedValue });
 }
 
-// src/features/preset/is-dev-utils-preset.ts
-var DEV_UTILS_PRESETS = /* @__PURE__ */ new Set(["demo", "enhanced"]);
-function isDevUtilsPreset(preset) {
-  return DEV_UTILS_PRESETS.has(preset);
-}
-
 // src/features/bundler/esbuild.ts
 var Esbuild = class extends FeatureOption {
   constructor() {
     super({ promptHint: "Fast and simple (recommended)", promptLabel: "esbuild", settingValue: "esbuild" });
   }
-  configure(builder, answers) {
+  configure(builder) {
     builder.addPackage("esbuild");
-    if (isDevUtilsPreset(answers.preset)) {
-      builder.addFiles(["scripts/esbuild-plugins.ts"]);
-    }
   }
 };
 
+// src/features/preset/is-framework-preset.ts
+var FRAMEWORK_PRESETS = /* @__PURE__ */ new Set(["all-in-one", "demo", "docs-showcase"]);
+function isFrameworkPreset(preset) {
+  return FRAMEWORK_PRESETS.has(preset);
+}
+
 // src/features/bundler/parcel.ts
 var Parcel = class extends FeatureOption {
   constructor() {
     super({ promptHint: "Zero-config bundler", promptLabel: "Parcel", settingValue: "parcel" });
   }
-  configure(builder) {
+  configure(builder, answers) {
+    if (isFrameworkPreset(answers.preset)) {
+      builder.addPackage("@parcel/core").addPackage("@parcel/config-default").addDepcheckIgnore("@parcel/config-default", "extended by name by the `.parcelrc` obsidian-dev-toolkit writes.").addPackage("@parcel/plugin").addDepcheckIgnore("@parcel/plugin", "the base of the parcel plugins obsidian-dev-toolkit registers; nothing here imports it.").addPartial("parcel-adapter");
+      return;
+    }
     builder.addPackage("parcel").addDepcheckIgnore("parcel", "run as a CLI by the build script.").addPackage("@parcel/config-default").addDepcheckIgnore("@parcel/config-default", "extended by name in `.parcelrc`.").addPackage("@parcel/plugin").addFiles([
       ".parcelrc",
       "parcel-namer-obsidian.cjs",
       "parcel-resolver-obsidian.cjs",
       "parcel-transformer-inline-imports.cjs"
-    ]);
-    builder.addPartial("cli-bundler");
+    ]).addPartial("parcel-targets").addPartial("cli-bundler");
   }
 };
 
@@ -231,12 +231,16 @@ var Rollup = class extends FeatureOption {
   constructor() {
     super({ promptHint: "Flexible with plugin ecosystem", promptLabel: "Rollup", settingValue: "rollup" });
   }
-  configure(builder) {
-    builder.addPackage("@rollup/plugin-commonjs").addPackage("@rollup/plugin-node-resolve").addPackage("@rollup/plugin-typescript").addPackage("@rollup/plugin-terser").addPackage("rollup").addFiles([
+  configure(builder, answers) {
+    builder.addPackage("@rollup/plugin-commonjs").addPackage("@rollup/plugin-node-resolve").addPackage("rollup").addFiles([
       "rollup.config.mjs",
       "scripts/rollup.config.ts"
     ]);
-    builder.addPartial("cli-bundler");
+    if (isFrameworkPreset(answers.preset)) {
+      builder.addPackage("esbuild").addDepcheckIgnore("esbuild", "the peer dependency `rollup-plugin-esbuild` runs; nothing imports it.").addPackage("rollup-plugin-esbuild").addPartial("adapter-cli");
+      return;
+    }
+    builder.addPackage("@rollup/plugin-typescript").addPackage("@rollup/plugin-terser").addPartial("cli-bundler");
   }
 };
 
@@ -245,12 +249,12 @@ var Vite = class extends FeatureOption {
   constructor() {
     super({ promptHint: "Modern dev server with HMR", promptLabel: "Vite", settingValue: "vite" });
   }
-  configure(builder) {
+  configure(builder, answers) {
     builder.addPackage("vite").addFiles([
       "vite.config.ts",
       "scripts/vite.config.ts"
     ]);
-    builder.addPartial("cli-bundler");
+    builder.addPartial(isFrameworkPreset(answers.preset) ? "adapter-cli" : "cli-bundler");
   }
 };
 
@@ -259,12 +263,16 @@ var Webpack = class extends FeatureOption {
   constructor() {
     super({ promptHint: "Mature bundler with broad plugin support", promptLabel: "Webpack", settingValue: "webpack" });
   }
-  configure(builder) {
-    builder.addPackage("webpack").addPackage("webpack-cli").addDepcheckIgnore("webpack-cli", "what `npx webpack` in the build script runs.").addPackage("terser-webpack-plugin").addPackage("ts-loader").addDepcheckIgnore("ts-loader", "named as a loader string in `scripts/webpack.config.ts`.").addFiles([
+  configure(builder, answers) {
+    builder.addPackage("webpack").addPackage("webpack-cli").addDepcheckIgnore("webpack-cli", "what the build script runs as the `webpack` command.").addFiles([
       "webpack.config.ts",
       "scripts/webpack.config.ts"
     ]);
-    builder.addPartial("cli-bundler");
+    if (isFrameworkPreset(answers.preset)) {
+      builder.addPackage("esbuild-loader").addDepcheckIgnore("esbuild-loader", "named as a loader string in `scripts/webpack.config.ts`.").addPartial("adapter-cli");
+      return;
+    }
+    builder.addPackage("terser-webpack-plugin").addPackage("ts-loader").addDepcheckIgnore("ts-loader", "named as a loader string in `scripts/webpack.config.ts`.").addPartial("cli-bundler");
   }
 };
 
@@ -275,31 +283,40 @@ async function promptBundler(savedValue) {
 }
 
 // src/features/git-hooks.ts
+var INITIAL_COMMIT_MESSAGE = "chore: initial commit from create-obsidian-plugin";
 function addHusky(builder) {
   builder.addPackage("husky").addDepcheckIgnore("husky", "run as a CLI by `scripts/prepare.ts`; the hooks in `.husky/` are its output.").addScript("prepare").addFiles(["scripts/prepare.ts"]);
 }
-function addStagedFilesHook(builder) {
+function addStagedFilesHook(builder, preset) {
   addHusky(builder);
+  builder.addPartial(usesToolkitNanoStagedConfig(preset) ? "toolkit-nano-staged" : "inline-nano-staged");
   builder.addPackage("nano-staged").addDepcheckIgnore("nano-staged", "`.husky/pre-commit` runs it; configured by `scripts/nano-staged-config.ts`.").addFiles([
     ".husky/pre-commit",
     ".nano-staged.mjs",
     "scripts/nano-staged-config.ts"
   ]);
 }
+function usesToolkitNanoStagedConfig(preset) {
+  return isFrameworkPreset(preset);
+}
 
 // src/features/commit-linting/conventional-commits.ts
 var ConventionalCommits = class extends FeatureOption {
   constructor() {
     super({ promptHint: "commitlint + a husky commit-msg hook", promptLabel: "Conventional Commits", settingValue: "conventional-commits" });
   }
-  configure(builder) {
+  configure(builder, answers) {
     addHusky(builder);
-    builder.addPackage("@commitlint/cli").addDepcheckIgnore("@commitlint/cli", "`.husky/commit-msg` runs it as the `commitlint` binary.").addPackage("@commitlint/config-conventional").addDepcheckIgnore("@commitlint/config-conventional", "extended by name (a string in the `extends` of `scripts/commitlint-config.ts`), never imported.").addPackage("@commitlint/types").addPackage("czg").addDepcheckIgnore("czg", "run as a CLI by `scripts/commit.ts`.").addScript("commit").addFiles([
+    builder.addPackage("@commitlint/cli").addDepcheckIgnore("@commitlint/cli", "`.husky/commit-msg` runs it as the `commitlint` binary.").addPackage("czg").addDepcheckIgnore("czg", "run as a CLI by `scripts/commit.ts`.").addScript("commit").addFiles([
       "commitlint.config.ts",
       "scripts/commit.ts",
       "scripts/commitlint-config.ts",
       ".husky/commit-msg"
     ]);
+    if (isFrameworkPreset(answers.preset)) {
+      return;
+    }
+    builder.addPackage("@commitlint/config-conventional").addDepcheckIgnore("@commitlint/config-conventional", "extended by name (a string in the `extends` of `scripts/commitlint-config.ts`), never imported.").addPackage("@commitlint/types");
   }
 };
 
@@ -319,14 +336,24 @@ async function promptCommitLinting(savedValue) {
 // src/features/coverage-badge/coverage-badge.ts
 var CoverageBadge = class extends FeatureOption {
   constructor() {
-    super({ promptHint: 'A "coverage: 100%" README badge', promptLabel: "Coverage badge", settingValue: "coverage-badge" });
+    super({ promptHint: "A coverage README badge, measured by CI where the project has one", promptLabel: "Coverage badge", settingValue: "coverage-badge" });
   }
   configure(builder, answers) {
-    builder.addBadge(
-      `[![Coverage: 100%](https://img.shields.io/badge/coverage-100%25-brightgreen)](https://github.com/${answers.authorGitHubName}/obsidian-${answers.pluginId})`
+    const repoUrl = `https://github.com/${answers.authorGitHubName}/obsidian-${answers.pluginId}`;
+    if (!isMeasured(answers)) {
+      builder.addBadge(`[![Coverage: 100%](https://img.shields.io/badge/coverage-100%25-brightgreen)](${repoUrl})`);
+      return;
+    }
+    builder.addPartial("measured-coverage-badge").addBadge(
+      `[![Coverage](https://raw.githubusercontent.com/${answers.authorGitHubName}/obsidian-${answers.pluginId}/badges/coverage.svg)](${repoUrl}/actions/workflows/ci.yml)`
     );
   }
 };
+var CI_ANSWERS = /* @__PURE__ */ new Set(["ci", "ci-and-release"]);
+var MEASURING_TEST_RUNNERS = /* @__PURE__ */ new Set(["jest", "vitest"]);
+function isMeasured(answers) {
+  return isFrameworkPreset(answers.preset) && CI_ANSWERS.has(answers.gitHubActions) && MEASURING_TEST_RUNNERS.has(answers.testRunner);
+}
 
 // src/features/coverage-badge/none.ts
 var None2 = class extends FeatureOption {
@@ -366,12 +393,16 @@ var WdioObsidian = class extends FeatureOption {
   constructor() {
     super({ promptHint: "WebdriverIO service for Obsidian, multi-version & CI/CD", promptLabel: "wdio-obsidian", settingValue: "wdio-obsidian" });
   }
-  configure(builder) {
-    builder.addPackage("@wdio/cli").addDepcheckIgnore("@wdio/cli", "run as the `wdio` CLI by `scripts/test-e2e.ts`.").addPackage("@wdio/globals").addPackage("@wdio/mocha-framework").addPackage("expect-webdriverio").addPackage("wdio-obsidian-service").addScript("test:e2e").addFiles([
-      "wdio.conf.ts",
+  configure(builder, answers) {
+    builder.addPackage("@wdio/cli").addDepcheckIgnore("@wdio/cli", "run as the `wdio` CLI by `scripts/test-e2e.ts`.").addPackage("@wdio/globals").addPackage("@wdio/local-runner").addDepcheckIgnore("@wdio/local-runner", "loaded by name by wdio for the config's `runner: 'local'`.").addPackage("@wdio/mocha-framework").addPackage("expect-webdriverio").addPackage("wdio-obsidian-service").addScript("test:e2e").addFiles([
       "e2e/sample.spec.ts",
       "scripts/test-e2e.ts"
     ]).addPartial("has-e2e");
+    if (isFrameworkPreset(answers.preset)) {
+      builder.addPackage("wdio-obsidian-reporter").addDepcheckIgnore("wdio-obsidian-reporter", "loaded by name by wdio for the `obsidian` reporter `defineWdioObsidianConfig` names.").addFiles(["wdio.conf.mts"]);
+      return;
+    }
+    builder.addFiles(["wdio.conf.ts"]);
   }
 };
 
@@ -452,14 +483,16 @@ var Prettier = class extends FeatureOption {
   constructor() {
     super({ promptHint: "Opinionated, widely adopted", promptLabel: "Prettier", settingValue: "prettier" });
   }
-  configure(builder) {
+  configure(builder, answers) {
     builder.addLintStagedCommand("*.{ts,tsx,mts}", "prettier --write").addPackage("prettier").addScript("format").addScript("format:check").addFiles([
       ".prettierignore",
       "prettier.config.mjs",
-      "scripts/prettier.config.ts",
       "scripts/format.ts",
       "scripts/format-check.ts"
     ]);
+    if (!isFrameworkPreset(answers.preset)) {
+      builder.addFiles(["scripts/prettier.config.ts"]);
+    }
   }
 };
 
@@ -806,6 +839,11 @@ var None9 = class extends FeatureOption {
   constructor() {
     super({ promptHint: "No hot reload support", promptLabel: "(none)", settingValue: "none" });
   }
+  configure(builder, answers) {
+    if (isFrameworkPreset(answers.preset)) {
+      builder.addBuildOption("reload", "false");
+    }
+  }
 };
 
 // src/features/hot-reload/obsidian-cli.ts
@@ -813,6 +851,11 @@ var ObsidianCli = class extends FeatureOption {
   constructor() {
     super({ promptHint: "Reloads via obsidian plugin:reload CLI command", promptLabel: "Obsidian CLI", settingValue: "obsidian-cli" });
   }
+  configure(builder, answers) {
+    if (isFrameworkPreset(answers.preset)) {
+      builder.addBuildOption("reload", "'obsidian-cli'");
+    }
+  }
 };
 
 // src/features/hot-reload/index.ts
@@ -889,7 +932,7 @@ var Eslint = class extends FeatureOption {
       "scripts/lint.ts",
       "scripts/lint-fix.ts"
     ]);
-    if (isDevUtilsPreset(answers.preset)) {
+    if (isFrameworkPreset(answers.preset)) {
       builder.addDepcheckIgnore("typescript-eslint", "imported by nothing here -- the shared config brings its own -- but the `typescript` pin's check reads its `package.json` for the peer range.").addFiles(["scripts/eslint-config.ts"]);
       return;
     }
@@ -918,7 +961,7 @@ var Markdownlint = class extends FeatureOption {
   configure(builder, answers) {
     builder.addLintStagedCommand("*.md", "markdownlint-cli2 --fix").addPackage("markdownlint-cli2").addDepcheckIgnore("markdownlint-cli2", "run as a CLI by the `lint:md` scripts, configured by `.markdownlint-cli2.mjs`.").addPackage("linkinator").addDepcheckIgnore("linkinator", "run as a CLI by the `lint:md` scripts.").addScript("lint:md").addScript("lint:md:fix").addFiles([
       // `markdownlint-cli2` only discovers a config named `.markdownlint-cli2.{jsonc,yaml,cjs,mjs}`, and
-      // So does obsidian-dev-utils' runner -- which copies its own `.mjs` in when it finds none, pointing
+      // So does the toolkit's runner -- which copies its own `.mjs` in when it finds none, pointing
       // At a `scripts/markdownlint-cli2-config.ts` that then has to exist. Hence this shape rather than a
       // Single `.mts` that nothing reads.
       ".markdownlint-cli2.mjs",
@@ -929,7 +972,7 @@ var Markdownlint = class extends FeatureOption {
       // Repository, which 404 until the user pushes it.
       "linkinator.config.json"
     ]);
-    if (isDevUtilsPreset(answers.preset)) {
+    if (isFrameworkPreset(answers.preset)) {
       return;
     }
     builder.addPackage("markdownlint").addPackage("markdownlint-rule-relative-links");
@@ -1032,17 +1075,17 @@ var DEMO_VAULT_TEMPLATE_FILES = [
   "demo-vault/_assets/CodeScriptToolkit/startup.ts"
 ];
 
-// src/features/preset/demo.ts
-var Demo = class extends FeatureOption {
+// src/features/preset/all-in-one.ts
+var AllInOne = class extends FeatureOption {
   constructor() {
-    super({ promptHint: "All features enabled for demonstration", promptLabel: "Demo", settingValue: "demo" });
+    super({
+      promptHint: "Recommended. The author's framework: @mnaoumov/obsidian-lib, a library of ready-made helpers for settings, commands, modals, notices, file and link handling, and more, plus the @mnaoumov toolkits for building, linting, testing and releases",
+      promptLabel: "All-in-one Framework",
+      settingValue: "all-in-one"
+    });
   }
-  configure(builder) {
-    builder.addPackage("@tsconfig/strictest").addPackage("moment").addDepcheckIgnore("moment", "imported through `obsidian` rather than directly, and the typings of `obsidian` resolve it by name.").addPackage("obsidian-dev-utils").addPackage("obsidian-integration-testing").addScript("dev").addScript("build").addScript("build:clean").addScript("build:compile").addScript("find-overexposed").addScript("find-overexposed:fix").addScript("version").addScript("gate").addFiles([
-      // Not gated on the gitHubActions answer, and deliberately so: this attests the assets of a
-      // Published RELEASE, and the release flow is the preset's, not CI's. Every plugin compared here
-      // Ships this workflow -- they have no ci.yml at all.
-      ".github/workflows/attest-release-assets.yml",
+  configure(builder, answers) {
+    builder.addPackage("@tsconfig/strictest").addPackage("@mnaoumov/obsidian-lib").addPackage("@mnaoumov/obsidian-dev-toolkit").addPackage("@mnaoumov/typescript-dev-toolkit").addPackage("obsidian-integration-testing").addScript("dev").addScript("build").addScript("build:clean").addScript("build:compile").addScript("find-overexposed").addScript("find-overexposed:fix").addScript("version").addScript("gate").addFiles([
       // Not gated on the answers either: the shared ESLint config's `obsidianmd/validate-license` compares
       // The LICENSE year with the current one, so without this bump every project turns red on 1 January.
       ".github/workflows/update-license-year.yml",
@@ -1054,28 +1097,24 @@ var Demo = class extends FeatureOption {
       "scripts/dev.ts",
       "scripts/gate.ts",
       "scripts/version.ts",
-      "src/modals/sample-form-modal.ts",
-      "src/modals/sample-suggest-modal.ts",
       "src/plugin-settings.ts",
       "src/plugin-settings-component.ts",
       "src/plugin-settings-tab.ts",
-      "src/views/sample-view.ts",
       ...DEMO_VAULT_TEMPLATE_FILES
-    ]).addPartial("dev-utils");
+    ]).addPartial("framework");
+    if (answers.gitHubActions !== "ci-and-release") {
+      builder.addFiles([".github/workflows/attest-release-assets.yml"]);
+    }
   }
 };
 
-// src/features/preset/enhanced.ts
-var Enhanced = class extends FeatureOption {
+// src/features/preset/demo.ts
+var Demo = class extends FeatureOption {
   constructor() {
-    super({ promptHint: "Recommended. Uses obsidian-dev-utils for settings, linting, and more", promptLabel: "Enhanced", settingValue: "enhanced" });
+    super({ promptHint: "All features enabled for demonstration", promptLabel: "Demo", settingValue: "demo" });
   }
-  configure(builder) {
-    builder.addPackage("@tsconfig/strictest").addPackage("obsidian-dev-utils").addPackage("obsidian-integration-testing").addScript("dev").addScript("build").addScript("build:clean").addScript("build:compile").addScript("find-overexposed").addScript("find-overexposed:fix").addScript("version").addScript("gate").addFiles([
-      // Not gated on the gitHubActions answer, and deliberately so: this attests the assets of a
-      // Published RELEASE, and the release flow is the preset's, not CI's. Every plugin compared here
-      // Ships this workflow -- they have no ci.yml at all.
-      ".github/workflows/attest-release-assets.yml",
+  configure(builder, answers) {
+    builder.addPackage("@tsconfig/strictest").addPackage("moment").addDepcheckIgnore("moment", "imported through `obsidian` rather than directly, and the typings of `obsidian` resolve it by name.").addPackage("@mnaoumov/obsidian-lib").addPackage("@mnaoumov/typescript-lib").addPackage("@mnaoumov/obsidian-dev-toolkit").addPackage("@mnaoumov/typescript-dev-toolkit").addPackage("obsidian-integration-testing").addScript("dev").addScript("build").addScript("build:clean").addScript("build:compile").addScript("find-overexposed").addScript("find-overexposed:fix").addScript("version").addScript("gate").addFiles([
       // Not gated on the answers either: the shared ESLint config's `obsidianmd/validate-license` compares
       // The LICENSE year with the current one, so without this bump every project turns red on 1 January.
       ".github/workflows/update-license-year.yml",
@@ -1087,18 +1126,70 @@ var Enhanced = class extends FeatureOption {
       "scripts/dev.ts",
       "scripts/gate.ts",
       "scripts/version.ts",
+      "src/modals/sample-form-modal.ts",
+      "src/modals/sample-suggest-modal.ts",
       "src/plugin-settings.ts",
       "src/plugin-settings-component.ts",
       "src/plugin-settings-tab.ts",
+      "src/views/sample-view.ts",
       ...DEMO_VAULT_TEMPLATE_FILES
-    ]).addPartial("dev-utils");
+    ]).addPartial("framework");
+    if (answers.gitHubActions !== "ci-and-release") {
+      builder.addFiles([".github/workflows/attest-release-assets.yml"]);
+    }
+  }
+};
+
+// src/features/preset/docs-showcase.ts
+var DOCS_SHOWCASE_PRESET = "docs-showcase";
+var DocsShowcase = class extends FeatureOption {
+  constructor() {
+    super({
+      promptHint: "The All-in-one Framework project, plus every code block of the Obsidian developer docs as a command you can run",
+      promptLabel: "Developer docs showcase",
+      settingValue: DOCS_SHOWCASE_PRESET
+    });
+  }
+  configure(builder, answers) {
+    new AllInOne().configure(builder, answers);
+    builder.addPartial("all-in-one").addPackage("@codemirror/language").addPackage("@codemirror/state").addPackage("@codemirror/view").addScript("build:compile:typescript").addFiles(["scripts/build-compile-typescript.ts"]);
+    if (answers.testRunner === "vitest") {
+      builder.addFiles(["src/docs-showcase.desktop.integration.test.ts"]);
+    }
+  }
+};
+
+// src/features/preset/official-sample.ts
+var OFFICIAL_SAMPLE_PRESET = "official-sample";
+var OFFICIAL_SAMPLE_ANSWER_KEYS = [
+  "authorGitHubName",
+  "authorName",
+  "defaultBranch",
+  "fundingPlatform",
+  "fundingUrl",
+  "fundingUsername",
+  "pluginDescription",
+  "pluginId",
+  "pluginName",
+  "preset"
+];
+var OfficialSample = class extends FeatureOption {
+  constructor() {
+    super({
+      promptHint: "Exactly obsidianmd/obsidian-sample-plugin, with your plugin's id, name, author and description filled in",
+      promptLabel: "Official sample plugin",
+      settingValue: OFFICIAL_SAMPLE_PRESET
+    });
   }
 };
+function isOfficialSamplePreset(preset) {
+  return preset === OFFICIAL_SAMPLE_PRESET;
+}
 
 // src/features/preset/standalone.ts
 var Standalone = class extends FeatureOption {
   constructor() {
-    super({ promptHint: "Standalone plugin without obsidian-dev-utils dependency", promptLabel: "Standalone", settingValue: "standalone" });
+    super({ promptHint: "Standalone plugin without the @mnaoumov library dependencies", promptLabel: "Standalone", settingValue: "standalone" });
   }
   configure(builder) {
     builder.addScript("dev").addScript("build").addScript("version").addFiles([
@@ -1111,9 +1202,10 @@ var Standalone = class extends FeatureOption {
 };
 
 // src/features/preset/index.ts
-var PRESET_OPTIONS = [new Demo(), new Enhanced(), new Standalone()];
+var PRESET_OPTIONS = [new AllInOne(), new Demo(), new DocsShowcase(), new Standalone()];
+var PRESET_PROMPT_OPTIONS = [...PRESET_OPTIONS, new OfficialSample()];
 async function promptPreset(savedValue) {
-  return promptFeature({ defaultOption: new Enhanced(), message: "Choose a preset", options: PRESET_OPTIONS, savedValue });
+  return promptFeature({ defaultOption: new AllInOne(), message: "Choose a preset", options: PRESET_PROMPT_OPTIONS, savedValue });
 }
 
 // src/features/spell-checker/cspell.ts
@@ -1142,16 +1234,25 @@ async function promptSpellChecker(savedValue) {
   return promptFeature({ defaultOption: new Cspell(), message: "Spell checker", options: SPELL_CHECKER_OPTIONS, savedValue });
 }
 
+// src/features/styling/toolkit-styles.ts
+function addToolkitStyles(builder, bundler, flag) {
+  builder.addBuildStyles(flag).addPartial("toolkit-styles");
+  if (bundler === "webpack") {
+    builder.addPackage("css-loader").addDepcheckIgnore("css-loader", "resolved by name by obsidian-dev-toolkit's webpack plugin for the stylesheet rule.").addPackage("mini-css-extract-plugin").addDepcheckIgnore("mini-css-extract-plugin", "applied by obsidian-dev-toolkit's webpack plugin to extract `styles.css`.");
+  }
+}
+
 // src/features/styling/css-modules.ts
 var CssModules = class extends FeatureOption {
   constructor() {
     super({ promptHint: "Scoped CSS with .module.css files", promptLabel: "CSS Modules", settingValue: "css-modules" });
   }
   configure(builder, answers) {
-    builder.addFiles([
-      "src/styles/main.module.css",
-      "src/styles/css-modules.d.ts"
-    ]);
+    builder.addFiles(["src/styles/css-modules.d.ts", "src/styles/main.module.css", "src/styles/sample-css-module-command.ts"]);
+    if (isFrameworkPreset(answers.preset)) {
+      addToolkitStyles(builder, answers.bundler, "cssModules");
+      return;
+    }
     if (answers.bundler === "rollup") {
       builder.addPackage("rollup-plugin-postcss").addPartial("rollup-postcss");
     }
@@ -1167,7 +1268,12 @@ var Css = class extends FeatureOption {
     super({ promptHint: "Plain CSS styles", promptLabel: "CSS", settingValue: "css" });
   }
   configure(builder, answers) {
-    builder.addFiles(["src/styles/main.css", "src/styles/styles.d.ts"]);
+    builder.addFiles(["src/styles/main.css"]);
+    if (isFrameworkPreset(answers.preset)) {
+      addToolkitStyles(builder, answers.bundler);
+      return;
+    }
+    builder.addFiles(["src/styles/styles.d.ts"]);
     if (answers.bundler === "rollup") {
       builder.addPackage("rollup-plugin-postcss").addPartial("rollup-postcss");
     }
@@ -1193,9 +1299,13 @@ var PostCss = class extends FeatureOption {
     builder.addPackage("autoprefixer").addPackage("postcss").addFiles([
       "postcss.config.cjs",
       "scripts/postcss.config.ts",
-      "src/styles/main.css",
-      "src/styles/styles.d.ts"
+      "src/styles/main.css"
     ]);
+    if (isFrameworkPreset(answers.preset)) {
+      addToolkitStyles(builder, answers.bundler, "postcss");
+      return;
+    }
+    builder.addFiles(["src/styles/styles.d.ts"]);
     if (answers.bundler === "esbuild") {
       builder.addPackage("esbuild-postcss");
     }
@@ -1226,8 +1336,13 @@ var Scss = class extends FeatureOption {
     super({ promptHint: "Sass/SCSS preprocessor", promptLabel: "SCSS", settingValue: "scss" });
   }
   configure(builder, answers) {
-    builder.addFiles(["src/styles/main.scss", "src/styles/styles.d.ts"]);
-    const plugin = isDevUtilsPreset(answers.preset) && answers.bundler === "esbuild" ? void 0 : SCSS_PLUGINS[answers.bundler];
+    builder.addFiles(["src/styles/main.scss"]);
+    if (isFrameworkPreset(answers.preset)) {
+      builder.addPartial("toolkit-styles");
+    } else {
+      builder.addFiles(["src/styles/styles.d.ts"]);
+    }
+    const plugin = isFrameworkPreset(answers.preset) && answers.bundler === "esbuild" ? void 0 : SCSS_PLUGINS[answers.bundler];
     if (plugin) {
       builder.addPackage(plugin);
       const depcheckReason = SCSS_PLUGIN_DEPCHECK_REASONS[answers.bundler];
@@ -1239,7 +1354,10 @@ var Scss = class extends FeatureOption {
       builder.addPackage("sass-embedded").addDepcheckIgnore("sass-embedded", "the Sass compiler `esbuild-sass-plugin` peers on; nothing imports it directly.");
     }
     if (answers.bundler === "webpack") {
-      builder.addPackage("css-loader").addDepcheckIgnore("css-loader", "named as a loader string in `scripts/webpack.config.ts`.").addPackage("mini-css-extract-plugin").addPackage("sass").addDepcheckIgnore("sass", "the Sass compiler `sass-loader` resolves by name; nothing imports it directly.").addPartial("webpack-css-extract");
+      builder.addPackage("css-loader").addDepcheckIgnore("css-loader", "named as a loader string in `scripts/webpack.config.ts`.").addPackage("mini-css-extract-plugin").addPackage("sass").addDepcheckIgnore("sass", "the Sass compiler `sass-loader` resolves by name; nothing imports it directly.");
+      if (!isFrameworkPreset(answers.preset)) {
+        builder.addPartial("webpack-css-extract");
+      }
     }
   }
 };
@@ -1250,11 +1368,16 @@ var Tailwind = class extends FeatureOption {
     super({ promptHint: "Utility-first CSS framework", promptLabel: "Tailwind CSS", settingValue: "tailwind" });
   }
   configure(builder, answers) {
-    builder.addPackage("@tailwindcss/cli").addDepcheckIgnore("@tailwindcss/cli", "run as a CLI by `scripts/build-styles.ts`.").addPackage("tailwindcss").addDepcheckIgnore("tailwindcss", 'imported by `src/styles/main.css` (`@import "tailwindcss"`), which depcheck does not read.').addScript("build:styles").addFiles([
+    builder.addPackage("tailwindcss").addDepcheckIgnore("tailwindcss", 'imported by `src/styles/main.css` (`@import "tailwindcss"`), which depcheck does not read.').addFiles(["src/styles/main.css"]);
+    if (isFrameworkPreset(answers.preset)) {
+      builder.addPackage("@tailwindcss/postcss").addDepcheckIgnore("@tailwindcss/postcss", "loaded by obsidian-dev-toolkit for its `styles.tailwind` build option.");
+      addToolkitStyles(builder, answers.bundler, "tailwind");
+      return;
+    }
+    builder.addPackage("@tailwindcss/cli").addDepcheckIgnore("@tailwindcss/cli", "run as a CLI by `scripts/build-styles.ts`.").addScript("build:styles").addFiles([
       "scripts/build-styles.ts",
-      "src/styles/main.css",
       "src/styles/styles.d.ts"
-    ]);
+    ]).addPartial("tailwind-cli");
     if (answers.bundler === "rollup") {
       builder.addPackage("rollup-plugin-postcss").addPartial("rollup-postcss");
     }
@@ -1273,12 +1396,12 @@ async function promptStyling(savedValue) {
 // src/features/test-runner/sample-unit-tests.ts
 function addSampleUnitTests(builder, answers) {
   builder.addFiles(["src/main.test.ts"]);
-  if (!isDevUtilsPreset(answers.preset)) {
+  if (!isFrameworkPreset(answers.preset)) {
     return;
   }
-  builder.addFiles(["src/plugin-settings-component.test.ts"]);
+  builder.addFiles(["src/plugin-settings-component.test.ts"]).addPackage("@mnaoumov/typescript-lib");
   if (answers.preset === "demo") {
-    builder.addFiles(["src/plugin-settings.test.ts"]);
+    builder.addFiles(["src/plugin-settings.test.ts"]).addPackage("@mnaoumov/typescript-test-toolkit");
   }
 }
 
@@ -1288,7 +1411,9 @@ var Jest = class extends FeatureOption {
     super({ promptHint: "Feature-rich, widely adopted", promptLabel: "Jest", settingValue: "jest" });
   }
   configure(builder, answers) {
-    builder.addPackage("@types/jest").addPackage("jest").addPackage("jest-environment-jsdom").addDepcheckIgnore("jest-environment-jsdom", "named by `testEnvironment` in `jest.config.ts`, never imported.").addPackage("obsidian-test-mocks").addPackage("ts-jest").addScript("test").addScript("test:watch").addFiles([
+    const isFramework = isFrameworkPreset(answers.preset);
+    const configNames = isFramework ? "`defineObsidianPluginJestConfig` from @mnaoumov/obsidian-dev-toolkit" : "`jest.config.ts`";
+    builder.addPackage("@types/jest").addPackage("jest").addPackage("jest-environment-jsdom").addDepcheckIgnore("jest-environment-jsdom", `named by \`testEnvironment\` in ${configNames}, never imported.`).addPackage("obsidian-test-mocks").addPackage("ts-jest").addDepcheckIgnore("ts-jest", `named as the TypeScript transform by ${configNames}, never imported.`).addScript("test").addScript("test:watch").addFiles([
       "jest.config.ts",
       "scripts/framework-component-stub.ts",
       "scripts/stylesheet-stub.ts",
@@ -1297,6 +1422,9 @@ var Jest = class extends FeatureOption {
       "scripts/test.ts",
       "scripts/test-watch.ts"
     ]);
+    if (isFramework) {
+      builder.addDepcheckIgnore("obsidian-test-mocks", "mapped onto `obsidian` and loaded as a setup file by name by `defineObsidianPluginJestConfig` from @mnaoumov/obsidian-dev-toolkit.").addPackage("@jest/globals").addDepcheckIgnore("@jest/globals", "imported by `@mnaoumov/obsidian-dev-toolkit/jest-setup`, which `defineObsidianPluginJestConfig` loads.").addScript("test:coverage").addFiles(["scripts/test-coverage.ts"]);
+    }
     addSampleUnitTests(builder, answers);
   }
 };
@@ -1316,23 +1444,23 @@ var Vitest = class extends FeatureOption {
   configure(builder, answers) {
     builder.addPackage("jsdom").addPackage("obsidian-test-mocks").addDepcheckIgnore(
       "obsidian-test-mocks",
-      isDevUtilsPreset(answers.preset) ? "aliased and loaded as a setup file by name by `defineObsidianPluginVitestConfig` from obsidian-dev-utils." : "aliased and loaded as a setup file by name in `vitest.config.ts`."
+      isFrameworkPreset(answers.preset) ? "aliased and loaded as a setup file by name by `defineObsidianPluginVitestConfig` from @mnaoumov/obsidian-dev-toolkit." : "aliased and loaded as a setup file by name in `vitest.config.ts`."
     ).addPackage("vitest").addScript("test").addScript("test:watch").addFiles([
       "vitest.config.ts",
       "src/plugin.test.ts",
       "scripts/test.ts",
       "scripts/test-watch.ts",
-      // Both presets, not just the dev-utils ones: the emitted `src/plugin.ts` reaches `src/wasm/answer.ts`
-      // On every preset when the `wasm` answer is chosen, so every vitest config aliases `.wasm` to
-      // This stub. `framework-component-stub.ts` is dev-utils-only because only those presets' `plugin.ts`
-      // Reaches a single-file component.
+      // Both presets, not just the framework ones: the emitted `src/plugin.ts` reaches `src/wasm/answer.ts`
+      // On every preset when the `wasm` answer is chosen, and registers the answered view, which may be a
+      // Single-file component. So every vitest config aliases `.wasm` and `.svelte` / `.vue` to these stubs.
       "scripts/wasm-module-stub.ts",
+      "scripts/framework-component-stub.ts",
       // `src/main.test.ts` imports `src/main.ts`, which imports the stylesheet -- and on `tailwind` that
       // File does not exist until the first build. See the stub's own comment.
       "scripts/stylesheet-stub.ts"
     ]);
     addSampleUnitTests(builder, answers);
-    if (!isDevUtilsPreset(answers.preset)) {
+    if (!isFrameworkPreset(answers.preset)) {
       return;
     }
     builder.addPackage("@vitest/coverage-v8").addScript("test:coverage").addScript("test:integration").addScript("test:integration:android").addScript("test:integration:demo-vault").addScript("test:integration:desktop").addScript("test:integration:desktop:performance").addScript("test:integration:no-app").addFiles([
@@ -1340,7 +1468,6 @@ var Vitest = class extends FeatureOption {
       "scripts/test-integration-desktop.ts",
       "scripts/test-integration-desktop-performance.ts",
       "scripts/demo-vault-global-setup.ts",
-      "scripts/framework-component-stub.ts",
       "scripts/test-coverage.ts",
       "scripts/test-integration.ts",
       "scripts/test-integration-demo-vault.ts",
@@ -1392,6 +1519,10 @@ var Preact = class extends FeatureOption {
       "src/preact-components/sample-preact-component.tsx",
       "src/views/sample-preact-view.tsx"
     ]);
+    if (isFrameworkPreset(answers.preset)) {
+      builder.addBuildFramework("preact").addTsconfigExtends("@mnaoumov/obsidian-dev-toolkit/tsconfig/preact.json");
+      return;
+    }
     const plugin = BUILD_PLUGINS[answers.bundler];
     if (plugin) {
       builder.addPackage(plugin);
@@ -1419,6 +1550,10 @@ var React = class extends FeatureOption {
       "src/react-components/sample-react-component.tsx",
       "src/views/sample-react-view.tsx"
     ]);
+    if (isFrameworkPreset(answers.preset)) {
+      builder.addBuildFramework("react").addTsconfigExtends("@mnaoumov/obsidian-dev-toolkit/tsconfig/react.json");
+      return;
+    }
     const plugin = BUILD_PLUGINS2[answers.bundler];
     if (plugin) {
       builder.addPackage(plugin);
@@ -1446,6 +1581,10 @@ var Solid = class extends FeatureOption {
       "src/solid-components/sample-solid-component.tsx",
       "src/views/sample-solid-view.tsx"
     ]);
+    if (isFrameworkPreset(answers.preset)) {
+      builder.addBuildFramework("solid").addTsconfigExtends("@mnaoumov/obsidian-dev-toolkit/tsconfig/solid.json").addPackage("@babel/core").addDepcheckIgnore("@babel/core", "loaded by obsidian-dev-toolkit to compile Solid's JSX.").addPackage("babel-preset-solid").addDepcheckIgnore("babel-preset-solid", "loaded by obsidian-dev-toolkit to compile Solid's JSX.");
+      return;
+    }
     const plugin = BUILD_PLUGINS3[answers.bundler];
     if (plugin) {
       builder.addPackage(plugin);
@@ -1487,16 +1626,17 @@ var Svelte = class extends FeatureOption {
       "src/svelte-components/sample-svelte-component.svelte",
       "src/views/sample-svelte-view.ts"
     ]);
-    const isDevUtilsEsbuild = isDevUtilsPreset(answers.preset) && answers.bundler === "esbuild";
+    builder.addPackage("svelte-check");
+    if (isFrameworkPreset(answers.preset)) {
+      builder.addBuildFramework("svelte").addTsconfigExtends("@mnaoumov/obsidian-dev-toolkit/tsconfig/svelte.json").addDepcheckIgnore("svelte-check", "run as a CLI by typescript-dev-toolkit's `build:compile`, which refuses to build without it declared.");
+      return;
+    }
     const plugin = getBuildPlugin(answers.bundler);
-    if (plugin !== null && !isDevUtilsEsbuild) {
+    if (plugin !== null) {
       builder.addPackage(plugin);
     }
-    builder.addPackage("svelte-check").addDepcheckIgnore(
-      "svelte-check",
-      isDevUtilsEsbuild ? "run as a CLI by obsidian-dev-utils' `build:compile`, which refuses to build without it declared." : "run as a CLI by `scripts/build.ts`."
-    );
-    if (!isDevUtilsEsbuild && SVELTE_PREPROCESS_BUNDLERS.has(answers.bundler)) {
+    builder.addDepcheckIgnore("svelte-check", "run as a CLI by `scripts/build.ts`.");
+    if (SVELTE_PREPROCESS_BUNDLERS.has(answers.bundler)) {
       builder.addPackage("svelte-preprocess");
     }
     if (answers.bundler === "webpack") {
@@ -1527,11 +1667,19 @@ var Vue = class extends FeatureOption {
     super({ promptHint: "Progressive framework with SFC", promptLabel: "Vue", settingValue: "vue" });
   }
   configure(builder, answers) {
-    builder.addPackage("vue").addPackage(getBuildPlugin2(answers.bundler)).addPartial("ui-view").addSentenceCaseBrand("Vue").addFiles([
+    builder.addPackage("vue").addPartial("ui-view").addSentenceCaseBrand("Vue").addFiles([
       "src/vue-components/sample-vue-component.d.ts",
       "src/vue-components/sample-vue-component.vue",
       "src/views/sample-vue-view.ts"
     ]);
+    if (isFrameworkPreset(answers.preset)) {
+      builder.addBuildFramework("vue").addPackage("unplugin-vue").addDepcheckIgnore("unplugin-vue", "loaded by obsidian-dev-toolkit to compile `.vue` components.");
+      if (answers.bundler === "parcel") {
+        builder.addPackage("@parcel/transformer-vue").addDepcheckIgnore("@parcel/transformer-vue", "resolved by name by `@parcel/config-default` for `.vue`; nothing imports it.");
+      }
+      return;
+    }
+    builder.addPackage(getBuildPlugin2(answers.bundler));
     if (answers.bundler === "rollup") {
       builder.addPackage("@babel/core").addPackage("@babel/preset-typescript").addPackage("@rollup/plugin-babel").addDepcheckIgnore("@babel/preset-typescript", "named as a string in `scripts/rollup.config.ts`, never imported.").addPartial("rollup-babel");
     }
@@ -1574,24 +1722,29 @@ var Wasm = class extends FeatureOption {
     super({ promptHint: "Import and use .wasm modules", promptLabel: "WASM", settingValue: "wasm" });
   }
   configure(builder, answers) {
-    const plugin = getWasmPlugin(answers.bundler);
-    if (plugin !== null) {
-      builder.addPackage(plugin);
+    const isFramework = isFrameworkPreset(answers.preset);
+    if (isFramework) {
+      builder.addBuildOption("wasm", "true").addPartial("wasm-adapter");
+    } else {
+      const plugin = getWasmPlugin(answers.bundler);
+      if (plugin !== null) {
+        builder.addPackage(plugin);
+      }
+      builder.addFiles(["src/wasm.d.ts"]).addPartial(`wasm-${answers.bundler}`);
     }
     builder.addSentenceCaseBrand("WASM");
     builder.addFiles([
       // The one binary in the template tree, copied verbatim (see `ASSET_EXTENSIONS`). 39 bytes, one
-      // Export, `answer()`, returning 42 -- the sample module from CodeScript Toolkit's demo vault.
+      // Export, `answer()`, returning 42 -- the sample module from `CodeScript Toolkit`'s demo vault.
       "src/wasm/module.wasm",
       // Its source in WebAssembly text format. Documentation only: nothing in the build reads it, and it
       // Is here so the binary beside it is not opaque.
       "src/wasm/module.wat",
-      "src/wasm.d.ts",
       "src/wasm/answer.ts",
       "src/wasm/sample-command.ts",
       "src/wasm/README.md"
     ]);
-    if (isDevUtilsPreset(answers.preset)) {
+    if (isFramework) {
       builder.addFiles(["demo-vault/03 WebAssembly.md"]);
     }
   }
@@ -1656,6 +1809,22 @@ function getPluginShortName(pluginId) {
   return pluginId.split("-").map((word) => (word[0] ?? "").toUpperCase() + word.slice(1)).join("");
 }
 
+// src/deprecated-answers.ts
+import { log } from "@clack/prompts";
+var DEPRECATED_ANSWER_VALUES = {
+  preset: {
+    enhanced: "all-in-one"
+  }
+};
+function resolveDeprecatedAnswer(key, value, source) {
+  const replacement = DEPRECATED_ANSWER_VALUES[key]?.[value];
+  if (replacement === void 0) {
+    return value;
+  }
+  log.warn(`${key} "${value}" in ${source} is deprecated and was read as "${replacement}". Use "${replacement}" instead.`);
+  return replacement;
+}
+
 // src/directory-constraints.ts
 var CORE_FEATURE_NAMES = [
   "Audio recorder",
@@ -1795,7 +1964,7 @@ function findCoreFeatureName(name) {
 // src/prompts.ts
 import {
   cancel as cancel2,
-  log
+  log as log2
 } from "@clack/prompts";
 import { styleText as styleText3 } from "node:util";
 
@@ -1891,6 +2060,30 @@ ${barEnd}
 }
 
 // src/prompts.ts
+var MAX_HINTED_CHANGES = 3;
+var TOOLING_QUESTIONS = {
+  bundler: { message: "Bundler", options: BUNDLER_OPTIONS },
+  uiFramework: { message: "UI framework", options: UI_FRAMEWORK_OPTIONS },
+  linter: { message: "Linter", options: LINTER_OPTIONS },
+  formatter: { message: "Formatter", options: FORMATTER_OPTIONS },
+  spellChecker: { message: "Spell checker", options: SPELL_CHECKER_OPTIONS },
+  markdownLinter: { message: "Markdown linter", options: MARKDOWN_LINTER_OPTIONS },
+  testRunner: { message: "Unit testing", options: TEST_RUNNER_OPTIONS },
+  e2eTestRunner: { message: "E2E testing", options: E2E_TEST_RUNNER_OPTIONS },
+  editorExtensions: { message: "Editor extensions", options: EDITOR_EXTENSIONS_OPTIONS },
+  styling: { message: "Styling", options: STYLING_OPTIONS },
+  wasmSupport: { message: "WebAssembly support", options: WASM_SUPPORT_OPTIONS },
+  commitLinting: { message: "Commit linting", options: COMMIT_LINTING_OPTIONS },
+  hotReload: { message: "Hot reload", options: HOT_RELOAD_OPTIONS },
+  internationalization: { message: "Internationalization", options: INTERNATIONALIZATION_OPTIONS },
+  gitHubActions: { message: "GitHub Actions", options: GITHUB_ACTIONS_OPTIONS },
+  gitHubIssueTemplates: { message: "GitHub issue templates", options: GITHUB_ISSUE_TEMPLATES_OPTIONS },
+  coverageBadge: { message: "Coverage badge", options: COVERAGE_BADGE_OPTIONS },
+  apiSubset: { message: "Obsidian API subset", options: API_SUBSET_OPTIONS },
+  packageManager: { message: "Package manager", options: PACKAGE_MANAGER_OPTIONS },
+  platformSupport: { message: "Platform support", options: PLATFORM_SUPPORT_OPTIONS }
+};
+var API_SUBSET_PRESETS = ["all-in-one", "docs-showcase"];
 var DEFAULT_PLUGIN_ID = "my-awesome-helper";
 function getDefaultAnswers(defaults) {
   const pluginId = defaults?.pluginId ?? DEFAULT_PLUGIN_ID;
@@ -1909,10 +2102,10 @@ function getDefaultAnswers(defaults) {
 function makePluginName(pluginId) {
   return extractWords(pluginId).join(" ");
 }
-async function promptAnswers(defaults) {
+async function promptAnswers(defaults, supplied = defaults ?? {}) {
   showHotkeyHints();
   const defaultTooling = getDefaultTooling();
-  const steps = skipSuppliedAnswers(buildPromptSteps(defaults ?? {}, defaultTooling), defaults ?? {});
+  const steps = skipSuppliedAnswers(buildPromptSteps(defaults ?? {}, supplied, defaultTooling), supplied);
   const answers = await runPromptSteps(steps);
   return buildAnswers(answers, defaultTooling);
 }
@@ -1922,6 +2115,9 @@ function validateNotEmpty(value) {
   }
   return void 0;
 }
+function asksApiSubset(preset) {
+  return API_SUBSET_PRESETS.includes(preset ?? "");
+}
 function buildAnswers(answers, defaultTooling) {
   function get(key, fallback) {
     return answers.get(key) ?? fallback;
@@ -1931,7 +2127,7 @@ function buildAnswers(answers, defaultTooling) {
     apiSubset: get("apiSubset", defaultTooling.apiSubset),
     authorGitHubName: get("authorGitHubName", "johndoe"),
     authorName: get("authorName", "John Doe"),
-    bundler: get("bundler", "esbuild"),
+    bundler: get("bundler", defaultTooling.bundler),
     commitLinting: get("commitLinting", defaultTooling.commitLinting),
     coverageBadge: get("coverageBadge", defaultTooling.coverageBadge),
     currentYear: (/* @__PURE__ */ new Date()).getFullYear(),
@@ -1949,154 +2145,165 @@ function buildAnswers(answers, defaultTooling) {
     linter: get("linter", defaultTooling.linter),
     markdownLinter: get("markdownLinter", defaultTooling.markdownLinter),
     obsidianConfigFolder: get("obsidianConfigFolder", ""),
-    packageManager: get("packageManager", "npm"),
-    platformSupport: get("platformSupport", "desktop-only"),
+    packageManager: get("packageManager", defaultTooling.packageManager),
+    platformSupport: get("platformSupport", defaultTooling.platformSupport),
     pluginDescription: get("pluginDescription", "Does something awesome."),
     pluginId,
     pluginName: get("pluginName", makePluginName(pluginId)),
-    preset: get("preset", "enhanced"),
+    preset: get("preset", "all-in-one"),
     spellChecker: get("spellChecker", defaultTooling.spellChecker),
     styling: get("styling", defaultTooling.styling),
     testRunner: get("testRunner", defaultTooling.testRunner),
-    uiFramework: get("uiFramework", "none"),
+    uiFramework: get("uiFramework", defaultTooling.uiFramework),
     wasmSupport: get("wasmSupport", defaultTooling.wasmSupport)
   };
 }
-function buildPromptSteps(d, defaultTooling) {
+function buildPromptSteps(d, supplied, defaultTooling) {
   function isCustomize(answers) {
     return answers.get("toolingMode") === "customize";
   }
   function skipUnlessCustomize(answers) {
     return !isCustomize(answers);
   }
+  function tooling(key, answers) {
+    if (answers.get("toolingMode") === "defaults" && supplied[key] === void 0) {
+      return defaultTooling[key];
+    }
+    return d[key] ?? defaultTooling[key];
+  }
+  function changes(answers) {
+    return findToolingChanges(d, supplied, defaultTooling, answers.get("preset"));
+  }
   return [
     {
-      defaultValue: () => d.preset ?? "enhanced",
+      defaultValue: () => d.preset ?? "all-in-one",
       key: "preset",
       prompt: (saved) => promptPreset(saved)
     },
     {
-      defaultValue: () => "defaults",
+      // A skipped `Tooling` keeps what was saved, which is what the question offers first when there is any.
+      defaultValue: (answers) => changes(answers).length > 0 ? "keep" : "defaults",
       key: "toolingMode",
-      prompt: () => promptToolingMode(),
-      skip: (answers) => answers.get("preset") === "demo"
+      prompt: (saved, answers) => promptToolingMode(saved, changes(answers)),
+      // The official sample is upstream's tooling as it is, so there is nothing to customize.
+      skip: (answers) => answers.get("preset") === "demo" || isOfficialSamplePreset(answers.get("preset"))
     },
     {
-      defaultValue: (answers) => answers.get("preset") === "demo" ? "esbuild" : d.bundler ?? "esbuild",
+      defaultValue: (answers) => answers.get("preset") === "demo" ? "esbuild" : tooling("bundler", answers),
       key: "bundler",
       prompt: (saved) => promptBundler(saved),
       skip: skipUnlessCustomize
     },
     {
-      defaultValue: (answers) => answers.get("preset") === "demo" ? "none" : d.uiFramework ?? "none",
+      defaultValue: (answers) => answers.get("preset") === "demo" ? "none" : tooling("uiFramework", answers),
       key: "uiFramework",
       prompt: (saved) => promptUiFramework(saved),
       skip: skipUnlessCustomize
     },
     {
-      defaultValue: () => d.linter ?? defaultTooling.linter,
+      defaultValue: (answers) => tooling("linter", answers),
       key: "linter",
       prompt: (saved) => promptLinter(saved),
       skip: skipUnlessCustomize
     },
     {
-      defaultValue: () => d.formatter ?? defaultTooling.formatter,
+      defaultValue: (answers) => tooling("formatter", answers),
       key: "formatter",
       prompt: (saved) => promptFormatter(saved),
       skip: skipUnlessCustomize
     },
     {
-      defaultValue: () => d.spellChecker ?? defaultTooling.spellChecker,
+      defaultValue: (answers) => tooling("spellChecker", answers),
       key: "spellChecker",
       prompt: (saved) => promptSpellChecker(saved),
       skip: skipUnlessCustomize
     },
     {
-      defaultValue: () => d.markdownLinter ?? defaultTooling.markdownLinter,
+      defaultValue: (answers) => tooling("markdownLinter", answers),
       key: "markdownLinter",
       prompt: (saved) => promptMarkdownLinter(saved),
       skip: skipUnlessCustomize
     },
     {
-      defaultValue: () => d.testRunner ?? defaultTooling.testRunner,
+      defaultValue: (answers) => tooling("testRunner", answers),
       key: "testRunner",
       prompt: (saved) => promptTestRunner(saved),
       skip: skipUnlessCustomize
     },
     {
-      defaultValue: () => d.e2eTestRunner ?? defaultTooling.e2eTestRunner,
+      defaultValue: (answers) => tooling("e2eTestRunner", answers),
       key: "e2eTestRunner",
       prompt: (saved) => promptE2eTestRunner(saved),
       skip: skipUnlessCustomize
     },
     {
-      defaultValue: () => d.editorExtensions ?? defaultTooling.editorExtensions,
+      defaultValue: (answers) => tooling("editorExtensions", answers),
       key: "editorExtensions",
       prompt: (saved) => promptEditorExtensions(saved),
       skip: skipUnlessCustomize
     },
     {
-      defaultValue: () => d.styling ?? defaultTooling.styling,
+      defaultValue: (answers) => tooling("styling", answers),
       key: "styling",
       prompt: (saved) => promptStyling(saved),
       skip: skipUnlessCustomize
     },
     {
-      defaultValue: () => d.wasmSupport ?? defaultTooling.wasmSupport,
+      defaultValue: (answers) => tooling("wasmSupport", answers),
       key: "wasmSupport",
       prompt: (saved) => promptWasmSupport(saved),
       skip: skipUnlessCustomize
     },
     {
-      defaultValue: () => d.commitLinting ?? defaultTooling.commitLinting,
+      defaultValue: (answers) => tooling("commitLinting", answers),
       key: "commitLinting",
       prompt: (saved) => promptCommitLinting(saved),
       skip: skipUnlessCustomize
     },
     {
-      defaultValue: () => d.hotReload ?? defaultTooling.hotReload,
+      defaultValue: (answers) => tooling("hotReload", answers),
       key: "hotReload",
       prompt: (saved) => promptHotReload(saved),
       skip: skipUnlessCustomize
     },
     {
-      defaultValue: () => d.internationalization ?? defaultTooling.internationalization,
+      defaultValue: (answers) => tooling("internationalization", answers),
       key: "internationalization",
       prompt: (saved) => promptInternationalization(saved),
       skip: skipUnlessCustomize
     },
     {
-      defaultValue: () => d.gitHubActions ?? defaultTooling.gitHubActions,
+      defaultValue: (answers) => tooling("gitHubActions", answers),
       key: "gitHubActions",
       prompt: (saved) => promptGitHubActions(saved),
       skip: skipUnlessCustomize
     },
     {
-      defaultValue: () => d.gitHubIssueTemplates ?? defaultTooling.gitHubIssueTemplates,
+      defaultValue: (answers) => tooling("gitHubIssueTemplates", answers),
       key: "gitHubIssueTemplates",
       prompt: (saved) => promptGitHubIssueTemplates(saved),
       skip: skipUnlessCustomize
     },
     {
-      defaultValue: () => d.coverageBadge ?? defaultTooling.coverageBadge,
+      defaultValue: (answers) => tooling("coverageBadge", answers),
       key: "coverageBadge",
       prompt: (saved) => promptCoverageBadge(saved),
       skip: skipUnlessCustomize
     },
     {
-      defaultValue: () => d.apiSubset ?? defaultTooling.apiSubset,
+      defaultValue: (answers) => tooling("apiSubset", answers),
       key: "apiSubset",
       prompt: (saved) => promptApiSubset(saved),
-      skip: (answers) => !(isCustomize(answers) && answers.get("preset") === "enhanced")
+      skip: (answers) => !(isCustomize(answers) && asksApiSubset(answers.get("preset")))
     },
     {
-      defaultValue: () => d.packageManager ?? "npm",
+      defaultValue: (answers) => tooling("packageManager", answers),
       key: "packageManager",
       prompt: (saved) => promptPackageManager(saved),
       skip: skipUnlessCustomize
     },
     {
-      defaultValue: () => d.platformSupport ?? "desktop-only",
+      defaultValue: (answers) => tooling("platformSupport", answers),
       key: "platformSupport",
       prompt: (saved) => promptPlatformSupport(saved),
       skip: skipUnlessCustomize
@@ -2187,37 +2394,59 @@ function buildPromptSteps(d, defaultTooling) {
         defaultValue: saved || void 0,
         message: "Path to test vault config folder (.obsidian, by default, but it is configurable in Obsidian settings). This enables auto-update of your plugin in your test vault during dev. Leave empty if you prefer to update the plugin manually.",
         placeholder: saved || "path/to/test-vault/.obsidian"
-      })
+      }),
+      // Upstream builds into the project folder and copies nothing into a vault.
+      skip: (answers) => isOfficialSamplePreset(answers.get("preset"))
     }
   ];
 }
+function describeChanges(changes, describe) {
+  const named = changes.slice(0, MAX_HINTED_CHANGES).map(describe).join(", ");
+  const rest = changes.length - MAX_HINTED_CHANGES;
+  return rest > 0 ? `${named}, and ${String(rest)} more` : named;
+}
 function extractWords(pluginId) {
   return pluginId.split("-").map((w) => (w[0] ?? "").toUpperCase() + w.slice(1));
 }
+function findToolingChanges(d, supplied, defaultTooling, preset) {
+  const changes = [];
+  for (const [key, question] of Object.entries(TOOLING_QUESTIONS)) {
+    const saved = d[key];
+    if (saved === void 0 || supplied[key] !== void 0 || saved === defaultTooling[key]) {
+      continue;
+    }
+    if (key === "apiSubset" && !asksApiSubset(preset)) {
+      continue;
+    }
+    changes.push({
+      question: question.message,
+      recommended: getOptionLabel(question, defaultTooling[key]),
+      saved: getOptionLabel(question, saved)
+    });
+  }
+  return changes;
+}
 function getDefaultAnswersBase(pluginId) {
   return {
     ...getDefaultTooling(),
     authorGitHubName: "johndoe",
     authorName: "John Doe",
-    bundler: "esbuild",
     currentYear: (/* @__PURE__ */ new Date()).getFullYear(),
     defaultBranch: "main",
     fundingPlatform: "buy-me-a-coffee",
     fundingUrl: "",
     fundingUsername: "johndoe",
     obsidianConfigFolder: "",
-    packageManager: "npm",
-    platformSupport: "desktop-only",
     pluginDescription: "Does something awesome.",
     pluginId,
     pluginName: makePluginName(pluginId),
-    preset: "enhanced",
-    uiFramework: "none"
+    preset: "all-in-one"
   };
 }
 function getDefaultTooling() {
   return {
     apiSubset: "official",
+    bundler: "esbuild",
     commitLinting: "conventional-commits",
     coverageBadge: "none",
     e2eTestRunner: "none",
@@ -2229,12 +2458,18 @@ function getDefaultTooling() {
     internationalization: "none",
     linter: "eslint",
     markdownLinter: "markdownlint",
+    packageManager: "npm",
+    platformSupport: "desktop-only",
     spellChecker: "cspell",
     styling: "scss",
     testRunner: "vitest",
+    uiFramework: "none",
     wasmSupport: "none"
   };
 }
+function getOptionLabel(question, value) {
+  return question.options.find((option) => option.settingValue === value)?.promptLabel ?? value;
+}
 function promptPluginDescription(saved) {
   const value = saved || void 0;
   return text({
@@ -2253,13 +2488,29 @@ function promptPluginName(saved) {
     validate: validatePluginName
   });
 }
-async function promptToolingMode() {
+async function promptToolingMode(savedValue, changes) {
+  const customize = { hint: "Choose each tool individually", label: "Customize", value: "customize" };
+  if (changes.length === 0) {
+    return select({
+      initialValue: savedValue,
+      message: "Tooling",
+      options: [
+        customize,
+        { hint: "ESLint, dprint, SCSS, Vitest, and more", label: "Use recommended defaults", value: "defaults" }
+      ]
+    });
+  }
   return select({
-    initialValue: "defaults",
+    initialValue: savedValue,
     message: "Tooling",
     options: [
-      { hint: "Choose each tool individually", label: "Customize", value: "customize" },
-      { hint: "ESLint, dprint, SCSS, Vitest, and more", label: "Use recommended defaults", value: "defaults" }
+      { hint: describeChanges(changes, (change) => `${change.question}: ${change.saved}`), label: "Keep current tooling", value: "keep" },
+      customize,
+      {
+        hint: describeChanges(changes, (change) => `${change.question}: ${change.saved} -> ${change.recommended}`),
+        label: "Use recommended defaults",
+        value: "defaults"
+      }
     ]
   });
 }
@@ -2275,7 +2526,7 @@ async function runPromptSteps(steps) {
     }
     try {
       const savedValue = answers.get(step.key) ?? step.defaultValue(answers);
-      answers.set(step.key, await step.prompt(savedValue));
+      answers.set(step.key, await step.prompt(savedValue, answers));
       i++;
     } catch (error) {
       if (!(error instanceof GoBackError)) {
@@ -2303,7 +2554,7 @@ function showHotkeyHints() {
   function key(s) {
     return styleText3("cyan", s);
   }
-  log.info([
+  log2.info([
     `${key("\u2191\u2193")} Navigate  ${key("Enter")} Confirm  ${key("Esc")} Go back`,
     `${dim("Text inputs:")} ${key("Tab")}/${key("\u2192")}/${key("End")} Accept suggestion`
   ].join("\n"));
@@ -2323,6 +2574,7 @@ var ANSWERS_FILE_PREFIX = "--answersFile=";
 var CUSTOM_TEMPLATE_PREFIX = "--customTemplate=";
 var MODE_PREFIX = "--mode=";
 var MODES = ["create" /* Create */, "update" /* Update */];
+var MODE_BY_VALUE = new Map(MODES.map((mode) => [mode, mode]));
 var FLAG_PREFIX_LENGTH = 2;
 var FREE_TEXT_VALIDATORS = {
   authorGitHubName: validateNotEmpty,
@@ -2334,6 +2586,9 @@ var FREE_TEXT_VALIDATORS = {
   pluginName: validatePluginName
 };
 var DEMO_PINNED_ANSWER_KEYS = ["bundler", "uiFramework"];
+var VALUES_OUTSIDE_ANSWER_SPACE = {
+  preset: [OFFICIAL_SAMPLE_PRESET]
+};
 function assertValidAnswer(key, value) {
   const dimension = findChoiceDimension(key);
   if (dimension) {
@@ -2366,6 +2621,8 @@ function getHelpText() {
     "      --customTemplate=<dir> Layer your own templates over the built-in ones: a directory",
     "                            mirroring templates/default, plus an overlay.json. Recorded in the",
     "                            project and re-applied on update; pass it empty to drop it.",
+    "      --latest              With --preset=official-sample: copy obsidianmd/obsidian-sample-plugin",
+    "                            as it is upstream today, not the snapshot this release vendored.",
     "",
     "Answers (any of these may be given as --<key>=<value>):"
   ];
@@ -2380,6 +2637,7 @@ function parseCliArgs(argv) {
   let answersFilePath = null;
   let customTemplate;
   let force = false;
+  let latest = false;
   let mode;
   let showHelp = false;
   let useDefaults = false;
@@ -2404,27 +2662,40 @@ function parseCliArgs(argv) {
       force = true;
       continue;
     }
+    if (argument === "--latest") {
+      latest = true;
+      continue;
+    }
     if (argument.startsWith(MODE_PREFIX)) {
       mode = toMode(argument.slice(MODE_PREFIX.length));
       continue;
     }
-    const [rawKey, value] = splitFlag(argument);
+    const [rawKey, rawValue] = splitFlag(argument);
     const key = toAnswerKey(rawKey);
-    assertValidAnswer(key, value);
-    flagAnswers[key] = value;
+    flagAnswers[key] = resolveAnswer(key, rawValue, `--${key}`);
   }
   const fileAnswers = answersFilePath === null ? {} : readAnswersFile(answersFilePath);
-  const answers = { ...fileAnswers, ...flagAnswers };
+  const isOfficialSample = isOfficialSamplePreset(flagAnswers.preset ?? fileAnswers.preset);
+  if (isOfficialSample) {
+    assertNoOfficialSampleConflict(flagAnswers);
+  }
+  const answers = { ...isOfficialSample ? pickOfficialSampleAnswers(fileAnswers) : fileAnswers, ...flagAnswers };
   assertNoDemoConflict(answers);
   return {
     answers,
     customTemplate,
     force,
+    latest,
     mode,
     showHelp,
     useDefaults
   };
 }
+function resolveAnswer(key, value, source) {
+  const resolved = resolveDeprecatedAnswer(key, value, source);
+  assertValidAnswer(key, resolved);
+  return resolved;
+}
 function toAnswerKey(key) {
   if (REFUSED_KEYS.includes(key)) {
     throw new Error(`${key} is computed by the generator, not answered, so it cannot be set.`);
@@ -2445,12 +2716,23 @@ function assertNoDemoConflict(answers) {
     }
   }
 }
+function assertNoOfficialSampleConflict(answers) {
+  const conflicting = Object.keys(answers).filter((key) => answers[key] !== void 0 && !OFFICIAL_SAMPLE_ANSWER_KEYS.includes(key));
+  if (conflicting.length > 0) {
+    const flags = conflicting.map((key) => `--${key}`).join(", ");
+    throw new Error(`preset=official-sample copies obsidianmd/obsidian-sample-plugin as it is, so it takes no ${conflicting.join(", ")}. Drop ${flags}, or choose another preset.`);
+  }
+}
 function findChoiceDimension(key) {
   const dimension = ANSWER_SPACE.find((candidate) => candidate.answerKey === key);
   if (!dimension || dimension.values.includes("")) {
     return null;
   }
-  return dimension;
+  const extraValues = VALUES_OUTSIDE_ANSWER_SPACE[key];
+  return extraValues ? { ...dimension, values: [...dimension.values, ...extraValues] } : dimension;
+}
+function pickOfficialSampleAnswers(answers) {
+  return Object.fromEntries(Object.entries(answers).filter(([key]) => OFFICIAL_SAMPLE_ANSWER_KEYS.includes(key)));
 }
 function readAnswersFile(path) {
   if (!existsSync(path)) {
@@ -2477,8 +2759,7 @@ function readAnswersFile(path) {
       throw new Error(`${rawKey} in ${path} should be a string, got ${typeof value}.`);
     }
     const key = toAnswerKey(rawKey);
-    assertValidAnswer(key, value);
-    answers[key] = value;
+    answers[key] = resolveAnswer(key, value, path);
   }
   return answers;
 }
@@ -2493,10 +2774,11 @@ function splitFlag(argument) {
   return [argument.slice(FLAG_PREFIX_LENGTH, separatorIndex), argument.slice(separatorIndex + 1)];
 }
 function toMode(value) {
-  if (!MODES.includes(value)) {
+  const mode = MODE_BY_VALUE.get(value);
+  if (mode === void 0) {
     throw new Error(`"${value}" is not a mode. It accepts: ${MODES.join(", ")}.`);
   }
-  return value;
+  return mode;
 }
 
 // src/answers-export.ts
@@ -2536,6 +2818,9 @@ function formatCreateScript(answers, shell, customTemplate) {
 }
 function getExportableKeys(answers) {
   const keys = getAnswerableKeys();
+  if (isOfficialSamplePreset(answers.preset)) {
+    return keys.filter((key) => OFFICIAL_SAMPLE_ANSWER_KEYS.includes(key));
+  }
   if (answers.preset !== "demo") {
     return keys;
   }
@@ -2589,48 +2874,50 @@ function validatePluginIdIsUnlisted(pluginId, listedIds) {
   return `"${pluginId}" is already the id of a plugin in the Community directory -- the directory requires every id to be unique, and an id can never be changed once the plugin is published`;
 }
 
-// src/overlay.ts
-import {
-  existsSync as existsSync4,
-  readdirSync as readdirSync2,
-  readFileSync as readFileSync4,
-  statSync as statSync2
-} from "node:fs";
-import {
-  isAbsolute,
-  join as join3,
-  relative,
-  resolve
-} from "node:path";
+// src/official-sample.ts
+import { join as join4 } from "node:path";
 
-// src/plan-checks.ts
+// src/templates.ts
+import { log as log4 } from "@clack/prompts";
+import ejs from "ejs";
+import { createHash } from "node:crypto";
 import {
   existsSync as existsSync3,
-  readdirSync,
+  mkdirSync,
   readFileSync as readFileSync3,
-  statSync
+  writeFileSync
 } from "node:fs";
 import {
-  extname as extname2,
+  dirname,
+  extname,
   join as join2
 } from "node:path";
+import { fileURLToPath } from "node:url";
 
-// src/templates.ts
-import { log as log3 } from "@clack/prompts";
-import ejs from "ejs";
-import { createHash } from "node:crypto";
+// src/docs-showcase/docs-showcase-files.ts
 import {
   existsSync as existsSync2,
-  mkdirSync,
-  readFileSync as readFileSync2,
-  writeFileSync
+  readdirSync,
+  readFileSync as readFileSync2
 } from "node:fs";
 import {
-  dirname,
-  extname,
-  join
+  join,
+  relative
 } from "node:path";
-import { fileURLToPath } from "node:url";
+var DOCS_SHOWCASE_TREE_DIR = join("src", "docs");
+var DOCS_SHOWCASE_FILES_DIR = join("templates", "docs-showcase", "files");
+var DOCS_SHOWCASE_HOST_DIR = join("templates", "docs-showcase", "host");
+var DOCS_SHOWCASE_REPORT_PATH = join("templates", "docs-showcase", "snippets.json");
+function readDocsShowcaseFiles(packageRoot) {
+  const filesDir = join(packageRoot, DOCS_SHOWCASE_FILES_DIR);
+  if (!existsSync2(filesDir)) {
+    return [];
+  }
+  return readdirSync(filesDir, { recursive: true, withFileTypes: true }).filter((entry) => entry.isFile()).map((entry) => join(entry.parentPath, entry.name)).sort((a, b) => a.localeCompare(b)).map((fullPath) => ({
+    content: readFileSync2(fullPath, "utf-8"),
+    destinationPath: relative(filesDir, fullPath).replaceAll("\\", "/")
+  }));
+}
 
 // src/template-builder.ts
 var PARTIAL_NAME_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
@@ -2647,10 +2934,31 @@ var Dependency = class {
     this.version = version;
   }
 };
+var FRAMEWORKS_ESBUILD_COMPILES_UNASKED = /* @__PURE__ */ new Set(["preact", "react", "svelte"]);
 var TemplateBuilder = class {
   get badges() {
     return [...this._badges];
   }
+  /**
+   * The options every obsidian-dev-toolkit bundler adapter takes, as `key: <TypeScript literal>` source, sorted by key.
+   *
+   * `framework` is a single value, and only `preset: demo` registers more than one, a set it builds only with esbuild.
+   * There the toolkit compiles Svelte, React and Preact unasked, so the framework that needs the option is the one
+   * passed.
+   */
+  get buildOptions() {
+    const options = new Map(this._buildOptions);
+    const frameworks = [...this._buildFrameworks];
+    const framework = frameworks.length > 1 ? frameworks.find((name) => !FRAMEWORKS_ESBUILD_COMPILES_UNASKED.has(name)) : frameworks[0];
+    if (framework !== void 0) {
+      options.set("framework", `'${framework}'`);
+    }
+    if (this._buildStyles !== null) {
+      const flags = [...this._buildStyles].sort((a, b) => a.localeCompare(b));
+      options.set("styles", flags.length === 0 ? "{}" : `{ ${flags.map((flag) => `${flag}: true`).join(", ")} }`);
+    }
+    return [...options.entries()].map(([key, value]) => ({ key, value })).sort((a, b) => a.key.localeCompare(b.key));
+  }
   get depcheckIgnores() {
     return [...this._depcheckIgnores.entries()].map(([packageName, reason]) => ({ packageName, reason })).sort((a, b) => a.packageName.localeCompare(b.packageName));
   }
@@ -2658,7 +2966,7 @@ var TemplateBuilder = class {
     return [...this._dependencies.values()].sort((a, b) => a.packageName.localeCompare(b.packageName));
   }
   get lintStagedPatterns() {
-    return [...this._lintStagedPatterns.entries()].map(([pattern, commands]) => ({ commands: [...commands], pattern }));
+    return [...this._lintStagedPatterns.entries()].map(([pattern, commands]) => ({ commands: [...commands], pattern })).sort((a, b) => a.pattern.localeCompare(b.pattern));
   }
   get partials() {
     return new Set(this._partials);
@@ -2672,7 +2980,16 @@ var TemplateBuilder = class {
   get templateFiles() {
     return new Set(this._templateFiles);
   }
+  /**
+   * The configs the emitted `tsconfig.json` extends after its base, in registration order.
+   */
+  get tsconfigExtends() {
+    return [...this._tsconfigExtends];
+  }
   _badges = [];
+  _buildFrameworks = /* @__PURE__ */ new Set();
+  _buildOptions = /* @__PURE__ */ new Map();
+  _buildStyles = null;
   _depcheckIgnores = /* @__PURE__ */ new Map();
   _dependencies = /* @__PURE__ */ new Map();
   _lintStagedPatterns = /* @__PURE__ */ new Map();
@@ -2680,6 +2997,7 @@ var TemplateBuilder = class {
   _scripts = {};
   _sentenceCaseBrands = /* @__PURE__ */ new Set();
   _templateFiles = /* @__PURE__ */ new Set();
+  _tsconfigExtends = /* @__PURE__ */ new Set();
   /**
    * Registers a README badge, rendered in registration order on the line under the title.
    *
@@ -2691,6 +3009,35 @@ var TemplateBuilder = class {
     this._badges.push(markdown);
     return this;
   }
+  /**
+   * Registers a UI framework the obsidian-dev-toolkit bundler adapters compile, through their `framework` option.
+   */
+  addBuildFramework(framework) {
+    this._buildFrameworks.add(framework);
+    return this;
+  }
+  /**
+   * Registers an obsidian-dev-toolkit bundler adapter option other than `framework` and `styles`.
+   *
+   * @param key - The option name.
+   * @param value - The option's value, as TypeScript source.
+   */
+  addBuildOption(key, value) {
+    this._buildOptions.set(key, value);
+    return this;
+  }
+  /**
+   * Turns on the adapters' `styles` option, which compiles the project's plain stylesheets, with a flag of it if given.
+   *
+   * @param flag - `postcss`, `tailwind` or `cssModules`; omitted, the stylesheets are compiled as plain CSS.
+   */
+  addBuildStyles(flag) {
+    this._buildStyles ??= /* @__PURE__ */ new Set();
+    if (flag !== void 0) {
+      this._buildStyles.add(flag);
+    }
+    return this;
+  }
   /**
    * Registers a declared package that depcheck reports as unused although it is not -- one only ever
    * invoked as a CLI, named as a string in a config, or reached by a compiler option.
@@ -2718,6 +3065,11 @@ var TemplateBuilder = class {
    * The commands are collected here rather than concatenated from template partials because a partial can
    * only ever emit `'<command>',` -- and the trailing comma the last one leaves behind is exactly what the
    * generated formatter config strips, so the file failed its own `format:check`.
+   *
+   * The patterns are rendered sorted, not in registration order: they become the keys of the emitted
+   * `nano-staged-config.ts` object, which the shared ESLint config's `perfectionist/sort-objects` checks,
+   * and answers register them in question order (markdownlint's `*.md` before the `*.{ts,tsx,mts}` that
+   * `preset: demo` forces in). Commands under one pattern keep their order, since nano-staged runs them so.
    */
   addLintStagedCommand(pattern, command) {
     const commands = this._lintStagedPatterns.get(pattern) ?? [];
@@ -2755,13 +3107,23 @@ var TemplateBuilder = class {
     this._sentenceCaseBrands.add(brand);
     return this;
   }
+  /**
+   * Registers a config the emitted `tsconfig.json` extends after its base, such as a framework's JSX preset.
+   *
+   * Collected here rather than composed from partials for the same reason as {@link addLintStagedCommand}: the
+   * `extends` value is a list whose last entry must not carry a comma, and a single entry is written as a plain string.
+   */
+  addTsconfigExtends(config) {
+    this._tsconfigExtends.add(config);
+    return this;
+  }
 };
 
 // src/versions.ts
-import { log as log2 } from "@clack/prompts";
+import { log as log3 } from "@clack/prompts";
 var PINNED_VERSIONS = {
   "@babel/core": {
-    check: `node -e "process.stdout.write(require('@rollup/plugin-babel/package.json').peerDependencies['@babel/core'])"`,
+    check: `node -e "const fs=require('node:fs');process.stdout.write(JSON.parse(fs.readFileSync('node_modules/@rollup/plugin-babel/package.json','utf8')).peerDependencies['@babel/core'])"`,
     checkRequires: "@rollup/plugin-babel",
     expect: "^7.0.0",
     manualCheck: null,
@@ -2771,7 +3133,7 @@ var PINNED_VERSIONS = {
     why: "@babel/core is only ever added alongside @rollup/plugin-babel, whose newest release still peers on `^7.0.0` while the registry tags 8.x as latest. Resolving latest therefore produced an `npm install` that fails outright with ERESOLVE for rollup with preact, react or solid. The check reads the peer range @rollup/plugin-babel itself declares, so the pin retires itself when that widens to ^8."
   },
   "@babel/plugin-transform-react-jsx": {
-    check: `node -e "process.stdout.write(require('@rollup/plugin-babel/package.json').peerDependencies['@babel/core'])"`,
+    check: `node -e "const fs=require('node:fs');process.stdout.write(JSON.parse(fs.readFileSync('node_modules/@rollup/plugin-babel/package.json','utf8')).peerDependencies['@babel/core'])"`,
     checkRequires: "@rollup/plugin-babel",
     expect: "^7.0.0",
     manualCheck: null,
@@ -2781,7 +3143,7 @@ var PINNED_VERSIONS = {
     why: "Held on 7.x for the same reason as @babel/core, and it has to move as one set: 8.0.1 peers on `@babel/core@^8.0.0`, so pinning core to 7 without pinning this one just moves the ERESOLVE. Only ever added for rollup + preact, which is exactly where @rollup/plugin-babel forces 7."
   },
   "@babel/preset-react": {
-    check: `node -e "process.stdout.write(require('@rollup/plugin-babel/package.json').peerDependencies['@babel/core'])"`,
+    check: `node -e "const fs=require('node:fs');process.stdout.write(JSON.parse(fs.readFileSync('node_modules/@rollup/plugin-babel/package.json','utf8')).peerDependencies['@babel/core'])"`,
     checkRequires: "@rollup/plugin-babel",
     expect: "^7.0.0",
     manualCheck: null,
@@ -2791,7 +3153,7 @@ var PINNED_VERSIONS = {
     why: "Held on 7.x for the same reason as @babel/core, and it has to move as one set: 8.0.1 peers on `@babel/core@^8.0.0`. Only ever added for rollup + react, which is exactly where @rollup/plugin-babel forces 7."
   },
   "@babel/preset-typescript": {
-    check: `node -e "process.stdout.write(require('@rollup/plugin-babel/package.json').peerDependencies['@babel/core'])"`,
+    check: `node -e "const fs=require('node:fs');process.stdout.write(JSON.parse(fs.readFileSync('node_modules/@rollup/plugin-babel/package.json','utf8')).peerDependencies['@babel/core'])"`,
     checkRequires: "@rollup/plugin-babel",
     expect: "^7.0.0",
     manualCheck: null,
@@ -2813,23 +3175,73 @@ var PINNED_VERSIONS = {
   "@codemirror/state": {
     check: `node -e "process.stdout.write(require('obsidian/package.json').peerDependencies['@codemirror/state'])"`,
     checkRequires: "obsidian",
-    expect: "6.5.0",
+    expect: "6.7.6",
     manualCheck: null,
     needsOverride: true,
     section: "devDependencies",
-    version: "6.5.0",
+    version: "6.7.6",
     why: "obsidian peers on this exact version. Anything else fails npm install with ERESOLVE, and a second copy in the tree breaks editor extensions at runtime."
   },
   "@codemirror/view": {
     check: `node -e "process.stdout.write(require('obsidian/package.json').peerDependencies['@codemirror/view'])"`,
     checkRequires: "obsidian",
-    expect: "6.38.6",
+    expect: "6.43.13",
     manualCheck: null,
     needsOverride: true,
     section: "devDependencies",
-    version: "6.38.6",
+    version: "6.43.13",
     why: "obsidian peers on this exact version. Anything else fails npm install with ERESOLVE, and a second copy in the tree breaks editor extensions at runtime."
   },
+  "@wdio/cli": {
+    check: `node -e "const fs=require('node:fs');process.stdout.write(JSON.parse(fs.readFileSync('node_modules/wdio-obsidian-service/package.json','utf8')).peerDependencies.webdriverio)"`,
+    checkRequires: "wdio-obsidian-service",
+    expect: "^9.18.1",
+    manualCheck: null,
+    needsOverride: false,
+    section: "devDependencies",
+    version: "^9.32.0",
+    why: "wdio-obsidian-service peers on `webdriverio ^9.18.1`, while the registry tags wdio 10 as latest. Resolving latest installed a webdriverio 10 tree beside the service and failed `npm install` with ERESOLVE. The wdio packages move as one set, and the check reads the service's own peer range, so the pin retires itself when that moves to ^10."
+  },
+  "@wdio/globals": {
+    check: `node -e "const fs=require('node:fs');process.stdout.write(JSON.parse(fs.readFileSync('node_modules/wdio-obsidian-service/package.json','utf8')).peerDependencies.webdriverio)"`,
+    checkRequires: "wdio-obsidian-service",
+    expect: "^9.18.1",
+    manualCheck: null,
+    needsOverride: false,
+    section: "devDependencies",
+    version: "^9.31.3",
+    why: "wdio-obsidian-service peers on `webdriverio ^9.18.1`, while the registry tags wdio 10 as latest. Resolving latest installed a webdriverio 10 tree beside the service and failed `npm install` with ERESOLVE. The wdio packages move as one set, and the check reads the service's own peer range, so the pin retires itself when that moves to ^10."
+  },
+  "@wdio/local-runner": {
+    check: `node -e "const fs=require('node:fs');process.stdout.write(JSON.parse(fs.readFileSync('node_modules/wdio-obsidian-service/package.json','utf8')).peerDependencies.webdriverio)"`,
+    checkRequires: "wdio-obsidian-service",
+    expect: "^9.18.1",
+    manualCheck: null,
+    needsOverride: false,
+    section: "devDependencies",
+    version: "^9.32.0",
+    why: "wdio-obsidian-service peers on `webdriverio ^9.18.1`, while the registry tags wdio 10 as latest. Resolving latest installed a webdriverio 10 tree beside the service and failed `npm install` with ERESOLVE. The wdio packages move as one set, and the check reads the service's own peer range, so the pin retires itself when that moves to ^10."
+  },
+  "@wdio/mocha-framework": {
+    check: `node -e "const fs=require('node:fs');process.stdout.write(JSON.parse(fs.readFileSync('node_modules/wdio-obsidian-service/package.json','utf8')).peerDependencies.webdriverio)"`,
+    checkRequires: "wdio-obsidian-service",
+    expect: "^9.18.1",
+    manualCheck: null,
+    needsOverride: false,
+    section: "devDependencies",
+    version: "^9.32.0",
+    why: "wdio-obsidian-service peers on `webdriverio ^9.18.1`, while the registry tags wdio 10 as latest. Resolving latest installed a webdriverio 10 tree beside the service and failed `npm install` with ERESOLVE. The wdio packages move as one set, and the check reads the service's own peer range, so the pin retires itself when that moves to ^10."
+  },
+  "expect-webdriverio": {
+    check: `node -e "const fs=require('node:fs');process.stdout.write(JSON.parse(fs.readFileSync('node_modules/wdio-obsidian-service/package.json','utf8')).peerDependencies.webdriverio)"`,
+    checkRequires: "wdio-obsidian-service",
+    expect: "^9.18.1",
+    manualCheck: null,
+    needsOverride: false,
+    section: "devDependencies",
+    version: "^6.1.0",
+    why: "Held on 6.x with the wdio packages: expect-webdriverio 7 and later peer on `webdriverio ^10`, and @wdio/globals 9 peers on `expect-webdriverio ^6`. wdio-obsidian-service peers on `webdriverio ^9.18.1`, while the registry tags wdio 10 as latest. Resolving latest installed a webdriverio 10 tree beside the service and failed `npm install` with ERESOLVE. The wdio packages move as one set, and the check reads the service's own peer range, so the pin retires itself when that moves to ^10."
+  },
   "moment": {
     check: null,
     checkRequires: null,
@@ -2856,17 +3268,17 @@ var ADVISORY_OVERRIDES = {
     check: `node -e "const fs=require('node:fs');process.stdout.write(JSON.parse(fs.readFileSync('node_modules/@wdio/utils/package.json','utf8')).dependencies['@puppeteer/browsers'])"`,
     expect: "^2.2.0",
     manualCheck: "The check reads @wdio/utils's own declared range, not a version, because that range is what makes the override necessary. When it moves to ^3 or later, @wdio/utils no longer pulls extract-zip in and both this override and this entry can go.",
-    requires: ["obsidian-dev-utils", "wdio-obsidian-service"],
+    requires: ["obsidian-integration-testing", "wdio-obsidian-service"],
     spec: "^3.2.1",
     why: "Clears GHSA-jmr9-qjv8-65gv (extract-zip unvalidated symlink path traversal). extract-zip is vulnerable at every published version, so there is nothing to override it to, and the direct dependency cannot be bumped either: even the newest webdriverio reaches extract-zip through @wdio/utils -> @puppeteer/browsers ^2.x. @puppeteer/browsers@3 replaced extract-zip with modern-tar, so forcing 3.x on @wdio/utils, the only consumer left on 2.x, removes the subtree. @wdio/utils imports only install, canDownload, resolveBuildId, detectBrowserPlatform, Browser, ChromeReleaseChannel, computeExecutablePath and the InstallOptions type, all still exported by 3.x, and both packages are ESM-only. Never take the `npm audit fix --force` remedy: it downgrades obsidian-integration-testing to 1.1.2."
   },
   "deepmerge-ts": {
-    check: `node -e "const fs=require('node:fs');process.stdout.write(JSON.parse(fs.readFileSync('node_modules/@wdio/utils/package.json','utf8')).dependencies['deepmerge-ts'])"`,
+    check: `node -e "const fs=require('node:fs');const path=['node_modules/obsidian-integration-testing/node_modules/@wdio/utils/package.json','node_modules/@wdio/utils/package.json'].find((candidate)=>fs.existsSync(candidate));process.stdout.write(JSON.parse(fs.readFileSync(path,'utf8')).dependencies['deepmerge-ts'])"`,
     expect: "^7.0.3",
-    manualCheck: "The check reads the range @wdio/utils declares, which is what forces the override. When it moves to ^8 or later the override and this entry can go. Before lifting it, re-run the deepmergeCustom probe: @wdio/config passes a `mergeArrays` handler that reads `meta.key`, and that is the API 8.0.0 renamed.",
-    requires: ["obsidian-dev-utils", "wdio-obsidian-service"],
+    manualCheck: "The check reads the range declared by the @wdio/utils that obsidian-integration-testing reaches, nested under it when the project also has a newer wdio, which is what forces the override. When it moves to ^8 or later the override and this entry can go. Before lifting it, re-run the deepmergeCustom probe: @wdio/config passes a `mergeArrays` handler that reads `meta.key`, and that is the API 8.0.0 renamed.",
+    requires: ["obsidian-integration-testing"],
     spec: "^8.0.2",
-    why: "Clears GHSA-ggr8-5vv4-36mx (stack exhaustion merging recursive object graphs), patched in 8.0.0. Every wdio package still declares ^7.0.3, including the newest, so no direct bump reaches it and `npm audit fix --force` only offers a downgrade of obsidian-integration-testing to 1.1.2. The forced major is safe for these consumers: 8.0.0 breaks by renaming the mergeInfo system and aligning the customization shorthand, and both surfaces were measured to behave identically on 7.1.6 and 8.0.1 in the exact shapes the tree uses -- @wdio/config's `deepmergeCustom` with a `mergeArrays` handler reading `meta.key` and returning `utils.actions.defaultMerge`, and webdriver's `deepmergeCustom({ mergeArrays: false })`. A scan of the whole installed tree found no other binding than `deepmerge` and `deepmergeCustom`."
+    why: "Clears GHSA-ggr8-5vv4-36mx (stack exhaustion merging recursive object graphs), patched in 8.0.0. @wdio/utils declares ^7.0.3 up to 9.30, and obsidian-integration-testing pins webdriverio 9.27.0, so no direct bump reaches it and `npm audit fix --force` only offers a downgrade of obsidian-integration-testing to 1.1.2. The forced major is safe for these consumers: 8.0.0 breaks by renaming the mergeInfo system and aligning the customization shorthand, and both surfaces were measured to behave identically on 7.1.6 and 8.0.1 in the exact shapes the tree uses -- @wdio/config's `deepmergeCustom` with a `mergeArrays` handler reading `meta.key` and returning `utils.actions.defaultMerge`, and webdriver's `deepmergeCustom({ mergeArrays: false })`. A scan of the whole installed tree found no other binding than `deepmerge` and `deepmergeCustom`."
   },
   "serialize-javascript": {
     check: `node -e "const fs=require('node:fs');process.stdout.write(JSON.parse(fs.readFileSync('node_modules/mocha/package.json','utf8')).dependencies['serialize-javascript'])"`,
@@ -2875,6 +3287,14 @@ var ADVISORY_OVERRIDES = {
     requires: ["@wdio/mocha-framework"],
     spec: "^7.1.1",
     why: "Clears GHSA-5c6j-r48x-rmvq (RCE via RegExp.flags and Date.prototype.toISOString) and GHSA-qj8w-gfj5-8c6v (CPU-exhaustion denial of service via crafted array-likes), both fixed in 7.0.5. No direct bump reaches it: mocha declares `serialize-javascript@^6.0.2` at every published version including 11.8.0, and the only consumer here is @wdio/mocha-framework -> mocha. `npm audit fix --force` offers a DOWNGRADE to @wdio/mocha-framework@7.7.3 instead. The forced major is safe for the one call site that exists: mocha's `buffered-worker-pool.js` calls `serializeJavascript(opts, { unsafe: true, ignoreFunction: true })`, and 6.0.2 and 7.1.1 were measured to return byte-identical output for that exact option pair across RegExp, Date, Map, Set, undefined, BigInt, functions and a script-tag string. Note the call is on mocha's parallel-run path, which wdio does not take."
+  },
+  "smol-toml": {
+    check: `node -e "const fs=require('node:fs');const path=['node_modules/@mnaoumov/typescript-dev-toolkit/node_modules/markdownlint-cli2/package.json','node_modules/markdownlint-cli2/package.json'].find((candidate)=>fs.existsSync(candidate));process.stdout.write(JSON.parse(fs.readFileSync(path,'utf8')).dependencies['smol-toml'])"`,
+    expect: "1.8.0",
+    manualCheck: "The check reads the exact version pinned by the markdownlint-cli2 that @mnaoumov/typescript-dev-toolkit reaches, nested under it when the project also declares a newer markdownlint-cli2, which is what makes the override necessary. When the toolkit moves to markdownlint-cli2 ^0.24.0 or later, that copy pins 1.9.1 and the override and this entry can go.",
+    requires: ["@mnaoumov/obsidian-dev-toolkit", "@mnaoumov/typescript-dev-toolkit"],
+    spec: "^1.9.1",
+    why: "Clears GHSA-r4xh-jqrq-34v2 (quadratic-time parse() from parseKey rescanning to the end of the document), patched in 1.9.0. markdownlint-cli2 pinned `smol-toml` to exactly 1.8.0 up to 0.23.3, and @mnaoumov/typescript-dev-toolkit declares markdownlint-cli2 `^0.23.2`, which on a 0.x package stops below 0.24.0, the first release pinning 1.9.1. So the toolkit presets still reach 1.8.0 through the toolkit, and `npm audit fix --force` offers only a DOWNGRADE of markdownlint-cli2 to 0.21.0. The markdownlint answer's own markdownlint-cli2 resolves to 0.24.0 or later, so `standalone` needs no override. The spec stays inside the 1.x major, and markdownlint-cli2 imports only `parse`, to read a `.markdownlint-cli2.toml` config."
   }
 };
 var DESKTOP_RELEASES_JSON_URL = "https://raw.githubusercontent.com/obsidianmd/obsidian-releases/master/desktop-releases.json";
@@ -2997,7 +3417,7 @@ async function resolveVersions(dependencies) {
     resolved.set(packageName, `^${version}`);
   }
   if (failed.length > 0) {
-    log2.warn(`Could not look up the latest version of ${failed.join(", ")}. Falling back to "${FALLBACK_VERSION}".`);
+    log3.warn(`Could not look up the latest version of ${failed.join(", ")}. Falling back to "${FALLBACK_VERSION}".`);
   }
   return resolved;
 }
@@ -3015,6 +3435,7 @@ function hasPackage(dependencies, packageName) {
 var ASSET_EXTENSIONS = /* @__PURE__ */ new Set([".wasm"]);
 var JSON_INDENT_SPACES3 = 2;
 var UNRESOLVED_VERSION = "latest";
+var TOOLKIT_WORKFLOW_REF = "3.0.0";
 var BASE_TEMPLATE_FILES = [
   // Never empty: `tslib` and `typescript` below are false positives on every answer set.
   ".depcheckrc.json",
@@ -3023,6 +3444,9 @@ var BASE_TEMPLATE_FILES = [
   ".gitattributes",
   ".gitignore",
   ".npmrc",
+  // The same Node major as this repo's own `.nvmrc`. Every CI workflow reads it, the toolkit's reusable ones by
+  // Default, and without it they fall back to the latest LTS, which is not the version the project is developed on.
+  ".nvmrc",
   "CONTRIBUTING.md",
   "LICENSE",
   "README.md",
@@ -3080,7 +3504,9 @@ var DEMO_OVERRIDES = [
   { answerKey: "spellChecker", demoValue: "cspell", options: SPELL_CHECKER_OPTIONS },
   { answerKey: "styling", demoValue: "scss", options: STYLING_OPTIONS }
 ];
-function buildTemplate(answers, overlay = null) {
+var DEMO_PINNED_ANSWERS = { bundler: "esbuild", uiFramework: "none" };
+function buildTemplate(givenAnswers, overlay = null) {
+  const answers = pinPresetAnswers(givenAnswers);
   const builder = new TemplateBuilder();
   builder.addFiles(BASE_TEMPLATE_FILES).addPackage("@types/node").addPackage("jiti").addPackage("obsidian").addPackage("tslib").addDepcheckIgnore("tslib", "never imported by name: `importHelpers: true` in `tsconfig.json` makes the compiled output import it.").addPackage("typescript").addDepcheckIgnore("typescript", "the compiler `tsconfig.json` configures, reached by `tsc`, by the TypeScript step of the bundler and by the editor rather than by an import.").addSentenceCaseBrand(answers.pluginName).addPartial("common");
   const funding = resolveFunding(answers);
@@ -3114,40 +3540,45 @@ function buildTemplate(answers, overlay = null) {
       builder.addPartial(option.partialName);
     }
   }
+  if (builder.lintStagedPatterns.length > 0) {
+    addStagedFilesHook(builder, answers.preset);
+  }
+  if (isFrameworkPreset(answers.preset) && builder.buildOptions.length > 0) {
+    builder.addFiles(["scripts/build-options.ts"]);
+  }
   if (overlay) {
     applyOverlay(builder, overlay);
   }
-  if (builder.lintStagedPatterns.length > 0) {
-    addStagedFilesHook(builder);
-  }
   return builder;
 }
-function copyTemplates(answers, targetDir, currentVersion, existingConfig, resolvedVersions = /* @__PURE__ */ new Map(), minAppVersion = FALLBACK_MIN_APP_VERSION, overlay = null, projectFormatter) {
-  const templatesDir = join(getScriptDir(), "..", "templates", "default");
+function copyTemplates(givenAnswers, targetDir, currentVersion, existingConfig, resolvedVersions = /* @__PURE__ */ new Map(), minAppVersion = FALLBACK_MIN_APP_VERSION, overlay = null, projectFormatter) {
+  const answers = pinPresetAnswers(givenAnswers);
+  const templatesDir = join2(getScriptDir(), "..", "templates", "default");
   function findTemplate(relativePath) {
     if (overlay) {
-      const overlayPath = join(overlay.dir, relativePath);
-      if (existsSync2(overlayPath)) {
+      const overlayPath = join2(overlay.dir, relativePath);
+      if (existsSync3(overlayPath)) {
         return overlayPath;
       }
     }
-    const builtInPath = join(templatesDir, relativePath);
-    return existsSync2(builtInPath) ? builtInPath : null;
+    const builtInPath = join2(templatesDir, relativePath);
+    return existsSync3(builtInPath) ? builtInPath : null;
   }
-  const newConfig = {
-    fileHashes: {},
-    generatorVersion: currentVersion
-  };
   const builder = buildTemplate(answers, overlay);
   const templateFiles = builder.templateFiles;
   const partials = builder.partials;
   const dependencies = builder.dependencies;
+  const hasBuildOptions = templateFiles.has("scripts/build-options.ts");
   let currentTemplatePath = "";
   let renderRoot = "";
   const templateContext = {
     ...answers,
     ...getFundingTemplateContext(answers),
     _badges: builder.badges,
+    _buildOptionsArgument: hasBuildOptions ? "buildOptions" : "",
+    _buildOptionsImport: hasBuildOptions ? "\nimport { buildOptions } from './build-options.ts';\n" : "",
+    _buildOptionsLiteral: toObjectLiteral(builder.buildOptions),
+    _cspellIdentityWords: getCspellIdentityWords(answers),
     _depcheckIgnores: builder.depcheckIgnores,
     _dependencies: dependencies.map((dependency) => ({
       packageName: dependency.packageName,
@@ -3161,6 +3592,8 @@ function copyTemplates(answers, targetDir, currentVersion, existingConfig, resol
     _resolutions: Object.entries(buildResolutions(dependencies)).map(([packageName, spec]) => ({ packageName, spec })),
     _scripts: builder.scripts,
     _sentenceCaseBrands: builder.sentenceCaseBrands,
+    _toolkitWorkflowRef: TOOLKIT_WORKFLOW_REF,
+    _tsconfigExtendsJson: toTsconfigExtendsJson(builder.tsconfigExtends),
     pluginShortName: getPluginShortName(answers.pluginId),
     render(options) {
       const { indentLevel, section } = typeof options === "string" ? { indentLevel: 0, section: options } : { indentLevel: 0, section: void 0, ...options };
@@ -3176,7 +3609,7 @@ function copyTemplates(answers, targetDir, currentVersion, existingConfig, resol
         }
         currentTemplatePath = partialPath;
         renderRoot = previousRenderRoot || partialPath;
-        let rendered = ejs.render(readFileSync2(fullPath, "utf-8"), templateContext);
+        let rendered = ejs.render(readFileSync3(fullPath, "utf-8"), templateContext);
         if (indentLevel > 0) {
           const indent = "  ".repeat(indentLevel);
           rendered = rendered.replaceAll(/^(?<Content>.+)$/gm, `${indent}$<Content>`);
@@ -3192,7 +3625,7 @@ function copyTemplates(answers, targetDir, currentVersion, existingConfig, resol
      *
      * A section that contributes imports emits them in PARTIAL order, which is the order the answers were
      * registered in {@link FEATURE_REGISTRIES} -- and that has nothing to do with the order an
-     * import-sorting lint rule wants. The obsidian-dev-utils presets now adopt that package's shared
+     * import-sorting lint rule wants. The toolkit presets now adopt obsidian-dev-toolkit's shared
      * ESLint config, which sorts imports as an ERROR, so `uiFramework=lit editorExtensions=codemirror`
      * emitted a `src/plugin.ts` that was red the moment it was generated. The sorting cannot be pushed
      * into the partials: each one knows only itself, and which others are beside it is the answer set.
@@ -3201,71 +3634,35 @@ function copyTemplates(answers, targetDir, currentVersion, existingConfig, resol
       return sortImportStatements(text3);
     }
   };
-  const skipped = [];
-  const updated = [];
-  const created = [];
-  const written = [];
+  const renderedFiles = [];
   for (const registeredPath of templateFiles) {
     const destinationPath = getDestinationPath(registeredPath, answers);
-    const fullDestinationPath = join(targetDir, destinationPath);
     const isAsset = ASSET_EXTENSIONS.has(extname(registeredPath));
     const ejsPath = findTemplate(`${registeredPath}.ejs`);
     let rendered;
     if (isAsset) {
       currentTemplatePath = registeredPath;
-      rendered = readFileSync2(findTemplate(registeredPath) ?? join(templatesDir, registeredPath));
+      rendered = readFileSync3(findTemplate(registeredPath) ?? join2(templatesDir, registeredPath));
     } else if (ejsPath === null) {
       currentTemplatePath = `${registeredPath}.ejs`;
       rendered = templateContext["render"]();
     } else {
       currentTemplatePath = `${registeredPath}.ejs`;
       try {
-        rendered = ejs.render(readFileSync2(ejsPath, "utf-8"), templateContext);
+        rendered = ejs.render(readFileSync3(ejsPath, "utf-8"), templateContext);
       } catch (error) {
         if (overlay && ejsPath.startsWith(overlay.dir)) {
           throw new Error(`${ejsPath} failed to render: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
         }
-        rendered = readFileSync2(ejsPath, "utf-8");
-      }
-    }
-    const newHash = sha256(rendered);
-    if (existingConfig && existsSync2(fullDestinationPath)) {
-      const currentContent = isAsset ? readFileSync2(fullDestinationPath) : readFileSync2(fullDestinationPath, "utf-8");
-      const currentHash = sha256(currentContent);
-      const originalHash = existingConfig.fileHashes[destinationPath];
-      if (matchesRender(currentHash, newHash, projectFormatter, destinationPath, rendered)) {
-        newConfig.fileHashes[destinationPath] = currentHash;
-        continue;
+        rendered = readFileSync3(ejsPath, "utf-8");
       }
-      if (originalHash === void 0) {
-        skipped.push(destinationPath);
-        continue;
-      }
-      if (currentHash !== originalHash) {
-        skipped.push(destinationPath);
-        newConfig.fileHashes[destinationPath] = originalHash;
-        continue;
-      }
-      updated.push(destinationPath);
-    } else {
-      created.push(destinationPath);
-    }
-    newConfig.fileHashes[destinationPath] = newHash;
-    const destDir = dirname(fullDestinationPath);
-    if (!existsSync2(destDir)) {
-      mkdirSync(destDir, { recursive: true });
     }
-    writeFileSync(fullDestinationPath, rendered);
-    written.push(destinationPath);
+    renderedFiles.push({ content: rendered, destinationPath });
   }
-  formatWrittenFiles(projectFormatter, targetDir, written, newConfig);
-  const configPath = join(targetDir, CONFIG_FILE_NAME);
-  writeFileSync(configPath, `${JSON.stringify(newConfig, null, JSON_INDENT_SPACES3)}
-`);
-  if (existingConfig) {
-    logUpdateSummary(updated, created, skipped);
+  if (answers.preset === DOCS_SHOWCASE_PRESET) {
+    renderedFiles.push(...readDocsShowcaseFiles(join2(getScriptDir(), "..")));
   }
-  return newConfig;
+  return writeGeneratedFiles(renderedFiles, targetDir, currentVersion, existingConfig, projectFormatter);
 }
 function getDestinationPath(templatePath, answers) {
   return templatePath.replace(/%= (?<AnswerKey>.+?) %/g, (_match, ...args) => String(answers[String(args[0])]));
@@ -3279,20 +3676,23 @@ function isPartialTemplatePath(templatePath) {
   return markerIndex > 0 && PARTIAL_NAME_PATTERN.test(fileName.slice(markerIndex + 1));
 }
 function loadConfig(dir) {
-  const configPath = join(dir, CONFIG_FILE_NAME);
-  if (!existsSync2(configPath)) {
+  const configPath = join2(dir, CONFIG_FILE_NAME);
+  if (!existsSync3(configPath)) {
     return null;
   }
-  const parsed = JSON.parse(readFileSync2(configPath, "utf-8"));
+  const parsed = JSON.parse(readFileSync3(configPath, "utf-8"));
   const raw = parsed;
   migrateAnswers(raw);
   return parsed;
 }
+function pinPresetAnswers(answers) {
+  return answers.preset === "demo" ? { ...answers, ...DEMO_PINNED_ANSWERS } : answers;
+}
 function recordHashesOnDisk(targetDir, config) {
   const fileHashes = {};
   for (const [destinationPath, hash] of Object.entries(config.fileHashes)) {
-    const fullPath = join(targetDir, destinationPath);
-    fileHashes[destinationPath] = existsSync2(fullPath) ? sha256(readFileSync2(fullPath)) : hash;
+    const fullPath = join2(targetDir, destinationPath);
+    fileHashes[destinationPath] = existsSync3(fullPath) ? sha256(readFileSync3(fullPath)) : hash;
   }
   return { ...config, fileHashes };
 }
@@ -3321,6 +3721,56 @@ function sortImportStatements(text3) {
   return `${statements.join("\n")}
 `;
 }
+function writeGeneratedFiles(files, targetDir, currentVersion, existingConfig, projectFormatter) {
+  const newConfig = {
+    fileHashes: {},
+    generatorVersion: currentVersion
+  };
+  const skipped = [];
+  const updated = [];
+  const created = [];
+  const written = [];
+  for (const { content: rendered, destinationPath } of files) {
+    const fullDestinationPath = join2(targetDir, destinationPath);
+    const newHash = sha256(rendered);
+    if (existingConfig && existsSync3(fullDestinationPath)) {
+      const currentContent = Buffer.isBuffer(rendered) ? readFileSync3(fullDestinationPath) : readFileSync3(fullDestinationPath, "utf-8");
+      const currentHash = sha256(currentContent);
+      const originalHash = existingConfig.fileHashes[destinationPath];
+      if (matchesRender(currentHash, newHash, projectFormatter, destinationPath, rendered)) {
+        newConfig.fileHashes[destinationPath] = currentHash;
+        continue;
+      }
+      if (originalHash === void 0) {
+        skipped.push(destinationPath);
+        continue;
+      }
+      if (currentHash !== originalHash) {
+        skipped.push(destinationPath);
+        newConfig.fileHashes[destinationPath] = originalHash;
+        continue;
+      }
+      updated.push(destinationPath);
+    } else {
+      created.push(destinationPath);
+    }
+    newConfig.fileHashes[destinationPath] = newHash;
+    const destDir = dirname(fullDestinationPath);
+    if (!existsSync3(destDir)) {
+      mkdirSync(destDir, { recursive: true });
+    }
+    writeFileSync(fullDestinationPath, rendered);
+    written.push(destinationPath);
+  }
+  formatWrittenFiles(projectFormatter, targetDir, written, newConfig);
+  const configPath = join2(targetDir, CONFIG_FILE_NAME);
+  writeFileSync(configPath, `${JSON.stringify(newConfig, null, JSON_INDENT_SPACES3)}
+`);
+  if (existingConfig) {
+    logUpdateSummary(updated, created, skipped);
+  }
+  return newConfig;
+}
 function applyOverlay(builder, overlay) {
   builder.addFiles([...overlay.files]);
   for (const packageName of overlay.packages) {
@@ -3343,9 +3793,13 @@ function formatWrittenFiles(projectFormatter, targetDir, written, config) {
   }
   projectFormatter.formatFiles(textFiles);
   for (const destinationPath of textFiles) {
-    config.fileHashes[destinationPath] = sha256(readFileSync2(join(targetDir, destinationPath)));
+    config.fileHashes[destinationPath] = sha256(readFileSync3(join2(targetDir, destinationPath)));
   }
 }
+function getCspellIdentityWords(answers) {
+  const words = [answers.authorGitHubName, "mnaoumov"];
+  return words.filter((word, index) => words.findIndex((other) => other.toLowerCase() === word.toLowerCase()) === index);
+}
 function getFundingTemplateContext(answers) {
   const funding = resolveFunding(answers);
   return {
@@ -3363,25 +3817,25 @@ function importedModule(block) {
 }
 function logUpdateSummary(updated, created, skipped) {
   if (updated.length > 0) {
-    log3.success(`Updated ${String(updated.length)} file(s):`);
+    log4.success(`Updated ${String(updated.length)} file(s):`);
     for (const f of updated) {
-      log3.info(`  ${f}`);
+      log4.info(`  ${f}`);
     }
   }
   if (created.length > 0) {
-    log3.success(`Created ${String(created.length)} new file(s):`);
+    log4.success(`Created ${String(created.length)} new file(s):`);
     for (const f of created) {
-      log3.info(`  ${f}`);
+      log4.info(`  ${f}`);
     }
   }
   if (skipped.length > 0) {
-    log3.warn(`Skipped ${String(skipped.length)} file(s) with local modifications:`);
+    log4.warn(`Skipped ${String(skipped.length)} file(s) with local modifications:`);
     for (const f of skipped) {
-      log3.info(`  ${f}`);
+      log4.info(`  ${f}`);
     }
   }
   if (updated.length === 0 && created.length === 0) {
-    log3.info("Everything is already up to date.");
+    log4.info("Everything is already up to date.");
   }
 }
 function matchesRender(currentHash, newHash, projectFormatter, destinationPath, rendered) {
@@ -3416,6 +3870,11 @@ function migrateAnswers(raw) {
   answers["fundingUsername"] ??= answers["authorGitHubName"];
   answers["coverageBadge"] ??= "none";
   delete answers["pluginShortName"];
+  for (const [key, value] of Object.entries(answers)) {
+    if (typeof value === "string") {
+      answers[key] = resolveDeprecatedAnswer(key, value, CONFIG_FILE_NAME);
+    }
+  }
 }
 function migrateFundingAnswers(answers) {
   if (answers["fundingPlatform"] !== void 0) {
@@ -3450,8 +3909,215 @@ function migrateFundingAnswers(answers) {
 function sha256(content) {
   return createHash("sha256").update(content).digest("hex");
 }
+function toObjectLiteral(options) {
+  return options.length === 0 ? "{}" : `{
+${options.map((option) => `  ${option.key}: ${option.value}`).join(",\n")}
+}`;
+}
+function toTsconfigExtendsJson(extraConfigs) {
+  const base = JSON.stringify("@tsconfig/strictest/tsconfig.json");
+  return extraConfigs.length === 0 ? base : `[
+${[base, ...extraConfigs.map((config) => JSON.stringify(config))].map((config) => `    ${config}`).join(",\n")}
+  ]`;
+}
+
+// src/upstream-snapshot.ts
+import {
+  existsSync as existsSync4,
+  readdirSync as readdirSync2,
+  readFileSync as readFileSync4
+} from "node:fs";
+import {
+  join as join3,
+  relative as relative2
+} from "node:path";
+var VENDORED_SUFFIX = ".vendored";
+var REGULAR_FILE_MODES = /* @__PURE__ */ new Set(["100644", "100755"]);
+async function fetchUpstreamSnapshot(repo, ref) {
+  const headers = { Accept: "application/vnd.github+json" };
+  const token = process.env["GITHUB_TOKEN"];
+  if (token) {
+    headers["Authorization"] = `Bearer ${token}`;
+  }
+  const commit = await fetchJson(`https://api.github.com/repos/${repo}/commits/${encodeURIComponent(ref)}`, headers);
+  const tree = await fetchJson(`https://api.github.com/repos/${repo}/git/trees/${commit.sha}?recursive=1`, headers);
+  if (tree.truncated) {
+    throw new Error(`The tree of ${repo}@${commit.sha} is too large for one API response.`);
+  }
+  const paths = tree.tree.filter((entry) => entry.type === "blob" && REGULAR_FILE_MODES.has(entry.mode)).map((entry) => entry.path);
+  const contents = await Promise.all(paths.map(async (path) => {
+    const response = await fetch(`https://raw.githubusercontent.com/${repo}/${commit.sha}/${path.split("/").map(encodeURIComponent).join("/")}`);
+    if (!response.ok) {
+      throw new Error(`Could not download ${path} from ${repo}@${commit.sha}: HTTP ${String(response.status)}.`);
+    }
+    return Buffer.from(await response.arrayBuffer());
+  }));
+  return {
+    commit: commit.sha,
+    files: new Map(paths.map((path, index) => [path, contents[index] ?? Buffer.alloc(0)]))
+  };
+}
+function readUpstream(upstreamsPath, name) {
+  const parsed = JSON.parse(readFileSync4(upstreamsPath, "utf-8"));
+  const upstream = parsed.upstreams.find((candidate) => candidate.name === name);
+  if (!upstream) {
+    throw new Error(`${upstreamsPath} has no upstream named "${name}".`);
+  }
+  return upstream;
+}
+function readVendoredFiles(dir) {
+  const files = /* @__PURE__ */ new Map();
+  if (!existsSync4(dir)) {
+    return files;
+  }
+  const paths = readdirSync2(dir, { recursive: true, withFileTypes: true }).filter((entry) => entry.isFile() && entry.name.endsWith(VENDORED_SUFFIX)).map((entry) => join3(entry.parentPath, entry.name)).sort();
+  for (const fullPath of paths) {
+    const upstreamPath = relative2(dir, fullPath).replaceAll("\\", "/").slice(0, -VENDORED_SUFFIX.length);
+    files.set(upstreamPath, readFileSync4(fullPath));
+  }
+  return files;
+}
+async function fetchJson(url, headers) {
+  const response = await fetch(url, { headers });
+  if (!response.ok) {
+    throw new Error(`GET ${url} failed: HTTP ${String(response.status)}.`);
+  }
+  return await response.json();
+}
+
+// src/official-sample.ts
+var OFFICIAL_SAMPLE_UPSTREAM_NAME = "obsidian-sample-plugin";
+var OFFICIAL_SAMPLE_FILES_DIR = join4("templates", "official-sample", "files");
+var OFFICIAL_SAMPLE_PINNED_ANSWERS = {
+  formatter: "none",
+  packageManager: "npm"
+};
+function applyOfficialSampleIdentity(files, answers) {
+  const packageName = `obsidian-${answers.pluginId}`;
+  const result = new Map(files);
+  editJson(result, "manifest.json", (manifest) => {
+    const fundingUrl = resolveFunding(answers)?.getUrl(answers);
+    const edited = {};
+    for (const [key, value] of Object.entries(manifest)) {
+      switch (key) {
+        case "author":
+          edited[key] = answers.authorName;
+          break;
+        case "authorUrl":
+          edited[key] = `https://github.com/${answers.authorGitHubName}`;
+          break;
+        case "description":
+          edited[key] = answers.pluginDescription;
+          break;
+        case "fundingUrl":
+          if (fundingUrl) {
+            edited[key] = fundingUrl;
+          }
+          break;
+        case "id":
+          edited[key] = answers.pluginId;
+          break;
+        case "name":
+          edited[key] = answers.pluginName;
+          break;
+        default:
+          edited[key] = value;
+      }
+    }
+    return edited;
+  });
+  const upstreamPackageName = readUpstreamPackageName(files);
+  editJson(result, "package.json", (packageJson) => ({ ...packageJson, name: packageName }));
+  editJson(result, "package-lock.json", (lock) => renamePackageInLock(lock, upstreamPackageName, packageName));
+  const readme = result.get("README.md");
+  if (readme) {
+    result.set("README.md", Buffer.from(readme.toString("utf-8").replace(/^# .*$/m, `# ${answers.pluginName}`), "utf-8"));
+  }
+  return result;
+}
+function copyOfficialSample(answers, targetDir, currentVersion, existingConfig, snapshot) {
+  const files = applyOfficialSampleIdentity(snapshot.files, answers);
+  const config = writeGeneratedFiles(
+    [...files].map(([destinationPath, content]) => ({ content, destinationPath })),
+    targetDir,
+    currentVersion,
+    existingConfig
+  );
+  return { ...config, upstreamCommit: snapshot.commit };
+}
+function getPackageRoot() {
+  return join4(getScriptDir(), "..");
+}
+function getUpstreamsPath() {
+  return join4(getPackageRoot(), "upstreams.json");
+}
+function loadOfficialSampleSnapshot() {
+  const upstream = readUpstream(getUpstreamsPath(), OFFICIAL_SAMPLE_UPSTREAM_NAME);
+  const files = readVendoredFiles(join4(getPackageRoot(), OFFICIAL_SAMPLE_FILES_DIR));
+  if (files.size === 0) {
+    throw new Error(`The vendored snapshot of ${upstream.repo} is missing from ${OFFICIAL_SAMPLE_FILES_DIR}.`);
+  }
+  return { commit: upstream.commit, files };
+}
+function editJson(files, path, edit) {
+  const content = files.get(path);
+  if (!content) {
+    return;
+  }
+  const text3 = content.toString("utf-8");
+  const indent = /^\{\r?\n(?<Indent>[ \t]+)/.exec(text3)?.groups?.["Indent"] ?? "	";
+  const finalNewline = /\r?\n$/.exec(text3)?.[0] ?? "";
+  const edited = edit(JSON.parse(text3));
+  files.set(path, Buffer.from(`${JSON.stringify(edited, null, indent)}${finalNewline}`, "utf-8"));
+}
+function readUpstreamPackageName(files) {
+  const content = files.get("package.json");
+  if (!content) {
+    return void 0;
+  }
+  const name = JSON.parse(content.toString("utf-8"))["name"];
+  return typeof name === "string" ? name : void 0;
+}
+function renamePackageInLock(lock, upstreamName, packageName) {
+  const renamed = { ...lock };
+  if (renamed["name"] === upstreamName) {
+    renamed["name"] = packageName;
+  }
+  const packages = renamed["packages"];
+  if (typeof packages === "object" && packages !== null) {
+    const root = packages[""];
+    if (typeof root === "object" && root !== null && root["name"] === upstreamName) {
+      renamed["packages"] = { ...packages, "": { ...root, name: packageName } };
+    }
+  }
+  return renamed;
+}
+
+// src/overlay.ts
+import {
+  existsSync as existsSync6,
+  readdirSync as readdirSync4,
+  readFileSync as readFileSync6,
+  statSync as statSync2
+} from "node:fs";
+import {
+  isAbsolute,
+  join as join6,
+  relative as relative3,
+  resolve
+} from "node:path";
 
 // src/plan-checks.ts
+import {
+  existsSync as existsSync5,
+  readdirSync as readdirSync3,
+  readFileSync as readFileSync5,
+  statSync
+} from "node:fs";
+import {
+  extname as extname2,
+  join as join5
+} from "node:path";
 var EJS_SUFFIX = ".ejs";
 var RENDER_SITE_PATTERN = /(?:<%[-=]?|\$\{)\s*render\(\s*(?:'(?<Section>[^']*)'|\{(?<Options>[^}]*)\})/g;
 var SECTION_OPTION_PATTERN = /section\s*:\s*'(?<Section>[^']*)'/;
@@ -3485,7 +4151,7 @@ function loadTemplateInventory(templatesDir = defaultTemplatesDir()) {
       continue;
     }
     const withoutSuffix = relativePath.slice(0, -EJS_SUFFIX.length);
-    const body = readFileSync3(join2(templatesDir, relativePath), "utf-8");
+    const body = readFileSync5(join5(templatesDir, relativePath), "utf-8");
     if (isPartialTemplatePath(relativePath)) {
       partials.push(parsePartialPath(relativePath));
     } else {
@@ -3538,7 +4204,7 @@ function parsePartialPath(relativePath) {
   };
 }
 function defaultTemplatesDir() {
-  return join2(getScriptDir(), "..", "templates", "default");
+  return join5(getScriptDir(), "..", "templates", "default");
 }
 function getRenderBase(templatePath) {
   if (!isPartialTemplatePath(templatePath)) {
@@ -3548,14 +4214,14 @@ function getRenderBase(templatePath) {
   return isPartialTemplatePath(basePath) ? getRenderBase(basePath) : templatePath;
 }
 function walkTemplates(templatesDir, relativeDir) {
-  const absoluteDir = join2(templatesDir, relativeDir);
-  if (!existsSync3(absoluteDir)) {
+  const absoluteDir = join5(templatesDir, relativeDir);
+  if (!existsSync5(absoluteDir)) {
     return [];
   }
   const found = [];
-  for (const entry of readdirSync(absoluteDir)) {
+  for (const entry of readdirSync3(absoluteDir)) {
     const relativePath = relativeDir === "" ? entry : `${relativeDir}/${entry}`;
-    if (statSync(join2(templatesDir, relativePath)).isDirectory()) {
+    if (statSync(join5(templatesDir, relativePath)).isDirectory()) {
       found.push(...walkTemplates(templatesDir, relativePath));
     } else {
       found.push(relativePath);
@@ -3572,11 +4238,11 @@ var MANIFEST_KEYS = ["badges", "files", "packages", "partials"];
 var PACKAGE_NAME_PATTERN = /^(?:@[a-z0-9-~][a-z0-9-._~]*\/)?[a-z0-9-~][a-z0-9-._~]*$/;
 function loadOverlay(dir, builtIn = loadTemplateInventory()) {
   const absoluteDir = resolve(dir);
-  if (!existsSync4(absoluteDir) || !statSync2(absoluteDir).isDirectory()) {
+  if (!existsSync6(absoluteDir) || !statSync2(absoluteDir).isDirectory()) {
     throw new Error(`Custom template directory not found: ${absoluteDir}`);
   }
-  const manifestPath = join3(absoluteDir, OVERLAY_MANIFEST_FILE_NAME);
-  if (!existsSync4(manifestPath)) {
+  const manifestPath = join6(absoluteDir, OVERLAY_MANIFEST_FILE_NAME);
+  if (!existsSync6(manifestPath)) {
     throw new Error(`Custom template directory has no ${OVERLAY_MANIFEST_FILE_NAME}: ${absoluteDir}`);
   }
   const manifest = readManifest(manifestPath);
@@ -3589,7 +4255,7 @@ ${problems.map((problem) => `  - ${problem}`).join("\n")}`);
   return overlay;
 }
 function toRecordedOverlayPath(overlayDir, projectDir) {
-  const relativePath = relative(projectDir, overlayDir);
+  const relativePath = relative3(projectDir, overlayDir);
   return isAbsolute(relativePath) ? relativePath : relativePath.replaceAll("\\", "/");
 }
 function findManifestProblems(overlay, own, builtIn) {
@@ -3688,7 +4354,7 @@ function listStrayFiles(dir, own) {
 function readManifest(manifestPath) {
   let parsed;
   try {
-    parsed = JSON.parse(readFileSync4(manifestPath, "utf-8"));
+    parsed = JSON.parse(readFileSync6(manifestPath, "utf-8"));
   } catch {
     throw new Error(`${manifestPath} is not valid JSON.`);
   }
@@ -3717,9 +4383,9 @@ function readManifest(manifestPath) {
 }
 function walkFiles(root, relativeDir) {
   const found = [];
-  for (const entry of readdirSync2(join3(root, relativeDir))) {
+  for (const entry of readdirSync4(join6(root, relativeDir))) {
     const relativePath = relativeDir === "" ? entry : `${relativeDir}/${entry}`;
-    if (statSync2(join3(root, relativePath)).isDirectory()) {
+    if (statSync2(join6(root, relativePath)).isDirectory()) {
       found.push(...walkFiles(root, relativePath));
     } else {
       found.push(relativePath);
@@ -3731,10 +4397,10 @@ function walkFiles(root, relativeDir) {
 // src/project-formatter.ts
 import { spawnSync } from "node:child_process";
 import {
-  existsSync as existsSync5,
-  readFileSync as readFileSync5
+  existsSync as existsSync7,
+  readFileSync as readFileSync7
 } from "node:fs";
-import { join as join4 } from "node:path";
+import { join as join7 } from "node:path";
 import process2 from "node:process";
 var FORMATTER_COMMANDS = {
   biome: {
@@ -3769,14 +4435,14 @@ function createProjectFormatter(targetDir, formatter) {
   };
 }
 function resolveBin(targetDir, packageName) {
-  const packageDir = join4(targetDir, "node_modules", packageName);
-  const packageJsonPath = join4(packageDir, "package.json");
-  if (!existsSync5(packageJsonPath)) {
+  const packageDir = join7(targetDir, "node_modules", packageName);
+  const packageJsonPath = join7(packageDir, "package.json");
+  if (!existsSync7(packageJsonPath)) {
     return null;
   }
-  const { bin } = JSON.parse(readFileSync5(packageJsonPath, "utf-8"));
+  const { bin } = JSON.parse(readFileSync7(packageJsonPath, "utf-8"));
   const relativeBin = typeof bin === "string" ? bin : Object.values(bin ?? {})[0];
-  return relativeBin === void 0 ? null : join4(packageDir, relativeBin);
+  return relativeBin === void 0 ? null : join7(packageDir, relativeBin);
 }
 function runCli(binPath, targetDir, args, input) {
   const result = spawnSync(process2.execPath, [binPath, ...args], { cwd: targetDir, encoding: "utf-8", input });
@@ -3786,7 +4452,22 @@ function runCli(binPath, targetDir, args, input) {
 // src/main.ts
 var ARGV_OFFSET = 2;
 var JSON_INDENT_SPACES4 = 2;
+var SHORT_SHA_LENGTH = 7;
 var SCRIPT_MODE = 493;
+function applyPresetFlags(answers, cliArgs, hasOverlay) {
+  if (!isOfficialSamplePreset(answers.preset)) {
+    if (cliArgs.latest) {
+      exitWithUsageError(`--latest picks which upstream tree preset=official-sample copies, and the preset is ${answers.preset}.
+Drop --latest, or pass --preset=official-sample.`);
+    }
+    return answers;
+  }
+  if (hasOverlay) {
+    exitWithUsageError(`--customTemplate layers over the built-in templates, and preset=official-sample renders none: it copies obsidianmd/obsidian-sample-plugin as it is.
+Drop --customTemplate, or choose another preset.`);
+  }
+  return { ...answers, ...OFFICIAL_SAMPLE_PINNED_ANSWERS };
+}
 function assertManifestAnswersAreListable(answers) {
   const problems = findUnlistableManifestAnswers(answers);
   if (problems.length === 0) {
@@ -3802,7 +4483,7 @@ function buildSavedConfig(newConfig, answers, overlay, targetDir) {
 async function checkForUpdates(currentVersion) {
   const latestVer = await fetchLatestVersion("@mnaoumov/create-obsidian-plugin");
   if (latestVer !== null && compare(currentVersion, latestVer) < 0) {
-    log4.warn(`Your version is outdated. Latest: ${latestVer}. Update with:
+    log5.warn(`Your version is outdated. Latest: ${latestVer}. Update with:
   npm install -g @mnaoumov/create-obsidian-plugin`);
   }
 }
@@ -3810,8 +4491,8 @@ async function detectMode(cliArgs) {
   if (cliArgs.mode) {
     return cliArgs.mode;
   }
-  const configPath = join5(process.cwd(), CONFIG_FILE_NAME);
-  if (existsSync6(configPath)) {
+  const configPath = join8(process.cwd(), CONFIG_FILE_NAME);
+  if (existsSync8(configPath)) {
     if (cliArgs.useDefaults) {
       exitWithUsageError(`Existing project detected (${CONFIG_FILE_NAME}), and --yes cannot ask whether to update it.
 Pass --mode=update to update it, or --mode=create to scaffold a new plugin beside it.`);
@@ -3830,7 +4511,7 @@ async function ensurePluginIdIsUnlisted(answers, useDefaults) {
   const listedIds = await fetchCommunityPluginIds();
   if (listedIds === null) {
     s.stop("Could not check the plugin id against the Community directory.");
-    log4.warn(`Could not fetch community-plugins.json, so "${answers.pluginId}" was not checked for a collision with a published plugin. The directory rejects a duplicate id, and an id can never be changed once published: check it by hand before submitting.`);
+    log5.warn(`Could not fetch community-plugins.json, so "${answers.pluginId}" was not checked for a collision with a published plugin. The directory rejects a duplicate id, and an id can never be changed once published: check it by hand before submitting.`);
     return answers;
   }
   const collision = validatePluginIdIsUnlisted(answers.pluginId, listedIds);
@@ -3843,7 +4524,7 @@ async function ensurePluginIdIsUnlisted(answers, useDefaults) {
     exitWithUsageError(`${collision}.
 Pass --pluginId=<value> to choose another.`);
   }
-  log4.warn(collision);
+  log5.warn(collision);
   const choice = await select2({
     initialValue: "reenter",
     message: `What should happen to "${answers.pluginId}"?`,
@@ -3901,6 +4582,10 @@ function exitWithUsageError(message) {
 `);
   process.exit(1);
 }
+function hasPrepareScript(targetDir) {
+  const packageJson = JSON.parse(readFileSync8(join8(targetDir, "package.json"), "utf-8"));
+  return Object.hasOwn(packageJson.scripts ?? {}, "prepare");
+}
 function loadOverlayOrExit(dir, hint = "") {
   try {
     return loadOverlay(dir);
@@ -3909,8 +4594,8 @@ function loadOverlayOrExit(dir, hint = "") {
   }
 }
 async function main() {
-  const packageJsonPath = join5(getScriptDir(), "..", "package.json");
-  const packageJson = JSON.parse(readFileSync6(packageJsonPath, "utf-8"));
+  const packageJsonPath = join8(getScriptDir(), "..", "package.json");
+  const packageJson = JSON.parse(readFileSync8(packageJsonPath, "utf-8"));
   const currentVersion = packageJson.version ?? "0.0.0";
   const m = "\x1B[38;5;135m";
   const r = "\x1B[0m";
@@ -3965,16 +4650,16 @@ async function offerAnswersExport(answers, customTemplate) {
   let choice = await ask();
   while (choice !== "generate") {
     if (choice === "script") {
-      const scriptPath = join5(process.cwd(), scriptName);
+      const scriptPath = join8(process.cwd(), scriptName);
       writeFileSync2(scriptPath, formatCreateScript(answers, shell, customTemplate));
       if (shell === "sh") {
         chmodSync(scriptPath, SCRIPT_MODE);
       }
-      log4.success(`Wrote ${scriptName}`);
+      log5.success(`Wrote ${scriptName}`);
       note(formatCreateCommand(answers, shell, customTemplate), "Non-interactive command");
     } else {
-      writeFileSync2(join5(process.cwd(), answersFileName), formatAnswersJson(answers));
-      log4.success(`Wrote ${answersFileName}`);
+      writeFileSync2(join8(process.cwd(), answersFileName), formatAnswersJson(answers));
+      log5.success(`Wrote ${answersFileName}`);
       const overlayFlag = customTemplate ? ` --customTemplate=${customTemplate}` : "";
       note(`npm create @mnaoumov/obsidian-plugin -- --yes --mode=create --answersFile=${answersFileName}${overlayFlag}`, "Non-interactive command");
     }
@@ -3991,18 +4676,41 @@ async function resolveExternalVersions(answers, overlay) {
   s.stop("Versions resolved.");
   return { minAppVersion, resolvedVersions };
 }
+async function resolveOfficialSampleSnapshot(latest) {
+  const vendored = loadOfficialSampleSnapshot();
+  if (!latest) {
+    return vendored;
+  }
+  const upstream = readUpstream(getUpstreamsPath(), OFFICIAL_SAMPLE_UPSTREAM_NAME);
+  const s = spinner();
+  s.start(`Fetching ${upstream.repo}@${upstream.ref}...`);
+  try {
+    const snapshot = await fetchUpstreamSnapshot(upstream.repo, upstream.ref);
+    s.stop(`Fetched ${upstream.repo} at ${snapshot.commit.slice(0, SHORT_SHA_LENGTH)}.`);
+    return snapshot;
+  } catch (error) {
+    s.stop(`Could not fetch ${upstream.repo}.`);
+    log5.warn(`${error instanceof Error ? error.message : String(error)}
+Using the snapshot this release vendored, ${vendored.commit.slice(0, SHORT_SHA_LENGTH)}.`);
+    return vendored;
+  }
+}
 async function runCreate(currentVersion, cliArgs) {
   const { answers: suppliedAnswers, customTemplate, useDefaults } = cliArgs;
   const overlay = customTemplate ? loadOverlayOrExit(resolvePath(customTemplate)) : null;
-  const answers = await ensurePluginIdIsUnlisted(
-    assertManifestAnswersAreListable(useDefaults ? getDefaultAnswers(suppliedAnswers) : await promptAnswers(suppliedAnswers)),
-    useDefaults
+  const answers = applyPresetFlags(
+    await ensurePluginIdIsUnlisted(
+      assertManifestAnswersAreListable(useDefaults ? getDefaultAnswers(suppliedAnswers) : await promptAnswers(suppliedAnswers)),
+      useDefaults
+    ),
+    cliArgs,
+    overlay !== null
   );
   if (!useDefaults) {
     await offerAnswersExport(answers, customTemplate);
   }
-  const targetDir = join5(process.cwd(), `obsidian-${answers.pluginId}`);
-  if (existsSync6(targetDir) && !cliArgs.force) {
+  const targetDir = join8(process.cwd(), `obsidian-${answers.pluginId}`);
+  if (existsSync8(targetDir) && !cliArgs.force) {
     if (useDefaults) {
       exitWithUsageError(`Directory obsidian-${answers.pluginId} already exists, and --yes cannot ask whether to scaffold into it.
 Pass --force to scaffold into it anyway.`);
@@ -4017,19 +4725,28 @@ Pass --force to scaffold into it anyway.`);
       process.exit(0);
     }
   }
-  const { minAppVersion, resolvedVersions } = await resolveExternalVersions(answers, overlay);
-  const s = spinner();
-  s.start("Scaffolding plugin...");
-  const newConfig = copyTemplates(answers, targetDir, currentVersion, null, resolvedVersions, minAppVersion, overlay);
-  const configPath = join5(targetDir, CONFIG_FILE_NAME);
+  let newConfig;
+  if (isOfficialSamplePreset(answers.preset)) {
+    const snapshot = await resolveOfficialSampleSnapshot(cliArgs.latest);
+    const s = spinner();
+    s.start("Copying the official sample plugin...");
+    newConfig = copyOfficialSample(answers, targetDir, currentVersion, null, snapshot);
+    s.stop(`Copied obsidianmd/obsidian-sample-plugin at ${snapshot.commit.slice(0, SHORT_SHA_LENGTH)}.`);
+  } else {
+    const { minAppVersion, resolvedVersions } = await resolveExternalVersions(answers, overlay);
+    const s = spinner();
+    s.start("Scaffolding plugin...");
+    newConfig = copyTemplates(answers, targetDir, currentVersion, null, resolvedVersions, minAppVersion, overlay);
+    s.stop("Plugin scaffolded.");
+  }
+  const configPath = join8(targetDir, CONFIG_FILE_NAME);
   const configWithAnswers = buildSavedConfig(newConfig, answers, overlay, targetDir);
   writeFileSync2(configPath, `${JSON.stringify(configWithAnswers, null, JSON_INDENT_SPACES4)}
 `);
-  s.stop("Plugin scaffolded.");
   const isFormatted = useDefaults ? false : await runPostScaffold(targetDir, answers);
   const pm = answers.packageManager;
   const dirName = `obsidian-${answers.pluginId}`;
-  const needsInstall = !existsSync6(join5(targetDir, "node_modules"));
+  const needsInstall = !existsSync8(join8(targetDir, "node_modules"));
   const needsFormat = needsInitialFormat(answers.formatter) && !isFormatted;
   const steps = [
     ...needsInstall ? [getInstallCommand(pm)] : [],
@@ -4047,8 +4764,8 @@ async function runInitialFormat(targetDir, answers, isInstalled) {
   s.start("Formatting...");
   try {
     await execAsync(getRunCommand(answers.packageManager, "format"), targetDir);
-    const configPath = join5(targetDir, CONFIG_FILE_NAME);
-    const config = JSON.parse(readFileSync6(configPath, "utf-8"));
+    const configPath = join8(targetDir, CONFIG_FILE_NAME);
+    const config = JSON.parse(readFileSync8(configPath, "utf-8"));
     writeFileSync2(configPath, `${JSON.stringify(recordHashesOnDisk(targetDir, config), null, JSON_INDENT_SPACES4)}
 `);
     s.stop("Formatted.");
@@ -4077,7 +4794,7 @@ async function runPostScaffold(targetDir, answers) {
     } catch (error) {
       s.stop(`Failed to install dependencies. Run \`${installCmd}\` manually.`);
       if (error instanceof Error && "stderr" in error) {
-        log4.error(String(error.stderr));
+        log5.error(String(error.stderr));
       }
     }
   }
@@ -4092,11 +4809,17 @@ async function runPostScaffold(targetDir, answers) {
     s.start("Initializing git repository...");
     try {
       await execAsync(`git init -b ${answers.defaultBranch}`, targetDir);
+      if (isInstalled && hasPrepareScript(targetDir)) {
+        await execAsync(getRunCommand(pm, "prepare"), targetDir);
+      }
       await execAsync("git add -A", targetDir);
-      await execAsync('git commit -m "Initial commit from create-obsidian-plugin"', targetDir);
+      await execAsync(`git commit -m "${INITIAL_COMMIT_MESSAGE}"`, targetDir);
       s.stop("Git repository initialized with initial commit.");
-    } catch {
+    } catch (error) {
       s.stop("Failed to initialize git. Run `git init` manually.");
+      if (error instanceof Error && "stderr" in error) {
+        log5.error(String(error.stderr));
+      }
     }
   }
   const shouldCreateGitHubRepo = await confirm({
@@ -4121,10 +4844,10 @@ async function runUpdate(currentVersion, cliArgs) {
   const targetDir = process.cwd();
   const existingConfig = loadConfig(targetDir);
   if (!existingConfig) {
-    log4.error("No config file found. Cannot update.");
+    log5.error("No config file found. Cannot update.");
     process.exit(1);
   }
-  log4.info(`Current project was generated with v${existingConfig.generatorVersion}`);
+  log5.info(`Current project was generated with v${existingConfig.generatorVersion}`);
   let overlay = null;
   if (customTemplate !== void 0) {
     overlay = customTemplate ? loadOverlayOrExit(resolvePath(customTemplate)) : null;
@@ -4134,21 +4857,21 @@ async function runUpdate(currentVersion, cliArgs) {
       `
 This project records it in ${CONFIG_FILE_NAME}. Pass --customTemplate=<dir> to point at where it is now, or --customTemplate= to stop using it.`
     );
-    log4.info(`Applying the custom template recorded for this project: ${existingConfig.customTemplate}`);
+    log5.info(`Applying the custom template recorded for this project: ${existingConfig.customTemplate}`);
   }
-  const configPath = join5(targetDir, CONFIG_FILE_NAME);
-  const savedConfig = JSON.parse(readFileSync6(configPath, "utf-8"));
+  const configPath = join8(targetDir, CONFIG_FILE_NAME);
+  const savedConfig = JSON.parse(readFileSync8(configPath, "utf-8"));
   let answers;
   if (savedConfig.answers) {
     const saved = { ...savedConfig.answers, ...suppliedAnswers };
-    log4.info("Using saved answers from previous generation.");
+    log5.info("Using saved answers from previous generation.");
     const shouldRePrompt = useDefaults ? false : await confirm({
       initialValue: false,
       message: "Would you like to change any settings?"
     });
     assertNotCancelled(shouldRePrompt);
     if (shouldRePrompt) {
-      answers = await promptAnswers(saved);
+      answers = await promptAnswers(saved, suppliedAnswers);
     } else {
       answers = saved;
     }
@@ -4157,17 +4880,29 @@ This project records it in ${CONFIG_FILE_NAME}. Pass --customTemplate=<dir> to p
       exitWithUsageError(`${CONFIG_FILE_NAME} records no answers, so --yes has none to reuse.
 Run without --yes to answer them again.`);
     }
-    log4.warn("No saved answers found. Please provide the settings again.");
+    log5.warn("No saved answers found. Please provide the settings again.");
     answers = await promptAnswers(suppliedAnswers);
   }
   const savedPluginId = savedConfig.answers?.pluginId;
   if (savedPluginId !== void 0 && answers.pluginId !== savedPluginId) {
     answers = await ensurePluginIdIsUnlisted(answers, useDefaults);
   }
+  answers = applyPresetFlags(answers, cliArgs, overlay !== null);
+  if (isOfficialSamplePreset(answers.preset)) {
+    const snapshot = await resolveOfficialSampleSnapshot(cliArgs.latest);
+    const s2 = spinner();
+    s2.start("Updating project files...");
+    const newConfig2 = copyOfficialSample(answers, targetDir, currentVersion, existingConfig, snapshot);
+    writeFileSync2(configPath, `${JSON.stringify({ ...newConfig2, answers }, null, JSON_INDENT_SPACES4)}
+`);
+    s2.stop(`Update complete: obsidianmd/obsidian-sample-plugin at ${snapshot.commit.slice(0, SHORT_SHA_LENGTH)}.`);
+    outro("Project updated successfully!");
+    return;
+  }
   const { minAppVersion, resolvedVersions } = await resolveExternalVersions(answers, overlay);
   const projectFormatter = createProjectFormatter(targetDir, answers.formatter);
   if (projectFormatter === null && needsInitialFormat(answers.formatter)) {
-    log4.warn(`${answers.formatter} is not installed, so the update cannot tell the files it formatted from hand edits and skips them. Install the dependencies and update again to have them updated.`);
+    log5.warn(`${answers.formatter} is not installed, so the update cannot tell the files it formatted from hand edits and skips them. Install the dependencies and update again to have them updated.`);
   }
   const s = spinner();
   s.start("Updating project files...");