pgkiln 0.83.0 → 0.85.0

package/src/builder/utilities.ts

@@ -6,6 +6,7 @@ import { html, raw, type Raw } from '../html.ts';
 import { icon, ICONS, LUCIDE_VERSION, lucideNames, searchIcons } from '../icons.ts';
 import { appOfPath } from './locks.ts';
 import { appHeader, BASE, designerUrl, developer, region, select, send, shell, type Req } from './ui.ts';
+import { scopedTx as tx } from './i18n.ts';
 
 // (sprint 138, AP-5) App Builder → an application's Utilities (APEX: Application
 // Utilities): one page for what an application's maintenance needs, the tools
@@ -76,34 +77,34 @@ export async function utilityRoutes(app: FastifyInstance) {
     const u = `${BASE}/apps/${a.id}`;
     const main = html`${appHeader(a, 'utilities', s)}
       <div class="ab-tiles ab-tiles-wrap util-tiles">
-        ${card(`${u}/advisor`, 'check', 'Advisor', 'Plans every SQL statement as the application\'s role and checks every reference.')}
-        ${card(`${u}/utilities/dependencies`, 'database', 'Database object dependencies', 'The tables, views, sequences and functions the application uses, missing ones and missing grants.')}
-        ${card(`${u}/utilities/history`, 'history', 'Change history', 'Who changed which component and when, with the differences.')}
-        ${card(`${u}/utilities/upgrade`, 'refresh', 'Upgrade application', 'Components that can use a newer default of this pgkiln version.')}
-        ${card(`${BASE}/ui-defaults`, 'sliders-horizontal', 'UI defaults', 'Labels, format masks, help and lists of values per table column, used by the page wizards.')}
-        ${card(`${u}/search`, 'search', 'Search', 'Names, SQL, conditions, settings and help texts of every component.')}
-        ${card(`${u}/debug`, 'list', 'Debug messages', 'Timed steps of each request and messages from meta.debug().')}
-        ${card(`${u}/activity`, 'activity', 'Activity', 'Page views, errors, sign-ins and the application\'s logs.')}
-        ${card(`${u}/backups`, 'archive', 'Backups', 'Back up now, download and restore earlier versions.')}
-        ${card(`${u}/working-copies`, 'layers', 'Working copies', 'Change a copy, compare it and merge it back.')}
-        ${card(`${u}/export`, 'download', 'Export', `The application as a file (checksum ${shortSum(sum)}).`)}
-        ${card(`${BASE}/icons`, 'image', 'Icons', 'Browse the icons the icon picker offers.')}
+        ${card(`${u}/advisor`, 'check', tx('util.c_advisor'), tx('util.plans_every_sql_statement_as'))}
+        ${card(`${u}/utilities/dependencies`, 'database', tx('util.c_deps'), tx('util.the_tables_views_sequences_and'))}
+        ${card(`${u}/utilities/history`, 'history', tx('util.c_history'), tx('util.who_changed_which_component_and'))}
+        ${card(`${u}/utilities/upgrade`, 'refresh', tx('util.c_upgrade'), tx('util.components_that_can_use_a'))}
+        ${card(`${BASE}/ui-defaults`, 'sliders-horizontal', tx('util.c_ui_defaults'), tx('util.labels_format_masks_help_and'))}
+        ${card(`${u}/search`, 'search', tx('util.c_search'), tx('util.names_sql_conditions_settings_and'))}
+        ${card(`${u}/debug`, 'list', tx('util.c_debug'), tx('util.timed_steps_of_each_request'))}
+        ${card(`${u}/activity`, 'activity', tx('util.c_activity'), tx('util.page_views_errors_sign_ins'))}
+        ${card(`${u}/backups`, 'archive', tx('util.c_backups'), tx('util.back_up_now_download_and'))}
+        ${card(`${u}/working-copies`, 'layers', tx('util.c_wc'), tx('util.change_a_copy_compare_it'))}
+        ${card(`${u}/export`, 'download', tx('util.c_export'), tx('util.export_text', { sum: shortSum(sum) }))}
+        ${card(`${BASE}/icons`, 'image', tx('util.c_icons'), tx('util.browse_the_icons_the_icon'))}
       </div>
-      ${region('Application dashboard', html`<dl class="util-stats">
-          <div><dt>Pages</dt><dd>${counts.pages}</dd></div><div><dt>Regions</dt><dd>${counts.regions}</dd></div>
-          <div><dt>Items</dt><dd>${counts.items}</dd></div><div><dt>Processes</dt><dd>${counts.processes}</dd></div>
-          <div><dt>Lists of values</dt><dd>${counts.lovs}</dd></div><div><dt>Changes in 7 days</dt><dd>${counts.week}</dd></div>
+      ${region(tx('util.application_dashboard'), html`<dl class="util-stats">
+          <div><dt>${tx('util.pages')}</dt><dd>${counts.pages}</dd></div><div><dt>${tx('util.regions')}</dt><dd>${counts.regions}</dd></div>
+          <div><dt>${tx('util.items')}</dt><dd>${counts.items}</dd></div><div><dt>${tx('util.processes')}</dt><dd>${counts.processes}</dd></div>
+          <div><dt>${tx('util.lists_of_values')}</dt><dd>${counts.lovs}</dd></div><div><dt>${tx('util.changes_in_7_days')}</dt><dd>${counts.week}</dd></div>
         </dl>`)}
-      ${region('Recently updated pages', recent.length
-        ? html`<div class="table-wrap"><table class="table report-reflow"><thead><tr><th scope="col">Page</th><th scope="col">Last change</th><th scope="col">By</th><th scope="col">Changes</th></tr></thead><tbody>
-            ${recent.map((r) => html`<tr><td data-label="Page"><a href="${designerUrl(a.id, r.page_no)}">${r.page_no}${pageName.has(r.page_no) ? `: ${pageName.get(r.page_no)}` : ''}</a></td><td data-label="Last change">${when(r.changed_at)}</td>
-              <td data-label="By">${r.changed_by ?? 'command line'}</td><td data-label="Changes"><a href="${u}/utilities/history?page=${r.page_no}">${r.n}</a></td></tr>`)}</tbody></table></div>`
-        : html`<p class="muted u-mt0">No recorded changes yet: the change history starts with the first change after the upgrade to this version.</p>`)}
-      ${region('Application checksum', html`<p class="u-mt0">The checksum of the application's definition (its export without the alias): the same definition gives the same checksum on any installation, so two installations, or an application and its working copy, compare at a glance.</p>
+      ${region(tx('util.recently_updated_pages'), recent.length
+        ? html`<div class="table-wrap"><table class="table report-reflow"><thead><tr><th scope="col">${tx('util.page')}</th><th scope="col">${tx('util.last_change')}</th><th scope="col">${tx('util.by')}</th><th scope="col">${tx('util.changes')}</th></tr></thead><tbody>
+            ${recent.map((r) => html`<tr><td data-label="${tx('util.page')}"><a href="${designerUrl(a.id, r.page_no)}">${r.page_no}${pageName.has(r.page_no) ? `: ${pageName.get(r.page_no)}` : ''}</a></td><td data-label="${tx('util.last_change')}">${when(r.changed_at)}</td>
+              <td data-label="${tx('util.by')}">${r.changed_by ?? 'command line'}</td><td data-label="${tx('util.changes')}"><a href="${u}/utilities/history?page=${r.page_no}">${r.n}</a></td></tr>`)}</tbody></table></div>`
+        : html`<p class="muted u-mt0">${tx('util.no_recorded_changes_yet_the')}</p>`)}
+      ${region(tx('util.application_checksum'), html`<p class="u-mt0">${tx('util.the_checksum_of_the_application')}</p>
         <p class="util-sum"><code>${sum}</code></p>
-        <details><summary>Page checksums (${pageSums.size})</summary><div class="table-wrap"><table class="table report-reflow"><thead><tr><th scope="col">Page</th><th scope="col">Checksum</th></tr></thead><tbody>
-          ${[...pageSums].map(([p, h]) => html`<tr><td data-label="Page">${p}${pageName.has(p) ? `: ${pageName.get(p)}` : ''}</td><td data-label="Checksum"><code>${shortSum(h)}</code></td></tr>`)}</tbody></table></div></details>`, '', 'checksum')}`;
-    return send(reply, s, shell(s, `Utilities · ${a.name}`, [['App Builder', BASE], [a.name, u], ['Utilities']], main));
+        <details><summary>Page checksums (${pageSums.size})</summary><div class="table-wrap"><table class="table report-reflow"><thead><tr><th scope="col">${tx('util.page')}</th><th scope="col">${tx('util.checksum')}</th></tr></thead><tbody>
+          ${[...pageSums].map(([p, h]) => html`<tr><td data-label="${tx('util.page')}">${p}${pageName.has(p) ? `: ${pageName.get(p)}` : ''}</td><td data-label="${tx('util.checksum')}"><code>${shortSum(h)}</code></td></tr>`)}</tbody></table></div></details>`, '', 'checksum')}`;
+    return send(reply, s, shell(s, tx('util.title', { app: a.name }), [[tx('util.app_builder'), BASE], [a.name, u], [tx('util.utilities')]], main));
   });
 
   // ---------------------------------------------------------------- change history
@@ -141,23 +142,23 @@ export async function utilityRoutes(app: FastifyInstance) {
     const link = (id: string) => `?${new URLSearchParams([...keep, ['c', id]])}#change`;
     const OPS: Record<string, string> = { added: 'tag-info', changed: 'tag-warning', deleted: 'tag-error' };
     const main = html`${appHeader(a, 'utilities', s)}
-      ${region('Change history', html`<p class="muted u-mt0">Every change made in the builder (and every import, restore or merge) is compared with the application before it: each component that was added, changed or deleted is listed here with who and when. Changes from the command line or the MCP server have no developer.</p>
+      ${region(tx('util.change_history'), html`<p class="muted u-mt0">${tx('util.every_change_made_in_the')}</p>
         <form method="get" class="util-filters">
-          ${select('dev', 'Developer', dev, [['', 'All'], ...devs.map((d): [string, string] => (d === null ? ['(command line)', 'Command line / import'] : [d, d]))])}
-          <div class="field"><label class="label" for="f_from">From</label><input id="f_from" name="from" type="date" value="${from}"></div>
-          <div class="field"><label class="label" for="f_to">To</label><input id="f_to" name="to" type="date" value="${to}"></div>
-          <div class="field"><label class="label" for="f_page">Page</label><input id="f_page" name="page" type="number" value="${page ?? ''}"></div>
-          <div class="field"><label class="label" for="f_q">Component</label><input id="f_q" name="q" type="search" value="${text}" placeholder="e.g. P3_ID"></div>
-          <div class="buttons"><button class="btn btn-sm">${icon('filter')} Show</button></div></form>
+          ${select('dev', tx('util.developer'), dev, [['', tx('util.all')], ...devs.map((d): [string, string] => (d === null ? ['(command line)', tx('util.cmd_line')] : [d, d]))])}
+          <div class="field"><label class="label" for="f_from">${tx('util.from')}</label><input id="f_from" name="from" type="date" value="${from}"></div>
+          <div class="field"><label class="label" for="f_to">${tx('util.to')}</label><input id="f_to" name="to" type="date" value="${to}"></div>
+          <div class="field"><label class="label" for="f_page">${tx('util.page')}</label><input id="f_page" name="page" type="number" value="${page ?? ''}"></div>
+          <div class="field"><label class="label" for="f_q">${tx('util.component')}</label><input id="f_q" name="q" type="search" value="${text}" placeholder="${tx('util.e_g_p3_id')}"></div>
+          <div class="buttons"><button class="btn btn-sm">${icon('filter')} ${tx('util.show')}</button></div></form>
         ${rows.length
-          ? html`<div class="table-wrap"><table class="table util-history report-reflow"><thead><tr><th scope="col">When</th><th scope="col">Developer</th><th scope="col">Component</th><th scope="col">Change</th><th scope="col">Differences</th></tr></thead><tbody>
-              ${rows.map((r) => html`<tr${r.id === shown ? raw(' aria-current="true"') : ''}><td data-label="When">${when(r.changed_at)}</td><td data-label="Developer">${r.changed_by ?? html`<span class="muted">${r.source === 'import' ? 'import' : 'command line'}</span>`}</td>
-                <td data-label="Component"><a href="${componentUrl(a.id, r.page_no)}">${r.label}</a></td>
-                <td data-label="Change"><span class="tag ${OPS[r.op] ?? ''}">${r.op}</span>${r.source !== 'builder' ? html` <span class="tag">${r.source}</span>` : ''}</td>
-                <td data-label="Differences"><a class="btn btn-sm" href="${link(r.id)}">Show</a></td></tr>`)}</tbody></table></div>`
-          : html`<p class="muted">No changes${where.length > 1 ? ' with these filters' : ' recorded yet'}.</p>`}`)}
-      ${detail ? region(`Differences: ${detail.label}`, html`<p class="muted u-mt0">${detail.op} by ${detail.changed_by ?? 'the command line'}, ${when(detail.changed_at)}. Lines with <code>-</code> are before the change, lines with <code>+</code> after it.</p>${changeDiff(detail.before, detail.after)}`, '', 'change') : ''}`;
-    return send(reply, s, shell(s, `Change history · ${a.name}`, [['App Builder', BASE], [a.name, `${BASE}/apps/${a.id}`], ['Utilities', `${BASE}/apps/${a.id}/utilities`], ['Change history']], main));
+          ? html`<div class="table-wrap"><table class="table util-history report-reflow"><thead><tr><th scope="col">${tx('util.when')}</th><th scope="col">${tx('util.developer')}</th><th scope="col">${tx('util.component')}</th><th scope="col">${tx('util.change')}</th><th scope="col">${tx('util.differences')}</th></tr></thead><tbody>
+              ${rows.map((r) => html`<tr${r.id === shown ? raw(' aria-current="true"') : ''}><td data-label="${tx('util.when')}">${when(r.changed_at)}</td><td data-label="${tx('util.developer')}">${r.changed_by ?? html`<span class="muted">${r.source === 'import' ? tx('util.import') : tx('util.command_line')}</span>`}</td>
+                <td data-label="${tx('util.component')}"><a href="${componentUrl(a.id, r.page_no)}">${r.label}</a></td>
+                <td data-label="${tx('util.change')}"><span class="tag ${OPS[r.op] ?? ''}">${tx.dyn(`util.op.${r.op}`, r.op)}</span>${r.source !== 'builder' ? html` <span class="tag">${r.source}</span>` : ''}</td>
+                <td data-label="${tx('util.differences')}"><a class="btn btn-sm" href="${link(r.id)}">${tx('util.show')}</a></td></tr>`)}</tbody></table></div>`
+          : html`<p class="muted">${where.length > 1 ? tx('util.no_changes_filtered') : tx('util.no_changes')}</p>`}`)}
+      ${detail ? region(tx('util.diff_title', { label: detail.label }), html`<p class="muted u-mt0">${tx.rich('util.diff_intro', { op: tx.dyn(`util.op.${detail.op}`, detail.op), who: detail.changed_by ?? tx('util.the_command_line'), when: when(detail.changed_at), minus: html`<code>-</code>`, plus: html`<code>+</code>` })}</p>${changeDiff(detail.before, detail.after)}`, '', 'change') : ''}`;
+    return send(reply, s, shell(s, tx('util.history_title', { app: a.name }), [[tx('util.app_builder'), BASE], [a.name, `${BASE}/apps/${a.id}`], [tx('util.utilities'), `${BASE}/apps/${a.id}/utilities`], [tx('util.change_history')]], main));
   });
 
   // ---------------------------------------------------------------- icons
@@ -169,13 +170,13 @@ export async function utilityRoutes(app: FastifyInstance) {
     const own = (ICONS as readonly string[]).filter((n) => !needle || n.includes(needle));
     const lucide = needle ? searchIcons(q, 300) : [];
     const tile = (n: string) => html`<li><span class="icon-tile">${icon(n, 'icon icon-2x')}<code>${n}</code></span></li>`;
-    const main = html`<h1 class="u-mb1">Icons</h1>
-      ${region('Icon browser', html`<p class="muted u-mt0">The icons of the icon picker: pgkiln's own set and ${String(lucideNames().size)} Lucide icons (${LUCIDE_VERSION}, ISC licence). Use the name in an icon field; modifiers such as <code>lg</code>, <code>spin</code> or <code>success</code> may follow it (e.g. <code>truck lg success</code>), and Font APEX names work where Lucide has the same icon (<code>fa-users</code>).</p>
-        <form method="get" role="search" class="util-filters"><div class="field"><label class="label" for="f_icon_q">Search</label><input id="f_icon_q" name="q" type="search" value="${q}" placeholder="e.g. truck, money, arrow"></div>
-          <div class="buttons"><button class="btn btn-sm">${icon('search')} Search</button></div></form>
+    const main = html`<h1 class="u-mb1">${tx('util.icons')}</h1>
+      ${region(tx('util.icon_browser'), html`<p class="muted u-mt0">${tx.rich('util.icons_intro', { n: String(lucideNames().size), version: LUCIDE_VERSION, lg: html`<code>lg</code>`, spin: html`<code>spin</code>`, success: html`<code>success</code>`, example: html`<code>truck lg success</code>`, fa: html`<code>fa-users</code>` })}</p>
+        <form method="get" role="search" class="util-filters"><div class="field"><label class="label" for="f_icon_q">${tx('util.search')}</label><input id="f_icon_q" name="q" type="search" value="${q}" placeholder="${tx('util.e_g_truck_money_arrow')}"></div>
+          <div class="buttons"><button class="btn btn-sm">${icon('search')} ${tx('util.search')}</button></div></form>
         <h3>pgkiln (${own.length})</h3><ul class="util-icons">${own.map(tile)}</ul>
-        ${needle ? html`<h3>Lucide (${lucide.length}${lucide.length === 300 ? '+' : ''})</h3>${lucide.length ? html`<ul class="util-icons">${lucide.map(tile)}</ul>` : html`<p class="muted">No Lucide icon matches.</p>`}`
-          : html`<p class="muted">Search to see the matching Lucide icons.</p>`}`)}`;
-    return send(reply, s, shell(s, 'Icons', [['App Builder', BASE], ['Workspace utilities', `${BASE}/utilities`], ['Icons']], main));
+        ${needle ? html`<h3>Lucide (${lucide.length}${lucide.length === 300 ? '+' : ''})</h3>${lucide.length ? html`<ul class="util-icons">${lucide.map(tile)}</ul>` : html`<p class="muted">${tx('util.no_lucide_icon_matches')}</p>`}`
+          : html`<p class="muted">${tx('util.search_to_see_the_matching')}</p>`}`)}`;
+    return send(reply, s, shell(s, tx('util.icons'), [[tx('util.app_builder'), BASE], [tx('util.workspace_utilities'), `${BASE}/utilities`], [tx('util.icons')]], main));
   });
 }

package/src/builder/vector-providers.ts

@@ -13,6 +13,7 @@ import { appOr404 } from './forms.ts';
 import { isAdmin } from './locks.ts';
 import { appHeader, back, BASE, csrf, developer, flash, input, region, select, send, shell, type Req } from './ui.ts';
 import { currentWorkspace, inWorkspaceSql } from './workspaces.ts';
+import { scopedTx as tx } from './i18n.ts';
 
 // (sprint 136, AP-1; APEX: Workspace Utilities and Shared Components → Vector Providers)
 //
@@ -29,20 +30,20 @@ type Body = Record<string, string | string[] | undefined>;
 const one = (v: string | string[] | undefined) => (Array.isArray(v) ? v[0] : v) ?? '';
 
 const crumbs = (a: { id: number; name: string }, last?: string): [string, string?][] => [
-  ['App Builder', BASE], [a.name, `${BASE}/apps/${a.id}`], ['Shared Components', `${BASE}/apps/${a.id}/shared`],
-  ...(last ? [['Vector providers', `${BASE}/apps/${a.id}/vector-providers`], [last]] as [string, string?][] : [['Vector providers']] as [string, string?][]),
+  [tx('vp.app_builder'), BASE], [a.name, `${BASE}/apps/${a.id}`], [tx('vp.shared_components'), `${BASE}/apps/${a.id}/shared`],
+  ...(last ? [[tx('vp.vector_providers'), `${BASE}/apps/${a.id}/vector-providers`], [last]] as [string, string?][] : [[tx('vp.vector_providers')]] as [string, string?][]),
 ];
 
 /** pgvector's state as a short paragraph (with how to get it). */
 export function pgvectorNote(st: PgvectorStatus, admin: boolean, s: Session): Raw {
-  if (st.installed) return html`<p class="muted u-mt0">${icon('check')} pgvector ${st.version} is installed (schema <code>${st.schema}</code>).</p>`;
-  return html`<div class="alert alert-info" role="status"><p><strong>pgvector is not installed in this database.</strong>
-    Vector providers can be defined, but vector columns, vector search and Retrieve tools need the extension.</p>
+  if (st.installed) return html`<p class="muted u-mt0">${icon('check')} ${tx.rich('vp.installed', { version: st.version ?? '', schema: html`<code>${st.schema}</code>` })}</p>`;
+  return html`<div class="alert alert-info" role="status"><p><strong>${tx('vp.pgvector_is_not_installed_in')}</strong>
+    ${tx('vp.not_installed_detail')}</p>
     ${st.available
       ? admin && st.canCreate
-        ? html`<form method="post" action="${BASE}/vector-providers/extension">${csrf(s)}<button class="btn btn-hot">${icon('plus')} Create extension vector ${st.availableVersion}</button></form>`
-        : html`<p>The database server has pgvector ${st.availableVersion}: ${admin ? 'a superuser' : 'an administrator'} runs <code>create extension vector;</code> in this database.</p>`
-      : html`<p>The database server doesn't have the pgvector package: install it (for example <code>apt install postgresql-17-pgvector</code>, the <code>pgvector/pgvector:pg17</code> Docker image, or your cloud provider's <i>vector</i> extension), then create the extension.</p>`}
+        ? html`<form method="post" action="${BASE}/vector-providers/extension">${csrf(s)}<button class="btn btn-hot">${icon('plus')} ${tx('vp.create_extension', { version: st.availableVersion ?? '' })}</button></form>`
+        : html`<p>${tx.rich('vp.has_pgvector', { version: st.availableVersion ?? '', who: admin ? tx('vp.a_superuser') : tx('vp.an_administrator'), sql: html`<code>create extension vector;</code>` })}</p>`
+      : html`<p>${tx.rich('vp.no_package', { apt: html`<code>apt install postgresql-17-pgvector</code>`, docker: html`<code>pgvector/pgvector:pg17</code>`, vector: html`<i>vector</i>` })}</p>`}
   </div>`;
 }
 
