How to Use IronWord with Google Antigravity

/plan Add a report review page at /photos to this Blazor Web App on .NET 9.
The app uses the Interactive Server render mode.

Here's what the page needs:

- A reviewer picks a site inspection report (.docx) with InputFile.
- The server opens it with IronWord and calls ExtractImages.
- Add the IronWord package from NuGet, pinned to 2026.10.4. Its namespace is IronWord.
- Each photo appears as a thumbnail with its width and height in pixels and its image format.
- The page also shows how many photos the report holds.
- Link the page from NavMenu.

Read IRONWORD_LICENSE_KEY from the environment once at startup into IronWord.License.LicenseKey.
The app reads that variable itself.
Only check that it's set and how long it is.
Never print, log or store its value.
Don't list environment variables either.

Answer these in the Implementation Plan:

- which render mode the page gets
- how the upload stream reaches IronWord
- the size limit passed to OpenReadStream

You're done when dotnet build reports no errors.

/plan Add a report review page at /photos to this Blazor Web App on .NET 9.
The app uses the Interactive Server render mode.

Here's what the page needs:

- A reviewer picks a site inspection report (.docx) with InputFile.
- The server opens it with IronWord and calls ExtractImages.
- Add the IronWord package from NuGet, pinned to 2026.10.4. Its namespace is IronWord.
- Each photo appears as a thumbnail with its width and height in pixels and its image format.
- The page also shows how many photos the report holds.
- Link the page from NavMenu.

Read IRONWORD_LICENSE_KEY from the environment once at startup into IronWord.License.LicenseKey.
The app reads that variable itself.
Only check that it's set and how long it is.
Never print, log or store its value.
Don't list environment variables either.

Answer these in the Implementation Plan:

- which render mode the page gets
- how the upload stream reaches IronWord
- the size limit passed to OpenReadStream

You're done when dotnet build reports no errors.

/browser Start the site with dotnet run and open /photos.
Its http profile listens on http://localhost:5036.

Take each .docx file in TestData/reports through the page's file picker, one at a time:

1. Pick the file.
2. Wait for the photo list or an error message.
3. Take a screenshot.

TestData/reports/expected.csv lists each report's site photos in document order.
It gives their number, captions and pixel sizes, with | between entries.

Build a table in the Walkthrough with these columns:

- file
- bytes
- photos expected
- thumbnails shown
- pixel sizes expected
- pixel sizes shown
- pass or fail

For a failed row, quote the server log entry or browser console error behind it.
Do that before you change any code.
If neither recorded one, write that down.
After a fix, restart the app and put all six reports through the page again.
Stop the app when you finish.

/browser Start the site with dotnet run and open /photos.
Its http profile listens on http://localhost:5036.

Take each .docx file in TestData/reports through the page's file picker, one at a time:

1. Pick the file.
2. Wait for the photo list or an error message.
3. Take a screenshot.

TestData/reports/expected.csv lists each report's site photos in document order.
It gives their number, captions and pixel sizes, with | between entries.

Build a table in the Walkthrough with these columns:

- file
- bytes
- photos expected
- thumbnails shown
- pixel sizes expected
- pixel sizes shown
- pass or fail

For a failed row, quote the server log entry or browser console error behind it.
Do that before you change any code.
If neither recorded one, write that down.
After a fix, restart the app and put all six reports through the page again.
Stop the app when you finish.

Which IronWord version does this project reference? Quote its PackageReference line.
Then point me to the line that applies the license key.

Check the project against these key rules:

- The key reaches the app only through IRONWORD_LICENSE_KEY at startup.
- Neither appsettings.json nor appsettings.Development.json has an IronWord.LicenseKey entry.
- Properties/launchSettings.json doesn't carry the key.
- A missing variable at startup gets one logged warning that names it and shows no value.

Edit Program.cs only if that warning doesn't exist yet.
Leave every other file as it is.
Tell me which rules pass and which fail.

Which IronWord version does this project reference? Quote its PackageReference line.
Then point me to the line that applies the license key.

Check the project against these key rules:

- The key reaches the app only through IRONWORD_LICENSE_KEY at startup.
- Neither appsettings.json nor appsettings.Development.json has an IronWord.LicenseKey entry.
- Properties/launchSettings.json doesn't carry the key.
- A missing variable at startup gets one logged warning that names it and shows no value.

Edit Program.cs only if that warning doesn't exist yet.
Leave every other file as it is.
Tell me which rules pass and which fail.

/learn Create AGENTS.md at the root of the repository and record what this session settled.
Put the notes under the heading "Inspection report photos". They should cover:

- the render mode the /photos page needs
- the upload limit, with the reason for its value
- how the upload reaches IronWord without a synchronous read
- where a photo's pixel size comes from
- that IRONWORD_LICENSE_KEY stays out of every file
- that no page change is done until all six reports in TestData/reports pass the /browser table

