@fi4f/hg 0.0.0

package/dist/vector4.js

@@ -0,0 +1,81 @@
+import { ADD, SUB, MUL, DIV, MOD } from "./math.js";
+export const X = 0;
+export const Y = 1;
+export const Z = 2;
+export const W = 3;
+export const __get__ = {
+    x(a) { return a[X]; },
+    y(a) { return a[Y]; },
+    z(a) { return a[Z]; },
+    w(a) { return a[W]; },
+};
+export const __set__ = {
+    x(a, x) { return a[X] = x; },
+    y(a, y) { return a[Y] = y; },
+    z(a, z) { return a[Z] = z; },
+    w(a, w) { return a[W] = w; },
+};
+export function x(a, x) {
+    return x === undefined ? __get__.x(a) : __set__.x(a, x);
+}
+export function y(a, y) {
+    return y === undefined ? __get__.y(a) : __set__.y(a, y);
+}
+export function z(a, z) {
+    return z === undefined ? __get__.z(a) : __set__.z(a, z);
+}
+export function w(a, w) {
+    return w === undefined ? __get__.w(a) : __set__.w(a, w);
+}
+export const Vector4 = {
+    X, Y, Z, W,
+    __get__,
+    __set__,
+    x, y, z, w,
+    new(...a) {
+        if (a.length === 1)
+            return [a[X], a[X], a[X], a[X]];
+        else
+            return [a[X] ?? 0, a[Y] ?? 0, a[Z] ?? 0, a[W] ?? 0];
+    },
+    from(a) {
+        if (typeof a === "number")
+            return [a, a, a, a];
+        else
+            return [a[X] ?? 0, a[Y] ?? 0, a[Z] ?? 0, a[W] ?? 0];
+    },
+    el(op, a, b, out = Vector4.new()) {
+        const [xa, ya, za, wa] = Vector4.from(a);
+        const [xb, yb, zb, wb] = Vector4.from(b);
+        __set__.x(out, op(xa, xb));
+        __set__.y(out, op(ya, yb));
+        __set__.z(out, op(za, zb));
+        __set__.w(out, op(wa, wb));
+        return out;
+    },
+    add(a, b, out = Vector4.new()) {
+        return Vector4.el(ADD, a, b, out);
+    },
+    sub(a, b, out = Vector4.new()) {
+        return Vector4.el(SUB, a, b, out);
+    },
+    hmul(a, b, out = Vector4.new()) {
+        return Vector4.el(MUL, a, b, out);
+    },
+    hdiv(a, b, out = Vector4.new()) {
+        return Vector4.el(DIV, a, b, out);
+    },
+    hmod(a, b, out = Vector4.new()) {
+        return Vector4.el(MOD, a, b, out);
+    },
+    dot(a, b = a) {
+        const [xa, ya, za, wa] = Vector4.from(a);
+        const [xb, yb, zb, wb] = Vector4.from(b);
+        return xa * xb + ya * yb + za * zb + wa * wb;
+    },
+    toString(a) {
+        const [x, y, z, w] = Vector4.from(a);
+        return `vec4<${x}, ${y}, ${z}, ${w}>`;
+    }
+};
+//# sourceMappingURL=vector4.js.map

package/dist/vector4.js.map

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

package/dist/version.d.ts

@@ -0,0 +1,21 @@
+export type Version = {
+    readonly moniker: string;
+    readonly major: number;
+    readonly minor: number;
+    readonly patch: number;
+};
+export declare const Version: {
+    "new"(o?: {
+        moniker?: string;
+        major?: number;
+        minor?: number;
+        patch?: number;
+    }): {
+        moniker: string;
+        major: number;
+        minor: number;
+        patch: number;
+    };
+    toString(a: Version): string;
+};
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAI,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAI,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAI,MAAM,CAAC;CAC1B,CAAA;AAED,eAAO,MAAM,OAAO;cACT;QACP,OAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAQ,CAAC,EAAE,MAAM,CAAC;KACnB;;;;;;gBASW,OAAO;CAGpB,CAAA"}

package/dist/version.js

