@oidoid/void 0.1.0-4 → 0.1.0-7

package/dist/src/void.d.ts

@@ -0,0 +1,48 @@
+import { Zoo } from './ents/zoo.ts';
+import type { Atlas, AtlasJSON, TagFormat } from './graphics/atlas.ts';
+import { Cam } from './graphics/cam.ts';
+import { Renderer } from './graphics/renderer.ts';
+import { Sprite } from './graphics/sprite.ts';
+import { type DefaultButton, Input } from './input/input.ts';
+import { Looper } from './looper.ts';
+import { Pool, type PoolOpts } from './mem/pool.ts';
+import type { WH } from './types/geo.ts';
+import type { Millis } from './types/time.ts';
+export type VoidOpts<out Tag extends TagFormat> = {
+    preloadAtlas?: {
+        image: HTMLImageElement;
+        json: AtlasJSON;
+    } | undefined;
+    backgroundRGBA?: number;
+    canvas?: HTMLCanvasElement | undefined;
+    minWH?: WH | undefined;
+    input?: 'Custom' | 'Default' | undefined;
+    mode?: 'Int' | 'Fraction' | undefined;
+    poll?: {
+        delay?: (() => Millis) | undefined;
+        period: Millis;
+    } | undefined;
+    sprites?: Partial<Omit<PoolOpts<Sprite<Tag>>, 'alloc' | 'allocBytes'>> | undefined;
+};
+export declare class Void<out Tag extends TagFormat, Button extends string = DefaultButton> {
+    #private;
+    readonly cam: Cam;
+    readonly canvas: HTMLCanvasElement;
+    readonly input: Input<Button>;
+    readonly preload: Atlas;
+    readonly renderer: Renderer;
+    readonly sprites: Pool<Sprite<Tag>>;
+    readonly zoo: Zoo<Tag>;
+    readonly looper: Looper;
+    constructor(opts: Readonly<VoidOpts<Tag>>);
+    onAllocSprite(pool: Pool<Sprite<Tag>>): Sprite<Tag>;
+    onEvent(): void;
+    /** update input, update canvas, update cam, update world, then render. */
+    onFrame(millis: Millis): void;
+    onLoop(millis: Millis): void;
+    onPoll(): void;
+    onResize(): void;
+    register(op: 'add' | 'remove'): Promise<void>;
+    requestFrame(force?: 'Force' | undefined): void;
+    [Symbol.asyncDispose](): Promise<void>;
+}

package/dist/src/void.js

