@yahoo/uds-create-config 2.44.0 → 3.0.0

package/dist/asset-value.js

@@ -1,40 +0,0 @@
-//#region src/asset-value.ts
-/**
-* Assemble a `font-family` CSS value from a font member — the primary
-* family (always double-quoted, so multi-word names are valid) followed by
-* its fallback stack. `fallback` rides `FontAssetMember`'s open index as
-* `unknown`, so read it defensively: a `string` is appended verbatim (it
-* may itself be a comma list), a `string[]` is joined, anything else is
-* ignored. Fallback entries are emitted verbatim — they're generic keywords
-* (`sans-serif`) or already-formatted names.
-*/
-function resolveFontStack(member) {
-	const primary = `"${member.fontFamily}"`;
-	const { fallback } = member;
-	if (typeof fallback === "string" && fallback.length > 0) return `${primary}, ${fallback}`;
-	if (Array.isArray(fallback) && fallback.every((entry) => typeof entry === "string")) {
-		const stack = fallback.filter((entry) => entry.length > 0);
-		return stack.length > 0 ? `${primary}, ${stack.join(", ")}` : primary;
-	}
-	return primary;
-}
-/**
-* Resolve a `<slug>/<member>` asset ref to its `font-family` CSS stack.
-* Every failure is a named throw (no silent string fallthrough): a
-* malformed ref, an unregistered group, a non-font group, or a missing
-* member each name the offending ref so config load fails loudly.
-*/
-function resolveAssetRefCss(ref, assetGroups) {
-	const slash = ref.indexOf("/");
-	if (slash <= 0 || slash === ref.length - 1) throw new Error(`asset('${ref}') is malformed — expected a '<group>/<member>' ref.`);
-	const slug = ref.slice(0, slash);
-	const memberName = ref.slice(slash + 1);
-	const group = assetGroups.get(slug);
-	if (!group) throw new Error(`asset('${ref}') — no asset group is registered under slug '${slug}'.`);
-	if (group.assetKind !== "font") throw new Error(`asset('${ref}') — group '${slug}' is a '${group.assetKind}' group; only font groups can be referenced as a token value.`);
-	const member = group.members?.[memberName];
-	if (!member) throw new Error(`asset('${ref}') — member '${memberName}' is not registered in font group '${slug}'.`);
-	return resolveFontStack(member);
-}
-//#endregion
-export { resolveAssetRefCss, resolveFontStack };

package/dist/brands.d.ts

@@ -1,30 +0,0 @@
-//#region src/brands.d.ts
-/**
- * Branded CSS string types.
- *
- * Every member that emits CSS — variable refs, selectors, class names,
- * declarations — returns a `Css<Kind>` instead of a plain `string`. The
- * brand erases at runtime; the compiler uses it to catch raw user strings
- * being passed into a CSS-emission slot.
- *
- * Brands are a one-way door: once they flow through the codegen surface
- * we lean on them at every emission site, so we lock the shape in here.
- */
-type Css<Kind extends string> = string & {
-  readonly __cssBrand: Kind;
-};
-type CssVar = Css<'var'>;
-type CssSelector = Css<'selector'>;
-type CssClassName = Css<'className'>;
-type CssDeclaration = Css<'declaration'>;
-/**
- * Stamp a plain string with a CSS brand. The brand is a phantom — no
- * runtime work. All emission helpers funnel through these so the cast
- * lives in one place.
- */
-declare function cssVar(value: string): CssVar;
-declare function cssSelector(value: string): CssSelector;
-declare function cssClassName(value: string): CssClassName;
-declare function cssDeclaration(value: string): CssDeclaration;
-//#endregion
-export { Css, CssClassName, CssDeclaration, CssSelector, CssVar, cssClassName, cssDeclaration, cssSelector, cssVar };

package/dist/brands.js

@@ -1,20 +0,0 @@
-//#region src/brands.ts
-/**
-* Stamp a plain string with a CSS brand. The brand is a phantom — no
-* runtime work. All emission helpers funnel through these so the cast
-* lives in one place.
-*/
-function cssVar(value) {
-	return value;
-}
-function cssSelector(value) {
-	return value;
-}
-function cssClassName(value) {
-	return value;
-}
-function cssDeclaration(value) {
-	return value;
-}
-//#endregion
-export { cssClassName, cssDeclaration, cssSelector, cssVar };

