@yahoo/uds-create-config 5.75.0 → 5.76.0

package/dist/configs/build-options.js

@@ -129,6 +129,16 @@ const buildFields = z.strictObject({
 		title: "React version",
 		description: `The React major the app this repo builds for runs. \`18\` wraps each emitted web component in \`forwardRef\`, so a call site's \`ref\` reaches its element. Unset, \`${BUILD_DEFAULTS.react}\`.`,
 		default: BUILD_DEFAULTS.react
+	}).optional(),
+	/**
+	* Whether the component modules `uds build` writes carry the component data attributes:
+	* `data-uds-component`, `data-uds-layer` and `data-uds-slot`, which Create's tools read to map an
+	* app's rendered markup back to its components. Unset, off; `uds build --debug` turns it on for
+	* one build.
+	*/
+	debug: z.boolean().meta({
+		title: "Debug",
+		description: "Have `uds build` write the component data attributes (`data-uds-component`, `data-uds-layer`, `data-uds-slot`) on the elements components render. Create's tools read them to map the app's rendered markup back to its components, such as the canvas capture rebuilding a page as components. Unset, off; `uds build --debug` turns it on for one build."
 	}).optional()
 }, { error: (issue) => issue.code === "unrecognized_keys" && issue.keys.includes("include") ? "`settings.build.include` was removed: every source file under `inputDir` now ships by default. Delete it, and list any file to keep out in `settings.build.exclude`." : void 0 });
 //#endregion

package/dist/configs/react-native-system.d.ts

@@ -42,6 +42,7 @@ declare const ReactNativeSystemDefinition: ConfigClass<{
       outputAlias: _$zod.ZodOptional<_$zod.ZodString>;
       linkedDir: _$zod.ZodOptional<_$zod.ZodString>;
       react: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodLiteral<18>, _$zod.ZodLiteral<19>]>>;
