@yahoo/uds-create-config 1.1.1

package/dist/types/css-property-keywords.js

@@ -0,0 +1,616 @@
+//#region src/types/css-property-keywords.ts
+/**
+* Single source of truth for CSS keyword enums.
+*
+* These hand-authored runtime arrays list every plain string-literal
+* keyword each CSS property accepts. The type unions in
+* `./css-properties.ts` are DERIVED from these tuples
+* (`(typeof CSS_PROPERTY_KEYWORDS)['<prop>'][number]`), so the keyword
+* data lives in exactly one place and is available at runtime — Studio
+* and other consumers can import the arrays directly instead of
+* re-declaring a parallel hardcoded map.
+*
+* Scope: only concrete keyword literals belong here. Value-type aliases
+* (lengths, percentages, numbers, colors, `CssVarRef`, intrinsic-size
+* keywords expressed via shared aliases, template-literal/number types,
+* bare `string`) stay in `css-properties.ts` and are NOT transcribed.
+* Properties whose union is purely value-typed (e.g. `flex-grow`) get no
+* entry here.
+*/
+/** The CSS-wide keyword set, available as a runtime array. */
+const CSS_GLOBAL_KEYWORDS = [
+	"inherit",
+	"initial",
+	"unset",
+	"revert",
+	"revert-layer"
+];
+/**
+* Per-property keyword tuples. Each tuple holds, in source order, every
+* plain string-literal keyword that property's union in
+* `css-properties.ts` lists.
+*/
+const CSS_PROPERTY_KEYWORDS = {
+	margin: ["auto"],
+	"margin-top": ["auto"],
+	"margin-right": ["auto"],
+	"margin-bottom": ["auto"],
+	"margin-left": ["auto"],
+	"margin-block": ["auto"],
+	"margin-inline": ["auto"],
+	"margin-inline-start": ["auto"],
+	"margin-inline-end": ["auto"],
+	top: ["auto"],
+	right: ["auto"],
+	bottom: ["auto"],
+	left: ["auto"],
+	inset: ["auto"],
+	"inset-block": ["auto"],
+	"inset-inline": ["auto"],
+	"inset-inline-start": ["auto"],
+	"inset-inline-end": ["auto"],
+	"inset-block-start": ["auto"],
+	"inset-block-end": ["auto"],
+	"max-width": ["none"],
+	"max-height": ["none"],
+	"border-width": [
+		"thin",
+		"medium",
+		"thick"
+	],
+	"border-top-width": [
+		"thin",
+		"medium",
+		"thick"
+	],
+	"border-right-width": [
+		"thin",
+		"medium",
+		"thick"
+	],
+	"border-bottom-width": [
+		"thin",
+		"medium",
+		"thick"
+	],
+	"border-left-width": [
+		"thin",
+		"medium",
+		"thick"
+	],
+	"border-block-width": [
+		"thin",
+		"medium",
+		"thick"
+	],
+	"border-inline-width": [
+		"thin",
+		"medium",
+		"thick"
+	],
+	"border-inline-start-width": [
+		"thin",
+		"medium",
+		"thick"
+	],
+	"border-inline-end-width": [
+		"thin",
+		"medium",
+		"thick"
+	],
+	"outline-width": [
+		"thin",
+		"medium",
+		"thick"
+	],
+	"border-style": [
+		"none",
+		"hidden",
+		"dotted",
+		"dashed",
+		"solid",
+		"double",
+		"groove",
+		"ridge",
+		"inset",
+		"outset"
+	],
+	"border-top-style": [
+		"none",
+		"hidden",
+		"dotted",
+		"dashed",
+		"solid",
+		"double",
+		"groove",
+		"ridge",
+		"inset",
+		"outset"
+	],
+	"border-bottom-style": [
+		"none",
+		"hidden",
+		"dotted",
+		"dashed",
+		"solid",
+		"double",
+		"groove",
+		"ridge",
+		"inset",
+		"outset"
+	],
+	"border-inline-start-style": [
+		"none",
+		"hidden",
+		"dotted",
+		"dashed",
+		"solid",
+		"double",
+		"groove",
+		"ridge",
+		"inset",
+		"outset"
+	],
+	"border-inline-end-style": [
+		"none",
+		"hidden",
+		"dotted",
+		"dashed",
+		"solid",
+		"double",
+		"groove",
+		"ridge",
+		"inset",
+		"outset"
+	],
+	"outline-style": [
+		"none",
+		"hidden",
+		"dotted",
+		"dashed",
+		"solid",
+		"double",
+		"groove",
+		"ridge",
+		"inset",
+		"outset",
+		"auto"
+	],
+	"text-decoration-style": [
+		"solid",
+		"double",
+		"dotted",
+		"dashed",
+		"wavy"
+	],
+	"text-decoration-thickness": ["auto", "from-font"],
+	"text-underline-offset": ["auto"],
+	"outline-color": ["invert"],
+	"caret-color": ["auto"],
+	fill: [
+		"none",
+		"context-fill",
+		"context-stroke"
+	],
+	stroke: [
+		"none",
+		"context-fill",
+		"context-stroke"
+	],
+	"scrollbar-color": ["auto"],
+	"font-size": [
+		"xx-small",
+		"x-small",
+		"small",
+		"medium",
+		"large",
+		"x-large",
+		"xx-large",
+		"smaller",
+		"larger"
+	],
+	"font-style": [
+		"normal",
+		"italic",
+		"oblique"
+	],
+	"font-stretch": [
+		"normal",
+		"ultra-condensed",
+		"extra-condensed",
+		"condensed",
+		"semi-condensed",
+		"semi-expanded",
+		"expanded",
+		"extra-expanded",
+		"ultra-expanded"
+	],
+	"line-height": ["normal"],
+	"letter-spacing": ["normal"],
+	"text-align": [
+		"left",
+		"right",
+		"center",
+		"justify",
+		"start",
+		"end"
+	],
+	"text-transform": [
+		"none",
+		"capitalize",
+		"uppercase",
+		"lowercase",
+		"full-width",
+		"full-size-kana"
+	],
+	"text-wrap": [
+		"wrap",
+		"nowrap",
+		"balance",
+		"pretty",
+		"stable"
+	],
+	"text-overflow": ["clip", "ellipsis"],
+	"text-decoration-line": [
+		"none",
+		"underline",
+		"overline",
+		"line-through",
+		"blink"
+	],
+	"text-shadow": ["none"],
+	"white-space": [
+		"normal",
+		"nowrap",
+		"pre",
+		"pre-wrap",
+		"pre-line",
+		"break-spaces"
+	],
+	"word-break": [
+		"normal",
+		"break-all",
+		"keep-all",
+		"break-word"
+	],
+	"overflow-wrap": [
+		"normal",
+		"break-word",
+		"anywhere"
+	],
+	hyphens: [
+		"none",
+		"manual",
+		"auto"
+	],
+	"list-style-image": ["none"],
+	"list-style-position": ["inside", "outside"],
+	"vertical-align": [
+		"baseline",
+		"sub",
+		"super",
+		"text-top",
+		"text-bottom",
+		"middle",
+		"top",
+		"bottom"
+	],
+	"-webkit-font-smoothing": [
+		"auto",
+		"none",
+		"antialiased",
+		"subpixel-antialiased"
+	],
+	"-webkit-line-clamp": ["none"],
+	display: [
+		"block",
+		"inline",
+		"inline-block",
+		"flex",
+		"inline-flex",
+		"grid",
+		"inline-grid",
+		"flow-root",
+		"none",
+		"contents",
+		"table",
+		"inline-table",
+		"table-row-group",
+		"table-header-group",
+		"table-footer-group",
+		"table-row",
+		"table-cell",
+		"table-column-group",
+		"table-column",
+		"table-caption",
+		"list-item"
+	],
+	visibility: [
+		"visible",
+		"hidden",
+		"collapse"
+	],
+	isolation: ["auto", "isolate"],
+	position: [
+		"static",
+		"relative",
+		"absolute",
+		"fixed",
+		"sticky"
+	],
+	"box-sizing": ["content-box", "border-box"],
+	"container-type": [
+		"normal",
+		"size",
+		"inline-size"
+	],
+	columns: ["auto"],
+	flex: [
+		"none",
+		"auto",
+		"initial"
+	],
+	"flex-direction": [
+		"row",
+		"row-reverse",
+		"column",
+		"column-reverse"
+	],
+	"flex-wrap": [
+		"nowrap",
+		"wrap",
+		"wrap-reverse"
+	],
+	"flex-basis": ["content"],
+	"justify-content": [
+		"flex-start",
+		"flex-end",
+		"start",
+		"end",
+		"center",
+		"space-between",
+		"space-around",
+		"space-evenly",
+		"stretch",
+		"normal",
+		"left",
+		"right"
+	],
+	"align-items": [
+		"normal",
+		"stretch",
+		"center",
+		"start",
+		"end",
+		"flex-start",
+		"flex-end",
+		"self-start",
+		"self-end",
+		"baseline",
+		"first baseline",
+		"last baseline"
+	],
+	"align-content": [
+		"normal",
+		"start",
+		"end",
+		"center",
+		"flex-start",
+		"flex-end",
+		"space-between",
+		"space-around",
+		"space-evenly",
+		"stretch",
+		"baseline"
+	],
+	"align-self": [
+		"auto",
+		"normal",
+		"stretch",
+		"center",
+		"start",
+		"end",
+		"flex-start",
+		"flex-end",
+		"self-start",
+		"self-end",
+		"baseline"
+	],
+	"grid-template-columns": ["none"],
+	"grid-template-rows": ["none"],
+	"grid-column": ["auto"],
+	"grid-column-start": ["auto"],
+	"grid-column-end": ["auto"],
+	"grid-row": ["auto"],
+	"grid-row-start": ["auto"],
+	"grid-row-end": ["auto"],
+	transform: ["none"],
+	rotate: ["none"],
+	scale: ["none"],
+	translate: ["none"],
+	transition: ["none"],
+	"transition-property": ["none", "all"],
+	"transition-behavior": ["normal", "allow-discrete"],
+	animation: ["none"],
+	"box-shadow": ["none"],
+	filter: ["none"],
+	"backdrop-filter": ["none"],
+	"mix-blend-mode": [
+		"normal",
+		"multiply",
+		"screen",
+		"overlay",
+		"darken",
+		"lighten",
+		"color-dodge",
+		"color-burn",
+		"hard-light",
+		"soft-light",
+		"difference",
+		"exclusion",
+		"hue",
+		"saturation",
+		"color",
+		"luminosity",
+		"plus-darker",
+		"plus-lighter"
+	],
+	"background-blend-mode": [
+		"normal",
+		"multiply",
+		"screen",
+		"overlay",
+		"darken",
+		"lighten",
+		"color-dodge",
+		"color-burn",
+		"hard-light",
+		"soft-light",
+		"difference",
+		"exclusion",
+		"hue",
+		"saturation",
+		"color",
+		"luminosity"
+	],
+	overflow: [
+		"visible",
+		"hidden",
+		"clip",
+		"scroll",
+		"auto"
+	],
+	"overflow-x": [
+		"visible",
+		"hidden",
+		"clip",
+		"scroll",
+		"auto"
+	],
+	"overflow-y": [
+		"visible",
+		"hidden",
+		"clip",
+		"scroll",
+		"auto"
+	],
+	"overscroll-behavior": [
+		"auto",
+		"contain",
+		"none"
+	],
+	"scroll-behavior": ["auto", "smooth"],
+	"scroll-snap-align": [
+		"none",
+		"start",
+		"end",
+		"center"
+	],
+	"scroll-snap-stop": ["normal", "always"],
+	"scroll-snap-type": ["none"],
+	"scrollbar-width": [
+		"auto",
+		"thin",
+		"none"
+	],
+	cursor: [
+		"auto",
+		"default",
+		"none",
+		"context-menu",
+		"help",
+		"pointer",
+		"progress",
+		"wait",
+		"cell",
+		"crosshair",
+		"text",
+		"vertical-text",
+		"alias",
+		"copy",
+		"move",
+		"no-drop",
+		"not-allowed",
+		"grab",
+		"grabbing",
+		"all-scroll",
+		"col-resize",
+		"row-resize",
+		"n-resize",
+		"e-resize",
+		"s-resize",
+		"w-resize",
+		"ne-resize",
+		"nw-resize",
+		"se-resize",
+		"sw-resize",
+		"ew-resize",
+		"ns-resize",
+		"nesw-resize",
+		"nwse-resize",
+		"zoom-in",
+		"zoom-out"
+	],
+	"pointer-events": [
+		"auto",
+		"none",
+		"visiblePainted",
+		"visibleFill",
+		"visibleStroke",
+		"visible",
+		"painted",
+		"fill",
+		"stroke",
+		"all"
+	],
+	"user-select": [
+		"none",
+		"auto",
+		"text",
+		"contain",
+		"all"
+	],
+	resize: [
+		"none",
+		"both",
+		"horizontal",
+		"vertical",
+		"block",
+		"inline"
+	],
+	appearance: [
+		"none",
+		"auto",
+		"menulist-button",
+		"textfield"
+	],
+	"touch-action": [
+		"auto",
+		"none",
+		"manipulation"
+	],
+	"will-change": [
+		"auto",
+		"scroll-position",
+		"contents"
+	],
+	"z-index": ["auto"],
+	"aspect-ratio": ["auto"],
+	"object-fit": [
+		"fill",
+		"contain",
+		"cover",
+		"none",
+		"scale-down"
+	],
+	"caption-side": [
+		"top",
+		"bottom",
+		"inline-start",
+		"inline-end"
+	],
+	"border-collapse": ["collapse", "separate"],
+	"table-layout": ["auto", "fixed"]
+};
+//#endregion
+export { CSS_GLOBAL_KEYWORDS, CSS_PROPERTY_KEYWORDS };

