plsqlwks 0.2.1__tar.gz → 0.2.3__tar.gz

{plsqlwks-0.2.1 → plsqlwks-0.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plsqlwks
-Version: 0.2.1
+Version: 0.2.3
 Summary: An ncurses SQL and PL/SQL workspace for Oracle databases.
 Author: unu2000
 License-Expression: LicenseRef-plsqlwks-Donationware
@@ -533,7 +533,11 @@ After a successful quit, plsqlwks records the open file-backed tabs, active tab,
 Worksheet and configuration saves replace their destination atomically while
 preserving an existing file's POSIX permission bits. A
 file-backed worksheet also detects when its file was changed or deleted outside
-plsqlwks and asks whether to overwrite it, save under another name, or cancel.
+plsqlwks and asks whether to overwrite it, reload the disk version, save under
+another name, or cancel. Reload is available while the file exists, including
+when a change is detected just before saving. It replaces the editor text
+without writing to disk; Undo can restore local edits. If reading fails, the
+local buffer stays intact.
 Undo and redo update the unsaved-change marker by comparing the current content
 with the last successful save.
 
@@ -613,9 +617,11 @@ Use left Alt for application shortcuts; AltGr remains available for characters
 on international keyboards. Shortcut digits and symbols refer to the character
 on the active Windows layout: for example, Czech top-row digits need Shift,
 so Alt-1 is typed with Alt-Shift-1. Use the layout's `+` or `=` character for
-autocomplete refresh. `Ctrl-C`, `Ctrl-X`, and `Ctrl-V` operate on the
-application/host clipboard with the existing internal fallback. SSH does not
-make that the Windows clipboard. Use PuTTY's native paste (`Shift-Insert` or
+autocomplete refresh. Clipboard preferences choose application copy targets
+and paste sources; on a Linux SSH host the ordinary shortcuts default to the
+Linux clipboard. Ctrl-Shift-C copies internally and Ctrl-Shift-V defaults to
+internal paste. SSH does not expose the Windows clipboard to the host. Use
+PuTTY's native paste (`Shift-Insert` or
 right-click) to insert Windows clipboard text as bracketed paste, and PuTTY
 mouse selection to copy to Windows. Leave plsqlwks' Ctrl-letter shortcuts
 available to the server when customizing PuTTY clipboard settings.
@@ -680,6 +686,94 @@ Run `tools\windows_keys.cmd -SelfTest` to check the helper without enabling it.
 The original `powershell.exe -NoProfile -File .\tools\putty_keys.ps1` command
 also works from Command Prompt and continues to support PuTTY.
 
