@graphlearning/graphl-flow 0.7.0 → 0.8.0

package/README.md

@@ -93,6 +93,12 @@ prompt's colours, red for root's `#`; every other row is output, in ink. A comma
 (default 80) wide wrapped, so the rows after it continue the command, and the command is highlighted
 whole across the wrap. `show`, `highlight` and `focus` (`con.L12`) work as on code.
 
+**psql (0.8).** A console also recognises psql's default prompt: `syndica=>` (a new statement),
+`syndica-*>` / `syndica(>` / `syndica'>` (a continued line; `(` and `'` inside brackets or a string),
+`*` a transaction open, `!` a failed one, and `#` a superuser (red, like root). A statement's
+continuation rows are one command, highlighted as SQL across its lines; `\d`, `\q`… draw as psql's
+own commands. Capture with `psql -n` (no readline) in an 80-column pty.
+
 A full-screen program is a **`tty`**: `screen` (its rows), `cols?` (80), `inverse?` and `bold?` runs
 as `[row, from, to)` — a fixed grid, padded to `cols`, so two captures of `top` are the same box.
 Its rows are `tty.R<n>`.

package/dist/Code.d.ts

@@ -15,15 +15,27 @@ type Row = {
  */
 export declare function codeRows(node: Code): Row[];
 export declare const codeLineIds: (node: Code) => string[];
-/** A shell prompt, as the three shells the course meets draw it. `sigil` is `$`/`%`, or `#` for root. */
-export interface Prompt {
+/**
+ * A prompt: a shell's, as the three shells the course meets draw it (`sigil` is `$`/`%`, or `#` for
+ * root), or psql's (0.8) default `%/%R%x%# ` — the database, the input state (`=` a new statement,
+ * `-` a continued one, `(` `'` `"` inside brackets or quotes), the transaction state (`*` open, `!`
+ * failed, `?` unknown) and `>`, or `#` for a superuser.
+ */
+export type Prompt = {
+    style: 'debian' | 'redhat' | 'zsh';
     user: string;
     host: string;
     cwd: string;
     sigil: string;
-    style: 'debian' | 'redhat' | 'zsh';
     cmd: string;
-}
+} | {
+    style: 'psql';
+    db: string;
+    mode: string;
+    tx: string;
+    sigil: string;
+    cmd: string;
+};
 export declare function parsePrompt(row: string): Prompt | null;
 type ConsoleRow = {
     n: number;
@@ -41,8 +53,11 @@ type ConsoleRow = {
 };
 /**
  * Classify a transcript's rows. A prompt row is a command; a command row exactly `cols` wide wrapped,
- * so the rows after it continue the command until one is shorter. The command is tokenized WHOLE and
- * its tokens cut back into rows, so a string or a path that crosses the wrap keeps its colour.
+ * so the rows after it continue the command until one is shorter. psql (0.8) draws a prompt on every
+ * line of a statement, so a psql command also takes the continuation-prompt rows after it (`-`, `(`,
+ * `'`, `"`) as further LINES. The command is tokenized WHOLE — lines joined by `\n` — and its tokens
+ * cut back into rows, so a string crossing a wrap or a line keeps its colour. A shell command is
+ * `shell`, a psql one `sql`.
  */
 export declare function consoleRows(lines: string[], cols: number): Map<number, ConsoleRow>;
 export declare function CodeView({ node, style }: {

package/dist/highlight.d.ts

@@ -5,5 +5,10 @@ export interface Tok {
 }
 export type Lang = 'python' | 'sql' | 'scala' | 'java' | 'js' | 'ts' | 'shell' | 'hcl' | 'ini' | 'nginx' | 'nft' | 'text';
 export declare function tokenize(src: string, lang: Lang): Tok[];
-/** Drop a leading/trailing blank line and the common indent, so scenes can use indented template literals. */
+/**
+ * Drop the template literal's first line break, trailing blank lines and the common indent, so scenes
+ * can use indented template literals. Only ONE leading blank line goes (0.8): a timeline pane's
+ * transcript can START with blank rows — padding that aligns it with the other session — and
+ * stripping them all shifted the whole pane up.
+ */
 export declare function dedent(src: string): string[];