@sanbus/galley-bun 0.0.1

package/src/index.ts

@@ -0,0 +1,79 @@
+/**
+ * Galley JavaScript bindings for Bun — public surface.
+ *
+ * Binds the runtime-neutral `@sanbus/galley-core` to the `bun:ffi` port. Mirrors
+ * the layout of `bindings/python/galley.pyi` and the C header
+ * `bindings/c/galley.h`.
+ */
+
+import { getBunPort, findLibrary } 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 };
+export { getBunPort, libFileName } from "./ffi.ts";
+export type { SessionOptions, WalkStep, Diagnostic, TreeSnapshot } from "@sanbus/galley-core";
+
+// Module-level queries (mirror galley.h)
+export function version(): string {
+  return getBunPort().version();
+}
+
+export function parserType(): number {
+  return getBunPort().parserType();
+}
+
+export function errorRecoveryMode(): number {
+  return getBunPort().errorRecoveryMode();
+}
+
+export function hasAst(): boolean {
+  return getBunPort().hasAst();
+}
+
+export function hasProcedures(): boolean {
+  return getBunPort().hasProcedures();
+}
+
+export function allowsNoAstTreeProcedures(): boolean {
+  return getBunPort().allowsNoAstTreeProcedures();
+}
+
+export function sourceRetentionEnabled(): boolean {
+  return getBunPort().sourceRetentionEnabled();
+}
+
+export function hasPositionTracking(): boolean {
+  return getBunPort().hasPositionTracking();
+}
+
+export function hasInputStreaming(): boolean {
+  return getBunPort().hasInputStreaming();
+}
+
+export function usesVerbatim(): boolean {
+  return getBunPort().usesVerbatim();
+}
+
+export function stackOverflowRecoveryAvailable(): boolean {
+  return getBunPort().stackOverflowRecoveryAvailable();
+}
+
+export function symbolCount(): number {
+  return getBunPort().symbolCount();
+}
+
+export function variableCount(): number {
+  return getBunPort().variableCount();
+}
+
+export function statusString(status: number): string | null {
+  return getBunPort().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 @@
+/**
+ * Bun `Session`: the core session bound to the `bun:ffi` port.
+ *
+ * Installs the host-procedure dispatch for the session's library (mirrors
+ * Node's import-time shim setup); the installer is a no-op for libraries
+ * built for C procedures.
+ */
+
+import { Session as CoreSession } from "@sanbus/galley-core";
+import type { SessionOptions } from "@sanbus/galley-core";
+import { getBunPort } from "./ffi.ts";
+import { ensureDispatchFor } from "./dispatch.ts";
+
+export type { SessionOptions };
+
+export class Session extends CoreSession {
+  constructor(options: SessionOptions = {}) {
+    const port = getBunPort(options.libraryPath);
+    try {
+      ensureDispatchFor(port);
+    } catch {
+      // installer missing (C build) — ignore.
+    }
+    super(port, options);
+  }
+}