@wix/himalaya-cli 0.1241.0 → 0.1243.0

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/core/ts/src/tokens.d.ts

@@ -20,6 +20,9 @@ export interface DesignTokens {
     materials?: Record<string, MaterialToken>;
     /** RFC 0059 / #2931 — named surface elevations, paint only. A `Card` wears `card`. */
     elevations?: Record<string, ElevationToken>;
+    /** #3491 — per-control styling the renderers read instead of hard-coded values. Today: the
+     *  `button` group (per size and per variant). Absent ⇒ every renderer draws exactly as before. */
+    controls?: ControlTokens;
     /** RFC 0021 (bottom-nav extension) — kit-driven tab bar styling. */
     tabBar?: TabBarStyle;
     /** RFC 0010/0021 — kit-driven slide-in drawer styling. */
@@ -300,6 +303,97 @@ export declare const TONAL_ELEVATION_ALPHA: readonly number[];
 /** The tint alpha an `ElevationToken.level` asks for: rounded and clamped to 0–5; anything
  *  non-numeric is 0 (no tint). */
 export declare function tonalElevationAlpha(level: number | undefined): number;
+/**
+ * #3491 — per-control design tokens. One group per control; `button` is the first.
+ *
+ *   "controls": {
+ *     "button": {
+ *       "sm": { "height": 36, "paddingH": 13, "text": "bodyEmphasis", "icon": 14 },
+ *       "variants": { "secondary": { "radius": 4, "borderWidth": 1 } }
+ *     }
+ *   }
+ *
+ * Every field is optional, at every depth. A field that is absent keeps that renderer's
+ * built-in value, so a token set with no `controls` block draws every Button exactly as before.
+ */
+export interface ControlTokens {
+    button?: ButtonTokens;
+}
+/** The three Button sizes, in the order `ButtonProps.size` names them. An unknown or absent size
+ *  is `md` on every renderer. */
+export declare const BUTTON_SIZES: readonly ["sm", "md", "lg"];
+export type ButtonSize = (typeof BUTTON_SIZES)[number];
+/** #3491 — Button tokens: one entry per size, plus `variants` keyed by `ButtonProps.style`
+ *  (`primary`, `secondary`, `tertiary`, `link`, `plain`, `destructive`, or any app style). */
+export interface ButtonTokens {
+    sm?: ButtonSizeToken;
+    md?: ButtonSizeToken;
+    lg?: ButtonSizeToken;
+    variants?: Record<string, ButtonVariantToken>;
+}
+/** The geometry of one Button size. Lengths are points (iOS/macOS), dp (Android) or CSS px (web). */
+export interface ButtonSizeToken {
+    /** The VISIBLE minimum height of the button. A value under {@link BUTTON_MIN_HIT_TARGET} keeps
+     *  the tap target at that floor through a transparent hit area, never through the visible box. */
+    height?: number;
+    /** Horizontal padding between the edge and the label. */
+    paddingH?: number;
+    /** Vertical padding between the edge and the label. */
+    paddingV?: number;
+    /** A `typography` token name for the label. */
+    text?: string;
+    /** The leading/trailing glyph (and spinner) size. */
+    icon?: number;
+    /** Corner radius. A variant's `radius` wins over this one; `ButtonProps.cornerRadius` wins over both. */
+    radius?: number;
+}
+/** The paint of one Button variant (`ButtonProps.style`). Colours are colour-token names or `#hex`. */
+export interface ButtonVariantToken {
+    /** The background fill. Absent ⇒ the variant's built-in fill (`accentPrimary`/`danger` when
+     *  filled, none otherwise). */
+    fill?: string;
+    /** The label, glyph and spinner colour. */
+    label?: string;
+    /** The outline colour. Absent ⇒ the label colour. */
+    border?: string;
+    /** The outline width; 0 = no outline. Absent ⇒ 1 for `secondary`, 0 otherwise. */
+    borderWidth?: number;
+    /** Corner radius; wins over the size's `radius`. */
+    radius?: number;
+}
+/** The smallest tap target a Button may have, on every renderer (WCAG 2.5.8 / Apple HIG 44pt).
+ *  A visible height below it is padded out by a transparent hit area. */
+export declare const BUTTON_MIN_HIT_TARGET = 44;
+/** The Button tokens for one size + variant, merged. Each field is present only when a token sets
+ *  it to a usable value, so a renderer falls back to its own built-in value field by field. */
+export interface ResolvedButtonTokens {
+    height?: number;
+    paddingH?: number;
+    paddingV?: number;
+    text?: string;
+    icon?: number;
+    radius?: number;
+    fill?: string;
+    label?: string;
+    border?: string;
+    borderWidth?: number;
+}
+/**
+ * #3491 — resolve `controls.button` for a Button of `size` and `style`. The shared rule every
+ * renderer mirrors (iOS `SDUIButtonTokens`, Android `SDUIButtonTokens`, web, React Native):
+ *
+ *   - `size` is `sm` / `lg`, else `md`; `style` absent is `primary`;
+ *   - a negative or non-finite length, and an empty name, is "not set";
+ *   - `radius`: the variant's, else the size's.
+ *
+ * Read defensively: the tokens document is published data, so any level can be malformed.
+ */
+export declare function resolveButtonTokens(tokens: {
+    controls?: unknown;
+} | null | undefined, size: string | null | undefined, style: string | null | undefined): ResolvedButtonTokens;
+/** The transparent hit area to add above AND below a Button whose visible minimum height is
+ *  `visibleHeight`, so its tap target reaches {@link BUTTON_MIN_HIT_TARGET}. 0 when it already does. */
+export declare function buttonHitSlop(visibleHeight: number | undefined): number;
 /** RFC 0020 — a linear gradient. `colors` are color-token NAMES (theme-aware);
  *  `angle` is degrees clockwise from top (0 = top→bottom, 90 = left→right).
  *  `locations` (0..1) optionally positions each stop. */

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/core.mjs

@@ -7857,6 +7857,36 @@ function tonalElevationAlpha(level) {
   if (typeof level !== "number" || !Number.isFinite(level)) return 0;
   return TONAL_ELEVATION_ALPHA[Math.min(5, Math.max(0, Math.round(level)))];
 }
+var BUTTON_SIZES = ["sm", "md", "lg"];
+var BUTTON_MIN_HIT_TARGET = 44;
+var nonNegative = (v) => typeof v === "number" && Number.isFinite(v) && v >= 0 ? v : void 0;
+var nonEmpty = (v) => typeof v === "string" && v !== "" ? v : void 0;
+var own = (o, k) => o && typeof o === "object" && Object.prototype.hasOwnProperty.call(o, k) ? o[k] : void 0;
+function resolveButtonTokens(tokens, size, style) {
+  const button = own(own(tokens, "controls"), "button");
+  const sizeKey = size === "sm" || size === "lg" ? size : "md";
+  const s = own(button, sizeKey);
+  const v = own(own(button, "variants"), style || "primary");
+  const out = {};
+  const set = (k, val) => {
+    if (val !== void 0) out[k] = val;
+  };
+  set("height", nonNegative(own(s, "height")));
+  set("paddingH", nonNegative(own(s, "paddingH")));
+  set("paddingV", nonNegative(own(s, "paddingV")));
+  set("text", nonEmpty(own(s, "text")));
+  set("icon", nonNegative(own(s, "icon")));
+  set("radius", nonNegative(own(v, "radius")) ?? nonNegative(own(s, "radius")));
+  set("fill", nonEmpty(own(v, "fill")));
+  set("label", nonEmpty(own(v, "label")));
+  set("border", nonEmpty(own(v, "border")));
+  set("borderWidth", nonNegative(own(v, "borderWidth")));
+  return out;
+}
+function buttonHitSlop(visibleHeight) {
+  if (typeof visibleHeight !== "number" || !Number.isFinite(visibleHeight)) return 0;
+  return Math.max(0, (BUTTON_MIN_HIT_TARGET - visibleHeight) / 2);
+}
 function buildTokenRegistry(tokens) {
   return {
     colors: new Set(Object.keys(tokens.colors ?? {})),
@@ -9269,16 +9299,16 @@ function shouldRevealError(args) {
       return args.touched && !args.focused;
   }
 }
-var nonEmpty = (type) => (v) => typeof v === "string" && v.length > 0 && isValid({ type }, v);
+var nonEmpty2 = (type) => (v) => typeof v === "string" && v.length > 0 && isValid({ type }, v);
 var validators = {
   // validates: these are top-level CALLS, which esbuild otherwise has to assume
   // might have side effects — and keeping them retained `validate` and every
   // predicate behind it, DOUBLING a Tier-5 bundle that does no validation at all.
-  email: /* @__PURE__ */ nonEmpty("email"),
-  phone: /* @__PURE__ */ nonEmpty("phone"),
-  url: /* @__PURE__ */ nonEmpty("url"),
-  number: /* @__PURE__ */ nonEmpty("number"),
-  integer: /* @__PURE__ */ nonEmpty("integer")
+  email: /* @__PURE__ */ nonEmpty2("email"),
+  phone: /* @__PURE__ */ nonEmpty2("phone"),
+  url: /* @__PURE__ */ nonEmpty2("url"),
+  number: /* @__PURE__ */ nonEmpty2("number"),
+  integer: /* @__PURE__ */ nonEmpty2("integer")
 };
 function validateAll(rules, values, catalog) {
   const errors = {};
@@ -13404,6 +13434,8 @@ export {
   APP_ID_PATTERN,
   AppRegistryClient,
   BASE44_ORIGINS,
+  BUTTON_MIN_HIT_TARGET,
+  BUTTON_SIZES,
   CHASSIS_GEOMETRY,
   CORE_COMPONENTS,
   DEFAULT_DISTRIBUTION,
@@ -13463,6 +13495,7 @@ export {
   buildPackageShareUrl,
   buildPlayerPreviewUrl,
   buildTokenRegistry,
+  buttonHitSlop,
   chassisOuterSize,
   checkTierCaps,
   chooseCandidate,
@@ -13506,6 +13539,7 @@ export {
   primarySubtag,
   resolveAppIdentity,
   resolveAppLocale,
+  resolveButtonTokens,
   resolveColor,
   resolveIcon,
   resolveIdiom,