+      debug: _$zod.ZodOptional<_$zod.ZodBoolean>;
     }, _$zod_v4_core0.$strict>>;
     css: _$zod.ZodOptional<_$zod.ZodObject<{
       prefix: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodString, _$zod.ZodObject<{

package/dist/configs/system.js

@@ -39,6 +39,7 @@ import { defaultColorsMigration } from "../migrations/20261102143821_default_col
 import { linkReplaceMigration } from "../migrations/20261102185610_link_replace.js";
 import { mapPropsFromMigration } from "../migrations/20261102193912_map_props_from.js";
 import { sourcesAuthoringMigration } from "../migrations/20261103115059_sources_authoring.js";
+import { buildDebugMigration } from "../migrations/20261104151013_build_debug.js";
 import { CanvasRole } from "../entities/system/CanvasRole.js";
 import { GlobalStyle } from "../entities/system/GlobalStyle.js";
 import { Guidance } from "../entities/system/Guidance.js";
@@ -214,5 +215,6 @@ if (!registeredSchemaMigrations().has(20261102143821)) registerSchemaMigrations(
 if (!registeredSchemaMigrations().has(20261102185610)) registerSchemaMigrations(linkReplaceMigration);
 if (!registeredSchemaMigrations().has(20261102193912)) registerSchemaMigrations(mapPropsFromMigration);
 if (!registeredSchemaMigrations().has(20261103115059)) registerSchemaMigrations(sourcesAuthoringMigration);
+if (!registeredSchemaMigrations().has(20261104151013)) registerSchemaMigrations(buildDebugMigration);
 //#endregion
 export { System };

package/dist/entities/native/NativeSettings.d.ts

@@ -31,6 +31,7 @@ declare const NativeSettings: EntityClass<z.ZodObject<Omit<{
     outputAlias: z.ZodOptional<z.ZodString>;
     linkedDir: z.ZodOptional<z.ZodString>;
     react: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<18>, z.ZodLiteral<19>]>>;
+    debug: z.ZodOptional<z.ZodBoolean>;
   }, z.core.$strict>>;
   css: z.ZodOptional<z.ZodObject<{
     prefix: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{

package/dist/entities/system/Settings.d.ts

@@ -24,6 +24,7 @@ declare const BuildSectionDefinition: SubEntityClass<z.ZodObject<{
   outputAlias: z.ZodOptional<z.ZodString>;
   linkedDir: z.ZodOptional<z.ZodString>;
   react: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<18>, z.ZodLiteral<19>]>>;
+  debug: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>>;
 interface BuildSectionClass extends Named<typeof BuildSectionDefinition> {}
 declare const BuildSection: BuildSectionClass;
@@ -194,6 +195,7 @@ declare const SettingsDefinition: EntityClass<z.ZodObject<{
     outputAlias: z.ZodOptional<z.ZodString>;
     linkedDir: z.ZodOptional<z.ZodString>;
     react: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<18>, z.ZodLiteral<19>]>>;
+    debug: z.ZodOptional<z.ZodBoolean>;
   }, z.core.$strict>>;
   css: z.ZodOptional<z.ZodObject<{
     prefix: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{

package/dist/framework/Config.d.ts

@@ -74,7 +74,7 @@ interface RecordedSource {
  * The dense-counter `2` a short-lived scheme stamped before the chain existed reads as the mint
  * that replaced it (see `detectedWireVersion`).
  */
-declare const SERIALIZED_CONFIG_VERSION = 20261103115059;
+declare const SERIALIZED_CONFIG_VERSION = 20261104151013;
 interface SerializedConfig {
   /** See {@link SERIALIZED_CONFIG_VERSION}. Always written; a stored artifact may lack it. */
   readonly version: number;

package/dist/framework/Config.js

@@ -6406,7 +6406,7 @@ var Config = class Config {
 	*  links from the provided sources. A declared `linkedKind` with no provided source throws. */
 	hydrateFrom(stored, options) {
 		const claimed = schemaVersionOf(stored);
-		if (claimed > 20261103115059) throw new SchemaVersionTooNew(claimed);
+		if (claimed > 20261104151013) throw new SchemaVersionTooNew(claimed);
 		const wire = upgradeSerializedConfig(stored);
 		if (!Array.isArray(wire.ownedKinds) || typeof wire.items !== "object" || wire.items === null) throw new ConfigFormatError(`Config "${stored.name ?? "system-config"}" cannot be hydrated: this is not a serialized config-v2 config (no "ownedKinds"/"items"). A pre-cutover build artifact converts through the registered cutover migration — import the config type's module (e.g. \`configs/system\`) before hydrating.`);
 		const leftover = wire.options;

package/dist/framework/schema-version.d.ts

@@ -15,7 +15,7 @@ import { Patch, SerializedConfig } from "./Config.js";
  * sets this constant to its own older timestamp; the merge ref then carries a registered migration
  * newer than the constant, and the assertion fails until the author re-mints.
  */
-declare const CURRENT_SCHEMA_VERSION = 20261103115059;
+declare const CURRENT_SCHEMA_VERSION = 20261104151013;
 /** What the walkers need to see of an envelope — loose on purpose, so a typed `SerializedConfig`
  *  and a raw old-shape record both flow in without casts. */
 interface VersionStamped {

package/dist/framework/schema-version.js

@@ -13,7 +13,7 @@ import { ConfigFormatError } from "./rejection.js";
 * sets this constant to its own older timestamp; the merge ref then carries a registered migration
 * newer than the constant, and the assertion fails until the author re-mints.
 */
-const CURRENT_SCHEMA_VERSION = 20261103115059;
+const CURRENT_SCHEMA_VERSION = 20261104151013;
 /** The mint that moved `options` into the `settings` kind — restated here, rather than imported
 *  from the migration that owns it, because that migration imports this module. */
 const SETTINGS_AS_KIND_VERSION = 20260908171448;
@@ -45,7 +45,7 @@ function registerSchemaMigrations(...migrations) {
 	for (const migration of migrations) {
 		if (migration.version !== 1 && !isMintTimestamp(migration.version)) throw new Error(`Schema migration version ${migration.version} is not a mint timestamp — mint one with \`date +%Y%m%d%H%M%S\`, like a supabase migration.`);
 		if (REGISTERED.has(migration.version)) throw new Error(`A schema migration at version ${migration.version} is already registered.`);
-		if (migration.version > 20261103115059) throw new Error(`Schema migration ${migration.version} is newer than CURRENT_SCHEMA_VERSION (${CURRENT_SCHEMA_VERSION}) — a stale branch merged, or the mint forgot to bump the constant. Re-mint: set CURRENT_SCHEMA_VERSION to the newest migration version.`);
+		if (migration.version > 20261104151013) throw new Error(`Schema migration ${migration.version} is newer than CURRENT_SCHEMA_VERSION (${CURRENT_SCHEMA_VERSION}) — a stale branch merged, or the mint forgot to bump the constant. Re-mint: set CURRENT_SCHEMA_VERSION to the newest migration version.`);
 		REGISTERED.set(migration.version, migration);
 	}
 }
@@ -102,7 +102,7 @@ function pendingFor(version, target, options) {
 * Already-current input passes through untouched — same reference, so hot paths pay nothing.
 */
 function upgradeSerializedConfig(json, options) {
-	const target = options?.target ?? 20261103115059;
+	const target = options?.target ?? 20261104151013;
 	const version = detectedWireVersion(json);
 	if (version > target) throw new SchemaVersionTooNew(version, target);
 	const raw = json;
@@ -160,7 +160,7 @@ function upgradedSources(json, options) {
 * meaning under the current schema and replay skips it — reported by the caller, not swallowed here.
 */
 function upgradePatch(patch, writtenAt, options) {
-	const target = options?.target ?? 20261103115059;
+	const target = options?.target ?? 20261104151013;
 	if (writtenAt > target) throw new SchemaVersionTooNew(writtenAt, target);
 	let current = patch;
 	for (const migration of pendingFor(writtenAt, target, options)) {
@@ -179,7 +179,7 @@ function upgradePatch(patch, writtenAt, options) {
 * stamp would cause.
 */
 function upgradeDraftEntries(draft, options) {
-	const target = options?.target ?? 20261103115059;
+	const target = options?.target ?? 20261104151013;
 	const entries = [];
 	const held = [];
 	const retired = [];

package/dist/migrations/20261104151013_build_debug.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Additions only, so the envelope passes through as it is:
+ *
+ * - A system's `settings.build` may name `debug`: whether the component modules `uds build` writes
+ *   carry the component data attributes.
+ */
+import type { SchemaMigration } from '../framework/schema-version';
+export declare const BUILD_DEBUG_VERSION = 20261104151013;
+export declare const buildDebugMigration: SchemaMigration;

package/dist/migrations/20261104151013_build_debug.js

@@ -0,0 +1,10 @@
+//#region src/migrations/20261104151013_build_debug.ts
+const BUILD_DEBUG_VERSION = 20261104151013;
+const buildDebugMigration = {
+	version: BUILD_DEBUG_VERSION,
+	up(json) {
+		return json;
+	}
+};
+//#endregion
+export { BUILD_DEBUG_VERSION, buildDebugMigration };