package/dist/captureCallerPath.d.ts

@@ -1,48 +0,0 @@
-//#region src/captureCallerPath.d.ts
-/**
- * Inspect the current call stack and return the first frame whose file
- * path sits outside the `@yahoo/uds-create-config` package itself — i.e. the
- * user's authoring site.
- *
- * Stashing the path at definition time gives every config object its
- * origin for free. Consumers (codegen, CSS scanner, AI prompt builder)
- * read `__sourcePath` off the config map directly instead of walking
- * the AST to re-derive where each registration was authored.
- *
- * The skip predicate matches `/packages/config/` (workspace
- * layout) and `/@yahoo/uds-create-config/` (consumer node_modules layout) so
- * internal frames never leak through. Returns `undefined` when no
- * eligible frame is found.
- *
- * Stack format coverage:
- *  - Bun / V8 in-process: `    at fn (/abs/path.ts:L:C)` or bare
- *    `    at /abs/path.ts:L:C` (no parens).
- *  - Node native stacks: `file:///abs/path.ts:L:C` URL form.
- *  - Source-mapped frames downleveled through tsdown: `.js` files.
- *
- * The regex picks the first `(...).ext:line:col` token; the
- * surrounding `at fn` / paren wrapping is ignored.
- */
-declare function captureCallerPath(): string | undefined;
-/**
- * Non-enumerable `__sourcePath` slot key. Centralized so codegen
- * consumers and authoring helpers agree on one spelling.
- */
-declare const SOURCE_PATH_KEY: "__sourcePath";
-/**
- * Attach `__sourcePath` to a config object non-enumerably.
- * `JSON.stringify` ignores non-enumerable properties so the wire format
- * stays clean.
- *
- * No-op when `path` is `undefined` — keeps the config shape stable
- * when the stack-walk yields no eligible frame.
- */
-declare function attachSourcePath<T extends object>(target: T, path: string | undefined): T;
-/**
- * Read `__sourcePath` off a config object. Returns `undefined` when
- * the slot was never set (e.g. configs produced outside the `define*`
- * helpers).
- */
-declare function readSourcePath(target: unknown): string | undefined;
-//#endregion
-export { SOURCE_PATH_KEY, attachSourcePath, captureCallerPath, readSourcePath };

package/dist/captureCallerPath.js

