@oidoid/void 0.1.0-4 → 0.1.0-7

package/tools/atlas-parser.js

@@ -1,120 +0,0 @@
-/** @typedef {import('./aseprite.js').Aseprite} Aseprite */
-/** @typedef {import('./aseprite.js').AsepriteAnimTagFrame} AsepriteAnimTagFrame */
-/** @typedef {import('./aseprite.js').AsepriteFrame} AsepriteFrame */
-/** @typedef {import('./aseprite.js').AsepriteFrameMap} AsepriteFrameMap */
-/** @typedef {import('./aseprite.js').AsepriteSlice} AsepriteSlice */
-/** @typedef {import('./aseprite.js').AsepriteTagSpan} AsepriteTagSpan */
-/** @typedef {import('../src/atlas/anim.js').Anim<AnimTag>} Anim */
-/** @typedef {import('../src/atlas/anim.js').AnimTag} AnimTag */
-/** @typedef {import('../src/atlas/atlas.js').Atlas} Atlas */
-/** @typedef {import('../src/types/2d.js').Box} Box */
-/** @typedef {import('../src/types/2d.js').WH} WH */
-/** @typedef {import('../src/types/2d.js').XY} XY */
-import {maxAnimCels} from '../src/atlas/anim.js'
-
-/**
- * @arg {Aseprite} ase
- * @return {Atlas}
- */
-export function parseAtlas(ase) {
-  const atlas = new Map()
-  for (const span of ase.meta.frameTags) {
-    const tag = parseTag(span.name)
-    if (atlas.has(tag)) throw Error(`duplicate tag "${tag}" in atlas`)
-    const id = atlas.size * maxAnimCels
-    atlas.set(tag, parseAnim(id, span, ase.frames, ase.meta.slices))
-  }
-
-  const extraSlices = ase.meta.slices.filter(
-    slice => !atlas.has(parseTag(slice.name))
-  )
-  if (extraSlices.length)
-    throw Error(
-      `unknown hitbox tags in atlas: ${extraSlices.map(slice => slice.name).join(', ')}`
-    )
-
-  return Object.fromEntries(atlas)
-}
-
-/**
- * @arg {number} id
- * @arg {AsepriteTagSpan} span
- * @arg {AsepriteFrameMap} map
- * @arg {readonly AsepriteSlice[]} slices
- * @return {Anim}
- * @internal
- */
-export function parseAnim(id, span, map, slices) {
-  const frames = [...parseAnimFrames(span, map)]
-  if (!frames[0]) throw Error('animation missing frames')
-  return {
-    id,
-    w: frames[0].sourceSize.w,
-    h: frames[0].sourceSize.h,
-    cels: frames.map(parseCel),
-    hitbox: parseHitbox(span, slices),
-    tag: parseTag(span.name)
-  }
-}
-
-/**
- * @arg {AsepriteTagSpan} span
- * @arg {AsepriteFrameMap} map
- * @return {IterableIterator<AsepriteFrame>}
- */
-function* parseAnimFrames(span, map) {
-  for (let i = span.from; i <= span.to && i - span.from < maxAnimCels; i++) {
-    const animTagFrame = /** @type {AsepriteAnimTagFrame} */ (
-      `${span.name}--${i}`
-    )
-    const frame = map[animTagFrame]
-    if (!frame) throw Error(`missing frame "${animTagFrame}"`)
-    yield frame
-  }
-}
-
-/**
- * @arg {AsepriteFrame} frame
- * @return {Readonly<XY>}
- * @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
-  }
-}
-
-/**
- * @arg {AsepriteTagSpan} span
- * @arg {readonly AsepriteSlice[]} slices
- * @return {Readonly<Box>}
- * @internal
- */
-export function parseHitbox(span, slices) {
-  const tagSlices = slices.filter(slice => slice.name === span.name)
-  if (tagSlices.length > 1) {
-    throw Error(`tag "${span.name}" has multiple hitboxes`)
-  }
-  const box = tagSlices[0]?.keys[0]?.bounds ?? {x: 0, y: 0, w: 0, h: 0}
-  // https://github.com/aseprite/aseprite/issues/3524
-  for (const key of tagSlices[0]?.keys ?? []) {
-    if (
-      key.bounds.x !== box.x ||
-      key.bounds.y !== box.y ||
-      key.bounds.w !== box.w ||
-      key.bounds.h !== box.h
-    )
-      throw Error(`tag "${span.name}" hitbox varies across frames`)
-  }
-  return box
-}
-
-/**
- * @arg {string} tag
- * @return {AnimTag}
- */
-function parseTag(tag) {
-  if (!tag.includes('--')) throw Error(`tag "${tag}" is malformed`)
-  return /** @type {AnimTag} */ (tag)
-}

package/tools/void.js

