@orkestrel/scaffold 0.0.17 → 0.0.19

package/dist/src/core/index.d.cts

@@ -259,6 +259,8 @@ export declare interface Blueprint {
     readonly service: boolean;
     /** Structural: `true` only for a repo that carries the physical, exact-case `tests/setupGlobal.ts` module — integration and `srcBrowser` projects consume that shared global setup only under their own additional structural conditions. */
     readonly global: boolean;
+    /** Structural: `true` only for a repo that carries the physical, exact-case `configs/app/vite.showcase.config.ts` regular file; valid only with `app/browser`. */
+    readonly showcase: boolean;
 }
 
 /**
@@ -270,7 +272,7 @@ export declare interface Blueprint {
  * `version` / `engines` default `DEFAULT_VERSION` / `DEFAULT_ENGINES`,
  * `src` defaults `['core']`, and `app` / `keywords` / `dependencies` /
  * `peers` / `extras` / `overrides` default `[]`, and `bin` / `integration` /
- * `service` / `global` default `false`. `description` is OMITTED entirely
+ * `service` / `global` / `showcase` default `false`. `description` is OMITTED entirely
  * when absent, so the result round-trips the exact-record `Blueprint` guard.
  * @returns A complete `Blueprint`.
  *
@@ -329,6 +331,7 @@ export declare function blueprintShape(): ObjectShape<{
     integration: BooleanShape;
     service: BooleanShape;
     global: BooleanShape;
+    showcase: BooleanShape;
 }, false>;
 
 /**
@@ -2047,6 +2050,7 @@ export declare function coreViteConfig(): string;
          integration: BooleanShape;
          service: BooleanShape;
          global: BooleanShape;
+         showcase: BooleanShape;
      }, false>;
      groups: ArrayShape<LiteralShape<readonly Group[]>>;
      artifacts: ArrayShape<UnionShape<readonly [ ObjectShape<{
@@ -2275,7 +2279,7 @@ export declare function coreViteConfig(): string;
  export declare function rootViteConfig(src: readonly Environment[], facts?: ViteFacts): string;
 
  /** The devDependency range generated packages pin `@orkestrel/scaffold` at. */
- export declare const SCAFFOLD_RANGE = "^0.0.17";
+ export declare const SCAFFOLD_RANGE = "^0.0.19";
 
  /**
   * Carries a `ScaffoldErrorCode` + optional `context` (AGENTS §12).
@@ -2365,6 +2369,9 @@ export declare function coreViteConfig(): string;
  /** Immutable official actions/setup-node v6.4.0 commit used by generated CI. */
  export declare const SETUP_NODE_ACTION_SHA = "48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e";
 
+ /** The consumer-owned Vite wrapper whose physical presence enables the optional app showcase. */
+ export declare const SHOWCASE_CONFIG_PATH = "configs/app/vite.showcase.config.ts";
+
  /**
   * The single non-`core` environment's factory IS the base (Shape 3 of
   * `rootViteConfig`) — the environment's own `viteHeader` (Playwright only when
@@ -2750,13 +2757,15 @@ export declare function coreViteConfig(): string;
   * @remarks
   * `bin`, `integration`, and `service` select their matching projects.
   * `global` records the physical `tests/setupGlobal.ts` module and wires it
-  * into every selected project that consumes that shared setup.
+  * into every selected project that consumes that shared setup. `showcase`
+  * records the physical app showcase wrapper and selects its browser machinery.
   */
  export declare interface ViteFacts {
      readonly bin?: boolean;
      readonly integration?: boolean;
      readonly service?: boolean;
      readonly global?: boolean;
+     readonly showcase?: boolean;
  }
 
  /**
@@ -2800,6 +2809,7 @@ export declare function coreViteConfig(): string;
      readonly browser: boolean;
      readonly vue: boolean;
      readonly output: boolean;
+     readonly showcase: boolean;
  }
 
  /**
@@ -2816,15 +2826,16 @@ export declare function coreViteConfig(): string;
   * @param src - The declared published `Environment[]`.
   * @param app - The declared application `Environment[]`, defaulting to none.
   * @param bin - Whether the workspace also builds its own executable.
+  * @param showcase - Whether the workspace carries its optional app showcase.
   * @returns The machinery set the generated header renders.
   *
   * @example
   * ```ts
-  * viteMachinery(['core']) // { browser: false, vue: false, output: true }
-  * viteMachinery([], ['core']) // { browser: false, vue: false, output: false }
+  * viteMachinery(['core']) // { browser: false, vue: false, output: true, showcase: false }
+  * viteMachinery([], ['core']) // { browser: false, vue: false, output: false, showcase: false }
   * ```
   */