+### Windows Terminal and WSL clipboard shortcuts
+
+There are two main sources in WSL: plsqlwks' internal clipboard and the Windows
+clipboard. Linux desktop access uses Wayland/X11; WSLg can bridge Linux and
+Windows contents, so these are not necessarily three independent clipboards.
+
+Open **Alt-O → Preferences → Clipboard** to choose external copy destinations
+and the source of each paste shortcut. Save persists the choices in your
+workspace's `config.ini`; Cancel discards changes. Internal copy is always
+enabled. Capabilities / latest failure shows available readers/writers and the
+latest backend error without displaying clipboard contents.
+
+| Shortcut | Default on WSL/Windows |
+| --- | --- |
+| `Ctrl-C` | Copy internally and to Windows |
+| `Ctrl-Shift-C` | Copy internally only |
+| `Ctrl-V` | Paste from Windows |
+| `Ctrl-Shift-V` | Paste internally |
+
+`Ctrl-X` cuts using the ordinary copy destinations and remains one immediate
+Undo edit. `Ctrl-C` interrupts a running database operation first. These copy
+shortcuts work for editor selections, result cells/ranges, DBMS_OUTPUT
+selections and schema-browser object names. Existing paste-enabled prompts and
+cell editors honor both paste-source preferences. New workspaces without
+Windows tools default ordinary copy/paste to Linux; explicit settings always
+win, even if the selected backend is unavailable.
+
+```ini
+[clipboard]
+copy_to_windows = yes
+copy_to_linux = no
+ctrl_v_source = windows
+ctrl_shift_v_source = internal
+```
+
+Paste sources are `windows`, `internal`, or `linux`. Windows paste reads Windows
+exclusively: failure or empty contents causes no insertion and explicit
+feedback. Internal paste performs no OS access and cancels a pending paste for
+that target. Copy updates internal text immediately, then attempts every enabled
+external destination in a background worker. Windows copy tries PowerShell,
+then `clip.exe` on failure, and verifies contents by readback when a reader is
+available. Copy-only Windows access is labelled unverified. Each Linux provider
+is attempted when Linux copying is enabled. A Linux success does not conceal a
+Windows failure.
+
+Windows Terminal normally consumes all four shortcuts for its own copy/paste.
+To let plsqlwks receive them, open **Settings → Open JSON file** and add these
+entries to `actions`, keeping the other actions:
+
+```json
+{ "command": { "action": "sendInput", "input": "\u0003" }, "id": "User.PlsqlwksCopy" },
+{ "command": { "action": "sendInput", "input": "\u001b[99;6u" }, "id": "User.PlsqlwksInternalCopy" },
+{ "command": { "action": "sendInput", "input": "\u0016" }, "id": "User.PlsqlwksPaste" },
+{ "command": { "action": "sendInput", "input": "\u001b[118;6u" }, "id": "User.PlsqlwksAlternatePaste" }
+```
+
+Replace the existing copy/paste entries in `keybindings` with
+the entries below, keeping the other keybindings:
+
+```json
+{ "id": "User.PlsqlwksCopy", "keys": "ctrl+c" },
+{ "id": "User.PlsqlwksInternalCopy", "keys": "ctrl+shift+c" },
+{ "id": "User.PlsqlwksPaste", "keys": "ctrl+v" },
+{ "id": "User.PlsqlwksAlternatePaste", "keys": "ctrl+shift+v" }
+```
+
+This setting applies to every Windows Terminal profile and tab. Restart
+plsqlwks after upgrading and reopen Windows Terminal if it retains old bindings.
+The command menu offers equivalents when a terminal intercepts the shortcuts.
+The optional `tools/putty_keys.ps1` helper also forwards all four shortcuts when
+enabled for the active Windows terminal window.
+
+Keyboard navigation, resizing and dialogs remain available while clipboard
+commands run. Windows paste waits behind pending external copies. If you change
+the paste target's text, cursor, selection or active tab before it finishes, the
+pending paste is cancelled; repeated external paste requests for that target
+are ignored. Requests retain the settings in effect when submitted.
+
+For native Windows Terminal paste, wait until application copy reports that the
+Windows clipboard has been updated. Native paste reads the Windows clipboard
+independently and receives no internal fallback. Its bracketed paste payload is
+inserted directly without a second clipboard lookup.
+
+Windows Terminal's **Copy on select** setting can overwrite the clipboard when
+you select terminal text with the mouse. Turn it off if you want only explicit
+copy commands to change the Windows clipboard.
+See Microsoft's [send input action](https://learn.microsoft.com/en-us/windows/terminal/customize-settings/actions#send-input).
+
 ## Keys
 
 ### Global
@@ -742,19 +836,25 @@ also works from Command Prompt and continues to support PuTTY.
 | `Ctrl-U` | Uppercase selected SQL code |
 | `Ctrl-L` | Lowercase selected SQL code |
 | `Ctrl-C` | Copy selected text |
+| `Ctrl-Shift-C` | Copy selected text internally only |
 | `Ctrl-X` | Cut selected text |
 | `Ctrl-V` | Paste clipboard text, expanding each tab to two spaces |
+| `Ctrl-Shift-V` | Paste the alternate source (internal by default) |
 | Terminal paste | Paste text as one edit, expanding each tab to two spaces |
 | `Ctrl-Z` / `Ctrl-Y` | Undo / redo |
 | `Ctrl+=` | Reconnect |
 
 Use `/` on a line by itself after PL/SQL objects or anonymous blocks when running a script.