@@ -1,95 +0,0 @@
-//#region src/captureCallerPath.ts
-/**
-* Inspect the current call stack and return the first frame whose file
-* path sits outside the `@yahoo/uds-create-config` package itself — i.e. the
-* user's authoring site.
-*
-* Stashing the path at definition time gives every config object its
-* origin for free. Consumers (codegen, CSS scanner, AI prompt builder)
-* read `__sourcePath` off the config map directly instead of walking
-* the AST to re-derive where each registration was authored.
-*
-* The skip predicate matches `/packages/config/` (workspace
-* layout) and `/@yahoo/uds-create-config/` (consumer node_modules layout) so
-* internal frames never leak through. Returns `undefined` when no
-* eligible frame is found.
-*
-* Stack format coverage:
-*  - Bun / V8 in-process: `    at fn (/abs/path.ts:L:C)` or bare
-*    `    at /abs/path.ts:L:C` (no parens).
-*  - Node native stacks: `file:///abs/path.ts:L:C` URL form.
-*  - Source-mapped frames downleveled through tsdown: `.js` files.
-*
-* The regex picks the first `(...).ext:line:col` token; the
-* surrounding `at fn` / paren wrapping is ignored.
-*/
-const INTERNAL_FRAME_MARKERS = ["/packages/config/", "/@yahoo/uds-create-config/"];
-const FRAME_PATH_RE = /\(?(?:file:\/\/)?(\/[^):\s]+?\.[cm]?[jt]sx?):\d+(?::\d+)?\)?/;
-const TEST_FILE_RE = /\.test\.[jt]sx?$/;
-function isInternalFrame(path) {
-	if (TEST_FILE_RE.test(path)) return false;
-	return INTERNAL_FRAME_MARKERS.some((marker) => path.includes(marker));
-}
-/**
-* `@yahoo/uds-create-codegen`'s `loadConfig` bundles `uds.config.ts` with
-* `Bun.build` and runs the bundle from `<cwd>/.uds/config-bundle/`.
-* The bundle's inline sourcemap maps frames back to paths *relative
-* to the bundle output dir* — e.g.
-* `apps/studio/.uds/config-bundle/src/uds/components/button.tsx`,
-* not the original `apps/studio/src/uds/components/button.tsx`.
-* Strip the segment so `Component.sourceFilePath` resolves to a
-* readable on-disk path. Matches `/.uds/config-bundle/` so it's
-* agnostic to which app the bundle was emitted under.
-*/
-const CONFIG_BUNDLE_PATH_SEGMENT = "/.uds/config-bundle/";
-function normalizeBundlePath(path) {
-	const idx = path.indexOf(CONFIG_BUNDLE_PATH_SEGMENT);
-	if (idx === -1) return path;
-	return path.slice(0, idx + 1) + path.slice(idx + 20);
-}
-function captureCallerPath() {
-	const stack = (/* @__PURE__ */ new Error()).stack;
-	if (!stack) return void 0;
-	for (const line of stack.split("\n")) {
-		const match = line.match(FRAME_PATH_RE);
-		if (!match) continue;
-		const path = normalizeBundlePath(match[1]);
-		if (isInternalFrame(path)) continue;
-		return path;
-	}
-}
-/**
-* Non-enumerable `__sourcePath` slot key. Centralized so codegen
-* consumers and authoring helpers agree on one spelling.
-*/
-const SOURCE_PATH_KEY = "__sourcePath";
-/**
-* Attach `__sourcePath` to a config object non-enumerably.
-* `JSON.stringify` ignores non-enumerable properties so the wire format
-* stays clean.
-*
-* No-op when `path` is `undefined` — keeps the config shape stable
-* when the stack-walk yields no eligible frame.
-*/
-function attachSourcePath(target, path) {
-	if (!path) return target;
-	Object.defineProperty(target, SOURCE_PATH_KEY, {
-		enumerable: false,
-		configurable: true,
-		writable: true,
-		value: path
-	});
-	return target;
-}
-/**
-* Read `__sourcePath` off a config object. Returns `undefined` when
-* the slot was never set (e.g. configs produced outside the `define*`
-* helpers).
-*/
-function readSourcePath(target) {
-	if (target === null || typeof target !== "object" && typeof target !== "function") return;
-	const value = target[SOURCE_PATH_KEY];
-	return typeof value === "string" ? value : void 0;
-}
-//#endregion
-export { SOURCE_PATH_KEY, attachSourcePath, captureCallerPath, readSourcePath };

package/dist/colorExpressions.d.ts

