@orkestrel/scaffold 0.0.22 → 0.0.23

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

@@ -2432,7 +2432,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.22";
+ export declare const SCAFFOLD_RANGE = "^0.0.23";
 
  /**
   * Carries a `ScaffoldErrorCode` + optional `context` (AGENTS §12).
@@ -2665,15 +2665,26 @@ export declare function coreViteConfig(): string;
   * `build.lib` / externals live in the root `srcBrowser` / `srcServer` export
   * instead (per the live exemplars).
   *
+  * @remarks
+  * `bundleTypes` rolls the face up through API Extractor, which leaves every
+  * `src/core` re-export behind a relative `../core/index.ts` specifier — a path no
+  * published tarball carries. A workspace that also declares `core` therefore emits
+  * a `beforeWriteFile` rewrite turning that specifier into `@orkestrel/<name>`, the
+  * package's own published root export. The rewrite is narrowed to the FINAL face
+  * roll-up: applying it to the intermediate declarations makes API Extractor analyse
+  * `src/core`'s own source and abort. A workspace with no `core` emits no rewrite,
+  * because it has no cross-environment specifier to externalize.
+  *
   * @param environment - The non-`core` environment to derive the `vite.config.ts` for.
+  * @param spec - The blueprint slice naming the package and its declared source environments.
   * @returns The environment `vite.config.ts` file content, newline-terminated.
   *
   * @example
   * ```ts
-  * srcViteConfig('browser').includes('srcBrowser') // true
+  * srcViteConfig('browser', { name: 'router', src: ['core', 'browser'] }).includes('srcBrowser')
   * ```
   */
- export declare function srcViteConfig(environment: 'browser' | 'server'): string;
+ export declare function srcViteConfig(environment: 'browser' | 'server', spec: Pick<Blueprint, 'name' | 'src'>): string;
 
  /**
   * Serialize a value to a canonical, key-order-INDEPENDENT JSON-like string.

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

@@ -2432,7 +2432,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.22";
+ export declare const SCAFFOLD_RANGE = "^0.0.23";
 
  /**
   * Carries a `ScaffoldErrorCode` + optional `context` (AGENTS §12).
@@ -2665,15 +2665,26 @@ export declare function coreViteConfig(): string;
   * `build.lib` / externals live in the root `srcBrowser` / `srcServer` export
   * instead (per the live exemplars).
   *
+  * @remarks
+  * `bundleTypes` rolls the face up through API Extractor, which leaves every
+  * `src/core` re-export behind a relative `../core/index.ts` specifier — a path no
+  * published tarball carries. A workspace that also declares `core` therefore emits
+  * a `beforeWriteFile` rewrite turning that specifier into `@orkestrel/<name>`, the
+  * package's own published root export. The rewrite is narrowed to the FINAL face
+  * roll-up: applying it to the intermediate declarations makes API Extractor analyse
+  * `src/core`'s own source and abort. A workspace with no `core` emits no rewrite,
+  * because it has no cross-environment specifier to externalize.
+  *
   * @param environment - The non-`core` environment to derive the `vite.config.ts` for.
+  * @param spec - The blueprint slice naming the package and its declared source environments.
   * @returns The environment `vite.config.ts` file content, newline-terminated.
   *
   * @example
   * ```ts
-  * srcViteConfig('browser').includes('srcBrowser') // true
+  * srcViteConfig('browser', { name: 'router', src: ['core', 'browser'] }).includes('srcBrowser')
   * ```
   */
- export declare function srcViteConfig(environment: 'browser' | 'server'): string;
+ export declare function srcViteConfig(environment: 'browser' | 'server', spec: Pick<Blueprint, 'name' | 'src'>): string;
 
  /**
   * Serialize a value to a canonical, key-order-INDEPENDENT JSON-like string.

package/dist/src/core/index.js

@@ -274,7 +274,7 @@ var DEFAULT_VERSION = "0.0.1";
 /** The `engines.node` range the `blueprint` builder fills. */
 var DEFAULT_ENGINES = `>=${MINIMUM_NODE_VERSION}`;
 /** The devDependency range generated packages pin `@orkestrel/scaffold` at. */