package/dist/types/css-values.d.ts

@@ -0,0 +1,63 @@
+//#region src/types/css-values.d.ts
+/**
+ * CSS value-type primitives — template-literal types for the subset of
+ * the CSS Values & Units vocabulary that token values, color
+ * expressions, and per-property keyword unions author against.
+ *
+ * `CssValue` is the registry keyed by spec value-type names (`color`,
+ * `length`, `percentage`, etc.). `CssPropertyValues` in `./css-properties`
+ * composes these entries plus per-property keywords into the union each
+ * CSS property accepts.
+ *
+ * Named colors (`red`, `blue`, etc.) are intentionally NOT in the
+ * `CssColor` union — authors use a token, a hex code, or a function
+ * form (`rgb(...)`, etc.). The CSS-wide keywords (`inherit`, `initial`,
+ * `unset`, `revert`) are bundled into `ColorKeyword` because color is
+ * the most common channel for them.
+ */
+type ColorKeyword = 'transparent' | 'currentColor' | 'inherit' | 'initial' | 'unset' | 'revert';
+type HexColor = `#${string}`;
+type RgbColor = `rgb(${string})` | `rgba(${string})`;
+type HslColor = `hsl(${string})` | `hsla(${string})`;
+type ColorFn = `color(${string})` | `lab(${string})` | `lch(${string})` | `oklab(${string})` | `oklch(${string})`;
+type CssColor = HexColor | RgbColor | HslColor | ColorFn | ColorKeyword;
+type CssLength = `${number}px` | `${number}rem` | `${number}em` | `${number}ch` | `${number}ex` | `${number}vh` | `${number}vw` | `${number}vmin` | `${number}vmax` | 0;
+type CssPercentage = `${number}%`;
+type CssAngle = `${number}deg` | `${number}rad` | `${number}grad` | `${number}turn`;
+type CssTime = `${number}ms` | `${number}s`;
+type CssRatio = `${number}/${number}`;
+type CssVarRef = `var(--${string})` | `var(--${string}, ${string})`;
+/**
+ * Registry of CSS value types, keyed by their spec-defined names.
+ *
+ * Used in two places:
+ *  1. As the source of truth for what shapes count as e.g. a "length"
+ *     or a "color" when validating token values and `defineStyleProp`
+ *     `arbitrary` specs.
+ *  2. By `CssPropertyValues` in `./css-properties`, which composes
+ *     these entries (plus per-property keywords) into the union
+ *     accepted by each CSS property.
+ */
+type CssValue = {
+  color: CssColor;
+  length: CssLength;
+  percentage: CssPercentage;
+  'length-percentage': CssLength | CssPercentage;
+  number: number;
+  integer: number;
+  angle: CssAngle;
+  time: CssTime;
+  ratio: CssRatio;
+  image: string;
+  url: `url(${string})`;
+  'font-weight': number | 'normal' | 'bold' | 'lighter' | 'bolder';
+  'font-family': string;
+  'easing-function': 'linear' | 'ease' | 'ease-in' | 'ease-out' | 'ease-in-out' | 'step-start' | 'step-end' | `cubic-bezier(${string})` | `steps(${string})`;
+  shadow: string;
+  gradient: string;
+  ident: string;
+  string: string;
+};
+type CssValueTypeName = keyof CssValue;
+//#endregion
+export { ColorFn, ColorKeyword, CssAngle, CssColor, CssLength, CssPercentage, CssRatio, CssTime, CssValue, CssValueTypeName, CssVarRef, HexColor, HslColor, RgbColor };

package/dist/types/css-values.js

@@ -0,0 +1,16 @@
+/**
+ * CSS value-type primitives — template-literal types for the subset of
+ * the CSS Values & Units vocabulary that token values, color
+ * expressions, and per-property keyword unions author against.
+ *
+ * `CssValue` is the registry keyed by spec value-type names (`color`,
+ * `length`, `percentage`, etc.). `CssPropertyValues` in `./css-properties`
+ * composes these entries plus per-property keywords into the union each
+ * CSS property accepts.
+ *
+ * Named colors (`red`, `blue`, etc.) are intentionally NOT in the
+ * `CssColor` union — authors use a token, a hex code, or a function
+ * form (`rgb(...)`, etc.). The CSS-wide keywords (`inherit`, `initial`,
+ * `unset`, `revert`) are bundled into `ColorKeyword` because color is
+ * the most common channel for them.
+ */