+With no selection, `F11` asks: **To run the whole buffer, press Enter. Esc cancels.**
+Press Enter to continue or Esc/Ctrl+C to cancel before bind prompts and execution.
+Executing selected text does not require this additional confirmation.
 Script execution reports statement progress as `n/total` and stops at the first
 failed statement while preserving earlier results. Scripts are sent directly to
 Oracle, not through SQL*Plus or SQLcl: client commands such as `PROMPT`, `SPOOL`,
 and `SET SERVEROUTPUT`, and `&`/`&&` substitution variables, are rejected before
 bind prompts or execution. Oracle SQL statements such as `SET TRANSACTION`
-remain supported.
+remain supported. A standalone `SET DEFINE OFF` line is accepted locally and
+omitted from database execution. It does not enable substitution variables.
 Execution and explain errors report mapped editor line and column diagnostics.
 The cursor moves only when the buffer still matches the source that was sent to
 Oracle; if it changed while the operation ran, the result warns about the stale
@@ -779,8 +879,8 @@ recorded as one undoable edit. `Ctrl-N` and `Ctrl-P` repeat the last search with
 its case setting, forward or backward with wraparound.
 
 Editor paste expands every tab character to two spaces and keeps multiline
-text in one undoable edit. This applies to `Ctrl-V` from either the system or
-internal clipboard and to native terminal paste while the editor is focused;
+text in one undoable edit. This applies to both configured paste shortcuts and
+to native terminal paste while the editor is focused;
 clipboard contents themselves are not changed. Native paste requires a
 terminal that supports the standard bracketed-paste protocol, with `Ctrl-V`
 remaining available as the fallback.
@@ -827,6 +927,7 @@ Read-only mode is a client-side guardrail that rejects statements which the SQL
 | `Ctrl-Home` / `Ctrl-End` | Move to the first/last result-grid row |
 | `F8` | Toggle result grid / row-detail output |
 | `Ctrl-C` | Copy one result cell immediately, or choose header handling for a rectangular selection |
+| `Ctrl-Shift-C` | Copy the same cell/range internally only |
 | `F10` | View or edit a mapped text cell in a ROWID-backed result |
 | `Enter` | Edit the selected ROWID-backed result cell when available |
 | `INS` | Prepare a draft insert row for ROWID-backed results |
@@ -1119,7 +1220,7 @@ Press `Enter` on a table or view to choose `Insert SELECT` (the default), `Load
 | `PageUp` / `PageDown` | Scroll cell text by page |
 | `Home` / `End` | Move to the first/last cell-viewer line |
 | `Ctrl-S` (editor) | Save the multiline edit |
-| `Ctrl-V` / terminal paste (editor) | Paste exact clipboard text as one undoable edit |
+| `Ctrl-V` / `Ctrl-Shift-V` / terminal paste (editor) | Paste exact clipboard text as one undoable edit |
 | `Enter` (editor) | Insert a newline |
 | `F10` / `Esc` / `Ctrl-Q` (editor) | Cancel the multiline edit |
 
@@ -1128,7 +1229,7 @@ Press `Enter` on a table or view to choose `Insert SELECT` (the default), `Load
 | Key | Action |
 | --- | --- |
 | Printable text | Type into prompts or filter picker options |
-| `Ctrl-V` / terminal paste | Paste single-line text; tabs are preserved and multiline text is rejected |
+| `Ctrl-V` / `Ctrl-Shift-V` / terminal paste | Paste single-line text; tabs are preserved and multiline text is rejected |
 | `Backspace` | Delete before the prompt cursor or picker filter |
 | `Enter` | Accept the prompt or selected picker item |
 | `Esc` / `Ctrl-Q` | Cancel the prompt or picker |
@@ -1189,9 +1290,13 @@ for the exact manifest, source layout, validation, replacement, and trust rules.
 Install `plugins/packages/table-ddl-export-0.1.1.plwgn` with
 `plsqlwks plugin install` and restart. **Alt-O -> Database -> Export table DDL**
 lets you choose a schema, filter table names as you type, select tables, and
-optionally remap them to another schema. It automatically includes related
+optionally remap them to another schema and prefix tables, indexes, constraints
+and triggers while updating static table references. It automatically includes related
 sequences and directly referencing packages, functions, procedures, and views, and follows
