@sanbus/galley-deno 0.0.1

package/README.md

@@ -0,0 +1,8 @@
+# JavaScript Bindings for Deno
+
+`@sanbus/galley-core` over `Deno.dlopen` and `bindings/c/galley.h`. Zero
+dependencies; the adapter is plain TypeScript run directly by Deno.
+
+See `docs/bindings_js_deno.md` and `examples/js/deno` for the consumer flow.
+
+One shared library embeds one parser; sessions are not thread-safe.

package/build.ts

@@ -0,0 +1,39 @@
+#!/usr/bin/env -S deno run --allow-read --allow-write --allow-run --allow-env
+/**
+ * Builds a Galley parser and its shared library for a JavaScript consumer
+ * on Deno.
+ *
+ * Usage (from a language directory, e.g. examples/js/deno):
+ *   deno task build
+ * which runs:
+ *   deno run --allow-read --allow-write --allow-run --allow-env \
+ *     ../../../bindings/js/deno/build.ts .
+ *
+ * Thin wrapper over the shared gate (`../core/build/builder.mjs`), which
+ * documents the accepted grammar files and owns the build. For both legs
+ * at once, use the single entry instead: `galley build <language-dir>`
+ * from `@sanbus/galley`.
+ */
+
+import { buildParserArtifact } from "../core/build/builder.mjs";
+import { artifactFileName, wasmArtifactFileName } from "../core/src/artifact.ts";
+
+const LIBRARY_NAME = "galley-js-deno";
+
+function fatal(msg: string): never {
+  console.error(`galley-bindings: ${msg}`);
+  Deno.exit(1);
+}
+
+async function main(): Promise<void> {
+  if (Deno.args.length !== 1) fatal("usage: deno task build  (runs build.ts <language-dir>)");
+  await buildParserArtifact({
+    languageDirectory: Deno.args[0],
+    libraryName: LIBRARY_NAME,
+    platform: Deno.build.os,
+    artifactFileName,
+    wasmArtifactFileName,
+  });
+}
+
+main();

package/dist/dispatch.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Deno procedure-dispatch installer.
+ *
+ * Owns the `UnsafeCallback` that the shared JS shim
+ * (`galley_install_js_dispatch_id`, generated by `@sanbus/galley-core/build/shim.mjs`)
+ * forwards every parser hook through. The registry and the ID-to-name
+ * dispatcher live in the core; this module only bridges the native
+ * boundary. Unlike Node there is no auto-scan: Deno consumers register
+ * hooks explicitly (`installProcedures(await import("./procedures.ts"))`).
+ * Libraries that predate integer hook IDs still export the name-carrying
+ * `galley_install_js_dispatch`, used as a fallback.
+ */
+import type { FfiPort } from "@sanbus/galley-core";
+import type { DenoPort } from "./ffi.ts";
+export declare function ensureDispatchFor(port: DenoPort & FfiPort): void;

package/dist/dispatch.js

