adminandClaude Opus 5
66d6aafbb4
Textures are uploaded files named by their content, so they cannot be edited in place. Pixel art is therefore its own asset type, like vector art. Its pixels live in the project and the tab rasters them into a texture that sprites, tiles and animations can use. - New asset types Pixel art and Palette. The first pixel art of a project gets a palette with the 16 PICO-8 colours in the same undo step. Every pixel is a palette index, 0 is transparent. - Each layer on each frame is its own file data/pixels/<sha256>.px. The project only holds the names, so undo swaps names. The browser computes the hash and uploads new cels before the project is saved. - New route POST ?r=pixels in api/lib/PixelStore.php. It answers 201 and 422 for broken data. data/pixels/ is git-ignored. - Tools: pencil, eraser, fill (contiguous or all pixels of a colour), eyedropper, line, rectangle and ellipse (outline or filled), brush size 1 to 8. - Layers can be added, deleted, renamed, reordered, hidden, faded and merged down. Frames can be added, duplicated, deleted and reordered, with onion skin and a small playing preview. - Zoom 1x to 32x in whole steps, grid from 8x, a 3x3 tile preview and Resize... with a 3x3 anchor. - All frames sit side by side in one image. Each frame is a region like a cut texture frame, so texture rows offer "Asset / Frame 2" and the context menu has Create animation from frames. Decisions: - Merging down drops the opacity of the upper layer. Indexed colours know no blends. - Only the last palette colour can be removed. Otherwise the indices of every image using the palette would shift. - Undo stores the whole layer per stroke instead of pixel diffs. - Alt+click picks a colour. It is a mouse gesture, not a shortcut. Follow-up issues: #197 import from texture, #198 selection and flipping, #199 PNG export, #200 more tools. Tests: - ./check.sh: 136 files, 2049 tests (before 135 / 2011). 34 new in tests/core/pixel-art.test.ts, 4 from the icon tables. - e2e module 48 fresh: ALL PASSED, 29 checks, console empty. - Counter-probes bite: five on the unit tests, upload order (2 tests fail) and cels not uploaded in the browser (1 check fails). - Check total 1259 in README is computed (1232 measured in CI + 27). Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
63 lines
2.0 KiB
TypeScript
63 lines
2.0 KiB
TypeScript
/**
|
||
* Uploaded files the view draws with, keyed by file name. Nothing is evicted: file names are
|
||
* content addressed, so a loaded file can never go stale. A miss is not an error – the subclass
|
||
* starts the load and reports "not yet", and `onChange` fires when the file lands.
|
||
*/
|
||
export abstract class FileLibrary<T> {
|
||
private base: string;
|
||
private readonly loading = new Set<string>();
|
||
/** Never retried, so one broken reference cannot spam the network. */
|
||
private readonly failed = new Set<string>();
|
||
private readonly listeners = new Set<() => void>();
|
||
|
||
constructor(
|
||
base: string,
|
||
private readonly tag: string,
|
||
) {
|
||
this.base = base;
|
||
}
|
||
|
||
/** Where the files are served from. Set once at start-up, before anything draws. */
|
||
configure(base: string): void {
|
||
this.base = base.replace(/\/+$/, '');
|
||
}
|
||
|
||
/** Runs `fn` whenever a file has arrived; returns the unsubscribe. */
|
||
onChange(fn: () => void): () => void {
|
||
this.listeners.add(fn);
|
||
return () => this.listeners.delete(fn);
|
||
}
|
||
|
||
/** Runs the listeners: something they draw from has changed without a file arriving here. */
|
||
notifyChange(): void {
|
||
for (const listener of this.listeners) listener();
|
||
}
|
||
|
||
protected abstract fetchFile(url: string, file: string): Promise<T>;
|
||
|
||
/** Keeps what arrived; the listeners run right after. */
|
||
protected abstract keep(file: string, loaded: T): void;
|
||
|
||
/** A file that could not be loaded; it is not asked for again. */
|
||
protected hasFailed(file: string): boolean {
|
||
return this.failed.has(file);
|
||
}
|
||
|
||
protected startLoading(file: string): void {
|
||
if (this.loading.has(file) || this.failed.has(file)) return;
|
||
this.loading.add(file);
|
||
void this.fetchFile(`${this.base}/${file}`, file).then(
|
||
(loaded) => {
|
||
this.loading.delete(file);
|
||
this.keep(file, loaded);
|
||
this.notifyChange();
|
||
},
|
||
(error: unknown) => {
|
||
this.loading.delete(file);
|
||
this.failed.add(file);
|
||
console.error(`[${this.tag}] cannot load ${file}`, error);
|
||
},
|
||
);
|
||
}
|
||
}
|