js-game-zero 0.0.0-stage → 0.3.0

package/dist/util.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Internal cross-cutting utilities shared between core modules. This module
+ * is intentionally NOT re-exported from `index.ts`, so none of these helpers
+ * become part of the public package API. The only geometry dependency is a
+ * type-only import, so there is no runtime import cycle.
+ */
+import type { Point } from "./geometry.js";
+/** Standard Levenshtein edit distance between two strings. */
+export declare function levenshtein(a: string, b: string): number;
+/**
+ * Optimal string alignment distance: Levenshtein where swapping two adjacent
+ * characters (`widht` for `width`) costs one edit instead of two.
+ */
+export declare function editDistance(a: string, b: string): number;
+/** Case- and underscore-insensitive form, so `filled_circle` meets `filledCircle`. */
+export declare function looseName(name: string): string;
+/**
+ * The candidate `name` most plausibly misspells, if any. Capitals and
+ * underscores don't count, so another spelling of a name (`filled_circle`,
+ * `on_key_down`, `Screen`) is always matched. Short names get one edit of
+ * slack and longer ones two (so `drow` and `onKeyDwon` match while `row` and
+ * `dow` do not), a transposition counts as one edit, and a name that
+ * contains a candidate whole (`redraw`, `updates`) is taken as deliberately
+ * derived from it rather than mistyped.
+ */
+export declare function closestName(name: string, candidates: Iterable<string>): string | undefined;
+/**
+ * A value as an error message should show it: strings quoted, lists as
+ * lists, and numbers as written (`NaN`, not JSON's `null`).
+ */
+export declare function describeValue(value: unknown): string;
+/** ` Did you mean NAME?` for a likely misspelling, or an empty string. */
+export declare function didYouMean(name: string, candidates: Iterable<string>): string;
+/**
+ * Throws a TypeError naming the first key of `options` that `allowed` does
+ * not contain, with a suggestion when the key looks like a typo — so a
+ * misspelled option fails loudly instead of being silently ignored.
+ */
+export declare function rejectUnknownOptions(options: object, allowed: ReadonlySet<string>, label: string): void;
+/** True when `value` is a thenable (a Promise or Promise-like object). */
+export declare function isPromiseLike<T>(value: unknown): value is PromiseLike<T>;
+export declare function clamp(value: number, minimum: number, maximum: number): number;
+export declare function isFiniteNumber(value: unknown): value is number;
+export declare function requireFiniteNumber(value: unknown, label: string): number;
+export declare function isPair(value: unknown): value is readonly [number, number];
+/**
+ * Validates that `value` is a `[number, number]` tuple of finite numbers,
+ * returning a fresh mutable `Point`. Shared by geometry/actor/assets/
+ * rendering, which each used to define an identical private copy.
+ */
+export declare function requirePoint(value: unknown, label: string): Point;
+export declare function horizontalAnchorOffset(value: number | "left" | "center" | "middle" | "right", width: number): number;
+export declare function verticalAnchorOffset(value: number | "top" | "center" | "middle" | "bottom", height: number): number;
+/**
+ * The compound Rect-anchor position keys (`topLeft`…`center`), shared by the
+ * actor, assets, and rendering modules for validating position keywords.
+ */
+export declare const rectPositionKeys: readonly ["topLeft", "topRight", "bottomLeft", "bottomRight", "midTop", "midLeft", "midRight", "midBottom", "center"];
+/** Recognized image asset file extensions. */
+export declare const imageExtensions: string[];
+/** Recognized sound asset file extensions. */
+export declare const soundExtensions: string[];

package/package.json

@@ -1,6 +1,71 @@
 {
   "name": "js-game-zero",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.3.0",
+  "type": "module",
+  "license": "MIT",
+  "description": "A beginner-friendly framework for browser games in the spirit of Pygame Zero: set WIDTH and HEIGHT, write draw(), and play. Actors, drawing, input, sound, animation and storage, with a script-tag build.",
+  "keywords": [
+    "game",
+    "gamedev",
+    "canvas",
+    "education",
+    "beginner",
+    "pygame-zero"
+  ],
+  "author": "Taha Rafiq",
+  "homepage": "https://github.com/Leaf-Learning/js-game-zero#readme",
+  "bugs": {
+    "url": "https://github.com/Leaf-Learning/js-game-zero/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Leaf-Learning/js-game-zero.git",
+    "directory": "packages/js-game-zero"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "jsdelivr": "./dist/jgz.js",
+  "unpkg": "./dist/jgz.js",
+  "files": [
+    "dist",
+    "LICENSE"
+  ],
+  "sideEffects": [
+    "./dist/jgz.js"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./host": {
+      "types": "./dist/host.d.ts",
+      "import": "./dist/host.js",
+      "default": "./dist/host.js"
+    },
+    "./node": {
+      "types": "./dist/node.d.ts",
+      "import": "./dist/node.js",
+      "default": "./dist/node.js"
+    },
+    "./reference": {
+      "types": "./dist/reference/index.d.ts",
+      "import": "./dist/reference/index.js",
+      "default": "./dist/reference/index.js"
+    },
+    "./reference/*.md": "./dist/reference/*.md",
+    "./iife": {
+      "types": "./dist/browser.d.ts",
+      "default": "./dist/jgz.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "bun ../../scripts/build.ts js-game-zero",
+    "test": "bun test"
+  }
+}