Function resolveOrderItem

packages/graph/src/astToSteps.ts:3092–3120

* Resolve an ORDER BY item to a direction config for OrderStep. * Handles both property access (n.name) and alias references (value). * * @param useAliasDirectly - If true (WITH ORDER BY), use the alias as the key since * the path has the alias bound after projection. If false (RETURN ORDER BY

(
  order: OrderItem,
  aliasMap: Map<string, AliasInfo>,
  useAliasDirectly: boolean = false,
)

 *   the source property/variable since ordering happens before projection.
 */
function resolveOrderItem(
  order: OrderItem,
  aliasMap: Map<string, AliasInfo>,
  useAliasDirectly: boolean = false,
): {
  key?: string;
  expression?: ConditionValue;
  direction: OrderDirection;
  nulls?: "first" | "last";
} {
  const base =
    order.expression !== undefined
      ? {
          expression: useAliasDirectly
            ? convertConditionValue(order.expression)
            : resolveReturnOrderExpression(order.expression, aliasMap),
        }
      : {
          key: resolveOrderKey(order, aliasMap, useAliasDirectly),
        };

  return {
    ...base,
    direction: order.direction.toLowerCase() as OrderDirection,
    ...(order.nulls && {
      nulls: order.nulls.toLowerCase() as "first" | "last",
    }),
  };
}

function resolveOrderKey(
  order: OrderItem,