# USA Data Tools

USA Data Tools is an AI-friendly, Playwright-friendly browser app for comparing EDI, JSON, XML, plain-text payloads, and byte-level file differences locally.

Use this tool when an agent needs to compare two payloads, inspect line-level differences, identify added or removed lines, use a hex viewer for byte-level file differences, or produce a browser-visible diff without uploading files to a remote service.

The app also includes a Delimited tool for converting CSV, pipe-delimited, tab-delimited, and semicolon-delimited text files in the browser.

It also includes an OpenAPI Test Generator for creating TypeScript API test helpers, smoke tests, negative tests, starter security tests, CSV test cases, env/config files, and setup guidance from OpenAPI, Swagger, or Postman Collection JSON.

## Compare URL API

Open the app to the compare tool:

https://usadatatools.com/#compare

Compare URL-encoded payload values:

https://usadatatools.com/#compare?leftValue=BASE%20TEXT&rightValue=TEST%20TEXT

Compare local path setup values:

https://usadatatools.com/#compare?left=C%3A%5Cqa%5Cbase.edi&right=C%3A%5Cqa%5Ctest.edi

Notes:

- `leftValue` and `rightValue` prefill payload text directly.
- `left` and `right` represent local file paths for the path-loading workflow.
- Browsers cannot read arbitrary local file paths on public websites without user action or a local helper/dev server.
- The app keeps payload processing in the browser.

## Payload limits

- Local file loading is limited to 2 MB per side.
- Pasted compare payloads are limited to 2 MB per side.
- `leftValue` and `rightValue` URL payloads are limited to 100 KB per side.
- Hex viewer output is rendered for the first 2,000 visible rows to protect browser performance.
- For larger payloads, prefer path setup parameters or user-assisted local file loading.

## Site information

- Privacy policy: `/#privacy`
- Terms and disclaimer: `/#terms`
- Contact: `/#contact`
- Authorized sellers file: `/ads.txt`
- Launch/status page: `/status.html`

## Tool pages

- EDI tool: `/tools/edi.html`
- JSON tool: `/tools/json.html`
- XML tool: `/tools/xml.html`
- Delimited tool: `/tools/delimited.html`
- Compare tool: `/tools/compare.html`
- OpenAPI Test Generator: `/tools/openapi-test-generator.html`
- Workflow Image Prompt Builder: `/tools/workflow-prompt-builder.html`
- Landscape & City Image Prompt Builder: `/tools/landscape-city-image-prompt-builder.html`
- Product Image Prompt Builder: `/tools/product-image-prompt-builder.html`
- Image Edit Prompt Builder: `/tools/image-edit-prompt-builder.html`
- Person / Character Prompt Builder: `/tools/person-character-prompt-builder.html`
- Interior Design / Room Decorating Prompt Builder: `/tools/interior-design-prompt-builder.html`

## OpenAPI Test Generator

Purpose:
Generate TypeScript API test scaffolding from OpenAPI, Swagger, or Postman Collection JSON in a browser-local workflow.

Crawler-friendly page:
`/tools/openapi-test-generator.html`

Live app route:
`/#api`

Feature list:
- OpenAPI test generator
- Swagger test generator
- Postman test generator
- TypeScript API test helpers
- API smoke tests
- API negative tests
- starter security tests
- CSV test cases
- env/config files
- setup guide

Relevant search phrases:
- OpenAPI test generator
- Swagger test generator
- Postman test generator
- TypeScript API test generator
- API smoke test generator
- API negative test generator

## Workflow Image Prompt Builder

Purpose:
Create ready-to-copy AI prompts for workflow graphics, process diagrams, themed flowcharts, and step-by-step visuals with browser-local controls for layout, steps, visuals, shapes, colors, and connectors.

Live app route:
`/#prompt-builder`

Feature list:
- workflow title
- number of steps
- layout
- theme
- step labels
- icons / visuals
- shapes
- outline colors
- connector style
- connector color
- connector thickness
- arrow direction

Relevant search phrases:
- workflow image prompt builder
- AI diagram prompt generator
- workflow prompt generator
- themed flowchart prompts
- AI workflow prompt builder
- copy-ready workflow graphic prompt

## Landscape & City Image Prompt Builder

Purpose:
Create copy-ready AI image prompts for landscapes, skylines, streets, nature scenes, city images, and custom environment pictures.

Live app route:
`/#landscape-city-image-prompt-builder`

Feature list:
- scene type
- main idea / subject
- location style
- time of day
- weather
- season
- mood
- art style
- camera view
- aspect ratio
- lighting
- people
- detail level
- extra details
- Generated Prompt output

