pixelize-native-library 1.2.0 → 1.3.0

package/lib/module/theme/tokens/brands/meadow/palette.light.js

@@ -1,6 +1,7 @@
 "use strict";
 
-import lavenderPalette from "../lavender/palette.light.js";
+import finalizePalette from "../../builders/finalizePalette.js";
+import { source as lavenderSource } from "../lavender/palette.light.js";
 import { buildPrimaryOpacity, buildPrimaryShadowTint } from "../../builders/buildBrandTokens.js";
 const PRIMARY_500 = "#2d6a4f";
 const primary = {
@@ -16,11 +17,11 @@ const primary = {
   900: "#0a2016",
   opacity: buildPrimaryOpacity(PRIMARY_500)
 };
-const palette = {
-  ...lavenderPalette,
+export const source = {
+  ...lavenderSource,
   gradient: {
     from: "#2d6a4f",
-    to: "#14b8a6"
+    to: "#0f8376"
   },
   primary,
   tertiary: {
@@ -32,7 +33,7 @@ const palette = {
     200: "#dce5e0",
     300: "#c4d2cb",
     400: "#93a99f",
-    500: "#637d72",
+    500: "#5c7369",
     600: "#445f52",
     700: "#344a3f",
     800: "#24342b",
@@ -118,9 +119,9 @@ const palette = {
   },
   boxShadow: {
     primary: buildPrimaryShadowTint(PRIMARY_500),
-    error: lavenderPalette.boxShadow.error,
-    default: lavenderPalette.boxShadow.default
+    error: lavenderSource.boxShadow.error,
+    default: lavenderSource.boxShadow.default
   }
 };
-export default palette;
+export default finalizePalette(source);
 //# sourceMappingURL=palette.light.js.map

package/lib/module/theme/tokens/brands/radiant/palette.light.js

@@ -1,6 +1,7 @@
 "use strict";
 
-import lavenderPalette from "../lavender/palette.light.js";
+import finalizePalette from "../../builders/finalizePalette.js";
+import { source as lavenderSource } from "../lavender/palette.light.js";
 import { buildPrimaryOpacity, buildPrimaryShadowTint } from "../../builders/buildBrandTokens.js";
 const PRIMARY_500 = "#cf4e3a";
 const primary = {
@@ -18,11 +19,11 @@ const primary = {
 };
 
 // No `tertiary` override — radiant inherits lavender's purple tertiary, as web ships it.
-const palette = {
-  ...lavenderPalette,
+export const source = {
+  ...lavenderSource,
   gradient: {
-    from: "#cf4e3a",
-    to: "#f59e0b"
+    from: "#cd4733",
+    to: "#a36807"
   },
   primary,
   gray: {
@@ -31,7 +32,7 @@ const palette = {
     200: "#e2dad5",
     300: "#cec2bb",
     400: "#b3a39a",
-    500: "#928077",
+    500: "#796861",
     600: "#6e6058",
     700: "#534841",
     800: "#39312c",
@@ -117,9 +118,9 @@ const palette = {
   },
   boxShadow: {
     primary: buildPrimaryShadowTint(PRIMARY_500),
-    error: lavenderPalette.boxShadow.error,
-    default: lavenderPalette.boxShadow.default
+    error: lavenderSource.boxShadow.error,
+    default: lavenderSource.boxShadow.default
   }
 };
-export default palette;
+export default finalizePalette(source);
 //# sourceMappingURL=palette.light.js.map

package/lib/module/theme/tokens/brands/rosewood/palette.light.js

@@ -1,6 +1,7 @@
 "use strict";
 
-import lavenderPalette from "../lavender/palette.light.js";
+import finalizePalette from "../../builders/finalizePalette.js";
+import { source as lavenderSource } from "../lavender/palette.light.js";
 import { buildPrimaryOpacity, buildPrimaryShadowTint } from "../../builders/buildBrandTokens.js";
 const PRIMARY_500 = "#d16a7e";
 const primary = {
@@ -18,11 +19,11 @@ const primary = {
 };
 
 // No `tertiary` override — rosewood inherits lavender's purple tertiary, as web ships it.
-const palette = {
-  ...lavenderPalette,
+export const source = {
+  ...lavenderSource,
   gradient: {
-    from: "#d16a7e",
-    to: "#fb7185"
+    from: "#c74962",
+    to: "#ea0727"
   },
   primary,
   gray: {
@@ -31,7 +32,7 @@ const palette = {
     200: "#e4dada",
     300: "#d0c1c1",
     400: "#b4a2a2",
-    500: "#927f7f",
+    500: "#796666",
     600: "#6e5e5e",
     700: "#534747",
     800: "#3a3030",
@@ -117,9 +118,9 @@ const palette = {
   },
   boxShadow: {
     primary: buildPrimaryShadowTint(PRIMARY_500),
-    error: lavenderPalette.boxShadow.error,
-    default: lavenderPalette.boxShadow.default
+    error: lavenderSource.boxShadow.error,
+    default: lavenderSource.boxShadow.default
   }
 };
-export default palette;
+export default finalizePalette(source);
 //# sourceMappingURL=palette.light.js.map

package/lib/module/theme/tokens/brands/skyline/palette.light.js

@@ -1,6 +1,7 @@
 "use strict";
 
-import lavenderPalette from "../lavender/palette.light.js";
+import finalizePalette from "../../builders/finalizePalette.js";
+import { source as lavenderSource } from "../lavender/palette.light.js";
 import { buildPrimaryOpacity, buildPrimaryShadowTint } from "../../builders/buildBrandTokens.js";
 const PRIMARY_500 = "#1a3a6b";
 const primary = {
@@ -16,11 +17,11 @@ const primary = {
   900: "#071021",
   opacity: buildPrimaryOpacity(PRIMARY_500)
 };
-const palette = {
-  ...lavenderPalette,
+export const source = {
+  ...lavenderSource,
   gradient: {
     from: "#1a3a6b",
-    to: "#38bdf8"
+    to: "#067db2"
   },
   primary,
   tertiary: {
@@ -32,7 +33,7 @@ const palette = {
     200: "#d3dae8",
     300: "#b0bcd4",
     400: "#8094b0",
-    500: "#566d8c",
+    500: "#566c8b",
     600: "#3d526b",
     700: "#2e3f54",
     800: "#202d3d",
@@ -118,9 +119,9 @@ const palette = {
   },
   boxShadow: {
     primary: buildPrimaryShadowTint(PRIMARY_500),
-    error: lavenderPalette.boxShadow.error,
-    default: lavenderPalette.boxShadow.default
+    error: lavenderSource.boxShadow.error,
+    default: lavenderSource.boxShadow.default
   }
 };
-export default palette;
+export default finalizePalette(source);
 //# sourceMappingURL=palette.light.js.map

package/lib/module/theme/tokens/brands/slate/palette.light.js

@@ -1,6 +1,7 @@
 "use strict";
 
-import lavenderPalette from "../lavender/palette.light.js";
+import finalizePalette from "../../builders/finalizePalette.js";
+import { source as lavenderSource } from "../lavender/palette.light.js";
 import { buildPrimaryOpacity, buildPrimaryShadowTint } from "../../builders/buildBrandTokens.js";
 const PRIMARY_500 = "#6b7280";
 const primary = {
@@ -16,11 +17,11 @@ const primary = {
   900: "#111827",
   opacity: buildPrimaryOpacity(PRIMARY_500)
 };
-const palette = {
-  ...lavenderPalette,
+export const source = {
+  ...lavenderSource,
   gradient: {
-    from: "#6b7280",
-    to: "#818cf8"
+    from: "#666d7a",
+    to: "#4a4e59"
   },
   primary,
   tertiary: {
@@ -32,7 +33,7 @@ const palette = {
     200: "#e5e7eb",
     300: "#d1d5db",
     400: "#9ca3af",
-    500: "#6b7280",
+    500: "#686e7c",
     600: "#4b5563",
     700: "#374151",
     800: "#1f2937",
@@ -88,9 +89,6 @@ const palette = {
     800: "#6a6a6e",
     900: "#4f4f52"
   },
-  // NOTE: table.hover[500] carries a Cyrillic homoglyph (U+0435) inside the hex, copied
-  // verbatim from web's slate palette (a real upstream bug). Do not "fix" here — it must be
-  // corrected on web and re-copied. Flagged for the web chat; see this task's report.
   table: {
     hover: {
       50: "#fefefe",
@@ -98,7 +96,7 @@ const palette = {
       200: "#f1f1f3",
       300: "#ebebed",
       400: "#e5e5e8",
-      500: "#dfdfе2",
+      500: "#dfdfe2",
       600: "#cbcbcf",
       700: "#a0a0a5",
       800: "#787880",
@@ -121,9 +119,9 @@ const palette = {
   },
   boxShadow: {
     primary: buildPrimaryShadowTint(PRIMARY_500),
-    error: lavenderPalette.boxShadow.error,
-    default: lavenderPalette.boxShadow.default
+    error: lavenderSource.boxShadow.error,
+    default: lavenderSource.boxShadow.default
   }
 };
-export default palette;
+export default finalizePalette(source);
 //# sourceMappingURL=palette.light.js.map

package/lib/module/theme/tokens/brands/storefront/palette.light.js

@@ -1,6 +1,7 @@
 "use strict";
 
-import lavenderPalette from "../lavender/palette.light.js";
+import finalizePalette from "../../builders/finalizePalette.js";
+import { source as lavenderSource } from "../lavender/palette.light.js";
 import { buildPrimaryOpacity, buildPrimaryShadowTint } from "../../builders/buildBrandTokens.js";
 const PRIMARY_500 = "#004f4b";
 const primary = {
@@ -20,8 +21,8 @@ const primary = {
 // No `tertiary` override — storefront inherits lavender's purple tertiary, as web ships it.
 // Same for `secondary`, `semantic`, the 9 utility hues, `text`/`header`/`placeholder`/`disabled`,
 // and `transparent`/`black`/`white`.
-const palette = {
-  ...lavenderPalette,
+export const source = {
+  ...lavenderSource,
   gradient: {
     from: "#0c7d77",
     to: "#095e90"
@@ -119,9 +120,9 @@ const palette = {
   },
   boxShadow: {
     primary: buildPrimaryShadowTint(PRIMARY_500),
-    error: lavenderPalette.boxShadow.error,
-    default: lavenderPalette.boxShadow.default
+    error: lavenderSource.boxShadow.error,
+    default: lavenderSource.boxShadow.default
   }
 };
-export default palette;
+export default finalizePalette(source);
 //# sourceMappingURL=palette.light.js.map

package/lib/module/theme/tokens/brands/zinc/palette.dark.js

@@ -2,6 +2,7 @@
 
 import { buildPrimaryOpacity, buildPrimaryShadowTint } from "../../builders/buildBrandTokens.js";
 import buildDarkPalette from "../../builders/buildDarkPalette.js";
+import finalizePalette from "../../builders/finalizePalette.js";
 import light from "./palette.light.js";
 
 /**
@@ -190,7 +191,7 @@ const sidebar = {
     900: "#040405"
   }
 };
-const palette = {
+const palette = finalizePalette({
   ...derived,
   gradient: {
     from: PRIMARY_500,
@@ -217,6 +218,6 @@ const palette = {
     error: derived.boxShadow.error,
     default: "#00000080"
   }
-};
+});
 export default palette;
 //# sourceMappingURL=palette.dark.js.map

package/lib/module/theme/tokens/brands/zinc/palette.light.js

@@ -1,5 +1,6 @@
 "use strict";
 
+import finalizePalette from "../../builders/finalizePalette.js";
 import { buildPrimaryOpacity, buildPrimaryShadowTint } from "../../builders/buildBrandTokens.js";
 
 /**
@@ -356,7 +357,7 @@ const gradient = {
   from: "#18181b",
   to: "#52525b"
 };
-const palette = {
+export const source = {
   gradient,
   primary,
   secondary,
@@ -389,5 +390,5 @@ const palette = {
   table,
   disabled
 };
-export default palette;
+export default finalizePalette(source);
 //# sourceMappingURL=palette.light.js.map

package/lib/module/theme/tokens/builders/accentText.js

@@ -9,7 +9,16 @@
  * that fixes those, rather than shipping broken until someone notices.
  */
 
-import { AA_TEXT, contrastRatio } from "./color.js";
+import { AA_TEXT, contrastRatio, relativeLuminance } from "./color.js";
+const AA_NORMAL_TEXT = AA_TEXT;
+const ACCENT_TEXT_SEARCH = [500, 600, 700, 800, 900];
+export const pickAccentText = (primary, canvas) => {
+  const found = ACCENT_TEXT_SEARCH.find(rung => contrastRatio(primary[rung], canvas) >= AA_NORMAL_TEXT);
+  const rung = found ?? 900;
+  return primary[rung];
+};
+export const accentTextOnCanvas = (scale, canvas) => pickAccentText(scale, canvas);
+export const onGradient = (from, to, white, black) => onFilled(relativeLuminance(from) >= relativeLuminance(to) ? from : to, white, black);
 
 /** The two candidate labels. Near-white and near-black, not #fff/#000 — the shadcn look. */
 export const ON_ACCENT_LIGHT = "#fafafa";

package/lib/module/theme/tokens/builders/buildBrandScale.js

@@ -0,0 +1,42 @@
+"use strict";
+
+import { mixHex } from "./color.js";
+import { buildPrimaryOpacity } from "./buildBrandTokens.js";
+const LOW_RUNG_WEIGHTS = {
+  50: 0.08,
+  100: 0.2,
+  200: 0.38,
+  300: 0.58,
+  400: 0.8
+};
+const HIGH_RUNG_WEIGHTS = {
+  600: 0.8,
+  700: 0.58,
+  800: 0.38,
+  900: 0.2
+};
+const RUNG_KEYS = [50, 100, 200, 300, 400, 500, 600, 700, 800, 900];
+export function buildRamp(hex500, towardLowRungs, towardHighRungs) {
+  const ramp = {
+    500: hex500
+  };
+  for (const [rung, weight] of Object.entries(LOW_RUNG_WEIGHTS)) {
+    const key = Number(rung);
+    ramp[key] = mixHex(towardLowRungs, hex500, weight);
+  }
+  for (const [rung, weight] of Object.entries(HIGH_RUNG_WEIGHTS)) {
+    const key = Number(rung);
+    ramp[key] = mixHex(towardHighRungs, hex500, weight);
+  }
+  for (const key of RUNG_KEYS) {
+    if (!ramp[key]) ramp[key] = hex500;
+  }
+  return ramp;
+}
+export function buildBrandScale(hex500, towardLow, towardHigh) {
+  return {
+    ...buildRamp(hex500, towardLow, towardHigh),
+    opacity: buildPrimaryOpacity(hex500)
+  };
+}
+//# sourceMappingURL=buildBrandScale.js.map

package/lib/module/theme/tokens/builders/buildDarkPalette.js

@@ -2,6 +2,7 @@
 
 import { buildPrimaryOpacity, buildPrimaryShadowTint } from "./buildBrandTokens.js";
 import { contrastRatio, hexToHsl, hslToHex, withLightness } from "./color.js";
+import finalizePalette from "./finalizePalette.js";
 
 /**
  * Derives a brand's dark palette from its light palette. Every value is computed from the brand's
@@ -249,7 +250,7 @@ export function buildDarkPalette(light) {
     s: SURFACE_SAT,
     l
   })]));
-  return {
+  return finalizePalette({
     ...light,
     // Brand identity: hue preserved, accent lifted as far as a light label allows.
     primary: liftBrand(light.primary, label),
@@ -294,7 +295,7 @@ export function buildDarkPalette(light) {
       error: light.boxShadow.error,
       default: "#00000080"
     }
-  };
+  });
 }
 export default buildDarkPalette;
 //# sourceMappingURL=buildDarkPalette.js.map

package/lib/module/theme/tokens/builders/finalizePalette.js

@@ -0,0 +1,34 @@
+"use strict";
+
+import { AA_TEXT } from "./color.js";
+import { liftToContrast } from "./liftToContrast.js";
+import { buildSemanticText } from "./semanticText.js";
+import { liftSemanticText, namedSurfaces, withSurfaceRungs } from "./surfaceRungs.js";
+const withPlaceholderRung = source => ({
+  ...source,
+  placeholder: {
+    ...source.placeholder,
+    500: liftToContrast(source.placeholder[500], source.background[50], AA_TEXT)
+  }
+});
+
+// The hover row is a SURFACE, so it steps away from the ink rather than the ink moving.
+const withTableHoverRung = source => ({
+  ...source,
+  table: {
+    hover: {
+      ...source.table.hover,
+      500: liftToContrast(source.table.hover[500], source.text[500], AA_TEXT)
+    }
+  }
+});
+export function finalizePalette(source) {
+  const resolved = withSurfaceRungs(withTableHoverRung(withPlaceholderRung(source)));
+  const surfaces = namedSurfaces(resolved);
+  return {
+    ...resolved,
+    semanticText: liftSemanticText(buildSemanticText(resolved.semantic, resolved.backgroundColor.main), surfaces)
+  };
+}
+export default finalizePalette;
+//# sourceMappingURL=finalizePalette.js.map

package/lib/module/theme/tokens/builders/gradientInk.js

@@ -0,0 +1,23 @@
+"use strict";
+
+import { AA_TEXT } from "./color.js";
+import { liftToContrast } from "./liftToContrast.js";
+import { onGradient } from "./accentText.js";
+const inkSafeStop = hex => liftToContrast(hex, "#ffffff", AA_TEXT);
+export const inkSafeGradient = gradient => ({
+  from: inkSafeStop(gradient.from),
+  to: inkSafeStop(gradient.to)
+});
+export const resolveGradient = (gradient, white, black) => {
+  const {
+    from,
+    to
+  } = inkSafeGradient(gradient);
+  return {
+    from,
+    to,
+    ink: onGradient(from, to, white, black)
+  };
+};
+export const gradientCss = (g, angle = "135deg") => `linear-gradient(${angle}, ${g.from} 0%, ${g.to} 100%)`;
+//# sourceMappingURL=gradientInk.js.map

package/lib/module/theme/tokens/builders/liftToContrast.js

@@ -0,0 +1,44 @@
+"use strict";
+
+import { contrastRatio, hexToHsl, relativeLuminance, withLightness } from "./color.js";
+export const DARK_CANVAS_LUMINANCE = 0.2;
+export const isDarkCanvas = canvas => relativeLuminance(canvas) < DARK_CANVAS_LUMINANCE;
+
+// Direction comes from the backdrop, so "away from what it sits on" needs no mode argument.
+export function liftToContrast(hex, backdrop, target) {
+  if (contrastRatio(hex, backdrop) >= target) return hex;
+  const {
+    s
+  } = hexToHsl(hex);
+  const step = isDarkCanvas(backdrop) ? 1 : -1;
+  let {
+    l
+  } = hexToHsl(hex);
+  while (l > 0 && l < 100) {
+    l += step;
+    const next = withLightness(hex, l, s);
+    if (contrastRatio(next, backdrop) >= target) return next;
+  }
+  return withLightness(hex, step === 1 ? 100 : 0, s);
+}
+
+/**
+ * Mirror of `liftToContrast`: walks ink TOWARD the backdrop, stopping at the last step that
+ * still clears `target`. For ink that must stay legible without reading as body copy.
+ */
+export function softenToContrast(hex, backdrop, target) {
+  if (contrastRatio(hex, backdrop) <= target) return hex;
+  const {
+    s,
+    l: start
+  } = hexToHsl(hex);
+  const toward = isDarkCanvas(backdrop) ? -1 : 1;
+  let softest = hex;
+  for (let l = start; l > 0 && l < 100; l += toward) {
+    const next = withLightness(hex, l, s);
+    if (contrastRatio(next, backdrop) < target) break;
+    softest = next;
+  }
+  return softest;
+}
+//# sourceMappingURL=liftToContrast.js.map

package/lib/module/theme/tokens/builders/paletteFromAccent.js

@@ -0,0 +1,30 @@
+"use strict";
+
+import { palettes } from "../brands/index.js";
+import { buildBrandScale } from "./buildBrandScale.js";
+import finalizePalette from "./finalizePalette.js";
+import { inkSafeGradient } from "./gradientInk.js";
+function stripSemanticText(palette) {
+  const {
+    semanticText: _semanticText,
+    ...source
+  } = palette;
+  return source;
+}
+export function paletteFromAccent(accentHex, brand, mode) {
+  const base = palettes[brand][mode];
+  const source = stripSemanticText(base);
+  const towardLow = mode === "light" ? source.white : source.black;
+  const towardHigh = mode === "light" ? source.black : source.white;
+  const primary = buildBrandScale(accentHex, towardLow, towardHigh);
+  const gradient = inkSafeGradient({
+    from: primary[500],
+    to: primary[700]
+  });
+  return finalizePalette({
+    ...source,
+    primary,
+    gradient
+  });
+}
+//# sourceMappingURL=paletteFromAccent.js.map

package/lib/module/theme/tokens/builders/placeholderInk.js

@@ -0,0 +1,22 @@
+"use strict";
+
+import { contrastRatio } from "./color.js";
+import { liftToContrast } from "./liftToContrast.js";
+import { PLACEHOLDER_TEXT } from "./surfaceRungs.js";
+
+/** A field always renders on at least one surface — the first is the reference backdrop. */
+
+/**
+ * The hint ink for a field: the rung the brand authored, guaranteed to clear `PLACEHOLDER_TEXT`
+ * on every surface a field can land on. The surface list is the caller's — a field's fill differs
+ * by platform, the resolution does not.
+ *
+ * It does not walk the rung toward AA in either direction. Held to 4.5 the hint stopped reading
+ * as a hint; softening back down again undershot on the next surface.
+ */
+export const placeholderInkOn = (palette, surfaces) => {
+  const rung = palette.placeholder[500];
+  const hardest = surfaces.reduce((worst, s) => contrastRatio(rung, s) < contrastRatio(rung, worst) ? s : worst);
+  return liftToContrast(rung, hardest, PLACEHOLDER_TEXT);
+};
+//# sourceMappingURL=placeholderInk.js.map

package/lib/module/theme/tokens/builders/semanticText.js

@@ -0,0 +1,14 @@
+"use strict";
+
+import { AA_TEXT } from "./color.js";
+import { liftToContrast } from "./liftToContrast.js";
+export const SEMANTIC_TONES = ["success", "error", "warning", "info"];
+
+// `semantic[tone][500]` is a FILL rung; as ink it measures 1.84-3.68:1 on every light canvas.
+export const buildSemanticText = (semantic, canvas) => ({
+  success: liftToContrast(semantic.success[500], canvas, AA_TEXT),
+  error: liftToContrast(semantic.error[500], canvas, AA_TEXT),
+  warning: liftToContrast(semantic.warning[500], canvas, AA_TEXT),
+  info: liftToContrast(semantic.info[500], canvas, AA_TEXT)
+});
+//# sourceMappingURL=semanticText.js.map

package/lib/module/theme/tokens/builders/skeletonShimmer.js

@@ -0,0 +1,22 @@
+"use strict";
+
+import { contrastRatio } from "./color.js";
+import { liftToContrast } from "./liftToContrast.js";
+
+/** Decorative shimmer band — must clear this against `background[200]` (skeleton base). */
+export const SKELETON_SHIMMER_CONTRAST = 1.35;
+const SHIMMER_CANDIDATE_RUNGS = [300, 100, 400, 50];
+
+/**
+ * Skeleton-only highlight fill. Derived from the background ramp against sunken (`[200]`), never from
+ * `backgroundColor.muted` — that token is shared with hover surfaces and other AA ink measurements.
+ */
+export function skeletonShimmerHighlight(p) {
+  const base = p.background[200];
+  for (const rung of SHIMMER_CANDIDATE_RUNGS) {
+    const candidate = p.background[rung];
+    if (contrastRatio(candidate, base) >= SKELETON_SHIMMER_CONTRAST) return candidate;
+  }
+  return liftToContrast(p.background[300], base, SKELETON_SHIMMER_CONTRAST);
+}
+//# sourceMappingURL=skeletonShimmer.js.map

package/lib/module/theme/tokens/builders/surfaceRungs.js

@@ -0,0 +1,44 @@
+"use strict";
+
+import { AA_NON_TEXT, AA_TEXT, contrastRatio } from "./color.js";
+import { liftToContrast } from "./liftToContrast.js";
+
+/**
+ * A hint is held to the non-text floor, not the body-text one. Deliberate: at 4.5 an empty field
+ * reads as one already typed into. See THEME-CONTRACT.md.
+ */
+export const PLACEHOLDER_TEXT = AA_NON_TEXT;
+export const namedSurfaces = p => [...Object.values(p.backgroundColor), p.background[50], p.table.hover[500]];
+
+/** The surface an ink is closest to — clearing it clears every other one. */
+export const hardestSurface = (ink, surfaces) => surfaces.reduce((worst, s) => contrastRatio(ink, s) < contrastRatio(ink, worst) ? s : worst);
+
+// Runs after the hover rung: `table.hover` is one of the surfaces being cleared.
+export function withSurfaceRungs(source) {
+  const surfaces = namedSurfaces(source);
+  const lift = (ink, target) => liftToContrast(ink, hardestSurface(ink, surfaces), target);
+  return {
+    ...source,
+    text: {
+      ...source.text,
+      500: lift(source.text[500], AA_TEXT)
+    },
+    header: {
+      ...source.header,
+      500: lift(source.header[500], AA_TEXT)
+    },
+    // `placeholder` is deliberately absent: the brand authors that rung and it ships untouched.
+    // Its floor is enforced in `placeholderInkOn`, against the surfaces a FIELD renders on.
+    boxborder: {
+      ...source.boxborder,
+      500: lift(source.boxborder[500], AA_NON_TEXT)
+    }
+  };
+}
+export const liftSemanticText = (semanticText, surfaces) => ({
+  success: liftToContrast(semanticText.success, hardestSurface(semanticText.success, surfaces), AA_TEXT),
+  error: liftToContrast(semanticText.error, hardestSurface(semanticText.error, surfaces), AA_TEXT),
+  warning: liftToContrast(semanticText.warning, hardestSurface(semanticText.warning, surfaces), AA_TEXT),
+  info: liftToContrast(semanticText.info, hardestSurface(semanticText.info, surfaces), AA_TEXT)
+});
+//# sourceMappingURL=surfaceRungs.js.map