-required source-schema tables and views recursively. Definitions, constraints, indexes,
+required source-schema tables, views, SQL types and program units recursively.
+Unreadable type or program definitions become named destination prerequisites.
+Types retain their names; prefixed copies in the source schema reuse existing types.
+Definitions, constraints, indexes,
 foreign keys and triggers are ordered by creation dependencies in a new
 unsaved SQL tab for review. Generation activates that tab and focuses its editor.
 See the [selection keys and remapping details](doc/PLUGIN_CATALOG.md#table-ddl-export).

{plsqlwks-0.2.1 → plsqlwks-0.2.3}/README.md

@@ -499,7 +499,11 @@ After a successful quit, plsqlwks records the open file-backed tabs, active tab,
 Worksheet and configuration saves replace their destination atomically while
 preserving an existing file's POSIX permission bits. A
 file-backed worksheet also detects when its file was changed or deleted outside
-plsqlwks and asks whether to overwrite it, save under another name, or cancel.
+plsqlwks and asks whether to overwrite it, reload the disk version, save under
+another name, or cancel. Reload is available while the file exists, including
+when a change is detected just before saving. It replaces the editor text
+without writing to disk; Undo can restore local edits. If reading fails, the
+local buffer stays intact.
 Undo and redo update the unsaved-change marker by comparing the current content
 with the last successful save.
 
@@ -579,9 +583,11 @@ Use left Alt for application shortcuts; AltGr remains available for characters
 on international keyboards. Shortcut digits and symbols refer to the character
 on the active Windows layout: for example, Czech top-row digits need Shift,
 so Alt-1 is typed with Alt-Shift-1. Use the layout's `+` or `=` character for
-autocomplete refresh. `Ctrl-C`, `Ctrl-X`, and `Ctrl-V` operate on the
-application/host clipboard with the existing internal fallback. SSH does not
-make that the Windows clipboard. Use PuTTY's native paste (`Shift-Insert` or
+autocomplete refresh. Clipboard preferences choose application copy targets
+and paste sources; on a Linux SSH host the ordinary shortcuts default to the
+Linux clipboard. Ctrl-Shift-C copies internally and Ctrl-Shift-V defaults to
+internal paste. SSH does not expose the Windows clipboard to the host. Use
+PuTTY's native paste (`Shift-Insert` or
 right-click) to insert Windows clipboard text as bracketed paste, and PuTTY
 mouse selection to copy to Windows. Leave plsqlwks' Ctrl-letter shortcuts
 available to the server when customizing PuTTY clipboard settings.
@@ -646,6 +652,94 @@ Run `tools\windows_keys.cmd -SelfTest` to check the helper without enabling it.
 The original `powershell.exe -NoProfile -File .\tools\putty_keys.ps1` command
 also works from Command Prompt and continues to support PuTTY.
 
