@youtyan/code-viewer 0.2.11 → 0.4.0

package/README.md

@@ -14,6 +14,12 @@ Requires Node.js 20 or newer when installed from npm. Development uses
   pills" that copy `@path#start-end` for AI agents.
 - Browse commit history per branch and open any commit's changed files and
   diff, with shareable `/history?ref=<branch>&commit=<sha>` links.
+- Open per-file Blame and History tabs on a file detail page (GitHub-style):
+  Blame groups consecutive lines from the same commit with an Older→Newer
+  colour bar and lets you jump to the originating commit; History embeds the
+  same commit list and diff renderer used by `/history` inside the file's
+  tab shell, filtered to that path. Both tabs keep the Repository sidebar
+  visible.
 - Open files directly from the repository or diff view, including large
   generated files (virtualized source viewer with copy/open-full-view).
 - Preview Markdown with a table of contents, task lists, Mermaid diagrams
@@ -111,6 +117,15 @@ resolved inside the repository, code blocks are highlighted with Shiki, and
 Mermaid diagrams are rendered lazily in the browser (click any diagram to
 open it in a lightbox).
 
+A file detail page lays out four tabs — **Preview**, **Code**, **Blame**,
+**History** — modelled after the GitHub file view. `Code` is the default and
+`?preview=1` opts in to the Markdown / media preview. `Blame` and `History`
+each have their own canonical URL (`view=blame`, `view=history`), so deep
+links and the browser back/forward stay in sync. The Blame tab reuses the
+source view's row component, so line numbers, drag-selection of `line=`
+ranges, syntax highlighting and the Viewer Settings code font size all match
+the Code tab.
+
 Very large text files use a virtualized source viewer. Only visible rows are
 rendered, and the page includes controls to copy the full file or reopen it in
 the full non-virtual view.
@@ -178,26 +193,36 @@ Services whose names collide across subdirectories are kept distinct via
 `docker:<service>@<relDir>` ids (cwd-direct compose files keep the historical
 `docker:<service>` id for backward compatibility).
 
-**Redis** support is read-only: browse DB 0–15, SCAN keys, and view values per
-type (string/hash/list as dedicated panes, set/zset/stream as JSON views). It
-also participates in snapshots and diffs.
+**Redis** support: browse DB 0–15, SCAN keys, and view values per
+type (string/hash/list as dedicated panes, set/zset/stream as JSON views).
+Edit values, delete keys, and create new keys (string/hash/list/set/zset/stream)
+with confirmation dialogs. It also participates in snapshots and diffs.
 
-**Elasticsearch** support is read-only: list indices, view mappings, paginate
+**Elasticsearch** support: list indices, view mappings, paginate
 docs with `search_after`, run lucene `q=` searches, and submit DSL queries to a
 small allowlist of `_search` / `_count` / `_msearch` / `_explain` /
-`_validate` / `_field_caps` / `_eql`. Snapshots and diffs over `_search`
-iteration are supported.
+`_validate` / `_field_caps` / `_eql`. Edit documents (with optimistic
+concurrency via `_seq_no` / `_primary_term`), create new documents, and delete
+existing ones. Snapshots and diffs over `_search` iteration are supported.
 
-**S3-compatible object storage** (MinIO, LocalStack) is read-only: browse
+**S3-compatible object storage** (MinIO, LocalStack): browse
 buckets as a folder tree, search by prefix or filename, sort scanned objects by
 update time, and preview images, video, audio, PDFs, Markdown, HTML, and text
-files. Updated-time sorting is scoped to the objects scanned for the current
-prefix/search rather than a persistent whole-bucket index. HTML previews are
-rendered in a sandboxed `srcdoc` iframe; relative subresources inside the HTML
-are not rewritten. **LocalStack** falls back to `docker exec <container> curl`
-against the container-local endpoint when the service does not publish a host
-port; **MinIO** requires a published host port (add a `9000:9000` mapping) and
-will refuse to browse otherwise.
+files. Edit text/markdown/JSON object bodies inline, upload new objects to any
+prefix, and delete existing objects. Updated-time sorting is scoped to the
+objects scanned for the current prefix/search rather than a persistent
+whole-bucket index. HTML previews are rendered in a sandboxed `srcdoc` iframe;
+relative subresources inside the HTML are not rewritten. **LocalStack** falls
+back to `docker exec <container> curl` against the container-local endpoint
+when the service does not publish a host port; **MinIO** requires a published
+host port (add a `9000:9000` mapping) and will refuse to browse otherwise.
+
+**SQL row editing** (SQLite / PostgreSQL / MySQL): toggle an Edit mode on the
+table grid to insert, update, or delete rows inline. Edits queue as pending
+changes (shown with a yellow highlight on the affected row/cell) and are
+applied as a single transaction on commit. Row updates and deletes require the
+table to have a primary key. The whole batch rolls back on the first
+constraint violation.
 
 ### Browser UI
 
@@ -211,11 +236,19 @@ Open Datastores in the global navigation to access:
   the database.
 - **Table browser** — paginated data grid with column sort, text filter, cell
   copy, and CSV/JSON export (capped at 100,000 rows; export respects current
-  filter/sort).
+  filter/sort). Double-click a cell to edit inline when Edit mode is on; the
+  whole pending edit batch commits atomically.
 - **Detail footer and related panel** — click any cell to open a resizable
   detail footer; foreign-key cells open a related panel showing the
   referenced or referencing rows, with multi-step drill-down breadcrumbs.
   Cells that match the focused row are highlighted in both panels.
+- **Footer dock with Query History & Session log** — JetBrains-style bottom
+  dock that hosts two tabs: the per-database **Query History** (master/detail
+  list of saved queries, SSE-synced across tabs) and a **Session log** that
+  records every SQL the server runs in this browser session (read fetches,
+  user queries, and write commits) with timing, row counts, and the actual
+  executed SQL syntax-highlighted with shiki. Auto-follow keeps the newest
+  entry pinned; scroll up to pause.
 - **Rails FK inference toggle** — opt-in heuristic that adds virtual foreign
   keys following Rails naming conventions (e.g. `user_id → users.id`) on top
   of the database-declared FKs.
@@ -227,16 +260,20 @@ Open Datastores in the global navigation to access:
   whether each entry came from the browser or the CLI.
 - **ER diagram** — auto-generated entity-relationship diagram showing
   foreign-key relationships between tables.
-- **Schema view** — table columns, indexes, foreign keys, triggers, and DDL.
+- **Schema view** — table columns (with column comments when the database
+  defines them), indexes, foreign keys, triggers, and DDL. Tables themselves
+  surface a comment column on the database table list.
 - **Global search** — full-text search across all tables and text columns of
   a database.
 - **Snapshots and diffs** — take point-in-time snapshots of selected tables
   (or Redis key spaces, or Elasticsearch indices) and compare any two
   snapshots to see inserted, updated, and deleted rows with full before/after
   values.
-- **Datastore explorers** — first-class sidebars for Redis (DB / SCAN), 
+- **Datastore explorers** — first-class sidebars for Redis (DB / SCAN),
   Elasticsearch (indices / mappings / docs), and S3 (folder tree, kind
-  badges) so the same Multi-DB tab UI works for non-SQL stores too.
+  badges) so the same Multi-DB tab UI works for non-SQL stores too. Each
+  explorer supports value editing / document creation / object upload /
+  deletion via in-line panes and confirmation dialogs.
 
 ### CLI