1681-engine 0.0.0-stage → 0.5.9

package/dist/ui/rich/richLayout.js

@@ -0,0 +1,132 @@
+function W(l, n, o = {}) {
+  const t = O(l, n, o), e = o.wrapWidth, i = [];
+  let s = [], h = 0, y = [], g = !1, x = l[0]?.style ?? { bold: !1, italic: !1 };
+  const w = () => {
+    i.push({ atoms: s, empty: x }), s = [], h = 0, y = [];
+  };
+  for (let c = 0; c < t.length; ) {
+    const f = t[c];
+    if (f.t === "br") {
+      x = f.style, w(), g = !1, c++;
+      continue;
+    }
+    if (f.t === "space") {
+      y.push(f), c++;
+      continue;
+    }
+    const r = [];
+    for (; c < t.length && (t[c].t === "word" || t[c].t === "icon"); ) r.push(t[c++]);
+    const d = b(r);
+    s.length === 0 && g && (y = []), e !== void 0 && s.length > 0 && h + b(y) + d > e + 1e-6 && (w(), g = !0);
+    for (const u of y) s.push(u);
+    if (h += b(y), y = [], e !== void 0 && h + d > e + 1e-6)
+      for (const u of r)
+        for (const p of L(u, n, e, () => h)) {
+          if (p === "break") {
+            w(), g = !0;
+            continue;
+          }
+          s.push(p), h += p.w;
+        }
+    else {
+      for (const u of r) s.push(u);
+      h += d;
+    }
+  }
+  return (s.length > 0 || i.length === 0 || t[t.length - 1]?.t === "br") && w(), N(i, n, o);
+}
+function O(l, n, o) {
+  const t = [];
+  for (const e of l) {
+    if (e.kind === "icon") {
+      const i = n.iconSize(e.key, e.frame), s = I(i.height, n.lineHeight(e.style), o), h = { t: "icon", key: e.key, style: e.style, w: i.width * s, h: i.height * s };
+      e.frame !== void 0 && (h.frame = e.frame), t.push(h);
+      continue;
+    }
+    for (const i of e.text.matchAll(/(\r?\n)|([ \t]+)|([^ \t\r\n]+)/g))
+      i[1] ? t.push({ t: "br", style: e.style }) : i[2] ? t.push({ t: "space", text: i[2], style: e.style, w: n.textWidth(i[2], e.style) }) : t.push({ t: "word", text: i[3], style: e.style, w: n.textWidth(i[3], e.style) });
+  }
+  return t;
+}
+function I(l, n, o) {
+  if (typeof o.iconScale == "number") return o.iconScale;
+  if (l <= 0) return 1;
+  const t = n / l;
+  return o.pixelPerfect ? Math.max(1, Math.floor(t)) : t;
+}
+function* L(l, n, o, t) {
+  if (l.t !== "word") {
+    t() > 0 && t() + l.w > o + 1e-6 && (yield "break"), yield l;
+    return;
+  }
+  const e = Array.from(l.text);
+  let i = 0;
+  for (; i < e.length; ) {
+    let s = i, h = 0;
+    for (; s < e.length; ) {
+      const y = n.textWidth(e.slice(i, s + 1).join(""), l.style);
+      if (t() + y > o + 1e-6 && !(s === i && t() === 0)) break;
+      h = y, s++;
+    }
+    if (s === i) {
+      yield "break";
+      continue;
+    }
+    yield { t: "word", text: e.slice(i, s).join(""), style: l.style, w: h }, i = s, i < e.length && (yield "break");
+  }
+}
+function N(l, n, o) {
+  const t = o.pixelPerfect ? Math.round : (c) => c, e = o.lineSpacing ?? 0, i = (c, f) => n.ascent?.(c) ?? f * 0.8, s = [];
+  let h = 0;
+  for (const c of l) {
+    for (; c.atoms.length > 0 && c.atoms[c.atoms.length - 1].t === "space"; ) c.atoms.pop();
+    const f = v(c.atoms, n);
+    let r = 0, d = 0;
+    const u = [];
+    if (f.length === 0) {
+      const a = n.lineHeight(c.empty);
+      r = -i(c.empty, a), d = r + a;
+    }
+    f.forEach((a, m) => {
+      const E = n.lineHeight(a.style), M = i(a.style, E), k = a.kind === "text" ? -M : -M + (E - a.height) / 2;
+      u[m] = k, (m === 0 || k < r) && (r = k), (m === 0 || k + a.height > d) && (d = k + a.height);
+    });
+    const p = t(-r), P = o.pixelPerfect ? Math.ceil(d - r) : d - r;
+    let S = 0;
+    f.forEach((a, m) => {
+      a.x = S, a.y = h + t(p + u[m]), S += a.width;
+    }), s.push({ y: h, width: S, height: P, baseline: p, items: f }), h += P + e;
+  }
+  const y = s.length === 0 ? 0 : h - e, g = s.reduce((c, f) => Math.max(c, f.width), 0), x = o.wrapWidth ?? g, w = o.align === "center" ? 0.5 : o.align === "right" ? 1 : 0;
+  for (const c of s) {
+    const f = (x - c.width) * w;
+    for (const r of c.items) r.x = t(r.x + f);
+  }
+  return { width: o.pixelPerfect ? Math.ceil(x) : x, height: y, lines: s };
+}
+function v(l, n) {
+  const o = [];
+  for (const t of l) {
+    if (t.t === "icon") {
+      const i = { kind: "icon", key: t.key, style: t.style, x: 0, y: 0, width: t.w, height: t.h };
+      t.frame !== void 0 && (i.frame = t.frame), o.push(i);
+      continue;
+    }
+    const e = o[o.length - 1];
+    e && e.kind === "text" && z(e.style, t.style) ? e.text += t.text : o.push({ kind: "text", text: t.text, style: t.style, x: 0, y: 0, width: 0, height: n.lineHeight(t.style) });
+  }
+  for (const t of o) t.kind === "text" && (t.width = n.textWidth(t.text, t.style));
+  return o;
+}
+function z(l, n) {
+  return l === n || l.color === n.color && l.bold === n.bold && l.italic === n.italic && l.size === n.size;
+}
+function b(l) {
+  let n = 0;
+  for (const o of l) n += o.w;
+  return n;
+}
+export {
+  W as layoutRichText,
+  z as sameStyle
+};

