pgkiln 0.88.0 → 0.89.0

package/src/builder/home.ts

@@ -2,7 +2,7 @@ import type { FastifyInstance, FastifyReply } from 'fastify';
 import { owner } from '../db.ts';
 import { html, raw, type Raw } from '../html.ts';
 import { icon } from '../icons.ts';
-import { APP_COLORS, BASE, csrf, developer, input, region, send, shell, type Req } from './ui.ts';
+import { APP_COLORS, BASE, csrf, developer, input, pageHeader, region, send, shell, type Req } from './ui.ts';
 import { crossAppLinks } from './cross-app.ts';
 import type { Session } from '../session.ts';
 import { isAdmin } from './locks.ts';
@@ -53,16 +53,6 @@ const lockedText = (tx: BuilderTranslate, by: string) => tx('ab.locked_by', { us
 const appIcon = (a: { id: number; name: string }, cls = '') =>
   html`<span class="app-icon app-color-${a.id % APP_COLORS}${cls ? ` ${cls}` : ''}" aria-hidden="true">${a.name.slice(0, 1).toUpperCase()}</span>`;
 
-/** The four tiles at the top of the App Builder. */
-const tiles = (tx: BuilderTranslate) => html`<nav class="ab-tiles" aria-label="${tx('rail.app_builder')}">
-  ${([
-    ['create', 'plus', tx('ab.tile.create'), tx('ab.tile.create_text')],
-    ['import', 'upload', tx('ab.tile.import'), tx('ab.tile.import_text')],
-    ['dashboard', 'activity', tx('ab.tile.dashboard'), tx('ab.tile.dashboard_text')],
-    ['utilities', 'settings', tx('ab.tile.utilities'), tx('ab.tile.utilities_text')],
-  ] as const).map(([path, ic, title, text]) => html`<a class="ab-tile" href="${BASE}/${path}"><span class="ab-tile-icon">${icon(ic)}</span><strong>${title}</strong><span>${text}</span></a>`)}
-</nav>`;
-
 /** The side column: About, Recent, Tasks. */
 function aside(tx: BuilderTranslate, recent: { id: number; name: string }[], about: string, tasks: [string, string][]) {
   return html`<aside class="ab-side" aria-label="${tx('ab.aside')}">
@@ -73,10 +63,9 @@ function aside(tx: BuilderTranslate, recent: { id: number; name: string }[], abo
   </aside>`;
 }
 
+// (UX-5) what the header doesn't offer already (Create and Import are there)
 const TASKS: [BuilderKey, string][] = [
-  ['ab.task.create', `${BASE}/create`],
   ['ab.task.create_file', `${BASE}/create/file`],
-  ['ab.task.import', `${BASE}/import`],
   ['ab.task.users', `${BASE}/users`],
   ['ab.task.providers', `${BASE}/users/providers`],
   ['rail.sql_workshop', `${BASE}/sql`],
@@ -174,9 +163,13 @@ export async function homeRoutes(app: FastifyInstance) {
       html`<a class="tb-btn" href="${link({ view: v })}" title="${label}"${view === v ? raw(' aria-current="true"') : ''}>${icon(ic)}<span class="sr-only">${label}</span></a>`;
     const main = html`<div class="ab-home">
       <div class="ab-main">
-        <h1 class="sr-only">${tx('rail.app_builder')}</h1>
+        ${pageHeader(tx('rail.app_builder'), {
+          primary: [`${BASE}/create`, tx('ab.tile.create'), 'plus'],
+          secondary: [[`${BASE}/import`, tx('ab.tile.import'), 'upload']],
+          more: [[`${BASE}/dashboard`, tx('ab.tile.dashboard'), 'activity'], [`${BASE}/utilities`, tx('rail.admin'), 'settings']],
+          moreLabel: tx('ws.more'),
+        })}
         ${s.workspace?.message ? html`<div class="alert alert-info ab-message" role="status">${icon('bell')}<div><strong>${s.workspace.name}</strong><p>${s.workspace.message}</p></div></div>` : ''}
-        ${tiles(tx)}
         <div class="ab-toolbar">
           <form class="ab-search" method="get" action="${BASE}/apps" role="search">
             <label class="sr-only" for="ab-q">${tx('ab.search_label')}</label>${icon('search')}
@@ -190,13 +183,8 @@ export async function homeRoutes(app: FastifyInstance) {
             <div class="menu-panel" role="menu">
               <div class="menu-section"><span class="small muted">${tx('ab.sort_by')}</span>
                 ${(Object.keys(SORTS) as Sort[]).map((k) => html`<a role="menuitem" href="${link({ sort: k })}"${sort === k ? raw(' aria-current="true"') : ''}>${tx(`ab.sort.${k}`)}</a>`)}</div>
-              <div class="menu-section menu-links">
-                <a role="menuitem" href="${BASE}/import">${icon('upload')} ${tx('ab.task.import')}</a>
-                <a role="menuitem" href="${BASE}/dashboard">${icon('activity')} ${tx('ab.ws_dashboard')}</a>
-              </div>
             </div></details>
           <span class="ab-count muted" aria-live="polite">${rows.length === total.n ? tx(total.n === 1 ? 'ab.count_one' : 'ab.count', { n: total.n }) : tx('ab.count_of', { n: rows.length, total: total.n })}</span>
-          <a class="btn btn-hot ab-create" href="${BASE}/create">${tx('ab.tile.create')}</a>
         </div>
         ${list}
       </div>
@@ -271,49 +259,72 @@ export async function homeRoutes(app: FastifyInstance) {
   });
 
   // ---------------------------------------------------------------- workspace utilities
+  // (UX-4) Administration: the workspace utilities in sections, with a filter; the rail's Administration entry (UX-3)
   app.get(`${BASE}/utilities`, async (req: Req, reply) => {
     const s = await developer(req, reply);
     if (!s) return;
     const tx = tr(s);
-    const card = (href: string, ic: Raw | '', title: string, text: string | Raw) =>
-      html`<a class="ab-tile" href="${href}"><span class="ab-tile-icon">${ic}</span><strong>${title}</strong><span>${text}</span></a>`;
-    const main = html`<div class="ab-home"><div class="ab-main"><h1 class="u-mb1">${tx('wu.title')}</h1>
-      <div class="ab-tiles ab-tiles-wrap">
-        ${card(`${BASE}/users`, icon('user'), tx('wu.users'), tx('wu.users_text'))}
-        ${card(`${BASE}/app-groups`, icon('folder'), tx('wu.app_groups'), tx('wu.app_groups_text'))}
-        ${card(`${BASE}/gallery`, icon('package'), tx('wu.gallery'), tx('wu.gallery_text'))}
-        ${card(`${BASE}/users/providers`, icon('key'), tx('wu.providers'), tx('wu.providers_text'))}
-        ${card(`${BASE}/users/directories`, icon('org'), tx('wu.ldap'), tx('wu.ldap_text'))}
-        ${card(`${BASE}/users#account-settings`, icon('shield'), tx('wu.password_policy'), tx('wu.password_policy_text'))}
-        ${card(`${BASE}/developers`, icon('users'), tx('wu.developers'), tx('wu.developers_text'))}
-        ${s.workspace?.sql_workshop === false ? '' : card(`${BASE}/sql`, icon('database'), tx('wu.sql'), tx('wu.sql_text'))}
-        ${card(`${BASE}/backups`, icon('archive'), tx('wu.backups'), tx('wu.backups_text'))}
-        ${card(`${BASE}/workspace-files`, icon('file'), tx('wu.files'), tx('wu.files_text', { tag: '#WORKSPACE_FILES#' }))}
-        ${card(`${BASE}/remote-servers`, icon('server'), tx('wu.servers'), tx('wu.servers_text'))}
-        ${(await isAdmin(s.username)) ? card(`${BASE}/remote-databases`, icon('database'), tx('wu.remote_dbs'), tx('wu.remote_dbs_text')) : ''}
-        ${card(`${BASE}/workspace-credentials`, icon('key'), tx('wu.credentials'), tx('wu.credentials_text'))}
-        ${card(`${BASE}/rest-catalogs`, icon('globe'), tx('wu.catalogs'), tx('wu.catalogs_text'))}
-        ${s.workspace?.admin ? card(`${BASE}/workspace-export`, icon('download'), tx('wu.export'), tx('wu.export_text')) : ''}
-        ${card(`${BASE}/dashboard`, icon('activity'), tx('wu.dashboard'), tx('wu.dashboard_text'))}
-        ${(await isAdmin(s.username)) ? card(`${BASE}/instance`, icon('settings'), tx('wu.instance'), tx('wu.instance_text')) : ''}
-        ${(await isAdmin(s.username))
-          ? card(`${BASE}/workspaces`, icon('layers'), tx('wu.workspaces'), tx('wu.workspaces_text'))
-          : s.workspace && (await workspaceAdmin(s.username, s.workspace.id))
-            ? card(`${BASE}/workspaces/${s.workspace.id}`, icon('layers'), tx('wu.workspace', { name: s.workspace.name }), tx('wu.workspace_text'))
-            : ''}
-        ${card(`${BASE}/ui-defaults`, icon('sliders-horizontal'), tx('wu.ui_defaults'), tx('wu.ui_defaults_text'))}
-        ${card(`${BASE}/icons`, icon('image'), tx('wu.icons'), tx('wu.icons_text'))}
-        ${card(`${BASE}/vector-providers`, icon('search'), tx('wu.vectors'), tx('wu.vectors_text'))}
-        ${(await isAdmin(s.username)) ? card(`${BASE}/ai`, icon('bolt'), tx('wu.ai'), tx('wu.ai_text')) : ''}
-        ${(await isAdmin(s.username)) ? card(`${BASE}/mail`, icon('send'), tx('wu.mail'), tx('wu.mail_text')) : ''}
-        ${(await isAdmin(s.username)) ? card(`${BASE}/telemetry`, icon('activity'), tx('wu.otel'), tx('wu.otel_text')) : ''}
-        ${(await isAdmin(s.username)) ? card(`${BASE}/installation`, icon('history'), tx('wu.installation'), tx('wu.installation_text')) : ''}
-      </div></div>
-      <aside class="ab-side" aria-label="${tx('wu.side')}">
-        <section><h2>${tx('wu.about')}</h2><p>${tx('wu.about_text')}</p>
-          <a href="https://github.com/pgkiln/pgkiln/blob/main/docs/guide/03-builder.md#workspaces" target="_blank" rel="noopener">${tx('wu.learn_more')}</a></section>
-        <section><h2>${tx('wu.cross_app')}</h2><ul class="ab-links ab-tasks">${crossAppLinks()}</ul></section>
-      </aside></div>`;
-    return send(reply, s, shell(s, tx('wu.title'), [[tx('rail.app_builder'), BASE], [tx('wu.title')]], main));
+    const admin = await isAdmin(s.username);
+    const wsAdmin = !!s.workspace?.admin || (!!s.workspace && (await workspaceAdmin(s.username, s.workspace.id)));
+    const ws = s.workspace;
+    type Tile = [href: string, ic: string, title: string, text: string | Raw] | null;
+    const tile = (t: Tile) =>
+      t ? html`<li><a class="adm-tile" href="${t[0]}"><span class="adm-tile-head">${icon(t[1])}<strong>${t[2]}</strong></span>${t[3] ? html`<span class="adm-tile-text">${t[3]}</span>` : ''}</a></li>` : '';
+    const section = (id: string, title: string, tiles: Tile[]) => {
+      const shown = tiles.filter(Boolean);
+      return shown.length ? html`<section class="adm-section" aria-labelledby="adm-${id}"><h2 id="adm-${id}">${title}</h2><ul class="adm-tiles">${shown.map(tile)}</ul></section>` : '';
+    };
+    const main = html`<div class="adm">
+      <div class="title-row"><h1>${tx('rail.admin')}</h1>
+        <div class="adm-filter" hidden><label class="sr-only" for="adm-q">${tx('wu.filter')}</label>
+          <input id="adm-q" type="search" placeholder="${tx('wu.filter')}" autocomplete="off" data-adm-filter></div></div>
+      <p class="u-mt0 adm-lede"><a href="https://github.com/pgkiln/pgkiln/blob/main/docs/guide/03-builder.md#workspaces" target="_blank" rel="noopener">${tx('wu.learn_more')}</a></p>
+      ${section('people', tx('wu.sec.people'), [
+        [`${BASE}/users`, 'user', tx('wu.users'), tx('wu.users_text')],
+        [`${BASE}/developers`, 'users', tx('wu.developers'), tx('wu.developers_text')],
+        [`${BASE}/users/providers`, 'key', tx('wu.providers'), tx('wu.providers_text')],
+        [`${BASE}/users/directories`, 'org', tx('wu.ldap'), tx('wu.ldap_text')],
+        [`${BASE}/users#account-settings`, 'shield', tx('wu.password_policy'), tx('wu.password_policy_text')],
+      ])}
+      ${section('connections', tx('wu.sec.connections'), [
+        [`${BASE}/remote-servers`, 'server', tx('wu.servers'), tx('wu.servers_text')],
+        admin ? [`${BASE}/remote-databases`, 'database', tx('wu.remote_dbs'), tx('wu.remote_dbs_text')] : null,
+        [`${BASE}/workspace-credentials`, 'key', tx('wu.credentials'), tx('wu.credentials_text')],
+        [`${BASE}/rest-catalogs`, 'globe', tx('wu.catalogs'), tx('wu.catalogs_text')],
+        admin ? [`${BASE}/mail`, 'send', tx('wu.mail'), tx('wu.mail_text')] : null,
+        wsAdmin ? [`${BASE}/mail-queue`, 'inbox', tx('admin.mail_queue'), ''] : null,
+        wsAdmin ? [`${BASE}/network`, 'globe', tx('admin.network'), ''] : null,
+      ])}
+      ${section('data', tx('wu.sec.data'), [
+        admin ? [`${BASE}/ai`, 'bolt', tx('wu.ai'), tx('wu.ai_text')] : null,
+        [`${BASE}/vector-providers`, 'search', tx('wu.vectors'), tx('wu.vectors_text')],
+        [`${BASE}/ui-defaults`, 'sliders-horizontal', tx('wu.ui_defaults'), tx('wu.ui_defaults_text')],
+        [`${BASE}/workspace-files`, 'file', tx('wu.files'), tx('wu.files_text', { tag: '#WORKSPACE_FILES#' })],
+        [`${BASE}/icons`, 'image', tx('wu.icons'), tx('wu.icons_text')],
+      ])}
+      ${section('operations', tx('wu.sec.operations'), [
+        [`${BASE}/app-groups`, 'folder', tx('wu.app_groups'), tx('wu.app_groups_text')],
+        [`${BASE}/backups`, 'archive', tx('wu.backups'), tx('wu.backups_text')],
+        wsAdmin ? [`${BASE}/workspace-export`, 'download', tx('wu.export'), tx('wu.export_text')] : null,
+        [`${BASE}/dashboard`, 'activity', tx('wu.dashboard'), tx('wu.dashboard_text')],
+        admin ? [`${BASE}/telemetry`, 'activity', tx('wu.otel'), tx('wu.otel_text')] : null,
+      ])}
+      ${ws && wsAdmin ? section('workspace', tx('wu.sec.workspace', { name: ws.name }), [
+        [`${BASE}/workspaces/${ws.id}`, 'layers', tx('admin.ws_devs'), tx('wu.workspace_text')],
+        [`${BASE}/workspaces/${ws.id}#service`, 'bell', tx('admin.ws_message'), ''],
+        [`${BASE}/workspaces/${ws.id}#preferences`, 'sliders-horizontal', tx('admin.ws_prefs'), ''],
+        [`${BASE}/workspaces/${ws.id}#links`, 'external-link', tx('admin.ext_links'), ''],
+        [`${BASE}/workspaces/${ws.id}/utilization`, 'chart', tx('admin.utilization'), ''],
+      ]) : ''}
+      ${admin ? section('instance', tx('wu.sec.instance'), [
+        [`${BASE}/instance`, 'settings', tx('wu.instance'), tx('wu.instance_text')],
+        [`${BASE}/workspaces`, 'layers', tx('wu.workspaces'), tx('wu.workspaces_text')],
+        s.instanceAdmin ? [`${BASE}/db-users`, 'key', tx('admin.db_users'), ''] : null,
+        [`${BASE}/installation`, 'history', tx('wu.installation'), tx('wu.installation_text')],
+      ]) : ''}
+      <section class="adm-section" aria-labelledby="adm-reports"><h2 id="adm-reports">${tx('wu.cross_app')}</h2><ul class="ab-links ab-tasks adm-reports">${crossAppLinks()}</ul></section>
+      <p class="adm-none muted" hidden>${tx('wu.filter_none')}</p>
+    </div>`;
+    return send(reply, s, shell(s, tx('rail.admin'), [[tx('rail.admin')]], main));
   });
 }

package/src/builder/i18n/de.ts

@@ -7516,4 +7516,26 @@ export const de: BuilderMessages = {
   'pwa.prefetch_hours': 'Erneut laden nach (Stunden)',
   'pwa.prefetch_hours_help': '1 bis 168. Die Seiten werden nach dieser Zeit beim ersten Seitenaufruf erneut geladen, sofern eine Verbindung besteht.',
   'pwa.prefetch_hours_range': 'Erneut laden nach: eine ganze Zahl von Stunden zwischen 1 und 168.',
+  // ------------------------------------------------------------ SQL Worksheet: one toolbar row (UX-1)
+  'ws.more': 'Weitere Aktionen',
+  'ws.suggest': 'Vorschläge',
+  'ws.suggest_title': 'Vorschläge an der Cursorposition (Strg+Leertaste)',
+  'ws.check': 'Prüfen',
+  'ws.check_title': 'Das SQL planen, ohne es auszuführen, wie der Advisor',
+  'ws.key.indent': 'Einrücken (Esc, dann Tab: nächstes Feld)',
+  'ws.search_path_plain': '{schema} zuerst im Suchpfad',
+  // ------------------------------------------------------------ Rail labels (UX-3)
+  'rail.labels_show': 'Beschriftungen anzeigen',
+  'rail.labels_hide': 'Beschriftungen ausblenden',
+  // ------------------------------------------------------------ Administration page (UX-4)
+  'wu.filter': 'Hilfsprogramme filtern',
+  'wu.filter_none': 'Nichts entspricht dem Filter.',
+  'wu.sec.people': 'Personen und Anmeldung',
+  'wu.sec.connections': 'Verbindungen',
+  'wu.sec.data': 'Daten und KI',
+  'wu.sec.operations': 'Betrieb',
+  'wu.sec.workspace': 'Arbeitsbereich {name}',
+  'wu.sec.instance': 'Instanz',
+  // ------------------------------------------------------------ Workspace home: needs attention (UX-13)
+  'wh.attention': 'Erfordert Aufmerksamkeit',
 };

package/src/builder/i18n/en.ts

@@ -7520,4 +7520,26 @@ export const en = {
   'pwa.prefetch_hours': 'Fetch them again after (hours)',
   'pwa.prefetch_hours_help': '1 to 168. The pages are fetched again on the first page opened after this time, while there is a connection.',
   'pwa.prefetch_hours_range': 'Fetch them again after: a whole number of hours from 1 to 168.',
+  // ------------------------------------------------------------ SQL Worksheet: one toolbar row (UX-1)
+  'ws.more': 'More actions',
+  'ws.suggest': 'Suggest',
+  'ws.suggest_title': 'Suggestions at the cursor (Ctrl+Space)',
+  'ws.check': 'Check',
+  'ws.check_title': 'Plan the SQL without running it, as the Advisor does',
+  'ws.key.indent': 'Indent (Esc, then Tab: next field)',
+  'ws.search_path_plain': '{schema} first in the search path',
+  // ------------------------------------------------------------ Rail labels (UX-3)
+  'rail.labels_show': 'Show labels',
+  'rail.labels_hide': 'Hide labels',
+  // ------------------------------------------------------------ Administration page (UX-4)
+  'wu.filter': 'Filter the utilities',
+  'wu.filter_none': 'Nothing matches the filter.',
+  'wu.sec.people': 'People and sign-in',
+  'wu.sec.connections': 'Connections',
+  'wu.sec.data': 'Data and AI',
+  'wu.sec.operations': 'Operations',
+  'wu.sec.workspace': 'Workspace {name}',
+  'wu.sec.instance': 'Instance',
+  // ------------------------------------------------------------ Workspace home: needs attention (UX-13)
+  'wh.attention': 'Needs attention',
 } as const;

package/src/builder/i18n/es.ts

@@ -7516,4 +7516,26 @@ export const es: BuilderMessages = {
   'pwa.prefetch_hours': 'Volver a obtenerlas después de (horas)',
   'pwa.prefetch_hours_help': 'De 1 a 168. Las páginas se vuelven a obtener en la primera página abierta después de este tiempo, mientras haya conexión.',
   'pwa.prefetch_hours_range': 'Volver a obtenerlas después de: un número entero de horas entre 1 y 168.',
+  // ------------------------------------------------------------ SQL Worksheet: one toolbar row (UX-1)
+  'ws.more': 'Más acciones',
+  'ws.suggest': 'Sugerir',
+  'ws.suggest_title': 'Sugerencias en el cursor (Ctrl+Espacio)',
+  'ws.check': 'Comprobar',
+  'ws.check_title': 'Planificar el SQL sin ejecutarlo, como el Advisor',
+  'ws.key.indent': 'Sangrar (Esc y luego Tab: siguiente campo)',
+  'ws.search_path_plain': '{schema} primero en la ruta de búsqueda',
+  // ------------------------------------------------------------ Rail labels (UX-3)
+  'rail.labels_show': 'Mostrar etiquetas',
+  'rail.labels_hide': 'Ocultar etiquetas',
+  // ------------------------------------------------------------ Administration page (UX-4)
+  'wu.filter': 'Filtrar las utilidades',
+  'wu.filter_none': 'Nada coincide con el filtro.',
+  'wu.sec.people': 'Personas e inicio de sesión',
+  'wu.sec.connections': 'Conexiones',
+  'wu.sec.data': 'Datos e IA',
+  'wu.sec.operations': 'Operaciones',
+  'wu.sec.workspace': 'Espacio de trabajo {name}',
+  'wu.sec.instance': 'Instancia',
+  // ------------------------------------------------------------ Workspace home: needs attention (UX-13)
+  'wh.attention': 'Requiere atención',
 };

package/src/builder/i18n/fr.ts

@@ -7516,4 +7516,26 @@ export const fr: BuilderMessages = {
   'pwa.prefetch_hours': 'Les récupérer à nouveau après (heures)',
   'pwa.prefetch_hours_help': 'De 1 à 168. Les pages sont récupérées à nouveau à la première page ouverte après ce délai, s’il y a une connexion.',
   'pwa.prefetch_hours_range': 'Les récupérer à nouveau après : un nombre entier d’heures entre 1 et 168.',
+  // ------------------------------------------------------------ SQL Worksheet: one toolbar row (UX-1)
+  'ws.more': 'Plus d’actions',
+  'ws.suggest': 'Suggérer',
+  'ws.suggest_title': 'Suggestions au curseur (Ctrl+Espace)',
+  'ws.check': 'Vérifier',
+  'ws.check_title': 'Planifier le SQL sans l’exécuter, comme l’Advisor',
+  'ws.key.indent': 'Indenter (Échap puis Tab : champ suivant)',
+  'ws.search_path_plain': '{schema} en premier dans le chemin de recherche',
+  // ------------------------------------------------------------ Rail labels (UX-3)
+  'rail.labels_show': 'Afficher les libellés',
+  'rail.labels_hide': 'Masquer les libellés',
+  // ------------------------------------------------------------ Administration page (UX-4)
+  'wu.filter': 'Filtrer les utilitaires',
+  'wu.filter_none': 'Rien ne correspond au filtre.',
+  'wu.sec.people': 'Personnes et connexion',
+  'wu.sec.connections': 'Connexions',
+  'wu.sec.data': 'Données et IA',
+  'wu.sec.operations': 'Exploitation',
+  'wu.sec.workspace': 'Espace de travail {name}',
+  'wu.sec.instance': 'Instance',
+  // ------------------------------------------------------------ Workspace home: needs attention (UX-13)
+  'wh.attention': 'À traiter',
 };

package/src/builder/i18n/it.ts

@@ -7516,4 +7516,26 @@ export const it: BuilderMessages = {
   'pwa.prefetch_hours': 'Recuperarle di nuovo dopo (ore)',
   'pwa.prefetch_hours_help': 'Da 1 a 168. Le pagine vengono recuperate di nuovo alla prima pagina aperta dopo questo tempo, se c’è connessione.',
   'pwa.prefetch_hours_range': 'Recuperarle di nuovo dopo: un numero intero di ore da 1 a 168.',
+  // ------------------------------------------------------------ SQL Worksheet: one toolbar row (UX-1)
+  'ws.more': 'Altre azioni',
+  'ws.suggest': 'Suggerisci',
+  'ws.suggest_title': 'Suggerimenti al cursore (Ctrl+Spazio)',
+  'ws.check': 'Verifica',
+  'ws.check_title': 'Pianifica l’SQL senza eseguirlo, come l’Advisor',
+  'ws.key.indent': 'Rientra (Esc, poi Tab: campo successivo)',
+  'ws.search_path_plain': '{schema} per primo nel percorso di ricerca',
+  // ------------------------------------------------------------ Rail labels (UX-3)
+  'rail.labels_show': 'Mostra etichette',
+  'rail.labels_hide': 'Nascondi etichette',
+  // ------------------------------------------------------------ Administration page (UX-4)
+  'wu.filter': 'Filtra le utilità',
+  'wu.filter_none': 'Nessun risultato per il filtro.',
+  'wu.sec.people': 'Persone e accesso',
+  'wu.sec.connections': 'Connessioni',
+  'wu.sec.data': 'Dati e IA',
+  'wu.sec.operations': 'Operazioni',
+  'wu.sec.workspace': 'Area di lavoro {name}',
+  'wu.sec.instance': 'Istanza',
+  // ------------------------------------------------------------ Workspace home: needs attention (UX-13)
+  'wh.attention': 'Richiede attenzione',
 };

package/src/builder/i18n/ja.ts

@@ -7516,4 +7516,26 @@ export const ja: BuilderMessages = {
   'pwa.prefetch_hours': '再取得までの時間（時間）',
   'pwa.prefetch_hours_help': '1～168。この時間が過ぎた後、接続があるときに最初にページを開くと再取得されます。',
   'pwa.prefetch_hours_range': '再取得までの時間: 1～168 の整数の時間を指定してください。',
+  // ------------------------------------------------------------ SQL Worksheet: one toolbar row (UX-1)
+  'ws.more': 'その他の操作',
+  'ws.suggest': '候補',
+  'ws.suggest_title': 'カーソル位置の候補 (Ctrl+Space)',
+  'ws.check': 'チェック',
+  'ws.check_title': 'Advisor と同様に、実行せずに SQL を計画します',
+  'ws.key.indent': 'インデント（Esc の後 Tab: 次のフィールド）',
+  'ws.search_path_plain': '検索パスの先頭は {schema}',
+  // ------------------------------------------------------------ Rail labels (UX-3)
+  'rail.labels_show': 'ラベルを表示',
+  'rail.labels_hide': 'ラベルを非表示',
+  // ------------------------------------------------------------ Administration page (UX-4)
+  'wu.filter': 'ユーティリティを絞り込む',
+  'wu.filter_none': 'フィルターに一致するものはありません。',
+  'wu.sec.people': 'ユーザーとサインイン',
+  'wu.sec.connections': '接続',
+  'wu.sec.data': 'データと AI',
+  'wu.sec.operations': '運用',
+  'wu.sec.workspace': 'ワークスペース {name}',
+  'wu.sec.instance': 'インスタンス',
+  // ------------------------------------------------------------ Workspace home: needs attention (UX-13)
+  'wh.attention': '要対応',
 };

package/src/builder/i18n/ko.ts

@@ -7516,4 +7516,26 @@ export const ko: BuilderMessages = {
   'pwa.prefetch_hours': '다시 가져오기까지의 시간(시간)',
   'pwa.prefetch_hours_help': '1~168. 이 시간이 지난 뒤 연결되어 있을 때 처음 페이지를 열면 다시 가져옵니다.',
   'pwa.prefetch_hours_range': '다시 가져오기까지의 시간: 1~168 사이의 정수 시간입니다.',
+  // ------------------------------------------------------------ SQL Worksheet: one toolbar row (UX-1)
+  'ws.more': '추가 작업',
+  'ws.suggest': '제안',
+  'ws.suggest_title': '커서 위치의 제안 (Ctrl+Space)',
+  'ws.check': '검사',
+  'ws.check_title': 'Advisor처럼 실행하지 않고 SQL을 계획합니다',
+  'ws.key.indent': '들여쓰기 (Esc 후 Tab: 다음 필드)',
+  'ws.search_path_plain': '검색 경로의 첫 번째는 {schema}',
+  // ------------------------------------------------------------ Rail labels (UX-3)
+  'rail.labels_show': '레이블 표시',
+  'rail.labels_hide': '레이블 숨기기',
+  // ------------------------------------------------------------ Administration page (UX-4)
+  'wu.filter': '유틸리티 필터',
+  'wu.filter_none': '필터와 일치하는 항목이 없습니다.',
+  'wu.sec.people': '사용자 및 로그인',
+  'wu.sec.connections': '연결',
+  'wu.sec.data': '데이터 및 AI',
+  'wu.sec.operations': '운영',
+  'wu.sec.workspace': '작업 공간 {name}',
+  'wu.sec.instance': '인스턴스',
+  // ------------------------------------------------------------ Workspace home: needs attention (UX-13)
+  'wh.attention': '주의 필요',
 };

package/src/builder/i18n/nl.ts

@@ -7516,4 +7516,26 @@ export const nl: BuilderMessages = {
   'pwa.prefetch_hours': 'Opnieuw ophalen na (uren)',
   'pwa.prefetch_hours_help': '1 tot 168. De pagina\'s worden opnieuw opgehaald bij de eerste pagina die na deze tijd wordt geopend, als er verbinding is.',
   'pwa.prefetch_hours_range': 'Opnieuw ophalen na: een geheel aantal uren van 1 tot 168.',
+  // ------------------------------------------------------------ SQL Worksheet: one toolbar row (UX-1)
+  'ws.more': 'Meer acties',
+  'ws.suggest': 'Suggesties',
+  'ws.suggest_title': 'Suggesties bij de cursor (Ctrl+Spatie)',
+  'ws.check': 'Controleren',
+  'ws.check_title': 'De SQL plannen zonder hem uit te voeren, zoals de Advisor',
+  'ws.key.indent': 'Inspringen (Esc, dan Tab: volgend veld)',
+  'ws.search_path_plain': '{schema} eerst in het zoekpad',
+  // ------------------------------------------------------------ Rail labels (UX-3)
+  'rail.labels_show': 'Labels tonen',
+  'rail.labels_hide': 'Labels verbergen',
+  // ------------------------------------------------------------ Administration page (UX-4)
+  'wu.filter': 'Hulpmiddelen filteren',
+  'wu.filter_none': 'Niets voldoet aan het filter.',
+  'wu.sec.people': 'Mensen en aanmelden',
+  'wu.sec.connections': 'Verbindingen',
+  'wu.sec.data': 'Gegevens en AI',
+  'wu.sec.operations': 'Beheer',
+  'wu.sec.workspace': 'Werkruimte {name}',
+  'wu.sec.instance': 'Instantie',
+  // ------------------------------------------------------------ Workspace home: needs attention (UX-13)
+  'wh.attention': 'Vraagt aandacht',
 };

package/src/builder/i18n/pt.ts

@@ -7516,4 +7516,26 @@ export const pt: BuilderMessages = {
   'pwa.prefetch_hours': 'Buscá-las novamente após (horas)',
   'pwa.prefetch_hours_help': 'De 1 a 168. As páginas são buscadas novamente na primeira página aberta após esse tempo, quando houver conexão.',
   'pwa.prefetch_hours_range': 'Buscá-las novamente após: um número inteiro de horas de 1 a 168.',
+  // ------------------------------------------------------------ SQL Worksheet: one toolbar row (UX-1)
+  'ws.more': 'Mais ações',
+  'ws.suggest': 'Sugerir',
+  'ws.suggest_title': 'Sugestões no cursor (Ctrl+Espaço)',
+  'ws.check': 'Verificar',
+  'ws.check_title': 'Planejar o SQL sem executá-lo, como o Advisor',
+  'ws.key.indent': 'Recuar (Esc e depois Tab: próximo campo)',
+  'ws.search_path_plain': '{schema} primeiro no caminho de pesquisa',
+  // ------------------------------------------------------------ Rail labels (UX-3)
+  'rail.labels_show': 'Mostrar rótulos',
+  'rail.labels_hide': 'Ocultar rótulos',
+  // ------------------------------------------------------------ Administration page (UX-4)
+  'wu.filter': 'Filtrar os utilitários',
+  'wu.filter_none': 'Nada corresponde ao filtro.',
+  'wu.sec.people': 'Pessoas e login',
+  'wu.sec.connections': 'Conexões',
+  'wu.sec.data': 'Dados e IA',
+  'wu.sec.operations': 'Operações',
+  'wu.sec.workspace': 'Espaço de trabalho {name}',
+  'wu.sec.instance': 'Instância',
+  // ------------------------------------------------------------ Workspace home: needs attention (UX-13)
+  'wh.attention': 'Requer atenção',
 };

package/src/builder/i18n/zh-cn.ts

@@ -7516,4 +7516,26 @@ export const zhCN: BuilderMessages = {
   'pwa.prefetch_hours': '多少小时后重新获取',
   'pwa.prefetch_hours_help': '1 到 168。超过此时间后，在有网络连接时打开第一个页面时会重新获取这些页面。',
   'pwa.prefetch_hours_range': '重新获取时间：1 到 168 之间的整数小时。',
+  // ------------------------------------------------------------ SQL Worksheet: one toolbar row (UX-1)
+  'ws.more': '更多操作',
+  'ws.suggest': '建议',
+  'ws.suggest_title': '光标处的建议 (Ctrl+Space)',
+  'ws.check': '检查',
+  'ws.check_title': '像 Advisor 一样规划 SQL 而不运行',
+  'ws.key.indent': '缩进（先按 Esc 再按 Tab：下一个字段）',
+  'ws.search_path_plain': '{schema} 位于搜索路径首位',
+  // ------------------------------------------------------------ Rail labels (UX-3)
+  'rail.labels_show': '显示标签',
+  'rail.labels_hide': '隐藏标签',
+  // ------------------------------------------------------------ Administration page (UX-4)
+  'wu.filter': '筛选实用工具',
+  'wu.filter_none': '没有符合筛选条件的项目。',
+  'wu.sec.people': '人员与登录',
+  'wu.sec.connections': '连接',
+  'wu.sec.data': '数据与 AI',
+  'wu.sec.operations': '运维',
+  'wu.sec.workspace': '工作区 {name}',
+  'wu.sec.instance': '实例',
+  // ------------------------------------------------------------ Workspace home: needs attention (UX-13)
+  'wh.attention': '需要注意',
 };

package/src/builder/i18n/zh-tw.ts

@@ -7516,4 +7516,26 @@ export const zhTW: BuilderMessages = {
   'pwa.prefetch_hours': '多少小時後重新取得',
   'pwa.prefetch_hours_help': '1 到 168。超過此時間後，在有網路連線時開啟第一個頁面時會重新取得這些頁面。',
   'pwa.prefetch_hours_range': '重新取得時間：1 到 168 之間的整數小時。',
+  // ------------------------------------------------------------ SQL Worksheet: one toolbar row (UX-1)
+  'ws.more': '更多動作',
+  'ws.suggest': '建議',
+  'ws.suggest_title': '游標處的建議 (Ctrl+Space)',
+  'ws.check': '檢查',
+  'ws.check_title': '像 Advisor 一樣規劃 SQL 而不執行',
+  'ws.key.indent': '縮排（先按 Esc 再按 Tab：下一個欄位）',
+  'ws.search_path_plain': '{schema} 位於搜尋路徑首位',
+  // ------------------------------------------------------------ Rail labels (UX-3)
+  'rail.labels_show': '顯示標籤',
+  'rail.labels_hide': '隱藏標籤',
+  // ------------------------------------------------------------ Administration page (UX-4)
+  'wu.filter': '篩選公用程式',
+  'wu.filter_none': '沒有符合篩選條件的項目。',
+  'wu.sec.people': '人員與登入',
+  'wu.sec.connections': '連線',
+  'wu.sec.data': '資料與 AI',
+  'wu.sec.operations': '維運',
+  'wu.sec.workspace': '工作區 {name}',
+  'wu.sec.instance': '執行個體',
+  // ------------------------------------------------------------ Workspace home: needs attention (UX-13)
+  'wh.attention': '需要注意',
 };

package/src/builder/routes.ts

@@ -540,6 +540,24 @@ export async function builderRoutes(app: FastifyInstance) {
     return reply.redirect(`${BASE}/login`, 303);
   });
 
+  // (UX-3) the icon rail with labels next to the icons, or icons only (kept in the developer's session)
+  app.post(`${BASE}/rail`, async (req: Req, reply) => {
+    const s = await developer(req, reply);
+    if (!s) return;
+    if (req.body?.labels === 'labels') s.state.__RAIL = 'labels';
+    else delete s.state.__RAIL;
+    const ref = String(req.headers.referer ?? '');
+    let to = `${BASE}/home`;
+    try {
+      const u = new URL(ref);
+      if (u.host === req.headers.host && u.pathname.startsWith(BASE)) to = u.pathname + u.search;
+    } catch {
+      /* no referer: the home page */
+    }
+    await saveState(s);
+    return reply.redirect(to, 303);
+  });
+
   // The builder's light/dark theme (the developer's menu in the icon rail).
   app.post(`${BASE}/theme`, async (req: Req, reply) => {
     const s = await developer(req, reply);
@@ -654,7 +672,7 @@ export async function builderRoutes(app: FastifyInstance) {
     const tx = tr(s);
 
     const main = html`
-      ${appHeader(a, 'pages', s)}
+      ${appHeader(a, 'pages', s, [`${BASE}/apps/${a.id}/create-page`, tx('app.create_page'), 'plus'])}
       ${appLock && appLock.locked_by !== s.username ? html`<div class="alert alert-error" role="status">${icon('key')} ${lockText(appLock)} ${tx('app.lock_refused')}</div>` : ''}
       <div class="app-home">
       <div class="app-home-main">
@@ -664,7 +682,6 @@ export async function builderRoutes(app: FastifyInstance) {
           <button class="btn">${icon('search')}<span class="sr-only">${tx('common.search')}</span></button></form>
         <div class="seg view-toggle" role="group" aria-label="${tx('ab.view')}">
           <a href="${keep({})}"${icons ? '' : raw(' aria-current="true"')}>${icon('list')} ${tx('ab.view_report')}</a><a href="${keep({ view: 'icons' })}"${icons ? raw(' aria-current="true"') : ''}>${icon('grid')} ${tx('app.view_icons')}</a></div>
-        <a class="btn btn-hot" href="${BASE}/apps/${a.id}/create-page">${icon('plus')} ${tx('app.create_page')}</a>
       </div>
       ${region(tx('app.tab.pages'), html`${grouped
           ? html`<form method="get" class="search u-mwnone u-mb1"><div class="field"><label class="label" for="f_group">${tx('app.page_group')}</label>
@@ -690,7 +707,7 @@ export async function builderRoutes(app: FastifyInstance) {
               ${select('kind', tx('app.page_type'), 'report_form', WIZARD_KINDS.map(([k, label]): [string, string] => [k, kindLabel(k, label)]))}
               ${select('table', tx('app.table_or_view'), '', tables.map((t): [string, string] => [t.t, t.access ? t.t : tx('app.no_access', { table: t.t, role: a.db_role })]))}
             </div>
-            <div class="buttons"><button class="btn btn-hot">${tx('common.next')}</button></div>
+            <div class="buttons"><button class="btn">${tx('common.next')}</button></div>
           </form>
           <p><a href="${BASE}/apps/${a.id}/create-page">${tx('app.all_page_types')} ▸</a></p>
           <p><a href="${BASE}/apps/${a.id}/ai-pages">${tx('app.ai_pages')} ▸</a> <span class="muted">${tx('app.ai_pages_note')}</span></p>`)}
@@ -702,25 +719,19 @@ export async function builderRoutes(app: FastifyInstance) {
               ${select('mode', tx('app.col.mode'), 'normal', ['normal', 'modal'])}
               ${input('parent_page', tx('app.parent'), a.home_page, { type: 'number' })}
             </div>
-            <div class="buttons"><button class="btn btn-hot">${tx('app.create_page')}</button></div>
+            <div class="buttons"><button class="btn">${tx('app.create_page')}</button></div>
           </form>`)}
       </div>
       </div>
       <aside class="app-tasks region region-standard" aria-labelledby="app-tasks-h"><header class="region-header"><h2 id="app-tasks-h">${tx('common.tasks')}</h2></header>
         <ul class="sc-links">
-          <li><a href="/a/${a.alias}" target="_blank" rel="noopener">${icon('play')} ${tx('app.task.run')}</a></li>
-          <li><a href="${BASE}/apps/${a.id}/create-page">${icon('plus')} ${tx('app.create_page')}</a></li>
           <li><a href="${BASE}/apps/${a.id}/create-page?tab=feature">${icon('puzzle')} ${tx('app.task.add_feature')}</a></li>
           <li><a href="${BASE}/apps/${a.id}/create-page?tab=copy">${icon('copy')} ${tx('app.task.copy_page')}</a></li>
           <li><a href="${BASE}/apps/${a.id}/ai-pages">${icon('lightbulb')} ${tx('app.ai_pages')}</a></li>
-          <li><a href="${BASE}/apps/${a.id}/shared">${icon('layers')} ${tx('app.tab.shared')}</a></li>
           <li><a href="${BASE}/apps/${a.id}/shared?type=page_group">${icon('folder')} ${tx('app.task.page_groups')}</a></li>
-          <li><a href="${BASE}/apps/${a.id}/export">${icon('download')} ${tx('app.head.export')}</a></li>
-          <li><a href="${BASE}/apps/${a.id}/backups">${icon('history')} ${tx('app.head.backups')}</a></li>
           <li><a href="${BASE}/apps/${a.id}/supporting-objects">${icon('database')} ${tx('app.task.supporting')}</a></li>
           <li><a href="#app-lock">${icon('lock')} ${tx('app.task.lock')}</a></li>
           ${issues.task}
-          <li><a href="${BASE}/apps/${a.id}/settings?tab=definition">${icon('trash')} ${tx('app.task.delete')}</a></li>
         </ul></aside>
       </div>`;
     return send(reply, s, shell(s, a.name, [[tx('rte.app_builder'), BASE], [a.name]], main));

package/src/builder/sql.ts

@@ -2,7 +2,7 @@ import type { FastifyInstance, FastifyReply } from 'fastify';
 import pg from 'pg';
 import { html, raw, type Raw } from '../html.ts';
 import { icon } from '../icons.ts';
-import { back, BASE, csrf, developer, flash, region, send, shell, workshopTabs, type Req } from './ui.ts';
+import { back, BASE, csrf, developer, flash, pageHeader, region, send, shell, workshopTabs, type Req } from './ui.ts';
 import { owner } from '../db.ts';
 import { clientIp, logActivity, type Session } from '../session.ts';
 import { clearCompletions } from './code-editor.ts';
@@ -70,7 +70,7 @@ async function workshopHome(req: Req, reply: FastifyReply) {
     html`<section class="sw-recent"><h2>${title}</h2>${rows.length ? html`<ul>${rows}</ul>` : html`<p class="muted">${empty}</p>`}</section>`;
   const main = html`<div class="ab-home">
     <div class="ab-main">
-      <h1 class="sr-only">${tx('rail.sql_workshop')}</h1>
+      ${pageHeader(tx('rail.sql_workshop'))}
       ${workshopTabs('home', s)}
       ${await launchpad(s, await isAdmin(s.username))}
       <div class="sw-recents">