@sanbus/galley-wasm 0.0.1

package/src/index.ts

@@ -0,0 +1,82 @@
+/**
+ * Galley JavaScript bindings over WebAssembly — public surface.
+ *
+ * Binds the runtime-neutral `@sanbus/galley-core` to the wasm port. Mirrors the
+ * layout of the Node adapter and the C header `bindings/c/galley.h`.
+ *
+ * Initialization: `await init()` (required in browsers; optional under Node
+ * where the module auto-initializes synchronously on first use).
+ */
+
+import { getWasmPort, findLibrary, init, initSync, seedDefault, NeedInitError } from "./ffi.ts";
+import { Session } from "./session.ts";
+
+// Core surface (Session base is shadowed by the adapter subclass below).
+export * from "@sanbus/galley-core";
+export { Session };
+export { findLibrary, init, initSync, seedDefault, NeedInitError };
+export { getWasmPort, wasmFileName } from "./ffi.ts";
+export type { InitOptions } from "./ffi.ts";
+export type { SessionOptions, WalkStep, Diagnostic, TreeSnapshot } from "@sanbus/galley-core";
+
+// Module-level queries (mirror galley.h)
+export function version(): string {
+  return getWasmPort().version();
+}
+
+export function parserType(): number {
+  return getWasmPort().parserType();
+}
+
+export function errorRecoveryMode(): number {
+  return getWasmPort().errorRecoveryMode();
+}
+
+export function hasAst(): boolean {
+  return getWasmPort().hasAst();
+}
+
+export function hasProcedures(): boolean {
+  return getWasmPort().hasProcedures();
+}
+
+export function allowsNoAstTreeProcedures(): boolean {
+  return getWasmPort().allowsNoAstTreeProcedures();
+}
+
+export function sourceRetentionEnabled(): boolean {
+  return getWasmPort().sourceRetentionEnabled();
+}
+
+export function hasPositionTracking(): boolean {
+  return getWasmPort().hasPositionTracking();
+}
+
+export function hasInputStreaming(): boolean {
+  return getWasmPort().hasInputStreaming();
+}
+
+export function usesVerbatim(): boolean {
+  return getWasmPort().usesVerbatim();
+}
+
+export function stackOverflowRecoveryAvailable(): boolean {
+  return getWasmPort().stackOverflowRecoveryAvailable();
+}
+
+export function symbolCount(): number {
+  return getWasmPort().symbolCount();
+}
+
+export function variableCount(): number {
+  return getWasmPort().variableCount();
+}
+
+export function statusString(status: number): string | null {
+  return getWasmPort().statusString(status);
+}
+
+// Preserve original Python naming aliases for docs parity
+export const has_ast = hasAst;
+export const has_procedures = hasProcedures;
+export const has_position_tracking = hasPositionTracking;

package/src/session.ts

@@ -0,0 +1,26 @@
+/**
+ * WebAssembly `Session`: the core session bound to the wasm port.
+ *
+ * Runs the adapter auto-scan for host procedures (a no-op outside Node or
+ * when hooks are already registered); the guest import itself is always
+ * wired at instantiation.
+ */
+
+import { Session as CoreSession } from "@sanbus/galley-core";
+import type { SessionOptions } from "@sanbus/galley-core";
+import { getWasmPort } from "./ffi.ts";
+import { ensureDispatch } from "./dispatch.ts";
+
+export type { SessionOptions };
+
+export class Session extends CoreSession {
+  constructor(options: SessionOptions = {}) {
+    const port = getWasmPort(options.libraryPath);
+    try {
+      ensureDispatch(options.libraryPath ?? port.libraryPath);
+    } catch {
+      // auto-scan is best-effort; explicit installProcedures always works.
+    }
+    super(port, options);
+  }
+}