@@ -0,0 +1,14 @@
+export const Version = {
+    new(o) {
+        return {
+            moniker: o?.moniker ?? "hg",
+            major: o?.major ?? 0,
+            minor: o?.minor ?? 0,
+            patch: o?.patch ?? 0,
+        };
+    },
+    toString(a) {
+        return `${a.moniker} ${a.major}.${a.minor}.${a.patch}`;
+    }
+};
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,GAAG,CAAC,CAKH;QACC,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,OAAO,IAAI,IAAI;YAC3B,KAAK,EAAI,CAAC,EAAE,KAAK,IAAM,CAAC;YACxB,KAAK,EAAI,CAAC,EAAE,KAAK,IAAM,CAAC;YACxB,KAAK,EAAI,CAAC,EAAE,KAAK,IAAM,CAAC;SACP,CAAC;IACtB,CAAC;IAED,QAAQ,CAAC,CAAU;QACjB,OAAO,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;IACzD,CAAC;CACF,CAAA"}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@fi4f/hg",
+  "version": "0.0.0",
+  "description": "",
+  "homepage": "https://github.com/fi4f/hg#readme",
+  "bugs": {
+    "url": "https://github.com/fi4f/hg/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fi4f/hg.git"
+  },
+  "license": "ISC",
+  "author": "",
+  "type": "module",
+  "main" : "dist/hg.js",
+  "types": "dist/hg.d.ts",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "dev": "concurrently \"tsc --watch\" \"npx serve\"",
+    "build": "tsc"
+  },
+  "dependencies": {
+    "typescript": "^5.9.3"
+  },
+  "devDependencies": {
+    "concurrently": "^9.2.1"
+  }
+}

package/src/asset.ts