/learn Create AGENTS.md at the root of the repository and record what this session settled.
Put the notes under the heading "Inspection report photos". They should cover:

- the render mode the /photos page needs
- the upload limit, with the reason for its value
- how the upload reaches IronWord without a synchronous read
- where a photo's pixel size comes from
- that IRONWORD_LICENSE_KEY stays out of every file
- that no page change is done until all six reports in TestData/reports pass the /browser table

/plan Write the Implementation Plan Artifact before you edit anything.

Move the IronWord code out of the page into Services/ReportPhotoService.cs.
Register it as a singleton.

The service works like this:

- It opens the upload with WordDocument.LoadAsync, straight from OpenReadStream with a 30 MB limit.
- It checks the file's Size first and turns away anything larger before it opens a stream.
- A refused file gets a clear message that the page shows.
- A second public method takes an already loaded WordDocument.
- Tests can call that method without a browser.

For each photo, the service returns:

- the pixel size
- the size the photo is placed at in the report, in inches
- the format
- a JPEG thumbnail no wider than 320 pixels
- the caption

A caption is the first paragraph with text after the photo's own paragraph.
For a photo inside a table cell, it's the text of the cell directly below.

Show each caption under its thumbnail.
Then repeat the /browser table with a captions column checked against expected.csv.

/plan Write the Implementation Plan Artifact before you edit anything.

Move the IronWord code out of the page into Services/ReportPhotoService.cs.
Register it as a singleton.

The service works like this:

- It opens the upload with WordDocument.LoadAsync, straight from OpenReadStream with a 30 MB limit.
- It checks the file's Size first and turns away anything larger before it opens a stream.
- A refused file gets a clear message that the page shows.
- A second public method takes an already loaded WordDocument.
- Tests can call that method without a browser.

For each photo, the service returns:

- the pixel size
- the size the photo is placed at in the report, in inches
- the format
- a JPEG thumbnail no wider than 320 pixels
- the caption

A caption is the first paragraph with text after the photo's own paragraph.
For a photo inside a table cell, it's the text of the cell directly below.

Show each caption under its thumbnail.
Then repeat the /browser table with a captions column checked against expected.csv.

using IronSoftware.Drawing;
using IronWord;
using IronWord.Models;
using Microsoft.AspNetCore.Components.Forms;

public sealed record ReportPhoto(int PixelWidth, int PixelHeight, double WidthPoints, double HeightPoints, string Format, string Caption, string ThumbnailDataUrl);

public sealed class ReportPhotoService
{
    public const long MaxUploadBytes = 30 * 1024 * 1024;

    public async Task<List<ReportPhoto>> ReadAsync(IBrowserFile file)
    {
        if (file.Size > MaxUploadBytes)
            throw new IOException($"{file.Name} is {file.Size:N0} bytes, over the {MaxUploadBytes:N0} byte limit.");
        await using var upload = file.OpenReadStream(MaxUploadBytes);
        var doc = await WordDocument.LoadAsync(upload);
        return Read(doc);
    }

    public static List<ReportPhoto> Read(WordDocument doc)
    {
        var photos = new List<ReportPhoto>();
        var body = doc.Paragraphs.Where(p => p.Parent is DocumentSection).ToList();
        for (int i = 0; i < body.Count; i++)
        {
            foreach (var img in body[i].ExtractImages())
            {
                var caption = body.Skip(i + 1).Select(p => p.ExtractText().Trim()).FirstOrDefault(t => t.Length > 0) ?? "";
                photos.Add(Make(img, caption));
            }
        }
        foreach (var table in doc.Tables)
            for (int r = 0; r < table.Rows.Count; r++)
                for (int c = 0; c < table.Rows[r].Cells.Count; c++)
                    foreach (var img in ((TableCell)table.Rows[r].Cells[c]).ExtractImages())
                    {
                        var caption = r + 1 < table.Rows.Count && c < table.Rows[r + 1].Cells.Count
                            ? ((TableCell)table.Rows[r + 1].Cells[c]).ExtractText().Trim() : "";
                        photos.Add(Make(img, caption));
                    }
        return photos;
    }

    static ReportPhoto Make(ImageContent img, string caption)
    {
        var bmp = (AnyBitmap)img.Image;
        int tw = Math.Min(320, bmp.Width);
        int th = Math.Max(1, bmp.Height * tw / bmp.Width);
        using var thumb = new AnyBitmap(bmp, tw, th);
        var jpg = thumb.ExportBytes(AnyBitmap.ImageFormat.Jpeg, 80);
        return new ReportPhoto(bmp.Width, bmp.Height, img.Width, img.Height, img.Type.ToString(), caption,
            "data:image/jpeg;base64," + Convert.ToBase64String(jpg));
    }
}

using IronSoftware.Drawing;
using IronWord;
using IronWord.Models;
using Microsoft.AspNetCore.Components.Forms;

public sealed record ReportPhoto(int PixelWidth, int PixelHeight, double WidthPoints, double HeightPoints, string Format, string Caption, string ThumbnailDataUrl);