Relevant search phrases:
- landscape image prompt builder
- city image prompt builder
- skyline prompt generator
- nature scene prompt generator
- AI environment prompt builder
- copy-ready AI image prompt
- generated prompt for AI image tools

## Product Image Prompt Builder

Purpose:
Create one complete copy-ready AI product image prompt for ecommerce product photos, Amazon listings, Etsy listings, Shopify hero images, ads, and social media posts.

Live app route:
`/#product-image-prompt-builder`

Feature list:
- product type
- product description / main idea
- shot type
- platform format
- background
- lighting
- camera angle
- composition / framing
- style
- use case
- brand mood
- brand colors
- props
- people / hands
- text / logo handling
- product preservation
- output intent
- aspect ratio
- single final product prompt output

Relevant search phrases:
- product image prompt builder
- ecommerce product photo prompt generator
- Amazon listing image prompt builder
- Etsy listing image prompt builder
- Shopify product hero prompt builder
- AI product photography prompt

## Image Edit Prompt Builder

Purpose:
Create one precise copy-ready AI image edit prompt that protects the main subject and only changes selected details.

Live app route:
`/#image-edit-prompt-builder`

Feature list:
- local image preview
- protected subject type
- protected subject details
- editable area
- editable area details
- requested edit
- preservation strength
- edit type
- preservation checklist
- avoid guidance
- single final image edit prompt output

Relevant search phrases:
- image edit prompt builder
- AI image edit prompt generator
- protect main subject prompt
- change only one part of an image
- vase edit prompt
- background replacement prompt

## Interior Design / Room Decorating Prompt Builder

Purpose:
Create a practical copy-ready decorating prompt for a room, apartment, studio, or home using the user's space, style, colors, budget, must-keep items, constraints, mood, and requested outputs.

Live app route:
`/#interior-design-prompt-builder`

Feature list:
- space type and room size
- optional exact dimensions
- current situation and design style
- colors to use and avoid
- budget level
- must-keep items
- practical needs
- mood / vibe
- requested output types
- step-by-step makeover plan

Relevant search phrases:
- interior design prompt builder
- room decorating prompt builder
- apartment decorating prompt
- furniture layout suggestions
- realistic makeover plan

## Learn pages

- EDI overview: `/learn/edi.html`
- JSON overview: `/learn/json.html`
- XML overview: `/learn/xml.html`
- Delimited file overview: `/learn/delimited.html`
- Payload comparison overview: `/learn/compare.html`

## Playwright selectors

Use stable test IDs:

- `popular-tool-compare`
- `popular-tool-json`
- `popular-tool-xml`
- `popular-tool-edi`
- `popular-tool-delimited`
- `tool-tab-compare`
- `tool-tab-json`
- `tool-tab-xml`
- `tool-tab-edi`
- `tool-tab-delimited`
- `delimited-input`
- `delimited-output`
- `delimited-input-delimiter`
- `delimited-custom-input-delimiter`
- `delimited-output-delimiter`
- `delimited-custom-output-delimiter`
- `delimited-show-column-numbers`
- `delimited-zero-based-columns`
- `compare-left-input`
- `compare-right-input`
- `compare-left-path-input`
- `compare-right-path-input`
- `compare-load-path-drafts`
- `compare-load-both`
- `compare-save-bat`
- `compare-copy-bat-text`
- `compare-summary-values`
- `compare-result-json`
- `compare-diff-row`
- `compare-json-diff`
- `compare-json-diff-row`
- `show-hex-view-checkbox`
- `only-diff-rows-checkbox`
- `bytes-per-row-select`
- `hex-compare-table`

## Reading results

Preferred machine-readable result:

```js
const result = JSON.parse(await page.locator("#compare-result-json").textContent());
```

The result includes:

- `summary.same`
- `summary.changed`
- `summary.added`
- `summary.removed`
- `summary.different`
- `summary.totalRows`
- `rows[].changeType`
- `rows[].leftLine`
- `rows[].rightLine`
- `rows[].left`
- `rows[].right`

Fast summary assertion:

```js
await expect(page.getByTestId("compare-summary-values")).toContainText("different");
```

Diff row attributes:

- `data-change-type`: `same`, `changed`, `added`, or `removed`
- `data-left-line`: left-side line number, blank when missing
- `data-right-line`: right-side line number, blank when missing

## Example Playwright flow

```js
await page.goto("/#compare?leftValue=ISA*00*&rightValue=ISA*01*");
const result = JSON.parse(await page.locator("#compare-result-json").textContent());
console.log(result.summary);
```

## Tool positioning

Relevant search phrases:

- browser local EDI compare tool
- compare EDI files locally
- AI-friendly payload comparison tool
- Playwright-friendly diff viewer
- browser-local hex viewer
- byte-level file compare
- integration QA payload compare
- browser-local JSON and XML compare