@vendure-platform/create 0.1.0 → 0.2.1-nightly.202605190703

package/dist/template-renderer.d.ts

@@ -3,25 +3,42 @@ import { PluginDefinition } from './types';
 export interface TemplateContext {
     projectName: string;
     companyName: string;
+    /**
+     * The full set of plugin keys whose imports, env vars, etc. should appear
+     * in the generated project. Includes all always-active (core) plugins plus
+     * the user's selected optional/requires-config plugins.
+     */
     resolvedPluginKeys: string[];
+    /**
+     * Same plugins as `resolvedPluginKeys`, materialised as `PluginDefinition`
+     * objects. Used by templates that iterate via `{{#each resolvedPlugins}}`
+     * to render `displayName` / `packageName` (see `README.md.hbs`,
+     * `CLAUDE.md.hbs`).
+     */
     resolvedPlugins: PluginDefinition[];
+    /**
+     * Optional plugins the user explicitly deselected. For each one, we emit
+     * `platformKey: false` inside `VendurePlatform.init({...})` to override
+     * its default-on behaviour.
+     */
+    disabledPluginKeys: string[];
     includeStorefront: boolean;
+    /**
+     * Private registry URL baked into the project's `.npmrc` scope mapping.
+     * Resolved from `VENDURE_REGISTRY_URL` if set, otherwise the production
+     * default. See `registry.ts`.
+     */
+    registryUrl: string;
 }
 export interface TemplateContextResult {
     context: TemplateContext;
     hbs: typeof Handlebars;
 }
-export declare function buildTemplateContext(projectName: string, companyName: string, resolvedPluginKeys: string[], includeStorefront: boolean): TemplateContextResult;
+export declare function buildTemplateContext(projectName: string, companyName: string, selectedPluginKeys: ReadonlyArray<string>, includeStorefront: boolean): TemplateContextResult;
 /**
  * Render a Handlebars template file with the given context.
  */
 export declare function renderTemplate(templatePath: string, context: TemplateContext, hbs: typeof Handlebars): string;