+### Windows Terminal and WSL clipboard shortcuts
+
+There are two main sources in WSL: plsqlwks' internal clipboard and the Windows
+clipboard. Linux desktop access uses Wayland/X11; WSLg can bridge Linux and
+Windows contents, so these are not necessarily three independent clipboards.
+
+Open **Alt-O → Preferences → Clipboard** to choose external copy destinations
+and the source of each paste shortcut. Save persists the choices in your
+workspace's `config.ini`; Cancel discards changes. Internal copy is always
+enabled. Capabilities / latest failure shows available readers/writers and the
+latest backend error without displaying clipboard contents.
+
+| Shortcut | Default on WSL/Windows |
+| --- | --- |
+| `Ctrl-C` | Copy internally and to Windows |
+| `Ctrl-Shift-C` | Copy internally only |
+| `Ctrl-V` | Paste from Windows |
+| `Ctrl-Shift-V` | Paste internally |
+
+`Ctrl-X` cuts using the ordinary copy destinations and remains one immediate
+Undo edit. `Ctrl-C` interrupts a running database operation first. These copy
+shortcuts work for editor selections, result cells/ranges, DBMS_OUTPUT
+selections and schema-browser object names. Existing paste-enabled prompts and
+cell editors honor both paste-source preferences. New workspaces without
+Windows tools default ordinary copy/paste to Linux; explicit settings always
+win, even if the selected backend is unavailable.
+
+```ini
+[clipboard]
+copy_to_windows = yes
+copy_to_linux = no
+ctrl_v_source = windows
+ctrl_shift_v_source = internal
+```
+
+Paste sources are `windows`, `internal`, or `linux`. Windows paste reads Windows
+exclusively: failure or empty contents causes no insertion and explicit
+feedback. Internal paste performs no OS access and cancels a pending paste for
+that target. Copy updates internal text immediately, then attempts every enabled
+external destination in a background worker. Windows copy tries PowerShell,
+then `clip.exe` on failure, and verifies contents by readback when a reader is
+available. Copy-only Windows access is labelled unverified. Each Linux provider
+is attempted when Linux copying is enabled. A Linux success does not conceal a
+Windows failure.
+
+Windows Terminal normally consumes all four shortcuts for its own copy/paste.
+To let plsqlwks receive them, open **Settings → Open JSON file** and add these
+entries to `actions`, keeping the other actions:
+
+```json
+{ "command": { "action": "sendInput", "input": "\u0003" }, "id": "User.PlsqlwksCopy" },
+{ "command": { "action": "sendInput", "input": "\u001b[99;6u" }, "id": "User.PlsqlwksInternalCopy" },
+{ "command": { "action": "sendInput", "input": "\u0016" }, "id": "User.PlsqlwksPaste" },
+{ "command": { "action": "sendInput", "input": "\u001b[118;6u" }, "id": "User.PlsqlwksAlternatePaste" }
+```
+
+Replace the existing copy/paste entries in `keybindings` with
+the entries below, keeping the other keybindings:
+
+```json
+{ "id": "User.PlsqlwksCopy", "keys": "ctrl+c" },
+{ "id": "User.PlsqlwksInternalCopy", "keys": "ctrl+shift+c" },
+{ "id": "User.PlsqlwksPaste", "keys": "ctrl+v" },
+{ "id": "User.PlsqlwksAlternatePaste", "keys": "ctrl+shift+v" }
+```
+
+This setting applies to every Windows Terminal profile and tab. Restart
+plsqlwks after upgrading and reopen Windows Terminal if it retains old bindings.
+The command menu offers equivalents when a terminal intercepts the shortcuts.
+The optional `tools/putty_keys.ps1` helper also forwards all four shortcuts when
+enabled for the active Windows terminal window.
+
+Keyboard navigation, resizing and dialogs remain available while clipboard
+commands run. Windows paste waits behind pending external copies. If you change
+the paste target's text, cursor, selection or active tab before it finishes, the
+pending paste is cancelled; repeated external paste requests for that target
+are ignored. Requests retain the settings in effect when submitted.
+
+For native Windows Terminal paste, wait until application copy reports that the
+Windows clipboard has been updated. Native paste reads the Windows clipboard
+independently and receives no internal fallback. Its bracketed paste payload is
+inserted directly without a second clipboard lookup.
+
+Windows Terminal's **Copy on select** setting can overwrite the clipboard when
+you select terminal text with the mouse. Turn it off if you want only explicit
+copy commands to change the Windows clipboard.
+See Microsoft's [send input action](https://learn.microsoft.com/en-us/windows/terminal/customize-settings/actions#send-input).
+
 ## Keys
 
 ### Global
@@ -708,19 +802,25 @@ also works from Command Prompt and continues to support PuTTY.
 | `Ctrl-U` | Uppercase selected SQL code |
 | `Ctrl-L` | Lowercase selected SQL code |
 | `Ctrl-C` | Copy selected text |
+| `Ctrl-Shift-C` | Copy selected text internally only |
 | `Ctrl-X` | Cut selected text |
 | `Ctrl-V` | Paste clipboard text, expanding each tab to two spaces |
+| `Ctrl-Shift-V` | Paste the alternate source (internal by default) |
 | Terminal paste | Paste text as one edit, expanding each tab to two spaces |
 | `Ctrl-Z` / `Ctrl-Y` | Undo / redo |
 | `Ctrl+=` | Reconnect |
 
 Use `/` on a line by itself after PL/SQL objects or anonymous blocks when running a script.
