@yahoo/uds-create-config 4.23.3 → 4.24.0

package/dist/configs/system.d.ts

@@ -16,6 +16,7 @@ import { listSlots, namedSlots, slotHostedBy, slotOf } from "../spec/slot.js";
 import { cellAt } from "../spec/cell.js";
 import { instanceAt } from "../spec/instance.js";
 import { ComposedValue } from "../entities/system/composed-values.js";
+import { DerivedColor } from "../entities/system/color.js";
 import { StyleValue } from "../entities/system/style-bag.js";
 import { OverrideCondition, TokenRefPath, TokenReference } from "../entities/system/Token.js";
 import { ComponentElementBody, ComponentReference, ComponentStyleBody } from "../entities/system/Component.js";
@@ -1667,19 +1668,20 @@ declare const System: ConfigClass<{
   }, Record<never, never>, false, Record<never, never>, Record<never, never>>;
   globalStyles: EntityClass<_$zod.ZodObject<{
     selector: _$zod.ZodString;
-    declarations: _$zod.ZodRecord<_$zod.ZodString, _$zod.ZodType<string | number | {
+    declarations: _$zod.ZodRecord<_$zod.ZodString, _$zod.ZodType<string | number | DerivedColor | {
       __ref: string;
     } | {
-      [key: string]: string | number | {
+      [key: string]: string | number | DerivedColor | {
         __ref: string;
       } | /*elided*/any;
-    }, unknown, _$zod_v4_core0.$ZodTypeInternals<string | number | {
+    }, unknown, _$zod_v4_core0.$ZodTypeInternals<string | number | DerivedColor | {
       __ref: string;
     } | {
-      [key: string]: string | number | {
+      [key: string]: string | number | DerivedColor | {
         __ref: string;
       } | /*elided*/any;
     }, unknown>>>;
+    important: _$zod.ZodOptional<_$zod.ZodBoolean>;
   }, _$zod_v4_core0.$strict>, _$zod.ZodObject<Record<never, never>, _$zod_v4_core0.$strip>, "global-style", Record<never, never>, Record<never, never>, false, Record<never, never>, Record<never, never>>;
   devices: EntityClass<_$zod.ZodObject<{
     width: _$zod.ZodNumber;
@@ -3728,19 +3730,20 @@ declare const System: ConfigClass<{
     }, Record<never, never>, false, Record<never, never>, Record<never, never>>;
     globalStyles: EntityClass<_$zod.ZodObject<{
       selector: _$zod.ZodString;
-      declarations: _$zod.ZodRecord<_$zod.ZodString, _$zod.ZodType<string | number | {
+      declarations: _$zod.ZodRecord<_$zod.ZodString, _$zod.ZodType<string | number | DerivedColor | {
         __ref: string;
       } | {
-        [key: string]: string | number | {
+        [key: string]: string | number | DerivedColor | {
           __ref: string;
         } | /*elided*/any;
-      }, unknown, _$zod_v4_core0.$ZodTypeInternals<string | number | {
+      }, unknown, _$zod_v4_core0.$ZodTypeInternals<string | number | DerivedColor | {
         __ref: string;
       } | {
-        [key: string]: string | number | {
+        [key: string]: string | number | DerivedColor | {
           __ref: string;
         } | /*elided*/any;
       }, unknown>>>;
+      important: _$zod.ZodOptional<_$zod.ZodBoolean>;
     }, _$zod_v4_core0.$strict>, _$zod.ZodObject<Record<never, never>, _$zod_v4_core0.$strip>, "global-style", Record<never, never>, Record<never, never>, false, Record<never, never>, Record<never, never>>;
     devices: EntityClass<_$zod.ZodObject<{
       width: _$zod.ZodNumber;

package/dist/configs/system.js

@@ -39,6 +39,7 @@ import { iconCanvasToolMigration } from "../migrations/20260923005318_icon_canva
 import { computedValuesAndRepeatedNodesMigration } from "../migrations/20260923112910_computed_values_and_repeated_nodes.js";
 import { transitionTokenValueMigration } from "../migrations/20260923144958_transition_token_value.js";
 import { renderTokenRefsMigration } from "../migrations/20260923160425_render_token_refs.js";
+import { globalStyleDerivedColorsMigration } from "../migrations/20260923163604_global_style_derived_colors.js";
 //#region src/configs/system.ts
 /**
 * `System` — the design-system config TYPE. Declares the exact kinds a design system owns (tokens,
@@ -98,5 +99,6 @@ if (!registeredSchemaMigrations().has(20260923005318)) registerSchemaMigrations(
 if (!registeredSchemaMigrations().has(20260923112910)) registerSchemaMigrations(computedValuesAndRepeatedNodesMigration);
 if (!registeredSchemaMigrations().has(20260923144958)) registerSchemaMigrations(transitionTokenValueMigration);
 if (!registeredSchemaMigrations().has(20260923160425)) registerSchemaMigrations(renderTokenRefsMigration);
+if (!registeredSchemaMigrations().has(20260923163604)) registerSchemaMigrations(globalStyleDerivedColorsMigration);
 //#endregion
 export { System };

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

@@ -1,17 +1,21 @@
 import { EntityClass } from "../../framework/defineEntity.js";
+import { DerivedColor } from "./color.js";
 import { z } from "zod";
 
 //#region src/entities/system/GlobalStyle.d.ts
 /** A declared value, or a nested block of them — an at-rule (`@keyframes`) and a grouped selector
- *  both hold rules rather than declarations, and they nest to any depth. */
+ *  both hold rules rather than declarations, and they nest to any depth. A derived colour
+ *  (`alpha(Token.ref('color/on-primary'), 0.2)`) is a value: it keeps its token, so a rename
+ *  cascades into the rule and a mode override reaches it, where a baked `rgba()` would not. */
 type Declared = string | number | {
   __ref: string;
-} | {
+} | DerivedColor | {
   [key: string]: Declared;
 };
 declare const GlobalStyle: EntityClass<z.ZodObject<{
   selector: z.ZodString;
   declarations: z.ZodRecord<z.ZodString, z.ZodType<Declared, unknown, z.core.$ZodTypeInternals<Declared, unknown>>>;
+  important: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>, z.ZodObject<Record<never, never>, z.core.$strip>, "global-style", Record<never, never>, Record<never, never>, false, Record<never, never>, Record<never, never>>;
 /**
  * A stable name for a rule, from its selector — `@keyframes bounce` → `bounce`, `.prompt-editor p`

package/dist/entities/system/GlobalStyle.js

@@ -1,5 +1,6 @@
 import { refSchema } from "../../framework/utils/refs.js";
 import { defineEntity } from "../../framework/defineEntity.js";
+import { derivedColor } from "./color.js";
 import { z } from "zod";
 //#region src/entities/system/GlobalStyle.ts
 /**
@@ -22,6 +23,7 @@ const declared = z.lazy(() => z.union([
 	z.string(),
 	z.number(),
 	refSchema,
+	derivedColor,
 	z.record(z.string(), declared)
 ]));
 const GlobalStyle = defineEntity({
@@ -32,7 +34,13 @@ const GlobalStyle = defineEntity({
 		/** What the rule applies to — `html, body`, `@keyframes bounce`, `.prompt-editor p`. */
 		selector: z.string(),
 		/** Property → value, camelCase as it's authored; a nested record is a nested rule. */
-		declarations: z.record(z.string(), declared)
+		declarations: z.record(z.string(), declared),
+		/**
+		* Every declaration in the rule, nested ones included, is emitted `!important`. The sheet is
+		* layered and a third party's stylesheet (React Flow, CodeMirror's injected theme) is not, so a
+		* rule meant to beat one has to say so; the flag lets it while its values stay refs.
+		*/
+		important: z.boolean().optional()
 	})
 });
 /**

package/dist/framework/Config.d.ts

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

package/dist/framework/Config.js

@@ -4883,7 +4883,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 > 20260923160425) throw new SchemaVersionTooNew(claimed);
+		if (claimed > 20260923163604) 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, or port the repo once with \`uds migrate\`.`);
 		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 = 20260923160425;
+declare const CURRENT_SCHEMA_VERSION = 20260923163604;
 /** 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 = 20260923160425;
+const CURRENT_SCHEMA_VERSION = 20260923163604;
 /** 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 > 20260923160425) 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 > 20260923163604) 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 ?? 20260923160425;
+	const target = options?.target ?? 20260923163604;
 	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 ?? 20260923160425;
+	const target = options?.target ?? 20260923163604;
 	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 ?? 20260923160425;
+	const target = options?.target ?? 20260923163604;
 	const entries = [];
 	const held = [];
 	const retired = [];

package/dist/migrations/2.0.0/v1-artifact.d.ts

@@ -16,6 +16,7 @@ import { listSlots, namedSlots, slotHostedBy, slotOf } from "../../spec/slot.js"
 import { cellAt } from "../../spec/cell.js";
 import { instanceAt } from "../../spec/instance.js";
 import { ComposedValue } from "../../entities/system/composed-values.js";
+import { DerivedColor } from "../../entities/system/color.js";
 import { StyleValue } from "../../entities/system/style-bag.js";
 import { OverrideCondition, TokenRefPath, TokenReference } from "../../entities/system/Token.js";
 import { ComponentElementBody, ComponentReference, ComponentStyleBody } from "../../entities/system/Component.js";
@@ -1841,19 +1842,20 @@ declare function loadV1Artifact(studio: V1Artifact, options?: LoadV1Options): Co
   }, Record<never, never>, false, Record<never, never>, Record<never, never>>;
   globalStyles: EntityClass<_$zod.ZodObject<{
     selector: _$zod.ZodString;
-    declarations: _$zod.ZodRecord<_$zod.ZodString, _$zod.ZodType<string | number | {
+    declarations: _$zod.ZodRecord<_$zod.ZodString, _$zod.ZodType<string | number | DerivedColor | {
       __ref: string;
     } | {
-      [key: string]: string | number | {
+      [key: string]: string | number | DerivedColor | {
         __ref: string;
       } | /*elided*/any;
-    }, unknown, _$zod_v4_core0.$ZodTypeInternals<string | number | {
+    }, unknown, _$zod_v4_core0.$ZodTypeInternals<string | number | DerivedColor | {
       __ref: string;
     } | {
-      [key: string]: string | number | {
+      [key: string]: string | number | DerivedColor | {
         __ref: string;
       } | /*elided*/any;
     }, unknown>>>;
+    important: _$zod.ZodOptional<_$zod.ZodBoolean>;
   }, _$zod_v4_core0.$strict>, _$zod.ZodObject<Record<never, never>, _$zod_v4_core0.$strip>, "global-style", Record<never, never>, Record<never, never>, false, Record<never, never>, Record<never, never>>;
   devices: EntityClass<_$zod.ZodObject<{
     width: _$zod.ZodNumber;

package/dist/migrations/20260923163604_global_style_derived_colors.d.ts

@@ -0,0 +1,10 @@
+/**
+ * A `global-style` declaration may be a derived colour (`alpha(Token.ref('color/on-primary'), 0.2)`),
+ * beside a string, a number, a ref or a nested rule, and a rule may carry `important: true`. The wire
+ * shape of every stored config is unchanged: a derived colour is an object the previous schema would
+ * have read as a nested rule, the flag is a new optional field, and no stored config held either.
+ * Additive, so the envelope passes through as it is.
+ */
+import type { SchemaMigration } from '../framework/schema-version';
+export declare const GLOBAL_STYLE_DERIVED_COLORS_VERSION = 20260923163604;
+export declare const globalStyleDerivedColorsMigration: SchemaMigration;

package/dist/migrations/20260923163604_global_style_derived_colors.js

@@ -0,0 +1,10 @@
+//#region src/migrations/20260923163604_global_style_derived_colors.ts
+const GLOBAL_STYLE_DERIVED_COLORS_VERSION = 20260923163604;
+const globalStyleDerivedColorsMigration = {
+	version: GLOBAL_STYLE_DERIVED_COLORS_VERSION,
+	up(json) {
+		return json;
+	}
+};
+//#endregion
+export { GLOBAL_STYLE_DERIVED_COLORS_VERSION, globalStyleDerivedColorsMigration };