- export declare function viteMachinery(src: readonly Environment[], app?: readonly Environment[], bin?: boolean): ViteMachinery;
+ export declare function viteMachinery(src: readonly Environment[], app?: readonly Environment[], bin?: boolean, showcase?: boolean): ViteMachinery;
 
  /**
   * Render the one ordered proof and structural-axis project definition block.

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

@@ -259,6 +259,8 @@ export declare interface Blueprint {
     readonly service: boolean;
     /** Structural: `true` only for a repo that carries the physical, exact-case `tests/setupGlobal.ts` module — integration and `srcBrowser` projects consume that shared global setup only under their own additional structural conditions. */
     readonly global: boolean;
+    /** Structural: `true` only for a repo that carries the physical, exact-case `configs/app/vite.showcase.config.ts` regular file; valid only with `app/browser`. */
+    readonly showcase: boolean;
 }
 
 /**
@@ -270,7 +272,7 @@ export declare interface Blueprint {
  * `version` / `engines` default `DEFAULT_VERSION` / `DEFAULT_ENGINES`,
  * `src` defaults `['core']`, and `app` / `keywords` / `dependencies` /
  * `peers` / `extras` / `overrides` default `[]`, and `bin` / `integration` /
- * `service` / `global` default `false`. `description` is OMITTED entirely
+ * `service` / `global` / `showcase` default `false`. `description` is OMITTED entirely
  * when absent, so the result round-trips the exact-record `Blueprint` guard.
  * @returns A complete `Blueprint`.
  *
@@ -329,6 +331,7 @@ export declare function blueprintShape(): ObjectShape<{
     integration: BooleanShape;
     service: BooleanShape;
     global: BooleanShape;
+    showcase: BooleanShape;
 }, false>;
 
 /**
@@ -2047,6 +2050,7 @@ export declare function coreViteConfig(): string;
          integration: BooleanShape;
          service: BooleanShape;
          global: BooleanShape;
+         showcase: BooleanShape;
      }, false>;
      groups: ArrayShape<LiteralShape<readonly Group[]>>;
      artifacts: ArrayShape<UnionShape<readonly [ ObjectShape<{
@@ -2275,7 +2279,7 @@ export declare function coreViteConfig(): string;
  export declare function rootViteConfig(src: readonly Environment[], facts?: ViteFacts): string;
 
  /** The devDependency range generated packages pin `@orkestrel/scaffold` at. */
- export declare const SCAFFOLD_RANGE = "^0.0.17";
+ export declare const SCAFFOLD_RANGE = "^0.0.19";
 
  /**
   * Carries a `ScaffoldErrorCode` + optional `context` (AGENTS §12).
@@ -2365,6 +2369,9 @@ export declare function coreViteConfig(): string;
  /** Immutable official actions/setup-node v6.4.0 commit used by generated CI. */
  export declare const SETUP_NODE_ACTION_SHA = "48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e";
 
+ /** The consumer-owned Vite wrapper whose physical presence enables the optional app showcase. */
+ export declare const SHOWCASE_CONFIG_PATH = "configs/app/vite.showcase.config.ts";
+
  /**
   * The single non-`core` environment's factory IS the base (Shape 3 of
   * `rootViteConfig`) — the environment's own `viteHeader` (Playwright only when
@@ -2750,13 +2757,15 @@ export declare function coreViteConfig(): string;
   * @remarks
   * `bin`, `integration`, and `service` select their matching projects.
   * `global` records the physical `tests/setupGlobal.ts` module and wires it
-  * into every selected project that consumes that shared setup.
+  * into every selected project that consumes that shared setup. `showcase`
+  * records the physical app showcase wrapper and selects its browser machinery.
   */
  export declare interface ViteFacts {
      readonly bin?: boolean;
      readonly integration?: boolean;
      readonly service?: boolean;
      readonly global?: boolean;
+     readonly showcase?: boolean;
  }
 
  /**
@@ -2800,6 +2809,7 @@ export declare function coreViteConfig(): string;
      readonly browser: boolean;
      readonly vue: boolean;
      readonly output: boolean;
+     readonly showcase: boolean;
  }
 
  /**
@@ -2816,15 +2826,16 @@ export declare function coreViteConfig(): string;
   * @param src - The declared published `Environment[]`.
   * @param app - The declared application `Environment[]`, defaulting to none.
   * @param bin - Whether the workspace also builds its own executable.
+  * @param showcase - Whether the workspace carries its optional app showcase.
   * @returns The machinery set the generated header renders.
   *
   * @example
   * ```ts
-  * viteMachinery(['core']) // { browser: false, vue: false, output: true }
-  * viteMachinery([], ['core']) // { browser: false, vue: false, output: false }
+  * viteMachinery(['core']) // { browser: false, vue: false, output: true, showcase: false }
+  * viteMachinery([], ['core']) // { browser: false, vue: false, output: false, showcase: false }
   * ```
   */
- export declare function viteMachinery(src: readonly Environment[], app?: readonly Environment[], bin?: boolean): ViteMachinery;
+ export declare function viteMachinery(src: readonly Environment[], app?: readonly Environment[], bin?: boolean, showcase?: boolean): ViteMachinery;
 
  /**
   * Render the one ordered proof and structural-axis project definition block.