@hype-stack/cli 1.1.1 → 1.3.0

package/dist/cli.d.ts

@@ -1,3 +1,8 @@
 import { Command } from 'commander';
+import { CustomizationOptions } from './types/types';
+/** `--mode` accepts only the two color modes a generated app can boot in. */
+export declare function parseColorMode(value: string | undefined): "light" | "dark" | undefined;
+/** Pull the look-and-feel flags off a parsed Commander options object. */
+export declare function customizationFrom(options: Record<string, unknown>): CustomizationOptions;
 export declare function createProgram(): Command;
 //# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0EpC,wBAAgB,aAAa,IAAI,OAAO,CAuLvC"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkBpC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAyB1D,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAEtF;AAoBD,0EAA0E;AAC1E,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,oBAAoB,CAQxF;AAoCD,wBAAgB,aAAa,IAAI,OAAO,CA8LvC"}

package/dist/commands/compose.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../../src/commands/compose.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,aAAa,EAEb,WAAW,EAEZ,MAAM,mBAAmB,CAAC;AAuB3B,wBAAsB,cAAc,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+NhF;AAkGD;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,MAAM,EAAE,CAUxG;AAID;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAIhE;AAED,6FAA6F;AAC7F,wBAAgB,WAAW,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,MAAM,EAAE,CAShE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,WAAW,CAYxE"}
+{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../../src/commands/compose.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,aAAa,EAEb,WAAW,EAEZ,MAAM,mBAAmB,CAAC;AAqB3B,wBAAsB,cAAc,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiQhF;AA0HD;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,MAAM,EAAE,CAUxG;AAID;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAIhE;AAED,6FAA6F;AAC7F,wBAAgB,WAAW,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,MAAM,EAAE,CAShE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,WAAW,CAYxE"}

package/dist/commands/create.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAc,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAWnE,wBAAsB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAwW3E"}
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAc,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAUnE,wBAAsB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAiS3E"}

package/dist/commands/deploy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../src/commands/deploy.ts"],"names":[],"mappings":"AAOA,OAAO,EAAgB,iBAAiB,EAAqC,MAAM,qBAAqB,CAAC;AA6BzG,OAAO,KAAK,EAEV,aAAa,EAEb,YAAY,EACZ,cAAc,EAGf,MAAM,oBAAoB,CAAC;AAM5B;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2J9E;AA2BD,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;IACjD,gBAAgB,EAAE,YAAY,EAAE,CAAC;IACjC,gBAAgB,EAAE,YAAY,EAAE,CAAC;CAClC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,eAAe,GAAG;IAC1D,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B,CAUA"}
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../src/commands/deploy.ts"],"names":[],"mappings":"AAOA,OAAO,EAAgB,iBAAiB,EAAqC,MAAM,qBAAqB,CAAC;AA6BzG,OAAO,KAAK,EAEV,aAAa,EAEb,YAAY,EACZ,cAAc,EAGf,MAAM,oBAAoB,CAAC;AAM5B;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmK9E;AA2BD,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;IACjD,gBAAgB,EAAE,YAAY,EAAE,CAAC;IACjC,gBAAgB,EAAE,YAAY,EAAE,CAAC;CAClC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,eAAe,GAAG;IAC1D,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B,CAUA"}

package/dist/commands/init.d.ts

@@ -1,4 +1,4 @@
-import { InitOptions } from '../types/types.js';
+import { CustomizationOptions, InitOptions } from '../types/types.js';
 export declare function initCommand(options: InitOptions): Promise<void>;
 /**
  * Optional overrides for {@link ensureInit}. Tests inject fakes so the interactive
@@ -9,14 +9,19 @@ export interface EnsureInitRunners {
     /** Returns the absolute target directory the project was scaffolded into. */
     runCreate?: (cwd: string, opts?: ScaffoldOptions) => Promise<string>;
 }
