@yahoo/uds-create-config 5.42.3 → 5.43.0

package/dist/configs/build-options.d.ts

@@ -3,8 +3,8 @@ import { z } from "zod";
 //#region src/configs/build-options.d.ts
 /** The section as a config that set nothing reads it, spelled once. */
 declare const BUILD_DEFAULTS: {
-  readonly outDir: ".uds"; /** The registry beside the conventional components root — see `resolveRegistryDir`. */
-  readonly registryDir: "src/uds/registry"; /** Where a system that declares no `inputDir` keeps its sources, for what sits beside them. */
+  readonly outDir: ".uds"; /** Linked systems' sources, beside the conventional components root — see `resolveLinkedDir`. */
+  readonly linkedDir: "src/uds/linked"; /** Where a system that declares no `inputDir` keeps its sources, for what sits beside them. */
   readonly inputRoot: "src/uds"; /** The prefix a system's sources are imported by: `@/uds/components/card`. */
   readonly sourceAlias: "@/uds"; /** The prefix its build output is imported by: `#uds/components/card`. */
   readonly outputAlias: "#uds"; /** The React major the app runs, which decides how an emitted component takes its `ref`. */

package/dist/configs/build-options.js

@@ -27,8 +27,8 @@ const insideProject = (field) => z.string().min(1).refine((value) => !value.star
 /** The section as a config that set nothing reads it, spelled once. */
 const BUILD_DEFAULTS = {
 	outDir: ".uds",
-	/** The registry beside the conventional components root — see `resolveRegistryDir`. */
-	registryDir: "src/uds/registry",
+	/** Linked systems' sources, beside the conventional components root — see `resolveLinkedDir`. */
+	linkedDir: "src/uds/linked",
 	/** Where a system that declares no `inputDir` keeps its sources, for what sits beside them. */
 	inputRoot: "src/uds",
 	/** The prefix a system's sources are imported by: `@/uds/components/card`. */
@@ -66,7 +66,7 @@ const buildFields = z.strictObject({
 	* Every source file under `inputDir` ships by default, with what it imports. A module no component
 	* imports, a toast queue's `createToast` or a motion wrapper like yos-v3's `SpringMotionConfig`,
 	* is emitted at its own path under `components/`, so this system's apps import it as
-	* `#uds/components/<file>` and a system that links this one as `@/uds/registry/<slug>/<file>`.
+	* `#uds/components/<file>` and a system that links this one as `@/uds/linked/<slug>/<file>`.
 	* Tests, stories and type declarations never ship, and neither does a file only the config or a
 	* script imports. List a file here to keep it out as well, such as a helper whose npm
 	* dependencies a linking team shouldn't have to install. An excluded file nothing else imports is
@@ -84,11 +84,11 @@ const buildFields = z.strictObject({
 	* sources even though nothing imports it. Unlike a shipped module it is never emitted, even under
 	* {@link inputDir}: a script runs as written, against the authoring package, so it may read the
 	* config (`Token.get`, `Component.list`) where a shipped module may only read token values. A
-	* linking team runs it from the installed tree, `src/uds/registry/<slug>/<path>`.
+	* linking team runs it from the installed tree, `src/uds/linked/<slug>/<path>`.
 	*/
 	scripts: z.array(z.string().min(1).refine((value) => !value.startsWith("/") && !/^[A-Za-z]:/.test(value) && !value.replace(/\\/g, "/").split("/").includes(".."), { message: "A path in `scripts` is relative to the config, inside the project." })).meta({
 		title: "Scripts",
-		description: "Files a team that links this system runs from its installed sources, such as a migration script that reads their old config and writes their new one, as paths relative to the config: `src/migrate/convert.ts`. Each is sealed, pushed and installed with the system's sources, at `src/uds/registry/<slug>/<path>` in a linking project, but never emitted, so it runs as written against the authoring package and may read the config. A file apps import at runtime ships without being listed."
+		description: "Files a team that links this system runs from its installed sources, such as a migration script that reads their old config and writes their new one, as paths relative to the config: `src/migrate/convert.ts`. Each is sealed, pushed and installed with the system's sources, at `src/uds/linked/<slug>/<path>` in a linking project, but never emitted, so it runs as written against the authoring package and may read the config. A file apps import at runtime ships without being listed."
 	}).optional(),
 	/** Where `uds build` writes. A CLI `--output-dir` still wins, because a one-off build into a
 	*  scratch directory is not a property of the system. */
@@ -100,7 +100,7 @@ const buildFields = z.strictObject({
 	/** The prefix sources are imported by — see `resolveSourceAlias`. */
 	sourceAlias: z.string().min(1).refine((value) => !value.endsWith("/") && !value.includes("*"), { message: "`sourceAlias` is a prefix, written without a trailing `/` or `*`." }).meta({
 		title: "Source alias",
-		description: `The prefix this system's sources are imported by, for their types — \`${BUILD_DEFAULTS.sourceAlias}/components/card\`, and a linked system's as \`${BUILD_DEFAULTS.sourceAlias}/registry/<slug>/…\`. \`uds install\` and \`uds build\` write the tsconfig paths it needs, and the loader rewrites it to the output alias at build time. Unset, \`${BUILD_DEFAULTS.sourceAlias}\`.`,
+		description: `The prefix this system's sources are imported by, for their types — \`${BUILD_DEFAULTS.sourceAlias}/components/card\`, and a linked system's as \`${BUILD_DEFAULTS.sourceAlias}/linked/<slug>/…\`. \`uds install\` and \`uds build\` write the tsconfig paths it needs, and the loader rewrites it to the output alias at build time. Unset, \`${BUILD_DEFAULTS.sourceAlias}\`.`,
 		default: BUILD_DEFAULTS.sourceAlias
 	}).optional(),
 	/** The prefix build output is imported by — see `resolveOutputAlias`. */
@@ -109,11 +109,11 @@ const buildFields = z.strictObject({
 		description: `The prefix this system's build output is imported by — \`${BUILD_DEFAULTS.outputAlias}/components/card\` — which the tsconfig maps onto \`outDir\`. Unset, \`${BUILD_DEFAULTS.outputAlias}\`.`,
 		default: BUILD_DEFAULTS.outputAlias
 	}).optional(),
-	/** Where `uds pull` materializes linked-system sources — see `resolveRegistryDir`. */
-	registryDir: z.string().min(1).meta({
-		title: "Registry directory",
-		description: `Where \`uds install\` places the sources of linked systems, relative to the config. Unset, \`registry/\` beside the system's components: \`${BUILD_DEFAULTS.registryDir}\` unless \`inputDir\` names another root.`,
-		default: BUILD_DEFAULTS.registryDir
+	/** Where `uds install` materializes linked-system sources — see `resolveLinkedDir`. */
+	linkedDir: z.string().min(1).meta({
+		title: "Linked directory",
+		description: `Where \`uds install\` places the sources of linked systems, relative to the config. Unset, \`linked/\` beside the system's components: \`${BUILD_DEFAULTS.linkedDir}\` unless \`inputDir\` names another root.`,
+		default: BUILD_DEFAULTS.linkedDir
 	}).optional(),
 	/**
 	* The React major the app this repo builds for runs — see `appBuildReact` in the CLI.

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

@@ -38,7 +38,7 @@ declare const ReactNativeSystemDefinition: ConfigClass<{
       outDir: _$zod.ZodOptional<_$zod.ZodString>;
       sourceAlias: _$zod.ZodOptional<_$zod.ZodString>;
       outputAlias: _$zod.ZodOptional<_$zod.ZodString>;
-      registryDir: _$zod.ZodOptional<_$zod.ZodString>;
+      linkedDir: _$zod.ZodOptional<_$zod.ZodString>;
       react: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodLiteral<18>, _$zod.ZodLiteral<19>]>>;
     }, _$zod_v4_core0.$strict>>;
     css: _$zod.ZodOptional<_$zod.ZodObject<{
@@ -57,6 +57,13 @@ declare const ReactNativeSystemDefinition: ConfigClass<{
       pagesDir: _$zod.ZodOptional<_$zod.ZodString>;
       port: _$zod.ZodOptional<_$zod.ZodNumber>;
     }, _$zod_v4_core0.$strict>>;
+    lint: _$zod.ZodOptional<_$zod.ZodObject<{
+      rules: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodEnum<{
+        error: "error";
+        off: "off";
+        warn: "warn";
+      }>>>;
+    }, _$zod_v4_core0.$strict>>;
   }, "css" | "playground" | "canvas"> & {
     canvas: _$zod.ZodOptional<_$zod.ZodObject<{
       packageAliases: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodString>>;

package/dist/configs/system.js

@@ -24,6 +24,8 @@ import { motionCompatibilityMigration } from "../migrations/20261016164316_motio
 import { nativeStyleArraysAndAutoMigration } from "../migrations/20261016201727_native_style_arrays_and_auto.js";
 import { buildExcludeMigration } from "../migrations/20261019165323_build_exclude.js";
 import { nativeLinearGradientsMigration } from "../migrations/20261020173914_native_linear_gradients.js";
+import { linkedDirMigration } from "../migrations/20261020182408_linked_dir.js";
+import { lintSettingsMigration } from "../migrations/20261020183330_lint_settings.js";
 import { CanvasRole } from "../entities/system/CanvasRole.js";
 import { GlobalStyle } from "../entities/system/GlobalStyle.js";
 import { Guidance } from "../entities/system/Guidance.js";
@@ -179,5 +181,7 @@ if (!registeredSchemaMigrations().has(20261016164316)) registerSchemaMigrations(
 if (!registeredSchemaMigrations().has(20261016201727)) registerSchemaMigrations(nativeStyleArraysAndAutoMigration);
 if (!registeredSchemaMigrations().has(20261019165323)) registerSchemaMigrations(buildExcludeMigration);
 if (!registeredSchemaMigrations().has(20261020173914)) registerSchemaMigrations(nativeLinearGradientsMigration);
+if (!registeredSchemaMigrations().has(20261020182408)) registerSchemaMigrations(linkedDirMigration);
+if (!registeredSchemaMigrations().has(20261020183330)) registerSchemaMigrations(lintSettingsMigration);
 //#endregion
 export { System };

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

@@ -29,7 +29,7 @@ declare const NativeSettings: EntityClass<z.ZodObject<Omit<{
     outDir: z.ZodOptional<z.ZodString>;
     sourceAlias: z.ZodOptional<z.ZodString>;
     outputAlias: z.ZodOptional<z.ZodString>;
-    registryDir: z.ZodOptional<z.ZodString>;
+    linkedDir: z.ZodOptional<z.ZodString>;
     react: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<18>, z.ZodLiteral<19>]>>;
   }, z.core.$strict>>;
   css: z.ZodOptional<z.ZodObject<{
@@ -48,6 +48,13 @@ declare const NativeSettings: EntityClass<z.ZodObject<Omit<{
     pagesDir: z.ZodOptional<z.ZodString>;
     port: z.ZodOptional<z.ZodNumber>;
   }, z.core.$strict>>;
+  lint: z.ZodOptional<z.ZodObject<{
+    rules: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
+      error: "error";
+      off: "off";
+      warn: "warn";
+    }>>>;
+  }, z.core.$strict>>;
 }, "css" | "playground" | "canvas"> & {
   canvas: z.ZodOptional<z.ZodObject<{
     packageAliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;

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

@@ -14,7 +14,7 @@ import { z } from "zod";
 /**
  * A link's slug, as a single path segment.
  *
- * The slug is more than a key: `uds install` writes one registry folder per link and names it this, so
+ * The slug is more than a key: `uds install` writes one folder per link and names it this, so
  * a slug that isn't a path segment is one the install step can't use, and `../..` would be a traversal
  * handed to a file write. Stated here on the entity so the rule has one home — the install refuses
  * with it, an authoring UI can say so before submitting, and an AI tool creating a link is bound by it

package/dist/entities/system/LinkedSystem.js

@@ -50,7 +50,7 @@ const EXACT_VERSION = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/
 /**
 * A link's slug, as a single path segment.
 *
-* The slug is more than a key: `uds install` writes one registry folder per link and names it this, so
+* The slug is more than a key: `uds install` writes one folder per link and names it this, so
 * a slug that isn't a path segment is one the install step can't use, and `../..` would be a traversal
 * handed to a file write. Stated here on the entity so the rule has one home — the install refuses
 * with it, an authoring UI can say so before submitting, and an AI tool creating a link is bound by it

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

@@ -22,7 +22,7 @@ declare const BuildSectionDefinition: SubEntityClass<z.ZodObject<{
   outDir: z.ZodOptional<z.ZodString>;
   sourceAlias: z.ZodOptional<z.ZodString>;
   outputAlias: z.ZodOptional<z.ZodString>;
-  registryDir: z.ZodOptional<z.ZodString>;
+  linkedDir: z.ZodOptional<z.ZodString>;
   react: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<18>, z.ZodLiteral<19>]>>;
 }, z.core.$strict>>;
 interface BuildSectionClass extends Named<typeof BuildSectionDefinition> {}
@@ -96,6 +96,16 @@ declare const PlaygroundSectionDefinition: SubEntityClass<z.ZodObject<{
 }, z.core.$strict>>;
 interface PlaygroundSectionClass extends Named<typeof PlaygroundSectionDefinition> {}
 declare const PlaygroundSection: PlaygroundSectionClass;
+/** The `lint` section — the authoring lint `uds lint` runs. */
+declare const LintSectionDefinition: SubEntityClass<z.ZodObject<{
+  rules: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
+    error: "error";
+    off: "off";
+    warn: "warn";
+  }>>>;
+}, z.core.$strict>>;
+interface LintSectionClass extends Named<typeof LintSectionDefinition> {}
+declare const LintSection: LintSectionClass;
 /**
  * {@link derivedInputDir} over paths alone, for a build that has walked its source graph but not yet
  * written the `file` rows the computed `inputDir` reads. `components` are the config-relative paths
@@ -114,7 +124,7 @@ declare const SettingsDefinition: EntityClass<z.ZodObject<{
     outDir: z.ZodOptional<z.ZodString>;
     sourceAlias: z.ZodOptional<z.ZodString>;
     outputAlias: z.ZodOptional<z.ZodString>;
-    registryDir: z.ZodOptional<z.ZodString>;
+    linkedDir: z.ZodOptional<z.ZodString>;
     react: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<18>, z.ZodLiteral<19>]>>;
   }, z.core.$strict>>;
   css: z.ZodOptional<z.ZodObject<{
@@ -133,6 +143,13 @@ declare const SettingsDefinition: EntityClass<z.ZodObject<{
     pagesDir: z.ZodOptional<z.ZodString>;
     port: z.ZodOptional<z.ZodNumber>;
   }, z.core.$strict>>;
+  lint: z.ZodOptional<z.ZodObject<{
+    rules: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
+      error: "error";
+      off: "off";
+      warn: "warn";
+    }>>>;
+  }, z.core.$strict>>;
 }, z.core.$strict>, z.ZodObject<Record<never, never>, z.core.$strip>, "settings", {}, {
   /**
    * The directory this system's component files are laid out beneath, always defined:
@@ -147,4 +164,4 @@ declare const SettingsDefinition: EntityClass<z.ZodObject<{
 interface SettingsClass extends Named<typeof SettingsDefinition> {}
 declare const Settings: SettingsClass;
 //#endregion
-export { BuildSection, BuildSectionClass, CSS_DEFAULTS, CssPrefix, CssSection, CssSectionClass, PLAYGROUND_DEFAULTS, PlaygroundSection, PlaygroundSectionClass, Settings, SettingsClass, SystemSection, SystemSectionClass, classPrefixOf, cssPrefixes, deriveInputDir, prefixed, varPrefixOf };
+export { BuildSection, BuildSectionClass, CSS_DEFAULTS, CssPrefix, CssSection, CssSectionClass, LintSection, LintSectionClass, PLAYGROUND_DEFAULTS, PlaygroundSection, PlaygroundSectionClass, Settings, SettingsClass, SystemSection, SystemSectionClass, classPrefixOf, cssPrefixes, deriveInputDir, prefixed, varPrefixOf };

package/dist/entities/system/Settings.js

@@ -4,7 +4,7 @@ import { defineSubEntity } from "../../framework/defineSubEntity.js";
 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/registry-dir.js";
+import { resolveInputDir } from "../../framework/build-dirs.js";
 import { safelistSchema } from "./safelist.js";
 import { z } from "zod";
 //#region src/entities/system/Settings.ts
@@ -168,6 +168,28 @@ const PlaygroundSection = defineSubEntity({
 	singleton: true,
 	fields: playgroundFields
 });
+const lintFields = z.strictObject({ 
+/**
+* How loud each authoring lint rule is, by rule or by group — `{ editability: 'off',
+* 'inline-style-on-layer': 'error' }`. A rule's own entry wins over its group's; a rule named
+* neither way takes its default, a warning for most. A group never turns on a rule that is off by
+* default. Keyed by name rather than an enum, so a rule the build adds later needs no new schema; a
+* name that is no rule or group is reported, not refused.
+*/
+rules: z.record(z.string(), z.enum([
+	"off",
+	"warn",
+	"error"
+])).meta({
+	title: "Rules",
+	description: "A severity — `'off'`, `'warn'` or `'error'` — per authoring lint rule or per group of them (`portability`, `editability`, `compatibility`, `nursery`): `{ editability: 'off' }` for a system nobody edits in a visual editor such as Create. A `nursery` rule runs only when named on its own. A rule's own entry wins over its group's. Unset, most rules warn. An `'error'` makes `uds lint` exit with status 1, so a CI step that runs it fails. One site is quieted with `// uds-lint-ignore <rule>: <why>` on its line or the line above."
+}).optional() });
+const LintSection = defineSubEntity({
+	name: "lint",
+	label: "Lint",
+	singleton: true,
+	fields: lintFields
+});
 /** The folders of a path, file name dropped. */
 const foldersOf = (file) => file.split("/").slice(0, -1);
 /** The folders every one of `lists` starts with. */
@@ -238,6 +260,23 @@ function deriveInputDir(components, reached) {
 	for (let end = shared.length; end >= 2; end -= 1) if (shared[end - 2] === "uds" && shared[end - 1] === "components") return shared.slice(0, end).join("/");
 	return sharedFolders(reached().map(foldersOf)).join("/");
 }
+/**
+* `build.registryDir`, the spelling `build.linkedDir` had before its rename, stored as `linkedDir`. An
+* old seal's `uds.config.ts` still sets it, and `uds pull` still materializes that source. Neither the
+* schema nor the authoring types offer it.
+*/
+function linkedDirFromRegistryDir(body) {
+	const build = body.build;
+	if (typeof build !== "object" || build === null || !("registryDir" in build)) return body;
+	const { registryDir, ...rest } = build;
+	return {
+		...body,
+		build: "linkedDir" in rest ? rest : {
+			...rest,
+			linkedDir: registryDir
+		}
+	};
+}
 const Settings = defineEntity({
 	kind: "settings",
 	label: "Settings",
@@ -245,17 +284,20 @@ const Settings = defineEntity({
 	singleton: true,
 	linkable: false,
 	authoredRefs: false,
+	authoredBody: linkedDirFromRegistryDir,
 	fields: z.strictObject({
 		system: systemFields.meta({ title: "System" }).optional(),
 		build: buildFields.meta({ title: "Build" }).optional(),
 		css: cssFields.meta({ title: "CSS" }).optional(),
-		playground: playgroundFields.meta({ title: "Playground" }).optional()
+		playground: playgroundFields.meta({ title: "Playground" }).optional(),
+		lint: lintFields.meta({ title: "Lint" }).optional()
 	}),
 	subEntities: {
 		system: SystemSection,
 		build: BuildSection,
 		css: CssSection,
-		playground: PlaygroundSection
+		playground: PlaygroundSection,
+		lint: LintSection
 	},
 	computed: { 
 	/**
@@ -266,4 +308,4 @@ const Settings = defineEntity({
 inputDir: ({ member, config }) => resolveInputDir(member.build) ?? derivedInputDir(config) }
 });
 //#endregion
-export { BuildSection, CSS_DEFAULTS, CssSection, PLAYGROUND_DEFAULTS, PlaygroundSection, Settings, SystemSection, classPrefixOf, cssPrefixes, deriveInputDir, prefixed, varPrefixOf };
+export { BuildSection, CSS_DEFAULTS, CssSection, LintSection, PLAYGROUND_DEFAULTS, PlaygroundSection, Settings, SystemSection, classPrefixOf, cssPrefixes, deriveInputDir, prefixed, varPrefixOf };

package/dist/entities/system/shipped-modules.d.ts

@@ -4,7 +4,7 @@ import { Config } from "../../framework/Config.js";
 /**
  * The modules a system ships beside its components: every source file under its `inputDir` that no
  * component reaches, so an app imports it on its own (`#uds/components/toast-portal`) and a system
- * that links this one emits it too (`@/uds/registry/<slug>/toast-portal`).
+ * that links this one emits it too (`@/uds/linked/<slug>/toast-portal`).
  *
  * One rule, read three ways. The owner's build emits these, the server serves them with a linked
  * version, and a linking build emits them from the installed tree. Each reads it from the same

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

package/dist/framework/Config.js

@@ -5862,7 +5862,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 > 20261020173914) throw new SchemaVersionTooNew(claimed);
+		if (claimed > 20261020183330) 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;
@@ -6196,7 +6196,8 @@ function extensionChange(entry, kind, path, raw, validate = false) {
 * every load.
 */
 function itemChange(entry, kind, path, raw, validate = false) {
-	const def = isRef(raw) || isComposedValue(raw) || typeof raw !== "object" || raw === null ? { [entry.primaryField]: raw } : raw;
+	const body = isRef(raw) || isComposedValue(raw) || typeof raw !== "object" || raw === null ? { [entry.primaryField]: raw } : raw;
+	const def = validate === "author" && entry.authoredBody ? entry.authoredBody(body) : body;
 	if (validate) {
 		const parsed = wholeBodySchema(entry)?.safeParse(def);
 		if (parsed && !parsed.success) {

package/dist/framework/{registry-dir.d.ts → build-dirs.d.ts}

@@ -1,20 +1,20 @@
-//#region src/framework/registry-dir.d.ts
+//#region src/framework/build-dirs.d.ts
 /**
- * Where a project's build directories live, relative to the project root — the registry it pulls
- * into, the directory it writes to, and the one it is allowed to read from.
+ * Where a project's build directories live, relative to the project root — the directory it installs
+ * linked systems into, the directory it writes to, and the one it is allowed to read from.
  *
  * One resolution rule each, shared by every consumer, because a default spelled at the call site is
  * a default that drifts: `.uds` was written out at eight of them before this.
  *
- * The registry half is shared by `uds pull` (writes the registry), `uds build` (regenerates linked
- * CSS from it), the bundler loaders (skip its files), and the push seal (excludes its files from a
- * consumer's own sealed sources): `build.registryDir` when the consumer sets one, else `registry/`
- * beside the system's components — `src/uds/registry` in the conventional layout.
+ * The linked half is shared by `uds install` (writes into it), `uds build` (regenerates linked CSS
+ * from it), the bundler loaders (skip its files), and the push seal (excludes its files from a
+ * consumer's own sealed sources): `build.linkedDir` when the consumer sets one, else `linked/` beside
+ * the system's components — `src/uds/linked` in the conventional layout.
  */
 /** The build setting this reads — structural, so a caller passes `Settings.get(config)?.build`, or
  *  the bare `build` record of an artifact it never loaded. */
-interface RegistryDirOptions {
-  registryDir?: string;
+interface LinkedDirOptions {
+  linkedDir?: string;
   inputDir?: string;
 }
 /** The build settings the directory resolvers read. Structural for the same reason. */
@@ -29,20 +29,33 @@ interface AliasOptions {
 }
 /** The prefix a system's sources are imported by (`@/uds`), for their types. */
 declare function resolveSourceAlias(buildOptions: AliasOptions | undefined): string;
+/** The prefix a system's linked systems are imported by, beneath its source alias: `@/uds/linked/`,
+ *  as in `@/uds/linked/<slug>/button`. Their build output is `#uds/components/_linked/<slug>/…`. */
+declare function resolveLinkedAlias(buildOptions: AliasOptions | undefined): string;
 /** The prefix a system's build output is imported by (`#uds`), mapped onto its `outDir`. */
 declare function resolveOutputAlias(buildOptions: AliasOptions | undefined): string;
 /**
- * Project-root-relative POSIX path of the linked-system registry.
+ * Project-root-relative POSIX path of the directory linked systems are installed in.
  *
- * Unset, it sits beside the system's own components: `registry/` under the root its `inputDir` names
- * (`components` itself dropped, so `src/uds/components` and `src/uds` both give `src/uds/registry`),
+ * Unset, it sits beside the system's own components: `linked/` under the root its `inputDir` names
+ * (`components` itself dropped, so `src/uds/components` and `src/uds` both give `src/uds/linked`),
  * or under `src/uds` when none is declared. Linked sources are then imported the way the system's own
- * are, `@/uds/registry/<slug>/…` beside `@/uds/components/…`.
+ * are, `@/uds/linked/<slug>/…` beside `@/uds/components/…`, and their build output sits at
+ * `#uds/components/_linked/<slug>/…`.
  *
  * Read from the AUTHORED settings only, never the derived `inputDir`: a loader that has nothing but a
  * built `config.json` has to land on the same directory the build did.
  */
-declare function resolveRegistryDir(buildOptions: RegistryDirOptions | undefined): string;
+declare function resolveLinkedDir(buildOptions: LinkedDirOptions | undefined): string;
+/**
+ * Where an unset `linkedDir` pointed before it was renamed from `registryDir`: `registry/` beside the
+ * components, `src/uds/registry` in the conventional layout. `undefined` for a system that names its
+ * own `linkedDir`, whose directory never moved.
+ *
+ * Read by `uds install`, which empties it of the entries it installed there, and by the tsconfig
+ * writer, which takes back the aliases and the `exclude` entry that pointed into it.
+ */
+declare function resolveRetiredLinkedDir(buildOptions: LinkedDirOptions | undefined): string | undefined;
 /**
  * Project-root-relative POSIX path of the build output directory.
  *
@@ -59,4 +72,4 @@ declare function resolveOutDir(buildOptions: BuildDirOptions | undefined): strin
  */
 declare function resolveInputDir(buildOptions: BuildDirOptions | undefined): string | undefined;
 //#endregion
-export { resolveInputDir, resolveOutDir, resolveOutputAlias, resolveRegistryDir, resolveSourceAlias };
+export { resolveInputDir, resolveLinkedAlias, resolveLinkedDir, resolveOutDir, resolveOutputAlias, resolveRetiredLinkedDir, resolveSourceAlias };

package/dist/framework/build-dirs.js

@@ -0,0 +1,95 @@
+import { BUILD_DEFAULTS } from "../configs/build-options.js";
+//#region src/framework/build-dirs.ts
+/**
+* Where a project's build directories live, relative to the project root — the directory it installs
+* linked systems into, the directory it writes to, and the one it is allowed to read from.
+*
+* One resolution rule each, shared by every consumer, because a default spelled at the call site is
+* a default that drifts: `.uds` was written out at eight of them before this.
+*
+* The linked half is shared by `uds install` (writes into it), `uds build` (regenerates linked CSS
+* from it), the bundler loaders (skip its files), and the push seal (excludes its files from a
+* consumer's own sealed sources): `build.linkedDir` when the consumer sets one, else `linked/` beside
+* the system's components — `src/uds/linked` in the conventional layout.
+*/
+/** The prefix a system's sources are imported by (`@/uds`), for their types. */
+function resolveSourceAlias(buildOptions) {
+	return normalize(buildOptions?.sourceAlias ?? BUILD_DEFAULTS.sourceAlias);
+}
+/** The prefix a system's linked systems are imported by, beneath its source alias: `@/uds/linked/`,
+*  as in `@/uds/linked/<slug>/button`. Their build output is `#uds/components/_linked/<slug>/…`. */
+function resolveLinkedAlias(buildOptions) {
+	return `${resolveSourceAlias(buildOptions)}/${LINKED_FOLDER}/`;
+}
+/** The prefix a system's build output is imported by (`#uds`), mapped onto its `outDir`. */
+function resolveOutputAlias(buildOptions) {
+	return normalize(buildOptions?.outputAlias ?? BUILD_DEFAULTS.outputAlias);
+}
+/** Scanned rather than matched with `/\/+$/`: anchoring a repeated group at the end makes the engine
+*  backtrack across the whole run, which is quadratic on a path that is all slashes. */
+const normalize = (p) => {
+	const posix = p.replace(/\\/g, "/");
+	let end = posix.length;
+	while (end > 0 && posix[end - 1] === "/") end--;
+	return posix.slice(0, end);
+};
+/** The folder an unset `linkedDir` names beside the components. */
+const LINKED_FOLDER = "linked";
+/** The folder it named before `registryDir` became `linkedDir`. */
+const RETIRED_LINKED_FOLDER = "registry";
+/**
+* Project-root-relative POSIX path of the directory linked systems are installed in.
+*
+* Unset, it sits beside the system's own components: `linked/` under the root its `inputDir` names
+* (`components` itself dropped, so `src/uds/components` and `src/uds` both give `src/uds/linked`),
+* or under `src/uds` when none is declared. Linked sources are then imported the way the system's own
+* are, `@/uds/linked/<slug>/…` beside `@/uds/components/…`, and their build output sits at
+* `#uds/components/_linked/<slug>/…`.
+*
+* Read from the AUTHORED settings only, never the derived `inputDir`: a loader that has nothing but a
+* built `config.json` has to land on the same directory the build did.
+*/
+function resolveLinkedDir(buildOptions) {
+	if (buildOptions?.linkedDir) return normalize(buildOptions.linkedDir);
+	return besideComponents(buildOptions, LINKED_FOLDER);
+}
+/**
+* Where an unset `linkedDir` pointed before it was renamed from `registryDir`: `registry/` beside the
+* components, `src/uds/registry` in the conventional layout. `undefined` for a system that names its
+* own `linkedDir`, whose directory never moved.
+*
+* Read by `uds install`, which empties it of the entries it installed there, and by the tsconfig
+* writer, which takes back the aliases and the `exclude` entry that pointed into it.
+*/
+function resolveRetiredLinkedDir(buildOptions) {
+	if (buildOptions?.linkedDir) return void 0;
+	return besideComponents(buildOptions, RETIRED_LINKED_FOLDER);
+}
+/** `folder` under the root the authored `inputDir` names, `components` itself dropped. */
+function besideComponents(buildOptions, folder) {
+	const inputDir = buildOptions?.inputDir ? normalize(buildOptions.inputDir) : BUILD_DEFAULTS.inputRoot;
+	const root = inputDir === "components" ? "" : inputDir.replace(/\/components$/, "");
+	return root ? `${root}/${folder}` : folder;
+}
+/**
+* Project-root-relative POSIX path of the build output directory.
+*
+* The schema's default unless the system says otherwise. A CLI `--output-dir` overrides both, which is
+* why this takes only the config: a scratch build is the caller's business, not the system's.
+*/
+function resolveOutDir(buildOptions) {
+	return normalize(buildOptions?.outDir ?? BUILD_DEFAULTS.outDir);
+}
+/**
+* Config-relative POSIX path of the directory every sealed file must live under, or `undefined` when
+* the system declares none.
+*
+* `undefined` is not a default in disguise — it is the answer that keeps the `uds/components/`
+* anchor convention in charge, so a config that never set this emits exactly what it emitted before.
+*/
+function resolveInputDir(buildOptions) {
+	if (!buildOptions?.inputDir) return void 0;
+	return normalize(buildOptions.inputDir);
+}
+//#endregion
+export { resolveInputDir, resolveLinkedAlias, resolveLinkedDir, resolveOutDir, resolveOutputAlias, resolveRetiredLinkedDir, resolveSourceAlias };

package/dist/framework/defineEntity.d.ts

@@ -324,7 +324,8 @@ declare function defineEntity<F extends FieldsSchema, G extends FieldsSchema = z
    *  {@link EntityKind.mentionFields}. */
   mentionFields?: readonly string[]; /** Cross-item rules the kind holds — see {@link EntityKind.invariants}. */
   invariants?: (config: Config) => string[]; /** See {@link EntityKind.structuralBody}. */
-  structuralBody?: (data: unknown) => Record<string, unknown>;
+  structuralBody?: (data: unknown) => Record<string, unknown>; /** See {@link EntityKind.authoredBody}. */
+  authoredBody?: (data: Record<string, unknown>) => Record<string, unknown>;
   /**
    * For a source kind that can be resolved: the two schemas its resolutions are validated against —
    * `{ resolved, unavailable }`. Declare it alongside `sourceIdentity` for a kind a config lists in its

package/dist/framework/defineEntity.js

@@ -134,7 +134,8 @@ function defineEntity(spec) {
 		authoredValue: spec.authoredValue,
 		mentionFields: spec.mentionFields,
 		invariants: spec.invariants,
-		structuralBody: spec.structuralBody
+		structuralBody: spec.structuralBody,
+		authoredBody: spec.authoredBody
 	});
 	const schema = refTo(spec.kind);
 	/**

package/dist/framework/registry.d.ts

@@ -352,6 +352,14 @@ interface EntityKind {
    * which refuses the delete. `group-delete` does not cascade.
    */
   readonly structuralBody?: (data: unknown) => Record<string, unknown>;
+  /**
+   * Rewrite a body authored in a spelling this kind has retired into the one it stores, before it is
+   * validated. A `uds.config.ts` written against an older version still evaluates: `uds pull`
+   * materializes the source an old seal holds, so a renamed field has to keep being accepted where
+   * it is authored. Only `register` runs it. A stored artifact or patch comes through the migration
+   * that renamed the field instead.
+   */
+  readonly authoredBody?: (data: Record<string, unknown>) => Record<string, unknown>;
   /**
    * Rewrite one name wherever this kind's data holds it as a key — the cascade half of
    * {@link nameEdges}, applied by `Config.apply`'s rename alongside `rewriteRefs`.

package/dist/framework/registry.js

@@ -32,7 +32,7 @@ function titleCase(kind) {
 /** Derive a kind's immutable metadata from its field schemas — the value a `defineEntity`/
 *  `defineDerivedEntity` attaches to its class and a `Config.register` stores in `#entities`. */
 function buildKind(spec) {
-	const { name, prepareLinkedBody, rebaseLinkedBody, layerKeys, fields, groupFields, subEntities = {}, computed, label, labelPlural, schemas: userSchemas, derived, sourceIdentity, sourceOrigin, authoredRefs, linkable, localGroupFields, emergentGroups, singleton = false, bareMember, sourceResolution, bulkAdopts, bulkExcludes, bulkOverlay, bulkDirectives, bulkOverlayWrite, nameEdges, rewriteName, styleBags, uniqueLeaves, authoredValue, mentionFields, invariants, structuralBody } = spec;
+	const { name, prepareLinkedBody, rebaseLinkedBody, layerKeys, fields, groupFields, subEntities = {}, computed, label, labelPlural, schemas: userSchemas, derived, sourceIdentity, sourceOrigin, authoredRefs, linkable, localGroupFields, emergentGroups, singleton = false, bareMember, sourceResolution, bulkAdopts, bulkExcludes, bulkOverlay, bulkDirectives, bulkOverlayWrite, nameEdges, rewriteName, styleBags, uniqueLeaves, authoredValue, mentionFields, invariants, structuralBody, authoredBody } = spec;
 	const allComputed = {
 		sources: ({ member, config }) => sourceSlugs(member, config),
 		borrowedFrom: ({ config, path }) => config.borrowedFrom(name, path),
@@ -84,7 +84,8 @@ function buildKind(spec) {
 		...authoredValue ? { authoredValue } : {},
 		...mentionFields?.length ? { mentionFields } : {},
 		...invariants ? { invariants } : {},
-		...structuralBody ? { structuralBody } : {}
+		...structuralBody ? { structuralBody } : {},
+		...authoredBody ? { authoredBody } : {}
 	};
 }
 /** Every operation a kind exposes — its merged `schemas` map, flattened to `{ kind, verb, ... }`.

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 = 20261020173914;
+declare const CURRENT_SCHEMA_VERSION = 20261020183330;
 /** 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 {