@yahoo/uds-create-config 5.41.8 → 5.42.0

package/dist/migrations/20261019165323_build_exclude.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `settings.build.include` leaves the build settings, and `settings.build.exclude` joins them.
+ *
+ * A system now ships every source file under its `inputDir` by default, so the list of files to ship
+ * that no component imports has nothing left to name: each one it could name ships without it.
+ * `exclude` keeps a file out instead. `up` drops a stored `include`, and `upPatch` drops it from a
+ * stored draft patch, a patch that wrote nothing else going with it. Nothing reads the field any
+ * more, so its value has nowhere to land; the files it named still ship, as every file under
+ * `inputDir` does.
+ *
+ * A `uds.config.ts` that still writes `include` is refused when it is evaluated, by the build
+ * settings' own schema, with a message saying to delete it.
+ */
+import type { RawWireConfig, SchemaMigration } from '../framework/schema-version';
+export declare const BUILD_EXCLUDE_VERSION = 20261019165323;
+export declare function dropBuildInclude(json: RawWireConfig): RawWireConfig;
+export declare const buildExcludeMigration: SchemaMigration;

package/dist/migrations/20261019165323_build_exclude.js

@@ -0,0 +1,81 @@
+import { isPlainObject } from "../framework/utils/field-path.js";
+import { z } from "zod";
+//#region src/migrations/20261019165323_build_exclude.ts
+/**
+* `settings.build.include` leaves the build settings, and `settings.build.exclude` joins them.
+*
+* A system now ships every source file under its `inputDir` by default, so the list of files to ship
+* that no component imports has nothing left to name: each one it could name ships without it.
+* `exclude` keeps a file out instead. `up` drops a stored `include`, and `upPatch` drops it from a
+* stored draft patch, a patch that wrote nothing else going with it. Nothing reads the field any
+* more, so its value has nowhere to land; the files it named still ship, as every file under
+* `inputDir` does.
+*
+* A `uds.config.ts` that still writes `include` is refused when it is evaluated, by the build
+* settings' own schema, with a message saying to delete it.
+*/
+const BUILD_EXCLUDE_VERSION = 20261019165323;
+/** A record with `key` taken out, or the record itself when it has none. */
+function without(record, key) {
+	if (!(key in record)) return record;
+	const { [key]: _dropped, ...rest } = record;
+	return rest;
+}
+/** The settings body with `build.include` taken out, or the body itself when it has none. */
+function settingsWithoutInclude(settings) {
+	if (!isPlainObject(settings.build) || !("include" in settings.build)) return settings;
+	return {
+		...settings,
+		build: without(settings.build, "include")
+	};
+}
+function dropBuildInclude(json) {
+	const items = json.items;
+	if (!isPlainObject(items) || !isPlainObject(items.settings)) return json;
+	const item = items.settings.settings;
+	if (!isPlainObject(item)) return json;
+	const next = settingsWithoutInclude(item);
+	if (next === item) return json;
+	return {
+		...json,
+		items: {
+			...items,
+			settings: {
+				...items.settings,
+				settings: next
+			}
+		}
+	};
+}
+/** The envelope this reads, loose, asserting only the item it edits. */
+const before = z.looseObject({ items: z.looseObject({ settings: z.record(z.string(), z.unknown()).optional() }).optional() });
+/** What it produces: no stored `build.include`. */
+const after = before.refine((json) => {
+	const item = json.items?.settings?.settings;
+	return !(isPlainObject(item) && isPlainObject(item.build) && "include" in item.build);
+}, { message: "no stored `settings.build.include`" });
+/**
+* A settings patch writes `include` three ways: in a body (`create`, `replace`, or `update` with a
+* `build` record), as a field path (`update` with `build.include`), or as a member of the `build`
+* section (`sub-*` with `field: 'build'`). Each loses it, and a patch left writing nothing is dropped.
+*/
+function patchWithoutInclude(patch) {
+	if (patch.kind !== "settings" || !("data" in patch)) return patch;
+	if (!isPlainObject(patch.data)) return patch;
+	const data = "field" in patch ? patch.field === "build" ? without(patch.data, "include") : patch.data : without(settingsWithoutInclude(patch.data), "build.include");
+	if (data === patch.data) return patch;
+	if ((Object.keys(data).length === 0 || Object.keys(data).length === 1 && isPlainObject(data.build) && Object.keys(data.build).length === 0) && patch.operation !== "create") return null;
+	return {
+		...patch,
+		data
+	};
+}
+const buildExcludeMigration = {
+	version: BUILD_EXCLUDE_VERSION,
+	up: dropBuildInclude,
+	upPatch: patchWithoutInclude,
+	fromSchema: before,
+	toSchema: after
+};
+//#endregion
+export { BUILD_EXCLUDE_VERSION, buildExcludeMigration };