@@ -0,0 +1,80 @@
+/**
+ * Deno procedure-dispatch installer.
+ *
+ * Owns the `UnsafeCallback` that the shared JS shim
+ * (`galley_install_js_dispatch_id`, generated by `@sanbus/galley-core/build/shim.mjs`)
+ * forwards every parser hook through. The registry and the ID-to-name
+ * dispatcher live in the core; this module only bridges the native
+ * boundary. Unlike Node there is no auto-scan: Deno consumers register
+ * hooks explicitly (`installProcedures(await import("./procedures.ts"))`).
+ * Libraries that predate integer hook IDs still export the name-carrying
+ * `galley_install_js_dispatch`, used as a fallback.
+ */
+import { dispatchProcedure } from "@sanbus/galley-core";
+const textDecoder = new TextDecoder();
+// Held to prevent GC of the callbacks; installed per library path.
+// ID and name paths keep separate slots: their signatures differ.
+let dispatchIdCallback = null;
+let dispatchIdPointer = null;
+let dispatchCallback = null;
+let dispatchPointer = null;
+const installedFor = new Set();
+export function ensureDispatchFor(port) {
+    if (!port.supportsDispatch) {
+        // Library was built for C procedures (no shim); installs will be no-ops.
+        return;
+    }
+    if (installedFor.has(port.libraryPath))
+        return;
+    if (typeof port.native.galley_install_js_dispatch_id === "function" &&
+        port.procedureNames().length > 0) {
+        installIdDispatch(port);
+    }
+    else {
+        installNameDispatch(port);
+    }
+    installedFor.add(port.libraryPath);
+}
+function installIdDispatch(port) {
+    if (dispatchIdCallback === null) {
+        // Integer hook IDs: no string copy or decode on the hot path. The table
+        // is fixed per library build; unknown IDs are silent no-ops.
+        const table = port.procedureNames();
+        const cb = new Deno.UnsafeCallback({ parameters: ["u32", "pointer"], result: "void" }, (id, argsPtr) => {
+            const name = table[id];
+            if (name === undefined)
+                return;
+            dispatchProcedure(name, argsPtr, port);
+        });
+        // Prevent GC — the trampoline must stay reachable for the process lifetime.
+        globalThis.__galley_js_dispatchIdCallback = cb;
+        dispatchIdCallback = cb;
+        dispatchIdPointer = cb.pointer;
+    }
+    port.native.galley_install_js_dispatch_id(dispatchIdPointer);
+}
+function installNameDispatch(port) {
+    if (dispatchCallback === null) {
+        // Signature mirrors Zig: fn([*]const u8, usize, ?*anyopaque) callconv(.c) void.
+        const cb = new Deno.UnsafeCallback({ parameters: ["pointer", "usize", "pointer"], result: "void" }, (namePtr, nameLen, argsPtr) => {
+            if (namePtr === null)
+                return;
+            let name;
+            try {
+                const bytes = new Deno.UnsafePointerView(namePtr).getArrayBuffer(Number(nameLen)).slice(0);
+                name = textDecoder.decode(bytes);
+            }
+            catch (e) {
+                console.error("galley procedure dispatch: failed to decode name", e);
+                return;
+            }
+            dispatchProcedure(name, argsPtr, port);
+        });
+        // Prevent GC — the trampoline must stay reachable for the process lifetime.
+        globalThis.__galley_js_dispatchCallback = cb;
+        dispatchCallback = cb;
+        dispatchPointer = cb.pointer;
+    }
+    port.native.galley_install_js_dispatch(dispatchPointer);
+}
+//# sourceMappingURL=dispatch.js.map

package/dist/dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.js","sourceRoot":"","sources":["../src/dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAIxD,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC;AAEtC,mEAAmE;AACnE,kEAAkE;AAClE,IAAI,kBAAkB,GAAY,IAAI,CAAC;AACvC,IAAI,iBAAiB,GAA6B,IAAI,CAAC;AACvD,IAAI,gBAAgB,GAAY,IAAI,CAAC;AACrC,IAAI,eAAe,GAA6B,IAAI,CAAC;AACrD,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;AAEvC,MAAM,UAAU,iBAAiB,CAAC,IAAwB;IACxD,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAC3B,yEAAyE;QACzE,OAAO;IACT,CAAC;IACD,IAAI,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC;QAAE,OAAO;IAC/C,IACE,OAAO,IAAI,CAAC,MAAM,CAAC,6BAA6B,KAAK,UAAU;QAC/D,IAAI,CAAC,cAAc,EAAE,CAAC,MAAM,GAAG,CAAC,EAChC,CAAC;QACD,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;SAAM,CAAC;QACN,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IACD,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAwB;IACjD,IAAI,kBAAkB,KAAK,IAAI,EAAE,CAAC;QAChC,wEAAwE;QACxE,6DAA6D;QAC7D,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QACpC,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,cAAc,CAChC,EAAE,UAAU,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAClD,CAAC,EAAE,EAAE,OAAO,EAAE,EAAE;YACd,MAAM,IAAI,GAAG,KAAK,CAAC,EAAY,CAAC,CAAC;YACjC,IAAI,IAAI,KAAK,SAAS;gBAAE,OAAO;YAC/B,iBAAiB,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QACzC,CAAC,CACF,CAAC;QACF,4EAA4E;QAC3E,UAAiD,CAAC,8BAA8B,GAAG,EAAE,CAAC;QACvF,kBAAkB,GAAG,EAAE,CAAC;QACxB,iBAAiB,GAAG,EAAE,CAAC,OAAO,CAAC;IACjC,CAAC;IACA,IAAI,CAAC,MAAM,CAAC,6BAAuE,CAClF,iBAAsC,CACvC,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAwB;IACnD,IAAI,gBAAgB,KAAK,IAAI,EAAE,CAAC;QAC9B,gFAAgF;QAChF,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,cAAc,CAChC,EAAE,UAAU,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAC/D,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE;YAC5B,IAAI,OAAO,KAAK,IAAI;gBAAE,OAAO;YAC7B,IAAI,IAAY,CAAC;YACjB,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBAC3F,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACnC,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,OAAO,CAAC,KAAK,CAAC,kDAAkD,EAAE,CAAC,CAAC,CAAC;gBACrE,OAAO;YACT,CAAC;YACD,iBAAiB,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QACzC,CAAC,CACF,CAAC;QACF,4EAA4E;QAC3E,UAAiD,CAAC,4BAA4B,GAAG,EAAE,CAAC;QACrF,gBAAgB,GAAG,EAAE,CAAC;QACtB,eAAe,GAAG,EAAE,CAAC,OAAO,CAAC;IAC/B,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,0BAA0B,CAAC,eAAoC,CAAC,CAAC;AAC/E,CAAC"}