@@ -0,0 +1,249 @@
+export const IMAGE = "image" as const;
+export const AUDIO = "audio" as const;
+export const TEXT  = "text"  as const;
+export const BLOB  = "blob"  as const;
+export const JSON  = "json"  as const;
+
+export type IMAGE = typeof IMAGE;
+export type AUDIO = typeof AUDIO;
+export type TEXT  = typeof TEXT ;
+export type BLOB  = typeof BLOB ;
+export type JSON  = typeof JSON ;
+
+export type Kind = IMAGE | AUDIO | TEXT | BLOB | JSON;
+
+export type Asset<T extends Kind> = { kind: T, path: string, id ?: string | undefined }
+export namespace Asset {
+  export type Image = Asset<IMAGE>
+  export type Audio = Asset<AUDIO>
+  export type Text  = Asset<TEXT >
+  export type Blob  = Asset<BLOB >
+  export type Json  = Asset<JSON >
+}
+
+export type Cache = {
+  images: { [id: string]: HTMLImageElement }
+  audios: { [id: string]: HTMLAudioElement }
+  texts:  { [id: string]: string           }
+  blobs:  { [id: string]: globalThis.Blob  }
+  jsons:  { [id: string]: any              }
+}
+
+export function load(a: Asset<any>) {
+  switch (a.kind) {
+    case IMAGE: return loadImage(a);
+    case AUDIO: return loadAudio(a);
+    case TEXT:  return loadText (a);
+    case BLOB:  return loadBlob (a);
+    case JSON:  return loadJson (a);
+    default: throw `[Asset.load]: Unknown kind of asset '${a.kind}'`;
+  }
+}
+
+export function loadImage(a: Asset.Image) {
+  return new Promise<HTMLImageElement>((res, rej) => {
+    const image = new Image();
+    image.onload  = () => res(image);
+    image.onerror = () => rej(     );
+    image.src     = a.path;
+  })
+}
+
+export function loadAudio(a: Asset.Audio) {
+  return new Promise<HTMLAudioElement>((res, rej) => {
+    const audio = new Audio();
+    audio.onload  = () => res(audio);
+    audio.onerror = () => rej(     );
+    audio.src     = a.path;
+  })
+}
+
+export async function loadText(a: Asset.Text) {
+  return fetch(a.path).then(res => res.text())
+}
+
+export async function loadBlob(a: Asset.Blob) {
+  return fetch(a.path).then(res => res.blob())
+}
+
+export async function loadJson(a: Asset.Json) {
+  return fetch(a.path).then(res => res.json())
+}
+
+export const Asset = {
+  new<T extends Kind>(kind: T, path: string, id ?: string) {
+    return { kind, path, id } satisfies Asset<T>
+  },
+
+  Image(path: string, id ?: string) {
+    return Asset.new(IMAGE, path, id) satisfies Asset.Image
+  },
+
+  Audio(path: string, id ?: string) {
+    return Asset.new(AUDIO, path, id) satisfies Asset.Audio
+  },
+
+  Text(path: string, id ?: string) {
+    return Asset.new(TEXT, path, id) satisfies Asset.Text
+  },
+
+  Blob(path: string, id ?: string) {
+    return Asset.new(BLOB, path, id) satisfies Asset.Blob
+  },
+
+  Json(path: string, id ?: string) {
+    return Asset.new(JSON, path, id) satisfies Asset.Json
+  },
+}
+
+export const Cache = {
+  new() {
+    return {
+      images: {},
+      audios: {},
+      texts:  {},
+      blobs:  {},
+      jsons:  {},
+    } satisfies Cache
+  },
+
+  getImage(cache: Cache, id: string) {
+    if (!(id in cache.images))
+      throw `[Cache.getImage]: Image with id '${id}' does not exist`;
+    return cache.images[id];
+  },
+
+  getAudio(cache: Cache, id: string) {
+    if (!(id in cache.audios))
+      throw `[Cache.getAudio]: Audio with id '${id}' does not exist`;
+    return cache.audios[id];
+  },
+
+  getText(cache: Cache, id: string) {
+    if (!(id in cache.texts))
+      throw `[Cache.getText]: Text with id '${id}' does not exist`;
+    return cache.texts[id];
+  },
+
+  getBlob(cache: Cache, id: string) {
+    if (!(id in cache.blobs))
+      throw `[Cache.getBlob]: Blob with id '${id}' does not exist`;
+    return cache.blobs[id];
+  },
+
+  getJson(cache: Cache, id: string) {
+    if(!(id in cache.jsons))
+      throw `[Cache.getJson]: Json with id '${id}' does not exist`;
+    return cache.jsons[id];
+  },
+
+  putImage(cache: Cache, id: string, image: HTMLImageElement) {
+    if (id in cache.images)
+      console.warn(`[Cache.putImage]: Image with id '${id}' already exists`);
+    return cache.images[id] = image;
+  },
+
+  putAudio(cache: Cache, id: string, audio: HTMLAudioElement) {
+    if (id in cache.audios)
+      console.warn(`[Cache.putAudio]: Audio with id '${id}' already exists`);
+    return cache.audios[id] = audio;
+  },
+
+  putText(cache: Cache, id: string, text: string) {
+    if (id in cache.texts)
+      console.warn(`[Cache.putText]: Text with id '${id}' already exists`);
+    return cache.texts[id] = text;
+  },
+
+  putBlob(cache: Cache, id: string, blob: Blob) {
+    if (id in cache.blobs)
+      console.warn(`[Cache.putBlob]: Blob with id '${id}' already exists`);
+    return cache.blobs[id] = blob;
+  },
+
+  putJson(cache: Cache, id: string, json: any) {
+    if (id in cache.jsons)
+      console.warn(`[Cache.putJson]: Json with id '${id}' already exists`);
+    return cache.jsons[id] = json;
+  },
+
+  freeImage(cache: Cache, id: string) {
+    delete cache.images[id];
+  },
+
+  freeAudio(cache: Cache, id: string) {
+    delete cache.audios[id];
+  },
+
+  freeText(cache: Cache, id: string) {
+    delete cache.texts[id];
+  },
+
+  freeBlob(cache: Cache, id: string) {
+    delete cache.blobs[id];
+  },
+
+  freeJson(cache: Cache, id: string) {
+    delete cache.jsons[id];
+  },
+
+  freeAll(cache: Cache) {
+    cache.images = {};
+    cache.audios = {};
+    cache.texts  = {};
+    cache.blobs  = {};
+    cache.jsons  = {};
+  },
+
+  load(cache: Cache, a: Asset<any>) {
+    switch (a.kind) {
+      case IMAGE: return Cache.loadImage(cache, a);
+      case AUDIO: return Cache.loadAudio(cache, a);
+      case TEXT:  return Cache.loadText (cache, a);
+      case BLOB:  return Cache.loadBlob (cache, a);
+      case JSON:  return Cache.loadJson (cache, a);
+      default: throw `[Cache.load]: Unknown kind of asset '${a.kind}'`;
+    }
+  },
+
+  async loadImage(cache: Cache, a: Asset.Image) {
+    const id = a.id   ??   uniqueId(cache.images);
+    Cache.putImage(cache, id, await loadImage(a));
+    return id;
+  },
+
+  async loadAudio(cache: Cache, a: Asset.Audio) {
+    const id = a.id   ??   uniqueId(cache.audios);
+    Cache.putAudio(cache, id, await loadAudio(a));
+    return id;
+  },
+
+  async loadText(cache: Cache, a: Asset.Text) {
+    const id = a.id  ??  uniqueId(cache.texts );
+    Cache.putText(cache, id, await loadText(a));
+    return id;
+  },
+
+  async loadBlob(cache: Cache, a: Asset.Blob) {
+    const id = a.id  ??  uniqueId(cache.blobs );
+    Cache.putBlob(cache, id, await loadBlob(a));
+    return id;
+  },
+
+  async loadJson(cache: Cache, a: Asset.Json) {
+    const id = a.id  ??  uniqueId(cache.jsons );
+    Cache.putJson(cache, id, await loadJson(a));
+    return id;
+  },
+
+  async loadAll(cache: Cache, a: Array<Asset<any>>) {
+    return Promise.all(a.map(a => Cache.load(cache, a)));
+  }
+}
+
+function uniqueId(ids: {[id: string]: any}) {
+  let id = crypto.randomUUID();
+  while (id in ids)
+      id = crypto.randomUUID();
+  return id;
+}