-var SCAFFOLD_RANGE = "^0.0.22";
+var SCAFFOLD_RANGE = "^0.0.23";
 /** Tooling versions shared by scaffold and every generated workspace. */
 var BASE_DEV_DEPENDENCIES = Object.freeze({
 	"@microsoft/api-extractor": "^7.58.12",
@@ -4699,8 +4699,19 @@ exit 1
 		content: `import { globSync } from 'node:fs'
 import { describe, expect, it } from 'vitest'
 import { isBrowserVuePath } from './setup.js'
-import { inspectCodingLaw, inspectCodingWorkspace, isFunctionDomainPath } from './setupPolicy.js'{{vuePolicyImport}}
-
+import {
+	derivePolicyTokens,
+	inspectCodingLaw,
+	inspectCodingWorkspace,
+	inspectPolicyPurity,
+	inspectPolicyWorkspace,
+	isFunctionDomainPath,
+	POLICY_SOURCE_ENVIRONMENTS,
+	readPackageName,
+} from './setupPolicy.js'{{vuePolicyImport}}
+
+${CONST_KEYWORD} POLICY_PLANTED_PATH = 'tests/setupPolicy.ts'
+${CONST_KEYWORD} POLICY_TOKENS = derivePolicyTokens(readPackageName(process.cwd()))
 ${CONST_KEYWORD} FUNCTION_MODULE_PATH = 'app/browser/composables/useTheme.ts'
 ${CONST_KEYWORD} FUNCTION_MODULE_VIOLATION =
 	FUNCTION_MODULE_PATH + ' declarations do not form one matching exported function implementation'
@@ -4839,6 +4850,30 @@ describe('repository coding law', () => {
 		expect(inspectCodingLaw(path, content)).toEqual([])
 	})
 })
+
+describe('fleet policy purity', () => {
+	it('keeps fleet policy files free of this package architecture', () => {
+		expect(inspectPolicyWorkspace(process.cwd())).toEqual([])
+	})
+
+	it('reports planted package architecture, so a clean sweep is evidence', () => {
+		const token = POLICY_TOKENS[0]
+		const environment = POLICY_SOURCE_ENVIRONMENTS[0]
+		if (token === undefined || environment === undefined) {
+			throw new Error('The package manifest derived no policy token to plant')
+		}
+		const planted = [
+			'export const ' + token + '_PATH = []',
+			"export const path = 'src/" + environment + "/index.ts'",
+			'',
+		].join('\\n')
+
+		expect(inspectPolicyPurity(POLICY_PLANTED_PATH, planted, POLICY_TOKENS)).toEqual([
+			POLICY_PLANTED_PATH + ':1:14 forbids the ' + token + ' package token',
+			POLICY_PLANTED_PATH + ':2:21 forbids a source-environment path literal',
+		])
+	})
+})
 `
 	}),
 	setupServer: Object.freeze({
@@ -9287,28 +9322,60 @@ function srcTsconfig(environment) {
 * `build.lib` / externals live in the root `srcBrowser` / `srcServer` export
 * instead (per the live exemplars).
 *
+* @remarks
+* `bundleTypes` rolls the face up through API Extractor, which leaves every
+* `src/core` re-export behind a relative `../core/index.ts` specifier — a path no
+* published tarball carries. A workspace that also declares `core` therefore emits
+* a `beforeWriteFile` rewrite turning that specifier into `@orkestrel/<name>`, the
+* package's own published root export. The rewrite is narrowed to the FINAL face
+* roll-up: applying it to the intermediate declarations makes API Extractor analyse
+* `src/core`'s own source and abort. A workspace with no `core` emits no rewrite,
+* because it has no cross-environment specifier to externalize.
+*
 * @param environment - The non-`core` environment to derive the `vite.config.ts` for.
+* @param spec - The blueprint slice naming the package and its declared source environments.
 * @returns The environment `vite.config.ts` file content, newline-terminated.
 *
 * @example
 * ```ts
-* srcViteConfig('browser').includes('srcBrowser') // true
+* srcViteConfig('browser', { name: 'router', src: ['core', 'browser'] }).includes('srcBrowser')
 * ```
 */
-function srcViteConfig(environment) {
+function srcViteConfig(environment, spec) {
 	const anchor = environment === "browser" ? "srcBrowser" : "srcServer";
+	const specifier = `'@orkestrel/${spec.name}'`;
+	const pattern = "/(?:\\.\\.\\/)+core\\/index\\.ts/g";
+	const inlineCall = `\t\t\t\t\t\t? content.replaceAll(${pattern}, ${specifier})`;
+	const call = fitsPrintWidth(inlineCall) ? [inlineCall] : [
+		"						? content.replaceAll(",
+		`\t\t\t\t\t\t\t\t${pattern},`,
+		`\t\t\t\t\t\t\t\t${specifier},`,
+		"							)"
+	];
+	const face = `/[\\\\/]dist[\\\\/]src[\\\\/]${environment}[\\\\/]index\\.d\\.ts$/`;
+	const external = spec.src.includes("core");
+	const rewrite = external ? `\n${[
+		"				beforeWriteFile: (path, content) => ({",
+		`\t\t\t\t\tcontent: ${face}.test(path)`,
+		...call,
+		"						: content,",
+		"				}),"
+	].join("\n")}` : "";
 	return `import { defineConfig } from 'vite'
 import dts from 'vite-plugin-dts'
 import { ${anchor}, resolveWorkspacePath } from '../../vite.config.ts'
 
-// Types are bundled inline by vite-plugin-dts (see configs/src/vite.core.config.ts
-// for the same pattern).
+${external ? `// vite-plugin-dts rolls this face into one declaration, and the roll-up reaches
+// src/core through a relative source path the tarball does not carry. The rewrite
+// below externalizes core through the package's own published root export, on the
+// final roll-up only.` : `// vite-plugin-dts rolls this face into one declaration. This workspace declares no
+// src/core, so the roll-up has no cross-environment specifier to externalize.`}
 export default defineConfig(
 	${anchor}({
 		plugins: [
 			dts({
 				tsconfigPath: resolveWorkspacePath('configs/src/tsconfig.${environment}.json'),
-				bundleTypes: true,
+				bundleTypes: true,${rewrite}
 			}),
 		],
 	}),
@@ -9524,7 +9591,7 @@ function configArtifacts(spec) {
 		const row = SRC_MATRIX[environment];
 		for (const path of row.configs) {
 			const isTsconfig = path.endsWith(".json");
-			const content = environment === "core" ? isTsconfig ? coreTsconfig() : coreViteConfig() : isTsconfig ? srcTsconfig(environment) : srcViteConfig(environment);
+			const content = environment === "core" ? isTsconfig ? coreTsconfig() : coreViteConfig() : isTsconfig ? srcTsconfig(environment) : srcViteConfig(environment, spec);
 			artifacts.push({
 				path,
 				group: "configs",