-/**
- * Get the path to a bundled asset file.
- * At runtime these live in dist/assets/.
- * During development they live in assets/.
- */
-export declare function getAssetPath(assetName: string): string;
 /**
  * Get the path to a bundled template file.
  * At runtime these live in dist/assets/templates/.

package/dist/template-renderer.js

@@ -38,13 +38,13 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildTemplateContext = buildTemplateContext;
 exports.renderTemplate = renderTemplate;
-exports.getAssetPath = getAssetPath;
 exports.getTemplatePath = getTemplatePath;
 const handlebars_1 = __importDefault(require("handlebars"));
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const plugin_registry_1 = require("./plugin-registry");
-function createHandlebarsInstance(resolvedPluginKeys) {
+const registry_1 = require("./registry");
+function createHandlebarsInstance(resolvedPluginKeys, disabledPluginKeys) {
     const hbs = handlebars_1.default.create();
     const resolvedSet = new Set(resolvedPluginKeys);
     hbs.registerHelper('ifPlugin', function (pluginKey, options) {
@@ -53,37 +53,8 @@ function createHandlebarsInstance(resolvedPluginKeys) {
         }
         return options.inverse(this);
     });
-    hbs.registerHelper('pluginImports', function () {
-        const lines = [];
-        for (const key of resolvedPluginKeys) {
-            const plugin = (0, plugin_registry_1.getPlugin)(key);
-            if (!plugin || plugin.imports.length === 0)
-                continue;
-            const names = plugin.imports.join(', ');
-            lines.push(`import { ${names} } from '${plugin.packageName}';`);
-        }
-        return new hbs.SafeString(lines.join('\n'));
-    });
-    hbs.registerHelper('pluginConfigBlocks', function () {
-        const blocks = [];
-        for (const key of resolvedPluginKeys) {
-            const plugin = (0, plugin_registry_1.getPlugin)(key);
-            if (!plugin)
-                continue;
-            // Compile configBlock through Handlebars so it can use {{#ifPlugin}} guards
-            const compiled = hbs.compile(plugin.configBlock, { noEscape: true });
-            blocks.push(`        ${compiled({})},`);
-        }
-        return new hbs.SafeString(blocks.join('\n'));
-    });
     hbs.registerHelper('pluginDependencies', function () {
-        const lines = [];
-        for (const key of resolvedPluginKeys) {
-            const plugin = (0, plugin_registry_1.getPlugin)(key);
-            if (!plugin || plugin.internal)
-                continue;
-            lines.push(`    "${plugin.packageName}": "nightly"`);
-        }
+        const lines = resolvedPluginKeys.map((key) => `    "${(0, plugin_registry_1.getPlugin)(key).packageName}": "nightly"`);
         if (lines.length === 0) {
             return new hbs.SafeString('');
         }
@@ -92,38 +63,54 @@ function createHandlebarsInstance(resolvedPluginKeys) {
     hbs.registerHelper('platformPluginImports', function () {
         const lines = [`import { VendurePlatform } from '@vendure-platform/platform';`];
         for (const key of resolvedPluginKeys) {
-            const plugin = (0, plugin_registry_1.getPlugin)(key);
-            if (!(plugin === null || plugin === void 0 ? void 0 : plugin.platformImports))
-                continue;
-            lines.push(...plugin.platformImports);
+            const imports = (0, plugin_registry_1.getPlugin)(key).platformImports;
+            if (imports)
+                lines.push(...imports);
         }
         return new hbs.SafeString(lines.join('\n'));
     });
+    /**
+     * Emit the options body for `VendurePlatform.init({...})`. Two kinds of
+     * entries appear here:
+     *
+     *  1. Options blocks for active plugins that ship a non-empty
+     *     `platformOptionsBlock` (e.g. core plugins with required config,
+     *     or `requires-config` plugins the user selected).
+     *  2. `platformKey: false` lines for any `optional` plugin the user
+     *     deselected — because `VendurePlatform` enables them by default.
+     */
     hbs.registerHelper('platformPluginOptions', function () {
         const blocks = [];
         for (const key of resolvedPluginKeys) {
-            const plugin = (0, plugin_registry_1.getPlugin)(key);
-            if (!plugin || !plugin.platformOptionsBlock)
-                continue;
-            blocks.push(`            ${plugin.platformOptionsBlock},`);
+            const block = (0, plugin_registry_1.getPlugin)(key).platformOptionsBlock;
+            if (block)
+                blocks.push(`            ${block},`);
+        }
+        for (const key of disabledPluginKeys) {
+            blocks.push(`            ${(0, plugin_registry_1.getPlugin)(key).platformKey}: false,`);
         }
         return new hbs.SafeString(blocks.join('\n'));
     });
     return hbs;
 }
