@sanbus/galley-deno 0.0.1

package/src/index.ts

@@ -0,0 +1,80 @@
+/**
+ * Galley JavaScript bindings for Deno — public surface.
+ *
+ * Binds the runtime-neutral `@sanbus/galley-core` to the `Deno.dlopen` port.
+ * Mirrors the layout of `bindings/python/galley.pyi` and the C header
+ * `bindings/c/galley.h`. Requires `--allow-ffi --allow-read --allow-env`.
+ */
+
+import { getDenoPort, 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 { getDenoPort, libFileName } from "./ffi.ts";
+import type { SessionOptions as SessionOptionsType, WalkStep as WalkStepType, Diagnostic as DiagnosticType } from "@sanbus/galley-core";
+export type { SessionOptionsType as SessionOptions, WalkStepType as WalkStep, DiagnosticType as Diagnostic };
+
+// Module-level queries (mirror galley.h)
+export function version(): string {
+  return getDenoPort().version();
+}
+
+export function parserType(): number {
+  return getDenoPort().parserType();
+}
+
+export function errorRecoveryMode(): number {
+  return getDenoPort().errorRecoveryMode();
+}
+
+export function hasAst(): boolean {
+  return getDenoPort().hasAst();
+}
+
+export function hasProcedures(): boolean {
+  return getDenoPort().hasProcedures();
+}
+
+export function allowsNoAstTreeProcedures(): boolean {
+  return getDenoPort().allowsNoAstTreeProcedures();
+}
+
+export function sourceRetentionEnabled(): boolean {
+  return getDenoPort().sourceRetentionEnabled();
+}
+
+export function hasPositionTracking(): boolean {
+  return getDenoPort().hasPositionTracking();
+}
+
+export function hasInputStreaming(): boolean {
+  return getDenoPort().hasInputStreaming();
+}
+
+export function usesVerbatim(): boolean {
+  return getDenoPort().usesVerbatim();
+}
+
+export function stackOverflowRecoveryAvailable(): boolean {
+  return getDenoPort().stackOverflowRecoveryAvailable();
+}
+
+export function symbolCount(): number {
+  return getDenoPort().symbolCount();
+}
+
+export function variableCount(): number {
+  return getDenoPort().variableCount();
+}
+
+export function statusString(status: number): string | null {
+  return getDenoPort().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,25 @@
+/**
+ * Deno `Session`: the core session bound to the `Deno.dlopen` port.
+ *
+ * Installs the host-procedure dispatch for the session's library; 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 { getDenoPort } from "./ffi.ts";
+import { ensureDispatchFor } from "./dispatch.ts";
+
+export type { SessionOptions };
+
+export class Session extends CoreSession {
+  constructor(options: SessionOptions = {}) {
+    const port = getDenoPort(options.libraryPath);
+    try {
+      ensureDispatchFor(port);
+    } catch {
+      // installer missing (C build) — ignore.
+    }
+    super(port, options);
+  }
+}