+With no selection, `F11` asks: **To run the whole buffer, press Enter. Esc cancels.**
+Press Enter to continue or Esc/Ctrl+C to cancel before bind prompts and execution.
+Executing selected text does not require this additional confirmation.
 Script execution reports statement progress as `n/total` and stops at the first
 failed statement while preserving earlier results. Scripts are sent directly to
 Oracle, not through SQL*Plus or SQLcl: client commands such as `PROMPT`, `SPOOL`,
 and `SET SERVEROUTPUT`, and `&`/`&&` substitution variables, are rejected before
 bind prompts or execution. Oracle SQL statements such as `SET TRANSACTION`
-remain supported.
+remain supported. A standalone `SET DEFINE OFF` line is accepted locally and
+omitted from database execution. It does not enable substitution variables.
 Execution and explain errors report mapped editor line and column diagnostics.
 The cursor moves only when the buffer still matches the source that was sent to
 Oracle; if it changed while the operation ran, the result warns about the stale
@@ -745,8 +845,8 @@ recorded as one undoable edit. `Ctrl-N` and `Ctrl-P` repeat the last search with
 its case setting, forward or backward with wraparound.
 
 Editor paste expands every tab character to two spaces and keeps multiline
-text in one undoable edit. This applies to `Ctrl-V` from either the system or
-internal clipboard and to native terminal paste while the editor is focused;
+text in one undoable edit. This applies to both configured paste shortcuts and
+to native terminal paste while the editor is focused;
 clipboard contents themselves are not changed. Native paste requires a
 terminal that supports the standard bracketed-paste protocol, with `Ctrl-V`
 remaining available as the fallback.
@@ -793,6 +893,7 @@ Read-only mode is a client-side guardrail that rejects statements which the SQL
 | `Ctrl-Home` / `Ctrl-End` | Move to the first/last result-grid row |
 | `F8` | Toggle result grid / row-detail output |
 | `Ctrl-C` | Copy one result cell immediately, or choose header handling for a rectangular selection |
+| `Ctrl-Shift-C` | Copy the same cell/range internally only |
 | `F10` | View or edit a mapped text cell in a ROWID-backed result |
 | `Enter` | Edit the selected ROWID-backed result cell when available |
 | `INS` | Prepare a draft insert row for ROWID-backed results |
@@ -1085,7 +1186,7 @@ Press `Enter` on a table or view to choose `Insert SELECT` (the default), `Load
 | `PageUp` / `PageDown` | Scroll cell text by page |
 | `Home` / `End` | Move to the first/last cell-viewer line |
 | `Ctrl-S` (editor) | Save the multiline edit |
-| `Ctrl-V` / terminal paste (editor) | Paste exact clipboard text as one undoable edit |
+| `Ctrl-V` / `Ctrl-Shift-V` / terminal paste (editor) | Paste exact clipboard text as one undoable edit |
 | `Enter` (editor) | Insert a newline |
 | `F10` / `Esc` / `Ctrl-Q` (editor) | Cancel the multiline edit |
 
@@ -1094,7 +1195,7 @@ Press `Enter` on a table or view to choose `Insert SELECT` (the default), `Load
 | Key | Action |
 | --- | --- |
 | Printable text | Type into prompts or filter picker options |
-| `Ctrl-V` / terminal paste | Paste single-line text; tabs are preserved and multiline text is rejected |
+| `Ctrl-V` / `Ctrl-Shift-V` / terminal paste | Paste single-line text; tabs are preserved and multiline text is rejected |
 | `Backspace` | Delete before the prompt cursor or picker filter |
 | `Enter` | Accept the prompt or selected picker item |
 | `Esc` / `Ctrl-Q` | Cancel the prompt or picker |
@@ -1155,9 +1256,13 @@ for the exact manifest, source layout, validation, replacement, and trust rules.
 Install `plugins/packages/table-ddl-export-0.1.1.plwgn` with
 `plsqlwks plugin install` and restart. **Alt-O -> Database -> Export table DDL**
 lets you choose a schema, filter table names as you type, select tables, and
-optionally remap them to another schema. It automatically includes related
+optionally remap them to another schema and prefix tables, indexes, constraints
+and triggers while updating static table references. It automatically includes related
 sequences and directly referencing packages, functions, procedures, and views, and follows
