sqlite-hub 0.11.1 → 0.16.0

package/README.md

@@ -13,11 +13,16 @@ Many database tools are powerful, but feel oversized when all you want is to ins
 SQLite Hub keeps that workflow sharp:
 
 - browse tables and rows
-- inspect schema and structure
-- edit records in place
-- export tables and query results as CSV
+- filter, sort, page through, and export table data
+- inspect schema, structure, and relationships
+- edit records in place with an SQL diff preview before saving
+- export tables and query results as CSV, TSV, Markdown, or duplicate them as a table
+- copy result columns with formatting, headers, first-10 previews, TXT export, and Markdown todo export
+- switch between recent databases with sidebar quick picks
 - create simple local backups of the active database
-- run SQL in a syntax-highlighted editor
+- run and format SQL in a syntax-highlighted editor with history, messages, and performance metrics
+- turn query-history results into local charts
+- create and edit tables with a live SQL preview
 - stay local and move fast
 
 ## Features
@@ -26,25 +31,59 @@ SQLite Hub keeps that workflow sharp:
 
 ![](./frontend/assets/mockups/structure.png)
 
-Inspect tables, columns, types, and schema details without losing pace. Visualized in a graph.
+Inspect tables, columns, types, indexes, foreign keys, and schema details without losing pace. The graph view visualizes relationships, the table list is searchable, and SQLite Hub remembers the last selected table while you move between views.
 
 ### Data browser
 
 ![](./frontend/assets/mockups/data.png)
 
-Scan rows, sort fast, move through local data quickly, and export full tables as CSV.
+Scan rows, sort fast, move through local data quickly, and export full tables as CSV, TSV, or Markdown. The Data browser also supports duplicating exports as a new table, table search, page sizes up to 250 rows, and advanced filters with column/operator/value controls. Text filters support case-insensitive `contains`, `not contains`, and exact `equals` matching.
 
 ### Row editing
 
 ![](./frontend/assets/mockups/data_row_editor.png)
 
-Open one record, edit it in place, commit, continue.
+Open one record, edit it in place, preview the SQL diff, then commit. SQLite Hub only enables row edits when it can target a stable row identity safely.
 
 ### SQL editor
 
 ![](./frontend/assets/mockups/sql_editor.png)
 
-Write queries in a syntax-highlighted editor, inspect results in the same workflow, and export result sets as CSV.
+Write queries in a syntax-highlighted editor, format SQL with the editor Format button, inspect results in the same workflow, and export result sets as CSV, TSV, Markdown, or duplicate them as a table. Query drafts survive reloads, query history can be searched and saved, and direct single-table `SELECT` results can be edited from the result grid.
+
+Result column menus include copy actions for a full column, a column with header, or the first 10 values. The same modal can preview the output, copy it, export it as TXT, or turn a column into Markdown todo items.
+
+The bottom panel keeps separate tabs for:
+
+- Results
+- Performance, including execution time, statement count, returned rows, affected rows, and serialized result memory size
+- Messages, including the executed query and statement updates/errors
+
+Potentially destructive statements are tracked in query history, and SQLite Hub keeps the active result tab instead of forcing you back to Results after every execution.
+
+### Query history
+
+SQLite Hub stores query history per database. You can search SQL, titles, and notes; mark useful queries as saved; re-run previous queries; and execute saved queries from the CLI.
+
+### Charts
+
+Create charts from chartable `SELECT` query-history entries. Charts can be saved per query, reopened later, and rendered from live query results.
+
+### Table Designer
+
+Create and edit SQLite tables from the UI. The Table Designer includes a searchable table list, column controls, CSV import drafting, and a live SQL preview that can be hidden or shown.
+
+### Media Tagging
+
+Configure a media table, tag table, and mapping table, then work through a tagging queue for image, video, and audio assets. The workflow supports preview controls, skipped items, parent tags, and applying selected tags to the current media row.
+
+### UI preferences
+
+SQLite Hub remembers common workspace preferences in local storage, including hidden panels, selected editor tabs, query drafts, chart panels, table row size, and Table Designer preview visibility.
+
+### Database quick picks
+
+The active database footer in the sidebar opens a quick-pick panel with the five most recent databases, so you can switch databases without going back to the Connections view.
 
 ### Simple backups
 
@@ -69,7 +108,7 @@ brew install sqlite-hub
 npm install -g sqlite-hub
 ```
 
-## alternative port
+## Alternative port
 
 ```bash
 sqlite-hub --port:4174
