snapshot of https://github.com/sqlc-dev/sqlc.git (main, 2026-09-16; blobs > 131072B omitted)

internal/sql/format/format.go

@@ -0,0 +1,23 @@
+package format
+
+// Dialect provides SQL dialect-specific formatting behavior
+type Dialect interface {
+	// QuoteIdent returns a quoted identifier if it needs quoting
+	// (e.g., reserved words, mixed case identifiers)
+	QuoteIdent(s string) string
+
+	// TypeName returns the SQL type name for the given namespace and name.
+	// This handles dialect-specific type name mappings (e.g., pg_catalog.int4 -> integer)
+	TypeName(ns, name string) string
+
+	// Param returns the placeholder for the parameter with this number.
+	// numbered reports that the author wrote the number out (SQLite's ?2,
+	// where a bare ? takes the next index), so engines with both forms can
+	// keep the one that was written.
+	// PostgreSQL uses $1, $2, etc. MySQL uses ?
+	Param(n int, numbered bool) string
+
+	// Cast formats a type cast expression.
+	// PostgreSQL uses expr::type, MySQL uses CAST(expr AS type)
+	Cast(arg, typeName string) string
+}