@yahoo/uds-create-config 5.60.5 → 5.61.0

package/dist/configs/system.js

@@ -31,6 +31,7 @@ import { cssContentScriptsMigration } from "../migrations/20261022152120_css_con
 import { linkTypeMigration } from "../migrations/20261022184639_link_type.js";
 import { conditionalDefaultsMigration } from "../migrations/20261023152030_conditional_defaults.js";
 import { timingValueMigration } from "../migrations/20261026125912_timing_value.js";
+import { variantValuesListWithBodiesMigration } from "../migrations/20261027184442_variant_values_list_with_bodies.js";
 import { CanvasRole } from "../entities/system/CanvasRole.js";
 import { GlobalStyle } from "../entities/system/GlobalStyle.js";
 import { Guidance } from "../entities/system/Guidance.js";
@@ -195,5 +196,6 @@ if (!registeredSchemaMigrations().has(20261022152120)) registerSchemaMigrations(
 if (!registeredSchemaMigrations().has(20261022184639)) registerSchemaMigrations(linkTypeMigration);
 if (!registeredSchemaMigrations().has(20261023152030)) registerSchemaMigrations(conditionalDefaultsMigration);
 if (!registeredSchemaMigrations().has(20261026125912)) registerSchemaMigrations(timingValueMigration);
+if (!registeredSchemaMigrations().has(20261027184442)) registerSchemaMigrations(variantValuesListWithBodiesMigration);
 //#endregion
 export { System };

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

@@ -69,6 +69,15 @@ declare const variantValueFields: z.ZodObject<{
 type VariantValueBody = z.infer<typeof variantValueFields>;
 /** A variant prop's own values — name → body, in the order they were declared. */
 type VariantValues = Record<string, VariantValueBody>;
+/** One value in the list form of a variant's values: a bare name, or the name with its body. */
+declare const listedVariantValue: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+  label: z.ZodOptional<z.ZodString>;
+  description: z.ZodOptional<z.ZodString>;
+  deprecated: z.ZodOptional<z.ZodBoolean>;
+  value: z.ZodString;
+}, z.core.$strict>]>;
+/** One value as the list form writes it — `'sm'`, or `{ value: 'md', label: 'Medium' }`. */
+type ListedVariantValue = z.input<typeof listedVariantValue>;
 declare const VariantValueDefinition: SubEntityClass<z.ZodObject<{
   label: z.ZodOptional<z.ZodString>;
   description: z.ZodOptional<z.ZodString>;
@@ -103,9 +112,23 @@ declare const propShapeDefinition: z.ZodDiscriminatedUnion<[z.ZodObject<{
   }, z.core.$strip>]>>]>>>;
 }, z.core.$strict>, z.ZodObject<{
   type: z.ZodLiteral<"variant">;
-  value: z.ZodUnion<readonly [z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<{
-    [k: string]: {};
-  }, string[]>>, z.ZodArray<z.ZodObject<{
+  value: z.ZodUnion<readonly [z.ZodPipe<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+    label: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    deprecated: z.ZodOptional<z.ZodBoolean>;
+    value: z.ZodString;
+  }, z.core.$strict>]>>, z.ZodTransform<{
+    [k: string]: {
+      label?: string | undefined;
+      description?: string | undefined;
+      deprecated?: boolean | undefined;
+    };
+  }, (string | {
+    value: string;
+    label?: string | undefined;
+    description?: string | undefined;
+    deprecated?: boolean | undefined;
+  })[]>>, z.ZodArray<z.ZodObject<{
     __ref: z.ZodString;
   }, z.core.$strip>>, z.ZodObject<{
     __ref: z.ZodString;
@@ -1004,4 +1027,4 @@ interface ComponentClass extends Omit<typeof ComponentEntity, 'ref' | 'item'> {
   instance: typeof instanceAt;
 }
 //#endregion
-export { AnatomyNodeClass, AuthoredPropBody, Component, ComponentBody, ComponentClass, ComponentCreateInput, ComponentElementBody, ComponentItemInput, ComponentPropBody, ComponentReference, ComponentStyleBody, ContractStyleRules, ElementVisibility, ElementVisibilityInput, ElementVisibilitySchema, ExtendedComponentRef, ForwardClass, LayerClass, ProjectedVisibility, PropClass, PropShapeSchema, SLOT_CODE_FORMS, VariantValueBody, VariantValues, blankComponentBody, canonicalWhen, forwardedNames, layerRef, ownValues, ownsItsValues, valueRef };
+export { AnatomyNodeClass, AuthoredPropBody, Component, ComponentBody, ComponentClass, ComponentCreateInput, ComponentElementBody, ComponentItemInput, ComponentPropBody, ComponentReference, ComponentStyleBody, ContractStyleRules, ElementVisibility, ElementVisibilityInput, ElementVisibilitySchema, ExtendedComponentRef, ForwardClass, LayerClass, ListedVariantValue, ProjectedVisibility, PropClass, PropShapeSchema, SLOT_CODE_FORMS, VariantValueBody, VariantValues, blankComponentBody, canonicalWhen, forwardedNames, layerRef, ownValues, ownsItsValues, valueRef };

package/dist/entities/system/Component.js

@@ -335,19 +335,30 @@ function declaringForwardRefs(config, element, value) {
 	});
 }
 const Forward = ForwardDefinition;
+/**
+* One value a variant prop offers — the keyed collection under its `value`.
+*
+* Keyed rather than a list of names, for the three things a bare string can't be: it can't be
+* reordered without rewriting every other value beside it, it can't carry what to call it in a
+* picker, and it can't be renamed by the ordinary cascade — which is what a keyed collection gets
+* from the framework, the same one `layers` and `props` are.
+*/
+const variantValueFields = z.strictObject({
+	/** What to call it, and what it's for, where it is offered — a picker row, the AI's catalogue.
+	*  The name is an identifier and reads like one (`ui6`, `xs`); this is the human half. */
+	label: z.string().optional(),
+	description: z.string().optional(),
+	/** Withdrawn from new work, exactly as a component's own `deprecated` is: still valid wherever
+	*  it is already used, left out of surfaces that offer values. The alternative to deleting it,
+	*  which takes its styling with it. */
+	deprecated: z.boolean().optional()
+});
+/** One value in the list form of a variant's values: a bare name, or the name with its body. */
+const listedVariantValue = z.union([z.string(), variantValueFields.extend({ value: z.string() })]);
 const VariantValue = defineSubEntity({
 	name: "value",
 	label: "Value",
-	fields: z.strictObject({
-		/** What to call it, and what it's for, where it is offered — a picker row, the AI's catalogue.
-		*  The name is an identifier and reads like one (`ui6`, `xs`); this is the human half. */
-		label: z.string().optional(),
-		description: z.string().optional(),
-		/** Withdrawn from new work, exactly as a component's own `deprecated` is: still valid wherever
-		*  it is already used, left out of surfaces that offer values. The alternative to deleting it,
-		*  which takes its styling with it. */
-		deprecated: z.boolean().optional()
-	}),
+	fields: variantValueFields,
 	namedValuesIn: [
 		"defaultProps",
 		"preview/*/props",
@@ -363,17 +374,23 @@ const VariantValue = defineSubEntity({
 * A variant's domain: the values it owns, a ref that delegates to whatever owns them, or a list of
 * refs whose leaves are unioned (an icon prop drawing from two libraries through one component).
 *
-* The string-array form is what an author writes (`['solid', 'ghost']`) and is coerced here into
-* the collection it is stored as, so every reader below this line sees one shape. In the schema
+* The list form is what an author writes (`['solid', 'ghost']`, with `{ value: 'outline', label }` for
+* a value that carries a body) and is coerced here into the collection it is stored as, so every
+* reader below this line sees one shape. In the schema
 * rather than in the authoring adapter because there are four doors into stored state — `register`,
 * an item create/update, a sub-op, and the artifact loader — and a coercion outside the schema only
 * covers the one it is written in.
 *
-* The two list arms are disjoint: a string fails `refSchema` and a ref fails `z.string()`. Only the
-* empty list could land on either, and it lands on the string list, which coerces it to `{}`.
+* The two list arms are disjoint: a ref fails both members of the value list, and a value fails
+* `refSchema`. Only the empty list could land on either, and it lands on the value list, which
+* coerces it to `{}`.
 */
 const variantDomain = z.union([
-	z.array(z.string()).transform((names) => Object.fromEntries(names.map((name) => [name, {}]))),
+	z.array(listedVariantValue).transform((values) => Object.fromEntries(values.map((entry) => {
+		if (typeof entry === "string") return [entry, {}];
+		const { value, ...body } = entry;
+		return [value, body];
+	}))),
 	z.array(refSchema).min(1),
 	refSchema,
 	VariantValue
@@ -541,7 +558,7 @@ const PROP_TYPES = [
 	"number",
 	"boolean"
 ];
-const PROP_DESCRIPTION = "What the prop is. A style property the component exposes, `{ \"type\": \"styleProperty\", \"value\": { \"__ref\": \"style-property:<name>\" } }`, which is what a primitive's props mostly are and what makes a style rule's bag key valid on it; a closed set of names a style rule keys on, `{ \"type\": \"variant\", \"value\": [\"sm\", \"lg\"] }`; content, `{ \"type\": \"slot\", \"text\": true }`, or a slot whose own value is a library member, `{ \"type\": \"slot\", \"value\": { \"__ref\": \"icon:<library>\" } }`, which code may also fill with the forms it lists under `code` (`[\"node\", \"element\", \"render\"]`); or a plain `string`, `number` or `boolean`. `null` hides a prop an inherited layer would expose. A prop that applies only under a condition on a sibling carries `when`, the record a style rule uses: `{ \"type\": \"string\", \"when\": { \"type\": \"color\" } }` shows it for one value, `{ \"when\": { \"type\": [\"default\", \"header\"] } }` for several.";
+const PROP_DESCRIPTION = "What the prop is. A style property the component exposes, `{ \"type\": \"styleProperty\", \"value\": { \"__ref\": \"style-property:<name>\" } }`, which is what a primitive's props mostly are and what makes a style rule's bag key valid on it; a closed set of names a style rule keys on, `{ \"type\": \"variant\", \"value\": [\"sm\", \"lg\"] }`, where a value that carries a label is written in place as `{ \"value\": \"md\", \"label\": \"Medium\" }`; content, `{ \"type\": \"slot\", \"text\": true }`, or a slot whose own value is a library member, `{ \"type\": \"slot\", \"value\": { \"__ref\": \"icon:<library>\" } }`, which code may also fill with the forms it lists under `code` (`[\"node\", \"element\", \"render\"]`); or a plain `string`, `number` or `boolean`. `null` hides a prop an inherited layer would expose. A prop that applies only under a condition on a sibling carries `when`, the record a style rule uses: `{ \"type\": \"string\", \"when\": { \"type\": \"color\" } }` shows it for one value, `{ \"when\": { \"type\": [\"default\", \"header\"] } }` for several.";
 const Prop = defineSubEntity({
 	name: "prop",
 	label: "Prop",

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

@@ -6,7 +6,7 @@ import { StyleValue } from "./style-bag.js";
 import { StylePropertyClass } from "./StyleProperty.js";
 import { ComponentSourceInput } from "./component-source-fields.js";
 import { PropsOrRules } from "./prop-rules.js";
-import { VariantValues } from "./Component.js";
+import { ListedVariantValue, VariantValues } from "./Component.js";
 import { AllHTMLAttributes, ComponentPropsWithRef, ComponentType, ElementType, JSX, ReactElement, ReactNode, Ref } from "react";
 
 //#region src/entities/system/defineComponent.d.ts
@@ -189,7 +189,7 @@ interface ForwardDecl<Path extends string = string> {
  */
 type PropDecl<Path extends string = string> = SlotDecl | ForwardDecl<Path> | {
   type: 'variant';
-  value: readonly string[] | VariantValues | Ref$1 | readonly Ref$1[];
+  value: readonly ListedVariantValue[] | VariantValues | Ref$1 | readonly Ref$1[];
   required?: boolean;
   when?: PropCondition;
 } | {
@@ -356,7 +356,9 @@ type StylePropValue<Target extends string> = Target extends keyof RegisteredStyl
  */
 type DomainValueOf<V> = V extends readonly {
   __ref: `icon:${string}`;
-}[] ? GlyphComponent : V extends readonly Ref$1[] ? string : V extends readonly (infer Member)[] ? Member : V extends VariantValues ? keyof V & string : V extends {
+}[] ? GlyphComponent : V extends readonly Ref$1[] ? string : V extends readonly (infer Member)[] ? Member extends {
+  value: infer Name;
+} ? Name : Member : V extends VariantValues ? keyof V & string : V extends {
   __ref: `${string}#${string}`;
 } ? string : V extends {
   __ref: `icon:${string}`;

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 = 20261026125912;
+declare const SERIALIZED_CONFIG_VERSION = 20261027184442;
 interface SerializedConfig {
   /** See {@link SERIALIZED_CONFIG_VERSION}. Always written; a stored artifact may lack it. */
   readonly version: number;

package/dist/framework/Config.js

@@ -6257,7 +6257,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 > 20261026125912) throw new SchemaVersionTooNew(claimed);
+		if (claimed > 20261027184442) 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 = 20261026125912;
+declare const CURRENT_SCHEMA_VERSION = 20261027184442;
 /** 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 = 20261026125912;
+const CURRENT_SCHEMA_VERSION = 20261027184442;
 /** 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 > 20261026125912) 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 > 20261027184442) 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 ?? 20261026125912;
+	const target = options?.target ?? 20261027184442;
 	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 ?? 20261026125912;
+	const target = options?.target ?? 20261027184442;
 	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 ?? 20261026125912;
+	const target = options?.target ?? 20261027184442;
 	const entries = [];
 	const held = [];
 	const retired = [];

package/dist/migrations/20261027184442_variant_values_list_with_bodies.d.ts

@@ -0,0 +1,7 @@
+/** A variant's list of values may give a value its body in place, `['sm', { value: 'md', label:
+ * 'Medium' }]`, beside bare names. The list is coerced into the stored collection as before, so stored
+ * configs and draft patches keep their meaning. Retire this identity hop only when no supported
+ * artifact predates this schema. */
+import type { SchemaMigration } from '../framework/schema-version';
+export declare const VARIANT_VALUES_LIST_WITH_BODIES_VERSION = 20261027184442;
+export declare const variantValuesListWithBodiesMigration: SchemaMigration;

package/dist/migrations/20261027184442_variant_values_list_with_bodies.js

@@ -0,0 +1,8 @@
+//#region src/migrations/20261027184442_variant_values_list_with_bodies.ts
+const VARIANT_VALUES_LIST_WITH_BODIES_VERSION = 20261027184442;
+const variantValuesListWithBodiesMigration = {
+	version: VARIANT_VALUES_LIST_WITH_BODIES_VERSION,
+	up: (json) => json
+};
+//#endregion
+export { VARIANT_VALUES_LIST_WITH_BODIES_VERSION, variantValuesListWithBodiesMigration };