@orkestrel/scaffold 0.0.3 → 0.0.5

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

@@ -659,6 +659,7 @@ export declare function coreTsconfig(): string;
  * `configs/src/vite.core.config.ts` — inlines its own `build.lib` /
  * `rolldownOptions` (core's `srcCore` root export carries no build.lib).
  *
+ * @param browser - Whether a declared browser environment enables the shared CSS pipeline.
  * @returns The core environment `vite.config.ts` file content, newline-terminated.
  *
  * @example
@@ -666,7 +667,7 @@ export declare function coreTsconfig(): string;
  * coreViteConfig().includes('srcCore(') // true
  * ```
  */
-export declare function coreViteConfig(): string;
+export declare function coreViteConfig(browser?: boolean): string;
 
 /**
  * Validate and return a `Blueprint` from plain data.
@@ -2131,7 +2132,7 @@ export declare function coreViteConfig(): string;
  export declare function rootViteConfig(src: readonly Environment[], engine?: boolean): string;
 
  /** The devDependency range generated packages pin `@orkestrel/scaffold` at. */
- export declare const SCAFFOLD_RANGE = "^0.0.2";
+ export declare const SCAFFOLD_RANGE = "^0.0.5";
 
  /**
   * Carries a `ScaffoldErrorCode` + optional `context` (AGENTS §12).
@@ -2570,22 +2571,66 @@ export declare function coreViteConfig(): string;
 
  /**
   * The rendered import / `resolve` header block every `rootViteConfig` shape
-  * prefixes — the official Playwright provider import appears only when
-  * `needsPlaywright`, per the three grounded `rootViteConfig`
-  * shapes: unconditional for a multi-environment blueprint, conditional on the
-  * sole environment being `'browser'` for a single non-`core` environment, absent for
-  * `core`-only.
-  *
-  * @param needsPlaywright - Whether this shape ships a browser test project (and so needs Playwright).
-  * @param needsVue - Whether the generated root imports the Vue Vite plugin.
+  * prefixes — the environment boundary and every guarantee it enforces ship
+  * unconditionally; `machinery` selects only the host-specific pipelines layered
+  * over them, per the three grounded `rootViteConfig` shapes: browser machinery
+  * unconditional for a multi-environment blueprint carrying `browser`,
+  * conditional on the sole environment being `'browser'` for a single non-`core`
+  * environment, absent for `core`-only.
+  *
+  * @param machinery - The host-specific machinery this shape carries, from `viteMachinery`.
   * @returns The rendered header block, newline-terminated.
   *
   * @example
   * ```ts
-  * viteHeader(false).includes('@vitest/browser-playwright') // false
-  * viteHeader(true).includes('@vitest/browser-playwright') // true
+  * viteHeader(viteMachinery(['core'])).includes('@vitest/browser-playwright') // false
+  * viteHeader(viteMachinery(['core', 'browser'])).includes('@vitest/browser-playwright') // true
   * ```
   */
- export declare function viteHeader(needsPlaywright: boolean, needsVue?: boolean): string;
+ export declare function viteHeader(machinery: ViteMachinery): string;
+
+ /**
+  * Which host-specific machinery a generated root `vite.config.ts` carries.
+  *
+  * @remarks
+  * The boundary GUARANTEES never vary by blueprint: every generated
+  * configuration emits the environment-boundary plugin, its module-graph AST
+  * audit, and stylesheet rejection, because those enforce owner-independent
+  * laws. Only the host-specific pipelines below are selected by the declared
+  * environments. `browser` covers everything a declared browser environment
+  * needs — the CSS pipeline and the Playwright-backed browser test project;
+  * `vue` adds the single-file-component, HTML, and development-server
+  * machinery an application browser environment needs; `output` adds build
+  * output containment, which an application of `core` alone never builds.
+  */
+ export declare interface ViteMachinery {
+     readonly browser: boolean;
+     readonly vue: boolean;
+     readonly output: boolean;
+ }
+
+ /**
+  * Derive which host-specific machinery a workspace's generated root
+  * `vite.config.ts` carries from its declared environments.
+  *
+  * @remarks
+  * This is the SOLE derivation of that set; `rootViteConfig`,
+  * `singleSrcViteConfig`, `applicationViteConfig`, and `configArtifacts` all
+  * read it rather than recomputing an axis of their own. Nothing here selects
+  * a boundary GUARANTEE — the environment-boundary plugin, its module-graph
+  * AST audit, and stylesheet rejection ship in every shape.
+  *
+  * @param src - The declared published `Environment[]`.
+  * @param app - The declared application `Environment[]`, defaulting to none.
+  * @param engine - Whether the workspace also builds its own executable.
+  * @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 }
+  * ```
+  */
+ export declare function viteMachinery(src: readonly Environment[], app?: readonly Environment[], engine?: boolean): ViteMachinery;
 
  export { }

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

@@ -659,6 +659,7 @@ export declare function coreTsconfig(): string;
  * `configs/src/vite.core.config.ts` — inlines its own `build.lib` /
  * `rolldownOptions` (core's `srcCore` root export carries no build.lib).
  *
+ * @param browser - Whether a declared browser environment enables the shared CSS pipeline.
  * @returns The core environment `vite.config.ts` file content, newline-terminated.
  *
  * @example
@@ -666,7 +667,7 @@ export declare function coreTsconfig(): string;
  * coreViteConfig().includes('srcCore(') // true
  * ```
  */
-export declare function coreViteConfig(): string;
+export declare function coreViteConfig(browser?: boolean): string;
 
 /**
  * Validate and return a `Blueprint` from plain data.
@@ -2131,7 +2132,7 @@ export declare function coreViteConfig(): string;
  export declare function rootViteConfig(src: readonly Environment[], engine?: boolean): string;
 
  /** The devDependency range generated packages pin `@orkestrel/scaffold` at. */
- export declare const SCAFFOLD_RANGE = "^0.0.2";
+ export declare const SCAFFOLD_RANGE = "^0.0.5";
 
  /**
   * Carries a `ScaffoldErrorCode` + optional `context` (AGENTS §12).
@@ -2570,22 +2571,66 @@ export declare function coreViteConfig(): string;
 
  /**
   * The rendered import / `resolve` header block every `rootViteConfig` shape
-  * prefixes — the official Playwright provider import appears only when
-  * `needsPlaywright`, per the three grounded `rootViteConfig`
-  * shapes: unconditional for a multi-environment blueprint, conditional on the
-  * sole environment being `'browser'` for a single non-`core` environment, absent for
-  * `core`-only.
-  *
-  * @param needsPlaywright - Whether this shape ships a browser test project (and so needs Playwright).
-  * @param needsVue - Whether the generated root imports the Vue Vite plugin.
+  * prefixes — the environment boundary and every guarantee it enforces ship
+  * unconditionally; `machinery` selects only the host-specific pipelines layered
+  * over them, per the three grounded `rootViteConfig` shapes: browser machinery
+  * unconditional for a multi-environment blueprint carrying `browser`,
+  * conditional on the sole environment being `'browser'` for a single non-`core`
+  * environment, absent for `core`-only.
+  *
+  * @param machinery - The host-specific machinery this shape carries, from `viteMachinery`.
   * @returns The rendered header block, newline-terminated.
   *
   * @example
   * ```ts
-  * viteHeader(false).includes('@vitest/browser-playwright') // false
-  * viteHeader(true).includes('@vitest/browser-playwright') // true
+  * viteHeader(viteMachinery(['core'])).includes('@vitest/browser-playwright') // false
+  * viteHeader(viteMachinery(['core', 'browser'])).includes('@vitest/browser-playwright') // true
   * ```
   */
- export declare function viteHeader(needsPlaywright: boolean, needsVue?: boolean): string;
+ export declare function viteHeader(machinery: ViteMachinery): string;
+
+ /**
+  * Which host-specific machinery a generated root `vite.config.ts` carries.
+  *
+  * @remarks
+  * The boundary GUARANTEES never vary by blueprint: every generated
+  * configuration emits the environment-boundary plugin, its module-graph AST
+  * audit, and stylesheet rejection, because those enforce owner-independent
+  * laws. Only the host-specific pipelines below are selected by the declared
+  * environments. `browser` covers everything a declared browser environment
+  * needs — the CSS pipeline and the Playwright-backed browser test project;
+  * `vue` adds the single-file-component, HTML, and development-server
+  * machinery an application browser environment needs; `output` adds build
+  * output containment, which an application of `core` alone never builds.
+  */
+ export declare interface ViteMachinery {
+     readonly browser: boolean;
+     readonly vue: boolean;
+     readonly output: boolean;
+ }
+
+ /**
+  * Derive which host-specific machinery a workspace's generated root
+  * `vite.config.ts` carries from its declared environments.
+  *
+  * @remarks
+  * This is the SOLE derivation of that set; `rootViteConfig`,
+  * `singleSrcViteConfig`, `applicationViteConfig`, and `configArtifacts` all
+  * read it rather than recomputing an axis of their own. Nothing here selects
+  * a boundary GUARANTEE — the environment-boundary plugin, its module-graph
+  * AST audit, and stylesheet rejection ship in every shape.
+  *
+  * @param src - The declared published `Environment[]`.
+  * @param app - The declared application `Environment[]`, defaulting to none.
+  * @param engine - Whether the workspace also builds its own executable.
+  * @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 }
+  * ```
+  */
+ export declare function viteMachinery(src: readonly Environment[], app?: readonly Environment[], engine?: boolean): ViteMachinery;
 
  export { }