@yahoo/uds-create-config 5.50.0 → 5.51.0

package/dist/authoring/presence.d.ts

@@ -8,6 +8,12 @@ interface PresenceProps {
   /** `popLayout`: a leaving child is taken out of the layout at once, so the one replacing it moves
    *  in without waiting. `wait`: the one replacing it enters once the leaving child's exit ends. */
   mode?: 'sync' | 'wait' | 'popLayout';
+  /** Called once every leaving child has finished its exit, e.g. to return focus after a menu
+   *  closes. Not called on native, where no presence plays. */
+  onExitComplete?: () => void;
+  /** `true`: inside a child another presence is taking away, the children this one keeps play their
+   *  exits too, and that child stays until they end. By default they stay where they are. */
+  propagate?: boolean;
 }
 /** See {@link PresenceProps}. Never rendered: the build replaces it. */
 declare function Presence({

package/dist/configs/react-native-system.js

@@ -1,9 +1,9 @@
 import { NATIVE_CONFIG_NAME } from "./platform.js";
 import { Font } from "../entities/system/Font.js";
 import { Package } from "../entities/system/Package.js";
+import { File } from "../entities/system/File.js";
 import { Composite } from "../entities/system/Composite.js";
 import { Motion } from "../entities/system/Motion.js";
-import { File } from "../entities/system/File.js";
 import { Component } from "../entities/system/Component.js";
 import { Icon } from "../entities/system/Icon.js";
 import { Device } from "../entities/system/Device.js";

package/dist/configs/system.js

@@ -1,12 +1,12 @@
 import { WEB_CONFIG_NAME } from "./platform.js";
 import { Font } from "../entities/system/Font.js";
-import { Settings } from "../entities/system/Settings.js";
 import { Package } from "../entities/system/Package.js";
+import { File } from "../entities/system/File.js";
+import { Settings } from "../entities/system/Settings.js";
 import { Composite } from "../entities/system/Composite.js";
 import { Modifier } from "../entities/system/Modifier.js";
 import { StyleProperty } from "../entities/system/StyleProperty.js";
 import { Motion } from "../entities/system/Motion.js";
-import { File } from "../entities/system/File.js";
 import { Token } from "../entities/system/Token.js";
 import { Component } from "../entities/system/Component.js";
 import { Icon } from "../entities/system/Icon.js";
@@ -27,6 +27,7 @@ import { nativeLinearGradientsMigration } from "../migrations/20261020173914_nat
 import { linkedDirMigration } from "../migrations/20261020182408_linked_dir.js";
 import { lintSettingsMigration } from "../migrations/20261020183330_lint_settings.js";
 import { directLayerCompositesMigration } from "../migrations/20261022124223_direct_layer_composites.js";
+import { cssContentScriptsMigration } from "../migrations/20261022152120_css_content_scripts.js";
 import { CanvasRole } from "../entities/system/CanvasRole.js";
 import { GlobalStyle } from "../entities/system/GlobalStyle.js";
 import { Guidance } from "../entities/system/Guidance.js";
@@ -187,5 +188,6 @@ if (!registeredSchemaMigrations().has(20261020183330)) {
 	registerSchemaMigrations(lintSettingsMigration);
 	registerSchemaMigrations(directLayerCompositesMigration);
 }
+if (!registeredSchemaMigrations().has(20261022152120)) registerSchemaMigrations(cssContentScriptsMigration);
 //#endregion
 export { System };

package/dist/entities/system/Component.js

@@ -9,10 +9,11 @@ import { defineEntity } from "../../framework/defineEntity.js";
 import { defineSubEntity, orList } from "../../framework/defineSubEntity.js";
 import { childrenPolicy, forwardedPropName } from "./element.js";
 import { interactionKey, interactionModifiers, isInteractionModifier } from "../../framework/interaction-conditions.js";
+import { Package } from "./Package.js";
+import { File } from "./File.js";
 import { translateLinkedStyleBags } from "./linked-style-values.js";
 import { listedIn } from "../../framework/utils/enumerated.js";
 import { valueSchemaOf } from "../../framework/value-domain.js";
-import { Package } from "./Package.js";
 import { bindPreviewGlyphs, glyphMemberRefIn } from "./glyph-identity.js";
 import { Style, addBagKeyIssues, anatomyPropValue, bagNameEdges, bagRewriteName, bindBagTokens, collectBag, compositeApplication, isPlainRecord, nativeStyleArray, openBag, styleValueFor } from "./style-bag.js";
 import { storedPreview } from "../../framework/preview-store.js";
@@ -25,7 +26,6 @@ import { instanceAt } from "../../spec/instance.js";
 import { forwardOptions, forwardsWrite } from "./component-forwards.js";
 import { assertComponentSourceInput } from "./component-source-fields.js";
 import { checkStyleSet, styleSetEdits } from "./component-style-set.js";
-import { File } from "./File.js";
 import { forwardRouteInvariants, refusedRoutes } from "./forward-route-invariants.js";
 import { iconDomainInvariants } from "./icon-domain-invariants.js";
 import { rootLayerInvariants } from "./root-layer-invariants.js";

package/dist/entities/system/Icon.js

@@ -1,7 +1,7 @@
 import { isRef, pathOf } from "../../framework/utils/refs.js";
 import { defineEntity } from "../../framework/defineEntity.js";
-import { spellValues } from "../../framework/value-domain.js";
 import { Package } from "./Package.js";
+import { spellValues } from "../../framework/value-domain.js";
 import { iconMemberMetadata, iconMetadataDeclaration, iconMetadataFormat } from "./icon-metadata.js";
 import { glyphMembersOf, glyphOfLibrary, libraryGlyphFacts, recordGlyphIdentities } from "./glyph-identity.js";
 import { iconDomainInvariants } from "./icon-domain-invariants.js";

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

@@ -42,7 +42,8 @@ declare const CSS_DEFAULTS: {
   readonly prefix: "uds";
   readonly preflight: true;
   readonly fontFaces: true;
-  readonly rem: "16px";
+  readonly rem: "16px"; /** Every script file under `src/`, in each extension a module resolver tries. */
+  readonly content: readonly [`src/**/*.{${string}}`];
 };
 /** The `css` section — how a web system names what it emits and where its stylesheet applies. A
  *  native system declares no such section, so a native config setting one is refused. */

package/dist/entities/system/Settings.js

@@ -5,6 +5,7 @@ import { createSliceMemo } from "../../framework/memo.js";
 import { parseRootFontSize } from "../../css/root-font-size.js";
 import { buildFields } from "../../configs/build-options.js";
 import { resolveInputDir } from "../../framework/build-dirs.js";
+import { SCRIPT_EXTENSIONS } from "./File.js";
 import { safelistSchema } from "./safelist.js";
 import { z } from "zod";
 //#region src/entities/system/Settings.ts
@@ -65,7 +66,9 @@ const CSS_DEFAULTS = {
 	prefix: "uds",
 	preflight: true,
 	fontFaces: true,
-	rem: "16px"
+	rem: "16px",
+	/** Every script file under `src/`, in each extension a module resolver tries. */
+	content: [`src/**/*.{${[...SCRIPT_EXTENSIONS].map((ext) => ext.slice(1)).join(",")}}`]
 };
 const cssFields = z.strictObject({
 	prefix: prefix.meta({
@@ -103,8 +106,8 @@ const cssFields = z.strictObject({
 	/** The files the app's stylesheet is shaken against, as globs from the config's directory. */
 	content: z.array(z.string().min(1)).meta({
 		title: "Content",
-		description: "The files the build reads for the classes an app uses, as globs relative to the config's directory: `src/**/*.{ts,tsx}`, `app/**/*.tsx`, or a prebuilt package's output such as `node_modules/@acme/widgets/dist/**/*.{js,mjs}`. `.ts`, `.tsx`, `.js`, `.jsx`, `.mjs` and `.cjs` files are read for the components they render, compiled JSX included, and every file a glob names — `.html`, `.vue`, `.md` and the rest — for the classes its text spells, as in `class=\"md:flex\"`. Set, it replaces the default. Unset, `src/**/*.{ts,tsx}`.",
-		default: ["src/**/*.{ts,tsx}"]
+		description: `The files the build reads for the classes an app uses, as globs relative to the config's directory: \`src/**/*.{ts,tsx}\`, \`app/**/*.tsx\`, or a prebuilt package's output such as \`node_modules/@acme/widgets/dist/**/*.{js,mjs}\`. \`.ts\`, \`.tsx\`, \`.mts\`, \`.cts\`, \`.js\`, \`.jsx\`, \`.mjs\` and \`.cjs\` files are read for the components they render, compiled JSX included, and every file a glob names — \`.html\`, \`.vue\`, \`.md\` and the rest — for the classes its text spells, as in \`class="md:flex"\`. Set, it replaces the default. Unset, \`${CSS_DEFAULTS.content[0]}\`.`,
+		default: [...CSS_DEFAULTS.content]
 	}).optional(),
 	/** What the stylesheet keeps whether or not a scanned file uses it — for a value built at runtime,
 	*  or one used by a file the build does not scan. See `safelist.ts` for the entry forms. */

package/dist/entities/system/component-module.js

@@ -1,8 +1,8 @@
 import { isNativeConfig } from "../../configs/platform.js";
 import { isRef, kindOf, pathOf, ref, routedSource, sourceHops, splitRef } from "../../framework/utils/refs.js";
 import { createSliceMemo } from "../../framework/memo.js";
-import { Settings, classPrefixOf, prefixed, varPrefixOf } from "./Settings.js";
 import { File } from "./File.js";
+import { Settings, classPrefixOf, prefixed, varPrefixOf } from "./Settings.js";
 import { Component } from "./Component.js";
 import { contentKey } from "../../framework/utils/content-key.js";
 //#region src/entities/system/component-module.ts

package/dist/entities/system/shipped-modules.js

@@ -1,6 +1,6 @@
 import { splitRef } from "../../framework/utils/refs.js";
-import { Settings } from "./Settings.js";
 import { SCRIPT_EXTENSIONS } from "./File.js";
+import { Settings } from "./Settings.js";
 //#region src/entities/system/shipped-modules.ts
 /** A file-name part that marks a test or story (`button.test.tsx`), which no app imports. */
 const NOT_SHIPPED_MARKERS = new Set([

package/dist/framework/Config.d.ts

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

package/dist/framework/Config.js

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

package/dist/index.js

@@ -28,12 +28,13 @@ import { resolveValueType, sniffValueType } from "./css/value-type.js";
 import { parseRootFontSize } from "./css/root-font-size.js";
 import { BUILD_DEFAULTS } from "./configs/build-options.js";
 import { resolveInputDir, resolveLinkedAlias, resolveLinkedDir, resolveOutDir, resolveOutputAlias, resolveRetiredLinkedDir, resolveSourceAlias } from "./framework/build-dirs.js";
+import { Package } from "./entities/system/Package.js";
+import { File, SCRIPT_EXTENSIONS, isBinaryAsset } from "./entities/system/File.js";
 import { safelistEntrySchema } from "./entities/system/safelist.js";
 import { BuildSection, CSS_DEFAULTS, CssSection, LintSection, PLAYGROUND_DEFAULTS, PlaygroundSection, Settings, SystemSection, classPrefixOf, cssPrefixes, deriveInputDir, prefixed, varPrefixOf } from "./entities/system/Settings.js";
 import { TOKEN_READERS, isTokenReader, parseTokenValue, rootFontSize, spellTokenRead, tokenExists, tokenValueRow, tokenValueRows } from "./entities/system/token-values.js";
 import { CSS_PROPERTY_NAMES, CSS_WIDE_KEYWORDS, cssProperty, cssValueIssue, isCssProperty } from "./css/values.js";
 import { valueLeavesOf, valueSchemaOf } from "./framework/value-domain.js";
-import { Package } from "./entities/system/Package.js";
 import { ICON_METADATA_FORMATS, glyphExportRule, iconMemberMetadata, iconMetadata, iconMetadataDeclaration, iconMetadataFile, iconMetadataFileJsonSchema, iconMetadataFormat, iconMetadataSourceFile, tablerExportName, tablerStyledExportName } from "./entities/system/icon-metadata.js";
 import { Composite } from "./entities/system/Composite.js";
 import { MODIFIER_CATEGORIES, Modifier, WEB_ACTIVATIONS, modeAxes, modifierAxes, modifierGroupFields, modifierInvariants, modifierLeaf } from "./entities/system/Modifier.js";
@@ -58,7 +59,6 @@ import { canvasCellAt, canvasDefaultCoordinate, cellAxes } from "./spec/cell.js"
 import { instanceHolding } from "./spec/instance.js";
 import { componentSourceDerivedFields } from "./entities/system/component-source-fields.js";
 import { styleSetEdits } from "./entities/system/component-style-set.js";
-import { File, SCRIPT_EXTENSIONS, isBinaryAsset } from "./entities/system/File.js";
 import { convertLinkedTokenValue, prepareLinkedTokenBody } from "./entities/system/linked-token-values.js";
 import { Token, defineOverride, overrideCondition, overrideKey, overrideKeyModifiers, overrideModifiers } from "./entities/system/Token.js";
 import { Component, SLOT_CODE_FORMS, blankComponentBody, canonicalWhen, forwardedNames, layerRef, ownValues, ownsItsValues, valueRef } from "./entities/system/Component.js";

package/dist/migrations/20261022152120_css_content_scripts.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `css.content` defaults to every script file under `src/` — `.ts`, `.tsx`, `.mts`, `.cts`, `.js`,
+ * `.jsx`, `.mjs` and `.cjs` — where it was `.ts` and `.tsx` alone, so a JavaScript app's sources are
+ * shaken against too. Only the default the schema states moved: a stored `content` is kept as it was,
+ * and an unset one was never written, so `up` is identity and no stored draft patch is affected.
+ *
+ * Deletable once no stored config predates this version.
+ */
+import type { SchemaMigration } from '../framework/schema-version';
+export declare const CSS_CONTENT_SCRIPTS_VERSION = 20261022152120;
+export declare const cssContentScriptsMigration: SchemaMigration;

package/dist/migrations/20261022152120_css_content_scripts.js

@@ -0,0 +1,10 @@
+//#region src/migrations/20261022152120_css_content_scripts.ts
+const CSS_CONTENT_SCRIPTS_VERSION = 20261022152120;
+const cssContentScriptsMigration = {
+	version: CSS_CONTENT_SCRIPTS_VERSION,
+	up(json) {
+		return json;
+	}
+};
+//#endregion
+export { CSS_CONTENT_SCRIPTS_VERSION, cssContentScriptsMigration };