@@ -64,60 +65,60 @@ async function providerForm(a: any, s: Session, x: Partial<VectorProvider>, orig
   const columns = original ? (await vectorTriggers(await devDbForApp(a.id))).filter((t) => t.appId === a.id && t.provider === original) : [];
   return html`${problems.length ? html`<div class="alert alert-error" role="alert">${problems.join(' ')}</div>` : ''}
     <form method="post" action="${BASE}/apps/${a.id}/vector-providers/provider">${csrf(s)}<input type="hidden" name="original" value="${original}">
-      <fieldset class="prop-group"><legend>Vector provider</legend><div class="form-grid">
-        ${input('name', 'Name (static ID)', x.name ?? '', { required: true, placeholder: 'e.g. DOC_EMBEDDINGS', help: 'Upper case letters, digits and _. Search configurations name it; in SQL: meta.embed(text, \'DOC_EMBEDDINGS\') (function and database model providers).' })}
-        ${input('description', 'Description', x.description ?? '')}
-        ${select('type', 'Type', x.type ?? 'ai_service', [['ai_service', 'AI service with an embedding model'], ['database_model', 'Model in the database (PostgresML)'], ['function', 'SQL or PL/pgSQL function']], 'Where the embeddings come from.')}
-        ${input('dimensions', 'Dimensions', x.dimensions ?? '', { type: 'number', required: true, placeholder: 'e.g. 1536', help: `The length of each vector: text-embedding-3-small 1536 (or fewer: OpenAI shortens them), text-embedding-3-large 3072, nomic-embed-text 768, gemini-embedding-001 3072. A vector column is vector(n) with this n; an HNSW index takes up to ${HNSW_MAX_DIMENSIONS}.` })}
+      <fieldset class="prop-group"><legend>${tx('vp.vector_provider')}</legend><div class="form-grid">
+        ${input('name', tx('vp.name_static_id'), x.name ?? '', { required: true, placeholder: tx('vp.e_g_doc_embeddings'), help: tx('vp.upper_case_letters_digits_and') })}
+        ${input('description', tx('vp.description'), x.description ?? '')}
+        ${select('type', tx('vp.type'), x.type ?? 'ai_service', [['ai_service', tx('vp.ai_service_with_an_embedding')], ['database_model', tx('vp.model_in_the_database_postgresml')], ['function', tx('vp.sql_or_pl_pgsql_function')]], tx('vp.where_the_embeddings_come_from'))}
+        ${input('dimensions', tx('vp.dimensions'), x.dimensions ?? '', { type: 'number', required: true, placeholder: tx('vp.eg_1536'), help: tx('vp.dimensions_help', { max: HNSW_MAX_DIMENSIONS }) })}
       </div></fieldset>
-      <fieldset class="prop-group"><legend>AI service</legend><div class="form-grid">
-        ${services.length ? '' : html`<p class="muted" data-wide>This application may not use an OpenAI, Gemini or OpenAI-compatible AI service yet: an administrator adds one under <a href="${BASE}/ai">Workspace utilities → AI services</a> (Claude has no embeddings) and allows this application to use it.</p>`}
-        ${select('service', 'AI service', x.service ?? '', svc, 'Its key, base URL and daily limits apply; the texts to embed go to its provider.')}
-        ${input('model', 'Embedding model', x.model ?? '', { placeholder: 'e.g. text-embedding-3-small', help: 'Exactly as the provider names it: text-embedding-3-small, gemini-embedding-001, nomic-embed-text, mxbai-embed-large …' })}
-        ${input('batch_size', 'Texts per request', x.batch_size ?? '', { type: 'number', placeholder: String(DEFAULT_BATCH), help: 'When the server embeds queued rows (vector columns).' })}
-        ${input('per_minute', 'Requests per minute', x.per_minute ?? '', { type: 'number', placeholder: String(DEFAULT_PER_MINUTE), help: 'At most this many background requests per minute (per server), under the provider\'s rate limit.' })}
+      <fieldset class="prop-group"><legend>${tx('vp.ai_service')}</legend><div class="form-grid">
+        ${services.length ? '' : html`<p class="muted" data-wide>${tx.rich('vp.no_service', { link: html`<a href="${BASE}/ai">${tx('vp.workspace_utilities_ai_services')}</a>` })}</p>`}
+        ${select('service', tx('vp.ai_service'), x.service ?? '', svc, tx('vp.its_key_base_url_and'))}
+        ${input('model', tx('vp.embedding_model'), x.model ?? '', { placeholder: tx('vp.e_g_text_embedding_3'), help: tx('vp.exactly_as_the_provider_names') })}
+        ${input('batch_size', tx('vp.texts_per_request'), x.batch_size ?? '', { type: 'number', placeholder: String(DEFAULT_BATCH), help: tx('vp.when_the_server_embeds_queued') })}
+        ${input('per_minute', tx('vp.requests_per_minute'), x.per_minute ?? '', { type: 'number', placeholder: String(DEFAULT_PER_MINUTE), help: tx('vp.at_most_this_many_background') })}
       </div></fieldset>
-      <fieldset class="prop-group"><legend>Model in the database</legend><div class="form-grid">
-        ${pgml ? '' : html`<p class="muted" data-wide>PostgresML (<code>pgml</code>) is not installed in this database: install it on the database server, then <code>create extension pgml;</code>. It runs Hugging Face models (ONNX among them) inside PostgreSQL.</p>`}
-        ${select('engine', 'Engine', x.engine ?? 'pgml', MODEL_ENGINES.map((e): [string, string] => [e, e === 'pgml' ? 'PostgresML: pgml.embed(model, text)' : e]), 'The extension that runs the model. Nothing leaves the database; grant usage on its schema (pgml) to the application\'s role.')}
-        ${input('db_model', 'Model', x.type === 'database_model' ? (x.model ?? '') : '', { placeholder: 'e.g. intfloat/e5-small-v2', help: 'A model the engine loads (the first call downloads it): intfloat/e5-small-v2 (384), Alibaba-NLP/gte-base-en-v1.5 (768), mixedbread-ai/mxbai-embed-large-v1 (1024) …' })}
+      <fieldset class="prop-group"><legend>${tx('vp.model_in_the_database')}</legend><div class="form-grid">
+        ${pgml ? '' : html`<p class="muted" data-wide>${tx.rich('vp.no_pgml', { pgml: html`<code>pgml</code>`, sql: html`<code>create extension pgml;</code>` })}</p>`}
+        ${select('engine', tx('vp.engine'), x.engine ?? 'pgml', MODEL_ENGINES.map((e): [string, string] => [e, e === 'pgml' ? tx('vp.postgresml_pgml_embed_model_text') : e]), tx('vp.the_extension_that_runs_the'))}
+        ${input('db_model', tx('vp.model'), x.type === 'database_model' ? (x.model ?? '') : '', { placeholder: tx('vp.e_g_intfloat_e5_small'), help: tx('vp.a_model_the_engine_loads') })}
       </div></fieldset>
-      <fieldset class="prop-group"><legend>Function</legend><div class="form-grid">
-        ${input('function', 'Function', x.function ?? '', { placeholder: 'e.g. sales.embed', help: 'schema.name of a function (text) returning vector, real[] or float8[]. meta.embed calls it as the role that runs the query (its grants apply): grant execute on it to the application\'s role.' })}
+      <fieldset class="prop-group"><legend>${tx('vp.function')}</legend><div class="form-grid">
+        ${input('function', tx('vp.function'), x.function ?? '', { placeholder: tx('vp.e_g_sales_embed'), help: tx('vp.schema_name_of_a_function') })}
       </div></fieldset>
-      <div class="buttons"><button class="btn btn-hot">${original ? 'Save' : 'Add vector provider'}</button></div>
+      <div class="buttons"><button class="btn btn-hot">${original ? tx('vp.save') : tx('vp.add_vector_provider')}</button></div>
     </form>
     ${original ? html`
       <form method="post" action="${BASE}/apps/${a.id}/vector-providers/test" class="u-mt1">${csrf(s)}<input type="hidden" name="name" value="${original}">
-        <button class="btn">${icon('play')} Test: embed a sample text</button></form>
-      <h3>Used by</h3>
+        <button class="btn">${icon('play')} ${tx('vp.test_embed_a_sample_text')}</button></form>
+      <h3>${tx('vp.used_by')}</h3>
       ${configs.length || columns.length ? html`<ul>
-        ${configs.map((c) => html`<li>Search configuration <a href="${BASE}/apps/${a.id}/shared?c=search_config-${c.id}">${c.name}</a> (${c.search_type})</li>`)}
-        ${columns.map((c) => html`<li>Vector column <a href="${BASE}/sql/objects/vector?${new URLSearchParams({ o: c.table })}"><code>${c.table}.${c.vectorColumn}</code></a> (${c.mode === 'set' ? 'set by a trigger' : 'queued for the server'})</li>`)}
-      </ul>` : html`<p class="muted">No search configuration or vector column uses this provider yet.</p>`}
+        ${configs.map((c) => html`<li>${tx.rich('vp.used_config', { link: html`<a href="${BASE}/apps/${a.id}/shared?c=search_config-${c.id}">${c.name}</a>`, type: c.search_type })}</li>`)}
+        ${columns.map((c) => html`<li>${tx.rich('vp.used_column', { link: html`<a href="${BASE}/sql/objects/vector?${new URLSearchParams({ o: c.table })}"><code>${c.table}.${c.vectorColumn}</code></a>`, mode: c.mode === 'set' ? tx('vp.set_by_trigger') : tx('vp.queued_server') })}</li>`)}
+      </ul>` : html`<p class="muted">${tx('vp.no_search_configuration_or_vector')}</p>`}
       <form method="post" action="${BASE}/apps/${a.id}/vector-providers/provider/delete" class="danger-zone">${csrf(s)}<input type="hidden" name="name" value="${original}">
-        <button class="btn btn-danger" data-confirm="Delete vector provider ${original}? Search configurations and vector columns that use it stop working.">Delete vector provider</button></form>` : ''}`;
+        <button class="btn btn-danger" data-confirm="${tx('vp.delete_confirm', { name: original })}">${tx('vp.delete_vector_provider')}</button></form>` : ''}`;
 }
 
 const intOrUndef = (v: string, what: string, errors: string[]) => {
   const t = v.trim();
   if (!t) return undefined;
   const n = Number(t);
-  if (!Number.isInteger(n)) errors.push(`${what} is a whole number.`);
+  if (!Number.isInteger(n)) errors.push(tx('vp.whole_number', { what }));
   return n;
 };
 
 function providerFrom(b: Body, errors: string[]): VectorProvider {
   const type = one(b.type) as VectorProvider['type'];
-  const x: VectorProvider = { name: one(b.name).trim().toUpperCase(), type, dimensions: intOrUndef(one(b.dimensions), 'Dimensions', errors) ?? 0 };
+  const x: VectorProvider = { name: one(b.name).trim().toUpperCase(), type, dimensions: intOrUndef(one(b.dimensions), tx('vp.f_dimensions'), errors) ?? 0 };
   const description = one(b.description).trim().slice(0, 500);
   if (description) x.description = description;
   if (type === 'ai_service') {
     x.service = one(b.service).trim().toUpperCase();
     x.model = one(b.model).trim();
-    const batch = intOrUndef(one(b.batch_size), 'Texts per request', errors);
+    const batch = intOrUndef(one(b.batch_size), tx('vp.f_batch'), errors);
     if (batch !== undefined) x.batch_size = batch;
-    const pm = intOrUndef(one(b.per_minute), 'Requests per minute', errors);
+    const pm = intOrUndef(one(b.per_minute), tx('vp.f_per_minute'), errors);
     if (pm !== undefined) x.per_minute = pm;
   }
   if (type === 'function') x.function = one(b.function).trim();
@@ -159,16 +160,16 @@ export async function vectorProviderRoutes(app: FastifyInstance) {
     const list = (a.vector_providers ?? []) as VectorProvider[];
     const st = await pgvectorStatus(await devDbForApp(a.id));
     const main = html`${appHeader(a, 'shared', s)}