package/dist/ffi.d.ts

@@ -0,0 +1,254 @@
+/**
+ * Deno adapter for the Galley JavaScript bindings: `Deno.dlopen` bindings
+ * over `bindings/c/galley.h`, implementing the core `FfiPort`.
+ *
+ * Zero dependencies: no npm packages, no build step for the adapter itself.
+ * The core (`@sanbus/galley-core`, resolved to its compiled `dist` via the
+ * package `deno.json` import map) owns all session logic; memory copying
+ * and integer normalization live here. Requires `--allow-ffi` (dlopen),
+ * `--allow-read` (library discovery, `parseFile`), and `--allow-env`
+ * (library discovery).
+ */
+import type { FfiPort, Handle, SessionCOptions, TreeSnapshot, WalkedStep } from "@sanbus/galley-core";
+/** Callable view of the native symbols (see `BASE_SYMBOLS` below). */
+type FfiOut = Uint8Array | Uint32Array | BigUint64Array | BigInt64Array;
+interface GalleySymbols {
+    galley_version(): Deno.PointerValue;
+    galley_parser_type(): bigint;
+    galley_error_recovery_mode(): bigint;
+    galley_has_ast(): number;
+    galley_has_procedures(): number;
+    galley_allows_no_ast_tree_procedures(): number;
+    galley_source_retention_enabled(): number;
+    galley_has_position_tracking(): number;
+    galley_has_input_streaming(): number;
+    galley_uses_verbatim(): number;
+    galley_stack_overflow_recovery_available(): number;
+    galley_symbol_count(): bigint;
+    galley_variable_count(): bigint;
+    galley_status_string(status: bigint): Deno.PointerValue;
+    galley_symbol_name(session: Deno.PointerValue, index: bigint, outData: FfiOut, outLen: FfiOut): bigint;
+    galley_symbol_is_terminal(session: Deno.PointerValue, index: bigint): number;
+    galley_variable_name(session: Deno.PointerValue, index: bigint, outData: FfiOut, outLen: FfiOut): bigint;
+    galley_session_create(): Deno.PointerValue;
+    galley_session_create_ex(options: FfiOut): Deno.PointerValue;
+    galley_session_destroy(session: Deno.PointerValue): void;
+    galley_session_set_message_override(session: Deno.PointerValue, name: FfiOut, nameLen: number, message: FfiOut, messageLen: number): bigint;
+    galley_parse(session: Deno.PointerValue, data: FfiOut, len: number): bigint;
+    galley_parse_file(session: Deno.PointerValue, path: FfiOut): bigint;
+    galley_last_position(session: Deno.PointerValue, outLine: FfiOut, outCol: FfiOut): bigint;
+    galley_node_count(session: Deno.PointerValue): bigint;
+    galley_reserve_nodes(session: Deno.PointerValue, capacity: bigint): bigint;
+    galley_node_capacity(session: Deno.PointerValue): bigint;
+    galley_root_node(session: Deno.PointerValue): bigint;
+    galley_node_is_valid(session: Deno.PointerValue, node: bigint): number;
+    galley_node_child_count(session: Deno.PointerValue, node: bigint): number;
+    galley_node_first_child(session: Deno.PointerValue, node: bigint): bigint;
+    galley_node_last_child(session: Deno.PointerValue, node: bigint): bigint;
+    galley_node_next_sibling(session: Deno.PointerValue, node: bigint): bigint;
+    galley_node_prior_sibling(session: Deno.PointerValue, node: bigint): bigint;
+    galley_node_parent(session: Deno.PointerValue, node: bigint): bigint;
+    galley_tree_snapshot(session: Deno.PointerValue, outParent: FfiOut, outFirstChild: FfiOut, outNext: FfiOut, outChildCount: FfiOut, outVariable: FfiOut, outSpanStart: FfiOut, outSpanLen: FfiOut, capacity: bigint): bigint;
+    galley_walker_create(session: Deno.PointerValue, node: bigint, skipSemanticErrors: number): Deno.PointerValue;
+    galley_walker_next(walker: Deno.PointerValue, outNode: FfiOut, outDepth: FfiOut, outFlag: FfiOut): number;
+    galley_walker_skip_children(walker: Deno.PointerValue): void;
+    galley_walker_destroy(walker: Deno.PointerValue): void;
+    galley_node_span(session: Deno.PointerValue, node: bigint, outStart: FfiOut, outLen: FfiOut): bigint;
+    galley_node_symbol_name(session: Deno.PointerValue, node: bigint, outData: FfiOut, outLen: FfiOut): bigint;
+    galley_node_variable_index(session: Deno.PointerValue, node: bigint): bigint;
+    galley_node_text(session: Deno.PointerValue, node: bigint, outData: FfiOut, outLen: FfiOut): bigint;
+    galley_node_line_column(session: Deno.PointerValue, node: bigint, outLine: FfiOut, outCol: FfiOut): bigint;
+    galley_has_diagnostic(session: Deno.PointerValue): number;
+    galley_diagnostic_kind(session: Deno.PointerValue): bigint;
+    galley_diagnostic_message(session: Deno.PointerValue, out: FfiOut): bigint;
+    galley_diagnostic_message_ansi(session: Deno.PointerValue, out: FfiOut): bigint;
+    galley_diagnostic_position(session: Deno.PointerValue, outLine: FfiOut, outCol: FfiOut): bigint;
+    galley_diagnostic_unexpected_token(session: Deno.PointerValue, outData: FfiOut, outLen: FfiOut): bigint;
+    galley_diagnostic_expected_count(session: Deno.PointerValue): bigint;
+    galley_diagnostic_expected_at(session: Deno.PointerValue, index: bigint, outData: FfiOut, outLen: FfiOut): bigint;
+    galley_diagnostic_context_count(session: Deno.PointerValue): bigint;
+    galley_diagnostic_context_at(session: Deno.PointerValue, index: bigint, outData: FfiOut, outLen: FfiOut): bigint;
+    galley_diagnostic_indentation(session: Deno.PointerValue, outSpaces: FfiOut, outWidth: FfiOut): bigint;
+    galley_syntax_error_count(session: Deno.PointerValue): bigint;
+    galley_semantic_error_count(session: Deno.PointerValue): bigint;
+    galley_diagnostic_semantic(session: Deno.PointerValue, outVariable: FfiOut, outVariableLen: FfiOut, outMessage: FfiOut, outMessageLen: FfiOut): bigint;
+    galley_diagnostic_recovery_kind(session: Deno.PointerValue): bigint;
+    galley_diagnostic_recovery_terminal(session: Deno.PointerValue, outData: FfiOut, outLen: FfiOut): bigint;
+    galley_diagnostic_recovery_resume(session: Deno.PointerValue, out: FfiOut): bigint;
+    galley_diagnostic_recovery_lhs_variable(session: Deno.PointerValue, outData: FfiOut, outLen: FfiOut): bigint;
+    galley_diagnostic_recovery_production(session: Deno.PointerValue, outVar: FfiOut, outLen: FfiOut, outIdx: FfiOut): bigint;
+    galley_diagnostic_recovery_occurrence(session: Deno.PointerValue, outParent: FfiOut, outParentLen: FfiOut, outRhs: FfiOut, outSym: FfiOut, outVar: FfiOut, outVarLen: FfiOut): bigint;
+    galley_recorded_diagnostic_count(session: Deno.PointerValue): bigint;
+    galley_recorded_diagnostic_kind(session: Deno.PointerValue, diagIndex: bigint): bigint;
+    galley_recorded_diagnostic_position(session: Deno.PointerValue, diagIndex: bigint, outLine: FfiOut, outCol: FfiOut): bigint;
+    galley_recorded_unexpected_token(session: Deno.PointerValue, diagIndex: bigint, outData: FfiOut, outLen: FfiOut): bigint;
+    galley_recorded_diagnostic_message(session: Deno.PointerValue, diagIndex: bigint, out: FfiOut): bigint;
+    galley_recorded_indentation(session: Deno.PointerValue, diagIndex: bigint, outSpaces: FfiOut, outWidth: FfiOut): bigint;
+    galley_recorded_semantic(session: Deno.PointerValue, diagIndex: bigint, outVariable: FfiOut, outVariableLen: FfiOut, outMessage: FfiOut, outMessageLen: FfiOut): bigint;
+    galley_recorded_expected_count(session: Deno.PointerValue, diagIndex: bigint): bigint;
+    galley_recorded_expected_token(session: Deno.PointerValue, diagIndex: bigint, tokenIndex: bigint, outData: FfiOut, outLen: FfiOut): bigint;
+    galley_recorded_context_count(session: Deno.PointerValue, diagIndex: bigint): bigint;
+    galley_recorded_context_name(session: Deno.PointerValue, diagIndex: bigint, ctxIndex: bigint, outData: FfiOut, outLen: FfiOut): bigint;
+    galley_recorded_recovery_kind(session: Deno.PointerValue, diagIndex: bigint): bigint;
+    galley_recorded_recovery_terminal(session: Deno.PointerValue, diagIndex: bigint, outData: FfiOut, outLen: FfiOut): bigint;
+    galley_recorded_recovery_resume(session: Deno.PointerValue, diagIndex: bigint, out: FfiOut): bigint;
+    galley_recorded_recovery_lhs_variable(session: Deno.PointerValue, diagIndex: bigint, outData: FfiOut, outLen: FfiOut): bigint;
+    galley_recorded_recovery_production(session: Deno.PointerValue, diagIndex: bigint, outVar: FfiOut, outLen: FfiOut, outIdx: FfiOut): bigint;
+    galley_recorded_recovery_occurrence(session: Deno.PointerValue, diagIndex: bigint, outParent: FfiOut, outParentLen: FfiOut, outRhs: FfiOut, outSym: FfiOut, outVar: FfiOut, outVarLen: FfiOut): bigint;
+    galley_tree_append_children(session: Deno.PointerValue, parent: bigint, first: bigint): bigint;
+    galley_tree_insert_before(session: Deno.PointerValue, target: bigint, first: bigint): bigint;
+    galley_tree_insert_after(session: Deno.PointerValue, target: bigint, first: bigint): bigint;
+    galley_tree_remove_siblings(session: Deno.PointerValue, node: bigint, count: number, outHead: FfiOut): bigint;
+    galley_tree_remove_self(session: Deno.PointerValue, node: bigint, outHead: FfiOut): bigint;
+    galley_tree_promote_children_over_wrapper(session: Deno.PointerValue, wrapper: bigint, outHead: FfiOut): bigint;
+    galley_tree_clean_children(session: Deno.PointerValue, node: bigint, outHead: FfiOut): bigint;
+    galley_tree_unlink_wrapper(session: Deno.PointerValue, wrapper: bigint): bigint;
+    galley_tree_insert_children_at(session: Deno.PointerValue, parent: bigint, index: number, first: bigint): bigint;
+    galley_tree_remove_children_at(session: Deno.PointerValue, parent: bigint, index: number, count: number, outHead: FfiOut): bigint;
+    galley_procedure_session(args: Deno.PointerValue): Deno.PointerValue;
+    galley_procedure_current_node(args: Deno.PointerValue): bigint;
+    galley_procedure_set_current_node(args: Deno.PointerValue, node: bigint): void;
+    galley_procedure_drop_self(args: Deno.PointerValue): bigint;
+    galley_procedure_drop_children(args: Deno.PointerValue): bigint;
+    galley_procedure_drop_if_empty(args: Deno.PointerValue): bigint;
+    galley_procedure_replace_with_children(args: Deno.PointerValue): bigint;
+    galley_procedure_context_line(args: Deno.PointerValue): number;
+    galley_procedure_context_column(args: Deno.PointerValue): number;
+    galley_procedure_report_semantic_error(args: Deno.PointerValue, message: FfiOut, messageLen: number): bigint;
+    galley_install_js_dispatch(callback: Deno.PointerValue): void;
+    galley_install_js_dispatch_id?(callback: Deno.PointerValue): void;
+    galley_js_procedure_count?(): number;
+    galley_js_procedure_name_ptr?(index: number): bigint;
+    galley_js_procedure_name_len?(index: number): bigint;
+    galley_js_procedure_enable?(name: FfiOut, nameLen: number | bigint): number;
+    galley_js_procedure_clear?(): void;
+}
+export declare function libFileName(base?: string): string;
+export declare function findLibrary(explicit?: string): string;
+export declare class DenoPort implements FfiPort {
+    #private;
+    readonly native: GalleySymbols;
+    readonly libraryPath: string;
+    readonly supportsDispatch: boolean;
+    constructor(native: GalleySymbols, libraryPath: string, supportsDispatch: boolean);
+    syncProcedures(names: string[]): void;
+    procedureNames(): string[];
+    version(): string;
+    parserType(): number;
+    errorRecoveryMode(): number;
+    hasAst(): boolean;
+    hasProcedures(): boolean;
+    allowsNoAstTreeProcedures(): boolean;
+    sourceRetentionEnabled(): boolean;
+    hasPositionTracking(): boolean;
+    hasInputStreaming(): boolean;
+    usesVerbatim(): boolean;
+    stackOverflowRecoveryAvailable(): boolean;
+    symbolCount(): number;
+    variableCount(): number;
+    statusString(status: number): string | null;
+    createSession(options: SessionCOptions | null): Handle;
+    destroySession(handle: Handle): void;
+    setMessageOverride(handle: Handle, name: Uint8Array, message: Uint8Array): number;
+    parse(handle: Handle, data: Uint8Array): number;
+    parseFile(handle: Handle, filePath: string): number;
+    lastPosition(handle: Handle): [number, number] | null;
+    nodeCount(handle: Handle): number;
+    reserveNodes(handle: Handle, capacity: bigint): number;
+    nodeCapacity(handle: Handle): number;
+    rootNode(handle: Handle): bigint;
+    nodeValid(handle: Handle, node: bigint): boolean;
+    childCount(handle: Handle, node: bigint): number;
+    firstChild(handle: Handle, node: bigint): bigint;
+    lastChild(handle: Handle, node: bigint): bigint;
+    nextSibling(handle: Handle, node: bigint): bigint;
+    priorSibling(handle: Handle, node: bigint): bigint;
+    parent(handle: Handle, node: bigint): bigint;
+    treeSnapshot(handle: Handle): TreeSnapshot;
+    walkerCreate(handle: Handle, node: bigint, skipSemanticErrors: boolean): Handle | null;
+    walkerNext(walker: Handle): WalkedStep | null;
+    walkerSkipChildren(walker: Handle): void;
+    walkerDestroy(walker: Handle): void;
+    nodeSymbolName(handle: Handle, node: bigint): Uint8Array | null;
+    nodeText(handle: Handle, node: bigint): Uint8Array | null;
+    nodeSpan(handle: Handle, node: bigint): [bigint, bigint] | null;
+    nodeLineColumn(handle: Handle, node: bigint): [number, number] | null;
+    nodeVariableIndex(handle: Handle, node: bigint): number;
+    symbolNameAt(handle: Handle, index: number): Uint8Array | null;
+    symbolIsTerminal(handle: Handle, index: number): boolean;
+    variableNameAt(handle: Handle, index: number): Uint8Array | null;
+    hasDiagnostic(handle: Handle): boolean;
+    diagnosticKind(handle: Handle): number;
+    diagnosticMessage(handle: Handle): string | null;
+    diagnosticMessageAnsi(handle: Handle): string | null;
+    diagnosticPosition(handle: Handle): [number, number] | null;
+    diagnosticUnexpectedToken(handle: Handle): Uint8Array | null;
+    diagnosticExpectedCount(handle: Handle): number;
+    diagnosticExpectedAt(handle: Handle, index: number): Uint8Array | null;
+    diagnosticContextCount(handle: Handle): number;
+    diagnosticContextAt(handle: Handle, index: number): Uint8Array | null;
+    syntaxErrorCount(handle: Handle): number;
+    semanticErrorCount(handle: Handle): number;
+    diagnosticSemantic(handle: Handle): [string, string] | null;
+    diagnosticIndentation(handle: Handle): [number, number] | null;
+    diagnosticRecoveryKind(handle: Handle): number;
+    diagnosticRecoveryTerminal(handle: Handle): Uint8Array | null;
+    diagnosticRecoveryResume(handle: Handle): number | null;
+    diagnosticRecoveryLhsVariable(handle: Handle): string | null;
+    diagnosticRecoveryProduction(handle: Handle): [string, number] | null;
+    diagnosticRecoveryOccurrence(handle: Handle): [string, number, number, string] | null;
+    recordedDiagnosticCount(handle: Handle): number;
+    recordedDiagnosticKind(handle: Handle, diagIndex: number): number;
+    recordedDiagnosticPosition(handle: Handle, diagIndex: number): [number, number] | null;
+    recordedUnexpectedToken(handle: Handle, diagIndex: number): Uint8Array | null;
+    recordedDiagnosticMessage(handle: Handle, diagIndex: number): string | null;
+    recordedIndentation(handle: Handle, diagIndex: number): [number, number] | null;
+    recordedSemantic(handle: Handle, diagIndex: number): [string, string] | null;
+    recordedExpectedCount(handle: Handle, diagIndex: number): number;
+    recordedExpectedToken(handle: Handle, diagIndex: number, tokenIndex: number): Uint8Array | null;
+    recordedContextCount(handle: Handle, diagIndex: number): number;
+    recordedContextName(handle: Handle, diagIndex: number, contextIndex: number): Uint8Array | null;
+    recordedRecoveryKind(handle: Handle, diagIndex: number): number;
+    recordedRecoveryTerminal(handle: Handle, diagIndex: number): Uint8Array | null;
+    recordedRecoveryResume(handle: Handle, diagIndex: number): number | null;
+    recordedRecoveryLhsVariable(handle: Handle, diagIndex: number): string | null;
+    recordedRecoveryProduction(handle: Handle, diagIndex: number): [string, number] | null;
+    recordedRecoveryOccurrence(handle: Handle, diagIndex: number): [string, number, number, string] | null;
+    treeAppendChildren(handle: Handle, parent: bigint, first: bigint): number;
+    treeInsertBefore(handle: Handle, target: bigint, first: bigint): number;
+    treeInsertAfter(handle: Handle, target: bigint, first: bigint): number;
+    treeRemoveSiblings(handle: Handle, node: bigint, count: number): {
+        status: number;
+        head: bigint;
+    };
+    treeRemoveSelf(handle: Handle, node: bigint): {
+        status: number;
+        head: bigint;
+    };
+    treePromoteChildrenOverWrapper(handle: Handle, wrapper: bigint): {
+        status: number;
+        head: bigint;
+    };
+    treeCleanChildren(handle: Handle, node: bigint): {
+        status: number;
+        head: bigint;
+    };
+    treeUnlinkWrapper(handle: Handle, wrapper: bigint): number;
+    treeInsertChildrenAt(handle: Handle, parent: bigint, index: number, first: bigint): number;
+    treeRemoveChildrenAt(handle: Handle, parent: bigint, index: number, count: number): {
+        status: number;
+        head: bigint;
+    };
+    procCurrentNode(args: Handle): bigint;
+    procSetCurrentNode(args: Handle, node: bigint): void;
+    procDropSelf(args: Handle): number;
+    procDropChildren(args: Handle): number;
+    procDropIfEmpty(args: Handle): number;
+    procReplaceWithChildren(args: Handle): number;
+    procContextLine(args: Handle): number;
+    procContextColumn(args: Handle): number;
+    procReportSemanticError(args: Handle, message: Uint8Array): number;
+}
+/** Port for the library at `explicitPath` (or default discovery), cached per path. */
+export declare function getDenoPort(explicitPath?: string): DenoPort;
+export {};