@yahoo/uds-create-config 5.19.1 → 5.21.0

package/dist/migrations/20261009022722_starting_style_modifier.d.ts

@@ -0,0 +1,9 @@
+/**
+ * A modifier may activate as `starting-style`, which wraps its block in `@starting-style`. Every
+ * stored modifier activates as one of the existing types, so the wire shape of every stored config
+ * is unchanged.
+ * Additive, so the envelope passes through as it is.
+ */
+import type { SchemaMigration } from '../framework/schema-version';
+export declare const STARTING_STYLE_MODIFIER_VERSION = 20261009022722;
+export declare const startingStyleModifierMigration: SchemaMigration;

package/dist/migrations/20261009022722_starting_style_modifier.js

@@ -0,0 +1,10 @@
+//#region src/migrations/20261009022722_starting_style_modifier.ts
+const STARTING_STYLE_MODIFIER_VERSION = 20261009022722;
+const startingStyleModifierMigration = {
+	version: STARTING_STYLE_MODIFIER_VERSION,
+	up(json) {
+		return json;
+	}
+};
+//#endregion
+export { STARTING_STYLE_MODIFIER_VERSION, startingStyleModifierMigration };

package/dist/migrations/20261009181635_css_motion_strict.d.ts

@@ -0,0 +1,23 @@
+/**
+ * A CSS motion preset takes only CSS fields. The fields only a JS preset has (`layout`, `drag`,
+ * `dragConstraints`, `dragElastic`, `whileDrag`) and a state's `transitionEnd` are gone from it, and
+ * its `transition` is CSS timing: `duration` and `delay` as CSS times, an `easing` that is CSS or a
+ * spring (`{ spring: { stiffness, damping, … } }`), and a value's own timing under `properties`.
+ * `motion/convert` rewrites a preset between the runtimes from here on.
+ *
+ * `up` rewrites a stored CSS preset written the JS way into that form. The previous version read a
+ * level with an `easing`, or a `duration` that is no number, as CSS and ignored the spring beside it,
+ * so that level keeps its CSS fields and drops the spring's. Any other level is read as `motion/react`
+ * writes one: a number is seconds, a `type: 'spring'` is a spring, and an `ease` is the easing. A
+ * draft patch that creates or replaces a CSS preset is rewritten the same way. One that updates a
+ * preset isn't, since it doesn't say which runtime the preset it writes into has.
+ *
+ * The rewrite is copied here rather than imported from `motion-convert.ts`, so a later change to the
+ * conversion can't change what this hop does.
+ */
+import type { RawWireConfig, SchemaMigration } from '../framework/schema-version';
+export declare const CSS_MOTION_STRICT_VERSION = 20261009181635;
+/** A stored CSS preset in the strict form. Anything else comes back as it is. */
+export declare function strictCssMotion(body: unknown): unknown;
+export declare function cssMotionStrict(json: RawWireConfig): RawWireConfig;
+export declare const cssMotionStrictMigration: SchemaMigration;

package/dist/migrations/20261009181635_css_motion_strict.js

