Save plan to JSON file.

Create a generation plan for filling a rectangle. Args: bounds: The rectangle bounds (top-left to bottom-right inclusive) generated:

Load plan from JSON file.

Validate that a plan covers all required quadrants exactly once. Returns (is_valid, error_messages).

Convert PNG bytes to a PIL Image.

Get the generation config from the metadata table.

Get a connection to the quadrants database.

Get the generation bytes for a quadrant at position (x, y).

Check if there are generated pixels adjacent to the infill region on the given side.

Create a plan for a depth-3+ strip. For depth 3: 1. Generate 2x2 quadrants away from edge with gaps 2. Generate 1x2 bridges between 2x2 quad

Check if a quadrant has been generated.

Check if a point is within the rectangle bounds.

Mark multiple positions as selected for generation.

Start the Vite dev server and wait for it to be ready. Args: web_dir: Directory containing the web app port: Port to run on Returns:

Convert a PIL Image to PNG bytes.

Mark multiple positions as generated.

Ensure a quadrant exists at position (x, y), creating it if necessary. Returns the quadrant data.

Create a plan for a depth-1 strip. Algorithm: 1. Generate 2x1 quadrants (2 wide in direction of progress) with 1 gap 2. Fill in the single-q

Check if a 2x2 tile can be placed at the given top-left position. Rules: - All 4 quadrants must be within bounds - All 4 quadrants must not

Get list of quadrant (qx, qy) positions that overlap with this region.

Return all points within the rectangle bounds.

Check if a horizontal 2x1 tile can be placed at (left.x, left.y) and (left.x+1, left.y). Rules (following task 019 strip plan): - Both quadran

Create an infill region covering multiple quadrants. The quadrants must form a contiguous rectangle.

Parse bounds from string format: 'min_x,min_y,max_x,max_y'.

Get the render bytes for a quadrant at position (x, y).

Get all positions marked as selected.

Load a GeoJSON bounds file. Args: path: Path to the bounds file. If None, loads the default NYC boundary. Returns: GeoJ

Run a shell command and handle errors.

Check if a vertical 1x2 tile can be placed at (top.x, top.y) and (top.x, top.y+1). Rules (following task 019 strip plan): - Both quadrants mus

Validate a quadrant selection and find optimal placement. This is a convenience function for the common case of selecting whole quadrants for

Build the URL for rendering a tile at the given coordinates. Args: port: Web server port lat: Latitude of the tile center lng:

Check if the region is within the allowed size (≤50% or exactly 100% of template).

Mark a quadrant as generated.

Mark multiple quadrants as generated.

Save generation bytes for a quadrant at position (x, y). Creates the quadrant if it doesn't exist. Returns True if successful.

Split a tile image into 4 quadrant images. Returns a dict mapping (dx, dy) offset to the quadrant image: (0, 0) = top-left (1, 0) = top-

Stitch 4 quadrant images into a single tile image. Args: quadrants: Dict mapping (dx, dy) offset to the quadrant image: (0, 0) = top-l

Update the global generation state.

Create a plan for a depth-2 strip. Apply the depth-1 algorithm twice, once for each row/column. Start with the row/column closest to the gener

Find the generation edge of the strip. The generation edge is the edge of the strip rectangle where ALL exterior neighboring quadrants are gen

Get the state of a quadrant at position (x, y).

Check if the given quadrants have valid 2x2 context for generation. For a generation to succeed, there must exist at least one 2x2 block where

Convert a hex color string to an RGB tuple. Args: hex_color: Hex color string (e.g., "#4B697D" or "4B697D") Returns: Tuple of (R,

Run the full generation pipeline for selected quadrants. This is the main entry point for generation. It: 1. Validates the quadrant selection

Save render bytes for a quadrant at position (x, y). Creates the quadrant if it doesn't exist. Returns True if successful.

Convert to a tuple.

Create a generation plan for the strip. The algorithm varies based on the depth of the strip: - Depth 1: 2x1 quadrants with 1 gap, then fill g

Create a template image for infill generation. The template is a 2x2 quadrant (tile-sized) image where: - Selected quadrants are filled with r

Ensure the is_reference column exists in the quadrants table (migration).

Find the optimal placement for the infill region within the template. Args: allow_expansion: If True, automatically expand infill regi

Create a QueueItem from a database row.

Get the 4 quadrants of a 2x2 tile given its top-left corner.

Get a connection to the quadrants database.

Get all exterior neighboring points along an edge.

Check if a quadrant has the appropriate generation data. For dark mode models: checks dark_mode column For regular models: checks genera

Convert a PIL Image to PNG or WebP bytes.

Check if all exterior neighbors along an edge are generated.

Parse a list of quadrant coordinates. Supports formats: - "(0,0),(1,0),(0,1)" - "(0,0) (1,0) (0,1)" - "0,0 1,0 0,1" Args: quadrants

Render a URL to a PIL Image using Playwright. This is a convenience wrapper around render_url_to_bytes. Args: url: The URL to render

Start the web server and render worker thread.

Convert to dictionary for JSON serialization.

Update the global generation state.

Check if all quadrants in a block exist in the source.

Build the template image. Args: border_width: Width of the red border around the infill region allow_expansion: If True, automat

Calculate the new lat/lon center after shifting the view by shift_x_px and shift_y_px.

Calculate the 4 geographic corners of a quadrant. The isometric projection means the quadrant appears as a parallelogram in geographic space.

Check if a 2x2 tile starting at top_left can be generated. A 2x2 tile can be generated if: - All 4 quadrants are empty (not already generated)

Create a QuadrantGrid for common test scenarios. Scenarios: - "half_left": Left half generated, right half selected - "half_right": Right ha

Format seconds into a human-readable time string.

Get all empty (not generated) quadrant positions.

Get all pending items in the queue, ordered by creation time.

Get detailed validation information for debugging.

Load view configuration from JSON file.