@@ -1,131 +0,0 @@
-import { TokenRef } from "./refs.js";
-import { CssAngle, CssColor, CssLength, CssPercentage } from "./types/css-values.js";
-
-//#region src/colorExpressions.d.ts
-/** Position used for gradient stops + radial center — a CSS length or percentage. */
-type LengthOrPercent = CssLength | CssPercentage;
-/** Line direction keyword for `linear-gradient(to <dir>, …)`. */
-type LineDirection = 'top' | 'right' | 'bottom' | 'left' | 'top right' | 'top left' | 'bottom right' | 'bottom left';
-/** Color space accepted by `color-mix()` and gradient `<color-interpolation-method>`. */
-type ColorSpace = 'srgb' | 'srgb-linear' | 'oklab' | 'oklch' | 'lab' | 'lch' | 'hsl' | 'hwb';
-/** Radial gradient extent keyword. */
-type RadialSize = 'closest-side' | 'closest-corner' | 'farthest-side' | 'farthest-corner';
-interface MixExpr {
-  readonly __kind: 'mix';
-  readonly from: ColorValue;
-  readonly to: ColorValue;
-  readonly amount: CssPercentage;
-  readonly colorSpace?: ColorSpace;
-}
-/**
- * `darken(color, N)` / `lighten(color, N)` — one-arg shade shorthands that
- * blend a color toward black (darken) or white (lighten) by `amount`%, using
- * `light-dark(...)` so the blend direction flips per color scheme. A focused
- * pair alongside the general `mix`; resolves through the same pipeline.
- */
-interface ShadeExpr {
-  readonly __kind: 'darken' | 'lighten';
-  readonly color: ColorValue;
-  /** Mix percentage toward black/white — `10` → `10%`. */
-  readonly amount: number;
-}
-interface GradientStop {
-  readonly color: ColorValue;
-  readonly at?: LengthOrPercent;
-}
-interface LinearGradientExpr {
-  readonly __kind: 'linear-gradient';
-  readonly angle?: CssAngle | `to ${LineDirection}`;
-  readonly stops: readonly GradientStop[];
-  readonly interpolation?: ColorSpace;
-  readonly repeating?: boolean;
-}
-interface RadialGradientExpr {
-  readonly __kind: 'radial-gradient';
-  readonly shape?: 'circle' | 'ellipse';
-  readonly size?: RadialSize;
-  readonly position?: LengthOrPercent | 'center' | 'top' | 'right' | 'bottom' | 'left';
-  readonly stops: readonly GradientStop[];
-  readonly interpolation?: ColorSpace;
-  readonly repeating?: boolean;
-}
-/**
- * Any expression / marker that resolves to a CSS color value.
- *
- * `TokenRef` here is intentionally un-narrowed by token type. When
- * the `Registered*` augmentations grow a `__type` slot, this can
- * narrow to color-typed tokens — until then runtime + patch
- * validation catches type mismatches.
- */
-type ColorValue = CssColor | TokenRef | MixExpr;
-/** Anything that resolves to a CSS `background-image`-eligible value. */
-type GradientValue = TokenRef | LinearGradientExpr | RadialGradientExpr;
-/** Union of every structured expression authored via these helpers. */
-type ColorExpression = MixExpr | ShadeExpr | LinearGradientExpr | RadialGradientExpr;
-declare function isMixExpr(value: unknown): value is MixExpr;
-declare function isLinearGradientExpr(value: unknown): value is LinearGradientExpr;
-declare function isRadialGradientExpr(value: unknown): value is RadialGradientExpr;
-declare function isColorExpression(value: unknown): value is ColorExpression;
-/**
- * `color-mix(in <space>, <from> <amount>, <to>)` — blend `from` and
- * `to` at the given percentage. Inputs can be CSS color literals,
- * `token('ns/name')` markers, or other `mix()` outputs.
- *
- *     mix(token('bg/primary'), 'transparent', '20%')
- *     mix('#000', token('bg/accent'), '40%', 'oklab')
- */
-declare function mix(from: ColorValue, to: ColorValue, amount: CssPercentage, colorSpace?: ColorSpace): MixExpr;
-/**
- * Opacity sugar — `alpha(color, 0.2)` resolves to
- * `color-mix(in srgb, color 20%, transparent)`, which renders as
- * `color` at 20% opacity. The numeric API matches `rgba()` and the
- * CSS `opacity` property (both 0..1).
- *
- * Out-of-range values clamp to `[0, 1]`. The mix amount is the
- * color's share of the blend (`color-mix(in srgb, A X%, B)` defines
- * `X%` as A's proportion), so `opacity * 100` is exactly what goes on
- * the wire.
- */
-declare function alpha(color: ColorValue, opacity: number): MixExpr;
-/**
- * `darken(color, 10)` → `color-mix(in oklch, color, light-dark(black, white) 10%)`
- * — blends `color` toward black in light mode, white in dark mode. Pairs with
- * `lighten`. `color` is usually a `token('bg/brand')` ref but accepts any
- * `ColorValue`.
- */
-declare function darken(color: ColorValue, amount: number): ShadeExpr;
-/** Mirror of `darken()`; blends toward white in light mode, black in dark. */
-declare function lighten(color: ColorValue, amount: number): ShadeExpr;
-/**
- * `linear-gradient(<angle>, <stop1>, <stop2>, …)` — directional
- * gradient. `angle` accepts a CSS angle (`'135deg'`) or a `to <dir>`
- * keyword. Stops carry a `color` and optional `at` position — bare
- * stops let the engine space evenly.
- */
-declare function linearGradient(spec: {
-  angle?: CssAngle | `to ${LineDirection}`;
-  stops: readonly GradientStop[];
-  interpolation?: ColorSpace;
-  repeating?: boolean;
-}): LinearGradientExpr;
-/**
- * `radial-gradient(<shape> <size> at <position>, <stop1>, …)` —
- * gradient radiating outward from `position`. Defaults match CSS
- * (ellipse at center).
- */
-declare function radialGradient(spec: {
-  shape?: 'circle' | 'ellipse';
-  size?: RadialSize;
-  position?: LengthOrPercent | 'center' | 'top' | 'right' | 'bottom' | 'left';
-  stops: readonly GradientStop[];
-  interpolation?: ColorSpace;
-  repeating?: boolean;
-}): RadialGradientExpr;
-type TokenRefToCss = (ref: string) => string;
-/**
- * Resolve any structured color expression to its CSS string. The
- * single entry point codegen calls after `isColorExpression` fires.
- */
-declare function resolveColorExpression(expr: ColorExpression, tokenRefToCss: TokenRefToCss): string;
-//#endregion
-export { ColorExpression, ColorSpace, ColorValue, GradientStop, GradientValue, LengthOrPercent, LineDirection, LinearGradientExpr, MixExpr, RadialGradientExpr, RadialSize, TokenRefToCss, alpha, darken, isColorExpression, isLinearGradientExpr, isMixExpr, isRadialGradientExpr, lighten, linearGradient, mix, radialGradient, resolveColorExpression };

