@pantoken/scaffold 1.0.1 → 1.2.0

package/dist/cli.mjs

@@ -1,4 +1,4 @@
-import { i as scaffoldProject, n as isScaffoldPlatform, o as validateThemeMode, r as resolveScaffoldPlatform, s as validateThemeVariant, t as SCAFFOLD_PLATFORMS } from "./src-DSGZRyeb.mjs";
+import { c as SUPPORTED_LOCALES, d as validateLocaleTag, i as scaffoldProject, l as createLocaleLookup, n as isScaffoldPlatform, o as validateThemeMode, r as resolveScaffoldPlatform, s as validateThemeVariant, t as SCAFFOLD_PLATFORMS, u as detectLocale } from "./src-DxBSPAO9.mjs";
 import { readFileSync } from "node:fs";
 import { basename, join } from "node:path";
 import { CDN_PROVIDERS } from "@pantoken/canvas-theme-editor";
@@ -6,47 +6,7 @@ import { Argument, Command, CommanderError, InvalidArgumentError } from "command
 import { cancel, isCancel, select, spinner, text } from "@clack/prompts";
 import tab from "@bomb.sh/tab/commander";
 import { homedir } from "node:os";
-//#region src/locale.ts
-/**
-* Resolves the active locale: --lang flag \> LC_ALL/LANG env \> Intl \> "en".
-*
-* @param options - Detection options. `langFlag` is an optional --lang flag value; `env` is
-* environment variables (defaults to process.env); `intl` is an optional injected
-* Intl.DateTimeFormat locale function (for testing).
-* @returns The resolved locale tag
-*/
-function detectLocale(options) {
-	if (options.langFlag) return options.langFlag;
-	const env = options.env ?? process.env;
-	const locale = env.LC_ALL ?? env.LANG ?? "";
-	if (locale) return locale.split(".")[0].split("_")[0] || "en";
-	try {
-		const tag = (options.intl ?? (() => Intl.DateTimeFormat().resolvedOptions().locale))();
-		if (tag) return tag.split("-")[0] || "en";
-	} catch {}
-	return "en";
-}
-/**
-* Builds a lookup over the given locale bundles, falling back to `bundles[fallback]`
-* for any key missing in the resolved locale.
-*
-* @param bundles - Record mapping locale tags to string bundles
-* @param resolvedLocale - The locale to use (typically from detectLocale)
-* @param fallback - The fallback locale when a key is missing (default "en")
-* @returns A LocaleLookup object with a `t` function
-*/
-function createLocaleLookup(bundles, resolvedLocale, fallback = "en") {
-	const resolved = bundles[resolvedLocale] ?? bundles[fallback] ?? {};
-	const fallbackBundle = bundles[fallback] ?? {};
-	return {
-		locale: resolvedLocale,
-		t: (key, params) => {
-			let value = resolved[key] ?? fallbackBundle[key] ?? key;
-			if (params) for (const [param, val] of Object.entries(params)) value = value.replace(new RegExp(`\\{\\{${param}\\}\\}`, "g"), val);
-			return value;
-		}
-	};
-}
+import { execFileSync } from "node:child_process";
 //#endregion
 //#region generated/locales/index.ts
 const MESSAGES = {
@@ -60,6 +20,10 @@ const MESSAGES = {
 		"nextStepsNav": "cd {{dir}}",
 		"nextStepsInstall": "تثبيت التبعيات: {{command}}",
 		"nextStepsDevServer": "شغّل خادم التطوير (إذا كان القالب يحتوي واحدًا)",
+		"getStartedHeading": "الخطوات التالية:",
+		"installSpinnerStart": "تثبيت التبعيات: {{command}}",
+		"installSpinnerStop": "تم تثبيت التبعيات.",
+		"installSpinnerFailed": "تثبيت التبعيات: {{command}}",
 		"notesHeading": "ملاحظة:",
 		"caveatsHeading": "تنبيه:",
 		"errorMissingPlatform": "الوسيط المطلوب \"platform\" مفقود. متوقع أحد القيم: {{platforms}}",
@@ -114,6 +78,10 @@ const MESSAGES = {
 		"nextStepsNav": "cd {{dir}}",
 		"nextStepsInstall": "Տեղադրել կախվածությունները՝ {{command}}",
 		"nextStepsDevServer": "Ստարտ վարել dev սերվերը (եթե ձեր տեմպլեյթը ունի մեկը)",
+		"getStartedHeading": "Հաջորդ քայլերը:",
+		"installSpinnerStart": "Տեղադրել կախվածությունները՝ {{command}}",
+		"installSpinnerStop": "Կախվածությունները տեղադրված են.",
+		"installSpinnerFailed": "Տեղադրել կախվածությունները՝ {{command}}",
 		"notesHeading": "Նշում:",
 		"caveatsHeading": "Ուշադրություն:",
 		"errorMissingPlatform": "Բացակայում է պարտադիր արգումենտը \"platform\". Ապահովված լիներ այս մեկը՝ {{platforms}}",
@@ -168,6 +136,10 @@ const MESSAGES = {
 		"nextStepsNav": "cd {{dir}}",
 		"nextStepsInstall": "Instal·la les dependències: {{command}}",
 		"nextStepsDevServer": "Inicia el servidor de desenvolupament (si la plantilla en té un)",
+		"getStartedHeading": "Passos següents:",
+		"installSpinnerStart": "Instal·la les dependències: {{command}}",
+		"installSpinnerStop": "Dependències instal·lades.",
+		"installSpinnerFailed": "Instal·la les dependències: {{command}}",
 		"notesHeading": "Nota:",
 		"caveatsHeading": "Advertència:",
 		"errorMissingPlatform": "Falta l'argument obligatori \"platform\". S'esperava un de: {{platforms}}",
@@ -222,6 +194,10 @@ const MESSAGES = {
 		"nextStepsNav": "cd {{dir}}",
 		"nextStepsInstall": "Installer afhængigheder: {{command}}",
 		"nextStepsDevServer": "Start dev-serveren (hvis din skabelon har en)",
+		"getStartedHeading": "Næste skridt:",
+		"installSpinnerStart": "Installer afhængigheder: {{command}}",
+		"installSpinnerStop": "Afhængigheder installeret.",
+		"installSpinnerFailed": "Installer afhængigheder: {{command}}",
 		"notesHeading": "Bemærk:",
 		"caveatsHeading": "Forbehold:",
 		"errorMissingPlatform": "Mangler krævet argument \"platform\". Forventet en af: {{platforms}}",
@@ -276,6 +252,10 @@ const MESSAGES = {
 		"nextStepsNav": "cd {{dir}}",
 		"nextStepsInstall": "Installeer afhankelijkheden: {{command}}",
 		"nextStepsDevServer": "Start de dev-server (als je template er één heeft)",
+		"getStartedHeading": "Volgende stappen:",
+		"installSpinnerStart": "Installeer afhankelijkheden: {{command}}",
+		"installSpinnerStop": "Afhankelijkheden geïnstalleerd.",
+		"installSpinnerFailed": "Installeer afhankelijkheden: {{command}}",
 		"notesHeading": "Opmerking:",
 		"caveatsHeading": "Opmerking / waarschuwing:",
 		"errorMissingPlatform": "Ontbrekend verplicht argument \"platform\". Verwacht één van: {{platforms}}",
@@ -330,6 +310,10 @@ const MESSAGES = {
 		"nextStepsNav": "cd {{dir}}",
 		"nextStepsInstall": "Install dependencies: {{command}}",
 		"nextStepsDevServer": "Start the dev server (if your template has one)",
+		"getStartedHeading": "Next steps:",
+		"installSpinnerStart": "Install dependencies: {{command}}",
+		"installSpinnerStop": "Dependencies installed.",
+		"installSpinnerFailed": "Install dependencies: {{command}}",
 		"notesHeading": "Note:",
 		"caveatsHeading": "Caveat:",
 		"errorMissingPlatform": "Missing required argument \"platform\". Expected one of: {{platforms}}",
@@ -384,6 +368,10 @@ const MESSAGES = {
 		"nextStepsNav": "cd {{dir}}",
 		"nextStepsInstall": "Install dependencies: {{command}}",
 		"nextStepsDevServer": "Start the dev server (if your template has one)",
+		"getStartedHeading": "Next steps:",
+		"installSpinnerStart": "Install dependencies: {{command}}",
+		"installSpinnerStop": "Dependencies installed.",
+		"installSpinnerFailed": "Install dependencies: {{command}}",
 		"notesHeading": "Note:",
 		"caveatsHeading": "Caveat:",
 		"errorMissingPlatform": "Missing required argument \"platform\". Expected one of: {{platforms}}",
@@ -438,6 +426,10 @@ const MESSAGES = {
 		"nextStepsNav": "cd {{dir}}",
 		"nextStepsInstall": "Install dependencies: {{command}}",
 		"nextStepsDevServer": "Start the dev server (if your template has one)",
+		"getStartedHeading": "Next steps:",
+		"installSpinnerStart": "Install dependencies: {{command}}",
+		"installSpinnerStop": "Dependencies installed.",
+		"installSpinnerFailed": "Install dependencies: {{command}}",
 		"notesHeading": "Note:",
 		"caveatsHeading": "Caveat:",
 		"errorMissingPlatform": "Missing required argument \"platform\". Expected one of: {{platforms}}",
@@ -492,6 +484,10 @@ const MESSAGES = {
 		"nextStepsNav": "cd {{dir}}",
 		"nextStepsInstall": "Install dependencies: {{command}}",
 		"nextStepsDevServer": "Start the dev server (if your template has one)",
+		"getStartedHeading": "Next steps:",
+		"installSpinnerStart": "2. Installing dependencies",
+		"installSpinnerStop": "Dependencies installed.",
+		"installSpinnerFailed": "2. Installing dependencies",
 		"notesHeading": "Note:",
 		"caveatsHeading": "Caveat:",
 		"errorMissingPlatform": "Missing required argument \"platform\". Expected one of: {{platforms}}",
@@ -546,6 +542,10 @@ const MESSAGES = {
 		"nextStepsNav": "cd {{dir}}",
 		"nextStepsInstall": "Asenna riippuvuudet: {{command}}",
 		"nextStepsDevServer": "Käynnistä kehityspalvelin (jos mallissasi on)",
+		"getStartedHeading": "Seuraavat vaiheet:",
+		"installSpinnerStart": "Asenna riippuvuudet: {{command}}",
+		"installSpinnerStop": "Riippuvuudet asennettu.",
+		"installSpinnerFailed": "Asenna riippuvuudet: {{command}}",
 		"notesHeading": "Huom:",
 		"caveatsHeading": "Varoitus:",
 		"errorMissingPlatform": "Puuttuu vaadittu argumentti \"platform\". Odotettu yksi seuraavista: {{platforms}}",
@@ -600,6 +600,10 @@ const MESSAGES = {
 		"nextStepsNav": "cd {{dir}}",
 		"nextStepsInstall": "Installer les dépendances : {{command}}",
 		"nextStepsDevServer": "Démarrer le serveur de développement (si votre modèle en propose un)",
+		"getStartedHeading": "Étapes suivantes :",
+		"installSpinnerStart": "Installer les dépendances : {{command}}",
+		"installSpinnerStop": "Dépendances installées.",
+		"installSpinnerFailed": "Installer les dépendances : {{command}}",
 		"notesHeading": "Remarque :",
 		"caveatsHeading": "Précaution :",
 		"errorMissingPlatform": "Argument requis manquant \"platform\". Attendu : l'un des suivants : {{platforms}}",
@@ -654,6 +658,10 @@ const MESSAGES = {
 		"nextStepsNav": "cd {{dir}}",
 		"nextStepsInstall": "Installer les dépendances : {{command}}",
 		"nextStepsDevServer": "Démarrer le serveur de développement (si votre modèle en fournit un)",
+		"getStartedHeading": "Étapes suivantes :",
+		"installSpinnerStart": "Installer les dépendances : {{command}}",
+		"installSpinnerStop": "Dépendances installées.",
+		"installSpinnerFailed": "Installer les dépendances : {{command}}",
 		"notesHeading": "Remarque :",
 		"caveatsHeading": "Précaution :",
 		"errorMissingPlatform": "Argument requis manquant \"platform\". Attendu : l'un de : {{platforms}}",
@@ -708,6 +716,10 @@ const MESSAGES = {
 		"nextStepsNav": "cd {{dir}}",
 		"nextStepsInstall": "Suiteáil spleáchais: {{command}}",
 		"nextStepsDevServer": "Tosaigh an freastalaí forbartha (má tá ceann sa téama agat)",
+		"getStartedHeading": "Céimeanna eile:",
+		"installSpinnerStart": "Suiteáil spleáchais: {{command}}",
+		"installSpinnerStop": "Spleáchais suiteáilte.",
+		"installSpinnerFailed": "Suiteáil spleáchais: {{command}}",
 		"notesHeading": "Nóta:",
 		"caveatsHeading": "Rabhadh:",
 		"errorMissingPlatform": "Easpa argóint riachtanach \"platform\". Bhíothas ag súil le ceann de: {{platforms}}",
@@ -762,6 +774,10 @@ const MESSAGES = {
 		"nextStepsNav": "cd {{dir}}",
 		"nextStepsInstall": "Abhängigkeiten installieren: {{command}}",
 		"nextStepsDevServer": "Entwicklungsserver starten (falls die Vorlage einen enthält)",
+		"getStartedHeading": "Nächste Schritte:",
+		"installSpinnerStart": "Abhängigkeiten installieren: {{command}}",
+		"installSpinnerStop": "Abhängigkeiten installiert.",
+		"installSpinnerFailed": "Abhängigkeiten installieren: {{command}}",
 		"notesHeading": "Hinweis:",
 		"caveatsHeading": "Einschränkung:",
 		"errorMissingPlatform": "Fehlendes erforderliches Argument \"platform\". Erwartet eines von: {{platforms}}",
@@ -816,6 +832,10 @@ const MESSAGES = {
 		"nextStepsNav": "cd {{dir}}",
 		"nextStepsInstall": "Εγκατάσταση εξαρτήσεων: {{command}}",
 		"nextStepsDevServer": "Εκκίνηση του dev server (αν το πρότυπό σας έχει έναν)",
+		"getStartedHeading": "Επόμενα βήματα:",
+		"installSpinnerStart": "Εγκατάσταση εξαρτήσεων: {{command}}",
+		"installSpinnerStop": "Εγκαταστάθηκαν οι εξαρτήσεις.",
+		"installSpinnerFailed": "Εγκατάσταση εξαρτήσεων: {{command}}",
 		"notesHeading": "Σημείωση:",
 		"caveatsHeading": "Προειδοποίηση:",
 		"errorMissingPlatform": "Λείπει η απαιτούμενη παράμετρος \"platform\". Αναμένονται μία από: {{platforms}}",
@@ -870,6 +890,10 @@ const MESSAGES = {
 		"nextStepsNav": "cd {{dir}}",
 		"nextStepsInstall": "Enstale depandans: {{command}}",
 		"nextStepsDevServer": "Kòmanse sèvè dev (si modèl ou a gen youn)",
+		"getStartedHeading": "Pwochèn etap:",
+		"installSpinnerStart": "Enstale depandans: {{command}}",
+		"installSpinnerStop": "Depandans enstale.",
+		"installSpinnerFailed": "Enstale depandans: {{command}}",
 		"notesHeading": "Remak:",
 		"caveatsHeading": "Avètisman:",
 		"errorMissingPlatform": "Agiman obligatwa \"platform\" manke. Atann youn nan: {{platforms}}",
@@ -924,6 +948,10 @@ const MESSAGES = {
 		"nextStepsNav": "cd {{dir}}",
 		"nextStepsInstall": "התקן תלותים: {{command}}",
 		"nextStepsDevServer": "הפעל את שרת הפיתוח (אם התבנית שלך כוללת אחד)",
+		"getStartedHeading": "שלבים הבאים:",
+		"installSpinnerStart": "התקן תלותים: {{command}}",
+		"installSpinnerStop": "התלויות הותקנו.",
+		"installSpinnerFailed": "התקן תלותים: {{command}}",
 		"notesHeading": "הערה:",
 		"caveatsHeading": "אזהרה:",
 		"errorMissingPlatform": "חסר ארגומנט דרוש \"platform\". צפוי אחד מ: {{platforms}}",
@@ -978,6 +1006,10 @@ const MESSAGES = {
 		"nextStepsNav": "cd {{dir}}",
 		"nextStepsInstall": "निर्भरता स्थापित करें: {{command}}",
 		"nextStepsDevServer": "डेव सर्वर शुरू करें (यदि आपके टेम्पलेट में है)",
+		"getStartedHeading": "अगले चरण:",
+		"installSpinnerStart": "निर्भरता स्थापित करें: {{command}}",
+		"installSpinnerStop": "निर्भरता स्थापित की गईं.",
+		"installSpinnerFailed": "निर्भरता स्थापित करें: {{command}}",
 		"notesHeading": "नोट:",
 		"caveatsHeading": "ध्यान दें:",
 		"errorMissingPlatform": "आवश्यक तर्क \"platform\" गायब है। अपेक्षित में से एक: {{platforms}}",
@@ -1032,6 +1064,10 @@ const MESSAGES = {
 		"nextStepsNav": "cd {{dir}}",
 		"nextStepsInstall": "Függőségek telepítése: {{command}}",
 		"nextStepsDevServer": "Indítsd el a fejlesztői szervert (ha a sablonod tartalmaz ilyet)",
+		"getStartedHeading": "Következő lépések:",
+		"installSpinnerStart": "Függőségek telepítése: {{command}}",
+		"installSpinnerStop": "Függőségek telepítve.",
+		"installSpinnerFailed": "Függőségek telepítése: {{command}}",
 		"notesHeading": "Megjegyzés:",
 		"caveatsHeading": "Figyelmeztetés:",
 		"errorMissingPlatform": "Hiányzó kötelező argumentum \"platform\". Egyik várható: {{platforms}}",
@@ -1086,6 +1122,10 @@ const MESSAGES = {
 		"nextStepsNav": "cd {{dir}}",
 		"nextStepsInstall": "Settu upp háður: {{command}}",
 		"nextStepsDevServer": "Ræstu þróunarþjóninn (ef sniðmátið inniheldur einn)",
+		"getStartedHeading": "Næstu skref:",
+		"installSpinnerStart": "Settu upp háður: {{command}}",
+		"installSpinnerStop": "Háðir pakkar uppsettir.",
+		"installSpinnerFailed": "Settu upp háður: {{command}}",
 		"notesHeading": "Athugið:",
 		"caveatsHeading": "Ábending:",
 		"errorMissingPlatform": "Vantar nauðsynlegt rök \"platform\". Búist var við einu af: {{platforms}}",
@@ -1140,6 +1180,10 @@ const MESSAGES = {
 		"nextStepsNav": "cd {{dir}}",
 		"nextStepsInstall": "Pasang dependensi: {{command}}",
 		"nextStepsDevServer": "Jalankan server pengembangan (jika template Anda memilikinya)",
+		"getStartedHeading": "Langkah selanjutnya:",
+		"installSpinnerStart": "Pasang dependensi: {{command}}",
+		"installSpinnerStop": "Dependensi terpasang.",
+		"installSpinnerFailed": "Pasang dependensi: {{command}}",
 		"notesHeading": "Catatan:",
 		"caveatsHeading": "Peringatan:",
 		"errorMissingPlatform": "Argumen wajib \"platform\" hilang. Diharapkan salah satu: {{platforms}}",
@@ -1194,6 +1238,10 @@ const MESSAGES = {
 		"nextStepsNav": "cd {{dir}}",
 		"nextStepsInstall": "Installa le dipendenze: {{command}}",
 		"nextStepsDevServer": "Avvia il server di sviluppo (se il template ne prevede uno)",
+		"getStartedHeading": "Prossimi passi:",
+		"installSpinnerStart": "Installa le dipendenze: {{command}}",
+		"installSpinnerStop": "Dipendenze installate.",
+		"installSpinnerFailed": "Installa le dipendenze: {{command}}",
 		"notesHeading": "Nota:",
 		"caveatsHeading": "Avvertenza:",
 		"errorMissingPlatform": "Argomento obbligatorio mancante \"platform\". Atteso uno dei seguenti: {{platforms}}",
@@ -1248,6 +1296,10 @@ const MESSAGES = {
 		"nextStepsNav": "cd {{dir}}",
 		"nextStepsInstall": "依存関係をインストール: {{command}}",
 		"nextStepsDevServer": "開発サーバーを起動（テンプレートにある場合）",
+		"getStartedHeading": "次の手順:",
+		"installSpinnerStart": "依存関係をインストール: {{command}}",
+		"installSpinnerStop": "依存関係がインストールされました。",
+		"installSpinnerFailed": "依存関係をインストール: {{command}}",
 		"notesHeading": "注意:",
 		"caveatsHeading": "留意事項:",
 		"errorMissingPlatform": "必須引数 \"platform\" がありません。予期される値: {{platforms}}",
@@ -1302,6 +1354,10 @@ const MESSAGES = {
 		"nextStepsNav": "cd {{dir}}",
 		"nextStepsInstall": "의존성 설치: {{command}}",
 		"nextStepsDevServer": "개발 서버 시작 (템플릿에 해당 기능이 있는 경우)",
+		"getStartedHeading": "다음 단계:",
+		"installSpinnerStart": "의존성 설치: {{command}}",
+		"installSpinnerStop": "종속성이 설치되었습니다.",
+		"installSpinnerFailed": "의존성 설치: {{command}}",
 		"notesHeading": "참고:",
 		"caveatsHeading": "주의:",
 		"errorMissingPlatform": "필수 인수 \"platform\" 누락. 다음 중 하나여야 합니다: {{platforms}}",
@@ -1356,6 +1412,10 @@ const MESSAGES = {
 		"nextStepsNav": "cd {{dir}}",
 		"nextStepsInstall": "Tāuta ngā whakawhirinaki: {{command}}",
 		"nextStepsDevServer": "Tīmatahia te tūmau whakawhanake (mēnā kei tō tauira)",
+		"getStartedHeading": "Hipanga e whai ake:",
+		"installSpinnerStart": "Tāuta ngā whakawhirinaki: {{command}}",
+		"installSpinnerStop": "Kua tāuta ngā whakawhirinaki.",
+		"installSpinnerFailed": "Tāuta ngā whakawhirinaki: {{command}}",
 		"notesHeading": "Tuhipoka:",
 		"caveatsHeading": "Whakatūpato:",
 		"errorMissingPlatform": "Kua ngaro te kupu whakahau hiahia \"platform\". Me kotahi o ēnei: {{platforms}}",
@@ -1410,6 +1470,10 @@ const MESSAGES = {
 		"nextStepsNav": "cd {{dir}}",
 		"nextStepsInstall": "Pasang kebergantungan: {{command}}",
 		"nextStepsDevServer": "Mulakan pelayan pembangunan (jika templat anda mempunyainya)",
+		"getStartedHeading": "Langkah seterusnya:",
+		"installSpinnerStart": "Pasang kebergantungan: {{command}}",
+		"installSpinnerStop": "Kebergantungan dipasang.",
+		"installSpinnerFailed": "Pasang kebergantungan: {{command}}",
 		"notesHeading": "Nota:",
 		"caveatsHeading": "Amaran:",
 		"errorMissingPlatform": "Argumen diperlukan \"platform\" hilang. Dijangka salah satu: {{platforms}}",
@@ -1464,6 +1528,10 @@ const MESSAGES = {
 		"nextStepsNav": "cd {{dir}}",
 		"nextStepsInstall": "Installera beroenden: {{command}}",
 		"nextStepsDevServer": "Starta dev-servern (om din mall har en)",
+		"getStartedHeading": "Nästa steg:",
+		"installSpinnerStart": "Installera beroenden: {{command}}",
+		"installSpinnerStop": "Dependencies installed.",
+		"installSpinnerFailed": "Installera beroenden: {{command}}",
 		"notesHeading": "Notering:",
 		"caveatsHeading": "Varning:",
 		"errorMissingPlatform": "Saknad obligatorisk argument \"platform\". Förväntat ett av: {{platforms}}",
@@ -1518,6 +1586,10 @@ const MESSAGES = {
 		"nextStepsNav": "cd {{dir}}",
 		"nextStepsInstall": "Installer avhengigheter: {{command}}",
 		"nextStepsDevServer": "Start utviklingsserveren (hvis malen din har en)",
+		"getStartedHeading": "Neste steg:",
+		"installSpinnerStart": "Installer avhengigheter: {{command}}",
+		"installSpinnerStop": "Avhengigheter installert.",
+		"installSpinnerFailed": "Installer avhengigheter: {{command}}",
 		"notesHeading": "Merk:",
 		"caveatsHeading": "Forbehold:",
 		"errorMissingPlatform": "Mangler påkrevd argument \"platform\". Forventet en av: {{platforms}}",
@@ -1572,6 +1644,10 @@ const MESSAGES = {
 		"nextStepsNav": "cd {{dir}}",
 		"nextStepsInstall": "Installer avhengigheiter: {{command}}",
 		"nextStepsDevServer": "Start utviklarserveren (om malen har ein)",
+		"getStartedHeading": "Neste steg:",
+		"installSpinnerStart": "Installer avhengigheiter: {{command}}",
+		"installSpinnerStop": "Avhengigheiter installert.",
+		"installSpinnerFailed": "Installer avhengigheiter: {{command}}",
 		"notesHeading": "Merk:",
 		"caveatsHeading": "Forbehald:",
 		"errorMissingPlatform": "Manglande påkravd argument \"platform\". Forventa éin av: {{platforms}}",
@@ -1626,6 +1702,10 @@ const MESSAGES = {
 		"nextStepsNav": "cd {{dir}}",
 		"nextStepsInstall": "نصب وابستگی‌ها: {{command}}",
 		"nextStepsDevServer": "راه‌اندازی سرور توسعه (در صورت وجود در قالب شما)",
+		"getStartedHeading": "گام‌های بعدی:",
+		"installSpinnerStart": "نصب وابستگی‌ها: {{command}}",
+		"installSpinnerStop": "وابستگی‌ها نصب شدند.",
+		"installSpinnerFailed": "نصب وابستگی‌ها: {{command}}",
 		"notesHeading": "توجه:",
 		"caveatsHeading": "ملاحظات:",
 		"errorMissingPlatform": "آرگومان اجباری \"platform\" مفقود است. انتظار یکی از موارد: {{platforms}}",
@@ -1680,6 +1760,10 @@ const MESSAGES = {
 		"nextStepsNav": "cd {{dir}}",
 		"nextStepsInstall": "Zainstaluj zależności: {{command}}",
 		"nextStepsDevServer": "Uruchom serwer deweloperski (jeśli szablon go zawiera)",
+		"getStartedHeading": "Kolejne kroki:",
+		"installSpinnerStart": "Zainstaluj zależności: {{command}}",
+		"installSpinnerStop": "Zależności zainstalowane.",
+		"installSpinnerFailed": "Zainstaluj zależności: {{command}}",
 		"notesHeading": "Uwaga:",
 		"caveatsHeading": "Ograniczenie:",
 		"errorMissingPlatform": "Brakuje wymaganego argumentu \"platform\". Oczekiwano jednego z: {{platforms}}",
@@ -1734,6 +1818,10 @@ const MESSAGES = {
 		"nextStepsNav": "cd {{dir}}",
 		"nextStepsInstall": "Instalar dependências: {{command}}",
 		"nextStepsDevServer": "Inicie o servidor de desenvolvimento (se o seu template tiver um)",
+		"getStartedHeading": "Próximos passos:",
+		"installSpinnerStart": "Instalar dependências: {{command}}",
+		"installSpinnerStop": "Dependências instaladas.",
+		"installSpinnerFailed": "Instalar dependências: {{command}}",
 		"notesHeading": "Observação:",
 		"caveatsHeading": "Atenção:",
 		"errorMissingPlatform": "Argumento obrigatório \"platform\" ausente. Esperado um dos: {{platforms}}",
@@ -1788,6 +1876,10 @@ const MESSAGES = {
 		"nextStepsNav": "cd {{dir}}",
 		"nextStepsInstall": "Instalar dependências: {{command}}",
 		"nextStepsDevServer": "Iniciar o servidor de desenvolvimento (se o template tiver um)",
+		"getStartedHeading": "Próximos passos:",
+		"installSpinnerStart": "Instalar dependências: {{command}}",
+		"installSpinnerStop": "Dependências instaladas.",
+		"installSpinnerFailed": "Instalar dependências: {{command}}",
 		"notesHeading": "Observação:",
 		"caveatsHeading": "Atenção:",
 		"errorMissingPlatform": "Argumento obrigatório \"platform\" ausente. Esperado um de: {{platforms}}",
@@ -1842,6 +1934,10 @@ const MESSAGES = {
 		"nextStepsNav": "cd {{dir}}",
 		"nextStepsInstall": "Установите зависимости: {{command}}",
 		"nextStepsDevServer": "Запустите dev-сервер (если он есть в шаблоне)",
+		"getStartedHeading": "Дальше:",
+		"installSpinnerStart": "Установите зависимости: {{command}}",
+		"installSpinnerStop": "Зависимости установлены.",
+		"installSpinnerFailed": "Установите зависимости: {{command}}",
 		"notesHeading": "Примечание:",
 		"caveatsHeading": "Ограничения:",
 		"errorMissingPlatform": "Отсутствует обязательный аргумент \"platform\". Ожидалось одно из: {{platforms}}",
@@ -1896,6 +1992,10 @@ const MESSAGES = {
 		"nextStepsNav": "cd {{dir}}",
 		"nextStepsInstall": "安装依赖：{{command}}",
 		"nextStepsDevServer": "启动开发服务器（如果你的模板提供）",
+		"getStartedHeading": "后续步骤：",
+		"installSpinnerStart": "安装依赖：{{command}}",
+		"installSpinnerStop": "依赖已安装。",
+		"installSpinnerFailed": "安装依赖：{{command}}",
 		"notesHeading": "注意：",
 		"caveatsHeading": "注意事项：",
 		"errorMissingPlatform": "缺少必需参数 \"platform\"。期望其中之一：{{platforms}}",
@@ -1950,6 +2050,10 @@ const MESSAGES = {
 		"nextStepsNav": "cd {{dir}}",
 		"nextStepsInstall": "Namestite odvisnosti: {{command}}",
 		"nextStepsDevServer": "Zaženite razvojni strežnik (če ga ima predloga)",
+		"getStartedHeading": "Naslednji koraki:",
+		"installSpinnerStart": "Namestite odvisnosti: {{command}}",
+		"installSpinnerStop": "Odvisnosti nameščene.",
+		"installSpinnerFailed": "Namestite odvisnosti: {{command}}",
 		"notesHeading": "Opomba:",
 		"caveatsHeading": "Opozorilo:",
 		"errorMissingPlatform": "Manjka zahtevan argument \"platform\". Pričakovana ena od: {{platforms}}",
@@ -2004,6 +2108,10 @@ const MESSAGES = {
 		"nextStepsNav": "cd {{dir}}",
 		"nextStepsInstall": "Instalar dependencias: {{command}}",
 		"nextStepsDevServer": "Iniciar el servidor de desarrollo (si la plantilla tiene uno)",
+		"getStartedHeading": "Siguientes pasos:",
+		"installSpinnerStart": "Instalar dependencias: {{command}}",
+		"installSpinnerStop": "Dependencias instaladas.",
+		"installSpinnerFailed": "Instalar dependencias: {{command}}",
 		"notesHeading": "Nota:",
 		"caveatsHeading": "Precaución:",
 		"errorMissingPlatform": "Falta el argumento requerido \"platform\". Se esperaba uno de: {{platforms}}",
@@ -2058,6 +2166,10 @@ const MESSAGES = {
 		"nextStepsNav": "cd {{dir}}",
 		"nextStepsInstall": "Installera beroenden: {{command}}",
 		"nextStepsDevServer": "Starta dev-servern (om din mall har en)",
+		"getStartedHeading": "Nästa steg:",
+		"installSpinnerStart": "Installera beroenden: {{command}}",
+		"installSpinnerStop": "Beroenden installerade.",
+		"installSpinnerFailed": "Installera beroenden: {{command}}",
 		"notesHeading": "Notera:",
 		"caveatsHeading": "Varning:",
 		"errorMissingPlatform": "Saknas obligatoriskt argument \"platform\". Förväntat ett av: {{platforms}}",
@@ -2112,6 +2224,10 @@ const MESSAGES = {
 		"nextStepsNav": "cd {{dir}}",
 		"nextStepsInstall": "ติดตั้ง dependencies: {{command}}",
 		"nextStepsDevServer": "เริ่มเซิร์ฟเวอร์สำหรับพัฒนา (ถ้าเทมเพลตมี)",
+		"getStartedHeading": "ขั้นตอนถัดไป:",
+		"installSpinnerStart": "ติดตั้ง dependencies: {{command}}",
+		"installSpinnerStop": "ติดตั้งการพึ่งพาเรียบร้อยแล้ว.",
+		"installSpinnerFailed": "ติดตั้ง dependencies: {{command}}",
 		"notesHeading": "หมายเหตุ:",
 		"caveatsHeading": "ข้อควรระวัง:",
 		"errorMissingPlatform": "ขาดอาร์กิวเมนต์ที่จำเป็น \"platform\". คาดหวังหนึ่งใน: {{platforms}}",
@@ -2166,6 +2282,10 @@ const MESSAGES = {
 		"nextStepsNav": "cd {{dir}}",
 		"nextStepsInstall": "安裝相依套件：{{command}}",
 		"nextStepsDevServer": "啟動開發伺服器（若範本有提供）",
+		"getStartedHeading": "下一步：",
+		"installSpinnerStart": "安裝相依套件：{{command}}",
+		"installSpinnerStop": "已安裝相依套件。",
+		"installSpinnerFailed": "安裝相依套件：{{command}}",
 		"notesHeading": "注意：",
 		"caveatsHeading": "注意事項：",
 		"errorMissingPlatform": "遺漏必要參數 \"platform\"。預期其中一項：{{platforms}}",
@@ -2220,6 +2340,10 @@ const MESSAGES = {
 		"nextStepsNav": "cd {{dir}}",
 		"nextStepsInstall": "Bağımlılıkları kurun: {{command}}",
 		"nextStepsDevServer": "Geliştirme sunucusunu başlatın (şablonunuzda varsa)",
+		"getStartedHeading": "Sonraki adımlar:",
+		"installSpinnerStart": "Bağımlılıkları kurun: {{command}}",
+		"installSpinnerStop": "Bağımlılıklar yüklendi.",
+		"installSpinnerFailed": "Bağımlılıkları kurun: {{command}}",
 		"notesHeading": "Not:",
 		"caveatsHeading": "Uyarı:",
 		"errorMissingPlatform": "Gerekli argüman \"platform\" eksik. Beklenenler: {{platforms}}",
@@ -2274,6 +2398,10 @@ const MESSAGES = {
 		"nextStepsNav": "cd {{dir}}",
 		"nextStepsInstall": "Встановити залежності: {{command}}",
 		"nextStepsDevServer": "Запустити dev‑сервер (якщо шаблон його має)",
+		"getStartedHeading": "Наступні кроки:",
+		"installSpinnerStart": "Встановити залежності: {{command}}",
+		"installSpinnerStop": "Залежності встановлено.",
+		"installSpinnerFailed": "Встановити залежності: {{command}}",
 		"notesHeading": "Примітка:",
 		"caveatsHeading": "Попередження:",
 		"errorMissingPlatform": "Відсутній обовʼязковий аргумент \"platform\". Очікується один з: {{platforms}}",
@@ -2328,6 +2456,10 @@ const MESSAGES = {
 		"nextStepsNav": "cd {{dir}}",
 		"nextStepsInstall": "Cài đặt phụ thuộc: {{command}}",
 		"nextStepsDevServer": "Khởi động máy chủ dev (nếu mẫu có)",
+		"getStartedHeading": "Bước tiếp theo:",
+		"installSpinnerStart": "Cài đặt phụ thuộc: {{command}}",
+		"installSpinnerStop": "Đã cài đặt các phụ thuộc.",
+		"installSpinnerFailed": "Cài đặt phụ thuộc: {{command}}",
 		"notesHeading": "Lưu ý:",
 		"caveatsHeading": "Cảnh báo:",
 		"errorMissingPlatform": "Thiếu tham số bắt buộc \"platform\". Mong đợi một trong: {{platforms}}",
@@ -2382,6 +2514,10 @@ const MESSAGES = {
 		"nextStepsNav": "cd {{dir}}",
 		"nextStepsInstall": "Gosod dibyniaethau: {{command}}",
 		"nextStepsDevServer": "Cychwyn y gweinydd datblyg (os oes gan eich templed un)",
+		"getStartedHeading": "Camau nesaf:",
+		"installSpinnerStart": "Gosod dibyniaethau: {{command}}",
+		"installSpinnerStop": "Dibyniaethau wedi'u gosod.",
+		"installSpinnerFailed": "Gosod dibyniaethau: {{command}}",
 		"notesHeading": "Nodyn:",
 		"caveatsHeading": "Rhybudd:",
 		"errorMissingPlatform": "Diffyg y dadleuon gofynnol \"platform\". Disgwylir un o: {{platforms}}",
@@ -2488,6 +2624,23 @@ function expandHome(dir) {
 	return dir === "~" ? home : join(home, dir.slice(2));
 }
 /**
+* Human-readable labels for the interactive platform picker — canonical `SCAFFOLD_PLATFORMS` keys
+* are lowercase/hyphenated for CLI-arg use, not meant for display as-is.
+*/
+const PLATFORM_DISPLAY_LABELS = {
+	components: "HTML",
+	"web-components": "Web components",
+	react: "React",
+	vue: "Vue",
+	angular: "Angular",
+	svelte: "Svelte",
+	"canvas-theme-editor": "Canvas theme editor"
+};
+/** Display label for a platform key, falling back to the raw key if unmapped. */
+function platformDisplayLabel(platform) {
+	return PLATFORM_DISPLAY_LABELS[platform] ?? platform;
+}
+/**
 * Resolves the platform: uses `platformArg` when given, otherwise prompts via clack `select()`
 * on a TTY (not --yes), otherwise throws a localized `ScaffoldCliError`.
 *
@@ -2503,10 +2656,10 @@ async function resolvePlatform(platformArg, opts) {
 		})) throw new ScaffoldCliError(t("errorMissingPlatform", { platforms: SCAFFOLD_PLATFORMS.join(", ") }));
 		const result = await select({
 			message: t("promptPlatform"),
-			options: SCAFFOLD_PLATFORMS.map((p) => ({
+			options: [...SCAFFOLD_PLATFORMS].map((p) => ({
 				value: p,
-				label: p
-			}))
+				label: platformDisplayLabel(p)
+			})).sort((a, b) => a.label.localeCompare(b.label))
 		});
 		if (isCancel(result)) {
 			cancel(t("cancelled"));
@@ -2575,7 +2728,7 @@ async function resolveScaffoldTarget(options) {
 * @param platform - The scaffold platform
 * @param dir - The target directory
 * @param t - Localized string lookup
-* @param options - `theme`/`mode`/`cdn` forwarded to {@link scaffoldProject}
+* @param options - `theme`/`mode`/`cdn`/`locale` forwarded to {@link scaffoldProject}
 * @returns The paths written by scaffoldProject
 */
 async function scaffoldWithSpinner(platform, dir, t, options) {
@@ -2645,6 +2798,50 @@ const PM_COMMANDS = {
 function pmCommands(pm) {
 	return PM_COMMANDS[pm ?? "npm"];
 }
+/** Per-package-manager invocation for `create-pantoken-app`'s own usage/help text. */
+const CREATE_USAGE_COMMANDS = {
+	npm: "npm create pantoken-app --",
+	pnpm: "pnpm create pantoken-app --",
+	yarn: "yarn create pantoken-app --",
+	bun: "bunx create-pantoken-app --",
+	deno: "deno run -A npm:create-pantoken-app --",
+	vp: "vpx create-pantoken-app --"
+};
+/**
+* The invocation string `create-pantoken-app`'s bin shim shows in `--help`/usage, matching
+* whichever package manager actually invoked it (falls back to the npm form when undetected).
+*
+* @param pm - The detected package manager (defaults to `detectPackageManager()`'s result)
+*/
+function buildCreateUsageCommand(pm) {
+	return CREATE_USAGE_COMMANDS[pm ?? detectPackageManager() ?? "npm"];
+}
+/**
+* Runs the detected package manager's install command in `dir`, wrapped in a clack spinner.
+* Failures are reported but non-fatal — the project is still usable, just not installed — so the
+* caller decides how `printNextSteps` should reflect the outcome via the returned boolean.
+*
+* @param dir - The scaffold directory to install into
+* @param pm - The detected package manager (defaults to npm's command when undefined)
+* @param t - Localized string lookup
+* @returns Whether the install command exited successfully
+*/
+function installWithSpinner(dir, pm, t) {
+	const [command, ...args] = pmCommands(pm).install.split(" ");
+	const s = spinner();
+	s.start(t("installSpinnerStart"));
+	try {
+		execFileSync(command, args, {
+			cwd: dir,
+			stdio: "ignore"
+		});
+		s.stop(t("installSpinnerStop"));
+		return true;
+	} catch (err) {
+		s.stop(`${t("installSpinnerFailed")} ${err instanceof Error ? err.message : String(err)}`);
+		return false;
+	}
+}
 /**
 * Finds the scaffolded `package.json` among `written` and returns its preferred run script name
 * (`dev`, else `preview`), or `undefined` if no such file/script exists (or can't be read).
@@ -2665,20 +2862,27 @@ function detectRunScript(written) {
 function substituteVars(text, vars) {
 	return text.replace(/\{\{(\w+)\}\}/g, (match, name) => vars[name] ?? match);
 }
+/** The one remaining manual step after an automatic install: `cd <dir> && <dev>`, or just `<dev>` when `dir` is `.`. */
+function buildDevStep(dir, dev) {
+	return dir === "." ? dev : `cd ${dir} && ${dev}`;
+}
 /**
 * Prints the post-scaffold "Next steps" block (plus any template-authored notes/caveats).
 *
-* When `platform` has a `scaffold.json`-derived entry in `SCAFFOLD_METADATA`, next steps/notes/
-* caveats are rendered from its (localized, `{{var}}`-substituted) authored strings. Otherwise a
-* generic cd/install/run-script fallback is used, with the run script itself detected from the
-* scaffolded `package.json` (`dev`, else `preview`).
+* When `installed` is true (dependencies were already installed automatically), the block collapses
+* to the single remaining manual action — starting the dev server, prefixed with `cd <dir>` when
+* needed — regardless of platform. Otherwise, when `platform` has a `scaffold.json`-derived entry in
+* `SCAFFOLD_METADATA`, next steps/notes/caveats are rendered from its (localized, `{{var}}`-
+* substituted) authored strings; failing that, a generic cd/install/run-script fallback is used,
+* with the run script itself detected from the scaffolded `package.json` (`dev`, else `preview`).
 *
 * @param dir - The scaffold directory
 * @param written - The paths written by scaffoldProject
 * @param t - Localized string lookup
 * @param platform - The resolved (alias-free) scaffold platform, used to look up `scaffold.json` metadata
+* @param installed - Whether dependencies were already installed automatically
 */
-function printNextSteps(dir, written, t, platform) {
+function printNextSteps(dir, written, t, platform, installed) {
 	const pm = detectPackageManager();
 	const { install, run } = pmCommands(pm);
 	const script = detectRunScript(written);
@@ -2692,13 +2896,13 @@ function printNextSteps(dir, written, t, platform) {
 		dev
 	};
 	const meta = platform ? SCAFFOLD_METADATA[platform] : void 0;
-	const steps = meta?.nextStepsKeys.length ? meta.nextStepsKeys.map((key) => substituteVars(t(key), vars)) : [
+	const steps = installed ? [buildDevStep(dir, dev)] : meta?.nextStepsKeys.length ? meta.nextStepsKeys.map((key) => substituteVars(t(key), vars)) : [
 		t("nextStepsNav", { dir }),
 		t("nextStepsInstall", { command: install }),
 		dev
 	];
 	console.log();
-	console.log(t("nextStepsHeading"));
+	console.log(installed ? t("getStartedHeading") : t("nextStepsHeading"));
 	steps.forEach((step, i) => console.log(`${i + 1}. ${step}`));
 	if (meta?.notesKey) console.log(`\n${t("notesHeading")} ${substituteVars(t(meta.notesKey), vars)}`);
 	if (meta?.caveatsKey) console.log(`${t("caveatsHeading")} ${substituteVars(t(meta.caveatsKey), vars)}`);
@@ -2736,7 +2940,7 @@ function createScaffoldCommand(options) {
 	const program = new Command(programName).exitOverride().configureOutput({
 		writeOut: (s) => process.stdout.write(s),
 		writeErr: (s) => process.stderr.write(s)
-	}).addArgument(new Argument("[platform]", `Platform to scaffold (${SCAFFOLD_PLATFORMS.join("|")}; "html" is an alias for "components")`).argParser(validateScaffoldPlatform)).option("-d, --dir <path>", "Target directory (prompts interactively on a TTY if omitted)").option("-y, --yes", "Never prompt; error instead of prompting for a missing platform/directory", false).option("-l, --lang <tag>", "Override the auto-detected display language (e.g. \"hu\")").option("--theme <name>", "Token theme: rebrand (default), canvas, canvasHighContrast", validateThemeVariant).option("--theme-mode <mode>", "Rebrand token mode: light (default) or adaptive; ignored outside the rebrand theme", validateThemeMode).option("--cdn <provider>", "CDN provider for canvas-theme-editor's theme.css/theme.js: jsdelivr (default), unpkg, esmsh", validateCdnProviderId);
+	}).addArgument(new Argument("[platform]", `Platform to scaffold (${SCAFFOLD_PLATFORMS.join("|")}; "html" is an alias for "components")`).argParser(validateScaffoldPlatform)).option("-d, --dir <path>", "Target directory (prompts interactively on a TTY if omitted)").option("-y, --yes", "Never prompt; error instead of prompting for a missing platform/directory", false).option("-l, --lang <tag>", "Language for the CLI and the scaffolded project (e.g. \"hu\"); auto-detected by default", validateLocaleTag).option("--theme <name>", "Token theme: rebrand (default), canvas, canvasHighContrast", validateThemeVariant).option("--theme-mode <mode>", "Rebrand token mode: light (default) or adaptive; ignored outside the rebrand theme", validateThemeMode).option("--cdn <provider>", "CDN provider for canvas-theme-editor's theme.css/theme.js: jsdelivr (default), unpkg, esmsh", validateCdnProviderId).option("--no-install", "Skip automatically installing dependencies after scaffolding");
 	if (options?.version) program.version(options.version, "-v, --version");
 	program.action(async (platformArg, opts) => {
 		const locale = detectLocale({ langFlag: opts.lang });
@@ -2752,10 +2956,17 @@ function createScaffoldCommand(options) {
 			const written = await scaffoldWithSpinner(platform, expandedDir, t, {
 				theme: opts.theme,
 				mode: opts.themeMode,
-				cdn: opts.cdn
+				cdn: opts.cdn,
+				locale
 			});
 			for (const path of written) console.log(t("wroteFile", { path }));
-			printNextSteps(expandedDir, written, t, resolveScaffoldPlatform(platform));
+			let printDir = expandedDir;
+			if (expandedDir !== ".") try {
+				process.chdir(expandedDir);
+				printDir = ".";
+			} catch {}
+			const installed = opts.install !== false && installWithSpinner(expandedDir, detectPackageManager(), t);
+			printNextSteps(printDir, written, t, resolveScaffoldPlatform(platform), installed);
 		} catch (err) {
 			if (err instanceof ScaffoldCliError) throw err;
 			throw err;
@@ -2793,4 +3004,4 @@ async function runScaffoldCli(argv, options) {
 	}
 }
 //#endregion
-export { MESSAGES, SCAFFOLD_PLATFORMS, ScaffoldCliError, createLocaleLookup, createScaffoldCommand, detectLocale, detectPackageManager, expandHome, isScaffoldPlatform, printNextSteps, resolveScaffoldPlatform, resolveScaffoldTarget, runScaffoldCli, scaffoldProject, scaffoldWithSpinner, shouldPrompt, validateCdnProviderId, validateScaffoldPlatform };
+export { MESSAGES, SCAFFOLD_PLATFORMS, SUPPORTED_LOCALES, ScaffoldCliError, buildCreateUsageCommand, createLocaleLookup, createScaffoldCommand, detectLocale, detectPackageManager, expandHome, installWithSpinner, isScaffoldPlatform, printNextSteps, resolveScaffoldPlatform, resolveScaffoldTarget, runScaffoldCli, scaffoldProject, scaffoldWithSpinner, shouldPrompt, validateCdnProviderId, validateLocaleTag, validateScaffoldPlatform };