pgkiln 0.81.0 → 0.83.0

package/src/builder/top-sql.ts

@@ -3,6 +3,7 @@ import { owner } from '../db.ts';
 import { html, raw } from '../html.ts';
 import { icon } from '../icons.ts';
 import { appHeader, back, BASE, csrf, developer, flash, region, send, shell, type Req } from './ui.ts';
+import { tr, type BuilderTranslate } from './i18n.ts';
 
 // App Builder → Activity → Top SQL: the statements the application's
 // database role ran, from pg_stat_statements (APEX: Top SQL in the
@@ -27,12 +28,14 @@ export async function statementsState(): Promise<{ ok: true } | { ok: false; rea
 }
 
 /** Why the statistics can't be shown, and how to turn them on. */
-export function statementsNote(reason: 'not_installed' | 'not_loaded' | 'error', message?: string) {
+export function statementsNote(tx: BuilderTranslate, reason: 'not_installed' | 'not_loaded' | 'error', message?: string) {
+  const ext = html`<code>pg_stat_statements</code>`;
+  const setting = html`<code>shared_preload_libraries = 'pg_stat_statements'</code>`;
   return html`<div class="alert alert-error" role="alert">${reason === 'not_installed'
-    ? html`The <code>pg_stat_statements</code> extension isn't installed in this database. To turn it on: set <code>shared_preload_libraries = 'pg_stat_statements'</code> (postgresql.conf, or <code>alter system set shared_preload_libraries = 'pg_stat_statements'</code>), restart PostgreSQL, then as a superuser: <code>create extension pg_stat_statements;</code>`
+    ? tx.rich('topsql.not_installed', { ext, setting, alter: html`<code>alter system set shared_preload_libraries = 'pg_stat_statements'</code>`, create: html`<code>create extension pg_stat_statements;</code>` })
     : reason === 'not_loaded'
-      ? html`The server doesn't load <code>pg_stat_statements</code> yet. Set <code>shared_preload_libraries = 'pg_stat_statements'</code> (the development <code>docker-compose.yml</code> does) and restart PostgreSQL.`
-      : html`The statistics could not be read: ${message ?? ''}`}</div>`;
+      ? tx.rich('topsql.not_loaded', { ext, setting, compose: html`<code>docker-compose.yml</code>` })
+      : tx('topsql.read_error', { message: message ?? '' })}</div>`;
 }
 
 /** The role's statements, slowest in total first (or by mean time, calls or rows). */