package/dist/colorExpressions.js

@@ -1,148 +0,0 @@
-import { isTokenRef } from "./refs.js";
-//#region src/colorExpressions.ts
-function hasKind(value, kind) {
-	return typeof value === "object" && value !== null && value.__kind === kind;
-}
-function isMixExpr(value) {
-	return hasKind(value, "mix");
-}
-function isShadeExpr(value) {
-	return hasKind(value, "darken") || hasKind(value, "lighten");
-}
-function isLinearGradientExpr(value) {
-	return hasKind(value, "linear-gradient");
-}
-function isRadialGradientExpr(value) {
-	return hasKind(value, "radial-gradient");
-}
-function isColorExpression(value) {
-	return isMixExpr(value) || isShadeExpr(value) || isLinearGradientExpr(value) || isRadialGradientExpr(value);
-}
-/**
-* `color-mix(in <space>, <from> <amount>, <to>)` — blend `from` and
-* `to` at the given percentage. Inputs can be CSS color literals,
-* `token('ns/name')` markers, or other `mix()` outputs.
-*
-*     mix(token('bg/primary'), 'transparent', '20%')
-*     mix('#000', token('bg/accent'), '40%', 'oklab')
-*/
-function mix(from, to, amount, colorSpace) {
-	return {
-		__kind: "mix",
-		from,
-		to,
-		amount,
-		colorSpace
-	};
-}
-/**
-* Opacity sugar — `alpha(color, 0.2)` resolves to
-* `color-mix(in srgb, color 20%, transparent)`, which renders as
-* `color` at 20% opacity. The numeric API matches `rgba()` and the
-* CSS `opacity` property (both 0..1).
-*
-* Out-of-range values clamp to `[0, 1]`. The mix amount is the
-* color's share of the blend (`color-mix(in srgb, A X%, B)` defines
-* `X%` as A's proportion), so `opacity * 100` is exactly what goes on
-* the wire.
-*/
-function alpha(color, opacity) {
-	return {
-		__kind: "mix",
-		from: color,
-		to: "transparent",
-		amount: `${Math.round(Math.max(0, Math.min(1, opacity)) * 100)}%`,
-		colorSpace: "srgb"
-	};
-}
-/**
-* `darken(color, 10)` → `color-mix(in oklch, color, light-dark(black, white) 10%)`
-* — blends `color` toward black in light mode, white in dark mode. Pairs with
-* `lighten`. `color` is usually a `token('bg/brand')` ref but accepts any
-* `ColorValue`.
-*/
-function darken(color, amount) {
-	return {
-		__kind: "darken",
-		color,
-		amount
-	};
-}
-/** Mirror of `darken()`; blends toward white in light mode, black in dark. */
-function lighten(color, amount) {
-	return {
-		__kind: "lighten",
-		color,
-		amount
-	};
-}
-/**
-* `linear-gradient(<angle>, <stop1>, <stop2>, …)` — directional
-* gradient. `angle` accepts a CSS angle (`'135deg'`) or a `to <dir>`
-* keyword. Stops carry a `color` and optional `at` position — bare
-* stops let the engine space evenly.
-*/
-function linearGradient(spec) {
-	return {
-		__kind: "linear-gradient",
-		...spec
-	};
-}
-/**
-* `radial-gradient(<shape> <size> at <position>, <stop1>, …)` —
-* gradient radiating outward from `position`. Defaults match CSS
-* (ellipse at center).
-*/
-function radialGradient(spec) {
-	return {
-		__kind: "radial-gradient",
-		...spec
-	};
-}
-function resolveColorValue(value, tokenRefToCss) {
-	if (typeof value === "string") return value;
-	if (isMixExpr(value)) return resolveMixExpr(value, tokenRefToCss);
-	if (isTokenRef(value)) return tokenRefToCss(value.ref);
-	return "";
-}
-function resolveMixExpr(expr, tokenRefToCss) {
-	const space = expr.colorSpace ?? "srgb";
-	const from = resolveColorValue(expr.from, tokenRefToCss);
-	const to = resolveColorValue(expr.to, tokenRefToCss);
-	return `color-mix(in ${space}, ${from} ${expr.amount}, ${to})`;
-}
-function resolveShadeExpr(expr, tokenRefToCss) {
-	return `color-mix(in oklch, ${resolveColorValue(expr.color, tokenRefToCss)}, ${expr.__kind === "darken" ? "light-dark(black, white)" : "light-dark(white, black)"} ${expr.amount}%)`;
-}
-function renderStops(stops, tokenRefToCss) {
-	const parts = [];
-	for (const stop of stops) {
-		const color = resolveColorValue(stop.color, tokenRefToCss);
-		parts.push(stop.at !== void 0 ? `${color} ${stop.at}` : color);
-	}
-	return parts.join(", ");
-}
-function resolveLinearGradientExpr(expr, tokenRefToCss) {
-	const fn = expr.repeating ? "repeating-linear-gradient" : "linear-gradient";
-	const prefix = expr.angle !== void 0 ? `${expr.angle}, ` : "";
-	return `${fn}(${expr.interpolation ? `in ${expr.interpolation}, ` : ""}${prefix}${renderStops(expr.stops, tokenRefToCss)})`;
-}
-function resolveRadialGradientExpr(expr, tokenRefToCss) {
-	const fn = expr.repeating ? "repeating-radial-gradient" : "radial-gradient";
-	const shapeAndSize = [expr.shape ?? "", expr.size ?? ""].filter(Boolean).join(" ");
-	const positionPart = expr.position ? ` at ${expr.position}` : "";
-	const head = shapeAndSize || positionPart ? `${shapeAndSize}${positionPart}, ` : "";
-	return `${fn}(${expr.interpolation ? `in ${expr.interpolation}, ` : ""}${head}${renderStops(expr.stops, tokenRefToCss)})`;
-}
-/**
-* Resolve any structured color expression to its CSS string. The
-* single entry point codegen calls after `isColorExpression` fires.
-*/
-function resolveColorExpression(expr, tokenRefToCss) {
-	if (isMixExpr(expr)) return resolveMixExpr(expr, tokenRefToCss);
-	if (isShadeExpr(expr)) return resolveShadeExpr(expr, tokenRefToCss);
-	if (isLinearGradientExpr(expr)) return resolveLinearGradientExpr(expr, tokenRefToCss);
-	return resolveRadialGradientExpr(expr, tokenRefToCss);
-}
-//#endregion
-export { alpha, darken, isColorExpression, isLinearGradientExpr, isMixExpr, isRadialGradientExpr, lighten, linearGradient, mix, radialGradient, resolveColorExpression };