package/dist/ui/rich/richMarkup.js

@@ -0,0 +1,67 @@
+const f = Object.freeze({ bold: !1, italic: !1 }), d = /^#(?:[0-9a-f]{3}|[0-9a-f]{6})$/i, h = /^\d+(?:\.\d+)?$/;
+function m(s) {
+  return s.replace(/\[/g, "[[");
+}
+function x(s, c = {}) {
+  const n = [], r = [], u = () => r[r.length - 1]?.style ?? f, o = (l) => {
+    if (!l) return;
+    const i = u(), a = n[n.length - 1];
+    a && a.kind === "text" && a.style === i ? a.text += l : n.push({ kind: "text", text: l, style: i });
+  };
+  let e = 0, t = 0;
+  for (; e < s.length; ) {
+    if (s[e] !== "[") {
+      e++;
+      continue;
+    }
+    if (o(s.slice(t, e)), s[e + 1] === "[") {
+      o("["), e += 2, t = e;
+      continue;
+    }
+    const l = s.indexOf("]", e + 1), i = l < 0 ? null : s.slice(e + 1, l);
+    if (i === null || i.includes("[") || !y(i, r, u(), n, c)) {
+      o("["), e += 1, t = e;
+      continue;
+    }
+    e = l + 1, t = e;
+  }
+  return o(s.slice(t)), n;
+}
+function p(s, c = {}) {
+  let n = "";
+  for (const r of x(s, c)) r.kind === "text" && (n += r.text);
+  return n;
+}
+function y(s, c, n, r, u) {
+  if (s.startsWith("/")) {
+    const l = s.slice(1).trim().toLowerCase();
+    for (let i = c.length - 1; i >= 0; i--)
+      if (c[i].name === l)
+        return c.length = i, !0;
+    return !1;
+  }
+  const o = s.indexOf("="), e = (o < 0 ? s : s.slice(0, o)).trim().toLowerCase(), t = o < 0 ? null : s.slice(o + 1).trim();
+  switch (e) {
+    case "b":
+    case "i":
+      return t !== null ? !1 : (c.push({ name: e, style: { ...n, [e === "b" ? "bold" : "italic"]: !0 } }), !0);
+    case "color": {
+      const l = t === null ? void 0 : d.test(t) ? t : u.colors?.[t];
+      return l ? (c.push({ name: e, style: { ...n, color: l } }), !0) : !1;
+    }
+    case "size":
+      return t === null || !h.test(t) || Number(t) <= 0 ? !1 : (c.push({ name: e, style: { ...n, size: Number(t) } }), !0);
+    case "icon": {
+      if (!t) return !1;
+      const l = t.lastIndexOf(":"), i = l > 0 ? { kind: "icon", key: t.slice(0, l), frame: t.slice(l + 1), style: n } : { kind: "icon", key: t, style: n };
+      return r.push(i), !0;
+    }
+    default:
+      return !1;
+  }
+}
+export {
+  m as escapeRichText,
+  x as parseRichText,
+  p as stripRichText
+};

package/dist/ui.js

@@ -0,0 +1,95 @@
+import { clamp as e, insets as t, snapPx as p, snapRect as i } from "./ui/layout/geometry.js";
+import { stackLayout as m } from "./ui/layout/stack.js";
+import { anchorPosition as a } from "./ui/layout/anchor.js";
+import { fitToViewport as s } from "./ui/layout/fitToViewport.js";
+import { placeTooltip as n } from "./ui/layout/placeTooltip.js";
+import { wrapRow as h } from "./ui/layout/wrapRow.js";
+import { listWidth as S } from "./ui/layout/listWidth.js";
+import { FLING_STOP as F, clampScroll as R, maxScroll as g, scrollIntoView as w, stepFling as D } from "./ui/layout/scroll.js";
+import { quantize as L, sliderFraction as P, sliderValueAt as A } from "./ui/layout/slider.js";
+import { drainState as O, setDrainValue as y, stepDrain as B } from "./ui/layout/barDrain.js";
+import { firstFocus as W, linearFocus as b, nextFocus as k } from "./ui/layout/focusNav.js";
+import { UiRoot as z } from "./ui/UiRoot.js";
+import { uiHostOf as G } from "./ui/UiHost.js";
+import { UiPointerGate as _ } from "./ui/UiPointerGate.js";
+import { DEFAULT_NAV as C, FocusManager as H } from "./ui/FocusManager.js";
+import { Widget as j, sizeOf as J } from "./ui/Widget.js";
+import { Panel as Q } from "./ui/Panel.js";
+import { Label as Y } from "./ui/Label.js";
+import { Button as $ } from "./ui/Button.js";
+import { Bar as ro } from "./ui/Bar.js";
+import { Slider as to } from "./ui/Slider.js";
+import { Toggle as io } from "./ui/Toggle.js";
+import { Stack as mo } from "./ui/Stack.js";
+import { ScrollView as ao } from "./ui/ScrollView.js";
+import { List as so } from "./ui/List.js";
+import { Dialog as no } from "./ui/Dialog.js";
+import { DomOverlay as uo } from "./ui/dom/DomOverlay.js";
+import { DomWorldAnchors as To } from "./ui/dom/DomWorldAnchors.js";
+import { onScreen as Ro, worldToScreen as go } from "./ui/dom/worldToScreen.js";
+import { createStore as Do } from "./ui/dom/createStore.js";
+import { InputShield as Lo } from "./ui/dom/InputShield.js";
+import { isEditable as Ao, isInside as Io, shouldShield as Oo } from "./ui/dom/shieldDecision.js";
+import { RichText as Bo } from "./ui/rich/RichText.js";
+import { BitmapRichFont as Wo, CanvasRichFont as bo } from "./ui/rich/richFonts.js";
+import { escapeRichText as vo, parseRichText as zo, stripRichText as Eo } from "./ui/rich/richMarkup.js";
+import { layoutRichText as No } from "./ui/rich/richLayout.js";
+export {
+  ro as Bar,
+  Wo as BitmapRichFont,
+  $ as Button,
+  bo as CanvasRichFont,
+  C as DEFAULT_NAV,
+  no as Dialog,
+  uo as DomOverlay,
+  To as DomWorldAnchors,
+  F as FLING_STOP,
+  H as FocusManager,
+  Lo as InputShield,
+  Y as Label,
+  so as List,
+  Q as Panel,
+  Bo as RichText,
+  ao as ScrollView,
+  to as Slider,
+  mo as Stack,
+  io as Toggle,
+  _ as UiPointerGate,
+  z as UiRoot,
+  j as Widget,
+  a as anchorPosition,
+  e as clamp,
+  R as clampScroll,
+  Do as createStore,
+  O as drainState,
+  vo as escapeRichText,
+  W as firstFocus,
+  s as fitToViewport,
+  t as insets,
+  Ao as isEditable,
+  Io as isInside,
+  No as layoutRichText,
+  b as linearFocus,
+  S as listWidth,
+  g as maxScroll,
+  k as nextFocus,
+  Ro as onScreen,
+  zo as parseRichText,
+  n as placeTooltip,
+  L as quantize,
+  w as scrollIntoView,
+  y as setDrainValue,
+  Oo as shouldShield,
+  J as sizeOf,
+  P as sliderFraction,
+  A as sliderValueAt,
+  p as snapPx,
+  i as snapRect,
+  m as stackLayout,
+  B as stepDrain,
+  D as stepFling,
+  Eo as stripRichText,
+  G as uiHostOf,
+  go as worldToScreen,
+  h as wrapRow
+};

package/package.json

@@ -1,6 +1,114 @@
 {
   "name": "1681-engine",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.5.9",
+  "description": "A 2D game engine on PixiJS 8 for any art style: scenes and a fast ECS, a fixed-step loop, asset loading, Tiled maps, sprite animation, input actions, camera follow, audio and deterministic, server-replayable movement, plus Dither, an optional pixel-art module (pixel-perfect effects, dithered lighting).",
+  "type": "module",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/1681-engine.js"
+    },
+    "./pixel": {
+      "types": "./dist/types/pixel/index.d.ts",
+      "import": "./dist/pixel.js"
+    },
+    "./ui": {
+      "types": "./dist/types/ui/index.d.ts",
+      "import": "./dist/ui.js"
+    },
+    "./postfx": {
+      "types": "./dist/types/postfx/index.d.ts",
+      "import": "./dist/postfx.js"
+    },
+    "./react": {
+      "types": "./dist/types/react/index.d.ts",
+      "import": "./dist/react.js"
+    },
+    "./pixel/tone": {
+      "types": "./dist/types/pixel/pixelTone.d.ts",
+      "import": "./dist/pixel/pixelTone.js"
+    },
+    "./pixel/paint": {
+      "types": "./dist/types/pixel/pixelPaint.d.ts",
+      "import": "./dist/pixel/pixelPaint.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "dev": "vite",
+    "build": "npm run clean && vite build && tsc -p tsconfig.build.json && node scripts/fix-dts-extensions.mjs",
+    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
+    "typecheck": "tsc --noEmit && tsc -p tsconfig.test.json",
+    "test": "node scripts/test.mjs",
+    "check": "npm run typecheck && npm test && npm run build",
+    "prepublishOnly": "npm run check",
+    "bench": "node --expose-gc --import tsx bench/ecs.bench.ts",
+    "example:server": "tsx examples/multiplayer/server.ts",
+    "example:lobby": "tsx examples/lobby/server.ts",
+    "docs:examples": "node scripts/build-examples.mjs",
+    "docs:dev": "npm run docs:prepare && vitepress dev docs",
+    "docs:build": "npm run docs:prepare && npm run docs:examples && vitepress build docs",
+    "docs:preview": "vitepress preview docs",
+    "docs:prepare": "typedoc && node -e \"require('fs').copyFileSync('CHANGELOG.md','docs/changelog.md')\""
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/react": "^19.3.0",
+    "@types/react-dom": "^19.3.0",
+    "@types/ws": "^8.18.2",
+    "pixi.js": "^8.21.0",
+    "react": "^19.3.0",
+    "react-dom": "^19.3.0",
+    "tsx": "^4.20.5",
+    "typedoc": "^0.28.20",
+    "typedoc-plugin-markdown": "^4.13.1",
+    "typedoc-vitepress-theme": "^1.1.4",
+    "typescript": "^5.9.2",
+    "vite": "^7.1.4",
+    "vitepress": "^1.6.4",
+    "ws": "^8.22.0"
+  },
+  "license": "MIT",
+  "keywords": [
+    "game-engine",
+    "2d",
+    "pixijs",
+    "ecs",
+    "tiled",
+    "pixel-art",
+    "gamedev",
+    "multiplayer",
+    "typescript"
+  ],
+  "sideEffects": false,
+  "module": "./dist/1681-engine.js",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "peerDependencies": {
+    "pixi.js": "^8.6.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Phadec/1681-engine.git"
+  },
+  "homepage": "https://phadec.github.io/1681-engine/",
+  "bugs": {
+    "url": "https://github.com/Phadec/1681-engine/issues"
+  },
+  "author": "Phadec"
+}