@orkestrel/scaffold 0.0.5 → 0.0.7

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

@@ -144,7 +144,7 @@ export declare interface ArtifactBase {
  *
  * @returns A fresh `ContractShape` describing one planned file.
  */
-export declare function artifactShape(): UnionShape<[ ObjectShape<{
+export declare function artifactShape(): UnionShape<readonly [ ObjectShape<{
     path: StringShape;
     group: LiteralShape<readonly Group[]>;
     origin: LiteralShape<readonly ["host"]>;
@@ -305,7 +305,7 @@ export declare function blueprintToMembers(spec: Blueprint): readonly Member[];
 /**
  * The full pure compilation: draft a blueprint's artifacts — the manifest and
  * exports combination rules over the per-environment `SRC_MATRIX` rows, plus
- * `HOST_PATHS` and `overrides` — then pin.
+ * the `selectHostPaths` selection of `HOST_PATHS` and `overrides` — then pin.
  *
  * @param blueprint - The `Blueprint` to compile.
  * @param groups - An optional `Group[]` selection (default: all groups).
@@ -644,7 +644,7 @@ export declare function contentToHex(content: string): string;
 export declare const CONTROL_CHARACTER_PATTERN: RegExp;
 
 /**
- * `configs/src/tsconfig.core.json` — unchanged core shape.
+ * `configs/src/tsconfig.core.json` — host-neutral core with web interop declarations.
  *
  * @returns The core environment `tsconfig` file content, newline-terminated.
  *
@@ -1042,12 +1042,15 @@ export declare function coreViteConfig(browser?: boolean): string;
 
  /**
   * Draft the `guides` group's artifacts — the package's own filled guide stub,
-  * the guides index, and any vendored dependency guide mirrors.
+  * the guides index, and vendored dependency guide mirrors whose paths are
+  * neither the package's own guide nor already carried by the selected host
+  * set.
   *
   * @param spec - The `Blueprint` to derive guide artifacts from.
   * @param pascal - The package's PascalCase entity name.
   * @param members - The blueprint's derived `Member[]`.
-  * @returns The `guides` group's `Artifact[]`.
+  * @returns The `guides` group's `Artifact[]`, with one contributor per guide
+  * path.
   *
   * @example
   * ```ts
@@ -1184,9 +1187,12 @@ export declare function coreViteConfig(browser?: boolean): string;
   * The root docs (`AGENTS.md` / `CLAUDE.md`), `LICENSE`, `.agents`, `.claude`, `.codex`,
   * the four SessionStart hook scripts (`scripts/deps.sh` / `scripts/cursor.sh` /
   * `scripts/codex.sh` / `scripts/ollama.sh`), the repository coding-law policy module,
-  * the line's seven byte-identical root dotfiles, and the two guides-grouped mirrors every repo carries: the line-wide
-  * dev-tooling guide (`guides/src/guide.md`) and the
-  * scaffold engine's own self-guide (`guides/src/scaffold.md`).
+  * the line's seven byte-identical root dotfiles, and the two guides-grouped
+  * mirror candidates: the line-wide dev-tooling guide
+  * (`guides/src/guide.md`) and the scaffold engine's own self-guide
+  * (`guides/src/scaffold.md`). `stageHost` vendors both; each plan carries the
+  * subset selected by `selectHostPaths`, omitting the target blueprint's own
+  * guide.
   */
  export declare const HOST_PATHS: readonly string[];
 
@@ -1393,6 +1399,24 @@ export declare function coreViteConfig(browser?: boolean): string;
   */
  export declare function manifestToDependencies(manifestText: string): readonly Dependency[];
 
+ /**
+  * Project a `package.json` text to its own string `name`.
+  *
+  * @param manifest - The `package.json` file content.
+  * @returns The own string `name`, or `undefined` when the manifest exceeds its
+  * byte ceiling, is malformed, has a non-object root, or has no own string
+  * `name`.
+  *
+  * @example
+  * ```ts
+  * import { manifestToName } from '@orkestrel/scaffold'
+  *
+  * manifestToName('{"name":"@orkestrel/router"}') // '@orkestrel/router'
+  * manifestToName('{}') // undefined
+  * ```
+  */
+ export declare function manifestToName(manifest: string): string | undefined;
+
  /** Maximum byte size accepted for one scaffold artifact. */
  export declare const MAX_ARTIFACT_BYTES = 5242880;
 
@@ -1493,12 +1517,13 @@ export declare function coreViteConfig(browser?: boolean): string;
  export declare const ORKESTREL_RANGE_PATTERN: RegExp;
 
  /**
-  * One caller template override.
+  * One artifact override.
   *
   * @remarks
   * `content` REPLACES the rendered artifact at `path`, never partially merges.
-  * An override whose `path` matches no planned artifact, or targets a
-  * `host`-origin path, is a BLOCKING question — never a silent add.
+  * An override whose `path` matches no planned artifact, targets a
+  * `host`-origin path, or targets `package.json` is a BLOCKING question.
+  * Accepted overrides surface as retained non-blocking advisories.
   */
  export declare interface Override {
      readonly path: string;
@@ -1931,7 +1956,7 @@ export declare function coreViteConfig(browser?: boolean): string;
          engine: BooleanShape;
      }, false>;
      groups: ArrayShape<LiteralShape<readonly Group[]>>;
-     artifacts: ArrayShape<UnionShape<[ ObjectShape<{
+     artifacts: ArrayShape<UnionShape<readonly [ ObjectShape<{
          path: StringShape;
          group: LiteralShape<readonly Group[]>;
          origin: LiteralShape<readonly ["host"]>;
@@ -2085,6 +2110,22 @@ export declare function coreViteConfig(browser?: boolean): string;
   */
  export declare function renderValue(entry: unknown, indent: string, prefix: string, suffix: string): string;
 
+ /**
+  * Render the root Vitest project registration, preserving browser ownership
+  * supplied by the caller.
+  *
+  * @param registrations - Ordered project factory identifiers with optional browser labels.
+  * @param browser - Whether the generated configuration carries browser machinery.
+  * @returns The rendered root `test` property.
+  *
+  * @example
+  * ```ts
+  * renderViteTest([{ project: 'srcCore' }], false)
+  * // '\ttest: {\n\t\tprojects: [srcCore],\n\t},'
+  * ```
+  */
+ export declare function renderViteTest(registrations: readonly ViteProjectRegistration[], browser: boolean): string;
+
  /**
   * The root `tsconfig.json` — one `@src/<environment>` path alias per declared
   * environment, in declared order.
@@ -2132,7 +2173,7 @@ export declare function coreViteConfig(browser?: boolean): 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.5";
+ export declare const SCAFFOLD_RANGE = "^0.0.7";
 
  /**
   * Carries a `ScaffoldErrorCode` + optional `context` (AGENTS §12).
@@ -2175,6 +2216,20 @@ export declare function coreViteConfig(browser?: boolean): string;
      readonly digest: string;
  }
 
+ /**
+  * Select host paths without the guide owned by the target blueprint.
+  *
+  * @param paths - Host artifact paths in deterministic input order.
+  * @param name - The target blueprint's unscoped package name.
+  * @returns Every host path except `guides/src/<name>.md`, in input order.
+  *
+  * @example
+  * ```ts
+  * selectHostPaths(['guides/src/guide.md', 'LICENSE'], 'guide') // ['LICENSE']
+  * ```
+  */
+ export declare function selectHostPaths(paths: readonly string[], name: string): readonly string[];
+
  /**
   * Serialize text as a single-quoted TypeScript string literal.
   *
@@ -2633,4 +2688,10 @@ export declare function coreViteConfig(browser?: boolean): string;
   */
  export declare function viteMachinery(src: readonly Environment[], app?: readonly Environment[], engine?: boolean): ViteMachinery;
 
+ /** One generated Vitest project factory and its optional browser-project label. */
+ export declare interface ViteProjectRegistration {
+     readonly project: string;
+     readonly browser?: string;
+ }
+
  export { }

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

@@ -144,7 +144,7 @@ export declare interface ArtifactBase {
  *
  * @returns A fresh `ContractShape` describing one planned file.
  */
-export declare function artifactShape(): UnionShape<[ ObjectShape<{
+export declare function artifactShape(): UnionShape<readonly [ ObjectShape<{
     path: StringShape;
     group: LiteralShape<readonly Group[]>;
     origin: LiteralShape<readonly ["host"]>;
@@ -305,7 +305,7 @@ export declare function blueprintToMembers(spec: Blueprint): readonly Member[];
 /**
  * The full pure compilation: draft a blueprint's artifacts — the manifest and
  * exports combination rules over the per-environment `SRC_MATRIX` rows, plus
- * `HOST_PATHS` and `overrides` — then pin.
+ * the `selectHostPaths` selection of `HOST_PATHS` and `overrides` — then pin.
  *
  * @param blueprint - The `Blueprint` to compile.
  * @param groups - An optional `Group[]` selection (default: all groups).
@@ -644,7 +644,7 @@ export declare function contentToHex(content: string): string;
 export declare const CONTROL_CHARACTER_PATTERN: RegExp;
 
 /**
- * `configs/src/tsconfig.core.json` — unchanged core shape.
+ * `configs/src/tsconfig.core.json` — host-neutral core with web interop declarations.
  *
  * @returns The core environment `tsconfig` file content, newline-terminated.
  *
@@ -1042,12 +1042,15 @@ export declare function coreViteConfig(browser?: boolean): string;
 
  /**
   * Draft the `guides` group's artifacts — the package's own filled guide stub,
-  * the guides index, and any vendored dependency guide mirrors.
+  * the guides index, and vendored dependency guide mirrors whose paths are
+  * neither the package's own guide nor already carried by the selected host
+  * set.
   *
   * @param spec - The `Blueprint` to derive guide artifacts from.
   * @param pascal - The package's PascalCase entity name.
   * @param members - The blueprint's derived `Member[]`.
-  * @returns The `guides` group's `Artifact[]`.
+  * @returns The `guides` group's `Artifact[]`, with one contributor per guide
+  * path.
   *
   * @example
   * ```ts
@@ -1184,9 +1187,12 @@ export declare function coreViteConfig(browser?: boolean): string;
   * The root docs (`AGENTS.md` / `CLAUDE.md`), `LICENSE`, `.agents`, `.claude`, `.codex`,
   * the four SessionStart hook scripts (`scripts/deps.sh` / `scripts/cursor.sh` /
   * `scripts/codex.sh` / `scripts/ollama.sh`), the repository coding-law policy module,
-  * the line's seven byte-identical root dotfiles, and the two guides-grouped mirrors every repo carries: the line-wide
-  * dev-tooling guide (`guides/src/guide.md`) and the
-  * scaffold engine's own self-guide (`guides/src/scaffold.md`).
+  * the line's seven byte-identical root dotfiles, and the two guides-grouped
+  * mirror candidates: the line-wide dev-tooling guide
+  * (`guides/src/guide.md`) and the scaffold engine's own self-guide
+  * (`guides/src/scaffold.md`). `stageHost` vendors both; each plan carries the
+  * subset selected by `selectHostPaths`, omitting the target blueprint's own
+  * guide.
   */
  export declare const HOST_PATHS: readonly string[];
 
@@ -1393,6 +1399,24 @@ export declare function coreViteConfig(browser?: boolean): string;
   */
  export declare function manifestToDependencies(manifestText: string): readonly Dependency[];
 
+ /**
+  * Project a `package.json` text to its own string `name`.
+  *
+  * @param manifest - The `package.json` file content.
+  * @returns The own string `name`, or `undefined` when the manifest exceeds its
+  * byte ceiling, is malformed, has a non-object root, or has no own string
+  * `name`.
+  *
+  * @example
+  * ```ts
+  * import { manifestToName } from '@orkestrel/scaffold'
+  *
+  * manifestToName('{"name":"@orkestrel/router"}') // '@orkestrel/router'
+  * manifestToName('{}') // undefined
+  * ```
+  */
+ export declare function manifestToName(manifest: string): string | undefined;
+
  /** Maximum byte size accepted for one scaffold artifact. */
  export declare const MAX_ARTIFACT_BYTES = 5242880;
 
@@ -1493,12 +1517,13 @@ export declare function coreViteConfig(browser?: boolean): string;
  export declare const ORKESTREL_RANGE_PATTERN: RegExp;
 
  /**
-  * One caller template override.
+  * One artifact override.
   *
   * @remarks
   * `content` REPLACES the rendered artifact at `path`, never partially merges.
-  * An override whose `path` matches no planned artifact, or targets a
-  * `host`-origin path, is a BLOCKING question — never a silent add.
+  * An override whose `path` matches no planned artifact, targets a
+  * `host`-origin path, or targets `package.json` is a BLOCKING question.
+  * Accepted overrides surface as retained non-blocking advisories.
   */
  export declare interface Override {
      readonly path: string;
@@ -1931,7 +1956,7 @@ export declare function coreViteConfig(browser?: boolean): string;
          engine: BooleanShape;
      }, false>;
      groups: ArrayShape<LiteralShape<readonly Group[]>>;
-     artifacts: ArrayShape<UnionShape<[ ObjectShape<{
+     artifacts: ArrayShape<UnionShape<readonly [ ObjectShape<{
          path: StringShape;
          group: LiteralShape<readonly Group[]>;
          origin: LiteralShape<readonly ["host"]>;
@@ -2085,6 +2110,22 @@ export declare function coreViteConfig(browser?: boolean): string;
   */
  export declare function renderValue(entry: unknown, indent: string, prefix: string, suffix: string): string;
 
+ /**
+  * Render the root Vitest project registration, preserving browser ownership
+  * supplied by the caller.
+  *
+  * @param registrations - Ordered project factory identifiers with optional browser labels.
+  * @param browser - Whether the generated configuration carries browser machinery.
+  * @returns The rendered root `test` property.
+  *
+  * @example
+  * ```ts
+  * renderViteTest([{ project: 'srcCore' }], false)
+  * // '\ttest: {\n\t\tprojects: [srcCore],\n\t},'
+  * ```
+  */
+ export declare function renderViteTest(registrations: readonly ViteProjectRegistration[], browser: boolean): string;
+
  /**
   * The root `tsconfig.json` — one `@src/<environment>` path alias per declared
   * environment, in declared order.
@@ -2132,7 +2173,7 @@ export declare function coreViteConfig(browser?: boolean): 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.5";
+ export declare const SCAFFOLD_RANGE = "^0.0.7";
 
  /**
   * Carries a `ScaffoldErrorCode` + optional `context` (AGENTS §12).
@@ -2175,6 +2216,20 @@ export declare function coreViteConfig(browser?: boolean): string;
      readonly digest: string;
  }
 
+ /**
+  * Select host paths without the guide owned by the target blueprint.
+  *
+  * @param paths - Host artifact paths in deterministic input order.
+  * @param name - The target blueprint's unscoped package name.
+  * @returns Every host path except `guides/src/<name>.md`, in input order.
+  *
+  * @example
+  * ```ts
+  * selectHostPaths(['guides/src/guide.md', 'LICENSE'], 'guide') // ['LICENSE']
+  * ```
+  */
+ export declare function selectHostPaths(paths: readonly string[], name: string): readonly string[];
+
  /**
   * Serialize text as a single-quoted TypeScript string literal.
   *
@@ -2633,4 +2688,10 @@ export declare function coreViteConfig(browser?: boolean): string;
   */
  export declare function viteMachinery(src: readonly Environment[], app?: readonly Environment[], engine?: boolean): ViteMachinery;
 
+ /** One generated Vitest project factory and its optional browser-project label. */
+ export declare interface ViteProjectRegistration {
+     readonly project: string;
+     readonly browser?: string;
+ }
+
  export { }