package/dist/component-referrers.d.ts

@@ -1,30 +0,0 @@
-import { Config } from "./Config.js";
-
-//#region src/component-referrers.d.ts
-/**
- * Components that would dangle if `component` were deleted. Three reference
- * channels, all on *other* components:
- *  - **layer / render-spec ref** — a component renders the target as one of
- *    its layers (`Layer.renders.kind === 'component'`), surfaced via the
- *    config's `dependentsOf({ kind: 'component' })` reverse walk;
- *  - **extends** — a component value-extends the target (`extendsFrom`);
- *  - **subcomponent** — the target owns child components declared through
- *    `.subcomponents({...})` (`derived.subcomponentOf`), which would lose
- *    their parent.
- *
- * The result is a deduped list of qualified referrer descriptions
- * (`component:`, `extends:`, `subcomponent:` prefixes) for the
- * `component-delete` validator's `REFERRERS_BLOCK` message. Self-references
- * are excluded.
- *
- * This lives in `@yahoo/uds-create-config` — the lowest common dependency —
- * so it has a single home shared by both consumers: the server-side
- * `component-delete` validator (the source of truth for the actual refusal)
- * and the Studio GUI, which calls it to disable the delete affordance up
- * front so the user never triggers a delete the validator would reject.
- * `component` is the bare registry name (the `config.components` key), not a
- * namespaced spec type.
- */
-declare function findComponentReferrers(config: Config, component: string): string[];
-//#endregion
-export { findComponentReferrers };

