sku 16.3.0-replace-pnpm-plugin-20260909044129 → 16.3.0

package/CHANGELOG.md

@@ -1,24 +1,32 @@
 # sku
 
-## 16.3.0-replace-pnpm-plugin-20260909044129
+## 16.3.0
 
 ### Minor Changes
 
-- Migrate from `pnpm-plugin-sku` to static `pnpm-workspace.yaml` configuration. ([#1718](https://github.com/seek-oss/sku/pull/1718))
-
-  ### Summary of Changes
-  - **Static Workspace Configuration**: Sku's recommended pnpm settings are now written directly into `pnpm-workspace.yaml` with `[sku_managed]` comment markers instead of being injected at runtime via `pnpm-plugin-sku`.
-  - **Automatic Migration**: On the first run of a configuration-enabled sku command or postinstall, `pnpm-plugin-sku` is removed from `configDependencies` in `pnpm-workspace.yaml` (and the `configDependencies` field is deleted if empty).
-  - **Two Sync Modes**:
-    - **Additive Sync (configuration-enabled sku commands & postinstall)**: Adds missing managed single-value settings and `allowBuilds` keys, unions and deduplicates array settings (`publicHoistPattern`, `minimumReleaseAgeExclude`, `trustPolicyExclude`), and never overwrites existing config values or removes user-owned entries.
-    - **Enforce Mode (`sku configure`)**: Overwrites managed single-value settings and marked `allowBuilds` keys to match sku defaults in both directions. Unmarked `allowBuilds` overrides are preserved. Removes retired sku defaults that still carry a `[sku_managed]` marker.
-    - **Managed Comments**: Comments on entries adopted or overwritten by sku are replaced with the `[sku_managed]` marker, alongside any explanatory comment sku provides (for example `# 3 days [sku_managed]`).
-  - **Mutation Logging**: File creation, additions, adoptions, duplicate removal, migrations, updates, and retirements are logged; aligned files remain silent.
-  - **Drift Warnings**: Regular sku commands warn when managed values differ from sku defaults or when retired entries still have a `[sku_managed]` marker, suggesting `sku configure` to align.
-  - **Opt-outs and Escape Hatches**:
-    - `skuSkipConfigure: true` in `package.json` disables the sync on regular sku commands (`skuSkipPostInstall: true` disables it on postinstall). Manual `sku configure` always syncs.
-    - To keep an entry that sku has retired, delete its `[sku_managed]` marker (or re-add it without a marker) to designate it as user-managed.
-  - **New Project Scaffolding**: `@sku-lib/create` now uses the shared sync engine to emit `pnpm-workspace.yaml` on project creation, without installing `pnpm-plugin-sku` or gating on pnpm versions.
+- Managed Data Mode root layouts now need to render the full `<html>`, `<head>`, and `<body>`, not just inside the `<body>`. Allowing it to render into any part of document. ([#1720](https://github.com/seek-oss/sku/pull/1720))
+
+- Add `entrySideEffects` so apps can import isomorphic modules (such as Braid reset) before any consumer module. ([#1717](https://github.com/seek-oss/sku/pull/1717))
+
+- Webpack SSR: Pass the listening server and port to `onStart` ([#1730](https://github.com/seek-oss/sku/pull/1730))
+
+  `onStart` still receives the Express app as its first argument. A new second argument carries `{ httpServer, port }`, so apps can set keep-alive timeouts and close the server on shutdown.
+
+  ```tsx
+  import type { Server } from 'sku';
+
+  export default (): Server => ({
+    renderCallback,
+    onStart: (app, { httpServer, port }) => {
+      httpServer.keepAliveTimeout = 20_000;
+      process.on('SIGTERM', () => {
+        httpServer.close(() => process.exit(0));
+      });
+    },
+  });
+  ```
+
+  See the [Webpack SSR](https://seek-oss.github.io/sku/ssr/webpack-ssr) docs for more details.
 
 ## 16.2.0
 

package/dist/context/configSchema.mjs

@@ -122,6 +122,10 @@ var configSchema_default = validator.compile({
 		type: "array",
 		items: "string"
 	},
+	entrySideEffects: {
+		type: "array",
+		items: "string"
+	},
 	libraryName: {
 		type: "string",
 		optional: true

package/dist/context/createSkuContext.mjs

@@ -107,6 +107,7 @@ const createSkuContext = async ({ configPath, port: portArg, strictPort }) => {
 	const libraryFile = skuConfig.libraryFile;
 	const isLibrary = Boolean(skuConfig.libraryEntry);
 	const polyfills = skuConfig.polyfills;
+	const entrySideEffects = skuConfig.entrySideEffects;
 	const webpackDecorator = skuConfig.dangerouslySetWebpackConfig;
 	const jestDecorator = skuConfig.dangerouslySetJestConfig;
 	const eslintDecorator = skuConfig.dangerouslySetESLintConfig;
@@ -157,6 +158,7 @@ const createSkuContext = async ({ configPath, port: portArg, strictPort }) => {
 		libraryFile,
 		isLibrary,
 		polyfills,
+		entrySideEffects,
 		webpackDecorator,
 		jestDecorator,
 		eslintDecorator,

package/dist/context/defaultSkuConfig.mjs

@@ -26,6 +26,7 @@ var defaultSkuConfig_default = {
 	public: "public",
 	publicPath: "/",
 	polyfills: [],
+	entrySideEffects: [],
 	libraryName: void 0,
 	libraryFile: void 0,
 	sourceMapsProd: true,

package/dist/entries/ssr-client.d.mts

@@ -1 +1,2 @@
+import "virtual:sku/entry-side-effects";
 import "virtual:sku/polyfills";

package/dist/entries/ssr-client.mjs

@@ -1,15 +1,16 @@
-import { Document } from "../services/vite/ssr/Document.mjs";
 import { buildSiteRouteTrees } from "../services/vite/ssr/buildSiteRouteTrees.mjs";
 import { readRoutesEntry } from "../services/vite/ssr/readRoutesEntry.mjs";
 import { assertSiteName, selectForSite } from "../services/vite/ssr/selectForSite.mjs";
+import "virtual:sku/entry-side-effects";
 import "virtual:sku/polyfills";
 import * as clientEntry from "__sku_alias__clientEntry";
-import { jsx } from "react/jsx-runtime";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { hydrateRoot } from "react-dom/client";
 import { RouterProvider, createBrowserRouter, matchRoutes } from "react-router";
 import * as routesEntry from "__sku_alias__routesEntry";
 import { SkuProvider } from "#runtime/skuContext";
 import { registerSiteRouteTree } from "#runtime/preloadRoute";
+import { DocumentAssetLinks } from "#runtime/documentAssets";
 //#region src/services/vite/entries/ssr-client.tsx
 const { routes, mapRoutePath } = readRoutesEntry(routesEntry);
 const entry = clientEntry.default;
@@ -41,18 +42,15 @@ const hydrate = async () => {
 		}) } : {},
 		...instrumentations === void 0 ? {} : { instrumentations }
 	});
-	hydrateRoot(document, /* @__PURE__ */ jsx(Document, {
-		assets: window.__SKU_DOCUMENT_ASSETS__ ?? {
-			css: [],
-			modulePreloads: []
-		},
-		children: /* @__PURE__ */ jsx(SkuProvider, {
-			site,
-			clientContext,
-			reactContext,
-			children: /* @__PURE__ */ jsx(RouterProvider, { router })
-		})
-	}));
+	hydrateRoot(document, /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(DocumentAssetLinks, { assets: window.__SKU_DOCUMENT_ASSETS__ ?? {
+		css: [],
+		modulePreloads: []
+	} }), /* @__PURE__ */ jsx(SkuProvider, {
+		site,
+		clientContext,
+		reactContext,
+		children: /* @__PURE__ */ jsx(RouterProvider, { router })
+	})] }));
 };
 hydrate().catch((error) => {
 	console.error(error);

package/dist/entries/ssr-server.d.mts

@@ -1,4 +1,5 @@
 import { RenderAssets, RenderManifest, RenderOptions, RenderResult, SkuMiddleware, SkuOnListen } from "../services/vite/ssr/types.mjs";
+import "virtual:sku/entry-side-effects";
 import { Request as Request$1 } from "express";
 //#region src/services/vite/entries/ssr-server.d.ts
 declare const middleware: SkuMiddleware | undefined, onListen: SkuOnListen | undefined;

package/dist/entries/ssr-server.mjs

@@ -2,6 +2,7 @@ import { buildSiteRouteTrees } from "../services/vite/ssr/buildSiteRouteTrees.mj
 import { readRoutesEntry } from "../services/vite/ssr/readRoutesEntry.mjs";
 import { buildSiteStaticHandlers } from "../services/vite/ssr/buildSiteStaticHandlers.mjs";
 import { render as render$1 } from "../services/vite/ssr/render.mjs";
+import "virtual:sku/entry-side-effects";
 import * as routesEntry from "__sku_alias__routesEntry";
 import * as serverEntry from "__sku_alias__serverEntry";
 //#region src/services/vite/entries/ssr-server.tsx

package/dist/entries/vite-client.d.mts

@@ -1 +1,2 @@
+import "virtual:sku/entry-side-effects";
 import "virtual:sku/polyfills";

package/dist/entries/vite-client.mjs

@@ -1,3 +1,4 @@
+import "virtual:sku/entry-side-effects";
 import "virtual:sku/polyfills";
 import client from "__sku_alias__clientEntry";
 import dedent from "dedent";

package/dist/entries/vite-render.d.mts

@@ -1,4 +1,5 @@
 import { ViteRenderFunction } from "../types/types.mjs";
+import "virtual:sku/entry-side-effects";
 //#region src/services/vite/entries/vite-render.d.ts
 declare const viteRender: ViteRenderFunction;
 //#endregion

package/dist/entries/vite-render.mjs

@@ -1,5 +1,6 @@
 import { createPreRenderedHtml } from "../services/vite/helpers/html/createPreRenderedHtml.mjs";
 import { createDebug } from "obug";
+import "virtual:sku/entry-side-effects";
 import { createCollector } from "@sku-lib/vite/collector";
 import render from "__sku_alias__renderEntry";
 //#region src/services/vite/entries/vite-render.tsx

package/dist/package.mjs

@@ -0,0 +1,4 @@
+//#region ../../package.json
+var packageManager = "pnpm@11.24.0";
+//#endregion
+export { packageManager };

package/dist/packages/sku/package.mjs

@@ -1,7 +1,7 @@
 //#region package.json
 var package_default = {
 	name: "sku",
-	version: "16.2.0",
+	version: "16.3.0",
 	description: "Front-end development toolkit, powered by Webpack, Babel, Vanilla Extract and Jest",
 	types: "./dist/index.d.mts",
 	bin: { "sku": "bin/bin.js" },
@@ -158,8 +158,7 @@ var package_default = {
 		"webpack-bundle-analyzer": "^5.1.1",
 		"webpack-dev-server": "catalog:",
 		"webpack-merge": "^6.0.1",
-		"webpack-node-externals": "^3.0.0",
-		"yaml": "^2.8.3"
+		"webpack-node-externals": "^3.0.0"
 	},
 	devDependencies: {
 		"@sku-private/tsdown": "workspace:*",

package/dist/postinstall.mjs

@@ -4,7 +4,7 @@ import "./private/utils/src/index.mjs";
 import { banner } from "./private/utils/src/console/banner.mjs";
 import "./private/utils/src/console/index.mjs";
 import { createSkuContext } from "./context/createSkuContext.mjs";
-import { configureApp } from "./utils/configureApp.mjs";
+import configureApp_default from "./utils/configureApp.mjs";
 import { createDebug } from "obug";
 //#region src/postinstall.ts
 /**
@@ -17,7 +17,7 @@ const postinstall = async ({ localCwd, packageJson, hasSkuDep }) => {
 	try {
 		log("postinstall", "running configure");
 		const skuContext = await createSkuContext({});
-		await configureApp(skuContext);
+		configureApp_default(skuContext);
 	} catch (error) {
 		console.error("An error occurred running postinstall script. Please check that sku.config.js is correct and try again.");
 		console.error(error);

package/dist/private/utils/src/index.mjs

@@ -1,9 +1,7 @@
 import "./path/toPosixPath.mjs";
 import { cwd, getPathFromCwd, requireFromCwd, setCwd, writeFileToCWD } from "./filesystem/cwd.mjs";
 import "./filesystem/index.mjs";
-import { getAddCommand, getExecuteCommand, getRunCommand, getWhyCommand, isPnpm, packageManager, rootDir } from "./packageManager/packageManager.mjs";
-import { MANAGED_BY_SKU_MARKER, arraySettings, defaultPnpmWorkspaceConfig, objectSettings, pnpmWorkspaceSettings, singleValueSettings } from "./packageManager/pnpmWorkspaceDefaults.mjs";
-import { ensurePnpmWorkspaceConfig } from "./packageManager/ensurePnpmWorkspaceConfig.mjs";
+import { getAddCommand, getExecuteCommand, getRunCommand, getWhyCommand, isAtLeastPnpmV10, isAtLeastRecommendedPnpmVersion, isPnpm, packageManager, rootDir } from "./packageManager/packageManager.mjs";
 import "./packageManager/index.mjs";
 import { makeUrl, serverUrls } from "./serverUrls.mjs";
-export { MANAGED_BY_SKU_MARKER, arraySettings, cwd, defaultPnpmWorkspaceConfig, ensurePnpmWorkspaceConfig, getAddCommand, getExecuteCommand, getPathFromCwd, getRunCommand, getWhyCommand, isPnpm, makeUrl, objectSettings, packageManager, pnpmWorkspaceSettings, requireFromCwd, rootDir, serverUrls, setCwd, singleValueSettings, writeFileToCWD };
+export { cwd, getAddCommand, getExecuteCommand, getPathFromCwd, getRunCommand, getWhyCommand, isAtLeastPnpmV10, isAtLeastRecommendedPnpmVersion, isPnpm, makeUrl, packageManager, requireFromCwd, rootDir, serverUrls, setCwd, writeFileToCWD };

package/dist/private/utils/src/packageManager/index.mjs

@@ -1,4 +1,3 @@
-import { getAddCommand, getExecuteCommand, getRunCommand, getWhyCommand, isPnpm, packageManager, rootDir } from "./packageManager.mjs";
-import { MANAGED_BY_SKU_MARKER, arraySettings, defaultPnpmWorkspaceConfig, objectSettings, pnpmWorkspaceSettings, singleValueSettings } from "./pnpmWorkspaceDefaults.mjs";
-import { ensurePnpmWorkspaceConfig } from "./ensurePnpmWorkspaceConfig.mjs";
-export { MANAGED_BY_SKU_MARKER, arraySettings, defaultPnpmWorkspaceConfig, ensurePnpmWorkspaceConfig, getAddCommand, getExecuteCommand, getRunCommand, getWhyCommand, isPnpm, objectSettings, packageManager, pnpmWorkspaceSettings, rootDir, singleValueSettings };
+import { getAddCommand, getExecuteCommand, getRunCommand, getWhyCommand, isAtLeastPnpmV10, isAtLeastRecommendedPnpmVersion, isPnpm, packageManager, rootDir } from "./packageManager.mjs";
+import "./skuPackageManager.mjs";
+export { getAddCommand, getExecuteCommand, getRunCommand, getWhyCommand, isAtLeastPnpmV10, isAtLeastRecommendedPnpmVersion, isPnpm, packageManager, rootDir };

package/dist/private/utils/src/packageManager/packageManager.mjs

@@ -4,6 +4,7 @@ import { detectSync } from "../../../../node_modules/.pnpm/package-manager-detec
 import { caution, strong } from "../console/styles.mjs";
 import { dirname } from "node:path";
 import * as find from "empathic/find";
+import semver from "semver";
 //#region ../../private/utils/src/packageManager/packageManager.ts
 const lockfileByPackageManager = {
 	pnpm: "pnpm-lock.yaml",
@@ -71,6 +72,9 @@ const resolvePackageManager = () => {
 	};
 };
 const { rootDir, packageManager, packageManagerVersion } = resolvePackageManager();
+const isAtLeastPnpmV10 = () => packageManager === "pnpm" && packageManagerVersion && semver.satisfies(packageManagerVersion, ">=10.0.0");
+const recommendedPnpmVersion = "10.13.0";
+const isAtLeastRecommendedPnpmVersion = () => Boolean(packageManager === "pnpm" && packageManagerVersion && semver.satisfies(packageManagerVersion, `>=${recommendedPnpmVersion}`));
 const getCommand = (agent, command, args) => {
 	const resolvedCommand = resolveCommand(agent, command, args);
 	if (!resolvedCommand) throw new Error(`Unable to resolve command: ${agent} ${command} ${args}`);
@@ -112,4 +116,4 @@ const getWhyCommand = () => {
 	return `${packageManager} ${isPnpm ? "why -r" : "why"}`;
 };
 //#endregion
-export { getAddCommand, getCommand, getExecuteCommand, getRunCommand, getWhyCommand, isPnpm, isYarn, packageManager, rootDir };
+export { getAddCommand, getCommand, getExecuteCommand, getRunCommand, getWhyCommand, isAtLeastPnpmV10, isAtLeastRecommendedPnpmVersion, isPnpm, isYarn, packageManager, packageManagerVersion, rootDir };

package/dist/private/utils/src/packageManager/skuPackageManager.mjs

@@ -0,0 +1,3 @@
+import "../../../../package.mjs";
+//#endregion
+export {};

package/dist/program/commands/configure/configure.action.mjs

@@ -1,7 +1,7 @@
-import { configureApp } from "../../../utils/configureApp.mjs";
+import configureApp_default from "../../../utils/configureApp.mjs";
 //#region src/program/commands/configure/configure.action.ts
-const configureAction = async ({ skuContext }) => {
-	await configureApp(skuContext, { mode: "enforce" });
+const configureAction = ({ skuContext }) => {
+	configureApp_default(skuContext);
 };
 //#endregion
 export { configureAction };

package/dist/program/commands/configure/configure.command.mjs

@@ -2,7 +2,7 @@ import { Command } from "commander";
 //#region src/program/commands/configure/configure.command.ts
 const configureCommand = new Command("configure").description("Emit and update configuration files for your project.").action(async (options) => {
 	const { configureAction } = await import("./configure.action.mjs");
-	await configureAction(options);
+	configureAction(options);
 });
 //#endregion
 export { configureCommand };

package/dist/program/commands/serve/serve.command.mjs

@@ -6,7 +6,7 @@ import { Command } from "commander";
 const serveCommand = new Command("serve").description("Serve a production build of a statically-rendered application from your local machine.").addOption(siteOption).addOption(portOption).addOption(strictPortOption).addOption(listUrlsOption).action(async ({ site, skuContext }, command) => {
 	const { serveAction } = await import("./serve.action.mjs");
 	const { environment } = command.optsWithGlobals();
-	await serveAction({
+	serveAction({
 		site,
 		environment,
 		skuContext

package/dist/program/commands/translations/helpers/translation-helpers.mjs

@@ -1,6 +1,6 @@
 import { getVocabConfig } from "../../../../services/vocab/config.mjs";
-import { resolveConfig } from "@vocab/core";
 import { execSync } from "node:child_process";
+import { resolveConfig } from "@vocab/core";
 //#region src/program/commands/translations/helpers/translation-helpers.ts
 const ensureBranch = async () => {
 	const branch = getGitBranch();

package/dist/services/packageManager/getPnpmConfigDependencies.mjs

@@ -0,0 +1,12 @@
+import { execAsync } from "../../utils/execAsync.mjs";
+//#region src/services/packageManager/getPnpmConfigDependencies.ts
+const getPnpmConfigDependencies = async () => {
+	const rawResult = await execAsync(`pnpm config get --json`);
+	if (!rawResult) return [];
+	const result = JSON.parse(rawResult);
+	const configDependencies = result["config-dependencies"] ?? result.configDependencies;
+	if (!configDependencies) return [];
+	return Object.keys(configDependencies);
+};
+//#endregion
+export { getPnpmConfigDependencies };

package/dist/services/packageManager/pnpmConfig.mjs

@@ -0,0 +1,14 @@
+import { accent } from "../../private/utils/src/console/styles.mjs";
+import { banner } from "../../private/utils/src/console/banner.mjs";
+import "../../private/utils/src/console/index.mjs";
+//#region src/services/packageManager/pnpmConfig.ts
+const validatePnpmConfig = async ({ hasRecommendedPnpmVersionInstalled, pnpmPluginSkuInstalled }) => {
+	if (!pnpmPluginSkuInstalled || !hasRecommendedPnpmVersionInstalled) {
+		const messages = [];
+		if (!hasRecommendedPnpmVersionInstalled) messages.push(`Please ensure you are on ${accent("PNPM v10.13.0")} or later.`);
+		messages.push(`Please delete your top-level ${accent("node_modules")} and run "${accent("pnpm add --config pnpm-plugin-sku && pnpm install")}".`);
+		banner("caution", "pnpm-plugin-sku is not configured correctly", messages);
+	}
+};
+//#endregion
+export { validatePnpmConfig };

package/dist/services/vite/plugins/entrySideEffects.mjs

@@ -0,0 +1,35 @@
+import { cwd } from "../../../private/utils/src/filesystem/cwd.mjs";
+import "../../../private/utils/src/index.mjs";
+import { makePluginName } from "../helpers/makePluginName.mjs";
+import { exactRegex } from "../../../node_modules/.pnpm/rolldown@1.2.2/node_modules/rolldown/dist/filter-index.mjs";
+import { createRequire } from "node:module";
+//#region src/services/vite/plugins/entrySideEffects.ts
+const require = createRequire(import.meta.url);
+const ENTRY_SIDE_EFFECTS_VIRTUAL_ID = "virtual:sku/entry-side-effects";
+const isFileSpecifier = (specifier) => specifier.startsWith(".") || specifier.startsWith("/");
+const loadEntrySideEffectsModule = (specifiers) => specifiers.map((specifier) => {
+	const resolved = require.resolve(specifier, { paths: [cwd()] });
+	return `import "${isFileSpecifier(specifier) ? resolved : specifier}";`;
+}).join("\n");
+const entrySideEffectsPlugin = (skuContext) => {
+	const resolvedVirtualModuleId = `\0${ENTRY_SIDE_EFFECTS_VIRTUAL_ID}`;
+	const moduleCode = loadEntrySideEffectsModule(skuContext.entrySideEffects);
+	return {
+		name: makePluginName("entry-side-effects"),
+		config: () => skuContext.entrySideEffects.length === 0 ? void 0 : { optimizeDeps: { include: skuContext.entrySideEffects } },
+		resolveId: {
+			filter: { id: exactRegex(ENTRY_SIDE_EFFECTS_VIRTUAL_ID) },
+			handler() {
+				return resolvedVirtualModuleId;
+			}
+		},
+		load: {
+			filter: { id: exactRegex(resolvedVirtualModuleId) },
+			handler() {
+				return moduleCode;
+			}
+		}
+	};
+};
+//#endregion
+export { ENTRY_SIDE_EFFECTS_VIRTUAL_ID, entrySideEffectsPlugin, loadEntrySideEffectsModule };

package/dist/services/vite/plugins/ssr.mjs

@@ -1,6 +1,7 @@
 import { makePluginName } from "../helpers/makePluginName.mjs";
 import { SSR_CLIENT_CHUNK_NAME } from "../ssr/resolveAssets.mjs";
 import { createOutDir } from "../helpers/bundleConfig.mjs";
+import { ENTRY_SIDE_EFFECTS_VIRTUAL_ID } from "./entrySideEffects.mjs";
 import { CLIENT_MANIFEST_RELATIVE_PATH } from "../ssr/clientManifestPath.mjs";
 import { resolveConfigSiteNames } from "../ssr/resolveConfigSiteNames.mjs";
 import { lazyRouteModuleIdPlugin } from "./lazyRouteModuleId/lazyRouteModuleIdPlugin.mjs";
@@ -25,6 +26,7 @@ const ssrPlugins = (skuContext) => {
 					skuContext.paths.clientEntry,
 					skuContext.paths.routesEntry,
 					ssrClientDevEntry,
+					ssrClientEntry,
 					ssrServerEntry
 				] },
 				ssr: { external: ["vite"] }
@@ -69,6 +71,7 @@ const ssrPlugins = (skuContext) => {
 		lazyRouteModuleIdPlugin(),
 		vitePluginSsrCss({
 			entries: [
+				ENTRY_SIDE_EFFECTS_VIRTUAL_ID,
 				skuContext.paths.serverEntry,
 				skuContext.paths.routesEntry,
 				ssrServerEntry

package/dist/services/vite/plugins/ssrCss/constants.mjs

@@ -1,6 +1,6 @@
 //#region src/services/vite/plugins/ssrCss/constants.ts
 const SSR_CSS_VIRTUAL_ENTRY = "virtual:ssr-css.css";
-/** Dev-server URL for the collected SSR stylesheet (Document / transformIndexHtml). */
+/** Dev-server URL for the collected SSR stylesheet (sku hoist / transformIndexHtml). */
 const SSR_CSS_VIRTUAL_HREF = `/@id/__x00__${SSR_CSS_VIRTUAL_ENTRY}`;
 //#endregion
 export { SSR_CSS_VIRTUAL_ENTRY, SSR_CSS_VIRTUAL_HREF };

package/dist/services/vite/plugins/ssrCss/plugin.mjs

@@ -1,12 +1,12 @@
-import { SSR_CSS_VIRTUAL_ENTRY, SSR_CSS_VIRTUAL_HREF } from "./constants.mjs";
 import { collectStyle } from "./collect.mjs";
+import { SSR_CSS_VIRTUAL_ENTRY, SSR_CSS_VIRTUAL_HREF } from "./constants.mjs";
 //#region src/services/vite/plugins/ssrCss/plugin.ts
 const PLUGIN_NAME = "vite-plugin-ssr-css";
 /**
 * This plugin provides virtual:ssr-css.css to collect styles reachable from entries.
 * When `injectHtml` is true (static Vite), ViteDevServer.transformIndexHtml injects
 * the stylesheet link plus HMR cleanup. SSR sets `injectHtml: false` and puts
-* `SSR_CSS_VIRTUAL_HREF` in Document `assets.css` instead.
+* `SSR_CSS_VIRTUAL_HREF` in sku-hoisted `assets.css` instead.
 *
 * This plugin has been forked from `hi-ogawa/vite-plugins`, with some adjustments to make it work with Sku + Braid.
 * @see https://github.com/hi-ogawa/vite-plugins/blob/main/packages/ssr-css/README.md

package/dist/services/vite/plugins/static.mjs

@@ -1,5 +1,6 @@
 import { makePluginName } from "../helpers/makePluginName.mjs";
 import { createOutDir, renderEntryChunkName } from "../helpers/bundleConfig.mjs";
+import { ENTRY_SIDE_EFFECTS_VIRTUAL_ID } from "./entrySideEffects.mjs";
 import { vitePluginSsrCss } from "./ssrCss/plugin.mjs";
 import { telemetryPlugin } from "./telemetry.mjs";
 import { middlewarePlugin } from "./middleware.mjs";
@@ -42,7 +43,7 @@ const staticPlugins = ({ skuContext, environment }) => {
 				} }
 			} })
 		},
-		vitePluginSsrCss({ entries: [skuContext.paths.renderEntry] }),
+		vitePluginSsrCss({ entries: [ENTRY_SIDE_EFFECTS_VIRTUAL_ID, skuContext.paths.renderEntry] }),
 		environment !== void 0 && middlewarePlugin({
 			skuContext,
 			environment

package/dist/services/vite/skuPlugin.mjs

@@ -2,6 +2,7 @@ import { httpsDevServerPlugin } from "./plugins/httpsDevServer.mjs";
 import { preloadPlugin } from "./plugins/preloadPlugin/preloadPlugin.mjs";
 import { setNoExternalPlugin } from "./plugins/setNoExternal.mjs";
 import { polyfillsPlugin } from "./plugins/polyfills.mjs";
+import { entrySideEffectsPlugin } from "./plugins/entrySideEffects.mjs";
 import { dangerouslySetViteConfigPlugin } from "./plugins/dangerouslySetViteConfig.mjs";
 import { configPlugin } from "./plugins/config.mjs";
 import { buildPlugin } from "./plugins/build.mjs";
@@ -27,6 +28,7 @@ const skuPlugin = ({ skuContext, environment }) => {
 			convertFromWebpack: skuContext.convertLoadable,
 			commandName: skuContext.commandName
 		}),
+		entrySideEffectsPlugin(skuContext),
 		polyfillsPlugin(skuContext),
 		!isSsr && staticPlugins({
 			skuContext,

package/dist/services/vite/ssr/createDevSsrServer.mjs

@@ -1,5 +1,5 @@
-import { SSR_CSS_VIRTUAL_HREF } from "../plugins/ssrCss/constants.mjs";
 import { getAppHosts } from "../../../context/hosts.mjs";
+import { SSR_CSS_VIRTUAL_HREF } from "../plugins/ssrCss/constants.mjs";
 import { metricsMeasurers } from "../../telemetry/metricsMeasurers.mjs";
 import { createConfig } from "../helpers/config/createConfig.mjs";
 import createServer$1 from "../../../utils/createServer.mjs";
@@ -52,7 +52,8 @@ const createDevSsrServer = async ({ skuContext, environment }) => {
 	const assets = {
 		bootstrapModules: [`/@vite/client`, `/@fs/${clientEntry}`],
 		css: [SSR_CSS_VIRTUAL_HREF],
-		modulePreloads: []
+		modulePreloads: [],
+		ssrCssHref: SSR_CSS_VIRTUAL_HREF
 	};
 	const render = async (...args) => {
 		return (await vite.ssrLoadModule(serverEntry)).render(...args);

package/dist/services/vite/ssr/createDocumentAttempt.mjs

@@ -1,11 +1,11 @@
-import { Document } from "./Document.mjs";
 import { abortReason } from "./abortReason.mjs";
 import { bindCommit } from "./bindCommit.mjs";
 import { buildBootstrapScriptContent } from "./bootstrap.mjs";
 import { renderToPipeableStream } from "react-dom/server";
-import { jsx } from "react/jsx-runtime";
+import { jsx, jsxs } from "react/jsx-runtime";
 import { StaticRouterProvider, createStaticRouter } from "react-router";
 import { SkuProvider } from "#runtime/skuContext";
+import { DocumentAssetLinks } from "#runtime/documentAssets";
 import { InsertHtmlProvider, createInsertHtmlQueue } from "#runtime/insertHtml";
 //#region src/services/vite/ssr/createDocumentAttempt.tsx
 const createDocumentAttempt = ({ renderContext, dataRoutes, documentAssets, assets, site, clientContext, reactContext, routeHeaders, waitForAll, nonce, options }) => {
@@ -54,21 +54,18 @@ const createDocumentAttempt = ({ renderContext, dataRoutes, documentAssets, asse
 			queue: insertHtmlQueue
 		})
 	});
-	streamRef.current = renderToPipeableStream(/* @__PURE__ */ jsx(InsertHtmlProvider, {
+	streamRef.current = renderToPipeableStream(/* @__PURE__ */ jsxs(InsertHtmlProvider, {
 		insertHtml: insertHtmlQueue.insertHtml,
-		children: /* @__PURE__ */ jsx(Document, {
-			assets: documentAssets,
-			children: /* @__PURE__ */ jsx(SkuProvider, {
-				site,
-				clientContext,
-				reactContext,
-				children: /* @__PURE__ */ jsx(StaticRouterProvider, {
-					router,
-					context: renderContext,
-					hydrate: false
-				})
+		children: [/* @__PURE__ */ jsx(DocumentAssetLinks, { assets: documentAssets }), /* @__PURE__ */ jsx(SkuProvider, {
+			site,
+			clientContext,
+			reactContext,
+			children: /* @__PURE__ */ jsx(StaticRouterProvider, {
+				router,
+				context: renderContext,
+				hydrate: false
 			})
-		})
+		})]
 	}), {
 		bootstrapModules: assets.bootstrapModules,
 		bootstrapScriptContent,

package/dist/services/vite/ssr/documentAssets.d.mts

@@ -0,0 +1,12 @@
+import { DocumentAssets } from "./types.mjs";
+//#region src/services/vite/ssr/documentAssets.d.ts
+declare const SKU_STYLESHEET_PRECEDENCE = "sku";
+/**
+ * Sku-owned CSS and modulepreload links. Mounted beside the router so React
+ * hoists them into the app `<head>`.
+ */
+declare const DocumentAssetLinks: ({ assets }: {
+  assets: DocumentAssets;
+}) => import("react").JSX.Element;
+//#endregion
+export { DocumentAssetLinks, SKU_STYLESHEET_PRECEDENCE };

package/dist/services/vite/ssr/documentAssets.mjs

@@ -0,0 +1,18 @@
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+//#region src/services/vite/ssr/documentAssets.tsx
+const SKU_STYLESHEET_PRECEDENCE = "sku";
+/**
+* Sku-owned CSS and modulepreload links. Mounted beside the router so React
+* hoists them into the app `<head>`.
+*/
+const DocumentAssetLinks = ({ assets }) => /* @__PURE__ */ jsxs(Fragment, { children: [assets.modulePreloads.map((href) => /* @__PURE__ */ jsx("link", {
+	rel: "modulepreload",
+	href
+}, href)), assets.css.map((href) => /* @__PURE__ */ jsx("link", {
+	rel: "stylesheet",
+	href,
+	precedence: "sku",
+	...href === assets.ssrCssHref ? { "data-ssr-css": true } : {}
+}, href))] });
+//#endregion
+export { DocumentAssetLinks, SKU_STYLESHEET_PRECEDENCE };

package/dist/services/vite/ssr/render.mjs

@@ -36,7 +36,8 @@ const renderDocument = async ({ siteStaticHandlers, request, req, assets, getSit
 	});
 	let documentAssets = {
 		css: assets.css,
-		modulePreloads: assets.modulePreloads
+		modulePreloads: assets.modulePreloads,
+		ssrCssHref: assets.ssrCssHref
 	};
 	if (renderManifest) documentAssets = resolveAssets({
 		manifest: renderManifest.manifest,

package/dist/services/vite/ssr/types.d.mts

@@ -10,6 +10,11 @@ import { Express, Request as Request$1, RequestHandler } from "express";
 interface DocumentAssets {
   css: string[];
   modulePreloads: string[];
+  /**
+   * Start-only virtual stylesheet href. Sku document asset links mark this URL
+   * with `data-ssr-css` so the client can drop it after HMR.
+   */
+  ssrCssHref?: string;
 }
 interface RenderAssets extends DocumentAssets {
   bootstrapModules: string[];

package/dist/types/types.d.mts

@@ -1,6 +1,8 @@
 import { Plugin, PluginOption } from "vite";
 import { JSX, ReactNode } from "react";
 import { ChunkExtractor } from "@loadable/server";
+import { Server } from "node:http";
+import { Server as Server$1 } from "node:https";
 import { Express, RequestHandler } from "express";
 import { Linter } from "eslint";
 import { TestUserConfig } from "vitest/node";
@@ -27,9 +29,12 @@ interface RenderCallbackParams {
   extractor: ChunkExtractor;
   registerScript?: (script: string) => void;
 }
-interface Server {
+interface Server$2 {
   renderCallback: (params: RenderCallbackParams, ...requestHandlerParams: Parameters<RequestHandler>) => void;
-  onStart?: (app: Express) => void;
+  onStart?: (app: Express, server: {
+    httpServer: Server | Server$1;
+    port: number;
+  }) => void | Promise<void>;
   middleware?: RequestHandler | RequestHandler[];
 }
 interface RenderableRoute {
@@ -508,6 +513,16 @@ interface ViteSkuConfig {
    * @default: []
    */
   vitePlugins?: PluginOption[];
+  /**
+   * An array of isomorphic modules to import before any consumer module.
+   *
+   * Use this for CSS resets (for example `braid-design-system/reset`) that must
+   * evaluate first. Specifiers resolve from the app, in array order.
+   *
+   * @default []
+   * @link https://seek-oss.github.io/sku/configuration#entrysideeffects
+   */
+  entrySideEffects?: string[];
   /**
    * **SSR only** (`buildType: 'ssr'`)
    *
@@ -587,4 +602,4 @@ type SkuConfig = SkuConfigBase & (({
   bundler: 'vite';
 } & ViteSkuConfig));
 //#endregion
-export { Render, RenderAppProps, RenderCallbackParams, RenderableRoute, Server, SkuConfig, SkuConfigBase, SkuLanguage, SkuProvider, SkuRoute, SkuRouteObject, SkuSiteObject, TransformOutputPathFunctionParams, ViteRenderFunction, ViteSkuConfig, WebpackSkuConfig };
+export { Render, RenderAppProps, RenderCallbackParams, RenderableRoute, Server$2 as Server, SkuConfig, SkuConfigBase, SkuLanguage, SkuProvider, SkuRoute, SkuRouteObject, SkuSiteObject, TransformOutputPathFunctionParams, ViteRenderFunction, ViteSkuConfig, WebpackSkuConfig };

package/dist/utils/configure.mjs

@@ -17,8 +17,8 @@ const configureProject = async (skuContext) => {
 		log(`"skuSkipConfigure" set in ${packageJson}, skipping sku configuration`);
 		return;
 	}
-	const { configureApp } = await import("./configureApp.mjs");
-	await configureApp(skuContext);
+	const { default: configure } = await import("./configureApp.mjs");
+	await configure(skuContext);
 };
 const validatePeerDeps = (skuContext) => {
 	if (skipValidatePeerDeps) {

package/dist/utils/configureApp.mjs

@@ -1,6 +1,5 @@
 import { getPathFromCwd, writeFileToCWD } from "../private/utils/src/filesystem/cwd.mjs";
-import { isPnpm, rootDir } from "../private/utils/src/packageManager/packageManager.mjs";
-import { ensurePnpmWorkspaceConfig } from "../private/utils/src/packageManager/ensurePnpmWorkspaceConfig.mjs";
+import { isAtLeastPnpmV10, isAtLeastRecommendedPnpmVersion, rootDir } from "../private/utils/src/packageManager/packageManager.mjs";
 import "../private/utils/src/index.mjs";
 import options from "../config/prettier.mjs";
 import { bundleReportFolder } from "../services/webpack/config/plugins/bundleAnalyzer.mjs";
@@ -8,6 +7,8 @@ import { createTSConfig } from "../services/typescript/tsconfig.mjs";
 import getCertificate from "./certificate.mjs";
 import { syncPathAliasImports } from "./pathAliasImports.mjs";
 import { validateSkuConfigFormat } from "./validateSkuConfigFormat.mjs";
+import { getPnpmConfigDependencies } from "../services/packageManager/getPnpmConfigDependencies.mjs";
+import { validatePnpmConfig } from "../services/packageManager/pnpmConfig.mjs";
 import { warnOnLegacyReact } from "./warnOnLegacyReact.mjs";
 import path from "node:path";
 import { rm } from "node:fs/promises";
@@ -17,7 +18,7 @@ import ensureGitignore from "ensure-gitignore";
 const coverageFolder = "coverage";
 const convertToForwardSlashPaths = (pathStr) => pathStr.replace(/\\/g, "/");
 const addSep = (p) => `${p}${path.sep}`;
-async function configureApp(skuContext, options$1) {
+var configureApp_default = async (skuContext) => {
 	const { paths, httpsDevServer, languages, hosts } = skuContext;
 	validateSkuConfigFormat(paths.appSkuConfigPath);
 	const targetDirectories = [.../* @__PURE__ */ new Set([addSep(paths.relativeTarget)])];
@@ -64,11 +65,16 @@ async function configureApp(skuContext, options$1) {
 		comment: "managed by sku",
 		patterns: gitIgnorePatterns.map(convertToForwardSlashPaths)
 	});
-	if (rootDir && isPnpm) await ensurePnpmWorkspaceConfig({
-		targetDir: rootDir,
-		mode: options$1?.mode ?? "additive"
-	});
+	if (rootDir && isAtLeastPnpmV10()) {
+		const pnpmConfigDependencies = await getPnpmConfigDependencies();
+		const hasRecommendedPnpmVersionInstalled = isAtLeastRecommendedPnpmVersion();
+		const pnpmPluginSkuInstalled = pnpmConfigDependencies.includes("pnpm-plugin-sku");
+		await validatePnpmConfig({
+			hasRecommendedPnpmVersionInstalled,
+			pnpmPluginSkuInstalled
+		});
+	}
 	warnOnLegacyReact();
-}
+};
 //#endregion
-export { configureApp };
+export { configureApp_default as default };

package/dist/utils/validatePeerDeps.mjs

@@ -7,8 +7,8 @@ import "../private/utils/src/console/index.mjs";
 import telemetry_default from "../services/telemetry/index.mjs";
 import { readFileSync } from "node:fs";
 import { readFile } from "node:fs/promises";
-import { fdir } from "fdir";
 import semver from "semver";
+import { fdir } from "fdir";
 //#region src/utils/validatePeerDeps.ts
 const asyncMap = (list, fn) => Promise.all(list.map((item) => fn(item)));
 const singletonPackages = ["@vanilla-extract/css"];

package/dist/webpack/server.mjs

@@ -15,11 +15,20 @@ const { values } = parseArgs({
 	strict: false
 });
 const { port } = values;
-const startCallback = () => {
+let server;
+const startCallback = async () => {
 	console.log("sku SSR server started on port", port);
-	if (typeof onStart === "function") onStart(app);
+	if (typeof onStart !== "function") return;
+	try {
+		await onStart(app, {
+			httpServer: server,
+			port: Number(port)
+		});
+	} catch (error) {
+		console.error(error);
+		process.exit(1);
+	}
 };
-let server;
 if (__SKU_DEV_HTTPS__) {
 	const pems = fs.readFileSync(".ssl/self-signed.pem");
 	server = https.createServer({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sku",
-  "version": "16.3.0-replace-pnpm-plugin-20260909044129",
+  "version": "16.3.0",
   "description": "Front-end development toolkit, powered by Webpack, Babel, Vanilla Extract and Jest",
   "types": "./dist/index.d.mts",
   "bin": {
@@ -169,8 +169,7 @@
     "webpack-bundle-analyzer": "^5.1.1",
     "webpack-dev-server": "^5.2.4",
     "webpack-merge": "^6.0.1",
-    "webpack-node-externals": "^3.0.0",
-    "yaml": "^2.8.3"
+    "webpack-node-externals": "^3.0.0"
   },
   "devDependencies": {
     "@sku-private/tsdown": "0.0.0",

package/dist/private/utils/src/packageManager/ensurePnpmWorkspaceConfig.mjs

@@ -1,50 +0,0 @@
-import { caution } from "../console/styles.mjs";
-import { rootDir } from "./packageManager.mjs";
-import { defaultPnpmWorkspaceConfig } from "./pnpmWorkspaceDefaults.mjs";
-import { removePnpmPluginSku } from "./removePnpmPluginSku.mjs";
-import { syncArraySettings } from "./syncArraySettings.mjs";
-import { syncObjectSettings } from "./syncObjectSettings.mjs";
-import { syncSingleValueSettings } from "./syncSingleValueSettings.mjs";
-import { join } from "node:path";
-import { existsSync } from "node:fs";
-import { readFile, writeFile } from "node:fs/promises";
-import { Document, isMap, parseDocument } from "yaml";
-//#region ../../private/utils/src/packageManager/ensurePnpmWorkspaceConfig.ts
-async function ensurePnpmWorkspaceConfig({ mode = "additive", create = false, targetDir = rootDir ?? process.cwd() } = {}) {
-	const filePath = join(targetDir, "pnpm-workspace.yaml");
-	const fileExisted = existsSync(filePath);
-	if (!fileExisted && !create) return;
-	let originalContent = "";
-	let doc;
-	if (fileExisted) {
-		originalContent = await readFile(filePath, "utf-8");
-		doc = parseDocument(originalContent);
-		if (!doc.contents) doc.contents = doc.createNode({});
-		else if (!isMap(doc.contents)) throw new Error(`Cannot sync ${filePath}: the document must contain a YAML mapping`);
-	} else doc = new Document(structuredClone(defaultPnpmWorkspaceConfig));
-	let modified = false;
-	const recordMutation = (message) => {
-		modified = true;
-		console.log(message);
-	};
-	if (!fileExisted) recordMutation("created pnpm-workspace.yaml");
-	const warn = (message) => {
-		console.warn(caution(message));
-	};
-	const context = {
-		doc,
-		mode,
-		recordMutation,
-		warn
-	};
-	removePnpmPluginSku(doc, recordMutation);
-	syncSingleValueSettings(context);
-	syncObjectSettings(context);
-	syncArraySettings(context);
-	if (modified) {
-		const newContent = doc.toString();
-		if (newContent !== originalContent) await writeFile(filePath, newContent, "utf-8");
-	}
-}
-//#endregion
-export { ensurePnpmWorkspaceConfig };

package/dist/private/utils/src/packageManager/pnpmWorkspaceDefaults.mjs

@@ -1,73 +0,0 @@
-//#region ../../private/utils/src/packageManager/pnpmWorkspaceDefaults.ts
-const MANAGED_BY_SKU_MARKER = "[sku_managed]";
-/** Overwritten wholesale by `sku configure`: sku's value always wins. */
-const singleValueSetting = (value, comment) => ({
-	kind: "value",
-	value,
-	comment
-});
-/** A flat map merged per key. Marked keys are sku-owned, the rest are the user's. */
-const objectSetting = (entries) => ({
-	kind: "object",
-	entries
-});
-/** Unioned and deduped. Marked entries are sku-owned, the rest are the user's. */
-const arraySetting = (entries) => ({
-	kind: "array",
-	entries: entries.map((entry) => typeof entry === "string" ? { value: entry } : entry)
-});
-const minutesPerDay = 1440;
-const minimumReleaseAgeInDays = 3;
-/**
-* Sku's recommended pnpm settings. Each entry declares its own value, merge
-* policy and comments, and everything the sync needs is derived from here.
-*/
-const pnpmWorkspaceSettings = {
-	allowBuilds: objectSetting({
-		"@parcel/watcher": true,
-		"@swc/core": true,
-		"core-js-pure": false,
-		esbuild: true,
-		sku: true,
-		"unrs-resolver": true
-	}),
-	blockExoticSubdeps: singleValueSetting(true),
-	minimumReleaseAge: singleValueSetting(minimumReleaseAgeInDays * minutesPerDay, `${minimumReleaseAgeInDays} days`),
-	minimumReleaseAgeExclude: arraySetting([
-		"@braid-design-system/*",
-		"@capsizecss/*",
-		"@seek/*",
-		"@sku-lib/*",
-		"@vanilla-extract/*",
-		"@vocab/*",
-		"braid-design-system",
-		"browserslist-config-seek",
-		"eslint-config-seek",
-		"sku"
-	]),
-	publicHoistPattern: arraySetting(["eslint", "prettier"]),
-	strictDepBuilds: singleValueSetting(false),
-	trustPolicy: singleValueSetting("off"),
-	trustPolicyExclude: arraySetting([{
-		value: "semver@6.3.1",
-		comment: "dependency of eslint-plugin-react"
-	}])
-};
-const keyedSettings = Object.keys(pnpmWorkspaceSettings).map((key) => ({
-	key,
-	...pnpmWorkspaceSettings[key]
-}));
-const singleValueSettings = keyedSettings.filter((setting) => setting.kind === "value");
-const objectSettings = keyedSettings.filter((setting) => setting.kind === "object");
-const arraySettings = keyedSettings.filter((setting) => setting.kind === "array");
-const settingValue = (setting) => {
-	switch (setting.kind) {
-		case "value": return setting.value;
-		case "object": return { ...setting.entries };
-		case "array": return setting.entries.map(({ value }) => value);
-	}
-};
-/** The settings as plain values, for scaffolding a `pnpm-workspace.yaml` from scratch. */
-const defaultPnpmWorkspaceConfig = Object.fromEntries(keyedSettings.map((setting) => [setting.key, settingValue(setting)]));
-//#endregion
-export { MANAGED_BY_SKU_MARKER, arraySettings, defaultPnpmWorkspaceConfig, objectSettings, pnpmWorkspaceSettings, singleValueSettings };

package/dist/private/utils/src/packageManager/removePnpmPluginSku.mjs

@@ -1,19 +0,0 @@
-import { getNodeKey } from "./syncShared.mjs";
-import { isMap, isPair, isSeq } from "yaml";
-//#region ../../private/utils/src/packageManager/removePnpmPluginSku.ts
-/**
-* Removes the pnpm-plugin-sku from the configDependencies in pnpm-workspace.yaml
-*/
-const removePnpmPluginSku = (doc, recordMutation) => {
-	if (!doc.has("configDependencies")) return;
-	const cd = doc.get("configDependencies", true);
-	if (!isMap(cd) && !isSeq(cd)) return;
-	const items = cd.items;
-	const remainingItems = items.filter((item) => getNodeKey(isPair(item) ? item.key : item) !== "pnpm-plugin-sku");
-	if (remainingItems.length === items.length) return;
-	cd.items = remainingItems;
-	recordMutation("removed pnpm-plugin-sku from configDependencies in pnpm-workspace.yaml");
-	if (remainingItems.length === 0) doc.delete("configDependencies");
-};
-//#endregion
-export { removePnpmPluginSku };

package/dist/private/utils/src/packageManager/syncArraySettings.mjs

@@ -1,75 +0,0 @@
-import { MANAGED_BY_SKU_MARKER, arraySettings } from "./pnpmWorkspaceDefaults.mjs";
-import { hasManagedMarker, setManagedComment } from "./syncShared.mjs";
-import { isScalar, isSeq } from "yaml";
-//#region ../../private/utils/src/packageManager/syncArraySettings.ts
-const deduplicateArrayItems = (seqNode, key, context) => {
-	const seenValues = /* @__PURE__ */ new Map();
-	const deduplicatedItems = [];
-	for (const item of seqNode.items) if (isScalar(item) && typeof item.value === "string") {
-		const existingIndex = seenValues.get(item.value);
-		if (existingIndex !== void 0) {
-			const existingItem = deduplicatedItems[existingIndex];
-			if (isScalar(existingItem) && hasManagedMarker(existingItem.comment) && !hasManagedMarker(item.comment)) deduplicatedItems[existingIndex] = item;
-			context.recordMutation(`removed duplicate ${item.value} from ${key} in pnpm-workspace.yaml`);
-			continue;
-		}
-		seenValues.set(item.value, deduplicatedItems.length);
-		deduplicatedItems.push(item);
-	} else deduplicatedItems.push(item);
-	seqNode.items = deduplicatedItems;
-};
-/**
-* Adopts default entries and flags retired ones in an existing array.
-*
-* @returns Whether the item should be removed from the sequence.
-*/
-const processSingleArrayItem = (item, defaultComments, key, context) => {
-	if (!isScalar(item) || typeof item.value !== "string") return false;
-	const val = item.value;
-	if (defaultComments.has(val)) {
-		if (setManagedComment(item, defaultComments.get(val))) context.recordMutation(`adopted ${val} in ${key} in pnpm-workspace.yaml`);
-		return false;
-	}
-	if (hasManagedMarker(item.comment)) {
-		if (context.mode === "enforce") return true;
-		context.warn(`pnpm-workspace.yaml: "${val}" in ${key} is marked with "${MANAGED_BY_SKU_MARKER}", but is no longer a sku default. Run "sku configure" to remove it, or delete its "${MANAGED_BY_SKU_MARKER}" marker to keep it as a user-managed entry.`);
-	}
-	return false;
-};
-const processExistingArrayItems = (seqNode, defaultComments, key, context) => {
-	const indicesToRemove = [];
-	for (const [i, item] of seqNode.items.entries()) if (processSingleArrayItem(item, defaultComments, key, context)) indicesToRemove.push(i);
-	for (const idx of indicesToRemove.toReversed()) {
-		const item = seqNode.items[idx];
-		const val = isScalar(item) ? String(item.value) : "";
-		seqNode.items.splice(idx, 1);
-		context.recordMutation(`removed retired entry ${val} from ${key} in pnpm-workspace.yaml`);
-	}
-};
-const appendMissingArrayDefaults = (seqNode, entries, key, context) => {
-	const existingValues = /* @__PURE__ */ new Set();
-	for (const item of seqNode.items) if (isScalar(item) && typeof item.value === "string") existingValues.add(item.value);
-	for (const { value, comment } of entries) if (!existingValues.has(value)) {
-		const newItem = context.doc.createNode(value);
-		setManagedComment(newItem, comment);
-		seqNode.items.push(newItem);
-		existingValues.add(value);
-		context.recordMutation(`added ${value} to ${key} in pnpm-workspace.yaml`);
-	}
-};
-const syncArraySettings = (context) => {
-	for (const { key, entries } of arraySettings) {
-		const defaultComments = new Map(entries.map(({ value, comment }) => [value, comment]));
-		if (!context.doc.has(key)) {
-			context.doc.set(key, context.doc.createNode([]));
-			context.recordMutation(`added ${key} to pnpm-workspace.yaml`);
-		}
-		const seqNode = context.doc.get(key, true);
-		if (!isSeq(seqNode)) continue;
-		deduplicateArrayItems(seqNode, key, context);
-		processExistingArrayItems(seqNode, defaultComments, key, context);
-		appendMissingArrayDefaults(seqNode, entries, key, context);
-	}
-};
-//#endregion
-export { syncArraySettings };

package/dist/private/utils/src/packageManager/syncObjectSettings.mjs

@@ -1,67 +0,0 @@
-import { MANAGED_BY_SKU_MARKER, objectSettings } from "./pnpmWorkspaceDefaults.mjs";
-import { clearCommentBefore, getNodeKey, hasManagedMarker, setManagedComment } from "./syncShared.mjs";
-import { isMap, isScalar } from "yaml";
-//#region ../../private/utils/src/packageManager/syncObjectSettings.ts
-const markPairAsManaged = (pair, explanatory) => {
-	const modified = setManagedComment(pair.value, explanatory);
-	return clearCommentBefore(pair.key) || modified;
-};
-const syncExistingObjectPair = (pair, key, subKey, defaultVal, context) => {
-	const { doc, mode, recordMutation, warn } = context;
-	if (!isScalar(pair.value)) return;
-	const currentVal = pair.value.value;
-	if (currentVal === defaultVal) {
-		if (markPairAsManaged(pair)) recordMutation(`adopted ${key}.${subKey}: ${String(currentVal)} in pnpm-workspace.yaml`);
-		return;
-	}
-	if (!hasManagedMarker(pair.value.comment)) return;
-	if (mode === "enforce") {
-		pair.value = doc.createNode(defaultVal);
-		setManagedComment(pair.value);
-		clearCommentBefore(pair.key);
-		recordMutation(`updated ${key}.${subKey}: ${String(currentVal)} → ${defaultVal} in pnpm-workspace.yaml`);
-		return;
-	}
-	warn(`pnpm-workspace.yaml: "${key}.${subKey}" has value ${String(currentVal)}, recommended is ${defaultVal}. Run "sku configure" to align.`);
-};
-const syncObjectPair = (mapNode, key, subKey, defaultVal, context) => {
-	const pair = mapNode.items.find((item) => getNodeKey(item.key) === subKey);
-	if (!pair) {
-		const valNode = context.doc.createNode(defaultVal);
-		setManagedComment(valNode);
-		mapNode.set(subKey, valNode);
-		context.recordMutation(`added ${key}.${subKey}: ${defaultVal} to pnpm-workspace.yaml`);
-		return;
-	}
-	syncExistingObjectPair(pair, key, subKey, defaultVal, context);
-};
-const cleanRetiredObjectKeys = (mapNode, key, defaultObj, context) => {
-	const { mode, recordMutation, warn } = context;
-	const itemsToRemove = [];
-	for (const pair of mapNode.items) {
-		const subKey = getNodeKey(pair.key);
-		if (!(subKey in defaultObj)) {
-			if (isScalar(pair.value) && hasManagedMarker(pair.value.comment)) if (mode === "enforce") itemsToRemove.push(subKey);
-			else warn(`pnpm-workspace.yaml: "${subKey}" in ${key} is marked with "${MANAGED_BY_SKU_MARKER}", but is no longer a sku default. Run "sku configure" to remove it, or delete its "${MANAGED_BY_SKU_MARKER}" marker to keep it as a user-managed entry.`);
-		}
-	}
-	for (const subKey of itemsToRemove) {
-		mapNode.delete(subKey);
-		recordMutation(`removed retired entry ${key}.${subKey} from pnpm-workspace.yaml`);
-	}
-};
-const syncObjectSettings = (context) => {
-	const { doc } = context;
-	for (const { key, entries } of objectSettings) {
-		if (!doc.has(key)) {
-			doc.set(key, doc.createNode({}));
-			context.recordMutation(`added ${key} to pnpm-workspace.yaml`);
-		}
-		const mapNode = doc.get(key, true);
-		if (!isMap(mapNode)) continue;
-		for (const [subKey, defaultVal] of Object.entries(entries)) syncObjectPair(mapNode, key, subKey, defaultVal, context);
-		cleanRetiredObjectKeys(mapNode, key, entries, context);
-	}
-};
-//#endregion
-export { syncObjectSettings };

package/dist/private/utils/src/packageManager/syncShared.mjs

@@ -1,21 +0,0 @@
-import { MANAGED_BY_SKU_MARKER } from "./pnpmWorkspaceDefaults.mjs";
-import { isScalar } from "yaml";
-//#region ../../private/utils/src/packageManager/syncShared.ts
-const getNodeKey = (node) => isScalar(node) ? String(node.value) : String(node);
-const hasManagedMarker = (comment) => Boolean(comment?.includes(MANAGED_BY_SKU_MARKER));
-const formatComment = (explanatory) => explanatory ? ` ${explanatory} ${MANAGED_BY_SKU_MARKER}` : ` ${MANAGED_BY_SKU_MARKER}`;
-const clearCommentBefore = (node) => {
-	if (!isScalar(node) || !node.commentBefore) return false;
-	node.commentBefore = void 0;
-	return true;
-};
-const setManagedComment = (node, explanatory) => {
-	if (!isScalar(node)) return false;
-	const comment = formatComment(explanatory);
-	const modified = node.comment !== comment || Boolean(node.commentBefore);
-	node.comment = comment;
-	node.commentBefore = void 0;
-	return modified;
-};
-//#endregion
-export { clearCommentBefore, getNodeKey, hasManagedMarker, setManagedComment };

package/dist/private/utils/src/packageManager/syncSingleValueSettings.mjs

@@ -1,58 +0,0 @@
-import { singleValueSettings } from "./pnpmWorkspaceDefaults.mjs";
-import { clearCommentBefore, getNodeKey, setManagedComment } from "./syncShared.mjs";
-import { isMap, isScalar } from "yaml";
-//#region ../../private/utils/src/packageManager/syncSingleValueSettings.ts
-const findMapPair = (doc, key) => {
-	if (!isMap(doc.contents)) return;
-	return doc.contents.items.find((pair) => getNodeKey(pair.key) === key);
-};
-const markSingleValueAsManaged = (node, explanatory, doc, key) => {
-	const modified = setManagedComment(node, explanatory);
-	const pair = findMapPair(doc, key);
-	return (pair ? clearCommentBefore(pair.key) : false) || modified;
-};
-const handleMatchingSingleValue = (node, explanatory, currentValue, doc, key, context) => {
-	if (isScalar(node)) {
-		if (markSingleValueAsManaged(node, explanatory, doc, key)) context.recordMutation(`adopted ${key}: ${String(currentValue)} in pnpm-workspace.yaml`);
-		return;
-	}
-	const wrapped = doc.createNode(currentValue);
-	setManagedComment(wrapped, explanatory);
-	doc.set(key, wrapped);
-	context.recordMutation(`adopted ${key}: ${String(currentValue)} in pnpm-workspace.yaml`);
-};
-const updateExistingSingleValue = (key, defaultValue, explanatory, context) => {
-	const { doc, mode, recordMutation, warn } = context;
-	const node = doc.get(key, true);
-	const currentValue = isScalar(node) ? node.value : doc.get(key);
-	if (currentValue === defaultValue) {
-		handleMatchingSingleValue(node, explanatory, currentValue, doc, key, context);
-		return;
-	}
-	if (mode === "enforce") {
-		const updatedNode = doc.createNode(defaultValue);
-		setManagedComment(updatedNode, explanatory);
-		doc.set(key, updatedNode);
-		const pair = findMapPair(doc, key);
-		if (pair) clearCommentBefore(pair.key);
-		recordMutation(`updated ${key}: ${String(currentValue)} → ${defaultValue} in pnpm-workspace.yaml`);
-		return;
-	}
-	warn(`pnpm-workspace.yaml: "${key}" has value ${String(currentValue)}, recommended is ${defaultValue}. Run "sku configure" to align.`);
-};
-const syncSingleValue = ({ key, value: defaultValue, comment }, context) => {
-	const { doc, recordMutation } = context;
-	if (!doc.has(key)) {
-		const node = doc.createNode(defaultValue);
-		setManagedComment(node, comment);
-		doc.set(key, node);
-		recordMutation(`added ${key}: ${defaultValue} to pnpm-workspace.yaml`);
-		return;
-	}
-	updateExistingSingleValue(key, defaultValue, comment, context);
-};
-const syncSingleValueSettings = (context) => {
-	for (const setting of singleValueSettings) syncSingleValue(setting, context);
-};
-//#endregion
-export { syncSingleValueSettings };

package/dist/services/vite/ssr/Document.mjs

@@ -1,24 +0,0 @@
-import { SSR_CSS_VIRTUAL_HREF } from "../plugins/ssrCss/constants.mjs";
-import { jsx, jsxs } from "react/jsx-runtime";
-//#region src/services/vite/ssr/Document.tsx
-const Document = ({ children, assets }) => /* @__PURE__ */ jsxs("html", {
-	lang: "en",
-	children: [/* @__PURE__ */ jsxs("head", { children: [
-		/* @__PURE__ */ jsx("meta", { charSet: "utf-8" }),
-		/* @__PURE__ */ jsx("meta", {
-			name: "viewport",
-			content: "width=device-width, initial-scale=1"
-		}),
-		assets.modulePreloads.map((href) => /* @__PURE__ */ jsx("link", {
-			rel: "modulepreload",
-			href
-		}, href)),
-		assets.css.map((href) => /* @__PURE__ */ jsx("link", {
-			rel: "stylesheet",
-			href,
-			...href === SSR_CSS_VIRTUAL_HREF ? { "data-ssr-css": true } : {}
-		}, href))
-	] }), /* @__PURE__ */ jsx("body", { children })]
-});
-//#endregion
-export { Document };