@@ -0,0 +1,152 @@
+import { z } from "zod";
+//#region src/migrations/20261009181635_css_motion_strict.ts
+/**
+* A CSS motion preset takes only CSS fields. The fields only a JS preset has (`layout`, `drag`,
+* `dragConstraints`, `dragElastic`, `whileDrag`) and a state's `transitionEnd` are gone from it, and
+* its `transition` is CSS timing: `duration` and `delay` as CSS times, an `easing` that is CSS or a
+* spring (`{ spring: { stiffness, damping, … } }`), and a value's own timing under `properties`.
+* `motion/convert` rewrites a preset between the runtimes from here on.
+*
+* `up` rewrites a stored CSS preset written the JS way into that form. The previous version read a
+* level with an `easing`, or a `duration` that is no number, as CSS and ignored the spring beside it,
+* so that level keeps its CSS fields and drops the spring's. Any other level is read as `motion/react`
+* writes one: a number is seconds, a `type: 'spring'` is a spring, and an `ease` is the easing. A
+* draft patch that creates or replaces a CSS preset is rewritten the same way. One that updates a
+* preset isn't, since it doesn't say which runtime the preset it writes into has.
+*
+* The rewrite is copied here rather than imported from `motion-convert.ts`, so a later change to the
+* conversion can't change what this hop does.
+*/
+const CSS_MOTION_STRICT_VERSION = 20261009181635;
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const isRef = (value) => isRecord(value) && "__ref" in value;
+const JS_ONLY = [
+	"whileDrag",
+	"layout",
+	"drag",
+	"dragConstraints",
+	"dragElastic"
+];
+const STATES = [
+	"initial",
+	"animate",
+	"exit",
+	"whileHover",
+	"whileTap",
+	"whileFocus"
+];
+const TIMING = new Set([
+	"type",
+	"duration",
+	"delay",
+	"ease",
+	"easing",
+	"times",
+	"stiffness",
+	"damping",
+	"mass",
+	"bounce",
+	"visualDuration"
+]);
+const SPRING = [
+	"stiffness",
+	"damping",
+	"mass",
+	"bounce"
+];
+/** `motion/react`'s easings that are a Bézier curve, as the previous version spelled them. */
+const NAMED = {
+	linear: "linear",
+	easeIn: "cubic-bezier(0.42, 0, 1, 1)",
+	easeOut: "cubic-bezier(0, 0, 0.58, 1)",
+	easeInOut: "cubic-bezier(0.42, 0, 0.58, 1)",
+	backOut: "cubic-bezier(0.33, 1.53, 0.69, 0.99)"
+};
+const time = (value) => typeof value === "number" ? `${Math.round(value * 1e3)}ms` : value;
+function easingOf(ease) {
+	if (isRef(ease)) return ease;
+	if (Array.isArray(ease) && ease.length === 4 && ease.every((n) => typeof n === "number")) return `cubic-bezier(${ease.join(", ")})`;
+	if (typeof ease === "string") return NAMED[ease.trim()] ?? ease.trim();
+}
+/** One level of a transition, as CSS timing. */
+function timingOf(level) {
+	const out = {};
+	if (level.delay !== void 0) out.delay = time(level.delay);
+	if (Array.isArray(level.times)) out.times = level.times;
+	if (level.easing !== void 0 || level.duration !== void 0 && typeof level.duration !== "number") {
+		if (level.duration !== void 0) out.duration = time(level.duration);
+		if (level.easing !== void 0) out.easing = level.easing;
+		return out;
+	}
+	if (level.type === "spring") {
+		const spring = {};
+		for (const key of SPRING) if (level[key] !== void 0) spring[key] = level[key];
+		for (const key of ["duration", "visualDuration"]) if (level[key] !== void 0) spring[key] = time(level[key]);
+		out.easing = { spring };
+		return out;
+	}
+	if (level.duration !== void 0) out.duration = time(level.duration);
+	const easing = easingOf(level.ease);
+	if (easing !== void 0) out.easing = easing;
+	return out;
+}
+/** A transition as CSS: its base timing (`default` where it has one), and each value's own under
+*  `properties`. A transition already written as CSS comes back as it is. */
+function transitionOf(transition) {
+	const out = timingOf(isRecord(transition.default) ? transition.default : transition);
+	const properties = isRecord(transition.properties) ? { ...transition.properties } : {};
+	for (const [key, value] of Object.entries(transition)) {
+		if (key === "default" || key === "properties" || TIMING.has(key)) continue;
+		if (isRecord(value) && !isRef(value)) properties[key] = timingOf(value);
+	}
+	if (Object.keys(properties).length > 0) out.properties = properties;
+	return out;
+}
+function stateOf(target) {
+	if (!isRecord(target)) return target;
+	const { transitionEnd: _transitionEnd, ...rest } = target;
+	if (isRecord(rest.transition)) rest.transition = transitionOf(rest.transition);
+	return rest;
+}
+/** A stored CSS preset in the strict form. Anything else comes back as it is. */
+function strictCssMotion(body) {
+	if (!isRecord(body) || body.runtime !== "css") return body;
+	const out = { ...body };
+	for (const field of JS_ONLY) delete out[field];
+	for (const state of STATES) if (out[state] !== void 0) out[state] = stateOf(out[state]);
+	if (isRecord(out.variants)) out.variants = Object.fromEntries(Object.entries(out.variants).map(([name, target]) => [name, stateOf(target)]));
+	if (isRecord(out.transition)) out.transition = transitionOf(out.transition);
+	return out;
+}
+function cssMotionStrict(json) {
+	const items = json.items;
+	if (!isRecord(items) || !isRecord(items.motion)) return json;
+	const motion = Object.fromEntries(Object.entries(items.motion).map(([path, body]) => [path, strictCssMotion(body)]));
+	return {
+		...json,
+		items: {
+			...items,
+			motion
+		}
+	};
+}
+const cssMotionStrictMigration = {
+	version: CSS_MOTION_STRICT_VERSION,
+	up: cssMotionStrict,
+	fromSchema: z.looseObject({}),
+	toSchema: z.looseObject({}).refine((json) => {
+		const items = json.items;
+		if (!isRecord(items) || !isRecord(items.motion)) return true;
+		return Object.values(items.motion).every((body) => !isRecord(body) || body.runtime !== "css" || JS_ONLY.every((field) => body[field] === void 0));
+	}, { message: "a CSS motion preset holds none of a JS preset's own fields" }),
+	upPatch(patch) {
+		if (patch.kind !== "motion" || !("data" in patch)) return patch;
+		if (patch.operation !== "create" && patch.operation !== "replace") return patch;
+		return {
+			...patch,
+			data: strictCssMotion(patch.data)
+		};
+	}
+};
+//#endregion
+export { CSS_MOTION_STRICT_VERSION, cssMotionStrictMigration };

package/dist/migrations/20261009193004_link_override_ref.d.ts

