Release 0.4.13

CHANGELOG.md

@@ -7,6 +7,34 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.13] - 2026-08-25
+
+Production-ready UI polish, complete interactive Data Grid editing suite, advanced query filtering, fluid collapsible navigation, and platform hardening.
+
+### Added
+
+- **In-Place Cell Editing & Staging Engine (#560, #561, #564, #565)** — Double-click cell to edit in-place with type-aware inline editors, dirty state indicators, staging buffer for staged mutations (inserts/updates/deletions), and keyboard navigation (Tab/Shift+Tab, Enter, Escape).
+- **Atomic DML Preview & Multi-Dialect Generation (#562, #566)** — Visual DML confirmation modal displaying compiled atomic `UPDATE`, `INSERT`, and `DELETE` statements with primary key resolution before committing to SQLite, PostgreSQL, and MySQL.
+- **In-Cell Validation & Safety Guardrails (#567)** — Real-time cell validation for integer, float, boolean, UUID, JSON, date, and timestamp data types with visual error cues.
+- **Advanced Query Filter Engine (#568, #569, #570)** — Compound predicate filter bar with `AND`, `OR`, `NOT`, parentheses, `LIKE`, `ILIKE`, `IN`, `IS NULL`, `BETWEEN`, escaped quotes, and intelligent popup autocomplete suggestions.
+- **Syntax Highlighting & Value Inspector (#571, #572)** — Dedicated inspector panel with syntax highlighting for JSON, XML, YAML, and automated XML/HTML formatting and validation.
+- **Selection Statistics & Quick Calc (#573)** — Extended selection calculations in the status bar (Count, Distinct, Sum, Avg, Min, Max, Median, Standard Deviation) with one-click clipboard summary export.
+- **Multi-Column Grouping & Pivot View (#574, #575, #576)** — Hierarchical multi-level grouping, custom aggregations (SUM, AVG, MIN, MAX, COUNT), sorting, and CSV export for grouped summaries.
+- **Column Drag-Resizing & 3-Phase Sorting (#548, #549)** — Interactive column width drag-resizing with divider handles and 3-phase client-side sorting (`natural` -> `asc` -> `desc`).
+- **Multi-Cell Range Selection & Clipboard (#550)** — Rectangular multi-cell selection (Shift+Click) with TSV/CSV clipboard copy for Excel/Google Sheets.
+- **Fluid Collapsible Sidebar (#557, #559)** — Physics-driven animated sidebar toggle with `QueryaSpring`, global `Cmd+B` / `Ctrl+B` hotkey, titlebar toggle button, and width persistence.
+- **Rich Object Context Menus (#551)** — Right-click native context menus for database tables, views, procedures, and connections (*«Select TOP 100»*, *«Copy SELECT statement»*, *«Copy name»*, *«Open in SQL»*).
+- **Tree Keyboard Navigation (#552)** — Full arrow-key navigation (Left/Right to expand/collapse, Up/Down, Enter/Space) across database trees.
+- **Interactive Welcome Tour & 1-Click Playground (#558)** — Built-in onboarding tour and 1-click SQLite demo database playground.
+- **Global Shortcuts & Focus Polish (#579)** — Added global shortcuts (`Ctrl+F` for filter bar, `Ctrl+S` for staging commit, `Ctrl+G` for groupings panel) and enhanced focus accessibility.
+
+### Fixed
+
+- **Connection Dialogs Inline Validation (#553)** — Real-time URI parser and validation with dynamic database driver and host badges.
+- **Toolbar Layout Responsive Scroll (#577)** — Wrapped data grid action bars in horizontal scroll to eliminate overflow on compact viewports.
+- **macOS SPM Path (#555)** — Corrected relative path to `refresh_rate` plugin source in `Package.swift` for Swift Package Manager builds.
+- **macOS App Sandbox Entitlements (#556)** — Added `network.client` and `files.user-selected.read-write` entitlements for outbound TCP connections and local file access.
+
 ## [0.4.11-c] - 2026-07-29
 
 Flutter SDK & dependency compatibility update, image downsampling memory optimization, and UI polish.

analysis_options.yaml

@@ -4,6 +4,12 @@ analyzer:
   exclude:
     - "third_party/**"
     - "build/**"
+    - android/**
+    - ios/**
+    - web/**
+    - windows/**
+    - macos/**
+    - linux/**
   errors:
     unnecessary_underscores: ignore
     prefer_initializing_formals: ignore

lib/core/actions/sql_editor_command_bridge.dart

@@ -1,6 +1,6 @@
 import 'package:flutter/foundation.dart';
 
-enum SqlEditorPendingAction { none, newQuery, openFile, saveFile }
+enum SqlEditorPendingAction { none, newQuery, openFile, saveFile, executeQuery }
 
 /// Lets the active SQL workspace handle File menu commands when menu focus is
 /// outside the editor subtree (e.g. title bar).
@@ -13,21 +13,25 @@ class SqlEditorCommandBridge {
   VoidCallback? _onNew;
   VoidCallback? _onOpen;
   VoidCallback? _onSave;
+  VoidCallback? _onExecute;
 
   SqlEditorPendingAction pendingAction = SqlEditorPendingAction.none;
 
   bool get isActive => _onNew != null;
+  bool get canExecute => _onExecute != null;
 
   void register({
     required int? connectionId,
     required VoidCallback onNew,
     required VoidCallback onOpen,
     required VoidCallback onSave,
+    VoidCallback? onExecute,
   }) {
     _ownerConnectionId = connectionId;
     _onNew = onNew;
     _onOpen = onOpen;
     _onSave = onSave;
+    _onExecute = onExecute;
     _flushPending();
   }
 
@@ -37,6 +41,7 @@ class SqlEditorCommandBridge {
     _onNew = null;
     _onOpen = null;
     _onSave = null;
+    _onExecute = null;
   }
 
   void queuePending(SqlEditorPendingAction action) {
@@ -67,6 +72,14 @@ class SqlEditorCommandBridge {
     pendingAction = SqlEditorPendingAction.saveFile;
   }
 
+  void invokeExecute() {
+    if (_onExecute != null) {
+      _onExecute!();
+      return;
+    }
+    pendingAction = SqlEditorPendingAction.executeQuery;
+  }
+
   void _flushPending() {
     final action = pendingAction;
     if (action == SqlEditorPendingAction.none) return;
@@ -81,6 +94,8 @@ class SqlEditorCommandBridge {
         _onOpen?.call();
       case SqlEditorPendingAction.saveFile:
         _onSave?.call();
+      case SqlEditorPendingAction.executeQuery:
+        _onExecute?.call();
     }
   }
 
@@ -90,6 +105,7 @@ class SqlEditorCommandBridge {
     _onNew = null;
     _onOpen = null;
     _onSave = null;
+    _onExecute = null;
     pendingAction = SqlEditorPendingAction.none;
   }
 }

lib/core/database/connection_pool_lock.dart

@@ -20,21 +20,26 @@ class PoolEntryLock<T> {
     }
     final completer = Completer<void>();
     _lock = completer.future;
+    Future<T> result;
     try {
       final existing = _pending[key];
-      if (existing != null) return existing;
-      final future = create();
-      _pending[key] = future;
-      // Ensure the pending entry is removed once the creation finishes, and
-      // swallow errors on the cleanup chain so they don't become unhandled.
-      final guarded = future.whenComplete(() => _pending.remove(key));
-      guarded.then((_) {}, onError: (_) {});
-      return future;
+      if (existing != null) {
+        result = existing;
+      } else {
+        final future = create();
+        _pending[key] = future;
+        // Ensure the pending entry is removed once the creation finishes, and
+        // swallow errors on the cleanup chain so they don't become unhandled.
+        final guarded = future.whenComplete(() => _pending.remove(key));
+        guarded.then((_) {}, onError: (_) {});
+        result = future;
+      }
     } finally {
       completer.complete();
       if (_lock == completer.future) {
         _lock = null;
       }
     }
+    return result;
   }
 }

lib/core/database/mysql_connection.dart

@@ -2,6 +2,7 @@ import 'dart:async';
 
 import 'package:flutter/foundation.dart';
 import 'package:mysql_client/mysql_client.dart';
+import 'package:querya_desktop/core/database/table_schema_meta.dart';
 import 'package:querya_desktop/core/storage/local_db.dart';
 import 'package:querya_desktop/features/connections/ssl_certificate_support.dart';
 
@@ -349,6 +350,76 @@ class MysqlConnection {
     return rs.rows.map((r) => r.colAt(0)!).toList();
   }
 
+  /// Retrieves schema metadata and primary keys for [table] in [database].
+  Future<TableSchemaMeta> getTableSchema({
+    required String database,
+    required String table,
+  }) async {
+    if (!isConnected || _conn == null) {
+      throw StateError('Not connected to MySQL');
+    }
+    final colsRs = await execute(
+      'SELECT COLUMN_NAME, DATA_TYPE, IS_NULLABLE, COLUMN_DEFAULT '
+      'FROM information_schema.COLUMNS '
+      'WHERE TABLE_SCHEMA = :database AND TABLE_NAME = :table '
+      'ORDER BY ORDINAL_POSITION',
+      {
+        'database': database,
+        'table': table,
+      },
+    );
+
+    final pkRs = await execute(
+      'SELECT COLUMN_NAME '
+      'FROM information_schema.KEY_COLUMN_USAGE '
+      "WHERE CONSTRAINT_NAME = 'PRIMARY' AND TABLE_SCHEMA = :database AND TABLE_NAME = :table "
+      'ORDER BY ORDINAL_POSITION',
+      {
+        'database': database,
+        'table': table,
+      },
+    );
+
+    final primaryKeys = pkRs.rows.map((r) => r.colAt(0)!).toList();
+    final columns = <TableColumnMeta>[];
+
+    for (final r in colsRs.rows) {
+      final name = r.colByName('COLUMN_NAME') ?? '';
+      final dataType = r.colByName('DATA_TYPE') ?? '';
+      final isNullable = (r.colByName('IS_NULLABLE') ?? 'YES').toUpperCase() == 'YES';
+      final isPk = primaryKeys.contains(name);
+      final pkPos = isPk ? primaryKeys.indexOf(name) + 1 : null;
+      final dflt = r.colByName('COLUMN_DEFAULT');
+
+      columns.add(
+        TableColumnMeta(
+          name: name,
+          dataType: dataType,
+          isNullable: isNullable,
+          isPrimaryKey: isPk,
+          primaryKeyPosition: pkPos,
+          defaultValue: dflt,
+        ),
+      );
+    }
+
+    return TableSchemaMeta(
+      tableName: table,
+      schema: database,
+      columns: columns,
+      primaryKeys: primaryKeys,
+    );
+  }
+
+  /// Returns primary key column names for [table] in [database].
+  Future<List<String>> getPrimaryKeys({
+    required String database,
+    required String table,
+  }) async {
+    final schema = await getTableSchema(database: database, table: table);
+    return schema.primaryKeys;
+  }
+
   /// Lists base tables in [schema] (MySQL: database name).
   Future<List<String>> listTables({required String schema}) async {
     if (!isConnected || _conn == null) {

lib/core/database/postgres_connection.dart

@@ -9,6 +9,7 @@ import 'package:querya_desktop/core/storage/local_db.dart';
 import 'package:postgres/src/connection_string.dart' show parseConnectionString;
 
 import 'postgres_metadata.dart';
+import 'table_schema_meta.dart';
 
 /// Replaces the database in a `postgresql://` / `postgres://` URI (path or
 /// `database=` query param). Used when switching DB while keeping URI auth/SSL.
@@ -329,6 +330,79 @@ class PostgresConnection {
     return result.map((row) => row[0] as String).toList();
   }
 
+  /// Retrieves schema metadata and primary keys for [table] in [schema].
+  Future<TableSchemaMeta> getTableSchema({
+    String schema = 'public',
+    required String table,
+  }) async {
+    if (!isConnected || _conn == null) {
+      throw StateError('Not connected to PostgreSQL');
+    }
+    final colsRs = await _conn!.execute(
+      Sql.named(
+        'SELECT column_name, data_type, is_nullable, column_default '
+        'FROM information_schema.columns '
+        'WHERE table_schema = @schema AND table_name = @table '
+        'ORDER BY ordinal_position',
+      ),
+      parameters: {'schema': schema, 'table': table},
+    );
+
+    final pkRs = await _conn!.execute(
+      Sql.named(
+        'SELECT kcu.column_name '
+        'FROM information_schema.table_constraints tc '
+        'JOIN information_schema.key_column_usage kcu '
+        '  ON tc.constraint_name = kcu.constraint_name '
+        ' AND tc.table_schema = kcu.table_schema '
+        "WHERE tc.constraint_type = 'PRIMARY KEY' "
+        '  AND tc.table_schema = @schema '
+        '  AND tc.table_name = @table '
+        'ORDER BY kcu.ordinal_position',
+      ),
+      parameters: {'schema': schema, 'table': table},
+    );
+
+    final primaryKeys = pkRs.map((r) => r[0] as String).toList();
+    final columns = <TableColumnMeta>[];
+
+    for (final r in colsRs) {
+      final name = r[0] as String? ?? '';
+      final dataType = r[1] as String? ?? '';
+      final isNullable = (r[2] as String? ?? 'YES').toUpperCase() == 'YES';
+      final isPk = primaryKeys.contains(name);
+      final pkPos = isPk ? primaryKeys.indexOf(name) + 1 : null;
+      final dflt = r[3]?.toString();
+
+      columns.add(
+        TableColumnMeta(
+          name: name,
+          dataType: dataType,
+          isNullable: isNullable,
+          isPrimaryKey: isPk,
+          primaryKeyPosition: pkPos,
+          defaultValue: dflt,
+        ),
+      );
+    }
+
+    return TableSchemaMeta(
+      tableName: table,
+      schema: schema,
+      columns: columns,
+      primaryKeys: primaryKeys,
+    );
+  }
+
+  /// Returns primary key column names for [table] in [schema].
+  Future<List<String>> getPrimaryKeys({
+    String schema = 'public',
+    required String table,
+  }) async {
+    final s = await getTableSchema(schema: schema, table: table);
+    return s.primaryKeys;
+  }
+
   Future<List<String>> listViews({String schema = 'public'}) async {
     if (!isConnected || _conn == null) {
       throw StateError('Not connected to PostgreSQL');

lib/core/database/sql_table_target_extractor.dart

@@ -0,0 +1,52 @@
+/// Result of extracting target table and schema from an SQL query.
+class SqlTableTarget {
+  const SqlTableTarget({
+    required this.tableName,
+    this.schema,
+  });
+
+  final String tableName;
+  final String? schema;
+
+  @override
+  bool operator ==(Object other) =>
+      identical(this, other) ||
+      other is SqlTableTarget &&
+          tableName == other.tableName &&
+          schema == other.schema;
+
+  @override
+  int get hashCode => Object.hash(tableName, schema);
+}
+
+/// Helper utility to infer the primary target table from a simple SELECT query.
+abstract final class SqlTableTargetExtractor {
+  static final _fromTableRegex = RegExp(
+    r'\bfrom\s+(?:(?:"([^"]+)"|`([^`]+)`|([a-zA-Z_]\w*))\.)?(?:"([^"]+)"|`([^`]+)`|([a-zA-Z_]\w*))',
+    caseSensitive: false,
+  );
+
+  /// Extracts the target schema and table name from [sql].
+  /// Returns `null` if no simple target table can be determined (e.g. subqueries, joins).
+  static SqlTableTarget? extract(String sql) {
+    final trimmed = sql.trim();
+    if (trimmed.isEmpty) return null;
+
+    // If query has JOIN or multiple tables separated by comma, avoid auto-generating DML
+    final hasJoin = RegExp(r'\bjoin\b', caseSensitive: false).hasMatch(trimmed);
+    if (hasJoin) return null;
+
+    final match = _fromTableRegex.firstMatch(trimmed);
+    if (match == null) return null;
+
+    final schema = match.group(1) ?? match.group(2) ?? match.group(3);
+    final table = match.group(4) ?? match.group(5) ?? match.group(6);
+
+    if (table == null || table.isEmpty) return null;
+
+    return SqlTableTarget(
+      tableName: table,
+      schema: schema,
+    );
+  }
+}