mirror of
https://github.com/Ku6epXBOCTuK/easy-png-tools.git
synced 2026-11-13 17:08:20 +00:00
chore: update verify tasks, add ci jobs
This commit is contained in:
@@ -1,22 +1,32 @@
|
||||
# easy-png-tools
|
||||
|
||||
Browser-based PNG utility toolkit — no server, no data upload, everything runs locally.
|
||||
Browser-based PNG utility toolkit — no server, no data upload, everything runs
|
||||
locally.
|
||||
|
||||
Inspired by online services like onlinepngtools.com, but fully offline-capable and open source.
|
||||
Inspired by online services like onlinepngtools.com, but fully offline-capable
|
||||
and open source.
|
||||
|
||||
## Features
|
||||
|
||||
- **Pixel-level image processing** — format conversion, transparency/alpha channel, color transformations, geometry, filters/convolutions, morphology, quantization & palettes, image generation, text/watermarks, analysis & checks
|
||||
- **Pipeline system (workspace)** — load image → chain multiple tool steps → sequential application → download result; pipelines saved to localStorage, exportable as JSON
|
||||
- **Web Worker execution** — heavy operations run off the main thread with automatic fallback to direct calls
|
||||
- **Pixel-level image processing** — format conversion, transparency/alpha
|
||||
channel, color transformations, geometry, filters/convolutions, morphology,
|
||||
quantization & palettes, image generation, text/watermarks, analysis & checks
|
||||
- **Pipeline system (workspace)** — load image → chain multiple tool steps →
|
||||
sequential application → download result; pipelines saved to localStorage,
|
||||
exportable as JSON
|
||||
- **Web Worker execution** — heavy operations run off the main thread with
|
||||
automatic fallback to direct calls
|
||||
- **i18n** — full Russian and English localization with search matching
|
||||
- **Dark/Light themes** — persisted to localStorage
|
||||
- **Pure TypeScript core** — `lib/core/` operates on `ImageData`/`Uint8ClampedArray` with no DOM dependency
|
||||
- **~30+ tools** across categories: transparency, color, geometry, filters, morphology, palettes, generation, text, analysis
|
||||
- **Pure TypeScript core** — `lib/core/` operates on
|
||||
`ImageData`/`Uint8ClampedArray` with no DOM dependency
|
||||
- **~30+ tools** across categories: transparency, color, geometry, filters,
|
||||
morphology, palettes, generation, text, analysis
|
||||
|
||||
## Tech Stack
|
||||
|
||||
- **SvelteKit** (Svelte 5, runes mode) with static adapter — pure static export, no server
|
||||
- **SvelteKit** (Svelte 5, runes mode) with static adapter — pure static export,
|
||||
no server
|
||||
- **Vite** + **TypeScript** (strict)
|
||||
- **Vitest** for unit tests
|
||||
- **ESLint** + **Prettier**
|
||||
@@ -46,14 +56,15 @@ Static output is written to `web/build/`.
|
||||
|
||||
### Other Commands
|
||||
|
||||
| Command | Description |
|
||||
| ------------------------ | ------------------------- |
|
||||
| `pnpm --dir web test` | Run unit tests (Vitest) |
|
||||
| `pnpm --dir web check` | Type-check (svelte-check) |
|
||||
| `pnpm --dir web lint` | Lint (ESLint) |
|
||||
| `pnpm --dir web format` | Format code (Prettier) |
|
||||
| `pnpm format:docs` | Format docs (Prettier) |
|
||||
| `pnpm --dir web preview` | Preview production build |
|
||||
| Command | Description |
|
||||
| ------------------------ | ------------------------------ |
|
||||
| `pnpm verify` | Run the full fast quality gate |
|
||||
| `pnpm --dir web test` | Run unit tests (Vitest) |
|
||||
| `pnpm --dir web check` | Type-check (svelte-check) |
|
||||
| `pnpm --dir web lint` | Lint (ESLint) |
|
||||
| `pnpm --dir web format` | Format code (Prettier) |
|
||||
| `pnpm format:docs` | Format docs (Prettier) |
|
||||
| `pnpm --dir web preview` | Preview production build |
|
||||
|
||||
## Project Structure
|
||||
|
||||
@@ -75,13 +86,18 @@ easy-png-tools/
|
||||
|
||||
## Architecture
|
||||
|
||||
The project is built around a **tool registry** (`registry.ts`) — each tool is a self-contained entry with `{id, title, description, category, params, run}`. Pages, forms, and pipelines are generated from this registry.
|
||||
The project is built around a **tool registry** (`registry.ts`) — each tool is a
|
||||
self-contained entry with `{id, title, description, category, params, run}`.
|
||||
Pages, forms, and pipelines are generated from this registry.
|
||||
|
||||
Core image processing lives in `lib/core/` and operates directly on `ImageData` objects with no browser API dependencies, making it portable to other environments (WASM, CLI) in the future.
|
||||
Core image processing lives in `lib/core/` and operates directly on `ImageData`
|
||||
objects with no browser API dependencies, making it portable to other
|
||||
environments (WASM, CLI) in the future.
|
||||
|
||||
## Roadmap
|
||||
|
||||
See [docs/roadmap.md](docs/roadmap.md) for the full development plan. Current phases:
|
||||
See [docs/roadmap.md](docs/roadmap.md) for the full development plan. Current
|
||||
phases:
|
||||
|
||||
1. **Phase 1** — TypeScript core + web UI (in progress)
|
||||
2. **Phase 2** — Rust/WASM core for performance-critical operations
|
||||
|
||||
Reference in New Issue
Block a user