-required source-schema tables and views recursively. Definitions, constraints, indexes,
+required source-schema tables, views, SQL types and program units recursively.
+Unreadable type or program definitions become named destination prerequisites.
+Types retain their names; prefixed copies in the source schema reuse existing types.
+Definitions, constraints, indexes,
 foreign keys and triggers are ordered by creation dependencies in a new
 unsaved SQL tab for review. Generation activates that tab and focuses its editor.
 See the [selection keys and remapping details](doc/PLUGIN_CATALOG.md#table-ddl-export).

{plsqlwks-0.2.1 → plsqlwks-0.2.3}/doc/API.md

@@ -537,17 +537,40 @@ wording of either presentation is not part of the API.
 
 `PluginContext.start_table_ddl_export()` is an additive API-v1 capability.
 It starts a host-owned workflow to choose a source schema, filter and select
-tables, and choose a target schema. Sequences and source-schema packages,
+tables, and choose a target schema and optional table prefix. The prefix renames
+included source-schema tables, indexes, constraints and triggers, and updates
+resolved static references, including foreign keys. Blank preserves original
+names; `TEST` and `TEST_` both prepend `TEST_`. Quoted prefixes preserve exact
+case. Views, routines, SQL types and standalone sequences keep their names.
+Sequences and source-schema packages,
 functions, procedures, and views that directly reference the tables are included
 automatically, without a separate sequence picker. It returns immediately while the host
 reads metadata through the initiating tab's database worker. No connection,
 credentials, cursor, or arbitrary SQL capability crosses the plugin boundary.
 
-Required source-schema tables and views are followed recursively; tables include
+Required source-schema tables, views, SQL types and program units are followed
+recursively; tables include
 their constraints, indexes, triggers, and detected sequences. Selection of callers stays
 limited to direct references to the initially checked tables. Definitions are
 ordered by creation dependencies across object types; unresolved prerequisites
-and genuine dependency cycles are reported in the generated script.
+and genuine dependency cycles are reported in the generated script. Discovery
+prefers ALL_* catalogs and supplements them with accessible DBA_* views.
+Parenthesized static function/package calls in complete stored program source and
+trigger bodies supplement recorded dependencies, while local bindings are excluded.
+Required readable functions precede their callers without selecting unrelated
+functions. Existing source compilation errors are reported with line/column positions;
+export does not recompile source objects or create missing definitions.
+Cross-schema definitions use catalog rendering for supported objects and
+DBMS_METADATA fallback for advanced or incomplete metadata. Own-schema
+definitions retain DBMS_METADATA extraction. Type specifications and bodies are
+distinct dependency nodes; TYPE extraction omits source OIDs and combined bodies.
+Complete stored type source is preferred to conservative catalog reconstruction
+of ordinary object types and VARRAYs. Declared column types supplement dictionary
+dependencies, and local/public type synonyms resolve to their canonical owners.
+Unavailable or unsupported type/program definitions remain named prerequisites in
+the destination schema. Unsupported table definitions, cancellation and connection
+failures still abort generation. Same-schema prefixed exports reuse existing types
+and bodies and report them as prerequisites.
 
 On success the host opens and activates a new unsaved tab containing the generated
 SQL, with keyboard focus in the editor. Cancellation,

{plsqlwks-0.2.1 → plsqlwks-0.2.3}/doc/ARCHITECTURE.md

@@ -47,6 +47,56 @@ UI command as force-disconnected, quarantines that worker, and closes the exact
 captured client connection on a best-effort control thread. No server-side kill
 or process termination is attempted, and other tab workers are unaffected.
 
+System clipboard access uses a separate lazy worker in `ClipboardController`.
+It processes copy/paste requests in FIFO order, runs only provider calls, and
+returns results through a queue. The main loop and all modal input loops poll
+that queue; while a clipboard request is pending their idle timeout is at most
+100 ms. Only the curses thread updates clipboard state, status and text models.
+Copy and cut update internal text immediately and attempt all configured external
+destinations. Requests capture copy targets or the chosen paste source from the
+workspace's immutable clipboard preferences when submitted. Ctrl-Shift-C copies
+internally only. Internal paste cancels the target's pending callback and uses
+internal text directly; Windows paste waits for pending copies, reads Windows
+exclusively, and reports failure without falling back. Windows writes retry
+through clip.exe after PowerShell failure and use readback verification when
+available; Linux successes cannot hide Windows failures.
+External paste callbacks check the originating
+buffer or modal model, revision, cursor, selection and active target before
+applying one undoable edit. Closing a modal drops its pending callback.
+Clipboard children use isolated pipes, noninteractive PowerShell and a two-second
+provider timeout. Application shutdown cancels queued work and terminates the
+active clipboard child without waiting for normal provider completion.
+
+## Editor rendering
+
+The SQL document remains in memory, with a lazy `ViewportSyntax` cache owned by
+each `Buffer`. The cache keeps line-boundary lexer states and code-bracket
+positions for scanned lines, but retains tokens only for the visible rows and
+one screen above and below. Buffer edits, completion, and undo/redo report their
+changed line ranges. Parsing resumes from the first invalid line and reuses the
+unchanged suffix once its incoming lexer state agrees again. Display and cursor
+movement do not join or tokenize the entire document.
+
+Cold jumps and edits that change multiline strings or comments may need context
+from earlier lines. Parsing and distant bracket searches run in cooperative
+8 ms batches on the curses thread. Unresolved rows appear immediately in the
+default text style; accurate highlighting follows as context becomes available.
+The event loop polls input and database completions between batches, without
+the normal 200 ms idle delay. The budget is checked between lines and bracket
+positions; an exceptionally long individual line can exceed it.
+
+`Renderer` retains a curses window sized to the editor viewport. Small vertical
+scrolls move its existing rows, and row signatures limit painting to exposed or
+changed text, selection, and bracket overlays. Geometry or active-buffer changes
+invalidate the appropriate rows. The root screen and editor window compose via
+`noutrefresh()` and one `doupdate()`, restoring the active cursor after composition.
+Recomposing the retained editor also restores it after overlapping dialogs and
+external terminal use. No document-sized curses pad or rendering thread is used.
+Modal backgrounds use the same active-view composition instead of refreshing
+the root alone. Single-line prompts occupy a separate topmost curses window,
+including when the editor fills the screen. Physical redraw invalidation keeps
+the document and syntax cache intact.
+
 ## Transaction state
 
 Each worker-owned `OracleWorkspace` is the detailed source of truth. It tracks
@@ -116,8 +166,10 @@ The Table DDL Export command delegates through `start_table_ddl_export()`.
 Its host controller owns the table checklist with incremental substring filtering
 and cancellable worker jobs. Its database service discovers related sequences
 and directly referencing source-schema program units using bound dictionary
-reads, orders included routines by dependency, and extracts definitions using
-per-handle DBMS_METADATA transforms. Generation creates a fresh unsaved tab only for the originating
+reads, orders included routines by dependency, and supplements ALL_* discovery
+with accessible DBA_* views. Cross-schema definitions use conservative catalog
+renderers; own-schema and unsupported definitions use per-handle DBMS_METADATA
+transforms. Generation creates a fresh unsaved tab only for the originating
 editor/session. Identifier-aware remapping preserves literals and comments and
 reports ambiguous references. The plugin itself never receives database or UI
 internals and generated SQL is never automatically executed.

{plsqlwks-0.2.1 → plsqlwks-0.2.3}/doc/PLUGINS.md

@@ -173,7 +173,9 @@ and configuration instructions are in the [catalog](PLUGIN_CATALOG.md#sqlplus-la
 `table-ddl-export-0.1.1.plwgn` adds **Database -> Export table DDL** through
 `PluginContext.start_table_ddl_export()`. The host supplies schema/table selection
 with filtering as you type, automatic dependent-object and directly referencing
-program-unit/view extraction, schema remapping, progress, and a new unsaved SQL tab.
+program-unit/view extraction, recursive required SQL type and program-unit
+extraction, schema remapping, optional prefixes for tables and
+attached indexes/constraints/triggers, progress, and a new unsaved SQL tab.
 No extra dependencies are required. See the
 [catalog guide](PLUGIN_CATALOG.md#table-ddl-export) for installation and details.