feat: add standard TypeScript wrapper and test structure

Author: superstructor

bench/freetype.bench.ts

@@ -0,0 +1,12 @@
+/**
+ * ${LIB_TITLE} WASM Benchmarks
+ */
+
+import ${LIB_TITLE}WASM from "../src/lib/index.ts"
+
+Deno.bench("${LIB_NAME} initialization", {
+  baseline: true
+}, async () => {
+  const lib = new ${LIB_TITLE}WASM()
+  await lib.initialize()
+})

src/lib/index.ts

@@ -0,0 +1,37 @@
+/**
+ * @module ${LIB_TITLE} WASM
+ * TypeScript-first ${LIB_TITLE} library for WebAssembly
+ */
+
+export default class ${LIB_TITLE}WASM {
+  private module: any = null
+  private initialized = false
+
+  async initialize(): Promise<void> {
+    if (this.initialized) return
+    
+    // Load WASM module
+    this.module = await this.loadWASM()
+    this.initialized = true
+  }
+
+  private async loadWASM(): Promise<any> {
+    // Try local build first
+    const localPaths = [
+      './../../install/wasm/${LIB_NAME}-main.js',
+      './../../install/wasm/${LIB_NAME}-release.js',
+    ]
+
+    for (const path of localPaths) {
+      try {
+        const modulePath = new URL(path, import.meta.url).href
+        const mod = await import(modulePath)
+        return await mod.default()
+      } catch (e) {
+        continue
+      }
+    }
+
+    throw new Error('Failed to load ${LIB_NAME}.wasm')
+  }
+}

src/lib/types.ts

@@ -0,0 +1,18 @@
+/**
+ * Type definitions for ${LIB_TITLE} WASM
+ */
+
+export interface ${LIB_UPPER}Module {
+  _malloc: (size: number) => number
+  _free: (ptr: number) => void
+  HEAPU8: Uint8Array
+  setValue: (ptr: number, value: number, type: string) => void
+  getValue: (ptr: number, type: string) => number
+}
+
+export class ${LIB_UPPER}Error extends Error {
+  constructor(message: string) {
+    super(message)
+    this.name = '${LIB_UPPER}Error'
+  }
+}

tests/deno/basic.test.ts

@@ -0,0 +1,23 @@
+import { assert, assertExists } from "@std/assert"
+
+Deno.test("Deno runtime features", () => {
+  assert(typeof Deno !== 'undefined', "Deno runtime should be available")
+  assert(typeof WebAssembly !== 'undefined', "WebAssembly should be available")
+})
+
+Deno.test("WASM file accessibility", async () => {
+  try {
+    const wasmFile = await Deno.stat("./install/wasm/${LIB_NAME}-main.wasm")
+    assert(wasmFile.isFile, "WASM file should exist")
+    assert(wasmFile.size > 0, "WASM file should not be empty")
+    console.log(`✅ Found WASM file: ${wasmFile.size} bytes`)
+  } catch (error) {
+    console.warn("⚠️  WASM file not found - run 'deno task build:wasm' first")
+  }
+})
+
+Deno.test("TypeScript module imports", async () => {
+  const { default: Module } = await import("../../src/lib/index.ts")
+  assertExists(Module, "Module class should be importable")
+  assert(typeof Module === 'function', "Module should be a constructor function")
+})