@@ -0,0 +1,9 @@
+/**
+ * A link's `options` entry may give `override` as a ref to another entity of the same kind, which
+ * re-points the path to it (`'js/scale': { override: Motion.ref('css/scale') }`). Every stored
+ * `override` is a body, so the wire shape of every stored config is unchanged. Additive, so the
+ * envelope passes through as it is.
+ */
+import type { SchemaMigration } from '../framework/schema-version';
+export declare const LINK_OVERRIDE_REF_VERSION = 20261009193004;
+export declare const linkOverrideRefMigration: SchemaMigration;

package/dist/migrations/20261009193004_link_override_ref.js

@@ -0,0 +1,10 @@
+//#region src/migrations/20261009193004_link_override_ref.ts
+const LINK_OVERRIDE_REF_VERSION = 20261009193004;
+const linkOverrideRefMigration = {
+	version: LINK_OVERRIDE_REF_VERSION,
+	up(json) {
+		return json;
+	}
+};
+//#endregion
+export { LINK_OVERRIDE_REF_VERSION, linkOverrideRefMigration };

package/dist/spec/links.d.ts

@@ -0,0 +1,2 @@
+import { LinkRedirect, linkRedirects, redirectSentence } from "../entities/system/LinkedSystem.js";
+export { type LinkRedirect, linkRedirects, redirectSentence };

package/dist/spec/links.js

@@ -0,0 +1,2 @@
+import { linkRedirects, redirectSentence } from "../entities/system/LinkedSystem.js";
+export { linkRedirects, redirectSentence };

package/dist/spec/motion.d.ts

@@ -0,0 +1,7 @@
+import { REDUCED_MOTION_ATTRIBUTE, REDUCED_MOTION_VALUES, ReducedMotion, ReducedMotionLayer, reducedMotionLayers } from "../entities/system/reduced-motion.js";
+import { MOTION_PACKAGE, presetReducedMotions } from "../entities/system/motion-presets.js";
+import { CSS_MOTION_STATES, CssMotionKeyframeList, CssMotionState, CssMotionTiming, CssMotionTimings, CssMotionTransitions, cssMotionExitDuration, cssMotionKeyframeLists, cssMotionTokens, cssMotionTransitions } from "../entities/system/css-motion.js";
+import { MotionConversion, MotionConversionNote, MotionConversionPlan, MotionRuntime, convertMotion } from "../entities/system/motion-convert.js";
+import { CssMotionExitOnUnmount, CssMotionPlacement, LinkedMotionSwap, SwappedLinkJsMotion, cssMotionExitsOnUnmount, cssMotionPlacements, cssMotionVariantGroups, linkedMotionSwaps, swappedLinkJsMotions } from "../entities/system/css-motion-reach.js";
+import { SpringOptions, SpringTiming, cssEasing, springTiming } from "../entities/system/css-timing.js";
+export { CSS_MOTION_STATES, type CssMotionExitOnUnmount, type CssMotionKeyframeList, type CssMotionPlacement, type CssMotionState, type CssMotionTiming, type CssMotionTimings, type CssMotionTransitions, type LinkedMotionSwap, MOTION_PACKAGE, type MotionConversion, type MotionConversionNote, type MotionConversionPlan, type MotionRuntime, REDUCED_MOTION_ATTRIBUTE, REDUCED_MOTION_VALUES, type ReducedMotion, type ReducedMotionLayer, type SpringOptions, type SpringTiming, type SwappedLinkJsMotion, convertMotion, cssEasing, cssMotionExitDuration, cssMotionExitsOnUnmount, cssMotionKeyframeLists, cssMotionPlacements, cssMotionTokens, cssMotionTransitions, cssMotionVariantGroups, linkedMotionSwaps, presetReducedMotions, reducedMotionLayers, springTiming, swappedLinkJsMotions };

package/dist/spec/motion.js

@@ -0,0 +1,7 @@
+import { cssEasing, springTiming } from "../entities/system/css-timing.js";
+import { convertMotion } from "../entities/system/motion-convert.js";
+import { cssMotionExitsOnUnmount, cssMotionPlacements, cssMotionVariantGroups, linkedMotionSwaps, swappedLinkJsMotions } from "../entities/system/css-motion-reach.js";
+import { REDUCED_MOTION_ATTRIBUTE, REDUCED_MOTION_VALUES, reducedMotionLayers } from "../entities/system/reduced-motion.js";
+import { MOTION_PACKAGE, presetReducedMotions } from "../entities/system/motion-presets.js";
+import { CSS_MOTION_STATES, cssMotionExitDuration, cssMotionKeyframeLists, cssMotionTokens, cssMotionTransitions } from "../entities/system/css-motion.js";
+export { CSS_MOTION_STATES, MOTION_PACKAGE, REDUCED_MOTION_ATTRIBUTE, REDUCED_MOTION_VALUES, convertMotion, cssEasing, cssMotionExitDuration, cssMotionExitsOnUnmount, cssMotionKeyframeLists, cssMotionPlacements, cssMotionTokens, cssMotionTransitions, cssMotionVariantGroups, linkedMotionSwaps, presetReducedMotions, reducedMotionLayers, springTiming, swappedLinkJsMotions };