Function validateStackProps

packages/core/src/layout/validate/interactive.ts:172–246

(
  kind: "row" | "column",
  props: StackProps | unknown,
)

/** Validate Row/Column props: pad (default 0), gap (default 0), align (default "start"). */
export function validateStackProps(
  kind: "row" | "column",
  props: StackProps | unknown,
): LayoutResult<ValidatedStackProps> {
  const propsRes = requirePropBag(kind, props);
  if (!propsRes.ok) return propsRes;
  const p = propsRes.value as StackPropBag;

  const padRes = requireSpacingIntNonNegative(kind, "pad", p.pad, 0);
  if (!padRes.ok) return padRes;
  const gapRes = requireSpacingIntNonNegative(kind, "gap", p.gap, 0);
  if (!gapRes.ok) return gapRes;

  const alignRaw = resolveResponsiveValue(p.items ?? p.align);
  const alignValue = alignRaw === undefined ? "start" : normalizeStringToken(alignRaw);
  if (
    alignValue !== "start" &&
    alignValue !== "center" &&
    alignValue !== "end" &&
    alignValue !== "stretch"
  ) {
    return invalid(`${kind}.align must be one of "start" | "center" | "end" | "stretch"`);
  }

  const justifySource = resolveResponsiveValue(p.justify);
  const justifyRaw = justifySource === undefined ? "start" : normalizeStringToken(justifySource);
  const justifyValue =
    justifyRaw === "space-between"
      ? "between"
      : justifyRaw === "space-around"
        ? "around"
        : justifyRaw === "space-evenly"
          ? "evenly"
          : justifyRaw;
  if (
    justifyValue !== "start" &&
    justifyValue !== "end" &&
    justifyValue !== "center" &&
    justifyValue !== "between" &&
    justifyValue !== "around" &&
    justifyValue !== "evenly"
  ) {
    return invalid(
      `${kind}.justify must be one of "start" | "end" | "center" | "between" | "around" | "evenly" (also accepts CSS aliases: "space-between" | "space-around" | "space-evenly")`,
    );
  }

  const lcRes = validateLayoutConstraints(kind, p);
  if (!lcRes.ok) return lcRes;
  const normalizedConstraints: ValidatedLayoutConstraints = { ...lcRes.value };
  const overflowRes = requireOverflow(kind, "overflow", p.overflow, "visible");
  if (!overflowRes.ok) return overflowRes;
  const scrollXRes = requireIntNonNegative(kind, "scrollX", p.scrollX, 0);
  if (!scrollXRes.ok) return scrollXRes;
  const scrollYRes = requireIntNonNegative(kind, "scrollY", p.scrollY, 0);
  if (!scrollYRes.ok) return scrollYRes;

  const spRes = validateSpacingProps(kind, p as unknown as Record<string, unknown>);