@orkestrel/scaffold 0.0.19 → 0.0.21

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

@@ -41,12 +41,18 @@ export declare function alignTable(header: readonly string[], rows: readonly (re
 /** Additional development dependencies required by a private Vue browser application. */
 export declare const APP_BROWSER_DEV_DEPENDENCIES: Readonly<Record<string, string>>;
 
+/** Baseline development dependency required by every private application environment. */
+export declare const APP_DEV_DEPENDENCIES: Readonly<Record<string, string>>;
+
 /**
  * The per-environment application matrix: thin config artifacts, Vitest project
  * label, and executable entry where the environment produces a runtime bundle.
  */
 export declare const APP_MATRIX: Readonly<Record<Environment, AppDefinition>>;
 
+/** Additional development dependencies required by a private server application. */
+export declare const APP_SERVER_DEV_DEPENDENCIES: Readonly<Record<string, string>>;
+
 /** The deterministic config, test-project, and runtime-entry settings for one application environment. */
 export declare interface AppDefinition {
     readonly configs: readonly string[];
@@ -58,9 +64,16 @@ export declare interface AppDefinition {
  * Draft the application source artifacts for every selected app environment.
  *
  * @param spec - The blueprint carrying the application environment set.
+ * @remarks
+ * Two conditional shapes layer over the per-environment set. The health contract —
+ * record, route constants, guard, and the one unknown-to-typed read — is declared by
+ * `app/server` while the server alone reads it and RELOCATES to `app/core` the moment
+ * the browser reads it too, because a contract two hosts share belongs to neither of
+ * them. The showcase entry pair, its seeder, and its factory appear only for a
+ * blueprint that declares the physical showcase wrapper alongside `app/browser`.
  * @returns Complete, runnable app/core, app/browser, and app/server artifacts.
  */
-export declare function applicationArtifacts(spec: Blueprint): readonly Artifact[];
+export declare function applicationArtifacts(spec: Pick<Blueprint, 'name' | 'app' | 'showcase'>): readonly Artifact[];
 
 /**
  * Build the root Vite/Vitest configuration for a workspace that includes
@@ -341,7 +354,11 @@ export declare function blueprintShape(): ObjectShape<{
  * @remarks
  * Published source environments receive the canonical entity/type/factory/constant
  * inventory. Application environments receive their exact public declaration kinds,
- * including parsers, guards, handlers, errors, and runners where present.
+ * including parsers, guards, handlers, errors, and runners where present. Two groups
+ * move rather than duplicate: the health contract is declared against `app/server`
+ * while the server alone reads it and against `app/core` once the browser reads it
+ * too, and the showcase seed, factory, and root-view identity appear only for a
+ * blueprint whose showcase accompanies `app/browser`.
  * @returns The declared `Member[]`, one set per environment.
  *
  * @example
@@ -647,6 +664,18 @@ export declare function computeHash(text: string): string;
  */
 export declare function configArtifacts(spec: Blueprint): readonly Artifact[];
 
+/**
+ * Build the standalone Node-only root-configuration Vitest project.
+ *
+ * @returns The emitted `config` project definition.
+ *
+ * @example
+ * ```ts
+ * configViteProject().includes("label: 'config'") // true
+ * ```
+ */
+export declare function configViteProject(): string;
+
 /** Constant-declaration token kept out of template literals consumed by parity scans. */
 export declare const CONST_KEYWORD = "const";
 
@@ -1202,6 +1231,32 @@ export declare function coreViteConfig(): string;
   */
  export declare function guideUsage(spec: Blueprint, pascal: string): string;
 
+ /**
+  * Determine whether an application blueprint spans the shared browser/server boundary.
+  *
+  * @param spec - The blueprint to inspect.
+  * @returns True only when app/core, app/browser, and app/server are all selected.
+  *
+  * @example
+  * ```ts
+  * hasApplicationBoundary(blueprint('application', { app: ['core', 'browser', 'server'] }))
+  * ```
+  */
+ export declare function hasApplicationBoundary(spec: Pick<Blueprint, 'app'>): boolean;
+
+ /**
+  * Determine whether an application blueprint emits its browser showcase.
+  *
+  * @param spec - The blueprint to inspect.
+  * @returns True only when showcase intent accompanies app/browser.
+  *
+  * @example
+  * ```ts
+  * hasApplicationShowcase(blueprint('application', { app: ['browser'], showcase: true }))
+  * ```
+  */
+ export declare function hasApplicationShowcase(spec: Pick<Blueprint, 'app' | 'showcase'>): boolean;
+
  /**
   * Whether a structurally valid blueprint selects at least one source or app environment.
   *
@@ -2196,6 +2251,28 @@ export declare function coreViteConfig(): string;
   */
  export declare function renderObject(entry: Readonly<Record<string, unknown>>, indent: string): string;
 
+ /**
+  * Render a single-quoted TypeScript string array literal through `oxfmt`'s
+  * inline-or-broken rule — inline when the rendered width fits
+  * `JSON_PRINT_WIDTH`, one item per line with a trailing comma on every line
+  * (including the last) otherwise, matching `.oxfmtrc.json`'s
+  * `trailingComma: "all"` for non-JSON files.
+  *
+  * @param entries - The array's string elements, in order.
+  * @param indent - The current indentation prefix.
+  * @param prefix - The text already emitted on this line before the array.
+  * @param suffix - The text that will follow the array on this line.
+  * @returns The rendered array fragment (no trailing newline).
+  *
+  * @example
+  * ```ts
+  * import { renderStringArray } from '@orkestrel/scaffold'
+  *
+  * renderStringArray(['app', 'guides', 'tests'], '', '', '') // "['app', 'guides', 'tests']"
+  * ```
+  */
+ export declare function renderStringArray(entries: readonly string[], indent: string, prefix: string, suffix: string): string;
+
  /**
   * Render one JSON value through `formatJson`'s dispatch — arrays via
   * `renderArray`, objects via `renderObject`, everything else via
@@ -2279,7 +2356,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.19";
+ export declare const SCAFFOLD_RANGE = "^0.0.21";
 
  /**
   * Carries a `ScaffoldErrorCode` + optional `context` (AGENTS §12).
@@ -2431,7 +2508,7 @@ export declare function coreViteConfig(): string;
   * factory per environment (AGENTS §5's per-environment centralized-file pattern), so
   * every environment gets the same uniform stub shape.
   *
-  * @param spec - The `Blueprint` to derive source stubs from.
+  * @param spec - The blueprint carrying the declared source environment set.
   * @param pascal - The package's PascalCase entity name.
   * @returns The `source` group's `Artifact[]`.
   *
@@ -2440,7 +2517,7 @@ export declare function coreViteConfig(): string;
   * sourceArtifacts(blueprint('router'), 'Router').length // 4
   * ```
   */
- export declare function sourceArtifacts(spec: Blueprint, pascal: string): readonly Artifact[];
+ export declare function sourceArtifacts(spec: Pick<Blueprint, 'src'>, pascal: string): readonly Artifact[];
 
  /**
   * Split one rendered GFM table row into its trimmed cell strings.
@@ -2841,7 +2918,7 @@ export declare function coreViteConfig(): string;
   * Render the one ordered proof and structural-axis project definition block.
   *
   * @param facts - Optional structural facts.
-  * @returns Policy, guides, then selected axis project definitions, separated by one blank line.
+  * @returns Policy, config, guides, then selected axis project definitions, separated by one blank line.
   *
   * @example
   * ```ts
@@ -2868,7 +2945,7 @@ export declare function coreViteConfig(): string;
   * @example
   * ```ts
   * viteProjectRegistrations(['core'], [], { integration: true })
-  * // [{ project: 'srcCore' }, { project: 'policy' }, { project: 'guides' }, { project: 'integration' }]
+  * // [{ project: 'srcCore' }, { project: 'policy' }, { project: 'config' }, { project: 'guides' }, { project: 'integration' }]
   * ```
   */
  export declare function viteProjectRegistrations(src: readonly Environment[], app?: readonly Environment[], facts?: ViteFacts): readonly ViteProjectRegistration[];

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

@@ -41,12 +41,18 @@ export declare function alignTable(header: readonly string[], rows: readonly (re
 /** Additional development dependencies required by a private Vue browser application. */
 export declare const APP_BROWSER_DEV_DEPENDENCIES: Readonly<Record<string, string>>;
 
+/** Baseline development dependency required by every private application environment. */
+export declare const APP_DEV_DEPENDENCIES: Readonly<Record<string, string>>;
+
 /**
  * The per-environment application matrix: thin config artifacts, Vitest project
  * label, and executable entry where the environment produces a runtime bundle.
  */
 export declare const APP_MATRIX: Readonly<Record<Environment, AppDefinition>>;
 
+/** Additional development dependencies required by a private server application. */
+export declare const APP_SERVER_DEV_DEPENDENCIES: Readonly<Record<string, string>>;
+
 /** The deterministic config, test-project, and runtime-entry settings for one application environment. */
 export declare interface AppDefinition {
     readonly configs: readonly string[];
@@ -58,9 +64,16 @@ export declare interface AppDefinition {
  * Draft the application source artifacts for every selected app environment.
  *
  * @param spec - The blueprint carrying the application environment set.
+ * @remarks
+ * Two conditional shapes layer over the per-environment set. The health contract —
+ * record, route constants, guard, and the one unknown-to-typed read — is declared by
+ * `app/server` while the server alone reads it and RELOCATES to `app/core` the moment
+ * the browser reads it too, because a contract two hosts share belongs to neither of
+ * them. The showcase entry pair, its seeder, and its factory appear only for a
+ * blueprint that declares the physical showcase wrapper alongside `app/browser`.
  * @returns Complete, runnable app/core, app/browser, and app/server artifacts.
  */
-export declare function applicationArtifacts(spec: Blueprint): readonly Artifact[];
+export declare function applicationArtifacts(spec: Pick<Blueprint, 'name' | 'app' | 'showcase'>): readonly Artifact[];
 
 /**
  * Build the root Vite/Vitest configuration for a workspace that includes
@@ -341,7 +354,11 @@ export declare function blueprintShape(): ObjectShape<{
  * @remarks
  * Published source environments receive the canonical entity/type/factory/constant
  * inventory. Application environments receive their exact public declaration kinds,
- * including parsers, guards, handlers, errors, and runners where present.
+ * including parsers, guards, handlers, errors, and runners where present. Two groups
+ * move rather than duplicate: the health contract is declared against `app/server`
+ * while the server alone reads it and against `app/core` once the browser reads it
+ * too, and the showcase seed, factory, and root-view identity appear only for a
+ * blueprint whose showcase accompanies `app/browser`.
  * @returns The declared `Member[]`, one set per environment.
  *
  * @example
@@ -647,6 +664,18 @@ export declare function computeHash(text: string): string;
  */
 export declare function configArtifacts(spec: Blueprint): readonly Artifact[];
 
+/**
+ * Build the standalone Node-only root-configuration Vitest project.
+ *
+ * @returns The emitted `config` project definition.
+ *
+ * @example
+ * ```ts
+ * configViteProject().includes("label: 'config'") // true
+ * ```
+ */
+export declare function configViteProject(): string;
+
 /** Constant-declaration token kept out of template literals consumed by parity scans. */
 export declare const CONST_KEYWORD = "const";
 
@@ -1202,6 +1231,32 @@ export declare function coreViteConfig(): string;
   */
  export declare function guideUsage(spec: Blueprint, pascal: string): string;
 
+ /**
+  * Determine whether an application blueprint spans the shared browser/server boundary.
+  *
+  * @param spec - The blueprint to inspect.
+  * @returns True only when app/core, app/browser, and app/server are all selected.
+  *
+  * @example
+  * ```ts
+  * hasApplicationBoundary(blueprint('application', { app: ['core', 'browser', 'server'] }))
+  * ```
+  */
+ export declare function hasApplicationBoundary(spec: Pick<Blueprint, 'app'>): boolean;
+
+ /**
+  * Determine whether an application blueprint emits its browser showcase.
+  *
+  * @param spec - The blueprint to inspect.
+  * @returns True only when showcase intent accompanies app/browser.
+  *
+  * @example
+  * ```ts
+  * hasApplicationShowcase(blueprint('application', { app: ['browser'], showcase: true }))
+  * ```
+  */
+ export declare function hasApplicationShowcase(spec: Pick<Blueprint, 'app' | 'showcase'>): boolean;
+
  /**
   * Whether a structurally valid blueprint selects at least one source or app environment.
   *
@@ -2196,6 +2251,28 @@ export declare function coreViteConfig(): string;
   */
  export declare function renderObject(entry: Readonly<Record<string, unknown>>, indent: string): string;
 
+ /**
+  * Render a single-quoted TypeScript string array literal through `oxfmt`'s
+  * inline-or-broken rule — inline when the rendered width fits
+  * `JSON_PRINT_WIDTH`, one item per line with a trailing comma on every line
+  * (including the last) otherwise, matching `.oxfmtrc.json`'s
+  * `trailingComma: "all"` for non-JSON files.
+  *
+  * @param entries - The array's string elements, in order.
+  * @param indent - The current indentation prefix.
+  * @param prefix - The text already emitted on this line before the array.
+  * @param suffix - The text that will follow the array on this line.
+  * @returns The rendered array fragment (no trailing newline).
+  *
+  * @example
+  * ```ts
+  * import { renderStringArray } from '@orkestrel/scaffold'
+  *
+  * renderStringArray(['app', 'guides', 'tests'], '', '', '') // "['app', 'guides', 'tests']"
+  * ```
+  */
+ export declare function renderStringArray(entries: readonly string[], indent: string, prefix: string, suffix: string): string;
+
  /**
   * Render one JSON value through `formatJson`'s dispatch — arrays via
   * `renderArray`, objects via `renderObject`, everything else via
@@ -2279,7 +2356,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.19";
+ export declare const SCAFFOLD_RANGE = "^0.0.21";
 
  /**
   * Carries a `ScaffoldErrorCode` + optional `context` (AGENTS §12).
@@ -2431,7 +2508,7 @@ export declare function coreViteConfig(): string;
   * factory per environment (AGENTS §5's per-environment centralized-file pattern), so
   * every environment gets the same uniform stub shape.
   *
-  * @param spec - The `Blueprint` to derive source stubs from.
+  * @param spec - The blueprint carrying the declared source environment set.
   * @param pascal - The package's PascalCase entity name.
   * @returns The `source` group's `Artifact[]`.
   *
@@ -2440,7 +2517,7 @@ export declare function coreViteConfig(): string;
   * sourceArtifacts(blueprint('router'), 'Router').length // 4
   * ```
   */
- export declare function sourceArtifacts(spec: Blueprint, pascal: string): readonly Artifact[];
+ export declare function sourceArtifacts(spec: Pick<Blueprint, 'src'>, pascal: string): readonly Artifact[];
 
  /**
   * Split one rendered GFM table row into its trimmed cell strings.
@@ -2841,7 +2918,7 @@ export declare function coreViteConfig(): string;
   * Render the one ordered proof and structural-axis project definition block.
   *
   * @param facts - Optional structural facts.
-  * @returns Policy, guides, then selected axis project definitions, separated by one blank line.
+  * @returns Policy, config, guides, then selected axis project definitions, separated by one blank line.
   *
   * @example
   * ```ts
@@ -2868,7 +2945,7 @@ export declare function coreViteConfig(): string;
   * @example
   * ```ts
   * viteProjectRegistrations(['core'], [], { integration: true })
-  * // [{ project: 'srcCore' }, { project: 'policy' }, { project: 'guides' }, { project: 'integration' }]
+  * // [{ project: 'srcCore' }, { project: 'policy' }, { project: 'config' }, { project: 'guides' }, { project: 'integration' }]
   * ```
   */
  export declare function viteProjectRegistrations(src: readonly Environment[], app?: readonly Environment[], facts?: ViteFacts): readonly ViteProjectRegistration[];