@spotlab/range 0.0.0-stage → 0.2.0

package/dist/init.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Instantiate the range wasm module. Idempotent: subsequent calls return the
+ * same promise. Retryable after a failure: a rejected `initRange()` clears
+ * its memoized promise, so a later call attempts instantiation again rather
+ * than re-throwing a cached rejection.
+ *
+ * Every other function export in this package throws
+ * {@link RangeNotInitializedError} until this has resolved. `RANKS`, `SUITS`,
+ * and `COMBOS` are static data generated from the Rust crate and need no
+ * initialization.
+ */
+export declare function initRange(): Promise<void>;
+/** @internal guard called at the top of every export other than `initRange`. */
+export declare function assertInitialized(fnName: string): void;

package/dist/types.d.ts

@@ -0,0 +1,21 @@
+/**
+ * A canonical 4-character hand token (e.g. `AsKd`), branded so a bare `string`
+ * cannot be passed where a validated hand is required. Mirrors the Rust
+ * crate's `Hand` newtype.
+ *
+ * Type-only: the brand has no runtime presence, so importing this package
+ * pulls in no validation library. Values come branded from this package's
+ * own exports (`parseRange`, `handsOfCombo`, ...); a consumer holding a token
+ * it has validated itself can cast (`token as Hand`).
+ */
+export type Hand = string & {
+    readonly __brand: "Hand";
+};
+/**
+ * A single concrete hand mapped to its weight in `[0, 1]`. Mirrors the Rust
+ * crate's `HandFrequency` wire type.
+ */
+export type HandFrequency = {
+    hand: Hand;
+    frequency: number;
+};

package/package.json

@@ -1,6 +1,57 @@
 {
   "name": "@spotlab/range",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "description": "A poker range-string parser and serializer, compiled from Rust to wasm: combo/hand grammar, canonical hand tokens, and weighted-range arithmetic.",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mAAdhaTTah/spotlab",
+    "directory": "packages/range"
+  },
+  "homepage": "https://github.com/mAAdhaTTah/spotlab/tree/main/packages/range#readme",
+  "bugs": {
+    "url": "https://github.com/mAAdhaTTah/spotlab/issues"
+  },
+  "author": "James DiGioia",
+  "keywords": [
+    "poker",
+    "range",
+    "parser",
+    "wasm",
+    "texas-holdem"
+  ],
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "devDependencies": {
+    "typescript": "^6.0.0",
+    "vite": "^8.3.1",
+    "vite-plugin-dts": "^5.1.2",
+    "vitest": "^4.1.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build:wasm": "wasm-pack build ../../crates/spotlab-range-wasm --release --target web --out-name range --out-dir ../../packages/range/src/wasm",
+    "build:inline": "node scripts/inline-wasm.mjs",
+    "build:strip-wasm-url-fallback": "node scripts/strip-wasm-url-fallback.mjs",
+    "build:vite": "vite build",
+    "build:size": "node scripts/check-size.mjs",
+    "build": "pnpm build:wasm && pnpm build:inline && pnpm build:strip-wasm-url-fallback && pnpm typecheck && pnpm build:vite && pnpm build:size",
+    "typecheck": "tsc -p tsconfig.json",
+    "test": "vitest run"
+  }
 }