Add landscape page size options (#6248)

# Description of Changes

Adds orientation (portrait/landscape) to the Adjust Page Scale tool.

- Orientation as a separate parameter (per review), sent through to the
backend
- ScalePagesController simplified; PDFWithPageSize gains the orientation
field
- Regenerated tool_models.py; frontend + backend tests added

---

## Checklist

### General

- [ ] I have read the [Contribution
Guidelines](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/CONTRIBUTING.md)
- [ ] I have read the [Stirling-PDF Developer
Guide](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/DeveloperGuide.md)
(if applicable)
- [ ] I have read the [How to add new languages to
Stirling-PDF](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/HowToAddNewLanguage.md)
(if applicable)
- [ ] I have performed a self-review of my own code
- [ ] My changes generate no new warnings

### Documentation

- [ ] I have updated relevant docs on [Stirling-PDF's doc
repo](https://github.com/Stirling-Tools/Stirling-Tools.github.io/blob/main/docs/)
(if functionality has heavily changed)
- [ ] I have read the section [Add New Translation
Tags](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/HowToAddNewLanguage.md#add-new-translation-tags)
(for new translation tags only)

### Translations (if applicable)

- [ ] I ran
[`scripts/counter_translation.py`](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/docs/counter_translation.md)

### UI Changes (if applicable)

- [ ] Screenshots or videos demonstrating the UI changes are attached
(e.g., as comments or direct attachments in the PR)

### Testing (if applicable)

- [ ] I have run `task check` to verify linters, typechecks, and tests
pass
- [ ] I have tested my changes locally. Refer to the [Testing
Guide](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/DeveloperGuide.md#7-testing)
for more details.

---------

Co-authored-by: ConnorYoh <[email protected]>

frontend/editor/src/core/hooks/tools/adjustPageScale/adjustPageScaleFormData.ts

@@ -0,0 +1,13 @@
+import { AdjustPageScaleParameters } from "@app/hooks/tools/adjustPageScale/useAdjustPageScaleParameters";
+
+export const buildAdjustPageScaleFormData = (
+  parameters: AdjustPageScaleParameters,
+  file: File,
+): FormData => {
+  const formData = new FormData();
+  formData.append("fileInput", file);
+  formData.append("scaleFactor", parameters.scaleFactor.toString());
+  formData.append("pageSize", parameters.pageSize);
+  formData.append("orientation", parameters.orientation);
+  return formData;
+};

frontend/editor/src/core/hooks/tools/adjustPageScale/useAdjustPageScaleOperation.test.ts

@@ -0,0 +1,51 @@
+import { describe, expect, it } from "vitest";
+import { buildAdjustPageScaleFormData } from "@app/hooks/tools/adjustPageScale/adjustPageScaleFormData";
+import {
+  defaultParameters,
+  PageSize,
+} from "@app/hooks/tools/adjustPageScale/useAdjustPageScaleParameters";
+
+const stubFile = () =>
+  new File(["data"], "doc.pdf", { type: "application/pdf" });
+
+describe("buildAdjustPageScaleFormData", () => {
+  it("includes scaleFactor, pageSize, and orientation by default", () => {
+    const formData = buildAdjustPageScaleFormData(
+      defaultParameters,
+      stubFile(),
+    );
+    expect(formData.get("scaleFactor")).toBe(
+      defaultParameters.scaleFactor.toString(),
+    );
+    expect(formData.get("pageSize")).toBe(defaultParameters.pageSize);
+    expect(formData.get("orientation")).toBe(defaultParameters.orientation);
+  });
+
+  it("forwards orientation=LANDSCAPE to the backend", () => {
+    const formData = buildAdjustPageScaleFormData(
+      { ...defaultParameters, pageSize: PageSize.A4, orientation: "LANDSCAPE" },
+      stubFile(),
+    );
+    expect(formData.get("orientation")).toBe("LANDSCAPE");
+    expect(formData.get("pageSize")).toBe("A4");
+  });
+
+  it("forwards orientation=PORTRAIT to the backend", () => {
+    const formData = buildAdjustPageScaleFormData(
+      {
+        ...defaultParameters,
+        pageSize: PageSize.LEGAL,
+        orientation: "PORTRAIT",
+      },
+      stubFile(),
+    );
+    expect(formData.get("orientation")).toBe("PORTRAIT");
+    expect(formData.get("pageSize")).toBe("LEGAL");
+  });
+
+  it("attaches the uploaded file under fileInput", () => {
+    const file = stubFile();
+    const formData = buildAdjustPageScaleFormData(defaultParameters, file);
+    expect(formData.get("fileInput")).toBe(file);
+  });
+});

frontend/editor/src/core/hooks/tools/adjustPageScale/useAdjustPageScaleOperation.ts

@@ -8,17 +8,9 @@ import {
   AdjustPageScaleParameters,
   defaultParameters,
 } from "@app/hooks/tools/adjustPageScale/useAdjustPageScaleParameters";
+import { buildAdjustPageScaleFormData } from "@app/hooks/tools/adjustPageScale/adjustPageScaleFormData";
 
-export const buildAdjustPageScaleFormData = (
-  parameters: AdjustPageScaleParameters,
-  file: File,
-): FormData => {
-  const formData = new FormData();
-  formData.append("fileInput", file);
-  formData.append("scaleFactor", parameters.scaleFactor.toString());
-  formData.append("pageSize", parameters.pageSize);
-  return formData;
-};
+export { buildAdjustPageScaleFormData };
 
 export const adjustPageScaleOperationConfig = {
   toolType: ToolType.singleFile,

frontend/editor/src/core/hooks/tools/adjustPageScale/useAdjustPageScaleParameters.test.ts

@@ -23,6 +23,8 @@ describe("useAdjustPageScaleParameters", () => {
     { paramName: "pageSize" as const, value: PageSize.A4 },
     { paramName: "pageSize" as const, value: PageSize.LETTER },
     { paramName: "pageSize" as const, value: PageSize.LEGAL },
+    { paramName: "orientation" as const, value: "LANDSCAPE" as const },
+    { paramName: "orientation" as const, value: "PORTRAIT" as const },
   ])("should update parameter $paramName to $value", ({ paramName, value }) => {
     const { result } = renderHook(() => useAdjustPageScaleParameters());
 

frontend/editor/src/core/hooks/tools/adjustPageScale/useAdjustPageScaleParameters.ts

@@ -17,14 +17,18 @@ export enum PageSize {
   LEGAL = "LEGAL",
 }
 
+export type Orientation = "PORTRAIT" | "LANDSCAPE";
+
 export interface AdjustPageScaleParameters extends BaseParameters {
   scaleFactor: number;
   pageSize: PageSize;
+  orientation: Orientation;
 }
 
 export const defaultParameters: AdjustPageScaleParameters = {
   scaleFactor: 1.0,
   pageSize: PageSize.KEEP,
+  orientation: "PORTRAIT",
 };
 
 export type AdjustPageScaleParametersHook =