-      <div class="title-row"><h1>Vector providers</h1></div>
-      <p class="muted u-mt0">A vector provider turns text into an embedding: a list of numbers whose distance says how close two texts are in meaning. Vector columns keep the embeddings of a table's rows (SQL Workshop › Table Properties › Add vector column), and search configurations of type vector or hybrid, and the Retrieve tools of AI agents, find rows by meaning. The texts go to the provider's AI service.</p>
+      <div class="title-row"><h1>${tx('vp.vector_providers')}</h1></div>
+      <p class="muted u-mt0">${tx('vp.a_vector_provider_turns_text')}</p>
       ${pgvectorNote(st, await isAdmin(s.username), s)}
-      ${region('Providers', html`<div class="table-wrap"><table class="report report-reflow"><thead><tr><th>Name</th><th>Type</th><th>Model or function</th><th class="num">Dimensions</th></tr></thead>
-        <tbody>${list.length ? list.map((p) => html`<tr><td data-label="Name"><a href="${BASE}/apps/${a.id}/vector-providers/provider?name=${encodeURIComponent(p.name)}">${p.name}</a>${p.description ? html` <span class="muted">${p.description}</span>` : ''}</td>
-          <td data-label="Type">${p.type === 'ai_service' ? html`AI service ${p.service}` : p.type === 'database_model' ? `in the database (${p.engine})` : 'function'}</td><td data-label="Model or function"><code>${p.type === 'function' ? p.function : p.model}</code></td>
-          <td class="num" data-label="Dimensions">${p.dimensions}</td></tr>`)
-          : html`<tr><td colspan="4" class="empty">No vector providers yet.</td></tr>`}</tbody></table></div>
-        <p><a class="btn" href="${BASE}/apps/${a.id}/vector-providers/provider">${icon('plus')} Add vector provider</a></p>`)}`;
-    return send(reply, s, shell(s, 'Vector providers', crumbs(a), main));
+      ${region(tx('vp.providers'), html`<div class="table-wrap"><table class="report report-reflow"><thead><tr><th>${tx('vp.name')}</th><th>${tx('vp.type')}</th><th>${tx('vp.model_or_function')}</th><th class="num">${tx('vp.dimensions')}</th></tr></thead>
+        <tbody>${list.length ? list.map((p) => html`<tr><td data-label="${tx('vp.name')}"><a href="${BASE}/apps/${a.id}/vector-providers/provider?name=${encodeURIComponent(p.name)}">${p.name}</a>${p.description ? html` <span class="muted">${p.description}</span>` : ''}</td>
+          <td data-label="${tx('vp.type')}">${p.type === 'ai_service' ? html`AI service ${p.service}` : p.type === 'database_model' ? `in the database (${p.engine})` : 'function'}</td><td data-label="${tx('vp.model_or_function')}"><code>${p.type === 'function' ? p.function : p.model}</code></td>
+          <td class="num" data-label="${tx('vp.dimensions')}">${p.dimensions}</td></tr>`)
+          : html`<tr><td colspan="4" class="empty">${tx('vp.no_vector_providers_yet')}</td></tr>`}</tbody></table></div>
+        <p><a class="btn" href="${BASE}/apps/${a.id}/vector-providers/provider">${icon('plus')} ${tx('vp.add_vector_provider')}</a></p>`)}`;
+    return send(reply, s, shell(s, tx('vp.vector_providers'), crumbs(a), main));
   });
 
   app.get(`${BASE}/apps/:id(^\\d+$)/vector-providers/provider`, async (req: Req, reply) => {
@@ -179,7 +180,7 @@ export async function vectorProviderRoutes(app: FastifyInstance) {
     const x = name ? ((a.vector_providers ?? []) as VectorProvider[]).find((p) => p.name === name) : {};
     if (!x) return reply.code(404).send('Not found');
     const title = name || 'New vector provider';
-    const main = html`${appHeader(a, 'shared', s)}<div class="title-row"><h1 class="ai-name">${title}</h1></div>${region('Vector provider', await providerForm(a, s, x, name, []))}`;
+    const main = html`${appHeader(a, 'shared', s)}<div class="title-row"><h1 class="ai-name">${title}</h1></div>${region(tx('vp.vector_provider'), await providerForm(a, s, x, name, []))}`;
     return send(reply, s, shell(s, title, crumbs(a, title), main));
   });
 
@@ -194,20 +195,20 @@ export async function vectorProviderRoutes(app: FastifyInstance) {
     const problems = errors.length ? errors : await update(a.id, (list) => {
       const out = vectorProviderProblems(x);
       const at = original ? list.findIndex((p) => p.name === original) : -1;
-      if (original && at < 0) out.push(`Vector provider ${original} no longer exists.`);
-      if (list.some((p, i) => p.name === x.name && i !== at)) out.push(`A vector provider ${x.name} exists already.`);
+      if (original && at < 0) out.push(tx('vp.gone', { name: original }));
+      if (list.some((p, i) => p.name === x.name && i !== at)) out.push(tx('vp.exists', { name: x.name }));
       if (out.length) return out;
       if (at >= 0) list[at] = x;
       else list.push(x);
       return [];
     });
     if (problems.length) {
-      const main = html`${appHeader(a, 'shared', s)}<div class="title-row"><h1 class="ai-name">${original || 'New vector provider'}</h1></div>${region('Vector provider', await providerForm(a, s, x, original, problems))}`;
+      const main = html`${appHeader(a, 'shared', s)}<div class="title-row"><h1 class="ai-name">${original || 'New vector provider'}</h1></div>${region(tx('vp.vector_provider'), await providerForm(a, s, x, original, problems))}`;
       return send(reply.code(422), s, shell(s, original || 'New vector provider', crumbs(a, original || 'New vector provider'), main));
     }
     // a renamed provider keeps its search configurations
     if (original && original !== x.name) await owner.query('update meta.search_config set vector_provider = $3 where app_id = $1 and vector_provider = $2', [a.id, original, x.name]);
-    flash(s, 'Vector provider saved.');
+    flash(s, tx('vp.vector_provider_saved'));
     return back(reply, s, `${BASE}/apps/${a.id}/vector-providers/provider?name=${encodeURIComponent(x.name)}`);
   });
 
