network-tools/docs/ARCHITECTURE.md

Architecture

Network Tools is a static React/Vite application wrapped in the shared Toolbox shell. Workbench.tsx owns only transient view state and delegates to small pure modules:

• network/url.ts resolves and decomposes URLs with the platform URL parser and returns a password-redacted display value.
• network/vlsm.ts parses bounded name,hosts requirements, sorts largest-first and allocates aligned IPv4 blocks atomically inside one parsed base CIDR.
• network/dns.ts constructs one bounded zone-file record and inertly parses complete pasted zone text. The zone parser joins bounded parenthesized records, honours local $ORIGIN/$TTL, validates common RDATA and retains unsupported record types as clearly marked syntax-only data. It rejects rather than follows external/generative directives such as $INCLUDE.
• network/http.ts parses a pasted header block, analyses a deployed CSP plus baseline response-header protections, and constructs an explicit CSP from source tokens.
• network/mime.ts is a project-authored offline reference table.

All operations are short, bounded and synchronous, so the app does not create a worker. VLSM is capped at 1,024 requirements; zone text at 2 MiB/50,000 physical lines/20,000 records; headers at 256 KiB/2,048 fields and CSP at 128 KiB. There is no server API, persistence layer or runtime lookup. Relative entry and asset URLs keep the production build relocatable below a nested portal path.