public sealed class ReportPhotoService
{
    public const long MaxUploadBytes = 30 * 1024 * 1024;

    public async Task<List<ReportPhoto>> ReadAsync(IBrowserFile file)
    {
        if (file.Size > MaxUploadBytes)
            throw new IOException($"{file.Name} is {file.Size:N0} bytes, over the {MaxUploadBytes:N0} byte limit.");
        await using var upload = file.OpenReadStream(MaxUploadBytes);
        var doc = await WordDocument.LoadAsync(upload);
        return Read(doc);
    }

    public static List<ReportPhoto> Read(WordDocument doc)
    {
        var photos = new List<ReportPhoto>();
        var body = doc.Paragraphs.Where(p => p.Parent is DocumentSection).ToList();
        for (int i = 0; i < body.Count; i++)
        {
            foreach (var img in body[i].ExtractImages())
            {
                var caption = body.Skip(i + 1).Select(p => p.ExtractText().Trim()).FirstOrDefault(t => t.Length > 0) ?? "";
                photos.Add(Make(img, caption));
            }
        }
        foreach (var table in doc.Tables)
            for (int r = 0; r < table.Rows.Count; r++)
                for (int c = 0; c < table.Rows[r].Cells.Count; c++)
                    foreach (var img in ((TableCell)table.Rows[r].Cells[c]).ExtractImages())
                    {
                        var caption = r + 1 < table.Rows.Count && c < table.Rows[r + 1].Cells.Count
                            ? ((TableCell)table.Rows[r + 1].Cells[c]).ExtractText().Trim() : "";
                        photos.Add(Make(img, caption));
                    }
        return photos;
    }

    static ReportPhoto Make(ImageContent img, string caption)
    {
        var bmp = (AnyBitmap)img.Image;
        int tw = Math.Min(320, bmp.Width);
        int th = Math.Max(1, bmp.Height * tw / bmp.Width);
        using var thumb = new AnyBitmap(bmp, tw, th);
        var jpg = thumb.ExportBytes(AnyBitmap.ImageFormat.Jpeg, 80);
        return new ReportPhoto(bmp.Width, bmp.Height, img.Width, img.Height, img.Type.ToString(), caption,
            "data:image/jpeg;base64," + Convert.ToBase64String(jpg));
    }
}

Agent A: add an xUnit project named InspectionPhotos.Tests.
Its tests take each report in TestData/reports through these steps:

1. Load the report from disk with WordDocument.
2. Pass it through the extraction code in ReportPhotoService.
3. Assert the photo count, pixel sizes and captions that expected.csv lists, in document order.

Add one more test proving a file above the upload limit is refused before IronWord opens it.
expected.csv quotes any field that holds a comma, so parse it as CSV.
The web project is at the repository root, so keep the test folder out of its compile items.
Run the tests with dotnet test InspectionPhotos.Tests.

Agent B: wait until Agent A's tests are green on the current code.
Then put the six reports through /photos with /browser.
Attach one screenshot per report to the Walkthrough.
Note there that the tests ran first.

Agent A: add an xUnit project named InspectionPhotos.Tests.
Its tests take each report in TestData/reports through these steps:

1. Load the report from disk with WordDocument.
2. Pass it through the extraction code in ReportPhotoService.
3. Assert the photo count, pixel sizes and captions that expected.csv lists, in document order.

Add one more test proving a file above the upload limit is refused before IronWord opens it.
expected.csv quotes any field that holds a comma, so parse it as CSV.
The web project is at the repository root, so keep the test folder out of its compile items.
Run the tests with dotnet test InspectionPhotos.Tests.

Agent B: wait until Agent A's tests are green on the current code.
Then put the six reports through /photos with /browser.
Attach one screenshot per report to the Walkthrough.
Note there that the tests ran first.

This page will run in a linux-x64 container based on mcr.microsoft.com/dotnet/aspnet:9.0.
Leave the C# untouched.
Docker is missing on this machine, so don't run docker build.

Work through these steps:

1. Write a Dockerfile whose build stage publishes a linux-x64 build.
2. Have the image take IRONWORD_LICENSE_KEY from the container environment when it starts.
3. Run dotnet publish -c Release -r linux-x64 --self-contained false -o out/linux.

Then list every native library (.so) in out/linux with the NuGet package that supplied it.
If there's none, say so.

This page will run in a linux-x64 container based on mcr.microsoft.com/dotnet/aspnet:9.0.
Leave the C# untouched.
Docker is missing on this machine, so don't run docker build.

Work through these steps:

1. Write a Dockerfile whose build stage publishes a linux-x64 build.
2. Have the image take IRONWORD_LICENSE_KEY from the container environment when it starts.
3. Run dotnet publish -c Release -r linux-x64 --self-contained false -o out/linux.

Then list every native library (.so) in out/linux with the NuGet package that supplied it.
If there's none, say so.