sqllens 1.1.0 → 1.3.0

package/README.md

@@ -15,9 +15,7 @@ Athena, Fabric, and MariaDB (see [Dialects](#dialects)).
 
 The front end is error-tolerant and token-first, so the library drives editor
 features (completion, hover, diagnostics, go-to-definition) over incomplete,
-mid-edit text. See [Editor / language tooling](#editor--language-tooling). An LSP
-(Language Server Protocol) server built on it lives in the repo, but it is
-experimental and not part of the published package.
+mid-edit text. See [Editor / language tooling](#editor--language-tooling).
 
 ```bash
 npm install sqllens
@@ -208,7 +206,7 @@ import { parse, qualify, lineage, deriveSymbols, toScopes, Schema } from "sqllen
 const { ast, errors, cst } = parse("SELECT a, b FROM t", "snowflake");
 // ast = dialect-neutral IR (frozen); cst = the raw antlr tree (escape hatch)
 
-const scopes = toScopes(ast, { dialect: "snowflake" }); // idempotent lift
+const scopes = toScopes(ast); // idempotent lift
 qualify(scopes, schema);   // reuses scopes — never re-parses or re-resolves
 lineage(scopes, schema);   // safe on the same scopes, in any order
 deriveSymbols(scopes);     // independent results
@@ -381,76 +379,6 @@ doc.tokenAt(7);                   // token under an offset
 const next = doc.withText("SELECT amount, id FROM sales", 2); // immutable edit → new doc
 ```
 
-## Language server (experimental)
-
-An LSP (Language Server Protocol) server built on the library lives in `src/lsp/`.
-It is experimental and **not part of the published npm package**: the package ships
-the library only, and the server is source you run from the repo. It holds one
-`SqlDocument` per open file (rebuilt on edit) and reaches the library only through
-the public API, and adds no analysis of its own beyond protocol translation.
-
-A SQL server needs only a subset of LSP's ~30 request types: some don't apply to
-SQL (type hierarchy, document color, monikers), and a few are deferred (formatting,
-project-wide navigation). Where the server stands today, feature by feature:
-
-### Language features
-
-| Feature | Status |
-| --- | --- |
-| Completion (+ resolve) | ✅ |
-| Hover | ✅ |
-| Hover — nullability | ✅ (` — not null` / ` — nullable` suffix when provable) |
-| Signature help | ✅ |
-| Go to definition | ✅ |
-| Find references | ✅ |
-| Document highlight | ✅ |
-| Document symbols | ✅ |
-| Folding range | ✅ |
-| Selection range | ✅ |
-| Semantic tokens (full / range / delta) | ✅ all three |
-| Inlay hints | ✅ (no resolve) |
-| Code lens | ✅ (no resolve) |
-| Go to declaration | ◻️ not yet |
-| Go to type definition | ◻️ not yet |
-| Go to implementation | ◻️ not yet — name → its defining query (view / model); needs the project model |
-| Call hierarchy | ◻️ not yet — the CTE / view / model dependency graph |
-| Document link | ◻️ not yet |
-| Linked editing range | ◻️ not yet — live alias / name sync-edit |
-| Code action (quick fixes) | ◻️ next phase |
-| Rename (+ prepare) | ◻️ next phase |
-| Formatting / range / on-type | ◻️ deferred (external formatter) |
-| Inline values | ◻️ debugger surface |
-| Type hierarchy | — n/a — SQL has no type-inheritance relation |
-| Document color | — n/a — no color literals |
-| Moniker | — n/a — LSIF / cross-repo indexing concern |
-
-### Diagnostics & document sync
-
-| Feature | Status |
-| --- | --- |
-| Diagnostics — push (`publishDiagnostics`) | ✅ |
-| Diagnostics — call signature (arity / argument type) | ✅ (curated tables; never-wrong, per-dialect coercion) |
-| Diagnostics — pull (document) | ✅ |
-| Diagnostics — pull (workspace) | ◻️ not yet |
-| Text sync — open / change / close | ✅ (full-document) |
-| Incremental sync | ◻️ full-document only (fine at SQL file sizes) |
-| Save notifications (`didSave` / `willSave`) | ◻️ not yet |
-| Notebook document sync | ◻️ not yet |
-
-### Workspace features
-
-| Feature | Status |
-| --- | --- |
-| Workspace symbols | ◻️ needs a project / multi-file model |
-| Execute command | ◻️ not yet |
-| Configuration / watched-files | ◻️ not yet (protocol config; file-based `.sqllens.json` config exists) |
-| File operations (create / rename / delete) | ◻️ not yet |
-
-Legend: ✅ implemented · ◻️ not yet / deferred · — not applicable to SQL. The
-deferred items are tracked work: rename and
-code actions are the next LSP phase, workspace symbols need the project model,
-and formatting is expected to wrap an existing external formatter.
-
 ## How sqllens compares
 
 The SQL-parser field splits into parse-only libraries and semantic tools bound

package/THIRD-PARTY-NOTICES.md

@@ -120,14 +120,84 @@ Forked from [antlr/grammars-v4](https://github.com/antlr/grammars-v4)
 Positive Technologies; (c) 2017 Ivan Khudyashev. Licensed under the MIT License
 (full text retained in the file headers).
 
+## Doc-derived function-signature and function-docs tables (distributed in this repository)
+
+The generated per-dialect function-signature tables and their per-name docs
+companions (`signatures.generated.ts` / `fn-docs.generated.ts`, produced by
+`tools/harvest-signatures.mjs`, committed under `src/`) carry factual API-surface
+data (function names, parameter names, arity, optionality) and links to each
+dialect's reference documentation. For the permissively licensed sources listed
+below, the docs tables additionally reproduce one descriptive sentence per
+function, extracted verbatim from the source and marked `origin: "vendor-docs"`.
+Sources and their licenses:
+
+### T-SQL signatures, from MicrosoftDocs/sql-docs (CC BY 4.0)
+
+Derived from the Transact-SQL reference markdown in
+[MicrosoftDocs/sql-docs](https://github.com/MicrosoftDocs/sql-docs), (c) Microsoft
+Corporation, licensed [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
+Changes were made: the documented syntax notation was mechanically parsed and
+transformed into TypeScript signature tables, and the docs table reproduces each
+function page's first descriptive sentence (truncated to one sentence, whitespace
+collapsed); no other documentation prose is reproduced.
+
+### DuckDB signatures, from duckdb/duckdb-web (MIT)
+
+Derived from the function reference markdown in
+[duckdb/duckdb-web](https://github.com/duckdb/duckdb-web), Copyright 2018-2025
+Stichting DuckDB Foundation, MIT License.
+
+### PostgreSQL signatures, from the PostgreSQL documentation (PostgreSQL License)
+
+Derived from `doc/src/sgml/func.sgml` of
+[postgres/postgres](https://github.com/postgres/postgres) (REL_18_STABLE),
+Copyright (c) 1996-2025, PostgreSQL Global Development Group, PostgreSQL License.
+
+### Trino signatures, from trinodb/trino docs (Apache License 2.0)
+
+Derived from the sphinx function reference in
+[trinodb/trino](https://github.com/trinodb/trino) `docs/src/main/sphinx/functions`
+(release 482), Apache License 2.0. trinodb/trino ships no `NOTICE` file, so there
+is no 4(d) attribution to reproduce.
+
+### BigQuery / GoogleSQL signatures, from google/googlesql docs (Apache License 2.0)
+
+Derived from the function reference markdown in
+[google/googlesql](https://github.com/google/googlesql) `docs/`, (c) Google LLC,
+Apache License 2.0.
+
+### Databricks descriptions, from Apache Spark's Built-in Functions reference (Apache License 2.0)
+
+The databricks docs table's descriptions (origin `"spark-docs"`) are reproduced
+from [Apache Spark](https://spark.apache.org)'s generated SQL Built-in Functions
+reference (4.0.1), (c) The Apache Software Foundation, Apache License 2.0 —
+Spark-authored prose describing the Spark SQL surface Databricks shares.
+Databricks-only functions carry no Spark description.
+
+### SQLite signatures and descriptions, from the sqlite.org documentation (public domain)
+
+Derived from the [sqlite.org](https://sqlite.org) function-reference pages (doc
+bundle 3.53.3). SQLite's code and documentation are dedicated to the
+[public domain](https://sqlite.org/copyright.html); the docs table reproduces one
+descriptive sentence per function.
+
+### Databricks and Snowflake signatures, from the vendors' public SQL references
+
+Derived from the Syntax sections of the public SQL language references at
+[docs.databricks.com](https://docs.databricks.com) ((c) Databricks, Inc.) and
+[docs.snowflake.com](https://docs.snowflake.com) ((c) Snowflake Inc.). These sites
+publish no redistribution license; the tables reproduce only the factual call
+shape of each function (name, parameter names, arity, optionality), the same facts
+any SQL tool documents about a dialect's API surface, and no documentation prose.
+The docs tables link each function to its page on these sites; no page text is
+reproduced. The same applies to the Redshift
+([docs.aws.amazon.com](https://docs.aws.amazon.com), (c) Amazon Web Services) and
+MySQL ([dev.mysql.com](https://dev.mysql.com/doc/), (c) Oracle Corporation)
+references: links only, no prose. Credited here as sources with thanks.
+
 ## Runtime and build dependencies (not redistributed in source)
 
 - **antlr4ng** — the TypeScript ANTLR runtime (BSD-3-Clause). Runtime dependency.
 - **antlr-ng** — the pure-TypeScript ANTLR generator used by `npm run gen` to
   produce `src/generated/` (a build product, gitignored). Dev dependency.
-- **vscode-languageserver** / **vscode-languageserver-protocol** /
-  **vscode-languageserver-textdocument** / **vscode-languageserver-types** — the
-  LSP layer's runtime dependencies (MIT).
-- **minimatch** — glob matching used by the LSP layer (ISC).
-
 Consult each package's own license for the authoritative terms.

package/dist/api.d.ts

@@ -117,10 +117,14 @@ export { SqlDocument, type DocumentAnalysis, type StatementCell, type DocumentVa
 export { LineIndex } from "./document/line-index.js";
 export type { StatementCellSpan } from "./document/split.js";
 export { complete, completeAt, type Completion } from "./completion/complete.js";
-export { signatureAt, type SignatureInfo } from "./signature/signature.js";
-export { FUNCTION_SIGNATURES, HARVESTED_SIGNATURES, lookupSignature, hasSignature, type FnSignature, type ParamSig, } from "./signature/signatures.js";
+export { jinjaSlotAt, type JinjaSlot } from "./completion/jinja-slot.js";
+export { signatureAt, type SignatureHelpInfo, type SignatureLabel } from "./signature/signature.js";
+export { SIGNATURES, lookupSignature, hasSignature, type FnSignature, type ParamSig } from "./signature/signatures.js";
+export { renderSignature, type RenderSignatureOptions } from "./signature/render.js";
+export { FN_DOCS, lookupFnDoc, type FnDoc } from "./signature/docs.js";
 export { referencesAt, type Occurrence, type Occurrences } from "./references/references.js";
 export { dialectSymbols, type DialectSymbols } from "./dialect-symbols.js";
 export { CallbackSchema, type SchemaProvider, type TableResolver } from "./qualify/schema-provider.js";
 export { DERIVED_DIALECTS, resolveDialect } from "./derived-dialects.js";
-export { foldIdentifier, displayName, type IdentKind } from "./ident/fold.js";
+export { foldIdentifier, displayName } from "./dialect-behavior/public-fold.js";
+export type { IdentKind } from "./ident/fold.js";

package/dist/api.js

@@ -205,11 +205,20 @@ export { LineIndex } from "./document/line-index.js";
 // Scope-aware completion over a SqlDocument — the broken-input editor feature (keywords + schema
 // tables/columns + function names at the caret). Total: never throws.
 export { complete, completeAt } from "./completion/complete.js";
+// The NEUTRAL half of jinja completion: which call + arg slot the caret sits in inside a jinja tag
+// (`{{ ref('cu│` → { callee: "ref", argIndex: 0, prefix: "cu" }). Carries no dbt vocabulary; a
+// consumer maps callee + argIndex to a role and supplies candidates. Reuses the parsed tags.
+export { jinjaSlotAt } from "./completion/jinja-slot.js";
 // Signature help over a SqlDocument — the broken-input editor feature that shows parameter hints
-// while typing inside a call's parens. Lookup order: curated (hand-verified) → harvested (doc-derived
-// long tail, from tools/harvest-signatures.mjs) → name-only fallback. A pure token scan; never throws.
+// while typing inside a call's parens. SIGNATURES is the merged per-dialect table (curated overrides
+// folded over the harvested doc-derived long tail at generation time, tools/harvest-signatures.mjs);
+// a name maps to an overload SET (readonly FnSignature[]), not a single shape: it is common for a
+// builtin to be overloaded on argument type or arity. An unknown name degrades to a one-entry
+// name-only fallback. A pure token scan; never throws.
 export { signatureAt } from "./signature/signature.js";
-export { FUNCTION_SIGNATURES, HARVESTED_SIGNATURES, lookupSignature, hasSignature, } from "./signature/signatures.js";
+export { SIGNATURES, lookupSignature, hasSignature } from "./signature/signatures.js";
+export { renderSignature } from "./signature/render.js";
+export { FN_DOCS, lookupFnDoc } from "./signature/docs.js";
 // References / occurrence engine — find the declaration + every occurrence of the symbol under a
 // cursor offset. The core primitive behind LSP references / documentHighlight / codeLens / rename.
 // Total: never throws; returns null off-symbol.
@@ -228,4 +237,4 @@ export { DERIVED_DIALECTS, resolveDialect } from "./derived-dialects.js";
 // The dialect-true identifier fold — the identity key for name comparison (unquote + case-fold per
 // the dialect's documented rules) and its display twin (unquote only). Exported so an embedding
 // consumer comparing names against IR/scope output folds the same way the pipeline does.
-export { foldIdentifier, displayName } from "./ident/fold.js";
+export { foldIdentifier, displayName } from "./dialect-behavior/public-fold.js";

package/dist/bigquery/behavior.d.ts

@@ -0,0 +1,2 @@
+import type { DialectBehavior } from "../dialect-behavior/behavior.js";
+export declare const bigqueryBehavior: DialectBehavior;

package/dist/bigquery/behavior.js

@@ -0,0 +1,20 @@
+import { acceptsFor } from "../dialect-behavior/coerce-rules.js";
+import { likePatternToRegExp } from "../scope/like-pattern.js";
+import { SIGNATURES } from "../signature/signatures.js";
+import { displayName, fold, foldTableName, matchesSourceKey } from "./fold.js";
+import { bigqueryLiteral, bigqueryParseType, bigquerySpecial, BIGQUERY_FUNCTION_RETURNS } from "./infer.js";
+export const bigqueryBehavior = {
+    fold,
+    displayName,
+    foldTableName,
+    matchesSourceKey,
+    likeMatch: (pattern, value) => likePatternToRegExp(pattern).test(value),
+    literal: bigqueryLiteral,
+    parseType: bigqueryParseType,
+    functions: BIGQUERY_FUNCTION_RETURNS,
+    division: "float",
+    special: bigquerySpecial,
+    signatures: SIGNATURES.bigquery,
+    // BigQuery implicit coercion: no STRING->NUMBER coercion, no BOOL<->NUMBER coercion (STR_TO_NUM=false, BOOL_NUM=false).
+    accepts: (argType, paramText) => acceptsFor(bigqueryParseType, false, false, argType, paramText),
+};

package/dist/bigquery/dot-path.d.ts

@@ -1,5 +1,4 @@
 import { type Lexer, ListTokenSource } from "antlr4ng";
-import { GoogleSQLLexer } from "../generated/bigquery/GoogleSQLLexer.js";
 import type { SyntaxDiagnostic } from "../parse-diagnostics.js";
 /**
  * Lex `sql` and return a token source with the DOT_IDENTIFIER rewrite applied, plus positioned
@@ -11,4 +10,3 @@ export declare function dotPathTokenSource(sql: string, lexer: Lexer): {
     source: ListTokenSource;
     escapeDiagnostics: SyntaxDiagnostic[];
 };
-export { GoogleSQLLexer };

package/dist/bigquery/dot-path.js

@@ -365,4 +365,3 @@ export function dotPathTokenSource(sql, lexer) {
     const tokens = lexer.getAllTokens(); // full lex (drives lexer error listeners); EOF excluded
     return { source: new ListTokenSource(rewriteDotPaths(tokens)), escapeDiagnostics: badLiteralEscapes(tokens) };
 }
-export { GoogleSQLLexer };

package/dist/bigquery/fn-docs.generated.d.ts

@@ -0,0 +1,2 @@
+import type { FnDoc } from "../signature/docs.js";
+export declare const BIGQUERY_FN_DOCS: Record<string, FnDoc>;