@@ -132,7 +171,7 @@ sqlite-hub --database:Unit-00 --sqleditor
 Execute a specific saved query by name:
 
 ```bash
-sqlite-hub --database:Unit-00 --sqleditor:"15min Posting Buckets withoud id 96"
+sqlite-hub --database:Unit-00 --sqleditor:"15min Posting Buckets without id 96"
 ```
 
 This searches the query history for the given database, finds the matching saved query by title, executes it, and returns all results with metadata (row count, columns, timing, and data).
@@ -152,7 +191,7 @@ This searches the query history for the given database, finds the matching saved
 | `--database:name --sqleditor`         | List all saved queries for a database |
 | `--database:name --sqleditor:"query"` | Execute a saved query by name         |
 
-### sqleditor
+### SQL editor CLI example
 
 ![](/frontend/assets/mockups/sql_editor_croped.png)
 
@@ -162,7 +201,7 @@ In the screenshot above, you can see a saved query from the SQL editor. You can
 sqlite-hub --database:Unit-00 --sqleditor:"Group by creation Year"
 ```
 
-which returns
+Example output:
 
 ```bash
 Executing: Group by creation Year
@@ -184,4 +223,4 @@ Results:
 
 ## Changelog
 
-[Changelog](/changelog.md)
+[Changelog](./docs/changelog.md)

package/frontend/js/api.js

@@ -46,7 +46,7 @@ async function download(path, options = {}) {
   const blob = await response.blob();
   const disposition = response.headers.get("content-disposition") ?? "";
   const match = disposition.match(/filename="([^"]+)"/i);
-  const filename = match?.[1] ?? options.fallbackFilename ?? "export.csv";
+  const filename = String(options.filename ?? "").trim() || match?.[1] || options.fallbackFilename || "export.csv";
   const url = URL.createObjectURL(blob);
   const link = document.createElement("a");
 
@@ -419,22 +419,74 @@ export function patchSettings(settings) {
   });
 }
 
-export function downloadQueryCsv(sql) {
-  return download("/api/export/query.csv", {
+const TEXT_EXPORT_EXTENSIONS = {
+  csv: "csv",
+  tsv: "tsv",
+  md: "md",
+};
+
+function normalizeTextExportFormat(format) {
+  const normalized = String(format ?? "csv").toLowerCase();
+  return TEXT_EXPORT_EXTENSIONS[normalized] ? normalized : "csv";
+}
+
+export function getQueryExport(sql, format = "csv") {
+  return request("/api/export/query", {
+    method: "POST",
+    body: {
+      sql,
+      format: normalizeTextExportFormat(format),
+    },
+  });
+}
+
+export function downloadQueryExport(sql, format = "csv", options = {}) {
+  const normalizedFormat = normalizeTextExportFormat(format);
+  const extension = TEXT_EXPORT_EXTENSIONS[normalizedFormat];
+
+  return download(`/api/export/query.${extension}`, {
     method: "POST",
     body: { sql },
-    fallbackFilename: "query-results.csv",
+    fallbackFilename: `query-results.${extension}`,
+    filename: options.filename,
   });
 }
 
-export function downloadTableCsv(tableName, options = {}) {
-  return download("/api/export/table.csv", {
+export function downloadQueryCsv(sql) {
+  return downloadQueryExport(sql, "csv");
+}
+
+function buildTableExportBody(tableName, options = {}) {
+  return {
+    tableName,
+    sortColumn: options.sortColumn,
+    sortDirection: options.sortDirection,
+    filterColumn: options.filterColumn,
+    filterOperator: options.filterOperator,
+    filterValue: options.filterValue,
+    format: normalizeTextExportFormat(options.format),
+  };
+}
+
+export function getTableExport(tableName, options = {}) {
+  return request("/api/export/table", {
     method: "POST",
-    body: {
-      tableName,
-      sortColumn: options.sortColumn,
-      sortDirection: options.sortDirection,
-    },
-    fallbackFilename: `${tableName || "table"}.csv`,
+    body: buildTableExportBody(tableName, options),
   });
 }
+
+export function downloadTableExport(tableName, options = {}) {
+  const normalizedFormat = normalizeTextExportFormat(options.format);
+  const extension = TEXT_EXPORT_EXTENSIONS[normalizedFormat];
+
+  return download(`/api/export/table.${extension}`, {
+    method: "POST",
+    body: buildTableExportBody(tableName, { ...options, format: normalizedFormat }),
+    fallbackFilename: `${tableName || "table"}.${extension}`,
+    filename: options.filename,
+  });
+}
+
+export function downloadTableCsv(tableName, options = {}) {
+  return downloadTableExport(tableName, { ...options, format: "csv" });
+}