package/dist/component-referrers.js

@@ -1,40 +0,0 @@
-//#region src/component-referrers.ts
-/**
-* Components that would dangle if `component` were deleted. Three reference
-* channels, all on *other* components:
-*  - **layer / render-spec ref** — a component renders the target as one of
-*    its layers (`Layer.renders.kind === 'component'`), surfaced via the
-*    config's `dependentsOf({ kind: 'component' })` reverse walk;
-*  - **extends** — a component value-extends the target (`extendsFrom`);
-*  - **subcomponent** — the target owns child components declared through
-*    `.subcomponents({...})` (`derived.subcomponentOf`), which would lose
-*    their parent.
-*
-* The result is a deduped list of qualified referrer descriptions
-* (`component:`, `extends:`, `subcomponent:` prefixes) for the
-* `component-delete` validator's `REFERRERS_BLOCK` message. Self-references
-* are excluded.
-*
-* This lives in `@yahoo/uds-create-config` — the lowest common dependency —
-* so it has a single home shared by both consumers: the server-side
-* `component-delete` validator (the source of truth for the actual refusal)
-* and the Studio GUI, which calls it to disable the delete affordance up
-* front so the user never triggers a delete the validator would reject.
-* `component` is the bare registry name (the `config.components` key), not a
-* namespaced spec type.
-*/
-function findComponentReferrers(config, component) {
-	const referrers = /* @__PURE__ */ new Set();
-	for (const ref of config.dependentsOf({
-		kind: "component",
-		name: component
-	})) if (ref.kind === "component" && ref.name !== component) referrers.add(`component:${ref.name}`);
-	for (const [name, comp] of config.components) {
-		if (name === component) continue;
-		if (comp.extendsFrom === component) referrers.add(`extends:${name}`);
-		if (comp.derived.subcomponentOf === component) referrers.add(`subcomponent:${name}`);
-	}
-	return [...referrers];
-}
-//#endregion
-export { findComponentReferrers };

package/dist/config-diagnostics.d.ts

@@ -1,21 +0,0 @@
-//#region src/config-diagnostics.d.ts
-/** A stable definition locator that UI, CLI, and migration callers can show. */
-interface ConfigDiagnosticDefinition {
-  kind: string;
-  name?: string;
-}
-/** Platform-neutral structured config diagnostic. */
-interface ConfigDiagnostic<TCode extends string = string> {
-  code: TCode;
-  severity: 'error' | 'warning';
-  path: readonly (string | number)[];
-  definition: ConfigDiagnosticDefinition;
-  reason: string;
-}
-/** Structured config failure shared by platform validators. */
-declare class ConfigValidationError<TDiagnostic extends ConfigDiagnostic = ConfigDiagnostic> extends Error {
-  readonly diagnostics: readonly TDiagnostic[];
-  constructor(diagnostics: readonly TDiagnostic[], message?: string);
-}
-//#endregion
-export { ConfigDiagnostic, ConfigDiagnosticDefinition, ConfigValidationError };

package/dist/config-diagnostics.js

@@ -1,12 +0,0 @@
-//#region src/config-diagnostics.ts
-/** Structured config failure shared by platform validators. */
-var ConfigValidationError = class extends Error {
-	diagnostics;
-	constructor(diagnostics, message = "Invalid config") {
-		super(diagnostics.length === 0 ? message : `${message}: ${diagnostics.map((diagnostic) => diagnostic.reason).join("; ")}`);
-		this.name = "ConfigValidationError";
-		this.diagnostics = diagnostics;
-	}
-};
-//#endregion
-export { ConfigValidationError };