@@ -221,7 +222,7 @@ export async function vectorProviderRoutes(app: FastifyInstance) {
       if (at >= 0) list.splice(at, 1);
       return [];
     });
-    flash(s, `Vector provider ${name} deleted.`);
+    flash(s, tx('vp.deleted', { name }));
     return back(reply, s, `${BASE}/apps/${a.id}/vector-providers`);
   });
 
@@ -241,7 +242,7 @@ export async function vectorProviderRoutes(app: FastifyInstance) {
     }
     const t0 = performance.now();
     try {
-      const [v] = await embedTexts(p, ['The quick brown fox jumps over the lazy dog.'], { appId: a.id, user: s.username, pageNo: null }, await devDbForApp(a.id));
+      const [v] = await embedTexts(p, [tx('vp.the_quick_brown_fox_jumps')], { appId: a.id, user: s.username, pageNo: null }, await devDbForApp(a.id));
       flash(s, `${name} answered in ${Math.round(performance.now() - t0)} ms with ${v.length} dimensions, as the provider says: [${v.slice(0, 4).map((n) => n.toFixed(4)).join(', ')}, …].`);
     } catch (e) {
       flash(s, `${name}: ${isAiError(e) ? e.message : (e as Error).message}`, 'error');
@@ -261,20 +262,20 @@ export async function vectorProviderRoutes(app: FastifyInstance) {
     const ids = new Set(apps.map((x) => x.id));
     const columns = st.installed ? (await vectorTriggers(owner)).filter((t) => ids.has(t.appId)) : [];
     const rows = apps.flatMap((x) => x.vector_providers.map((p) => ({ app: x, p })));
-    const main = html`<div class="title-row"><h1>Vector providers</h1></div>
-      <p class="muted u-mt0">The vector providers of this workspace's applications (each application defines its own under Shared Components → Vector providers), and the vector columns they keep current.</p>
+    const main = html`<div class="title-row"><h1>${tx('vp.vector_providers')}</h1></div>
+      <p class="muted u-mt0">${tx('vp.the_vector_providers_of_this')}</p>
       ${pgvectorNote(st, admin, s)}
-      ${region('Providers', html`<div class="table-wrap"><table class="report report-reflow"><thead><tr><th>Application</th><th>Name</th><th>Type</th><th>Model or function</th><th class="num">Dimensions</th></tr></thead>
-        <tbody>${rows.length ? rows.map(({ app: x, p }) => html`<tr><td data-label="Application">${x.name}</td>
-          <td data-label="Name"><a href="${BASE}/apps/${x.id}/vector-providers/provider?name=${encodeURIComponent(p.name)}">${p.name}</a></td>
-          <td data-label="Type">${p.type === 'ai_service' ? html`AI service ${p.service}` : p.type === 'database_model' ? `in the database (${p.engine})` : 'function'}</td><td data-label="Model or function"><code>${p.type === 'function' ? p.function : p.model}</code></td>
-          <td class="num" data-label="Dimensions">${p.dimensions}</td></tr>`)
-          : html`<tr><td colspan="5" class="empty">No vector providers yet.</td></tr>`}</tbody></table></div>`)}
-      ${region('Vector columns', html`<div class="table-wrap"><table class="report report-reflow"><thead><tr><th>Column</th><th>Provider</th><th>Source columns</th><th>Kept by</th></tr></thead>
-        <tbody>${columns.length ? columns.map((c) => html`<tr><td data-label="Column"><a href="${BASE}/sql/objects/vector?${new URLSearchParams({ o: c.table })}"><code>${c.table}.${c.vectorColumn}</code></a></td>
-          <td data-label="Provider">${c.provider}</td><td data-label="Source columns">${c.sourceColumns.join(', ')}</td><td data-label="Kept by">${c.mode === 'set' ? 'a trigger' : 'the server\'s queue'}</td></tr>`)
-          : html`<tr><td colspan="4" class="empty">No vector columns yet (SQL Workshop › Table Properties › Add vector column).</td></tr>`}</tbody></table></div>`)}`;
-    return send(reply, s, shell(s, 'Vector providers', [['App Builder', BASE], ['Workspace utilities', `${BASE}/utilities`], ['Vector providers']], main));
+      ${region(tx('vp.providers'), html`<div class="table-wrap"><table class="report report-reflow"><thead><tr><th>${tx('vp.application')}</th><th>${tx('vp.name')}</th><th>${tx('vp.type')}</th><th>${tx('vp.model_or_function')}</th><th class="num">${tx('vp.dimensions')}</th></tr></thead>
+        <tbody>${rows.length ? rows.map(({ app: x, p }) => html`<tr><td data-label="${tx('vp.application')}">${x.name}</td>
+          <td data-label="${tx('vp.name')}"><a href="${BASE}/apps/${x.id}/vector-providers/provider?name=${encodeURIComponent(p.name)}">${p.name}</a></td>
+          <td data-label="${tx('vp.type')}">${p.type === 'ai_service' ? html`AI service ${p.service}` : p.type === 'database_model' ? `in the database (${p.engine})` : 'function'}</td><td data-label="${tx('vp.model_or_function')}"><code>${p.type === 'function' ? p.function : p.model}</code></td>
+          <td class="num" data-label="${tx('vp.dimensions')}">${p.dimensions}</td></tr>`)
+          : html`<tr><td colspan="5" class="empty">${tx('vp.no_vector_providers_yet')}</td></tr>`}</tbody></table></div>`)}
+      ${region(tx('vp.vector_columns'), html`<div class="table-wrap"><table class="report report-reflow"><thead><tr><th>${tx('vp.column')}</th><th>${tx('vp.provider')}</th><th>${tx('vp.source_columns')}</th><th>${tx('vp.kept_by')}</th></tr></thead>
+        <tbody>${columns.length ? columns.map((c) => html`<tr><td data-label="${tx('vp.column')}"><a href="${BASE}/sql/objects/vector?${new URLSearchParams({ o: c.table })}"><code>${c.table}.${c.vectorColumn}</code></a></td>
+          <td data-label="${tx('vp.provider')}">${c.provider}</td><td data-label="${tx('vp.source_columns')}">${c.sourceColumns.join(', ')}</td><td data-label="${tx('vp.kept_by')}">${c.mode === 'set' ? 'a trigger' : 'the server\'s queue'}</td></tr>`)
+          : html`<tr><td colspan="4" class="empty">${tx('vp.no_vector_columns_yet_sql')}</td></tr>`}</tbody></table></div>`)}`;
+    return send(reply, s, shell(s, tx('vp.vector_providers'), [[tx('vp.app_builder'), BASE], [tx('vp.workspace_utilities'), `${BASE}/utilities`], [tx('vp.vector_providers')]], main));
   });
 
   // administrators: create extension vector (pgvector is not a trusted extension: the owner connection must be a superuser)
@@ -285,7 +286,7 @@ export async function vectorProviderRoutes(app: FastifyInstance) {
     try {
       await owner.query('create extension if not exists vector');
       await logActivity({ username: s.username, event: 'sql_command', ip: clientIp(req), detail: 'create extension if not exists vector' });
-      flash(s, 'The pgvector extension is installed.');
+      flash(s, tx('vp.the_pgvector_extension_is_installed'));
     } catch (e) {
       flash(s, `create extension vector failed: ${(e as Error).message}`, 'error');
     }