@orkestrel/scaffold 0.0.1 → 0.0.2

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

@@ -440,6 +440,23 @@ export declare interface CompilerOptions {
 /** The three fixed pipeline phases, in order. */
 export declare type CompileStage = 'draft' | 'gate' | 'pin';
 
+/**
+ * Measure a rendered fragment's column width, counting each literal tab as
+ * `JSON_TAB_WIDTH` columns (matching `.oxfmtrc.json`'s `tabWidth`) and every
+ * other character as one.
+ *
+ * @param text - The rendered fragment to measure.
+ * @returns The fragment's column width against `JSON_PRINT_WIDTH`.
+ *
+ * @example
+ * ```ts
+ * import { computeColumnWidth } from '@orkestrel/scaffold'
+ *
+ * computeColumnWidth('\t"a"') // 3 — one tab counted as JSON_TAB_WIDTH, plus two characters
+ * ```
+ */
+export declare function computeColumnWidth(text: string): number;
+
 /**
  * Compute a canonical FNV-1a digest of a text string.
  *
@@ -660,14 +677,25 @@ export declare function coreViteConfig(): string;
   * @param plan - The plan whose artifacts are the source of truth.
   * @param current - The target's current content, keyed by artifact-relative path.
   * @remarks
-  * A `template` / `computed` artifact whose rendered content the target does not
-  * match is `stale`; one the target lacks is `missing`; a target file the plan
-  * does not own is `foreign`. A `host`-origin artifact is audited by PRESENCE
-  * only — `missing` or `aligned`, never `stale` — UNLESS it has been hydrated
-  * with its real host bytes (`hydratePlan`'s `content`), in which case it is
-  * content-compared exactly like a `template` / `computed` artifact and CAN be
+  * Audit semantics are per-origin. A `host`-origin artifact is audited by
+  * PRESENCE only — `missing` or `aligned`, never `stale` — UNLESS it has been
+  * hydrated with its real host bytes (`hydratePlan`'s `content`), in which case
+  * it is content-compared exactly like a `computed` artifact and CAN be
   * `stale`. A degrade-path or directory-shaped host artifact (never hydrated)
-  * stays presence-only.
+  * stays presence-only. A `computed` artifact is content-aware canon —
+  * `missing` / `aligned` / `stale` — and gates the audit like any drifted
+  * finding. A `template`-origin artifact is BIRTH-ONLY and AUDIT-EXEMPT: it is
+  * always reported `aligned`, regardless of whether the target has it at all
+  * or what its bytes are. Starter files (source stubs, test stubs, starter
+  * guides, README) are written ONCE by `materialize` and are legitimately
+  * outgrown — real code replaces the stub, a hand-authored guide replaces the
+  * scaffold prose, an entity gets renamed. Content- or presence-comparing a
+  * mature package against its birth stub is a category error (the build and
+  * parity gates already police the package's substance) AND makes any
+  * unscoped repair a data-loss footgun — a stub overwrite would clobber real,
+  * hand-authored code. `template` findings therefore never contribute to
+  * `drifted` / `missing` / `clean`. A target file the plan does not own is
+  * `foreign`.
   * @returns The `Audit` of drift findings — pure, no I/O.
   *
   * @example
@@ -767,6 +795,31 @@ export declare function coreViteConfig(): string;
      readonly drift: Drift;
  }
 
+ /**
+  * Serialize a value to newline-terminated JSON that matches the fleet's own
+  * `oxfmt` output byte-for-byte — objects one key per line, arrays collapsed
+  * onto one line when they fit `JSON_PRINT_WIDTH`, one item per line
+  * otherwise.
+  *
+  * @param value - The value to serialize (config JSON — objects/arrays/primitives).
+  * @remarks
+  * `JSON.stringify(value, undefined, '\t')` always breaks arrays one item per
+  * line; `oxfmt` collapses short ones. Emitting through `formatJson` keeps
+  * computed config JSON format-stable by construction — `oxfmt --check` never
+  * has anything left to rewrite. The rendering itself is delegated to
+  * `renderValue` / `renderArray` / `renderObject` / `computeColumnWidth`, so
+  * `formatJson` is a thin orchestrator around them.
+  * @returns The rendered value, newline-terminated.
+  *
+  * @example
+  * ```ts
+  * import { formatJson } from '@orkestrel/scaffold'
+  *
+  * formatJson({ lib: ['ESNext', 'DOM'] }) // '{\n\t"lib": ["ESNext", "DOM"]\n}\n'
+  * ```
+  */
+ export declare function formatJson(value: unknown): string;
+
  /** The four `Freshness` values, frozen — the currency axis `Sync` reports on. */
  export declare const FRESHNESS: readonly ["current", "behind", "missing", "failed"];
 
@@ -1001,6 +1054,12 @@ export declare function coreViteConfig(): string;
   */
  export declare const isSyncReport: Guard<SyncReport>;
 
+ /** The fleet's `.oxfmtrc.json` `printWidth` — `formatJson`'s array-collapse threshold. */
+ export declare const JSON_PRINT_WIDTH = 100;
+
+ /** The fleet's `.oxfmtrc.json` `tabWidth` — the column width `formatJson` counts each tab as. */
+ export declare const JSON_TAB_WIDTH = 2;
+
  /**
   * Parse a `package.json` text into its declared `@orkestrel/*` dependencies.
   *
@@ -1501,6 +1560,62 @@ export declare function coreViteConfig(): string;
   */
  export declare function rangeToFreshness(range: string, latest: string): Freshness;
 
+ /**
+  * Render a JSON array through `formatJson`'s inline-or-broken rule — inline
+  * when the rendered width (via `computeColumnWidth`) fits `JSON_PRINT_WIDTH`, one
+  * item per line otherwise.
+  *
+  * @param entries - The array's 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 { renderArray } from '@orkestrel/scaffold'
+  *
+  * renderArray(['ESNext', 'DOM'], '', '', '') // '["ESNext", "DOM"]'
+  * ```
+  */
+ export declare function renderArray(entries: readonly unknown[], indent: string, prefix: string, suffix: string): string;
+
+ /**
+  * Render a JSON object through `formatJson`'s one-key-per-line rule.
+  *
+  * @param entry - The object to render.
+  * @param indent - The current indentation prefix.
+  * @returns The rendered object fragment (no trailing newline).
+  *
+  * @example
+  * ```ts
+  * import { renderObject } from '@orkestrel/scaffold'
+  *
+  * renderObject({ lib: ['ESNext'] }, '') // '{\n\t"lib": ["ESNext"]\n}'
+  * ```
+  */
+ export declare function renderObject(entry: Readonly<Record<string, unknown>>, indent: string): string;
+
+ /**
+  * Render one JSON value through `formatJson`'s dispatch — arrays via
+  * `renderArray`, objects via `renderObject`, everything else via
+  * `JSON.stringify`.
+  *
+  * @param entry - The value to render.
+  * @param indent - The current indentation prefix.
+  * @param prefix - The text already emitted on this line before `entry`.
+  * @param suffix - The text that will follow `entry` on this line.
+  * @returns The rendered fragment (no trailing newline).
+  *
+  * @example
+  * ```ts
+  * import { renderValue } from '@orkestrel/scaffold'
+  *
+  * renderValue('ESNext', '', '', '') // '"ESNext"'
+  * ```
+  */
+ export declare function renderValue(entry: unknown, indent: string, prefix: string, suffix: string): string;
+
  /**
   * The root `tsconfig.json` — one `@src/<surface>` path alias per declared
   * surface, in declared order.
@@ -1543,7 +1658,7 @@ export declare function coreViteConfig(): string;
  export declare function rootViteConfig(surfaces: readonly Surface[]): string;
 
  /** The devDependency range generated packages pin `@orkestrel/scaffold` at. */
- export declare const SCAFFOLD_RANGE = "^0.0.1";
+ export declare const SCAFFOLD_RANGE = "^0.0.2";
 
  /**
   * Carries a `ScaffoldErrorCode` + optional `context` (AGENTS §12).

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

@@ -440,6 +440,23 @@ export declare interface CompilerOptions {
 /** The three fixed pipeline phases, in order. */
 export declare type CompileStage = 'draft' | 'gate' | 'pin';
 
+/**
+ * Measure a rendered fragment's column width, counting each literal tab as
+ * `JSON_TAB_WIDTH` columns (matching `.oxfmtrc.json`'s `tabWidth`) and every
+ * other character as one.
+ *
+ * @param text - The rendered fragment to measure.
+ * @returns The fragment's column width against `JSON_PRINT_WIDTH`.
+ *
+ * @example
+ * ```ts
+ * import { computeColumnWidth } from '@orkestrel/scaffold'
+ *
+ * computeColumnWidth('\t"a"') // 3 — one tab counted as JSON_TAB_WIDTH, plus two characters
+ * ```
+ */
+export declare function computeColumnWidth(text: string): number;
+
 /**
  * Compute a canonical FNV-1a digest of a text string.
  *
@@ -660,14 +677,25 @@ export declare function coreViteConfig(): string;
   * @param plan - The plan whose artifacts are the source of truth.
   * @param current - The target's current content, keyed by artifact-relative path.
   * @remarks
-  * A `template` / `computed` artifact whose rendered content the target does not
-  * match is `stale`; one the target lacks is `missing`; a target file the plan
-  * does not own is `foreign`. A `host`-origin artifact is audited by PRESENCE
-  * only — `missing` or `aligned`, never `stale` — UNLESS it has been hydrated
-  * with its real host bytes (`hydratePlan`'s `content`), in which case it is
-  * content-compared exactly like a `template` / `computed` artifact and CAN be
+  * Audit semantics are per-origin. A `host`-origin artifact is audited by
+  * PRESENCE only — `missing` or `aligned`, never `stale` — UNLESS it has been
+  * hydrated with its real host bytes (`hydratePlan`'s `content`), in which case
+  * it is content-compared exactly like a `computed` artifact and CAN be
   * `stale`. A degrade-path or directory-shaped host artifact (never hydrated)
-  * stays presence-only.
+  * stays presence-only. A `computed` artifact is content-aware canon —
+  * `missing` / `aligned` / `stale` — and gates the audit like any drifted
+  * finding. A `template`-origin artifact is BIRTH-ONLY and AUDIT-EXEMPT: it is
+  * always reported `aligned`, regardless of whether the target has it at all
+  * or what its bytes are. Starter files (source stubs, test stubs, starter
+  * guides, README) are written ONCE by `materialize` and are legitimately
+  * outgrown — real code replaces the stub, a hand-authored guide replaces the
+  * scaffold prose, an entity gets renamed. Content- or presence-comparing a
+  * mature package against its birth stub is a category error (the build and
+  * parity gates already police the package's substance) AND makes any
+  * unscoped repair a data-loss footgun — a stub overwrite would clobber real,
+  * hand-authored code. `template` findings therefore never contribute to
+  * `drifted` / `missing` / `clean`. A target file the plan does not own is
+  * `foreign`.
   * @returns The `Audit` of drift findings — pure, no I/O.
   *
   * @example
@@ -767,6 +795,31 @@ export declare function coreViteConfig(): string;
      readonly drift: Drift;
  }
 
+ /**
+  * Serialize a value to newline-terminated JSON that matches the fleet's own
+  * `oxfmt` output byte-for-byte — objects one key per line, arrays collapsed
+  * onto one line when they fit `JSON_PRINT_WIDTH`, one item per line
+  * otherwise.
+  *
+  * @param value - The value to serialize (config JSON — objects/arrays/primitives).
+  * @remarks
+  * `JSON.stringify(value, undefined, '\t')` always breaks arrays one item per
+  * line; `oxfmt` collapses short ones. Emitting through `formatJson` keeps
+  * computed config JSON format-stable by construction — `oxfmt --check` never
+  * has anything left to rewrite. The rendering itself is delegated to
+  * `renderValue` / `renderArray` / `renderObject` / `computeColumnWidth`, so
+  * `formatJson` is a thin orchestrator around them.
+  * @returns The rendered value, newline-terminated.
+  *
+  * @example
+  * ```ts
+  * import { formatJson } from '@orkestrel/scaffold'
+  *
+  * formatJson({ lib: ['ESNext', 'DOM'] }) // '{\n\t"lib": ["ESNext", "DOM"]\n}\n'
+  * ```
+  */
+ export declare function formatJson(value: unknown): string;
+
  /** The four `Freshness` values, frozen — the currency axis `Sync` reports on. */
  export declare const FRESHNESS: readonly ["current", "behind", "missing", "failed"];
 
@@ -1001,6 +1054,12 @@ export declare function coreViteConfig(): string;
   */
  export declare const isSyncReport: Guard<SyncReport>;
 
+ /** The fleet's `.oxfmtrc.json` `printWidth` — `formatJson`'s array-collapse threshold. */
+ export declare const JSON_PRINT_WIDTH = 100;
+
+ /** The fleet's `.oxfmtrc.json` `tabWidth` — the column width `formatJson` counts each tab as. */
+ export declare const JSON_TAB_WIDTH = 2;
+
  /**
   * Parse a `package.json` text into its declared `@orkestrel/*` dependencies.
   *
@@ -1501,6 +1560,62 @@ export declare function coreViteConfig(): string;
   */
  export declare function rangeToFreshness(range: string, latest: string): Freshness;
 
+ /**
+  * Render a JSON array through `formatJson`'s inline-or-broken rule — inline
+  * when the rendered width (via `computeColumnWidth`) fits `JSON_PRINT_WIDTH`, one
+  * item per line otherwise.
+  *
+  * @param entries - The array's 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 { renderArray } from '@orkestrel/scaffold'
+  *
+  * renderArray(['ESNext', 'DOM'], '', '', '') // '["ESNext", "DOM"]'
+  * ```
+  */
+ export declare function renderArray(entries: readonly unknown[], indent: string, prefix: string, suffix: string): string;
+
+ /**
+  * Render a JSON object through `formatJson`'s one-key-per-line rule.
+  *
+  * @param entry - The object to render.
+  * @param indent - The current indentation prefix.
+  * @returns The rendered object fragment (no trailing newline).
+  *
+  * @example
+  * ```ts
+  * import { renderObject } from '@orkestrel/scaffold'
+  *
+  * renderObject({ lib: ['ESNext'] }, '') // '{\n\t"lib": ["ESNext"]\n}'
+  * ```
+  */
+ export declare function renderObject(entry: Readonly<Record<string, unknown>>, indent: string): string;
+
+ /**
+  * Render one JSON value through `formatJson`'s dispatch — arrays via
+  * `renderArray`, objects via `renderObject`, everything else via
+  * `JSON.stringify`.
+  *
+  * @param entry - The value to render.
+  * @param indent - The current indentation prefix.
+  * @param prefix - The text already emitted on this line before `entry`.
+  * @param suffix - The text that will follow `entry` on this line.
+  * @returns The rendered fragment (no trailing newline).
+  *
+  * @example
+  * ```ts
+  * import { renderValue } from '@orkestrel/scaffold'
+  *
+  * renderValue('ESNext', '', '', '') // '"ESNext"'
+  * ```
+  */
+ export declare function renderValue(entry: unknown, indent: string, prefix: string, suffix: string): string;
+
  /**
   * The root `tsconfig.json` — one `@src/<surface>` path alias per declared
   * surface, in declared order.
@@ -1543,7 +1658,7 @@ export declare function coreViteConfig(): string;
  export declare function rootViteConfig(surfaces: readonly Surface[]): string;
 
  /** The devDependency range generated packages pin `@orkestrel/scaffold` at. */
- export declare const SCAFFOLD_RANGE = "^0.0.1";
+ export declare const SCAFFOLD_RANGE = "^0.0.2";
 
  /**
   * Carries a `ScaffoldErrorCode` + optional `context` (AGENTS §12).

package/dist/src/core/index.js

@@ -128,9 +128,13 @@ var DEFAULT_VERSION = "0.0.1";
 /** The `engines.node` range the `blueprint` builder fills. */
 var DEFAULT_ENGINES = ">=22";
 /** The devDependency range generated packages pin `@orkestrel/scaffold` at. */
-var SCAFFOLD_RANGE = "^0.0.1";
+var SCAFFOLD_RANGE = "^0.0.2";
 /** The default id for a `Compiler` orchestrator. */
 var COMPILER_ID = "compiler";
+/** The fleet's `.oxfmtrc.json` `printWidth` — `formatJson`'s array-collapse threshold. */
+var JSON_PRINT_WIDTH = 100;
+/** The fleet's `.oxfmtrc.json` `tabWidth` — the column width `formatJson` counts each tab as. */
+var JSON_TAB_WIDTH = 2;
 //#endregion
 //#region src/core/errors.ts
 /**
@@ -984,14 +988,25 @@ function inferGroup(path) {
 * @param plan - The plan whose artifacts are the source of truth.
 * @param current - The target's current content, keyed by artifact-relative path.
 * @remarks
-* A `template` / `computed` artifact whose rendered content the target does not
-* match is `stale`; one the target lacks is `missing`; a target file the plan
-* does not own is `foreign`. A `host`-origin artifact is audited by PRESENCE
-* only — `missing` or `aligned`, never `stale` — UNLESS it has been hydrated
-* with its real host bytes (`hydratePlan`'s `content`), in which case it is
-* content-compared exactly like a `template` / `computed` artifact and CAN be
+* Audit semantics are per-origin. A `host`-origin artifact is audited by
+* PRESENCE only — `missing` or `aligned`, never `stale` — UNLESS it has been
+* hydrated with its real host bytes (`hydratePlan`'s `content`), in which case
+* it is content-compared exactly like a `computed` artifact and CAN be
 * `stale`. A degrade-path or directory-shaped host artifact (never hydrated)
-* stays presence-only.
+* stays presence-only. A `computed` artifact is content-aware canon —
+* `missing` / `aligned` / `stale` — and gates the audit like any drifted
+* finding. A `template`-origin artifact is BIRTH-ONLY and AUDIT-EXEMPT: it is
+* always reported `aligned`, regardless of whether the target has it at all
+* or what its bytes are. Starter files (source stubs, test stubs, starter
+* guides, README) are written ONCE by `materialize` and are legitimately
+* outgrown — real code replaces the stub, a hand-authored guide replaces the
+* scaffold prose, an entity gets renamed. Content- or presence-comparing a
+* mature package against its birth stub is a category error (the build and
+* parity gates already police the package's substance) AND makes any
+* unscoped repair a data-loss footgun — a stub overwrite would clobber real,
+* hand-authored code. `template` findings therefore never contribute to
+* `drifted` / `missing` / `clean`. A target file the plan does not own is
+* `foreign`.
 * @returns The `Audit` of drift findings — pure, no I/O.
 *
 * @example
@@ -1007,6 +1022,14 @@ function diffPlan(plan, current) {
 	for (const artifact of plan.artifacts) {
 		owned.add(artifact.path);
 		const seen = current[artifact.path];
+		if (artifact.origin === "template") {
+			findings.push({
+				path: artifact.path,
+				group: artifact.group,
+				drift: "aligned"
+			});
+			continue;
+		}
 		if (artifact.origin === "host") {
 			let drift;
 			if (seen === void 0) drift = "missing";
@@ -1379,6 +1402,125 @@ function stableStringify(value) {
 	return JSON.stringify(value);
 }
 /**
+* Measure a rendered fragment's column width, counting each literal tab as
+* `JSON_TAB_WIDTH` columns (matching `.oxfmtrc.json`'s `tabWidth`) and every
+* other character as one.
+*
+* @param text - The rendered fragment to measure.
+* @returns The fragment's column width against `JSON_PRINT_WIDTH`.
+*
+* @example
+* ```ts
+* import { computeColumnWidth } from '@orkestrel/scaffold'
+*
+* computeColumnWidth('\t"a"') // 3 — one tab counted as JSON_TAB_WIDTH, plus two characters
+* ```
+*/
+function computeColumnWidth(text) {
+	let width = 0;
+	for (const char of text) width += char === "	" ? 2 : 1;
+	return width;
+}
+/**
+* Render a JSON array through `formatJson`'s inline-or-broken rule — inline
+* when the rendered width (via `computeColumnWidth`) fits `JSON_PRINT_WIDTH`, one
+* item per line otherwise.
+*
+* @param entries - The array's 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 { renderArray } from '@orkestrel/scaffold'
+*
+* renderArray(['ESNext', 'DOM'], '', '', '') // '["ESNext", "DOM"]'
+* ```
+*/
+function renderArray(entries, indent, prefix, suffix) {
+	if (entries.length === 0) return "[]";
+	const items = entries.map((entry) => renderValue(entry, indent, "", ""));
+	const inline = `[${items.join(", ")}]`;
+	if (computeColumnWidth(`${prefix}${inline}${suffix}`) <= 100) return inline;
+	const childIndent = `${indent}\t`;
+	return `[\n${items.map((item) => `${childIndent}${item}`).join(",\n")}\n${indent}]`;
+}
+/**
+* Render a JSON object through `formatJson`'s one-key-per-line rule.
+*
+* @param entry - The object to render.
+* @param indent - The current indentation prefix.
+* @returns The rendered object fragment (no trailing newline).
+*
+* @example
+* ```ts
+* import { renderObject } from '@orkestrel/scaffold'
+*
+* renderObject({ lib: ['ESNext'] }, '') // '{\n\t"lib": ["ESNext"]\n}'
+* ```
+*/
+function renderObject(entry, indent) {
+	const keys = Object.keys(entry);
+	if (keys.length === 0) return "{}";
+	const childIndent = `${indent}\t`;
+	return `{\n${keys.map((key, index) => {
+		const prefix = `${childIndent}${JSON.stringify(key)}: `;
+		const suffix = index === keys.length - 1 ? "" : ",";
+		return `${prefix}${renderValue(entry[key], childIndent, prefix, suffix)}${suffix}`;
+	}).join("\n")}\n${indent}}`;
+}
+/**
+* Render one JSON value through `formatJson`'s dispatch — arrays via
+* `renderArray`, objects via `renderObject`, everything else via
+* `JSON.stringify`.
+*
+* @param entry - The value to render.
+* @param indent - The current indentation prefix.
+* @param prefix - The text already emitted on this line before `entry`.
+* @param suffix - The text that will follow `entry` on this line.
+* @returns The rendered fragment (no trailing newline).
+*
+* @example
+* ```ts
+* import { renderValue } from '@orkestrel/scaffold'
+*
+* renderValue('ESNext', '', '', '') // '"ESNext"'
+* ```
+*/
+function renderValue(entry, indent, prefix, suffix) {
+	if (Array.isArray(entry)) return renderArray(entry, indent, prefix, suffix);
+	if (isRecord(entry)) return renderObject(entry, indent);
+	return JSON.stringify(entry);
+}
+/**
+* Serialize a value to newline-terminated JSON that matches the fleet's own
+* `oxfmt` output byte-for-byte — objects one key per line, arrays collapsed
+* onto one line when they fit `JSON_PRINT_WIDTH`, one item per line
+* otherwise.
+*
+* @param value - The value to serialize (config JSON — objects/arrays/primitives).
+* @remarks
+* `JSON.stringify(value, undefined, '\t')` always breaks arrays one item per
+* line; `oxfmt` collapses short ones. Emitting through `formatJson` keeps
+* computed config JSON format-stable by construction — `oxfmt --check` never
+* has anything left to rewrite. The rendering itself is delegated to
+* `renderValue` / `renderArray` / `renderObject` / `computeColumnWidth`, so
+* `formatJson` is a thin orchestrator around them.
+* @returns The rendered value, newline-terminated.
+*
+* @example
+* ```ts
+* import { formatJson } from '@orkestrel/scaffold'
+*
+* formatJson({ lib: ['ESNext', 'DOM'] }) // '{\n\t"lib": ["ESNext", "DOM"]\n}\n'
+* ```
+*/
+function formatJson(value) {
+	return `${renderValue(value, "", "", "")}\n`;
+}
+/**
 * Return a fresh `Plan` with `trace` and `hash` filled.
 *
 * @param plan - The plan to pin.
@@ -2251,6 +2393,8 @@ function packageManifest(spec) {
 	for (const peer of [...spec.peers].sort((a, b) => compareCodeUnit(a.name, b.name))) peerDependencies[peer.name] = peer.range;
 	const peerDependenciesMeta = {};
 	for (const peer of spec.peers) if (peer.optional === true) peerDependenciesMeta[peer.name] = { optional: true };
+	const peerDevDependencies = {};
+	for (const peer of [...spec.peers].sort((a, b) => compareCodeUnit(a.name, b.name))) peerDevDependencies[peer.name] = peer.range;
 	const scripts = {
 		clean: "node -e \"try{require('node:fs').rmSync('dist',{recursive:true,force:true})}catch{}\"",
 		copy: "node -e \"const fs=require('node:fs'),p=require('node:path'),a=process.argv[1],b=process.argv[2];fs.mkdirSync(p.dirname(b),{recursive:true});fs.cpSync(a,b,{force:true});console.log('Copied: '+a+' to '+b)\"",
@@ -2294,7 +2438,10 @@ function packageManifest(spec) {
 		publishConfig: { access: "public" },
 		scripts,
 		dependencies,
-		devDependencies: devDependenciesFor(spec.extras),
+		devDependencies: Object.fromEntries(Object.entries({
+			...devDependenciesFor(spec.extras),
+			...peerDevDependencies
+		}).sort(([a], [b]) => compareCodeUnit(a, b))),
 		...Object.keys(peerDependencies).length > 0 ? { peerDependencies } : {},
 		...Object.keys(peerDependenciesMeta).length > 0 ? { peerDependenciesMeta } : {},
 		engines: { node: spec.engines }
@@ -2316,7 +2463,7 @@ function packageManifest(spec) {
 function rootTsconfig(surfaces) {
 	const paths = {};
 	for (const surface of surfaces) paths[`@src/${surface}`] = [`./src/${surface}/index.ts`];
-	return `${JSON.stringify({
+	return formatJson({
 		compilerOptions: {
 			target: "ESNext",
 			module: "ESNext",
@@ -2346,7 +2493,7 @@ function rootTsconfig(surfaces) {
 			"dist",
 			"tmp"
 		]
-	}, void 0, "	")}\n`;
+	});
 }
 /**
 * The rendered import / `resolve` header block every `rootViteConfig` shape
@@ -2701,7 +2848,7 @@ export default defineConfig({
 * ```
 */
 function coreTsconfig() {
-	return `${JSON.stringify({
+	return formatJson({
 		extends: "../../tsconfig.json",
 		compilerOptions: {
 			lib: ["ESNext"],
@@ -2712,7 +2859,7 @@ function coreTsconfig() {
 			outDir: "../../dist/src/core"
 		},
 		include: ["../../src/core/**/*.ts"]
-	}, void 0, "	")}\n`;
+	});
 }
 /**
 * `configs/src/vite.core.config.ts` — inlines its own `build.lib` /
@@ -2767,7 +2914,7 @@ export default defineConfig(
 * ```
 */
 function surfaceTsconfig(surface) {
-	const config = {
+	return formatJson({
 		extends: "../../tsconfig.json",
 		compilerOptions: {
 			lib: surface === "browser" ? [
@@ -2783,8 +2930,7 @@ function surfaceTsconfig(surface) {
 			outDir: "../../dist/src"
 		},
 		include: [`../../src/${surface}/**/*.ts`]
-	};
-	return `${JSON.stringify(config, void 0, "	")}\n`;
+	});
 }
 /**
 * `configs/src/vite.<browser|server>.config.ts` — a thin `dts`-only wrapper;
@@ -3631,6 +3777,6 @@ function createBlueprint(data) {
 	return candidate;
 }
 //#endregion
-export { CATEGORIES, COMPILER_ID, COMPILE_STAGES, Compiler, DEFAULT_ENGINES, DEFAULT_VERSION, DEPENDENCY_NAME_PATTERN, EXTRA_NAME_PATTERN, FRESHNESS, GROUPS, HOST_PATHS, NAME_PATTERN, ORIGINS, PlanManager, SCAFFOLD_RANGE, SURFACES, SURFACE_MATRIX, ScaffoldError, TEMPLATES, alignTable, applyOverrides, artifactShape, auditToReview, blueprint, blueprintShape, blueprintToMembers, blueprintToPlan, catalogNames, catalogToBlock, compareCodeUnit, computeHash, configArtifacts, coreTsconfig, coreViteConfig, createBlueprint, createCompiler, createPlanManager, delimiterCell, dependency, dependencyShape, devDependenciesFor, diffPlan, dualCondition, entryFields, exportsMap, fillArtifact, guideArtifacts, guideMemberTable, hostGroup, inferGroup, isArtifact, isBehind, isBlueprint, isDependency, isMember, isOverride, isPlan, isRecord, isScaffoldError, isSyncReport, manifestToDependencies, member, memberShape, override, overrideShape, packageManifest, padCell, paritySpecifiers, parseBlueprint, parsePlan, parseSyncReport, pascalCase, pinPlan, planShape, planToReview, planToSummary, rangeToFreshness, rootTsconfig, rootViteConfig, singleSurfaceViteConfig, sourceArtifacts, splitTableRow, stableStringify, surfaceTsconfig, surfaceVariant, surfaceViteConfig, syncReportShape, syncToReview, testArtifacts, validateBlueprint, validateDependencyArray, viteHeader };
+export { CATEGORIES, COMPILER_ID, COMPILE_STAGES, Compiler, DEFAULT_ENGINES, DEFAULT_VERSION, DEPENDENCY_NAME_PATTERN, EXTRA_NAME_PATTERN, FRESHNESS, GROUPS, HOST_PATHS, JSON_PRINT_WIDTH, JSON_TAB_WIDTH, NAME_PATTERN, ORIGINS, PlanManager, SCAFFOLD_RANGE, SURFACES, SURFACE_MATRIX, ScaffoldError, TEMPLATES, alignTable, applyOverrides, artifactShape, auditToReview, blueprint, blueprintShape, blueprintToMembers, blueprintToPlan, catalogNames, catalogToBlock, compareCodeUnit, computeColumnWidth, computeHash, configArtifacts, coreTsconfig, coreViteConfig, createBlueprint, createCompiler, createPlanManager, delimiterCell, dependency, dependencyShape, devDependenciesFor, diffPlan, dualCondition, entryFields, exportsMap, fillArtifact, formatJson, guideArtifacts, guideMemberTable, hostGroup, inferGroup, isArtifact, isBehind, isBlueprint, isDependency, isMember, isOverride, isPlan, isRecord, isScaffoldError, isSyncReport, manifestToDependencies, member, memberShape, override, overrideShape, packageManifest, padCell, paritySpecifiers, parseBlueprint, parsePlan, parseSyncReport, pascalCase, pinPlan, planShape, planToReview, planToSummary, rangeToFreshness, renderArray, renderObject, renderValue, rootTsconfig, rootViteConfig, singleSurfaceViteConfig, sourceArtifacts, splitTableRow, stableStringify, surfaceTsconfig, surfaceVariant, surfaceViteConfig, syncReportShape, syncToReview, testArtifacts, validateBlueprint, validateDependencyArray, viteHeader };
 
 //# sourceMappingURL=index.js.map