-/** Options forwarded to `create` when `ensureInit` scaffolds a new project. */
-export interface ScaffoldOptions {
+/**
+ * Options forwarded to `create` when `ensureInit` scaffolds a new project. The
+ * `default*` fields preselect the pickers (a template's canonical look), while
+ * the rest are the caller's own `--theme` / `--radius` / `--mode` flags, which
+ * skip the matching question entirely.
+ */
+export interface ScaffoldOptions extends CustomizationOptions {
     /** Theme id to preselect in the picker (the template's canonical theme). */
     defaultTheme?: string;
     /** Color mode the scaffolded app opens in (the template's `defaultMode`). */
     defaultMode?: "light" | "dark";
-    /** Corner roundness the scaffolded app ships with (the template's `radius`). */
-    radius?: string;
+    /** Corner roundness to preselect in the picker (the template's `radius`). */
+    defaultRadius?: string;
 }
 export interface EnsureInitResult {
     /** Absolute path to the project root the caller should work against. */

package/dist/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAarD,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAyFrE;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,6EAA6E;IAC7E,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,eAAe,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACtE;AAED,+EAA+E;AAC/E,MAAM,WAAW,eAAe;IAC9B,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC/B,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,wEAAwE;IACxE,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,iBAAsB,EAC/B,eAAe,CAAC,EAAE,eAAe,GAChC,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CA6ElC"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAa3E,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAyFrE;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,6EAA6E;IAC7E,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,eAAe,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACtE;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAgB,SAAQ,oBAAoB;IAC3D,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC/B,6EAA6E;IAC7E,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,wEAAwE;IACxE,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,iBAAsB,EAC/B,eAAe,CAAC,EAAE,eAAe,GAChC,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAkFlC"}

package/dist/commands/install-helpers.d.ts

@@ -27,14 +27,12 @@ export declare function installNpmForPacks(args: {
     cwd: string;
     spinner: ReturnType<typeof p.spinner>;
 }): Promise<void>;
-export declare function printNextSteps(): void;
 /**
- * Ask whether to continue straight into onboarding (the env var walkthrough).
- * Skipped in --yes mode: onboarding is interactive, so non-interactive runs
- * keep the printed next steps instead. Cancelling counts as "no" because the
- * install itself already succeeded.
+ * The commands to run after an install, in the order you actually need them.
+ * Onboarding is listed rather than offered: filling in env vars is a sit-down
+ * job most people want to do later, not while they are still picking packs.
  */
-export declare function promptOnboarding(skipPrompts: boolean): Promise<boolean>;
+export declare function printNextSteps(): void;
 /**
  * List the files an install skipped because their targets already existed. The installer
  * collects these as `"<manifest target> (<reason>)"` strings, but the command only prints

package/dist/commands/install-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install-helpers.d.ts","sourceRoot":"","sources":["../../src/commands/install-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,gBAAgB,CAAC;AAMpC,OAAO,EAAqB,KAAK,YAAY,EAAwB,MAAM,sBAAsB,CAAC;AAIlG,OAAO,KAAK,EACV,oBAAoB,EACpB,oBAAoB,EACpB,YAAY,EAEZ,QAAQ,EACR,WAAW,EACX,UAAU,EACX,MAAM,mBAAmB,CAAC;AAI3B,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEpD,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEnD;AAED,0GAA0G;AAC1G,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,YAAY,EAAE,EACrB,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,EACzB,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC9B,OAAO,CAAC,oBAAoB,CAAC,CAI/B;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIhE;AAED,+FAA+F;AAC/F,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EAAE,EACjB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,EACnC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,GACrC,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,IAAI,CAQnG;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAUzF;AAED,2FAA2F;AAC3F,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAiB7G;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,KAAK,EAAE,UAAU,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC;CACvC,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBhB;AAED,wBAAgB,cAAc,IAAI,IAAI,CAKrC;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAU7E;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAOzD;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,MAAM,EAAE,WAAW,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;IACb,6EAA6E;IAC7E,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;CACvC,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAwDvB"}
+{"version":3,"file":"install-helpers.d.ts","sourceRoot":"","sources":["../../src/commands/install-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,gBAAgB,CAAC;AAMpC,OAAO,EAAqB,KAAK,YAAY,EAAwB,MAAM,sBAAsB,CAAC;AAIlG,OAAO,KAAK,EACV,oBAAoB,EACpB,oBAAoB,EACpB,YAAY,EAEZ,QAAQ,EACR,WAAW,EACX,UAAU,EACX,MAAM,mBAAmB,CAAC;AAI3B,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEpD,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEnD;AAED,0GAA0G;AAC1G,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,YAAY,EAAE,EACrB,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,EACzB,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC9B,OAAO,CAAC,oBAAoB,CAAC,CAI/B;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIhE;AAED,+FAA+F;AAC/F,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EAAE,EACjB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,EACnC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,GACrC,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,IAAI,CAQnG;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAUzF;AAED,2FAA2F;AAC3F,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAiB7G;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,KAAK,EAAE,UAAU,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC;CACvC,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBhB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAMrC;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAOzD;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,MAAM,EAAE,WAAW,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;IACb,6EAA6E;IAC7E,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;CACvC,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAwDvB"}

package/dist/commands/onboard.d.ts

@@ -1,9 +1,16 @@
 import { OnboardOptions } from '../types/types.js';
 /**
- * Walk the user through filling in .env values for the packs they installed,
- * then print pack tips and the start command. Docker and database migrations
- * are NOT part of onboarding: `create`, `compose`, and `template` all run them
- * as part of their own install flow.
+ * Fill in the values a person actually has to go and fetch, and nothing else.
+ *
+ * The old version walked every line of every `.env.example` and asked about all
+ * of them, which meant typing `http://localhost:4200` into a prompt that already
+ * had `http://localhost:4200` in it. Now each var carries a setup requirement
+ * (declared per pack, see `core/env-setup.ts`) and only two kinds get asked
+ * about: `required`, which is prompted, and `optional`, which is offered once per
+ * feature. Defaults are copied and generated secrets are rolled, both silently.
+ *
+ * Docker and database migrations are NOT part of onboarding: `create`,
+ * `compose`, and `template` all run them as part of their own install flow.
  */
 export declare function onboardCommand(options?: OnboardOptions): Promise<void>;
 //# sourceMappingURL=onboard.d.ts.map

package/dist/commands/onboard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"onboard.d.ts","sourceRoot":"","sources":["../../src/commands/onboard.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAc,cAAc,EAAe,MAAM,mBAAmB,CAAC;AAMjF;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0ChF"}
+{"version":3,"file":"onboard.d.ts","sourceRoot":"","sources":["../../src/commands/onboard.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAiB,cAAc,EAAe,MAAM,mBAAmB,CAAC;AAoBpF;;;;;;;;;;;;GAYG;AACH,wBAAsB,cAAc,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2DhF"}

package/dist/commands/template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../src/commands/template.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAIV,sBAAsB,EAGvB,MAAM,mBAAmB,CAAC;AAsB3B;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,IAAI,CAAC,CAgXzF"}
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../src/commands/template.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAIV,sBAAsB,EAGvB,MAAM,mBAAmB,CAAC;AAoB3B;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,IAAI,CAAC,CA0VzF"}

package/dist/config/bin.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { d as e, n as t, t as n, u as r } from "../cli-BQlmo5KI.js";
+import { d as e, n as t, t as n, u as r } from "../cli-CZanCLn9.js";
 import { z as i } from "zod";
 import * as a from "@sentry/node";
 //#region src/core/sentry.ts

package/dist/constants/radius.d.ts

@@ -0,0 +1,19 @@
+export interface RadiusPreset {
+    /** Stable id used in URLs and flags. */
+    id: string;
+    label: string;
+    /** The `--radius` CSS value this preset writes. */
+    value: string;
+    hint: string;
+}
+export declare const RADIUS_PRESETS: readonly RadiusPreset[];
+/** The `--radius` the base template ships with, and what the picker opens on. */
+export declare const DEFAULT_RADIUS = "0.625rem";
+/** The preset that writes `value`, when one matches exactly. */
+export declare function findRadiusPreset(value: string): RadiusPreset | undefined;
+/**
+ * Human label for a `--radius` value. Falls back to the raw value so a custom
+ * radius from a template manifest still reads sensibly in a picker or a log.
+ */
+export declare function radiusLabel(value: string): string;
+//# sourceMappingURL=radius.d.ts.map

package/dist/constants/radius.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"radius.d.ts","sourceRoot":"","sources":["../../src/constants/radius.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,YAAY;IAC3B,wCAAwC;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,cAAc,EAAE,SAAS,YAAY,EAOxC,CAAC;AAEX,iFAAiF;AACjF,eAAO,MAAM,cAAc,aAAa,CAAC;AAEzC,gEAAgE;AAChE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAGxE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD"}

package/dist/core/codemods.d.ts

@@ -21,14 +21,19 @@ export declare function patchFrontendUrl(frontendRoutes: PackFrontendRoute[], pa
  * The admin sidebar's group headers. Applied to the admin shell's nav.constants so
  * every admin-compatible layout renders the same section labels (Analytics for the
  * primary group, Platform for the secondary, More for the tertiary), regardless of
- * the layout's own frontend labels.
+ * the layout's own frontend labels. The starters ship these keys in the admin
+ * message catalog, so the headers translate with the rest of the shell.
  */
 export declare const ADMIN_NAV_GROUP_LABELS: NavGroupLabelsInput;
+/** A group header: literal text, or a key resolved through the message catalog. */
+export type NavGroupLabel = string | {
+    messageKey: string;
+};
 export type NavGroupLabelsInput = {
-    primary?: string;
-    secondary?: string;
-    tertiary?: string;
-    settings?: string;
+    primary?: NavGroupLabel;
+    secondary?: NavGroupLabel;
+    tertiary?: NavGroupLabel;
+    settings?: NavGroupLabel;
 };
 export interface SetNavGroupLabelsOptions {
     labels: NavGroupLabelsInput;

package/dist/core/codemods.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codemods.d.ts","sourceRoot":"","sources":["../../src/core/codemods.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,SAAS,EACT,oBAAoB,EACpB,eAAe,EACf,QAAQ,EACR,UAAU,EACV,UAAU,EACX,MAAM,mBAAmB,CAAC;AA2B3B,iGAAiG;AACjG,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAM1F;AASD,wBAAsB,QAAQ,CAAC,GAAG,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkCzG;AAwFD,wBAAsB,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAc5G;AAmCD,wBAAsB,YAAY,CAAC,OAAO,EAAE,gBAAgB,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBrH;AA8ED,wBAAsB,UAAU,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAY9G;AAkBD,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,mBAAmB,EAAE,EAClC,KAAK,EAAE,UAAU,EACjB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CA2Bf;AAoDD,wBAAsB,YAAY,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB/G;AAiED,wBAAsB,sBAAsB,CAC1C,cAAc,EAAE,oBAAoB,EAAE,EACtC,KAAK,EAAE,UAAU,EACjB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAef;AAoCD,wBAAsB,gBAAgB,CACpC,cAAc,EAAE,iBAAiB,EAAE,EACnC,KAAK,EAAE,UAAU,EACjB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAiBf;AA8FD;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,EAAE,mBAIpC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAmBF,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,KAAK,EAAE,UAAU,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4BxF;AAcD,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,KAAK,EAAE,UAAU,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2DxF;AAID,MAAM,WAAW,6BAA6B;IAC5C,qEAAqE;IACrE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE,UAAU,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,IAAI,CAAC,EAAE,QAAQ,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,6BAA6B,GAAG,OAAO,CAAC,IAAI,CAAC,CAalG;AAID,MAAM,WAAW,4BAA4B;IAC3C,gEAAgE;IAChE,gBAAgB,EAAE,OAAO,CAAC;IAC1B,KAAK,EAAE,UAAU,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,IAAI,CAAC,EAAE,QAAQ,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,4BAA4B,GAAG,OAAO,CAAC,IAAI,CAAC,CAahG;AA+PD,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,kBAAkB,EAAE,EAC3B,KAAK,EAAE,UAAU,EACjB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAef;AA4DD,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,gBAAgB,EAAE,EACxB,KAAK,EAAE,UAAU,EACjB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CA8Bf;AAgHD,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,sBAAsB,EAAE,EACpC,KAAK,EAAE,UAAU,EACjB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,sBAAsB,EAAE,EACpC,KAAK,EAAE,UAAU,EACjB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAEf;AA4ED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,KAAK,EAAE,UAAU,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,IAAI,CAAC,EAAE,QAAQ,CAAC;CACjB;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAEpF;AAED,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtF;AA0GD,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,eAAe,EAAE,CAAC;IACxB,KAAK,EAAE,UAAU,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,iBAAiB,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB7G;AAuED,UAAU,uBAAuB;IAC/B,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,KAAK,EAAE,UAAU,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBtF;AAgFD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhG"}
+{"version":3,"file":"codemods.d.ts","sourceRoot":"","sources":["../../src/core/codemods.ts"],"names":[],"mappings":"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"}

package/dist/core/customization.d.ts

@@ -0,0 +1,90 @@
+import { ColorMode } from '../constants/themes.js';
+import { CustomizationOptions, StackConfig } from '../types/types.js';
+/** Fully resolved look and feel, one entry per app shell. */
+export interface Customization {
+    theme: string;
+    adminTheme: string;
+    radius: string;
+    adminRadius: string;
+    mode: ColorMode;
+}
+/** What the pickers open on when no flag pins a value: usually a template's manifest. */
+export interface CustomizationDefaults {
+    theme?: string;
+    radius?: string;
+    mode?: ColorMode;
+}
+/**
+ * Terminal preview of a corner radius. Box-drawing corners only come in square
+ * and round, so the ramp is faked with brightness: the sharper the preset, the
+ * dimmer the rounded glyph reads next to it.
+ */
+export declare function radiusSwatch(value: string): string;
+/** Radius picker options, ordered sharp to round with the CSS value as the hint. */
+export declare function radiusChoices(): {
+    value: string;
+    label: string;
+    hint: string;
+}[];
+/** Theme picker options with the light/dark chip pair prefixed to each label. */
+export declare function themeChoices(): {
+    value: string;
+    label: string;
+}[];
+/**
+ * Narrow the raw flag values to ones the appliers accept. An unparseable flag is
+ * dropped rather than fatal, so a typo falls back to the prompt (or the default
+ * in `--yes` mode) instead of killing a scaffold halfway through.
+ */
+export declare function validCustomizationFlags(options: CustomizationOptions): CustomizationOptions;
+/** Warn once per flag the user passed that we could not parse. */
+export declare function warnInvalidCustomizationFlags(options: CustomizationOptions): void;
+/**
+ * True when nothing was overridden. Callers use this to leave an existing
+ * project's look untouched unless the user actually asked for a change.
+ */
+export declare function hasCustomizationFlags(options: CustomizationOptions): boolean;
+/** Resolve flags + defaults without prompting. Used for `--yes` and headless runs. */
+export declare function resolveCustomization(options: CustomizationOptions, defaults?: CustomizationDefaults): Customization;
+/** Section divider so the frontend and admin questions read as two groups, not one long list. */
+export declare function customizationSection(title: string, subtitle: string): void;
+export interface PromptCustomizationArgs {
+    options: CustomizationOptions;
+    defaults?: CustomizationDefaults;
+    /** Skip every question and take flags + defaults (`--yes`, headless). */
+    skipPrompts: boolean;
+    /** Ask the admin questions. False for projects with no admin app. */
+    admin: boolean;
+    /**
+     * Extra admin questions to run when the user declines "copy frontend
+     * settings" (compose uses this for the admin layout picker). Not called when
+     * settings are copied, or when prompts are skipped.
+     */
+    onAdminSection?: () => Promise<void>;
+}
+/**
+ * Walk the frontend section (theme, radius) and then the admin section, which
+ * opens with "copy the frontend settings?" defaulting to yes. Most people keep
+ * both apps in sync, so the common path is one keypress; saying no unfolds the
+ * admin's own theme and radius (plus whatever `onAdminSection` adds).
+ */
+export declare function promptCustomization(args: PromptCustomizationArgs): Promise<Customization>;
+/** Human label for a theme id, falling back to the id for anything unknown. */
+export declare function themeLabel(name: string): string;
+export interface ApplyCustomizationArgs {
+    projectRoot: string;
+    config: StackConfig;
+    /**
+     * What to write. Every field is optional and an omitted one is left alone, so
+     * `compose --admin-theme ocean` retints the dashboard without touching the
+     * frontend. Mode is frontend-only; the admin app has no color-mode init.
+     */
+    customization: Partial<Customization>;
+}
+/**
+ * Write the look and feel into a project on disk. Missing style files downgrade
+ * to a warning: a pack install that already succeeded should not fail because a
+ * template moved its `styles.css`.
+ */
+export declare function applyCustomization(args: ApplyCustomizationArgs): Promise<void>;
+//# sourceMappingURL=customization.d.ts.map

package/dist/core/customization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"customization.d.ts","sourceRoot":"","sources":["../../src/core/customization.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAQ3E,6DAA6D;AAC7D,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,yFAAyF;AACzF,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIlD;AAED,oFAAoF;AACpF,wBAAgB,aAAa,IAAI;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAMhF;AAED,iFAAiF;AACjF,wBAAgB,YAAY,IAAI;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAKjE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,oBAAoB,GAAG,oBAAoB,CAS3F;AAED,kEAAkE;AAClE,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAiBjF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAG5E;AAED,sFAAsF;AACtF,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,oBAAoB,EAC7B,QAAQ,GAAE,qBAA0B,GACnC,aAAa,CAaf;AAED,iGAAiG;AACjG,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAE1E;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,oBAAoB,CAAC;IAC9B,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC,yEAAyE;IACzE,WAAW,EAAE,OAAO,CAAC;IACrB,qEAAqE;IACrE,KAAK,EAAE,OAAO,CAAC;IACf;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,aAAa,CAAC,CA+E/F;AAED,+EAA+E;AAC/E,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,WAAW,CAAC;IACpB;;;;OAIG;IACH,aAAa,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;CACvC;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8BpF"}

package/dist/core/env-secrets.d.ts

@@ -0,0 +1,18 @@
+import { StackConfig } from '../types/types.js';
+export interface GeneratedSecret {
+    key: string;
+    /** Path of the `.env` it landed in, relative to the project root. */
+    env: string;
+}
+/**
+ * Roll a real random value for every `generated` var still sitting on its
+ * `.env.example` placeholder.
+ *
+ * Run at the end of an install, which is what makes a fresh project bootable
+ * without anyone touching `onboard`: signing and cookie secrets have no external
+ * source, so asking a human to invent one only ever produced a worse value than
+ * `randomBytes` would. Re-running is safe. A var somebody already set is left
+ * alone, because rotating it would sign out every existing session.
+ */
+export declare function applyGeneratedSecrets(projectRoot: string, config: StackConfig | null): Promise<GeneratedSecret[]>;
+//# sourceMappingURL=env-secrets.d.ts.map

package/dist/core/env-secrets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-secrets.d.ts","sourceRoot":"","sources":["../../src/core/env-secrets.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAKrD,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,qEAAqE;IACrE,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;;;GASG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,GAAG,IAAI,GACzB,OAAO,CAAC,eAAe,EAAE,CAAC,CAwC5B"}

package/dist/core/env-setup.d.ts

@@ -0,0 +1,63 @@
+import { EnvSection, EnvVarSetup, OnboardEnvVar, PackEnvExampleVar, PackEnvVar } from '../types/types.js';
+/**
+ * Everything about deciding which env vars are worth a person's attention.
+ *
+ * The rule is subtractive: a var is silent unless something says otherwise.
+ * Packs declare their own vars in their manifest; the base template's vars are
+ * declared in {@link BASE_ENV_SETUP} below, because no pack owns them. Whatever
+ * neither covers is a working default that gets copied and never mentioned.
+ */
+/** Placeholder value written to `.env.example` for a var, whichever form it takes. */
+export declare function envVarValue(entry: PackEnvExampleVar): string;
+/** Setup requirement for a var, or null when it is a plain default. */
+export declare function envVarSetup(entry: PackEnvExampleVar): PackEnvVar | null;
+/**
+ * Setup requirements for the vars the base template ships in its own
+ * `.env.example`. These predate any pack and no manifest claims them, so the
+ * knowledge has to live here.
+ *
+ * Only vars needing a human are listed. The omissions are the point: app URLs,
+ * Postgres and Valkey credentials, RustFS keys, and ports all work as shipped
+ * against local Docker, so onboarding stays quiet about them.
+ */
+export declare const BASE_ENV_SETUP: Record<string, {
+    section: EnvSection;
+    setup: EnvVarSetup;
+    group?: string;
+}>;
+/**
+ * Flatten a pack's manifest env entries into the per-var records `stack.json`
+ * carries. Plain-string vars produce nothing, which is what keeps the recorded
+ * list short enough to be worth reading.
+ */
+export declare function collectPackEnvVars(env: {
+    envExample: {
+        section: EnvSection;
+        vars: Record<string, PackEnvExampleVar>;
+    };
+}[] | undefined): OnboardEnvVar[];
+/**
+ * Merge recorded env vars, last writer wins per key. Reinstalling a pack, or
+ * swapping one starter for another that declares the same key, updates the
+ * entry in place rather than stacking a duplicate.
+ */
+export declare function mergeEnvVars(previous: OnboardEnvVar[], next: OnboardEnvVar[]): OnboardEnvVar[];
+/**
+ * Resolve one `.env.example` key to its setup requirement. Pack declarations win
+ * over the base table so a pack can tighten a var the template ships loose.
+ * Returns null for a plain default, which the caller copies without asking.
+ */
+export declare function resolveEnvVarSetup(key: string, recorded: OnboardEnvVar[]): OnboardEnvVar | null;
+/**
+ * A random value for a `generated` var. URL-safe base64 over 32 bytes: long
+ * enough for cookie and token signing, and free of the quoting problems that
+ * make people hand-edit a `.env` at midnight.
+ */
+export declare function generateSecret(): string;
+/**
+ * Whether a `generated` var still needs rolling. A value the user (or a
+ * previous run) already set is left alone: regenerating it would invalidate
+ * every session signed with the old one.
+ */
+export declare function needsGeneratedValue(current: string, exampleValue: string): boolean;
+//# sourceMappingURL=env-setup.d.ts.map

package/dist/core/env-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-setup.d.ts","sourceRoot":"","sources":["../../src/core/env-setup.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/G;;;;;;;GAOG;AAEH,sFAAsF;AACtF,wBAAgB,WAAW,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAE5D;AAED,uEAAuE;AACvE,wBAAgB,WAAW,CAAC,KAAK,EAAE,iBAAiB,GAAG,UAAU,GAAG,IAAI,CAEvE;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,WAAW,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAItG,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE;IAAE,UAAU,EAAE;QAAE,OAAO,EAAE,UAAU,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;KAAE,CAAA;CAAE,EAAE,GAAG,SAAS,GAClG,aAAa,EAAE,CAiBjB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,aAAa,EAAE,CAI9F;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,GAAG,aAAa,GAAG,IAAI,CAQ/F;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAIlF"}

package/dist/core/env-status.d.ts

@@ -1,4 +1,4 @@
-import { StackConfig } from '../types/types.js';
+import { EnvVarSetup, StackConfig } from '../types/types.js';
 /**
  * Read-only version of what `onboard` walks you through. `onboard` asks for each
  * value; this reports which ones are still unset so an agent can tell the user
@@ -12,6 +12,15 @@ export type EnvVarState =
 export interface EnvVarStatus {
     key: string;
     state: EnvVarState;
+    /**
+     * What this var needs from a human, or null when it is a plain default whose
+     * shipped value works as-is. Only `required` vars count toward
+     * {@link EnvStatus.missingCount}, so an agent reading this reports the four
+     * keys somebody has to go and fetch, not forty lines of localhost URLs.
+     */
+    setup: EnvVarSetup | null;
+    /** Optional feature these vars belong to, e.g. "Google login". */
+    group?: string;
 }
 export interface EnvSectionStatus {
     section: string;
@@ -31,10 +40,12 @@ export interface EnvFileStatus {
 }
 export interface EnvStatus {
     files: EnvFileStatus[];
-    /** Count of `missing` vars across relevant sections only. This is the number that matters. */
+    /**
+     * Count of unset `required` vars in relevant sections. This is the number that
+     * matters: defaults and generated secrets resolve themselves, and an optional
+     * var left blank is a feature nobody switched on, not a problem.
+     */
     missingCount: number;
 }
 export declare function collectEnvStatus(projectRoot: string, config: StackConfig | null): Promise<EnvStatus>;
-/** Value of `KEY` in an env file body, or "" when absent or blank. */
-export declare function readValue(envContent: string, key: string): string;
 //# sourceMappingURL=env-status.d.ts.map

package/dist/core/env-status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env-status.d.ts","sourceRoot":"","sources":["../../src/core/env-status.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAgC,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAKnF;;;;GAIG;AAEH,MAAM,MAAM,WAAW;AACrB,2CAA2C;AACzC,SAAS;AACX,uGAAuG;GACrG,SAAS,GACT,QAAQ,CAAC;AAEb,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,WAAW,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,QAAQ,EAAE,OAAO,CAAC;IAClB,+CAA+C;IAC/C,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,YAAY,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,8FAA8F;IAC9F,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,GAAG,OAAO,CAAC,SAAS,CAAC,CAkB1G;AAwCD,sEAAsE;AACtE,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAYjE"}
+{"version":3,"file":"env-status.d.ts","sourceRoot":"","sources":["../../src/core/env-status.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAgC,WAAW,EAAiB,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAM/G;;;;GAIG;AAEH,MAAM,MAAM,WAAW;AACrB,2CAA2C;AACzC,SAAS;AACX,uGAAuG;GACrG,SAAS,GACT,QAAQ,CAAC;AAEb,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,WAAW,CAAC;IACnB;;;;;OAKG;IACH,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IAC1B,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,QAAQ,EAAE,OAAO,CAAC;IAClB,+CAA+C;IAC/C,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,YAAY,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB;;;;OAIG;IACH,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,GAAG,OAAO,CAAC,SAAS,CAAC,CAuB1G"}

package/dist/core/installer.d.ts

@@ -26,8 +26,9 @@ export interface FileConflict {
 }
 /**
  * Find every file that `applyPackInstall` would silently skip because its target already exists.
- * Only `create` files can conflict: `skip-if-exists` is an intentional no-op and `merge` edits the
- * existing file in place. Deduplicated by resolved path so the same target is never reported twice.
+ * Only `create` files can conflict: `skip-if-exists` is an intentional no-op and `merge` /
+ * `merge-json` edit the existing file in place. Deduplicated by resolved path so the same target is
+ * never reported twice.
  */
 export declare function findInstallConflicts(options: {
     packs: PreparedPack[];
@@ -81,11 +82,12 @@ export declare function installPlan(options: {
     slotsByPack?: Map<string, PackSlot[]>;
 }): Promise<InstallPlanResult>;
 /**
- * Record a pack as installed in `stack.json`: append it to `installedPacks` and
- * merge the onboarding env sections its manifest declares into
- * `onboarding.envSections` (deduped). Those sections are what `onboard` later
- * prompts for, so onboarding is driven by the packs actually installed instead
- * of by whatever sections happen to be in `.env.example`.
+ * Record a pack as installed in `stack.json`: append it to `installedPacks`, and
+ * merge in both the env sections and the per-var setup requirements its manifest
+ * declares. Those two lists are what `onboard` reads, so onboarding is driven by
+ * the packs actually installed instead of by whatever happens to be sitting in
+ * `.env.example`. The per-var list is the one that matters: a var missing from it
+ * is a working default nobody gets asked about.
  */
 export declare function markPackInstalled(config: StackConfig, manifest: PackManifest | string, projectRoot: string): Promise<StackConfig>;
 export interface TemplateOverlayResult {
@@ -105,9 +107,11 @@ export interface TemplateOverlayResult {
  * pages and its logo SVGs) all install and win over pack equivalents, instead
  * of silently going missing because the manifest forgot to list them.
  *
- * `merge`-strategy manifest entries are the one exception: those are snippets
- * meant to be spliced into an existing file via a marker, not copied wholesale,
- * so they are skipped during the tree copy and applied through `installFile`.
+ * `merge` and `merge-json` manifest entries are the one exception: those are
+ * fragments meant to be folded into an existing file, not copied wholesale, so
+ * they are skipped during the tree copy and applied through `installFile`. That
+ * matters most for the message catalog, where copying the template's fragment
+ * over the target would drop every key the packs contributed.
  *
  * It also runs the template's frontend-route, nav, and post-login-redirect
  * codemods so the generated app knows about the new routes and sidebar entries.

package/dist/core/installer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../../src/core/installer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../../src/core/installer.ts"],"names":[],"mappings":"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"}

package/dist/core/merge-json.d.ts

@@ -0,0 +1,33 @@
+/**
+ * JSON-aware merging for files that several packs contribute to.
+ *
+ * The text `merge` strategy splices strings at a marker, which cannot work for a
+ * shared JSON document: two packs appending their own object would produce
+ * invalid JSON. Paraglide message catalogs are exactly that case, so `merge-json`
+ * parses both sides and merges them structurally instead.
+ */
+export declare class JsonMergeError extends Error {
+}
+type JsonObject = Record<string, unknown>;
+/**
+ * Merge `source` into `target`, source winning on conflicts.
+ *
+ * Key order is what makes the result reviewable: keys already in the target keep
+ * their position (so a re-install produces no diff noise) and genuinely new keys
+ * append in source order. `$schema` is pinned to the top the way editors and the
+ * inlang tooling expect to find it.
+ */
+export declare function deepMergeJson(target: JsonObject, source: JsonObject): JsonObject;
+/**
+ * Merge two JSON documents given as text and render the result. Formatting is
+ * fixed at two-space indent with a trailing newline so the file matches what the
+ * repo's formatter would produce and does not churn between installs.
+ */
+export declare function mergeJsonContent(options: {
+    target: string;
+    source: string;
+    targetLabel: string;
+    sourceLabel: string;
+}): string;
+export {};
+//# sourceMappingURL=merge-json.d.ts.map

package/dist/core/merge-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-json.d.ts","sourceRoot":"","sources":["../../src/core/merge-json.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,qBAAa,cAAe,SAAQ,KAAK;CAAG;AAE5C,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAmB1C;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,GAAG,UAAU,CAwBhF;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,MAAM,CAIT"}

package/dist/core/onboard-env.d.ts

@@ -15,6 +15,11 @@ export interface EnvSection {
  * text after the first `=` so URLs with query params survive.
  */
 export declare function parseEnvExample(content: string): EnvSection[];
+/**
+ * Value of `KEY` in an env file body, or "" when absent or blank. Commented-out
+ * lines do not count: a `# KEY=...` line is documentation, not a setting.
+ */
+export declare function readEnvValue(content: string, key: string): string;
 /**
  * Mask a current env value for display in a prompt so a real secret is never
  * echoed in full to the terminal (or scrollback / screen shares). Only the last

package/dist/core/onboard-env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"onboard-env.d.ts","sourceRoot":"","sources":["../../src/core/onboard-env.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,MAAM;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE,CAgC7D;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAShD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CA0B/E;AAED,iEAAiE;AACjE,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAInE;AAED,mFAAmF;AACnF,wBAAsB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAM/E;AAED,kFAAkF;AAClF,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI/F"}
+{"version":3,"file":"onboard-env.d.ts","sourceRoot":"","sources":["../../src/core/onboard-env.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,MAAM;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE,CAgC7D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAYjE;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAShD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CA0B/E;AAED,iEAAiE;AACjE,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAInE;AAED,mFAAmF;AACnF,wBAAsB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAM/E;AAED,kFAAkF;AAClF,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI/F"}

package/dist/deploy/dry-run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dry-run.d.ts","sourceRoot":"","sources":["../../src/deploy/dry-run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,cAAc,EAAE,MAAM,aAAa,CAAC;AAE/D;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,wBAAwB,CAAC;AAUzD,eAAO,MAAM,iBAAiB,EAAE,cAAc,EAwE7C,CAAC"}
+{"version":3,"file":"dry-run.d.ts","sourceRoot":"","sources":["../../src/deploy/dry-run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,cAAc,EAAE,MAAM,aAAa,CAAC;AAE/D;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,wBAAwB,CAAC;AAgBzD,eAAO,MAAM,iBAAiB,EAAE,cAAc,EAuH7C,CAAC"}

package/dist/deploy/env-plan.d.ts

@@ -16,6 +16,11 @@ export interface BuildEnvPlanInput {
     localEnv?: Partial<Record<DeployTarget, Record<string, string>>>;
     /** Keys each app declares in `.env.example`, used to decide what to forward and what is missing. */
     declaredKeys?: Partial<Record<DeployTarget, string[]>>;
+    /**
+     * Values from each app's `.env.example`, used as a starting point for keys
+     * nothing else can fill.
+     */
+    exampleEnv?: Partial<Record<DeployTarget, Record<string, string>>>;
     /**
      * Keys a provider wired onto the app itself, out of band (Fly's `mpg attach`
      * sets `DATABASE_URL` this way). Nothing local knows the value, but the app
@@ -28,6 +33,7 @@ export interface PreviewEnvPlanInput {
     plan: DeployPlan;
     localEnv?: Partial<Record<DeployTarget, Record<string, string>>>;
     declaredKeys?: Partial<Record<DeployTarget, string[]>>;
+    exampleEnv?: Partial<Record<DeployTarget, Record<string, string>>>;
 }
 /**
  * The env plan as it will look once the run has settled every origin and
@@ -53,7 +59,10 @@ interface ManagedEnvInput {
  * empty `VITE_API_BASE_URL` over a working one.
  */
 export declare function managedEnvFor(input: ManagedEnvInput): Record<string, string>;
-/** Every env var to apply to a target, managed values winning over forwarded ones. */
+/**
+ * Every env var to apply to a target. What the deploy wired beats what the
+ * developer's `.env` had, which in turn beats a placeholder from `.env.example`.
+ */
 export declare function mergedEnv(plan: TargetEnvPlan): Record<string, string>;
 /**
  * Parse a `.env` file into a flat map. Handles the `export KEY=value` prefix and