@@ -0,0 +1,102 @@
+import { Zoo } from "./ents/zoo.js";
+import { parseAtlas } from "./graphics/atlas-parser.js";
+import { Cam } from "./graphics/cam.js";
+import { Renderer } from "./graphics/renderer.js";
+import { drawableBytes, Sprite } from "./graphics/sprite.js";
+import { Input } from "./input/input.js";
+import { Looper } from "./looper.js";
+import { Pool } from "./mem/pool.js";
+import { initCanvas } from "./utils/canvas-util.js";
+import { DelayInterval } from "./utils/delay-interval.js";
+import { initBody, initMetaViewport } from "./utils/dom-util.js";
+import { loadImage } from "./utils/fetch-util.js";
+export class Void {
+    cam = new Cam();
+    canvas;
+    input;
+    preload;
+    renderer;
+    sprites;
+    zoo = new Zoo();
+    looper = new Looper();
+    #poll;
+    #preloadAtlasImage;
+    // may trigger an initial force update.
+    #resizeObserver = new ResizeObserver(() => this.onResize());
+    constructor(opts) {
+        if (opts.poll != null)
+            this.#poll = new DelayInterval(opts.poll.delay ?? (() => 0), opts.poll.period, () => this.onPoll());
+        initMetaViewport();
+        this.canvas = initCanvas(opts.canvas, opts.mode ?? 'Int');
+        initBody(this.canvas, opts.backgroundRGBA ?? 0x000000ff);
+        if (opts.minWH)
+            this.cam.minWH = opts.minWH;
+        this.cam.mode = opts.mode ?? 'Int';
+        this.cam.update(this.canvas);
+        this.input = new Input(this.cam, this.canvas);
+        if (opts.input !== 'Custom')
+            this.input.mapDefault();
+        this.input.onEvent = () => this.onEvent();
+        if (opts.preloadAtlas)
+            this.#preloadAtlasImage = opts.preloadAtlas.image;
+        this.preload = opts.preloadAtlas
+            ? parseAtlas(opts.preloadAtlas.json)
+            : { anim: {}, celXYWH: [], tags: [] };
+        this.renderer = new Renderer(this.preload ?? {}, this.canvas, this.looper);
+        this.sprites = new Pool({
+            alloc: pool => this.onAllocSprite(pool),
+            allocBytes: drawableBytes,
+            minPages: opts.sprites?.minPages ?? 3,
+            pageBlocks: opts.sprites?.pageBlocks ?? 1000
+        });
+        this.looper.onFrame = millis => this.onFrame(millis);
+    }
+    onAllocSprite(pool) {
+        return new Sprite(pool, 0, this.preload, this.looper);
+    }
+    onEvent() {
+        this.requestFrame('Force');
+    }
+    /** update input, update canvas, update cam, update world, then render. */
+    onFrame(millis) {
+        if (document.hidden)
+            return;
+        this.input.update(millis);
+        this.requestFrame(); // request frame before in case loop cancels.
+        this.onLoop(millis);
+        this.cam.postupdate();
+    }
+    // biome-ignore lint/correctness/noUnusedFunctionParameters:;
+    onLoop(millis) { }
+    onPoll() {
+        this.requestFrame('Force');
+    }
+    onResize() {
+        this.requestFrame('Force'); // force cam reeval.
+    }
+    async register(op) {
+        this.input.register(op);
+        this.renderer.register(op);
+        this.looper.register(op);
+        if (!this.canvas.parentElement)
+            throw Error('no canvas parent');
+        if (op === 'add')
+            this.#resizeObserver.observe(this.canvas.parentElement);
+        else
+            this.#resizeObserver.unobserve(this.canvas.parentElement);
+        if (op === 'add')
+            this.looper.requestFrame();
+        this.#poll?.register(op);
+        if (this.#preloadAtlasImage)
+            await loadImage(this.#preloadAtlasImage);
+        this.renderer.load(this.#preloadAtlasImage);
+    }
+    requestFrame(force) {
+        if (force || this.renderer.always || this.input.anyOn || this.input.gamepad)
+            this.looper.requestFrame();
+    }
+    async [Symbol.asyncDispose]() {
+        await this.register('remove');
+    }
+}
+//# sourceMappingURL=void.js.map

package/dist/src/void.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"void.js","sourceRoot":"","sources":["../../src/void.ts"],"names":[],"mappings":"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"}

package/dist/tools/atlas-pack/aseprite.d.ts

@@ -0,0 +1,58 @@
+import type { TagFormat } from '../../src/graphics/atlas.ts';
+import type { Box, WH } from '../../src/types/geo.ts';
+/** https://github.com/aseprite/aseprite/blob/master/docs/ase-file-specs.md */
+export type Aseprite = {
+    meta: AsepriteMeta;
+    frames: AsepriteFrameMap;
+};
+export type AsepriteFrameMap = {
+    [tag: AsepriteFrameTag]: AsepriteFrame;
+};
+export type AsepriteMeta = {
+    /** `--list-tags`. */
+    frameTags: AsepriteTagSpan[];
+    size: WH;
+    /** `--list-slices`. */
+    slices: AsepriteSlice[];
+};
+/** `--filename-format='{title}--{tag}--{frame}'`. */
+export type AsepriteFrameTag = `${TagFormat}--${bigint}`;
+export type AsepriteFrame = {
+    /** positive animation length in milliseconds. */
+    duration: number;
+    /** bounds including padding. */
+    frame: Box;
+    /** WH without padding. */
+    sourceSize: WH;
+};
+export type AsepriteTagSpan = {
+    direction: AsepriteDirection | string;
+    name: TagFormat | string;
+    from: number;
+    /** inclusive ending index, possibly equal to from. */
+    to: number;
+};
+export type AsepriteSlice = {
+    /** '#ff0000ff' is hitbox, '#00ff00ff' is hurtbox, '#0000ffff is both. */
+    color: string;
+    name: TagFormat | string;
+    keys: {
+        bounds: Box;
+    }[];
+};
+export type AsepriteDirection = (typeof AsepriteDirection)[keyof typeof AsepriteDirection];
+export declare const AsepriteDirection: {
+    /** animate from start to end; when looping, return to start. */
+    readonly Forward: "forward";
+    /** animate from end to start; when looping, return to end. */
+    readonly Reverse: "reverse";
+    /**
+     * animate from start to end - 1 or start, whichever is greater; when
+     * looping, change direction (initially, end to start + 1 or end, whichever
+     * is lesser. a traversal from start to end - 1 then end to start + 1 is
+     * considered a complete loop.
+     */
+    readonly PingPong: "pingpong";
+    /** like pingpong but start from end - 1 or start, whichever is greater. */
+    readonly PingPongReverse: "pingpong_reverse";
+};

package/dist/tools/atlas-pack/aseprite.js

@@ -0,0 +1,16 @@
+export const AsepriteDirection = {
+    /** animate from start to end; when looping, return to start. */
+    Forward: 'forward',
+    /** animate from end to start; when looping, return to end. */
+    Reverse: 'reverse',
+    /**
+     * animate from start to end - 1 or start, whichever is greater; when
+     * looping, change direction (initially, end to start + 1 or end, whichever
+     * is lesser. a traversal from start to end - 1 then end to start + 1 is
+     * considered a complete loop.
+     */
+    PingPong: 'pingpong',
+    /** like pingpong but start from end - 1 or start, whichever is greater. */
+    PingPongReverse: 'pingpong_reverse'
+};
+//# sourceMappingURL=aseprite.js.map

package/dist/tools/atlas-pack/aseprite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aseprite.js","sourceRoot":"","sources":["../../../tools/atlas-pack/aseprite.ts"],"names":[],"mappings":"AA6CA,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,gEAAgE;IAChE,OAAO,EAAE,SAAS;IAClB,8DAA8D;IAC9D,OAAO,EAAE,SAAS;IAClB;;;;;OAKG;IACH,QAAQ,EAAE,UAAU;IACpB,2EAA2E;IAC3E,eAAe,EAAE,kBAAkB;CAC3B,CAAA"}

package/dist/tools/atlas-pack/atlas-json-parser.d.ts

@@ -0,0 +1,21 @@
+import { type Anim, type AtlasJSON } from '../../src/graphics/atlas.ts';
+import { type Box, type XY } from '../../src/types/geo.ts';
+import { type Aseprite, type AsepriteFrame, type AsepriteFrameMap, type AsepriteSlice, type AsepriteTagSpan } from './aseprite.ts';
+export declare function parseAtlasJSON(ase: Readonly<Aseprite>): AtlasJSON;
+/** @internal */
+export declare function parseAnim(id: number, span: Readonly<AsepriteTagSpan>, map: Readonly<AsepriteFrameMap>, slices: readonly Readonly<AsepriteSlice>[]): Anim;
+/**
+ * every frame is guaranteed to be present for at least `celMillis`. cels are
+ * duplicated until cel duration is at least met. cels are unpacked until a full
+ * period is defined for the direction. no warns for overflowing past on second
+ * or uneven periods.
+ * @internal
+ */
+export declare function parseAnimFrames(span: AsepriteTagSpan, map: AsepriteFrameMap): AsepriteFrame[];
+/** @internal */
+export declare function parseCel(frame: Readonly<AsepriteFrame>): XY;
+/** @internal */
+export declare function parseHitboxes(span: Readonly<AsepriteTagSpan>, slices: readonly Readonly<AsepriteSlice>[]): {
+    hitbox: Box | undefined;
+    hurtbox: Box | undefined;
+};

package/dist/tools/atlas-pack/atlas-json-parser.js

@@ -0,0 +1,116 @@
+import { animCels, animMillis, celMillis } from "../../src/graphics/atlas.js";
+import { boxEq } from "../../src/types/geo.js";
+import { AsepriteDirection } from "./aseprite.js";
+export function parseAtlasJSON(ase) {
+    const anim = {};
+    const cels = [];
+    for (const span of ase.meta.frameTags) {
+        const tag = parseTag(span.name);
+        if (anim[tag])
+            throw Error(`atlas tag "${tag}" duplicate`);
+        const id = Object.keys(anim).length;
+        anim[tag] = parseAnim(id, span, ase.frames, ase.meta.slices);
+        for (const cel of parseAnimFrames(span, ase.frames).map(parseCel))
+            cels.push(cel.x, cel.y);
+    }
+    for (const slice of ase.meta.slices)
+        if (!anim[parseTag(slice.name)])
+            throw Error(`atlas hitbox "${slice.name}" has no animation`);
+    return { anim, celXY: cels };
+}
+/** @internal */
+export function parseAnim(id, span, map, slices) {
+    const cels = parseAnimFrames(span, map);
+    if (!cels[0])
+        throw Error(`no atlas frame "${span.name}"`);
+    const { hitbox, hurtbox } = parseHitboxes(span, slices);
+    return {
+        cels: cels.length,
+        h: cels[0].sourceSize.h,
+        hitbox,
+        hurtbox,
+        id,
+        w: cels[0].sourceSize.w
+    };
+}
+/**
+ * every frame is guaranteed to be present for at least `celMillis`. cels are
+ * duplicated until cel duration is at least met. cels are unpacked until a full
+ * period is defined for the direction. no warns for overflowing past on second
+ * or uneven periods.
+ * @internal
+ */
+export function parseAnimFrames(span, map) {
+    const cels = [];
+    let animDuration = 0;
+    const len = span.to - span.from + 1;
+    const peak = len - 1;
+    const cycle = Math.max(1, 2 * peak);
+    const end = span.direction === AsepriteDirection.Forward ||
+        span.direction === AsepriteDirection.Reverse
+        ? len
+        : cycle;
+    const indexByDir = {
+        forward: i => span.from + (i % len),
+        pingpong: i => span.from + peak - Math.abs((i % cycle) - peak),
+        pingpong_reverse: i => span.to - (peak - Math.abs((i % cycle) - peak)),
+        reverse: i => span.to - (i % len)
+    };
+    const frameIndex = indexByDir[span.direction];
+    for (let i = 0; i < end && cels.length < animCels && animDuration < animMillis; i++) {
+        const frameTag = `${span.name}--${frameIndex(i)}`;
+        const frame = map[frameTag];
+        if (!frame)
+            throw Error(`no atlas frame "${frameTag}"`);
+        for (let celDuration = 0; celDuration < frame.duration &&
+            cels.length < animCels &&
+            animDuration < animMillis; celDuration += celMillis, animDuration += celMillis) {
+            cels.push(frame);
+            if (span.from === span.to)
+                return cels; // optimize for long single cel.
+        }
+    }
+    return cels;
+}
+/** @internal */
+export function parseCel(frame) {
+    return {
+        x: frame.frame.x + (frame.frame.w - frame.sourceSize.w) / 2,
+        y: frame.frame.y + (frame.frame.h - frame.sourceSize.h) / 2
+    };
+}
+/** @internal */
+export function parseHitboxes(span, slices) {
+    let hitbox;
+    let hurtbox;
+    // https://github.com/aseprite/aseprite/issues/3524
+    for (const slice of slices) {
+        if (slice.name !== span.name)
+            continue;
+        if (!slice.keys[0])
+            continue;
+        for (const k of slice.keys)
+            if (!boxEq(k.bounds, slice.keys[0].bounds))
+                throw Error(`atlas tag "${span.name}" hitbox bounds varies across frames`);
+        const red = slice.color === '#ff0000ff';
+        const green = slice.color === '#00ff00ff';
+        const blue = slice.color === '#0000ffff'; // default Aseprite slice color.
+        if (!red && !green && !blue)
+            throw Error(`atlas tag "${span.name}" hitbox color ${slice.color} unsupported`);
+        if (hitbox && (red || blue))
+            throw Error(`atlas tag "${span.name}" has multiple hitboxes`);
+        if (hurtbox && (green || blue))
+            throw Error(`atlas tag "${span.name}" has multiple hurtboxes`);
+        if (red || blue)
+            hitbox = slice.keys[0].bounds;
+        if (green || blue)
+            hurtbox = slice.keys[0].bounds;
+    }
+    return { hitbox, hurtbox };
+}
+function parseTag(tag) {
+    if (!tag.includes('--'))
+        throw Error(`atlas tag "${tag}" not in <filestem>--<animation> format`);
+    return tag;
+}
+//# sourceMappingURL=atlas-json-parser.js.map

package/dist/tools/atlas-pack/atlas-json-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atlas-json-parser.js","sourceRoot":"","sources":["../../../tools/atlas-pack/atlas-json-parser.ts"],"names":[],"mappings":"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"}

package/dist/tools/atlas-pack/atlas-pack.d.ts

@@ -0,0 +1,2 @@
+import type { AtlasConfig } from '../../schema/config-file.ts';
+export declare function packAtlas(config: Readonly<AtlasConfig>): Promise<void>;

package/dist/tools/atlas-pack/atlas-pack.js

@@ -0,0 +1,22 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { exec } from "../utils/exec.js";
+import { globAll } from "../utils/file-util.js";
+import { parseAtlasJSON } from "./atlas-json-parser.js";
+// to-do: separate executable?
+export async function packAtlas(config) {
+    const filenames = await globAll(path.join(config.dir, '**.aseprite'));
+    if (!filenames.length)
+        return;
+    const webp = config.image.endsWith('.webp');
+    const sheet = webp ? config.image.replace('.webp', '.png') : config.image;
+    const json = await exec('aseprite', '--batch', '--color-mode=indexed', '--filename-format={title}--{tag}--{frame}', '--list-slices', '--list-tags', '--merge-duplicates', `--sheet=${sheet}`, '--sheet-pack', '--tagname-format={title}--{tag}', ...filenames);
+    if (webp)
+        await exec('cwebp', '-exact', '-lossless', '-mt', '-quiet', '-z', '9', sheet, '-o', config.image);
+    await fs.writeFile(config.json, JSON.stringify(parseAtlasJSON(JSON.parse(json))));
+    try {
+        await exec('biome', 'check', '--fix', config.json);
+    }
+    catch { }
+}
+//# sourceMappingURL=atlas-pack.js.map

package/dist/tools/atlas-pack/atlas-pack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atlas-pack.js","sourceRoot":"","sources":["../../../tools/atlas-pack/atlas-pack.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAA;AACjC,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,OAAO,EAAC,IAAI,EAAC,MAAM,kBAAkB,CAAA;AACrC,OAAO,EAAC,OAAO,EAAC,MAAM,uBAAuB,CAAA;AAC7C,OAAO,EAAC,cAAc,EAAC,MAAM,wBAAwB,CAAA;AAErD,8BAA8B;AAC9B,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,MAA6B;IAC3D,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,CAAA;IACrE,IAAI,CAAC,SAAS,CAAC,MAAM;QAAE,OAAM;IAE7B,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;IAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAA;IACzE,MAAM,IAAI,GAAG,MAAM,IAAI,CACrB,UAAU,EACV,SAAS,EACT,sBAAsB,EACtB,2CAA2C,EAC3C,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,WAAW,KAAK,EAAE,EAClB,cAAc,EACd,iCAAiC,EACjC,GAAG,SAAS,CACb,CAAA;IAED,IAAI,IAAI;QACN,MAAM,IAAI,CACR,OAAO,EACP,QAAQ,EACR,WAAW,EACX,KAAK,EACL,QAAQ,EACR,IAAI,EACJ,GAAG,EACH,KAAK,EACL,IAAI,EACJ,MAAM,CAAC,KAAK,CACb,CAAA;IAEH,MAAM,EAAE,CAAC,SAAS,CAChB,MAAM,CAAC,IAAI,EACX,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CACjD,CAAA;IAED,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;IACpD,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;AACZ,CAAC"}

package/dist/tools/bundle/bundle.d.ts

@@ -0,0 +1,3 @@
+import type { VoidVersion } from '../../src/types/void-version.ts';
+import type { Config } from '../types/config.ts';
+export declare function bundle(config: Readonly<Config>, srcFilenames: readonly string[], voidVersion: Readonly<VoidVersion>): Promise<void>;

package/dist/tools/bundle/bundle.js

@@ -0,0 +1,48 @@
+import fs from 'node:fs';
+import esbuild from 'esbuild';
+import * as V from "../../src/index.js";
+import { packAtlas } from "../atlas-pack/atlas-pack.js";
+import { HTMLPlugin } from "./html-plugin.js";
+export async function bundle(config, srcFilenames, voidVersion) {
+    const opts = {
+        banner: config.watch
+            ? {
+                js: "new EventSource('/esbuild').addEventListener('change', () => location.reload());"
+            }
+            : {},
+        bundle: true,
+        define: {
+            // define on globalThis to avoid ReferenceError in unit tests.
+            'globalThis.voidVersion': JSON.stringify(voidVersion)
+        },
+        entryPoints: [...srcFilenames],
+        format: 'esm',
+        logLevel: 'info', // print the port and build demarcations.
+        metafile: true,
+        minify: config.minify,
+        outdir: config.out.dir,
+        plugins: [HTMLPlugin(config)],
+        sourcemap: 'linked',
+        target: 'es2024' // https://esbuild.github.io/content-types/#tsconfig-json
+    };
+    if (config.preloadAtlas)
+        await packAtlas(config.preloadAtlas);
+    if (config.preloadAtlas && config.watch) {
+        fs.watch(config.preloadAtlas.dir, { recursive: true }, (ev, type) => onWatch(config.preloadAtlas, ev, type));
+        const ctx = await esbuild.context(opts);
+        await Promise.all([
+            ctx.watch(),
+            ctx.serve({ port: 1234, servedir: config.out.dir })
+        ]);
+    }
+    else {
+        const build = await esbuild.build(opts);
+        if (config.meta)
+            await fs.promises.writeFile(config.meta, JSON.stringify(build.metafile));
+    }
+}
+const onWatch = V.debounce(async (config, ev, file) => {
+    console.log(`asset ${file} ${ev}.`);
+    await packAtlas(config);
+}, 500);
+//# sourceMappingURL=bundle.js.map

package/dist/tools/bundle/bundle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.js","sourceRoot":"","sources":["../../../tools/bundle/bundle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,OAAO,MAAM,SAAS,CAAA;AAE7B,OAAO,KAAK,CAAC,MAAM,oBAAoB,CAAA;AAEvC,OAAO,EAAC,SAAS,EAAC,MAAM,6BAA6B,CAAA;AAErD,OAAO,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAA;AAE3C,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,MAAwB,EACxB,YAA+B,EAC/B,WAAkC;IAElC,MAAM,IAAI,GAAyB;QACjC,MAAM,EAAE,MAAM,CAAC,KAAK;YAClB,CAAC,CAAC;gBACE,EAAE,EAAE,kFAAkF;aACvF;YACH,CAAC,CAAC,EAAE;QACN,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE;YACN,8DAA8D;YAC9D,wBAAwB,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC;SACtD;QACD,WAAW,EAAE,CAAC,GAAG,YAAY,CAAC;QAC9B,MAAM,EAAE,KAAK;QACb,QAAQ,EAAE,MAAM,EAAE,yCAAyC;QAC3D,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG;QACtB,OAAO,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAC7B,SAAS,EAAE,QAAQ;QACnB,MAAM,EAAE,QAAQ,CAAC,yDAAyD;KAC3E,CAAA;IAED,IAAI,MAAM,CAAC,YAAY;QAAE,MAAM,SAAS,CAAC,MAAM,CAAC,YAAY,CAAC,CAAA;IAC7D,IAAI,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACxC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,EAAC,SAAS,EAAE,IAAI,EAAC,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAChE,OAAO,CAAC,MAAM,CAAC,YAAa,EAAE,EAAE,EAAE,IAAI,CAAC,CACxC,CAAA;QACD,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QACvC,MAAM,OAAO,CAAC,GAAG,CAAC;YAChB,GAAG,CAAC,KAAK,EAAE;YACX,GAAG,CAAC,KAAK,CAAC,EAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,EAAC,CAAC;SAClD,CAAC,CAAA;IACJ,CAAC;SAAM,CAAC;QACN,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QACvC,IAAI,MAAM,CAAC,IAAI;YACb,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAA;IAC5E,CAAC;AACH,CAAC;AAED,MAAM,OAAO,GAAG,CAAC,CAAC,QAAQ,CACxB,KAAK,EACH,MAA6B,EAC7B,EAAqB,EACrB,IAAmB,EACnB,EAAE;IACF,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,IAAI,EAAE,GAAG,CAAC,CAAA;IACnC,MAAM,SAAS,CAAC,MAAM,CAAC,CAAA;AACzB,CAAC,EACD,GAAe,CAChB,CAAA"}

package/dist/tools/bundle/html-plugin.d.ts

@@ -0,0 +1,3 @@
+import type esbuild from 'esbuild';
+import type { Config } from '../types/config.ts';
+export declare function HTMLPlugin(config: Readonly<Config>): esbuild.Plugin;

package/dist/tools/bundle/html-plugin.js

@@ -0,0 +1,90 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { minify } from 'html-minifier-next';
+import { exec } from "../utils/exec.js";
+import { parseHTML } from "../utils/html-parser.js";
+export function HTMLPlugin(config) {
+    return {
+        name: 'HTMLPlugin',
+        setup(build) {
+            build.onEnd(async (_result) => {
+                const doc = await parseHTML(config.entry);
+                const scripts = doc.querySelectorAll("script[type='module'][src$='.ts']");
+                for (const script of scripts) {
+                    // to-do: test.
+                    const filename = path.basename(script.getAttribute('src').replace(/\.ts$/, '.js'));
+                    if (config.oneFile) {
+                        script.removeAttribute('src');
+                        script.textContent = await fs.readFile(path.join(config.out.dir, filename), { encoding: 'utf8' });
+                    }
+                    else
+                        script.src = filename;
+                }
+                if (config.oneFile) {
+                    const imgs = doc.querySelectorAll('img[src]');
+                    for (const img of imgs) {
+                        const filename = img.getAttribute('src');
+                        const b64 = await fs.readFile(path.join(config.out.dir, filename), {
+                            encoding: 'base64'
+                        });
+                        const ext = filename.match(/\.([^.]+)$/)?.[1];
+                        if (!ext)
+                            throw Error('no asset extension');
+                        img.src = `data:image/${ext};base64,${b64}`;
+                    }
+                }
+                const manifestEl = doc.querySelector('link[href][rel="manifest"]');
+                if (manifestEl) {
+                    const manifestFilename = path.resolve(path.dirname(config.entry), manifestEl.getAttribute('href'));
+                    const manifest = JSON.parse(await fs.readFile(manifestFilename, 'utf8'));
+                    if (config.version)
+                        manifest.version = config.version;
+                    for (const icon of manifest.icons ?? []) {
+                        if (!icon.src || !icon.type)
+                            continue;
+                        const iconFilename = `${path.dirname(manifestFilename)}/${icon.src}`;
+                        const file = await fs.readFile(iconFilename);
+                        if (config.oneFile)
+                            icon.src = `data:${icon.type};base64,${file.toString('base64')}`;
+                        else
+                            icon.src = path.relative(config.out.dir, iconFilename);
+                    }
+                    if (config.watch)
+                        manifest.start_url = 'http://localhost:1234';
+                    if (config.oneFile)
+                        manifestEl.href = `data:application/json,${encodeURIComponent(JSON.stringify(manifest))}`;
+                    else
+                        await fs.writeFile(path.join(config.out.dir, path.basename(manifestFilename)), JSON.stringify(manifest));
+                }
+                if (config.oneFile) {
+                    const icons = doc.querySelectorAll('link[href][rel="icon"][type]');
+                    for (const icon of icons) {
+                        const filename = path.resolve(config.out.dir, icon.getAttribute('href'));
+                        const file = await fs.readFile(filename);
+                        icon.href = `data:${icon.type};base64,${file.toString('base64')}`;
+                    }
+                }
+                let html = `<!doctype html>\n${doc.documentElement.outerHTML}`;
+                if (config.minify)
+                    html = await minify(html, {
+                        caseSensitive: true,
+                        collapseBooleanAttributes: true,
+                        html5: true,
+                        minifyCSS: true,
+                        removeAttributeQuotes: true,
+                        removeComments: true,
+                        removeEmptyAttributes: true
+                    });
+                else
+                    try {
+                        html = await exec('biome', 'check', '--fix', `--stdin-file-path=${config.entry}`, { stdin: html });
+                    }
+                    catch { }
+                // to-do: test.
+                const outHTMLFilename = path.join(config.out.dir, config.out.filename);
+                await fs.writeFile(outHTMLFilename, html);
+            });
+        }
+    };
+}
+//# sourceMappingURL=html-plugin.js.map

package/dist/tools/bundle/html-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-plugin.js","sourceRoot":"","sources":["../../../tools/bundle/html-plugin.ts"],"names":[],"mappings":"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"}

package/dist/tools/tsconfig-base.json

@@ -0,0 +1,48 @@
+// TypeScript config defaults for each sub-project (src, test, etc).
+{
+    "$schema": "https://json.schemastore.org/tsconfig.json",
+    "compilerOptions": {
+        // enable incremental builds.
+        "composite": true,
+        // enable type-stripping.
+        "allowImportingTsExtensions": true,
+        // only allow type-strippable syntax.
+        "erasableSyntaxOnly": true,
+        // maximize type checking.
+        "allowUnreachableCode": false,
+        "allowUnusedLabels": false,
+        "exactOptionalPropertyTypes": true,
+        "forceConsistentCasingInFileNames": true,
+        "noImplicitOverride": true,
+        "noUncheckedIndexedAccess": true,
+        "noUncheckedSideEffectImports": true,
+        "noUnusedLocals": true,
+        "resolveJsonModule": true,
+        "strict": true,
+        // projects add types as needed.
+        "lib": ["ES2024", "ESNext.disposable"],
+        "types": [],
+        "isolatedDeclarations": true, // require explicit types.
+        // improve compatibility with compilers that aren't type system aware.
+        "isolatedModules": true,
+        "esModuleInterop": true, // use ESM.
+        // allow JSON type-checking and imports.
+        "module": "ESNext",
+        "moduleResolution": "Bundler",
+        "rewriteRelativeImportExtensions": true, // rewrite .ts imports to .js.
+        // all subprojects output to dist/ relative the project root.
+        "outDir": "../dist",
+        "rootDir": "..",
+        // assume library types are checked and compatible.
+        "skipLibCheck": true,
+        "skipDefaultLibCheck": true,
+        "sourceMap": true,
+        "target": "ES2024",
+        // don't transform type-only imports.
+        "verbatimModuleSyntax": true
+    },
+    // include all sources and JSON.
+    "include": ["${configDir}/", "${configDir}/**/*.json"],
+    // exclude colocated tests and test utils.
+    "exclude": ["${configDir}/**/*.test.*", "${configDir}/**/test/"]
+}