@@ -66,28 +69,29 @@ export async function topSqlRoutes(app: FastifyInstance) {
     if (!s) return;
     const a = await appOf(req.params.id);
     if (!a) return reply.code(404).send('Not found');
+    const tx = tr(s);
     const sort = SORTS[req.query.sort ?? ''] ? req.query.sort! : 'total';
     const top = await topSql(a.db_role, sort);
     const sortLink = (key: string, label: string) =>
       html`<a href="${BASE}/apps/${a.id}/top-sql?sort=${key}"${sort === key ? raw(' aria-current="true"') : ''}>${label}</a>`;
     const body = top.ok
       ? top.rows.length
-        ? html`<div class="seg u-mb1">Sort by ${sortLink('total', 'total time')} ${sortLink('mean', 'time per call')} ${sortLink('calls', 'calls')} ${sortLink('rows', 'rows')}</div>
-            <div class="table-wrap"><table class="report report-reflow top-sql"><thead><tr><th class="num">Calls</th><th class="num">Total ms</th><th class="num">Mean ms</th><th class="num">Rows</th><th class="num">Share</th><th>Statement</th></tr></thead>
+        ? html`<div class="seg u-mb1">${tx.rich('topsql.sort_by', { total: sortLink('total', tx('topsql.sort.total')), mean: sortLink('mean', tx('topsql.sort.mean')), calls: sortLink('calls', tx('topsql.sort.calls')), rows: sortLink('rows', tx('topsql.sort.rows')) })}</div>
+            <div class="table-wrap"><table class="report report-reflow top-sql"><thead><tr><th class="num">${tx('sm.col.calls')}</th><th class="num">${tx('sm.col.total_ms')}</th><th class="num">${tx('sm.col.mean_ms')}</th><th class="num">${tx('sm.col.rows')}</th><th class="num">${tx('topsql.share')}</th><th>${tx('sm.col.statement')}</th></tr></thead>
             <tbody>${top.rows.map((r) => html`<tr>
-              <td class="num" data-label="Calls">${r.calls}</td><td class="num" data-label="Total ms">${r.total_ms}</td><td class="num" data-label="Mean ms">${r.mean_ms}</td>
-              <td class="num" data-label="Rows">${r.rows}</td><td class="num" data-label="Share">${r.share ?? 0}%</td>
-              <td data-label="Statement"><code class="sql-text">${r.query}</code></td></tr>`)}</tbody></table></div>
+              <td class="num" data-label="${tx('sm.col.calls')}">${r.calls}</td><td class="num" data-label="${tx('sm.col.total_ms')}">${r.total_ms}</td><td class="num" data-label="${tx('sm.col.mean_ms')}">${r.mean_ms}</td>
+              <td class="num" data-label="${tx('sm.col.rows')}">${r.rows}</td><td class="num" data-label="${tx('topsql.share')}">${r.share ?? 0}%</td>
+              <td data-label="${tx('sm.col.statement')}"><code class="sql-text">${r.query}</code></td></tr>`)}</tbody></table></div>
             <form method="post" action="${BASE}/apps/${a.id}/top-sql/reset" class="u-mt1">${csrf(s)}
-              <button class="btn" data-confirm="Clear the statistics of role ${a.db_role}?">${icon('history')} Reset the statistics</button></form>`
-        : html`<p class="muted">No statements recorded for <code>${a.db_role}</code> yet. Use the application, then come back.</p>`
+              <button class="btn" data-confirm="${tx('topsql.reset_confirm', { role: a.db_role })}">${icon('history')} ${tx('topsql.reset')}</button></form>`
+        : html`<p class="muted">${tx.rich('topsql.none_yet', { role: html`<code>${a.db_role}</code>` })}</p>`
       : top.reason === 'no_role'
-        ? html`<div class="alert alert-error" role="alert">This application runs as the owner role, so its statements can't be told apart. Give it a database role in Settings.</div>`
-        : statementsNote(top.reason, top.message);
+        ? html`<div class="alert alert-error" role="alert">${tx('topsql.no_role')}</div>`
+        : statementsNote(tx, top.reason, top.message);
     const main = html`${appHeader(a, 'activity', s)}
-      ${region('Top SQL', html`<p class="muted u-mt0">Statements run as the role <code>${a.db_role ?? '(owner)'}</code> since the statistics were last reset, from <code>pg_stat_statements</code>. Literals and binds show as <code>$1</code>, <code>$2</code>…; applications that share a role share this list. <a href="${BASE}/apps/${a.id}/activity">Back to Activity</a></p>
+      ${region(tx('sql.tool.topsql'), html`<p class="muted u-mt0">${tx.rich('topsql.intro', { role: html`<code>${a.db_role ?? tx('topsql.owner')}</code>`, ext: html`<code>pg_stat_statements</code>`, p1: html`<code>$1</code>`, p2: html`<code>$2</code>` })} <a href="${BASE}/apps/${a.id}/activity">${tx('topsql.back_activity')}</a></p>
         ${body}`)}`;
-    return send(reply, s, shell(s, `Top SQL · ${a.name}`, [['App Builder', BASE], [a.name, `${BASE}/apps/${a.id}`], ['Activity', `${BASE}/apps/${a.id}/activity`], ['Top SQL']], main));
+    return send(reply, s, shell(s, `${tx('sql.tool.topsql')} · ${a.name}`, [[tx('rail.app_builder'), BASE], [a.name, `${BASE}/apps/${a.id}`], [tx('topsql.activity'), `${BASE}/apps/${a.id}/activity`], [tx('sql.tool.topsql')]], main));
   });
 
   app.post(`${BASE}/apps/:id/top-sql/reset`, async (req: Req, reply) => {
@@ -96,9 +100,9 @@ export async function topSqlRoutes(app: FastifyInstance) {
     const a = await appOf(req.params.id);
     if (!a) return reply.code(404).send('Not found');
     try {
-      if (!a.db_role) throw new Error('The application has no database role.');
+      if (!a.db_role) throw new Error(tr(s)('topsql.no_db_role'));
       await owner.query(`select pg_stat_statements_reset((select oid from pg_roles where rolname = $1), (select oid from pg_database where datname = current_database()), 0)`, [a.db_role]);
-      flash(s, 'Statistics reset.');
+      flash(s, tr(s)('topsql.reset_done'));
     } catch (e) {
       flash(s, (e as Error).message, 'error');
     }

package/src/builder/unload.ts

@@ -22,6 +22,7 @@ import {
 } from '../unload.ts';
 import { BASE, csrf, developer, region, send, shell, workshopTabs, type Body, type Req } from './ui.ts';
 import { sessionSchema, workshopDb } from './workspaces.ts';
+import { tr, type BuilderTranslate } from './i18n.ts';
 
 // SQL Workshop → Unload Data (APEX: Data Workshop → Unload Data): a table or
 // view (chosen columns, an optional WHERE and ORDER BY) or a query, to CSV,
@@ -88,86 +89,89 @@ const list = (v: unknown) => (Array.isArray(v) ? v : v === undefined || v === nu
 export async function unloadRoutes(app: FastifyInstance) {
   const page = (s: Session, reply: FastifyReply, main: Raw, code = 200) => {
     reply.code(code);
-    return send(reply, s, shell(s, 'Unload Data', [['SQL Workshop', `${BASE}/sql`], ['Unload Data']], html`<h1 class="u-mb1">SQL Workshop</h1>${workshopTabs('unload', s)}${main}`, 'sql'));
+    const tx = tr(s);
+    return send(reply, s, shell(s, tx('sql.tool.unload'), [[tx('rail.sql_workshop'), `${BASE}/sql`], [tx('sql.tool.unload')]], html`<h1 class="u-mb1">${tx('rail.sql_workshop')}</h1>${workshopTabs('unload', s)}${main}`, 'sql'));
   };
 
-  const formatFields = (b: Body) => {
+  const formatFields = (tx: BuilderTranslate, b: Body) => {
     const fmt = (UNLOAD_FORMATS as string[]).includes(b.format ?? '') ? b.format : 'csv';
     const posted = b.format !== undefined; // unticked checkboxes post nothing
     const on = (name: string) => (!posted || b[name] === '1' ? raw(' checked') : '');
     const opt = (map: Record<string, string>, field: string, labels: Record<string, string>) =>
       Object.keys(map).map((k) => html`<option value="${k}"${(b[field] ?? Object.keys(map)[0]) === k ? raw(' selected') : ''}>${labels[k]}</option>`);
     return html`
-      <fieldset class="prop-group u-mt125"><legend>Format</legend>
-        <div class="unload-formats" role="radiogroup" aria-label="Format">${UNLOAD_FORMATS.map(
-          (f) => html`<label class="check"><input type="radio" name="format" value="${f}"${fmt === f ? raw(' checked') : ''}> ${{ csv: 'CSV', json: 'JSON', xlsx: 'Excel (.xlsx)', xml: 'XML', sql: 'SQL inserts' }[f]}</label>`,
+      <fieldset class="prop-group u-mt125"><legend>${tx('cl.format')}</legend>
+        <div class="unload-formats" role="radiogroup" aria-label="${tx('cl.format')}">${UNLOAD_FORMATS.map(
+          (f) => html`<label class="check"><input type="radio" name="format" value="${f}"${fmt === f ? raw(' checked') : ''}> ${{ csv: 'CSV', json: 'JSON', xlsx: tx('ul.fmt.xlsx'), xml: 'XML', sql: tx('ul.fmt.sql') }[f]}</label>`,
         )}</div>
       </fieldset>
       <fieldset class="prop-group"><legend>CSV</legend><div class="form-grid">
-        <div class="field"><label class="label" for="f_delimiter">Separator</label>
-          <select id="f_delimiter" name="delimiter">${opt(CSV_DELIMITERS, 'delimiter', { comma: 'Comma ,', semicolon: 'Semicolon ;', tab: 'Tab', pipe: 'Pipe |' })}</select></div>
-        <div class="field"><label class="label" for="f_enclosure">Enclosed by</label>
-          <select id="f_enclosure" name="enclosure">${opt(CSV_ENCLOSURES, 'enclosure', { double: 'Double quote "', single: "Single quote '" })}</select>
-          <small class="help">Only values that contain the separator, the enclosure or a line break are enclosed.</small></div>
+        <div class="field"><label class="label" for="f_delimiter">${tx('ul.separator')}</label>
+          <select id="f_delimiter" name="delimiter">${opt(CSV_DELIMITERS, 'delimiter', { comma: tx('ul.sep.comma'), semicolon: tx('ul.sep.semicolon'), tab: tx('ul.sep.tab'), pipe: tx('ul.sep.pipe') })}</select></div>
+        <div class="field"><label class="label" for="f_enclosure">${tx('ul.enclosed')}</label>
+          <select id="f_enclosure" name="enclosure">${opt(CSV_ENCLOSURES, 'enclosure', { double: tx('ul.enc.double'), single: tx('ul.enc.single') })}</select>
+          <small class="help">${tx('ul.enclosed_help')}</small></div>
         <div class="field"><span class="label" aria-hidden="true"></span>
-          <label class="check"><input type="checkbox" name="header" value="1"${on('header')}> First row: column names</label>
-          <label class="check"><input type="checkbox" name="bom" value="1"${on('bom')}> UTF-8 byte order mark (for Excel)</label></div>
+          <label class="check"><input type="checkbox" name="header" value="1"${on('header')}> ${tx('ul.header')}</label>
+          <label class="check"><input type="checkbox" name="bom" value="1"${on('bom')}> ${tx('ul.bom')}</label></div>
       </div></fieldset>
       <fieldset class="prop-group"><legend>XML</legend><div class="form-grid">
-        <div class="field"><label class="label" for="f_root_tag">Root element</label><input id="f_root_tag" name="root_tag" value="${b.root_tag ?? DEFAULT_UNLOAD.rootTag}" maxlength="64"></div>
-        <div class="field"><label class="label" for="f_row_tag">Row element</label><input id="f_row_tag" name="row_tag" value="${b.row_tag ?? DEFAULT_UNLOAD.rowTag}" maxlength="64">
-          <small class="help">One child element per column; empty (null) values are left out.</small></div>
+        <div class="field"><label class="label" for="f_root_tag">${tx('ul.root')}</label><input id="f_root_tag" name="root_tag" value="${b.root_tag ?? DEFAULT_UNLOAD.rootTag}" maxlength="64"></div>
+        <div class="field"><label class="label" for="f_row_tag">${tx('ul.row')}</label><input id="f_row_tag" name="row_tag" value="${b.row_tag ?? DEFAULT_UNLOAD.rowTag}" maxlength="64">
+          <small class="help">${tx('ul.row_help')}</small></div>
       </div></fieldset>`;
   };
 
-  const sourceTabs = (active: 'table' | 'query') =>
-    html`<nav class="ide-tabs u-mb1" aria-label="Unload from">
-      <a class="ide-tab" href="${BASE}/sql/unload"${active === 'table' ? raw(' aria-current="page"') : ''}>${icon('table')}<span>Table or view</span></a>
-      <a class="ide-tab" href="${BASE}/sql/unload?source=query"${active === 'query' ? raw(' aria-current="page"') : ''}>${icon('code')}<span>Query</span></a></nav>`;
+  const sourceTabs = (tx: BuilderTranslate, active: 'table' | 'query') =>
+    html`<nav class="ide-tabs u-mb1" aria-label="${tx('ul.from')}">
+      <a class="ide-tab" href="${BASE}/sql/unload"${active === 'table' ? raw(' aria-current="page"') : ''}>${icon('table')}<span>${tx('ul.table_or_view')}</span></a>
+      <a class="ide-tab" href="${BASE}/sql/unload?source=query"${active === 'query' ? raw(' aria-current="page"') : ''}>${icon('code')}<span>${tx('sm.col.query')}</span></a></nav>`;
 
-  const intro = html`<p class="muted">Download the rows of a table, a view or a query as CSV, JSON, Excel or XML (up to ${DOWNLOAD_MAX_ROWS.toLocaleString('en')} rows).
-    Runs as the builder's owner connection (an isolated workspace's developer login for its developers) in a read-only transaction. To load a file into a table, use <a href="${BASE}/sql/load">Load Data</a>.</p>`;
+  const introOf = (tx: BuilderTranslate) => html`<p class="muted">${tx('ul.intro', { n: DOWNLOAD_MAX_ROWS.toLocaleString('en') })}
+    ${tx.rich('ul.intro2', { load: html`<a href="${BASE}/sql/load">${tx('sql.tool.load')}</a>` })}</p>`;
 
   const form = async (s: Session, b: Body, error?: string) => {
+    const tx = tr(s);
+    const intro = introOf(tx);
     const alert = error ? html`<div class="alert alert-error" role="alert">${error}</div>` : '';
     if (b.source === 'query')
-      return html`${intro}${sourceTabs('query')}${region(
-        'Unload a query',
+      return html`${intro}${sourceTabs(tx, 'query')}${region(
+        tx('ul.unload_query'),
         html`${alert}<form method="post" action="${BASE}/sql/unload">${csrf(s)}<input type="hidden" name="source" value="query">
-          <div class="field"><label class="label" for="f_query">Query</label>
+          <div class="field"><label class="label" for="f_query">${tx('sm.col.query')}</label>
             <textarea id="f_query" name="query" class="code sql-editor" rows="10" spellcheck="false" data-code="plpgsql" required>${b.query ?? ''}</textarea>
-            <small class="help">One SELECT (or WITH … SELECT) statement.</small></div>
-          ${formatFields(b)}
-          <div class="buttons"><button class="btn btn-hot">${icon('download')} Download</button></div></form>`,
+            <small class="help">${tx('ul.one_select')}</small></div>
+          ${formatFields(tx, b)}
+          <div class="buttons"><button class="btn btn-hot">${icon('download')} ${tx('scr.download')}</button></div></form>`,
       )}`;
     const rels = await relations();
     const rel = rels.find((r) => r.qname === b.table);
     let schema = '';
     const chooser = html`<form method="get" action="${BASE}/sql/unload" class="unload-pick">
-        <label class="sr-only" for="f_table">Table or view</label>
-        <select id="f_table" name="table" required><option value="">- choose a table or view -</option>${rels.map((r) => {
+        <label class="sr-only" for="f_table">${tx('ul.table_or_view')}</label>
+        <select id="f_table" name="table" required><option value="">${tx('ul.choose_table')}</option>${rels.map((r) => {
           const group = r.schema !== schema ? html`${schema ? raw('</optgroup>') : ''}<optgroup label="${(schema = r.schema)}">` : '';
-          return html`${group}<option value="${r.qname}"${r === rel ? raw(' selected') : ''}>${r.name}${r.kind === 'view' ? ' (view)' : ''}</option>`;
+          return html`${group}<option value="${r.qname}"${r === rel ? raw(' selected') : ''}>${r.name}${r.kind === 'view' ? ` ${tx('ul.view')}` : ''}</option>`;
         })}${schema ? raw('</optgroup>') : ''}</select>
-        <button class="btn">Choose</button></form>`;
-    if (!rel) return html`${intro}${sourceTabs('table')}${region('Unload a table or view', html`${alert}${chooser}`)}`;
+        <button class="btn">${tx('ul.choose')}</button></form>`;
+    if (!rel) return html`${intro}${sourceTabs(tx, 'table')}${region(tx('ul.unload_table'), html`${alert}${chooser}`)}`;
     const cols = await columns(rel.qname);
     const chosen = new Set(b.format !== undefined ? list(b.columns) : cols.map((c) => c.name));
-    return html`${intro}${sourceTabs('table')}${region(
-      `Unload ${rel.qname}`,
+    return html`${intro}${sourceTabs(tx, 'table')}${region(
+      tx('ul.unload_of', { name: rel.qname }),
       html`${alert}${chooser}
         <form method="post" action="${BASE}/sql/unload" class="u-mt1">${csrf(s)}<input type="hidden" name="source" value="table"><input type="hidden" name="table" value="${rel.qname}">
-          <fieldset class="prop-group"><legend>Columns</legend><div class="qb-pick">${cols.map(
+          <fieldset class="prop-group"><legend>${tx('ul.columns')}</legend><div class="qb-pick">${cols.map(
             (c) => html`<label class="check"><input type="checkbox" name="columns" value="${c.name}"${chosen.has(c.name) ? raw(' checked') : ''}> ${c.name} <span class="muted small">${c.type}</span></label>`,
           )}</div></fieldset>
           <div class="form-grid">
-            <div class="field"><label class="label" for="f_where">Where</label><input id="f_where" name="where" value="${b.where ?? ''}" placeholder="e.g. deptno = 10" class="code" spellcheck="false">
-              <small class="help">Optional: a condition, without the word WHERE.</small></div>
-            <div class="field"><label class="label" for="f_order">Order by</label><input id="f_order" name="order" value="${b.order ?? ''}" placeholder="e.g. 1, created desc" class="code" spellcheck="false">
-              <small class="help">Optional: columns, without the words ORDER BY.</small></div>
+            <div class="field"><label class="label" for="f_where">${tx('ul.where')}</label><input id="f_where" name="where" value="${b.where ?? ''}" placeholder="${tx('ul.eg', { x: 'deptno = 10' })}" class="code" spellcheck="false">
+              <small class="help">${tx('ul.where_help')}</small></div>
+            <div class="field"><label class="label" for="f_order">${tx('ul.order')}</label><input id="f_order" name="order" value="${b.order ?? ''}" placeholder="${tx('ul.eg', { x: '1, created desc' })}" class="code" spellcheck="false">
+              <small class="help">${tx('ul.order_help')}</small></div>
           </div>
-          ${formatFields(b)}
-          <div class="buttons"><button class="btn btn-hot">${icon('download')} Download</button></div></form>`,
+          ${formatFields(tx, b)}
+          <div class="buttons"><button class="btn btn-hot">${icon('download')} ${tx('scr.download')}</button></div></form>`,
     )}`;
   };
 
@@ -192,10 +196,10 @@ export async function unloadRoutes(app: FastifyInstance) {
         name = 'query';
       } else {
         const rel = (await relations()).find((r) => r.qname === b.table);
-        if (!rel) return refuse('Choose a table or view.');
+        if (!rel) return refuse(tr(s)('ul.err.table'));
         const known = new Set((await columns(rel.qname)).map((c) => c.name));
         const cols = list(b.columns).filter((c) => known.has(c));
-        if (!cols.length) return refuse('Choose at least one column.');
+        if (!cols.length) return refuse(tr(s)('ul.err.column'));
         const where = (b.where ?? '').trim();
         const order = (b.order ?? '').trim();
         // the WHERE and ORDER BY text is the developer's SQL: the whole statement must still be one SELECT
@@ -226,7 +230,7 @@ export async function unloadRoutes(app: FastifyInstance) {
     } catch (e) {
       await c.query('rollback').catch(() => {});
       c.release(true);
-      return refuse(`The query failed: ${(e as Error).message}`);
+      return refuse(tr(s)('ul.err.failed', { error: (e as Error).message }));
     }
     await logActivity({ username: s.username, event: 'sql_unload', ip: clientIp(req), detail: `${opts.format}: ${sql.length > 1900 ? `${sql.slice(0, 1900)}…` : sql}` });
     const out = new PassThrough();

package/src/builder/worksheet.ts

@@ -121,9 +121,9 @@ async function navigatorTree(db: Awaited<ReturnType<typeof workshopDb>>, schema:
   return html`<ul class="ws-tree" id="ws-tree">${objects.map((o) => {
     const list = cols.get(o.ref);
     const obLink = `${BASE}/sql/objects?${new URLSearchParams(o.type === 'policy' ? { schema, k: 'table', o: o.ref, tab: 'rls' } : { schema, k: o.type, o: o.ref })}`;
-    if (!list) return html`<li class="ws-obj" data-name="${o.name.toLowerCase()}"><a href="${obLink}" title="${label(o.type)}">${icon(iconOf(o.type))}<span>${o.name}</span></a>${objectMenu(schema, o)}</li>`;
+    if (!list) return html`<li class="ws-obj" data-name="${o.name.toLowerCase()}"><a href="${obLink}" title="${label(o.type)}">${icon(iconOf(o.type))}<span>${o.name}</span></a>${objectMenu(schema, o, tx)}</li>`;
     const st = objectStatements(schema, o.name, list, o.type);
-    return html`<li class="ws-obj" data-name="${o.name.toLowerCase()}">${objectMenu(schema, o)}<details>
+    return html`<li class="ws-obj" data-name="${o.name.toLowerCase()}">${objectMenu(schema, o, tx)}<details>
       <summary draggable="true" data-ws-sql="${st.select}" title="${tx('ws.nav.drag', { type: tx.lang === 'en' ? label(o.type).replace(/s$/, '') : label(o.type) })}">${icon(iconOf(o.type))}<span>${o.name}</span>${o.rls ? html`<span class="tag">RLS</span>` : ''}</summary>
       <ul class="ws-cols">${list.map((c) => html`<li title="${c.type}${c.notnull ? ' not null' : ''}">${c.pk ? icon('key') : icon('minus')}<span>${c.name}</span><small class="muted">${c.type}</small></li>`)}</ul>
       <div class="ws-obj-actions">
@@ -525,7 +525,7 @@ async function worksheet(req: Req, reply: FastifyReply) {
     else {
       const d = drawChart('', lastQuery.columns, lastQuery.data ?? [], spec);
       chartCss = d.css;
-      chartPane = html`${chartControls(lastQuery.columns, spec)}
+      chartPane = html`${chartControls(lastQuery.columns, spec, 'ch', tx)}
         <div class="ch-actions"><button class="btn btn-sm" name="mode" value="chart">${icon('refresh')} ${tx('ws.chart.again')}</button>
           <input type="hidden" name="chart_sql" value="${lastQuery.sql}">
           <label class="sr-only" for="ws-chart-name">${tx('ws.chart.name')}</label><input id="ws-chart-name" name="chart_name" placeholder="${tx('ws.chart.name')}" maxlength="120">

package/src/cron-schedule.ts

@@ -231,12 +231,12 @@ const pad = (n: number) => String(n).padStart(2, '0');
 const sorted = (s: Set<number>) => [...s].sort((a, b) => a - b);
 const isAll = (s: Set<number>, min: number, max: number) => s.size === max - min + 1;
 /** a list of numbers with runs as ranges: 1-5, 7 */
-function compact(values: number[], name: (n: number) => string = String) {
+function compact(values: number[], name: (n: number) => string = String, t: CronWords = EN_WORDS) {
   const out: string[] = [];
   for (let i = 0; i < values.length; i++) {
     let j = i;
     while (j + 1 < values.length && values[j + 1] === values[j] + 1) j++;
-    out.push(j - i >= 2 ? `${name(values[i])} to ${name(values[j])}` : j > i ? `${name(values[i])}, ${name(values[j])}` : name(values[i]));
+    out.push(j - i >= 2 ? fillWords(t('cron.range'), { from: name(values[i]), to: name(values[j]) }) : j > i ? `${name(values[i])}, ${name(values[j])}` : name(values[i]));
     i = j;
   }
   return out.join(', ');
@@ -250,33 +250,63 @@ function stepOf(s: Set<number>, min: number, max: number) {
 }
 
 /** The schedule in words ("At 02:00, every day"). */
-export function describeSchedule(s: Schedule): string {
-  if (s.kind === 'reboot') return 'When the database server starts';
-  if (s.kind === 'seconds') return s.seconds === 1 ? 'Every second' : `Every ${s.seconds} seconds`;
+/**
+ * (sprint 162, CD-8) The phrases of a schedule in words, by key: English here; the builder passes its translator
+ * (the same keys, cron.*, in src/builder/i18n/*.ts) and the language for the day and month names.
+ */
+export const EN_WORDS_TEXT: Record<string, string> = {
+  'cron.reboot': 'When the database server starts', 'cron.every_second': 'Every second', 'cron.every_seconds': 'Every {n} seconds',
+  'cron.every_minute': 'Every minute', 'cron.every_minutes': 'Every {n} minutes', 'cron.every_hour': 'Every hour',
+  'cron.minute_of_hour': 'At minute {m} of every hour', 'cron.minutes_of_hour': 'At minutes {list} of every hour', 'cron.at': 'At {times}',
+  'cron.at_minute': 'At minute {m}', 'cron.at_minutes': 'At minutes {list}', 'cron.of_every_hours': '{mins} of every {n} hours',
+  'cron.past_hours': '{mins} past hours {list}', 'cron.day_and_last': 'on day {list} and the last day of the month',
+  'cron.last_day': 'on the last day of the month', 'cron.day_of_month': 'on day {list} of the month', 'cron.weekdays': 'on weekdays',
+  'cron.on_days': 'on {list}', 'cron.a_days': 'a {list}', 'cron.either': '{dom} or {dow}', 'cron.if': '{dom} if it is {dow}',
+  'cron.every_day': 'every day', 'cron.in_months': 'in {list}', 'cron.range': '{from} to {to}',
+};
+export type CronWords = (key: string) => string;
+const EN_WORDS: CronWords = (k) => EN_WORDS_TEXT[k] ?? k;
+const fillWords = (text: string, p: Record<string, string | number>) => text.replace(/\{(\w+)\}/g, (m, k: string) => (k in p ? String(p[k]) : m));
+
+/** Day (0 = Sunday) and month (1 = January) names in a language (English: as before). */
+const dayName = (lang: string, d: number) => (lang === 'en' ? DAY_NAMES[d] : new Intl.DateTimeFormat(lang, { weekday: 'long', timeZone: 'UTC' }).format(new Date(Date.UTC(2023, 0, 1 + d))));
+const monthName = (lang: string, m: number) => (lang === 'en' ? MONTH_NAMES[m - 1] : new Intl.DateTimeFormat(lang, { month: 'long', timeZone: 'UTC' }).format(new Date(Date.UTC(2023, m - 1, 1))));
+
+export function describeSchedule(s: Schedule, t: CronWords = EN_WORDS, lang = 'en'): string {
+  const w = (key: string, p: Record<string, string | number> = {}) => fillWords(t(key), p);
+  const list = (v: number[], name?: (n: number) => string) => compact(v, name, t);
+  if (s.kind === 'reboot') return w('cron.reboot');
+  if (s.kind === 'seconds') return s.seconds === 1 ? w('cron.every_second') : w('cron.every_seconds', { n: s.seconds });
   const minutes = sorted(s.minutes);
   const hours = sorted(s.hours);
   let time: string;
-  if (isAll(s.minutes, 0, 59) && isAll(s.hours, 0, 23)) time = 'Every minute';
-  else if (isAll(s.hours, 0, 23)) {
+  // whether the time already says how often (then no "every day")
+  let often = false;
+  if (isAll(s.minutes, 0, 59) && isAll(s.hours, 0, 23)) {
+    time = w('cron.every_minute');
+    often = true;
+  } else if (isAll(s.hours, 0, 23)) {
     const step = stepOf(s.minutes, 0, 59);
-    time = step ? `Every ${step} minutes` : minutes.length === 1 ? (minutes[0] === 0 ? 'Every hour' : `At minute ${minutes[0]} of every hour`) : `At minutes ${compact(minutes)} of every hour`;
-  } else if (hours.length * minutes.length <= 6) time = `At ${hours.flatMap((h) => minutes.map((m) => `${pad(h)}:${pad(m)}`)).join(', ')}`;
+    often = true;
+    time = step ? w('cron.every_minutes', { n: step }) : minutes.length === 1 ? (minutes[0] === 0 ? w('cron.every_hour') : w('cron.minute_of_hour', { m: minutes[0] })) : w('cron.minutes_of_hour', { list: list(minutes) });
+  } else if (hours.length * minutes.length <= 6) time = w('cron.at', { times: hours.flatMap((h) => minutes.map((m) => `${pad(h)}:${pad(m)}`)).join(', ') });
   else {
     const step = stepOf(s.hours, 0, 23);
-    const mins = isAll(s.minutes, 0, 59) ? 'Every minute' : minutes.length === 1 ? `At minute ${minutes[0]}` : `At minutes ${compact(minutes)}`;
-    time = `${mins} ${step ? `of every ${step} hours` : `past hours ${compact(hours)}`}`;
+    const mins = isAll(s.minutes, 0, 59) ? w('cron.every_minute') : minutes.length === 1 ? w('cron.at_minute', { m: minutes[0] }) : w('cron.at_minutes', { list: list(minutes) });
+    time = step ? w('cron.of_every_hours', { mins, n: step }) : w('cron.past_hours', { mins, list: list(hours) });
   }
   const parts = [time];
   const domAll = isAll(s.days, 1, 31) && !s.lastDay;
   const dowAll = isAll(s.weekdays, 0, 6);
-  const dom = s.lastDay ? (s.days.size ? `on day ${compact(sorted(s.days))} and the last day of the month` : 'on the last day of the month') : `on day ${compact(sorted(s.days))} of the month`;
+  const dom = s.lastDay ? (s.days.size ? w('cron.day_and_last', { list: list(sorted(s.days)) }) : w('cron.last_day')) : w('cron.day_of_month', { list: list(sorted(s.days)) });
   const weekdays = sorted(s.weekdays);
-  const dow = weekdays.join() === '1,2,3,4,5' ? 'on weekdays' : `on ${compact(weekdays, (d) => DAY_NAMES[d])}`;
-  if (s.either) parts.push(`${dom} or ${dow}`);
-  else if (!domAll && !dowAll) parts.push(`${dom} if it is ${dow.replace(/^on /, 'a ')}`);
+  const days = list(weekdays, (d) => dayName(lang, d));
+  const dow = weekdays.join() === '1,2,3,4,5' ? w('cron.weekdays') : w('cron.on_days', { list: days });
+  if (s.either) parts.push(w('cron.either', { dom, dow }));
+  else if (!domAll && !dowAll) parts.push(w('cron.if', { dom, dow: weekdays.join() === '1,2,3,4,5' ? w('cron.weekdays') : w('cron.a_days', { list: days }) }));
   else if (!domAll) parts.push(dom);
   else if (!dowAll) parts.push(dow);
-  else if (time !== 'Every minute' && !/^Every \d+ minutes$|hour$/.test(time)) parts.push('every day');
-  if (!isAll(s.months, 1, 12)) parts.push(`in ${compact(sorted(s.months), (m) => MONTH_NAMES[m - 1])}`);
+  else if (!often) parts.push(w('cron.every_day'));
+  if (!isAll(s.months, 1, 12)) parts.push(w('cron.in_months', { list: list(sorted(s.months), (m) => monthName(lang, m)) }));
   return parts.join(', ');
 }

package/src/i18n/ar.ts

@@ -676,6 +676,11 @@ export const ar: Record<MessageKey, string> = {
   'process.queued': "بدأ في الخلفية (المهمة {id}).",
   'process.background_type': "لا يمكن تشغيل العملية «{name}» ({type}) في الخلفية.",
   'workflow.started': "بدأ مسار العمل {id}.",
+  'process.no_geocoder': 'لم يُعدّ أي محدِّد مواقع جغرافية لهذا التثبيت.',
+  'process.address_not_found': 'لم يُعثر على مكان لـ "{address}".',
+  'process.task_created': 'تم إنشاء المهمة {id}.',
+  'item.map_of': 'خريطة {position}',
+  'process.no_task': 'لا توجد مهمة للتعامل معها.',
   'workflow.terminated': "أُنهي مسار العمل {id}.",
   'workflow.retried': "يعمل مسار العمل {id} من جديد.",
   'workflow.no_instance': "لم يُحدد أي مسار عمل.",

package/src/i18n/cs.ts

@@ -676,6 +676,11 @@ export const cs: Record<MessageKey, string> = {
   'process.queued': "Spuštěno na pozadí (úloha {id}).",
   'process.background_type': "Proces „{name}“ ({type}) nemůže běžet na pozadí.",
   'workflow.started': "Pracovní postup {id} byl spuštěn.",
+  'process.no_geocoder': 'Tato instalace nemá nastavený geokodér.',
+  'process.address_not_found': 'Pro „{address}“ nebylo nalezeno žádné místo.',
+  'process.task_created': 'Úkol {id} byl vytvořen.',
+  'item.map_of': 'Mapa: {position}',
+  'process.no_task': 'Žádný úkol ke zpracování.',
   'workflow.terminated': "Pracovní postup {id} byl ukončen.",
   'workflow.retried': "Pracovní postup {id} běží znovu.",
   'workflow.no_instance': "Není vybrán žádný pracovní postup.",

package/src/i18n/da.ts

@@ -676,6 +676,11 @@ export const da: Record<MessageKey, string> = {
   'process.queued': "Startet i baggrunden (job {id}).",
   'process.background_type': "Processen “{name}” ({type}) kan ikke køre i baggrunden.",
   'workflow.started': "Arbejdsgang {id} er startet.",
+  'process.no_geocoder': 'Denne installation har ingen geokoder.',
+  'process.address_not_found': 'Intet sted fundet for "{address}".',
+  'process.task_created': 'Opgave {id} er oprettet.',
+  'item.map_of': 'Kort over {position}',
+  'process.no_task': 'Ingen opgave at behandle.',
   'workflow.terminated': "Arbejdsgang {id} er afsluttet.",
   'workflow.retried': "Arbejdsgang {id} kører igen.",
   'workflow.no_instance': "Ingen arbejdsgang er valgt.",

package/src/i18n/de.ts

@@ -686,6 +686,11 @@ export const de: Record<MessageKey, string> = {
   'process.queued': 'Im Hintergrund gestartet (Job {id}).',
   'process.background_type': 'Der Prozess "{name}" ({type}) kann nicht im Hintergrund laufen.',
   'workflow.started': 'Workflow {id} gestartet.',
+  'process.no_geocoder': 'Für diese Installation ist kein Geocoder eingerichtet.',
+  'process.address_not_found': 'Kein Ort für „{address}“ gefunden.',
+  'process.task_created': 'Aufgabe {id} wurde erstellt.',
+  'item.map_of': 'Karte von {position}',
+  'process.no_task': 'Keine Aufgabe zum Bearbeiten.',
   'workflow.terminated': 'Workflow {id} beendet.',
   'workflow.retried': 'Workflow {id} läuft wieder.',
   'workflow.no_instance': 'Es ist kein Workflow ausgewählt.',

package/src/i18n/el.ts

@@ -676,6 +676,11 @@ export const el: Record<MessageKey, string> = {
   'process.queued': "Ξεκίνησε στο παρασκήνιο (εργασία {id}).",
   'process.background_type': "Η διαδικασία «{name}» ({type}) δεν μπορεί να εκτελεστεί στο παρασκήνιο.",
   'workflow.started': "Η ροή εργασίας {id} ξεκίνησε.",
+  'process.no_geocoder': 'Δεν έχει ρυθμιστεί γεωκωδικοποιητής για αυτή την εγκατάσταση.',
+  'process.address_not_found': 'Δεν βρέθηκε τοποθεσία για «{address}».',
+  'process.task_created': 'Η εργασία {id} δημιουργήθηκε.',
+  'item.map_of': 'Χάρτης του {position}',
+  'process.no_task': 'Δεν υπάρχει εργασία για ενέργεια.',
   'workflow.terminated': "Η ροή εργασίας {id} τερματίστηκε.",
   'workflow.retried': "Η ροή εργασίας {id} εκτελείται ξανά.",
   'workflow.no_instance': "Δεν έχει επιλεγεί ροή εργασίας.",

package/src/i18n/es.ts

@@ -686,6 +686,11 @@ export const es: Record<MessageKey, string> = {
   'process.queued': 'Iniciado en segundo plano (trabajo {id}).',
   'process.background_type': 'El proceso "{name}" ({type}) no se puede ejecutar en segundo plano.',
   'workflow.started': 'Flujo de trabajo {id} iniciado.',
+  'process.no_geocoder': 'Esta instalación no tiene un geocodificador configurado.',
+  'process.address_not_found': 'No se encontró ningún lugar para "{address}".',
+  'process.task_created': 'Tarea {id} creada.',
+  'item.map_of': 'Mapa de {position}',
+  'process.no_task': 'No hay ninguna tarea sobre la que actuar.',
   'workflow.terminated': 'Flujo de trabajo {id} terminado.',
   'workflow.retried': 'El flujo de trabajo {id} se está ejecutando de nuevo.',
   'workflow.no_instance': 'No hay ningún flujo de trabajo seleccionado.',

package/src/i18n/fi.ts

@@ -676,6 +676,11 @@ export const fi: Record<MessageKey, string> = {
   'process.queued': "Käynnistetty taustalla (työ {id}).",
   'process.background_type': "Prosessia ”{name}” ({type}) ei voi suorittaa taustalla.",
   'workflow.started': "Työnkulku {id} käynnistetty.",
+  'process.no_geocoder': 'Tälle asennukselle ei ole määritetty geokoodaajaa.',
+  'process.address_not_found': 'Paikkaa ei löytynyt haulle "{address}".',
+  'process.task_created': 'Tehtävä {id} luotiin.',
+  'item.map_of': 'Kartta: {position}',
+  'process.no_task': 'Ei käsiteltävää tehtävää.',
   'workflow.terminated': "Työnkulku {id} lopetettu.",
   'workflow.retried': "Työnkulku {id} on taas käynnissä.",
   'workflow.no_instance': "Työnkulkua ei ole valittu.",

package/src/i18n/fr.ts

@@ -686,6 +686,11 @@ export const fr: Record<MessageKey, string> = {
   'process.queued': 'Démarré en arrière-plan (tâche {id}).',
   'process.background_type': 'Le processus « {name} » ({type}) ne peut pas s’exécuter en arrière-plan.',
   'workflow.started': 'Workflow {id} démarré.',
+  'process.no_geocoder': 'Aucun géocodeur n\'est configuré pour cette installation.',
+  'process.address_not_found': 'Aucun lieu trouvé pour « {address} ».',
+  'process.task_created': 'Tâche {id} créée.',
+  'item.map_of': 'Carte de {position}',
+  'process.no_task': 'Aucune tâche à traiter.',
   'workflow.terminated': 'Workflow {id} arrêté.',
   'workflow.retried': 'Workflow {id} relancé.',
   'workflow.no_instance': 'Aucun workflow n’est sélectionné.',

package/src/i18n/he.ts

@@ -676,6 +676,11 @@ export const he: Record<MessageKey, string> = {
   'process.queued': "הופעל ברקע (עבודה {id}).",
   'process.background_type': "התהליך \"{name}\" ({type}) אינו יכול לפעול ברקע.",
   'workflow.started': "תהליך העבודה {id} הופעל.",
+  'process.no_geocoder': 'לא הוגדר מקודד גאוגרפי בהתקנה זו.',
+  'process.address_not_found': 'לא נמצא מקום עבור "{address}".',
+  'process.task_created': 'המשימה {id} נוצרה.',
+  'item.map_of': 'מפה של {position}',
+  'process.no_task': 'אין משימה לטיפול.',
   'workflow.terminated': "תהליך העבודה {id} הופסק.",
   'workflow.retried': "תהליך העבודה {id} פועל שוב.",
   'workflow.no_instance': "לא נבחר תהליך עבודה.",

package/src/i18n/it.ts

@@ -676,6 +676,11 @@ export const it: Record<MessageKey, string> = {
   'process.queued': "Avviato in background (job {id}).",
   'process.background_type': "Il processo “{name}” ({type}) non può essere eseguito in background.",
   'workflow.started': "Workflow {id} avviato.",
+  'process.no_geocoder': 'Nessun geocodificatore configurato per questa installazione.',
+  'process.address_not_found': 'Nessun luogo trovato per "{address}".',
+  'process.task_created': 'Attività {id} creata.',
+  'item.map_of': 'Mappa di {position}',
+  'process.no_task': 'Nessuna attività da gestire.',
   'workflow.terminated': "Workflow {id} terminato.",
   'workflow.retried': "Il workflow {id} è di nuovo in esecuzione.",
   'workflow.no_instance': "Nessun workflow selezionato.",

package/src/i18n/ja.ts

@@ -676,6 +676,11 @@ export const ja: Record<MessageKey, string> = {
   'process.queued': "バックグラウンドで開始しました (ジョブ {id})。",
   'process.background_type': "プロセス「{name}」({type}) はバックグラウンドで実行できません。",
   'workflow.started': "ワークフロー {id} を開始しました。",
+  'process.no_geocoder': 'このインストールにはジオコーダーが設定されていません。',
+  'process.address_not_found': '「{address}」の場所が見つかりません。',
+  'process.task_created': 'タスク {id} を作成しました。',
+  'item.map_of': '{position} の地図',
+  'process.no_task': '処理するタスクがありません。',
   'workflow.terminated': "ワークフロー {id} を終了しました。",
   'workflow.retried': "ワークフロー {id} を再実行しています。",
   'workflow.no_instance': "ワークフローが選択されていません。",

package/src/i18n/ko.ts

@@ -676,6 +676,11 @@ export const ko: Record<MessageKey, string> = {
   'process.queued': "백그라운드에서 시작했습니다(작업 {id}).",
   'process.background_type': "프로세스 '{name}'({type})은(는) 백그라운드에서 실행할 수 없습니다.",
   'workflow.started': "워크플로 {id}을(를) 시작했습니다.",
+  'process.no_geocoder': '이 설치에는 지오코더가 설정되어 있지 않습니다.',
+  'process.address_not_found': '"{address}"에 대한 장소를 찾을 수 없습니다.',
+  'process.task_created': '작업 {id}이(가) 생성되었습니다.',
+  'item.map_of': '{position} 지도',
+  'process.no_task': '처리할 작업이 없습니다.',
   'workflow.terminated': "워크플로 {id}을(를) 종료했습니다.",
   'workflow.retried': "워크플로 {id}이(가) 다시 실행 중입니다.",
   'workflow.no_instance': "선택한 워크플로가 없습니다.",

package/src/i18n/nb.ts

@@ -676,6 +676,11 @@ export const nb: Record<MessageKey, string> = {
   'process.queued': "Startet i bakgrunnen (jobb {id}).",
   'process.background_type': "Prosessen «{name}» ({type}) kan ikke kjøre i bakgrunnen.",
   'workflow.started': "Arbeidsflyt {id} er startet.",
+  'process.no_geocoder': 'Denne installasjonen har ingen geokoder.',
+  'process.address_not_found': 'Fant ikke noe sted for «{address}».',
+  'process.task_created': 'Oppgave {id} er opprettet.',
+  'item.map_of': 'Kart over {position}',
+  'process.no_task': 'Ingen oppgave å behandle.',
   'workflow.terminated': "Arbeidsflyt {id} er avsluttet.",
   'workflow.retried': "Arbeidsflyt {id} kjører igjen.",
   'workflow.no_instance': "Ingen arbeidsflyt er valgt.",

package/src/i18n/pl.ts

@@ -676,6 +676,11 @@ export const pl: Record<MessageKey, string> = {
   'process.queued': "Uruchomiono w tle (zadanie {id}).",
   'process.background_type': "Proces „{name}” ({type}) nie może działać w tle.",
   'workflow.started': "Przepływ pracy {id} uruchomiony.",
+  'process.no_geocoder': 'Ta instalacja nie ma skonfigurowanego geokodera.',
+  'process.address_not_found': 'Nie znaleziono miejsca dla „{address}”.',
+  'process.task_created': 'Utworzono zadanie {id}.',
+  'item.map_of': 'Mapa: {position}',
+  'process.no_task': 'Brak zadania do obsłużenia.',
   'workflow.terminated': "Przepływ pracy {id} przerwany.",
   'workflow.retried': "Przepływ pracy {id} działa ponownie.",
   'workflow.no_instance': "Nie wybrano przepływu pracy.",

package/src/i18n/pt.ts

@@ -676,6 +676,11 @@ export const pt: Record<MessageKey, string> = {
   'process.queued': "Iniciado em segundo plano (tarefa {id}).",
   'process.background_type': "O processo “{name}” ({type}) não pode ser executado em segundo plano.",
   'workflow.started': "Fluxo de trabalho {id} iniciado.",
+  'process.no_geocoder': 'Esta instalação não tem um geocodificador configurado.',
+  'process.address_not_found': 'Nenhum lugar encontrado para "{address}".',
+  'process.task_created': 'Tarefa {id} criada.',
+  'item.map_of': 'Mapa de {position}',
+  'process.no_task': 'Nenhuma tarefa para tratar.',
   'workflow.terminated': "Fluxo de trabalho {id} terminado.",
   'workflow.retried': "O fluxo de trabalho {id} está novamente em execução.",
   'workflow.no_instance': "Nenhum fluxo de trabalho selecionado.",