@@ -1,143 +0,0 @@
-#!/usr/bin/env -S node --no-warnings
-// Bundles sources into a single HTML file for distribution and development.
-//
-// void --html=file --out=dir [--watch] sprite...
-// --watch  Run development server. Serve on http://localhost:1234 and reload on
-//          code change.
-//
-// --no-warnings shebang works around JSON import warnings. See
-// https://github.com/nodejs/node/issues/27355 and
-// https://github.com/nodejs/node/issues/40940.
-
-import {execFile} from 'child_process'
-import esbuild from 'esbuild'
-import {JSDOM} from 'jsdom'
-import fs from 'node:fs/promises'
-import path from 'node:path'
-import pkg from '../package.json' assert {type: 'json'}
-import {parseAtlas} from './atlas-parser.js'
-
-const args = process.argv.filter(arg => !arg.startsWith('--'))
-const opts = Object.fromEntries(
-  process.argv.filter(arg => arg.startsWith('--')).map(arg => arg.split('='))
-)
-
-const watch = '--watch' in opts
-const inFilename = opts['--html']
-if (!inFilename) throw Error('missing input')
-const outDir = opts['--out']
-if (!outDir) throw Error('missing output')
-const doc = new JSDOM(await fs.readFile(inFilename, 'utf8')).window.document
-let srcFilename = /** @type {HTMLScriptElement|null} */ (
-  doc.querySelector('script[type="module"][src]')
-)?.src
-if (!srcFilename) throw Error('missing script source')
-srcFilename = `${path.dirname(inFilename)}/${srcFilename}`
-const sprites = args.splice(2)
-if (!sprites.length) throw Error('missing sprites')
-
-const atlasPNGFilename = `${await fs.mkdtemp('/tmp/', {encoding: 'utf8'})}/atlas.png`
-const [err, stdout, stderr] = await new Promise(resolve =>
-  execFile(
-    'aseprite',
-    [
-      '--batch',
-      '--color-mode=indexed',
-      '--filename-format={title}--{tag}--{frame}',
-      // '--ignore-empty', Breaks --tagname-format.
-      '--list-slices',
-      '--list-tags',
-      '--merge-duplicates',
-      `--sheet=${atlasPNGFilename}`,
-      '--sheet-pack',
-      '--tagname-format={title}--{tag}',
-      ...sprites
-    ],
-    (err, stdout, stderr) => resolve([err, stdout, stderr])
-  )
-)
-process.stderr.write(stderr)
-if (err) throw err
-
-const atlasJSON = JSON.stringify(parseAtlas(JSON.parse(stdout)))
-const atlasURI =
-  await `data:image/png;base64,${(await fs.readFile(atlasPNGFilename)).toString('base64')}`
-
-/** @type {Parameters<esbuild.PluginBuild['onEnd']>[0]} */
-async function pluginOnEnd(result) {
-  const copy = /** @type {Document} */ (doc.cloneNode(true))
-  const manifestEl = /** @type {HTMLLinkElement|null} */ (
-    copy.querySelector('link[href][rel="manifest"]')
-  )
-  if (manifestEl) {
-    const manifestFilename = `${path.dirname(inFilename)}/${manifestEl.href}`
-    const manifest = JSON.parse(await fs.readFile(manifestFilename, 'utf8'))
-    for (const icon of manifest.icons) {
-      if (!icon.src) throw Error('missing manifest icon src')
-      if (!icon.type) throw Error('missing manifest icon type')
-      const file = await fs.readFile(
-        `${path.dirname(manifestFilename)}/${icon.src}`
-      )
-      icon.src = `data:${icon.type};base64,${file.toString('base64')}`
-    }
-    if (watch) manifest.start_url = 'http://localhost:1234'
-    manifest.version = pkg.version
-    manifestEl.href = `data:application/json,${encodeURIComponent(
-      JSON.stringify(manifest)
-    )}`
-  }
-  const iconEl = /** @type {HTMLLinkElement|null} */ (
-    copy.querySelector('link[href][rel="icon"][type]')
-  )
-  if (iconEl) {
-    const file = await fs.readFile(`${path.dirname(inFilename)}/${iconEl.href}`)
-    iconEl.href = `data:${iconEl.type};base64,${file.toString('base64')}`
-  }
-
-  let js = ''
-  if (watch)
-    js +=
-      "new globalThis.EventSource('/esbuild').addEventListener('change', () => globalThis.location.reload());"
-
-  const outFiles =
-    result.outputFiles?.filter(file => file.path.endsWith('.js')) ?? []
-  if (outFiles.length > 1) throw Error('cannot concatenate JavaScript files')
-  if (outFiles[0]) js += outFiles[0].text
-
-  const scriptEl = /** @type {HTMLScriptElement|null} */ (
-    copy.querySelector('script[type="module"][src]')
-  )
-  if (!scriptEl) throw Error('missing script')
-  scriptEl.removeAttribute('src')
-  scriptEl.textContent = `
-  const atlasURI = '${atlasURI}'
-  const atlas = ${atlasJSON}
-  ${js}
-`
-  const outFilename = `${outDir}/${
-    watch ? 'index' : `${path.basename(inFilename, '.html')}-v${pkg.version}`
-  }.html`
-  await fs.mkdir(path.dirname(outFilename), {recursive: true})
-  await fs.writeFile(
-    outFilename,
-    `<!doctype html>${copy.documentElement.outerHTML}`
-  )
-}
-
-/** @type {esbuild.BuildOptions} */
-const buildOpts = {
-  bundle: true,
-  entryPoints: [srcFilename],
-  format: 'esm',
-  logLevel: `info`, // Print the port and build demarcations.
-  minify: !watch,
-  outdir: outDir,
-  plugins: [{name: 'void', setup: build => build.onEnd(pluginOnEnd)}],
-  sourcemap: 'linked',
-  target: 'es2022', // https://esbuild.github.io/content-types/#tsconfig-json
-  write: false // Written by plugin.
-}
-if (watch) {
-  const ctx = await esbuild.context(buildOpts)
-  await Promise.race([ctx.watch(), ctx.serve({port: 1234, servedir: 'dist'})])
-} else await esbuild.build(buildOpts)