-function buildTemplateContext(projectName, companyName, resolvedPluginKeys, includeStorefront) {
-    const resolvedPlugins = resolvedPluginKeys
-        .map((key) => (0, plugin_registry_1.getPlugin)(key))
-        .filter((p) => p != null);
+function buildTemplateContext(projectName, companyName, selectedPluginKeys, includeStorefront) {
+    const resolvedPluginKeys = (0, plugin_registry_1.resolveActivePluginKeys)(selectedPluginKeys);
+    const resolvedPlugins = resolvedPluginKeys.map((key) => (0, plugin_registry_1.getPlugin)(key));
+    const resolvedSet = new Set(resolvedPluginKeys);
+    const disabledPluginKeys = plugin_registry_1.pluginRegistry
+        .filter((p) => p.tier === 'optional' && !resolvedSet.has(p.key))
+        .map((p) => p.key);
     return {
         context: {
             projectName,
             companyName,
             resolvedPluginKeys,
             resolvedPlugins,
+            disabledPluginKeys,
             includeStorefront,
+            registryUrl: (0, registry_1.getRegistryUrl)(),
         },
-        hbs: createHandlebarsInstance(resolvedPluginKeys),
+        hbs: createHandlebarsInstance(resolvedPluginKeys, disabledPluginKeys),
     };
 }
 /**
@@ -134,25 +121,6 @@ function renderTemplate(templatePath, context, hbs) {
     const template = hbs.compile(source, { noEscape: true });
     return template(context);
 }
-/**
- * Get the path to a bundled asset file.
- * At runtime these live in dist/assets/.
- * During development they live in assets/.
- */
-function getAssetPath(assetName) {
-    const candidates = [
-        path.join(__dirname, 'assets', assetName),
-        path.join(__dirname, '..', 'assets', assetName),
-    ];
-    for (const candidate of candidates) {
-        if (fs.existsSync(candidate)) {
-            return candidate;
-        }
-    }
-    throw new Error(`Asset not found: ${assetName}\n` +
-        `  __dirname: ${__dirname}\n` +
-        `  Searched:\n${candidates.map((c) => `    - ${c} (exists: ${fs.existsSync(path.dirname(c))})`).join('\n')}`);
-}
 /**
  * Get the path to a bundled template file.
  * At runtime these live in dist/assets/templates/.

package/dist/template-renderer.js.map

@@ -1 +1 @@
-{"version":3,"file":"template-renderer.js","sourceRoot":"","sources":["../src/template-renderer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"template-renderer.js","sourceRoot":"","sources":["../src/template-renderer.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqGA,oDAyBC;AAKD,wCAIC;AAOD,0CAiBC;AA/JD,4DAAoC;AACpC,uCAAyB;AACzB,2CAA6B;AAE7B,uDAAuF;AACvF,yCAA4C;AAsC5C,SAAS,wBAAwB,CAC7B,kBAA4B,EAC5B,kBAA4B;IAE5B,MAAM,GAAG,GAAG,oBAAU,CAAC,MAAM,EAAE,CAAC;IAChC,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAEhD,GAAG,CAAC,cAAc,CAAC,UAAU,EAAE,UAAyB,SAAiB,EAAE,OAAiC;QACxG,IAAI,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YAC7B,OAAO,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,cAAc,CAAC,oBAAoB,EAAE;QACrC,MAAM,KAAK,GAAG,kBAAkB,CAAC,GAAG,CAChC,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,IAAA,2BAAS,EAAC,GAAG,CAAE,CAAC,WAAW,cAAc,CAC7D,CAAC;QACF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrB,OAAO,IAAI,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,IAAI,GAAG,CAAC,UAAU,CAAC,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,cAAc,CAAC,uBAAuB,EAAE;QACxC,MAAM,KAAK,GAAa,CAAC,+DAA+D,CAAC,CAAC;QAC1F,KAAK,MAAM,GAAG,IAAI,kBAAkB,EAAE,CAAC;YACnC,MAAM,OAAO,GAAG,IAAA,2BAAS,EAAC,GAAG,CAAE,CAAC,eAAe,CAAC;YAChD,IAAI,OAAO;gBAAE,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,IAAI,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH;;;;;;;;;OASG;IACH,GAAG,CAAC,cAAc,CAAC,uBAAuB,EAAE;QACxC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,KAAK,MAAM,GAAG,IAAI,kBAAkB,EAAE,CAAC;YACnC,MAAM,KAAK,GAAG,IAAA,2BAAS,EAAC,GAAG,CAAE,CAAC,oBAAoB,CAAC;YACnD,IAAI,KAAK;gBAAE,MAAM,CAAC,IAAI,CAAC,eAAe,KAAK,GAAG,CAAC,CAAC;QACpD,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,kBAAkB,EAAE,CAAC;YACnC,MAAM,CAAC,IAAI,CAAC,eAAe,IAAA,2BAAS,EAAC,GAAG,CAAE,CAAC,WAAW,UAAU,CAAC,CAAC;QACtE,CAAC;QACD,OAAO,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACf,CAAC;AAED,SAAgB,oBAAoB,CAChC,WAAmB,EACnB,WAAmB,EACnB,kBAAyC,EACzC,iBAA0B;IAE1B,MAAM,kBAAkB,GAAG,IAAA,yCAAuB,EAAC,kBAAkB,CAAC,CAAC;IACvE,MAAM,eAAe,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAA,2BAAS,EAAC,GAAG,CAAE,CAAC,CAAC;IACzE,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAChD,MAAM,kBAAkB,GAAG,gCAAc;SACpC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;SAC/D,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAEvB,OAAO;QACH,OAAO,EAAE;YACL,WAAW;YACX,WAAW;YACX,kBAAkB;YAClB,eAAe;YACf,kBAAkB;YAClB,iBAAiB;YACjB,WAAW,EAAE,IAAA,yBAAc,GAAE;SAChC;QACD,GAAG,EAAE,wBAAwB,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;KACxE,CAAC;AACN,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc,CAAC,YAAoB,EAAE,OAAwB,EAAE,GAAsB;IACjG,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC;AAED;;;;GAIG;AACH,SAAgB,eAAe,CAAC,YAAoB;IAChD,MAAM,UAAU,GAAG;QACf,sEAAsE;QACtE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,CAAC;QACzD,qEAAqE;QACrE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,CAAC;KAClE,CAAC;IACF,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACjC,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3B,OAAO,SAAS,CAAC;QACrB,CAAC;IACL,CAAC;IACD,MAAM,IAAI,KAAK,CACX,uBAAuB,YAAY,IAAI;QACnC,gBAAgB,SAAS,IAAI;QAC7B,gBAAgB,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,aAAa,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACnH,CAAC;AACN,CAAC"}

package/dist/types.d.ts

@@ -1,3 +1,4 @@
+import type { PluginMeta } from '@vendure-platform/plugin-meta';
 export interface ScaffoldOptions {
     projectName: string;
     companyName: string;
@@ -5,6 +6,23 @@ export interface ScaffoldOptions {
     includeStorefront: boolean;
     createGithubRepo: boolean;
     githubOrg?: string;
+    /**
+     * Package manager used for the install step. Defaults to `bun` to match
+     * the recommended invocation `bunx @vendure-platform/create`.
+     */
+    packageManager?: PackageManager;
+    skipInstall?: boolean;
+    skipGit?: boolean;
+    dryRun?: boolean;
+}
+export type PackageManager = 'bun' | 'npm' | 'pnpm';
+export interface StorefrontOnlyOptions {
+    projectName: string;
+    /** Vendure Shop API URL written to `.env.local`. */
+    apiUrl?: string;
+    /** Scenario baked into `NEXT_PUBLIC_SCENARIO`. Default: `customer`. */
+    scenario: string;
+    packageManager: PackageManager;
     skipInstall?: boolean;
     skipGit?: boolean;
     dryRun?: boolean;
@@ -18,43 +36,44 @@ export interface CliFlags {
     install?: boolean;
     git?: boolean;
     dryRun?: boolean;
+    storefrontOnly?: boolean;
+    apiUrl?: string;
+    scenario?: string;
+    pm?: PackageManager;
 }
-export interface PluginDefinition {
-    /** Unique key matching the lib folder name */
-    key: string;
-    /** npm package name */
-    packageName: string;
-    /** Human-readable name */
-    displayName: string;
-    /** Grouping for the multi-select prompt */
-    category: 'b2b' | 'commerce' | 'platform' | 'search';
-    /** Other plugin keys this plugin depends on */
-    requires: string[];
-    /** Named imports from the package for vendure-config.ts (legacy, individual plugin mode) */
-    imports: string[];
-    /** Environment variables this plugin needs */
+/**
+ * Scaffolder-specific data for a plugin — env vars, options-block template
+ * snippets, additional imports. Keyed by the same `key` (kebab-case) used in
+ * `@vendure-platform/plugin-meta` so the two halves can be joined at runtime.
+ *
+ * The shared `PluginMeta` defines what every consumer agrees on (key, tier,
+ * dependencies, etc.); this interface holds the bits only the scaffolder
+ * needs and which would be dead weight in `@vendure-platform/platform` or
+ * any other consumer.
+ */
+export interface ScaffolderPluginExtras {
+    /** Environment variables to add to the generated `.env` file. */
     envVars: EnvVar[];
-    /** The .init({...}) or plugin expression code for vendure-config.ts (legacy, individual plugin mode) */
-    configBlock: string;
     /**
-     * The options fragment emitted under this plugin's key in `VendurePlatform.init({...})`.
-     * Compiled through Handlebars so it can use `{{#ifPlugin}}` guards.
+     * Options fragment emitted under this plugin's key in
+     * `VendurePlatform.init({...})`. Compiled through Handlebars so it can
+     * use `{{#ifPlugin}}` guards. Empty string means the plugin activates
+     * with just defaults — no entry will be emitted.
      */
     platformOptionsBlock: string;
     /**
-     * Additional imports needed when this plugin is selected in VendurePlatform mode.
-     * These are imports beyond `VendurePlatform` itself (e.g. strategy classes the user
-     * references in their options).
+     * Extra named imports the options block needs (e.g. strategy classes
+     * referenced inside `platformOptionsBlock`).
      */
     platformImports?: string[];
-    /**
-     * If true, this plugin is not shown in the interactive plugin selection prompt.
-     * Used for internal/infrastructure plugins like `platform`.
-     */
-    internal?: boolean;
+}
+/**
+ * The joined view used by the scaffolder: shared metadata + scaffolder extras.
+ * Each `pluginRegistry` entry has this shape — see `plugin-registry.ts`.
+ */
+export interface PluginDefinition extends PluginMeta, ScaffolderPluginExtras {
 }
 export interface EnvVar {
     name: string;
     defaultValue: string;
-    comment?: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vendure-platform/create",
-  "version": "0.1.0",
+  "version": "0.2.1-nightly.202605190703",
   "description": "CLI tool to scaffold a Vendure demo project with Vendure Platform plugins",
   "license": "UNLICENSED",
   "repository": {
@@ -22,6 +22,7 @@
     }
   },
   "files": [
+    "CHANGELOG.md",
     "dist/**/*",
     "!**/*.tsbuildinfo",
     "!**/*.spec.*",
@@ -36,6 +37,7 @@
   },
   "dependencies": {
     "@clack/prompts": "^0.10.0",
+    "@vendure-platform/plugin-meta": "0.2.0",
     "commander": "^13.1.0",
     "fs-extra": "^11.3.0",
     "handlebars": "^4.7.8",

package/dist/assets/storefront/.env.local

@@ -1 +0,0 @@
-# NEXT_PUBLIC_SCENARIO=b2b-wholesale

package/dist/assets/storefront/public/scenarios/b2b-wholesale/logo.svg

@@ -1,4 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32" fill="none">
-  <rect x="2" y="2" width="28" height="28" rx="5" fill="#e07a00"/>
-  <text x="16" y="22.5" font-family="Arial Black, Impact, sans-serif" font-size="14" font-weight="900" fill="white" text-anchor="middle" letter-spacing="-0.5">BD</text>
-</svg>

package/dist/assets/storefront/public/scenarios/default/logo.svg

@@ -1,4 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 40 27">
-    <path fill="#17C1FF" d="M10.746 12.008v9.263c0 .166.093.323.237.404l8.407 4.763c.302.17.671.17.973 0l8.407-4.762a.466.466 0 0 0 .237-.405v-9.263a.476.476 0 0 0-.714-.405l-7.93 4.491a.996.996 0 0 1-.973 0l-7.93-4.49a.476.476 0 0 0-.714.404Z"/>
-    <path fill="#17C1FF" d="M8.893.072.486 4.832A.948.948 0 0 0 0 5.657v9.522c0 .166.092.323.237.405l8.176 4.633a.476.476 0 0 0 .714-.405V10.83c0-.341.185-.655.487-.824l7.93-4.491a.463.463 0 0 0 0-.81L9.366.072a.48.48 0 0 0-.477 0h.003ZM30.86.063l8.407 4.76c.301.17.486.486.486.825v9.522a.469.469 0 0 1-.237.405l-8.176 4.633a.476.476 0 0 1-.714-.405v-8.982a.945.945 0 0 0-.486-.824l-7.93-4.491a.463.463 0 0 1 0-.81L30.386.063a.48.48 0 0 1 .477 0h-.003Z"/>
-</svg>

package/dist/assets/storefront/public/scenarios/kaminpro/logo.svg

@@ -1,7 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32" fill="none">
-  <rect x="2" y="2" width="28" height="28" rx="5" fill="#1c1917"/>
-  <path d="M16 6c-.5 2.8-3.2 4.3-3.2 7.8 0 2 1.4 3.6 3.2 3.6s3.2-1.6 3.2-3.6c0-1.2-.4-2-1.1-3 .3 1.4-.4 2.4-1.1 2.4-.7 0-1.1-.6-1.1-1.5C15.9 10 16.9 8.6 16 6z" fill="#dc2626"/>
-  <rect x="12" y="18" width="8" height="1.6" fill="#a8a29e"/>
-  <rect x="12" y="20.8" width="8" height="1.6" fill="#a8a29e"/>
-  <rect x="12" y="23.6" width="8" height="1.6" fill="#a8a29e"/>
-</svg>

package/dist/assets/storefront/src/components/shared/scenario-paused.tsx

@@ -1,80 +0,0 @@
-import Image from 'next/image';
-import {getTranslations} from 'next-intl/server';
-import {Button} from '@/components/ui/button';
-import {getBranding} from '@/config/branding';
-import {isBackendReachable} from '@/lib/backend-health';
-
-const CONTACT_URL = 'https://vendure.io/contact/';
-
-/**
- * Suspense-wrappable server component that renders nothing when the Vendure
- * backend is reachable, or a full-screen "Demo Paused" overlay when it isn't.
- *
- * Must be used inside a <Suspense> boundary — it awaits isBackendReachable(),
- * which would otherwise block layout prerender under cacheComponents.
- */
-export async function BackendHealthGate({locale}: {locale: string}) {
-    const reachable = await isBackendReachable();
-    if (reachable) return null;
-    return <ScenarioPausedOverlay locale={locale} />;
-}
-
-async function ScenarioPausedOverlay({locale}: {locale: string}) {
-    const t = await getTranslations({locale, namespace: 'ScenarioPaused'});
-    const {logo, logoInverted, siteName} = getBranding();
-    const displayLogo = logoInverted ?? logo;
-
-    return (
-        <div className="fixed inset-0 z-[9999] flex flex-col items-center justify-center px-4 py-12 bg-background overflow-auto">
-            <div className="max-w-lg w-full text-center space-y-8">
-                <div className="flex justify-center">
-                    <Image
-                        src={displayLogo.src}
-                        alt={displayLogo.alt}
-                        width={displayLogo.width}
-                        height={displayLogo.height}
-                        className="h-16 w-auto"
-                        priority
-                    />
-                </div>
-
-                <div className="inline-flex items-center gap-2 rounded-full border border-border bg-muted/60 px-4 py-1.5 text-xs font-medium text-muted-foreground">
-                    <span className="relative flex h-2 w-2">
-                        <span className="absolute inline-flex h-full w-full rounded-full bg-primary/40 animate-ping" />
-                        <span className="relative inline-flex h-2 w-2 rounded-full bg-primary" />
-                    </span>
-                    {t('badge')}
-                </div>
-
-                <div className="space-y-4">
-                    <h1 className="text-3xl sm:text-4xl font-bold tracking-tight text-foreground">
-                        {t('title', {siteName})}
-                    </h1>
-                    <p className="text-base text-muted-foreground leading-relaxed">
-                        {t('description')}
-                    </p>
-                </div>
-
-                <div className="flex flex-col sm:flex-row gap-3 justify-center pt-2">
-                    <Button asChild size="lg">
-                        <a href={CONTACT_URL} target="_blank" rel="noopener noreferrer">
-                            {t('contactCta')}
-                        </a>
-                    </Button>
-                    <Button asChild size="lg" variant="outline">
-                        <a href="https://vendure.io" target="_blank" rel="noopener noreferrer">
-                            {t('learnMore')}
-                        </a>
-                    </Button>
-                </div>
-
-                <p className="text-xs text-muted-foreground pt-4">
-                    {t('poweredBy')}{' '}
-                    <a href="https://vendure.io" target="_blank" rel="noopener noreferrer" className="underline hover:text-foreground transition-colors">
-                        Vendure
-                    </a>
-                </p>
-            </div>
-        </div>
-    );
-}

package/dist/assets/storefront/src/scenarios/b2b-wholesale/branding.ts

@@ -1,180 +0,0 @@
-import type { StorefrontBranding } from '@/config/branding';
-
-/* =============================================================
-   Color palettes — Construction Orange + Warm Stone
-   ============================================================= */
-
-const baseVars: Record<string, string> = {
-    '--radius': '0.375rem',
-};
-
-const heroColors: Record<string, string> = {
-    '--hero-gradient-from': '#1c1917',
-    '--hero-gradient-via': '#292524',
-    '--hero-gradient-to': '#1c1917',
-    '--hero-accent': '#fb923c',
-    '--hero-accent-bg': '#e07a00',
-    '--hero-accent-bg-hover': '#c96e00',
-    '--hero-accent-foreground': '#ffffff',
-    '--hero-text': '#f5f5f4',
-    '--hero-text-muted': '#d6d3d1',
-    '--hero-border': 'rgba(214, 211, 209, 0.25)',
-    '--hero-badge-bg': 'rgba(224, 122, 0, 0.18)',
-    '--hero-badge-border': 'rgba(251, 146, 60, 0.4)',
-    '--hero-bg-image': 'url(/scenarios/b2b-wholesale/hero/hero-bg.webp)',
-};
-
-const darkColors: Record<string, string> = {
-    ...baseVars,
-
-    '--background': '#1c1917',
-    '--foreground': '#f5f5f4',
-
-    '--card': '#292524',
-    '--card-foreground': '#f5f5f4',
-    '--popover': '#292524',
-    '--popover-foreground': '#f5f5f4',
-
-    '--primary': '#e07a00',
-    '--primary-foreground': '#ffffff',
-
-    '--secondary': '#292524',
-    '--secondary-foreground': '#f5f5f4',
-
-    '--muted': '#292524',
-    '--muted-foreground': '#a8a29e',
-
-    '--accent': '#292524',
-    '--accent-foreground': '#f5f5f4',
-
-    '--destructive': '#dc2626',
-
-    '--border': '#44403c',
-    '--input': '#292524',
-    '--ring': '#e07a00',
-
-    '--chart-1': '#e07a00',
-    '--chart-2': '#22c55e',
-    '--chart-3': '#eab308',
-    '--chart-4': '#f97316',
-    '--chart-5': '#dc2626',
-
-    '--sidebar': '#1c1917',
-    '--sidebar-foreground': '#f5f5f4',
-    '--sidebar-primary': '#e07a00',
-    '--sidebar-primary-foreground': '#ffffff',
-    '--sidebar-accent': '#292524',
-    '--sidebar-accent-foreground': '#f5f5f4',
-    '--sidebar-border': '#44403c',
-    '--sidebar-ring': '#e07a00',
-
-    ...heroColors,
-};
-
-const lightColors: Record<string, string> = {
-    ...baseVars,
-
-    '--background': '#ffffff',
-    '--foreground': '#1c1917',
-
-    '--card': '#fafaf9',
-    '--card-foreground': '#1c1917',
-    '--popover': '#ffffff',
-    '--popover-foreground': '#1c1917',
-
-    '--primary': '#d97706',
-    '--primary-foreground': '#ffffff',
-
-    '--secondary': '#f5f5f4',
-    '--secondary-foreground': '#1c1917',
-
-    '--muted': '#f5f5f4',
-    '--muted-foreground': '#78716c',
-
-    '--accent': '#f5f5f4',
-    '--accent-foreground': '#1c1917',
-
-    '--destructive': '#dc2626',
-
-    '--border': '#e7e5e4',
-    '--input': '#e7e5e4',
-    '--ring': '#d97706',
-
-    '--chart-1': '#d97706',
-    '--chart-2': '#16a34a',
-    '--chart-3': '#ca8a04',
-    '--chart-4': '#ea580c',
-    '--chart-5': '#dc2626',
-
-    '--sidebar': '#fafaf9',
-    '--sidebar-foreground': '#1c1917',
-    '--sidebar-primary': '#d97706',
-    '--sidebar-primary-foreground': '#ffffff',
-    '--sidebar-accent': '#f5f5f4',
-    '--sidebar-accent-foreground': '#1c1917',
-    '--sidebar-border': '#e7e5e4',
-    '--sidebar-ring': '#d97706',
-
-    ...heroColors,
-};
-
-export const branding: StorefrontBranding = {
-    siteName: 'BauDirekt',
-    siteDescription: 'Baustoffe. Direkt. Der Baustoffgroßhandel für DACH-Profis.',
-
-    logo: { src: '/scenarios/b2b-wholesale/logo.svg', alt: 'BauDirekt', width: 32, height: 32 },
-
-    colors: {
-        dark: darkColors,
-        light: lightColors,
-    },
-
-    demoAccounts: [
-        {
-            email: 'buyer@berger-bau.demo',
-            label: 'Einkäufer',
-            description: 'Berger Bau GmbH · Bestellt Baumaterial (Freigabe >€500)',
-        },
-        {
-            email: 'approver@berger-bau.demo',
-            label: 'Freigeber',
-            description: 'Berger Bau GmbH · Genehmigt Bestellungen',
-        },
-        {
-            email: 'admin@berger-bau.demo',
-            label: 'Firmenadmin',
-            description: 'Berger Bau GmbH · Verwaltet Nutzer & Adressen',
-        },
-        {
-            email: 'admin@klein-handwerk.demo',
-            label: 'Inhaber',
-            description: 'Klein Handwerk · Einzelunternehmer, kein Workflow',
-        },
-        {
-            email: 'buyer@huber-baustoffe.demo',
-            label: 'Einkaufsleitung',
-            description: 'Huber Baustoffe GmbH · Großabnehmer (DE)',
-        },
-        {
-            email: 'admin@huber-baustoffe.demo',
-            label: 'Firmenadmin',
-            description: 'Huber Baustoffe GmbH · Unternehmensverwaltung',
-        },
-    ],
-
-    footer: {
-        copyright: 'BauDirekt GmbH',
-        poweredByLinks: [
-            { label: 'Vendure Commerce', href: 'https://vendure.io' },
-        ],
-    },
-
-    metadata: {
-        themeColor: '#1c1917',
-        defaultDescription:
-            'Baustoffe, Werkzeuge & Arbeitsschutz zum Großhandelspreis. Für Baufirmen, Handwerker und Fachhändler im DACH-Raum.',
-        homepageTitle: 'Baustoffgroßhandel für DACH-Profis',
-        homepageDescription:
-            'Dämmstoffe, Befestigungstechnik, Werkzeuge & PSA zum Fachhandelspreis. Zuverlässig. Direkt. BauDirekt.',
-    },
-};