package/src/event.ts

@@ -0,0 +1,174 @@
+import type { Maybe } from "./types.js"
+
+export namespace Event {
+  export type Listener<T> = (event: T, context: Event.Context<T>) => void
+
+  export type Listen   = { action: "listen"  , path: string, type  : string            , listener  : Listener<any>             }
+  export type Deafen   = { action: "deafen"  , path: string, type ?: string | undefined, listener ?: Listener<any> | undefined }
+  export type Dispatch = { action: "dispatch", path: string, type: string, event: any }
+
+  export type Action = Listen | Deafen | Dispatch
+
+  export type Tree = {
+    root   :       Event.Node   
+    pending: Array<Event.Action>
+  }
+
+  export type Node = {
+    children : Map<string,     Event.Node          >
+    listeners: Map<string, Set<Event.Listener<any>>>
+  }
+
+  export type Context<T> = {
+    tree: Event.Tree
+    node: Event.Node
+    path: string
+    type: string
+    self: Event.Listener<T>
+  }
+}
+
+export const Event = {
+  Tree: {
+    new() {
+      return {
+        root   : Event.Node.new(),
+        pending: [ ]
+      } satisfies Event.Tree
+    }
+  },
+
+  Node: {
+    new() {
+      return {
+        children : new Map(),
+        listeners: new Map()
+      } satisfies Event.Node
+    }
+  },
+
+  once<T>(listener: Event.Listener<T>) {
+    return ((event: T, context: Event.Context<T>) => {
+      listener(event, context)
+      const { tree, path, type, self } = context
+      Event.deafen(tree, type, self, { path, defer: false })
+    }) satisfies Event.Listener<T>
+  },
+
+  listen<T>(tree: Event.Tree, type  : string, listener  : Event.Listener<T>, o ?: { path ?: string, defer ?: boolean }) {
+    const a: Event.Listen = { action: "listen", path: o?.path ?? "", type, listener }
+    if (o?.defer ?? true) queue(tree, a)
+    else                  flush(tree, a)
+  },
+
+  deafen<T>(tree: Event.Tree, type ?: string, listener ?: Event.Listener<T>, o ?: { path ?: string, defer ?: boolean }) {
+    const a: Event.Deafen = { action: "deafen", path: o?.path ?? "", type, listener }
+    if (o?.defer ?? true) queue(tree, a)
+    else                  flush(tree, a)
+  },
+
+  dispatch(tree: Event.Tree, type: string, event: any, o ?: { path ?: string, defer ?: boolean }) {
+    const a: Event.Dispatch = { action: "dispatch", path: o?.path ?? "", type, event }
+    if (o?.defer ?? true) queue(tree, a)
+    else                  flush(tree, a)
+  },
+
+  poll(tree: Event.Tree) {
+    tree.pending.splice(0).forEach(
+      a => flush(tree, a)
+    )
+  }
+}
+
+function queue(tree: Event.Tree, a: Event.Action) {
+  tree.pending.push(a)
+}
+
+function flush(tree: Event.Tree, a: Event.Action) {
+  switch(a.action) {
+    case "listen"  : return onListen  (tree, a)
+    case "deafen"  : return onDeafen  (tree, a)
+    case "dispatch": return onDispatch(tree, a)
+  }
+}
+
+function requestListeners(node: Maybe<Event.Node>, type: string) {
+  let list = node?.listeners.get(type)
+  // if (!list) node.listeners.set(
+  //   type, list = new Set()
+  // )
+  return list
+}
+
+function requireListeners(node:       Event.Node , type: string) {
+  let list = node.listeners.get(type)
+  if (!list) node.listeners.set(
+    type, list = new Set()
+  )
+  return list
+}
+
+function requestNode(root: Maybe<Event.Node>, path: string) {
+  for (const part of path.split("/")) {
+    let node = root?.children.get(part)
+    if (!node) return
+    root = node
+  }
+
+  return root
+}
+
+function requireNode(root:       Event.Node , path: string) {
+  for (const part of path.split("/")) {
+    let node = root.children.get(part)
+    if (!node) root.children.set(
+      part, node = Event.Node.new()
+    )
+    root = node
+  }
+
+  return root
+}
+
+function onListen  (tree: Event.Tree, a: Event.Listen  ) {
+  const node = requireNode(tree.root, a.path)
+  const list = requireListeners(node, a.type)
+  list.add(a.listener)
+}
+
+function onDeafen  (tree: Event.Tree, a: Event.Deafen  ) {
+         if (a.type !== undefined && a.listener !== undefined) {
+    const node = requestNode(tree.root, a.path)
+    const list = requestListeners(node, a.type)
+    list?.delete(a.listener)
+  } else if (a.type !== undefined && a.listener === undefined) {
+    const node = requestNode(tree.root, a.path)
+    const list = requestListeners(node, a.type)
+    list?.clear()
+  } else if (a.type === undefined && a.listener !== undefined) {
+    const node = requestNode(tree.root, a.path)
+    node?.listeners.forEach((list) => {
+      list.delete(a.listener!)
+    })
+  } else if (a.type === undefined && a.listener === undefined) {
+    const node = requestNode(tree.root, a.path)
+    node?.children .clear()
+    node?.listeners.clear()
+  }
+}
+
+function onDispatch(tree: Event.Tree, { path, type, event }: Event.Dispatch) {
+  const node = requestNode(tree.root, path)
+  if (!node) return
+  reDispatch(tree, node, path, type, event)
+}
+
+function reDispatch(tree: Event.Tree, node: Event.Node, path: string, type: string, event: any) {
+  requestListeners(node, type)?.forEach(self => {
+    self(event, { tree, node, path, type, self })
+  })
+
+  node.children.forEach((child, name) => {
+    reDispatch(tree, child, `${path}/${name}`, type, event)
+  })
+}

package/src/hg.ts

@@ -0,0 +1,21 @@
+import { Version } from "./version.js";
+
+export const VERSION = Version.new({
+  moniker: "hg",
+  major  : 0,
+  minor  : 0,
+  patch  : 1,
+})
+
+export { Version } from "./version.js"
+export { Vector2 } from "./vector2.js"
+export { Vector3 } from "./vector3.js"
+export { Vector4 } from "./vector4.js"
+export { Matrix2 } from "./matrix2.js"
+export { Matrix3 } from "./matrix3.js"
+export { Matrix4 } from "./matrix4.js"
+export { Stage   } from "./stage.js"
+export { Scene   } from "./scene.js"
+export { Event   } from "./event.js"
+
+export { Asset, Cache } from "./asset.js"

package/src/math.ts

@@ -0,0 +1,5 @@
+export function ADD(a: number, b: number) { return a + b }
+export function SUB(a: number, b: number) { return a - b }
+export function MUL(a: number, b: number) { return a * b }
+export function DIV(a: number, b: number) { return a / b }
+export function MOD(a: number, b: number) { return a % b }