pgkiln 0.67.0 → 0.69.0

package/src/builder/i18n.ts

@@ -19,20 +19,30 @@ import { de } from './i18n/de.ts';
 import { en } from './i18n/en.ts';
 import { es } from './i18n/es.ts';
 import { fr } from './i18n/fr.ts';
+import { it } from './i18n/it.ts';
+import { ja } from './i18n/ja.ts';
+import { ko } from './i18n/ko.ts';
 import { nl } from './i18n/nl.ts';
 import { pt } from './i18n/pt.ts';
+import { zhCN } from './i18n/zh-cn.ts';
+import { zhTW } from './i18n/zh-tw.ts';
 
 export type BuilderKey = keyof typeof en;
 export type BuilderMessages = Record<BuilderKey, string>;
 export type Params = Record<string, string | number | null | undefined>;
 
-/** The builder's languages, in the order of the language menu and the sign-in page's links (names in their own language). */
+/**
+ * The builder's languages, in the order of the language menu and the sign-in page's links (names in their own
+ * language): APEX's ten (sprint 134, SEC-5: Italiano, both Chinese scripts, Japanese, Korean) and Nederlands.
+ * The codes are BCP 47 tags, used as they are in <html lang>, the cookie and meta.developer.language.
+ */
 export const BUILDER_LANGUAGES = [
-  ['de', 'Deutsch'], ['en', 'English'], ['es', 'Español'], ['fr', 'Français'], ['nl', 'Nederlands'], ['pt', 'Português'],
+  ['de', 'Deutsch'], ['en', 'English'], ['es', 'Español'], ['fr', 'Français'], ['it', 'Italiano'], ['nl', 'Nederlands'], ['pt', 'Português'],
+  ['zh-CN', '中文 (简体)'], ['zh-TW', '中文 (繁體)'], ['ja', '日本語'], ['ko', '한국어'],
 ] as const;
 export type BuilderLang = (typeof BUILDER_LANGUAGES)[number][0];
 
-const MESSAGES: Record<BuilderLang, Readonly<Record<string, string>>> = { en, de, es, fr, nl, pt };
+const MESSAGES: Record<BuilderLang, Readonly<Record<string, string>>> = { en, de, es, fr, it, nl, pt, 'zh-CN': zhCN, 'zh-TW': zhTW, ja, ko };
 
 /** The cookie with the sign-in page's language on this device (the builder's path only). */
 export const LANG_COOKIE = 'pgkiln_blang';

package/src/builder/object-actions.ts

@@ -32,6 +32,7 @@ export function objectMenu(schema: string, o: MenuObj): Raw {
       ${table ? item(`${BASE}/sql/objects/table?${new URLSearchParams({ schema, template: o.ref })}`, 'copy', 'Use as template') : ''}
       ${table ? item(`${BASE}/sql/objects/security?${new URLSearchParams({ o: o.ref })}`, 'shield', 'Security…') : ''}
       ${table ? item(`${BASE}/sql/load`, 'upload', 'Load data') : ''}
+      ${table ? item(`${BASE}/sql/objects/fulltext?${new URLSearchParams({ o: o.ref })}`, 'search', 'Add full-text search…') : ''}
       ${table ? html`${item(q('index'), 'list', 'Add index')}${item(q('trigger'), 'bolt', 'Add trigger')}${item(q('policy'), 'shield', 'Add policy')}` : ''}
       ${RELATIONS.has(o.type) ? item(`${BASE}/sql/rest/object?${new URLSearchParams({ schema, name: o.name })}`, 'globe', 'REST › Enable / Disable') : ''}
       ${item(q('ddl'), 'code', 'Quick DDL to the worksheet')}

package/src/builder/sql.ts

@@ -19,6 +19,7 @@ import { sqlUtilityRoutes } from './sql-utilities.ts';
 import { createTemplate, objectBrowserRoutes } from './object-browser.ts';
 import { objectActionRoutes } from './object-actions.ts';
 import { tableEditorRoutes } from './table-editor.ts';
+import { fulltextRoutes } from './fulltext.ts';
 import { dataSecurityRoutes } from './data-security.ts';
 import { dataModelerRoutes } from './data-modeler.ts';
 import { autoRestBuilderRoutes } from './autorest.ts';
@@ -134,6 +135,8 @@ export async function sqlRoutes(app: FastifyInstance) {
   await app.register(objectActionRoutes);
   // (sprint 95) Table Properties: create, edit or copy a table in a form
   await app.register(tableEditorRoutes);
+  // (sprint 135, AP-2) Table Properties › Add full-text search
+  await app.register(fulltextRoutes);
   await app.register(dataSecurityRoutes);
   // (sprint 98) the Data Modeler: relational diagrams, their DDL and data dictionary
   await app.register(dataModelerRoutes);

package/src/builder/table-editor.ts

@@ -142,6 +142,7 @@ function form(s: Session, def: TableDef, opts: { editing: TableDef | null; schem
       <button class="btn" name="mode" value="preview">${icon('eye')} ${tx('te.preview')}</button>
       <button class="btn btn-hot" name="mode" value="apply">${icon('check')} ${tx('te.apply')}</button>
       <button class="btn" name="mode" value="worksheet">${icon('code')} ${tx('te.open_ws')}</button>
+      ${editing ? html`<a class="btn" href="${BASE}/sql/objects/fulltext?${new URLSearchParams({ o: opts.ref })}">${icon('search')} ${tx('fts.add')}…</a>` : ''}
       <a class="btn" href="${editing ? `${BASE}/sql/objects?${new URLSearchParams({ schema: def.schema, k: 'table', o: opts.ref })}` : `${BASE}/sql/objects?${new URLSearchParams({ schema: def.schema })}`}">${tx('common.cancel')}</a>
     </div></form>`;
 }

package/src/i18n/ar.ts

@@ -424,6 +424,7 @@ export const ar: Record<MessageKey, string> = {
   'lov.loading': "جارٍ تحميل المزيد…",
   'da.wait': "يرجى الانتظار…",
   'lov.no_rows': "لم يُعثر على شيء.",
+  'search.did_you_mean': "هل تقصد:",
   'error.lov_value': "{label}: اختر قيمة من القائمة.",
   'item.yes': "نعم",
   'item.no': "لا",

package/src/i18n/cs.ts

@@ -424,6 +424,7 @@ export const cs: Record<MessageKey, string> = {
   'lov.loading': "Načítání dalších…",
   'da.wait': "Čekejte prosím…",
   'lov.no_rows': "Nic nenalezeno.",
+  'search.did_you_mean': "Měli jste na mysli:",
   'error.lov_value': "{label}: vyberte hodnotu ze seznamu.",
   'item.yes': "Ano",
   'item.no': "Ne",

package/src/i18n/da.ts

@@ -424,6 +424,7 @@ export const da: Record<MessageKey, string> = {
   'lov.loading': "Indlæser flere…",
   'da.wait': "Vent venligst…",
   'lov.no_rows': "Intet fundet.",
+  'search.did_you_mean': "Mente du:",
   'error.lov_value': "{label}: vælg en værdi på listen.",
   'item.yes': "Ja",
   'item.no': "Nej",

package/src/i18n/de.ts

@@ -421,6 +421,7 @@ export const de: Record<MessageKey, string> = {
   'lov.loading': 'Weitere werden geladen…',
   'da.wait': 'Bitte warten…',
   'lov.no_rows': 'Nichts gefunden.',
+  'search.did_you_mean': "Meinten Sie:",
   'error.lov_value': '{label}: Wählen Sie einen Wert aus der Liste.',
   'item.yes': 'Ja',
   'item.no': 'Nein',

package/src/i18n/el.ts

@@ -424,6 +424,7 @@ export const el: Record<MessageKey, string> = {
   'lov.loading': "Φόρτωση περισσότερων…",
   'da.wait': "Παρακαλώ περιμένετε…",
   'lov.no_rows': "Δεν βρέθηκε τίποτα.",
+  'search.did_you_mean': "Μήπως εννοούσατε:",
   'error.lov_value': "{label}: επιλέξτε τιμή από τη λίστα.",
   'item.yes': "Ναι",
   'item.no': "Όχι",

package/src/i18n/es.ts

@@ -421,6 +421,7 @@ export const es: Record<MessageKey, string> = {
   'lov.loading': 'Cargando más…',
   'da.wait': 'Espere, por favor…',
   'lov.no_rows': 'No se ha encontrado nada.',
+  'search.did_you_mean': "Quizás quiso decir:",
   'error.lov_value': '{label}: elija un valor de la lista.',
   'item.yes': 'Sí',
   'item.no': 'No',

package/src/i18n/fi.ts

@@ -424,6 +424,7 @@ export const fi: Record<MessageKey, string> = {
   'lov.loading': "Ladataan lisää…",
   'da.wait': "Odota hetki…",
   'lov.no_rows': "Mitään ei löytynyt.",
+  'search.did_you_mean': "Tarkoititko:",
   'error.lov_value': "{label}: valitse arvo luettelosta.",
   'item.yes': "Kyllä",
   'item.no': "Ei",

package/src/i18n/fr.ts

@@ -421,6 +421,7 @@ export const fr: Record<MessageKey, string> = {
   'lov.loading': 'Chargement de la suite…',
   'da.wait': 'Veuillez patienter…',
   'lov.no_rows': 'Aucun résultat.',
+  'search.did_you_mean': "Vouliez-vous dire :",
   'error.lov_value': '{label} : choisissez une valeur dans la liste.',
   'item.yes': 'Oui',
   'item.no': 'Non',

package/src/i18n/he.ts

@@ -424,6 +424,7 @@ export const he: Record<MessageKey, string> = {
   'lov.loading': "טוען עוד…",
   'da.wait': "נא להמתין…",
   'lov.no_rows': "לא נמצא דבר.",
+  'search.did_you_mean': "האם התכוונת ל:",
   'error.lov_value': "{label}: בחרו ערך מהרשימה.",
   'item.yes': "כן",
   'item.no': "לא",

package/src/i18n/it.ts

@@ -424,6 +424,7 @@ export const it: Record<MessageKey, string> = {
   'lov.loading': "Caricamento di altri…",
   'da.wait': "Attendere prego…",
   'lov.no_rows': "Nessun risultato.",
+  'search.did_you_mean': "Forse cercavi:",
   'error.lov_value': "{label}: scegli un valore dall'elenco.",
   'item.yes': "Sì",
   'item.no': "No",

package/src/i18n/ja.ts

@@ -424,6 +424,7 @@ export const ja: Record<MessageKey, string> = {
   'lov.loading': "さらに読み込み中…",
   'da.wait': "お待ちください…",
   'lov.no_rows': "見つかりません。",
+  'search.did_you_mean': "もしかして:",
   'error.lov_value': "{label}: 一覧から値を選んでください。",
   'item.yes': "はい",
   'item.no': "いいえ",

package/src/i18n/ko.ts

@@ -424,6 +424,7 @@ export const ko: Record<MessageKey, string> = {
   'lov.loading': "더 불러오는 중…",
   'da.wait': "잠시 기다려 주세요…",
   'lov.no_rows': "찾은 항목이 없습니다.",
+  'search.did_you_mean': "이것을 찾으셨나요:",
   'error.lov_value': "{label}: 목록에서 값을 선택하세요.",
   'item.yes': "예",
   'item.no': "아니요",

package/src/i18n/nb.ts

@@ -424,6 +424,7 @@ export const nb: Record<MessageKey, string> = {
   'lov.loading': "Laster inn flere…",
   'da.wait': "Vent litt…",
   'lov.no_rows': "Fant ingenting.",
+  'search.did_you_mean': "Mente du:",
   'error.lov_value': "{label}: velg en verdi fra listen.",
   'item.yes': "Ja",
   'item.no': "Nei",

package/src/i18n/pl.ts

@@ -424,6 +424,7 @@ export const pl: Record<MessageKey, string> = {
   'lov.loading': "Wczytywanie kolejnych…",
   'da.wait': "Proszę czekać…",
   'lov.no_rows': "Nic nie znaleziono.",
+  'search.did_you_mean': "Czy chodziło o:",
   'error.lov_value': "{label}: wybierz wartość z listy.",
   'item.yes': "Tak",
   'item.no': "Nie",

package/src/i18n/pt.ts

@@ -424,6 +424,7 @@ export const pt: Record<MessageKey, string> = {
   'lov.loading': "A carregar mais…",
   'da.wait': "Aguarde, por favor…",
   'lov.no_rows': "Nada encontrado.",
+  'search.did_you_mean': "Queria dizer:",
   'error.lov_value': "{label}: escolha um valor da lista.",
   'item.yes': "Sim",
   'item.no': "Não",

package/src/i18n/ru.ts

@@ -424,6 +424,7 @@ export const ru: Record<MessageKey, string> = {
   'lov.loading': "Загрузка…",
   'da.wait': "Подождите…",
   'lov.no_rows': "Ничего не найдено.",
+  'search.did_you_mean': "Возможно, вы имели в виду:",
   'error.lov_value': "{label}: выберите значение из списка.",
   'item.yes': "Да",
   'item.no': "Нет",

package/src/i18n/sv.ts

@@ -424,6 +424,7 @@ export const sv: Record<MessageKey, string> = {
   'lov.loading': "Läser in fler…",
   'da.wait': "Vänta…",
   'lov.no_rows': "Inget hittades.",
+  'search.did_you_mean': "Menade du:",
   'error.lov_value': "{label}: välj ett värde i listan.",
   'item.yes': "Ja",
   'item.no': "Nej",

package/src/i18n/tr.ts

@@ -424,6 +424,7 @@ export const tr: Record<MessageKey, string> = {
   'lov.loading': "Daha fazlası yükleniyor…",
   'da.wait': "Lütfen bekleyin…",
   'lov.no_rows': "Hiçbir şey bulunamadı.",
+  'search.did_you_mean': "Bunu mu demek istediniz:",
   'error.lov_value': "{label}: listeden bir değer seçin.",
   'item.yes': "Evet",
   'item.no': "Hayır",

package/src/i18n/uk.ts

@@ -424,6 +424,7 @@ export const uk: Record<MessageKey, string> = {
   'lov.loading': "Завантаження…",
   'da.wait': "Зачекайте…",
   'lov.no_rows': "Нічого не знайдено.",
+  'search.did_you_mean': "Можливо, ви мали на увазі:",
   'error.lov_value': "{label}: виберіть значення зі списку.",
   'item.yes': "Так",
   'item.no': "Ні",

package/src/i18n/zh.ts

@@ -424,6 +424,7 @@ export const zh: Record<MessageKey, string> = {
   'lov.loading': "正在加载更多…",
   'da.wait': "请稍候…",
   'lov.no_rows': "未找到任何内容。",
+  'search.did_you_mean': "您是不是要找：",
   'error.lov_value': "{label}：请从列表中选择一个值。",
   'item.yes': "是",
   'item.no': "否",

package/src/i18n.ts

@@ -451,6 +451,7 @@ const en = {
   'lov.loading': 'Loading more…',
   'da.wait': 'Please wait…',
   'lov.no_rows': 'Nothing found.',
+  'search.did_you_mean': 'Did you mean:',
   'error.lov_value': '{label}: choose a value from the list.',
   'item.yes': 'Yes',
   'item.no': 'No',
@@ -1318,6 +1319,7 @@ const nl: Record<MessageKey, string> = {
   'lov.loading': 'Meer laden…',
   'da.wait': 'Even geduld…',
   'lov.no_rows': 'Niets gevonden.',
+  'search.did_you_mean': 'Bedoelde u:',
   'error.lov_value': '{label}: kies een waarde uit de lijst.',
   'item.yes': 'Ja',
   'item.no': 'Nee',

package/src/runtime/report.ts

@@ -17,6 +17,7 @@ import { REPORT_CHART_KINDS } from './charts.ts';
 import { ComputeError, computeNameOk, computeSql, type Computation } from './compute.ts';
 import { GRID_VIEWS, renderView, VIEWS, type View } from './report-views.ts';
 import { columnTemplates } from './template-components.ts';
+import { textSearchConfig } from './search.ts';
 import { facetFilterSql, facetFilters, hidesColumns, reportFacetDefs, searchSql, userColumnNames } from './facet-state.ts';
 import { resolveRestRegion } from './rest-sources.ts';
 import { checksumValid, signText } from '../security.ts';
@@ -409,6 +410,18 @@ export async function withComputations(ctx: PageContext, r: Region, src: string,
   return { src: exprs.length ? `select "__s".*, ${exprs.join(', ')} from (\n${src}\n) "__s"` : src, errors };
 }
 
+/**
+ * (135) The tsvector column a report's search also uses: the one its attributes name (`fulltext`, which may be a
+ * hidden column: the developer chose it), else the only tsvector column the user may see; null when there is none.
+ */
+export function fulltextColumn(r: Pick<Region, 'config'>, fields: { name: string; dataTypeID: number }[], userCols: Map<string, number>) {
+  const TSVECTOR = 3614;
+  const named = typeof r.config.fulltext === 'string' ? r.config.fulltext : null;
+  if (named) return fields.find((f) => f.name === named && f.dataTypeID === TSVECTOR)?.name ?? null;
+  const shown = fields.filter((f) => f.dataTypeID === TSVECTOR && userCols.has(f.name));
+  return shown.length === 1 ? shown[0].name : null;
+}
+
 /**
  * The report's query with the user's search, filters and facets applied:
  * the source, the WHERE clause, and the result's column names (only looked
@@ -422,14 +435,25 @@ export async function filtered(ctx: PageContext, r: Region, st: ReportState) {
   const p = new SqlParams();
   const hides = hidesColumns(r);
   const facets = facetFilters(ctx.params, r.id, reportFacetDefs(ctx.page.regions, r.id, ctx.vis?.regions), undefined, appDateReader(ctx));
-  const needCols = st.filters.length || facets.length || st.breakCol || st.aggregates.length || st.highlights.length || st.view !== 'report' || st.area || st.near || keysetColumns(r) || (hides && (st.search || st.sort)) || (st.search && st.searchCol);
+  const needCols = st.filters.length || facets.length || st.breakCol || st.aggregates.length || st.highlights.length || st.view !== 'report' || st.area || st.near || keysetColumns(r) || (hides && (st.search || st.sort)) || st.search;
   // column name → type oid
   const fields = needCols ? await fieldsOf(ctx, src) : [];
   const cols = new Map<string, number>(fields.map((f) => [f.name, f.dataTypeID]));
   // the columns the user may choose (filters, highlights, control break, aggregates, views, sorting): not the hidden ones
   const userCols = new Map<string, number>(userColumnNames(r, [...cols.keys()]).map((n) => [n, cols.get(n)!]));
   // (sprint 76) the search in one column the user may see, or in all
-  if (st.search) where.push(searchSql(st.search, p, st.searchCol && userCols.has(st.searchCol) ? [st.searchCol] : hides ? [...userCols.keys()] : undefined));
+  if (st.search) {
+    const oneCol = !!st.searchCol && userCols.has(st.searchCol);
+    let cond = searchSql(st.search, p, oneCol ? [st.searchCol!] : hides ? [...userCols.keys()] : undefined);
+    // (135) a tsvector column in the source: the search also finds rows by full-text search (stemmed words,
+    // "phrases", or, -word), with a text search configuration from pg_ts_config as a query parameter
+    const fts = oneCol ? null : fulltextColumn(r, fields, userCols);
+    if (fts) {
+      const cfg = await textSearchConfig(ctx.client!, typeof r.config.fulltext_config === 'string' ? r.config.fulltext_config : null, ctx.app.language);
+      cond = `(${cond} or ${q(fts)} @@ websearch_to_tsquery(${p.add(cfg, 'regconfig')}, ${p.add(st.search, 'text')}))`;
+    }
+    where.push(cond);
+  }
   for (const f of st.filters) if (userCols.has(f.column)) where.push(OPERATORS[f.op].sql(q(f.column), f.value));
   for (const f of facets) {
     const cond = facetFilterSql(f, cols, p);

package/src/runtime/search.ts

@@ -10,8 +10,15 @@
 //  - sql:   a SELECT (binds allowed), wrapped as a subquery;
 //  - list:  the entries of a list (Shared Components → Lists) the user may see.
 //
-// Every word of the search text must be found in one of the searchable
-// columns (ILIKE, % and _ escaped, the text as a query parameter). The
+// Search type standard: every word of the search text must be found in one
+// of the searchable columns (ILIKE, % and _ escaped, the text as a query
+// parameter). Search type fulltext (135): the source's tsvector matched
+// with websearch_to_tsquery (quotes, or, -word), the best match first
+// (ts_rank_cd), title, subtitle and description highlighted by ts_headline
+// (between private-use markers that only then become <mark>, everything
+// else escaped); the text search configuration is checked against
+// pg_ts_config and passed as a parameter. With pg_trgm installed, a
+// configuration may suggest the closest words when nothing is found. The
 // queries run as the application's role in the page's transaction, each in a
 // savepoint, so one configuration that fails shows its error and the others
 // still answer. Without JavaScript the field is a GET form; app.js searches
@@ -42,6 +49,14 @@ export interface SearchConfig {
   icon: string | null;
   link: { page?: number; items?: Record<string, string> } | null;
   max_results: number;
+  /** (135) standard: ILIKE per word · fulltext: PostgreSQL full-text search (later: vector, hybrid) */
+  search_type?: 'standard' | 'fulltext';
+  /** (135) fulltext: a tsvector column or expression; empty: to_tsvector over the searchable columns */
+  fts_vector?: string | null;
+  /** (135) fulltext: the text search configuration; empty: the application language's */
+  fts_config?: string | null;
+  /** (135) with pg_trgm: suggest the closest words when nothing is found */
+  did_you_mean?: boolean;
 }
 
 export interface SearchRegionConfig {
@@ -58,6 +73,54 @@ const MAX_TEXT = 200;
 const COLUMN = /^[A-Za-z_][A-Za-z0-9_$]{0,62}$/;
 const TABLE = /^([A-Za-z_][A-Za-z0-9_$]{0,62}\.)?[A-Za-z_][A-Za-z0-9_$]{0,62}$/;
 
+/** A client, a pool or pgkiln's Db: something that runs a query with parameters. */
+type Queryable = { query: (sql: string, params?: unknown[]) => Promise<{ rows: any[] }> };
+
+/** (135) The search types (later: vector, hybrid). */
+export const SEARCH_TYPES = ['standard', 'fulltext'] as const;
+const TS_CONFIG = /^[a-z_][a-z0-9_]{0,62}$/;
+
+/** (135) The text search configuration of a language: pgkiln's languages that PostgreSQL has a stemmer for. */
+const TS_BY_LANGUAGE: Record<string, string> = {
+  ar: 'arabic', ca: 'catalan', da: 'danish', de: 'german', el: 'greek', en: 'english', es: 'spanish', eu: 'basque', fi: 'finnish',
+  fr: 'french', ga: 'irish', hi: 'hindi', hu: 'hungarian', hy: 'armenian', id: 'indonesian', it: 'italian', lt: 'lithuanian',
+  nb: 'norwegian', ne: 'nepali', nl: 'dutch', nn: 'norwegian', no: 'norwegian', pt: 'portuguese', ro: 'romanian', ru: 'russian',
+  sr: 'serbian', sv: 'swedish', ta: 'tamil', tr: 'turkish', yi: 'yiddish',
+};
+export const tsConfigFor = (language: string | null | undefined) => TS_BY_LANGUAGE[String(language ?? '').toLowerCase().split(/[-_]/)[0]] ?? 'simple';
+
+/**
+ * (135) The text search configuration to use: the one asked for, else the language's, if it exists in
+ * pg_ts_config; else simple. Only a name that exists is returned (and it is still passed as a parameter).
+ */
+export async function textSearchConfig(db: Queryable, wanted: string | null | undefined, language: string | null | undefined): Promise<string> {
+  const names = [wanted, tsConfigFor(language)].filter((x): x is string => !!x && TS_CONFIG.test(x));
+  if (!names.length) return 'simple';
+  const found = (await db.query('select cfgname from pg_catalog.pg_ts_config where cfgname = any($1::text[])', [names])).rows.map((r: { cfgname: string }) => r.cfgname);
+  return names.find((n) => found.includes(n)) ?? 'simple';
+}
+
+/** (135) The schema of pg_trgm when it is installed (its functions are called schema-qualified), else null. */
+export async function trigramSchema(db: Queryable): Promise<string | null> {
+  return (await db.query(`select n.nspname as s from pg_catalog.pg_extension e join pg_catalog.pg_namespace n on n.oid = e.extnamespace where e.extname = 'pg_trgm'`)).rows[0]?.s ?? null;
+}
+
+/** (135) The markers ts_headline puts around a matched word (private-use characters, removed from the text first). */
+export const HL_START = '\uE000';
+export const HL_STOP = '\uE001';
+
+/** (135) A ts_headline result as HTML: everything escaped, only the text between the markers in <mark>. */
+export function headlined(value: string): Raw {
+  const parts: Raw[] = [];
+  let last = 0;
+  for (const m of value.matchAll(/\uE000([^\uE000\uE001]*)\uE001/g)) {
+    parts.push(html`${value.slice(last, m.index).replace(/[\uE000\uE001]/g, '')}${m[1] ? html`<mark>${m[1]}</mark>` : ''}`);
+    last = m.index! + m[0].length;
+  }
+  parts.push(html`${value.slice(last).replace(/[\uE000\uE001]/g, '')}`);
+  return html`${parts}`;
+}
+
 /** The columns a configuration names (for the Advisor's check of its source). */
 export const configColumns = (c: Pick<SearchConfig, 'title_column' | 'subtitle_column' | 'description_column' | 'badge_column' | 'searchable_columns' | 'icon'>) =>
   [...new Set([c.title_column, c.subtitle_column, c.description_column, c.badge_column, ...(c.searchable_columns ?? []), /^#(.+)#$/.exec(c.icon ?? '')?.[1]]
@@ -87,6 +150,12 @@ export function searchConfigProblems(c: Partial<SearchConfig>): string[] {
   if (c.source_type === 'table' && !TABLE.test((c.source ?? '').trim())) out.push('The source of a table configuration is a table or view name, e.g. sales.customers.');
   if (c.icon && !/^(#[A-Za-z_][A-Za-z0-9_$]*#|[a-z0-9-]{1,40})$/.test(c.icon)) out.push('The icon is an icon name, or #COLUMN# for a column that holds icon names.');
   if (c.link && (typeof c.link !== 'object' || !Number.isInteger(c.link.page))) out.push('The link is {"page": 3, "items": {"P3_ID": "#ID#"}}.');
+  if (c.search_type && !SEARCH_TYPES.includes(c.search_type)) out.push(`The search type is one of ${SEARCH_TYPES.join(', ')}.`);
+  if (c.search_type === 'fulltext') {
+    if (c.source_type === 'list') out.push('Full-text search needs a table or SQL source.');
+    if (c.fts_config && !TS_CONFIG.test(c.fts_config)) out.push('The text search configuration is a name, e.g. english, dutch or simple.');
+    if (c.fts_vector && /;|--|\/\*/.test(c.fts_vector)) out.push('The tsvector is one column or expression (no ; or comments).');
+  }
   return out;
 }
 
@@ -97,7 +166,8 @@ async function configsOf(ctx: PageContext, r: Region): Promise<SearchConfig[]> {
   return (
     await runtime.query<SearchConfig>(
       `select name, label, seq, source_type, source, searchable_columns, title_column, subtitle_column, description_column,
-              badge_column, icon, link, max_results
+              badge_column, icon, link, max_results,
+              search_type, fts_vector, fts_config, did_you_mean
          from meta.search_config
         where app_id = $1 and meta.build_option_on(app_id, build_option) and (cardinality($2::text[]) = 0 or name = any($2))
         order by seq, name`,
@@ -113,6 +183,8 @@ interface Hit {
   badge: string | null;
   icon: string | null;
   href: Raw | null;
+  /** (135) full-text search: title, subtitle and description as highlighted by ts_headline */
+  headlines?: { title: Raw; subtitle: Raw | null; description: Raw | null };
 }
 
 const text = (v: unknown) => (v === null || v === undefined ? null : typeof v === 'object' ? JSON.stringify(v) : String(v));
@@ -124,21 +196,58 @@ function col(row: Record<string, unknown>, name: string | null) {
   return key === undefined ? null : text(row[key]);
 }
 
-/** One configuration's results on a table or a query: up to max_results, and whether there are more. */
-async function searchRows(ctx: PageContext, c: SearchConfig, words: string[]): Promise<{ hits: Hit[]; more: boolean }> {
-  const searched = (c.searchable_columns.length ? c.searchable_columns : [c.title_column, c.subtitle_column, c.description_column]).filter(
-    (x): x is string => !!x,
-  );
-  const conditions = words.map((_, i) => `(${searched.map((s) => `t.${ident(s)}::text ilike $${i + 1} escape '\\'`).join(' or ')})`);
-  let from: string;
+/** The columns a configuration searches: its searchable columns, else title, subtitle and description. */
+const searchedColumns = (c: SearchConfig) =>
+  (c.searchable_columns.length ? c.searchable_columns : [c.title_column, c.subtitle_column, c.description_column]).filter((x): x is string => !!x);
+
+/** The FROM of a table or SQL configuration (the source as `t`). */
+async function sourceFrom(ctx: PageContext, c: SearchConfig) {
   if (c.source_type === 'table') {
     const table = (await ctx.client!.query('select $1::regclass::text as t', [c.source])).rows[0].t as string;
-    from = `${table} t`;
-  } else from = `(${stripSemicolon(applyBinds(c.source, bindValues(ctx)))}) t`;
-  const sql = `select t.* from ${from} where ${conditions.join(' and ') || 'true'}${c.title_column ? ` order by t.${ident(c.title_column)}` : ''} limit ${c.max_results + 1}`;
-  const res = await ctx.client!.query(sql, words.map(likePattern));
-  const rows = res.rows as Record<string, unknown>[];
+    return `${table} t`;
+  }
+  return `(${stripSemicolon(applyBinds(c.source, bindValues(ctx)))}) t`;
+}
+
+/**
+ * (135) The tsvector of a full-text configuration as SQL over `t`: its column, its expression, or to_tsvector
+ * over the searchable columns (`cfg` is the placeholder of the text search configuration).
+ */
+export function tsvectorSql(c: Pick<SearchConfig, 'fts_vector' | 'searchable_columns' | 'title_column' | 'subtitle_column' | 'description_column'>, cfg: string) {
+  const v = (c.fts_vector ?? '').trim();
+  if (v) return COLUMN.test(v) ? `t.${ident(v)}` : `(${v})`;
+  const cols = searchedColumns(c as SearchConfig);
+  return `to_tsvector(${cfg}, ${cols.map((x) => `coalesce(t.${ident(x)}::text, '')`).join(` || ' ' || `) || `''`})`;
+}
+
+/** One configuration's results on a table or a query: up to max_results, and whether there are more. */
+async function searchRows(ctx: PageContext, c: SearchConfig, words: string[], query: string): Promise<{ hits: Hit[]; more: boolean }> {
+  const from = await sourceFrom(ctx, c);
+  let rows: Record<string, unknown>[];
+  const fulltext = c.search_type === 'fulltext';
+  if (fulltext) {
+    // $1 the text search configuration (a name from pg_ts_config), $2 the user's text, $3 the headline options,
+    // $4 the marker characters (taken out of the values first, so only ts_headline's markers become markup)
+    const cfg = await textSearchConfig(ctx.client!, c.fts_config, ctx.app.language);
+    const vec = tsvectorSql(c, '$1::regconfig');
+    const hl = (column: string | null, alias: string, options: string) =>
+      column ? `, ts_headline($1::regconfig, translate(s.${ident(column)}::text, $4, ''), "pgkiln$q".query, ${options}) as "pgkiln$${alias}"` : '';
+    const sql = `select s.*${hl(c.title_column, 'title', '$3::text || \', HighlightAll=true\'')}${hl(c.subtitle_column, 'subtitle', '$3::text || \', HighlightAll=true\'')}${hl(c.description_column, 'description', '$3::text || \', MaxWords=35, MinWords=15, MaxFragments=2, FragmentDelimiter=" … "\'')}
+      from (select t.*, ts_rank_cd(${vec}, "pgkiln$q".query) as "pgkiln$rank"
+              from ${from}, websearch_to_tsquery($1::regconfig, $2) "pgkiln$q"(query)
+             where ${vec} @@ "pgkiln$q".query
+             order by "pgkiln$rank" desc${c.title_column ? `, t.${ident(c.title_column)}` : ''}
+             limit ${c.max_results + 1}) s, websearch_to_tsquery($1::regconfig, $2) "pgkiln$q"(query)
+      order by s."pgkiln$rank" desc${c.title_column ? `, s.${ident(c.title_column)}` : ''}`;
+    rows = (await ctx.client!.query(sql, [cfg, query, `StartSel="${HL_START}", StopSel="${HL_STOP}"`, HL_START + HL_STOP])).rows;
+  } else {
+    const searched = searchedColumns(c);
+    const conditions = words.map((_, i) => `(${searched.map((s) => `t.${ident(s)}::text ilike $${i + 1} escape '\\'`).join(' or ')})`);
+    const sql = `select t.* from ${from} where ${conditions.join(' and ') || 'true'}${c.title_column ? ` order by t.${ident(c.title_column)}` : ''} limit ${c.max_results + 1}`;
+    rows = (await ctx.client!.query(sql, words.map(likePattern))).rows;
+  }
   const iconCol = /^#(.+)#$/.exec(c.icon ?? '')?.[1] ?? null;
+  const h = (row: Record<string, unknown>, alias: string) => (typeof row[`pgkiln$${alias}`] === 'string' ? headlined(row[`pgkiln$${alias}`] as string) : null);
   return {
     more: rows.length > c.max_results,
     hits: rows.slice(0, c.max_results).map((row) => ({
@@ -151,10 +260,37 @@ async function searchRows(ctx: PageContext, c: SearchConfig, words: string[]): P
         c.link && Number.isInteger(c.link.page)
           ? linkAttrs(ctx, c.link.page!, fillItems(c.link.items, (name) => col(row, name) ?? undefined))
           : null,
+      ...(fulltext ? { headlines: { title: h(row, 'title') ?? html`${col(row, c.title_column) ?? ''}`, subtitle: h(row, 'subtitle'), description: h(row, 'description') } } : {}),
     })),
   };
 }
 
+/**
+ * (135) "Did you mean": with pg_trgm installed, each search word that is not a word of the configuration's
+ * searched columns replaced by the most similar one (similarity 0.3 or more), from the first 10,000 rows of the
+ * source. Null when there is nothing better to suggest.
+ */
+async function suggestion(ctx: PageContext, c: SearchConfig, words: string[], trgm: string): Promise<string | null> {
+  const cols = searchedColumns(c);
+  if (!cols.length || !words.length) return null;
+  const sim = `${ident(trgm)}.similarity`;
+  const res = await ctx.client!.query<{ word: string; best: string | null; known: boolean }>(
+    `with v as (select distinct w from (select concat_ws(' ', ${cols.map((x) => `t.${ident(x)}::text`).join(', ')}) as doc from ${await sourceFrom(ctx, c)} limit 10000) d,
+                regexp_split_to_table(lower(d.doc), '[^[:alnum:]]+') w where length(w) between 2 and 40)
+     select u.word, exists (select from v where v.w = lower(u.word)) as known,
+            (select v.w from v where ${sim}(v.w, lower(u.word)) >= 0.3 order by ${sim}(v.w, lower(u.word)) desc, v.w limit 1) as best
+       from unnest($1::text[]) with ordinality u(word, n) order by u.n`,
+    [words],
+  );
+  let changed = false;
+  const out = res.rows.map((r) => {
+    if (r.known || !r.best) return r.word;
+    changed = true;
+    return r.best;
+  });
+  return changed ? out.join(' ') : null;
+}
+
 /** One configuration's results on a list: the entries (and their children) the user may see. */
 async function searchList(ctx: PageContext, c: SearchConfig, words: string[]): Promise<{ hits: Hit[]; more: boolean }> {
   const nodes = (await listTree(ctx, c.source)) ?? [];
@@ -204,18 +340,23 @@ async function searchResults(ctx: PageContext, r: Region, query: string): Promis
   const minLength = Number.isInteger(conf.min_length) && conf.min_length! > 0 ? conf.min_length! : 1;
   if (!words.length || query.trim().length < minLength) return html``;
   const groups: Raw[] = [];
-  for (const c of await configsOf(ctx, r)) {
+  const configs = await configsOf(ctx, r);
+  for (const c of configs) {
     let body: Raw;
     try {
       const problems = searchConfigProblems(c);
       if (problems.length) throw new Error(`Search configuration ${c.name}: ${problems.join(' ')}`);
-      const { hits, more } = await savepoint(ctx.client!, () => (c.source_type === 'list' ? searchList(ctx, c, words) : searchRows(ctx, c, words)));
+      const { hits, more } = await savepoint(ctx.client!, () => (c.source_type === 'list' ? searchList(ctx, c, words) : searchRows(ctx, c, words, query.trim())));
       if (!hits.length) continue;
       body = html`<ul class="search-hits">${hits.map((h) => {
+        // (135) full-text results: ts_headline's highlights (stemmed words: "running" marks "run"); else the words
+        const title = h.headlines?.title ?? marked(h.title, words);
+        const subtitle = h.subtitle ? (h.headlines?.subtitle ?? marked(h.subtitle, words)) : null;
+        const description = h.description ? (h.headlines?.description ?? marked(h.description, words)) : null;
         const inner = html`${h.icon ? html`<span class="search-icon">${icon(h.icon)}</span>` : ''}
-          <span class="search-text"><span class="search-title">${marked(h.title, words)}</span>${
-            h.subtitle ? html`<span class="search-subtitle">${marked(h.subtitle, words)}</span>` : ''}${
-            h.description ? html`<span class="search-description">${marked(h.description, words)}</span>` : ''}</span>
+          <span class="search-text"><span class="search-title">${title}</span>${
+            subtitle ? html`<span class="search-subtitle">${subtitle}</span>` : ''}${
+            description ? html`<span class="search-description">${description}</span>` : ''}</span>
           ${h.badge ? html`<span class="badge-pill">${marked(h.badge, words)}</span>` : ''}`;
         return html`<li>${h.href ? html`<a class="search-hit" ${h.href}>${inner}</a>` : html`<div class="search-hit">${inner}</div>`}</li>`;
       })}</ul>${more ? html`<p class="muted search-more">${ctx.locale.t('region.first_rows', { n: String(c.max_results) })}</p>` : ''}`;
@@ -226,7 +367,29 @@ async function searchResults(ctx: PageContext, r: Region, query: string): Promis
     groups.push(html`<section class="search-group"><h3>${ctx.locale.tr(c.label)}</h3>${body}</section>`);
   }
   // (a configuration that failed shows its error as a group of its own)
-  return groups.length ? html`${groups}` : html`<p class="muted search-empty">${conf.empty ?? ctx.locale.t('lov.no_rows')}</p>`;
+  if (groups.length) return html`${groups}`;
+  return html`<p class="muted search-empty">${conf.empty ?? ctx.locale.t('lov.no_rows')}</p>${await didYouMean(ctx, r, configs, words)}`;
+}
+
+/** (135) Nothing found: the first suggestion of a configuration that asks for one (pg_trgm installed), as a link. */
+async function didYouMean(ctx: PageContext, r: Region, configs: SearchConfig[], words: string[]): Promise<Raw | ''> {
+  const asking = configs.filter((c) => c.did_you_mean && c.source_type !== 'list' && !searchConfigProblems(c).length);
+  if (!asking.length) return '';
+  const trgm = await trigramSchema(ctx.client!);
+  if (!trgm) return '';
+  for (const c of asking) {
+    // a configuration that fails here suggests nothing (its error was shown, or there was none to show)
+    const s = await savepoint(ctx.client!, () => suggestion(ctx, c, words, trgm)).catch(() => null);
+    if (!s) continue;
+    const conf = (r.config ?? {}) as SearchRegionConfig;
+    const label = ctx.locale.t('search.did_you_mean');
+    // the region's own field: a link that searches for the suggestion; a page item: the words only
+    if (typeof conf.item === 'string' && conf.item) return html`<p class="muted search-suggestion">${label} <b>${s}</b></p>`;
+    const params = new URLSearchParams([...ctx.params].filter(([k]) => k !== searchParam(r)));
+    params.set(searchParam(r), s);
+    return html`<p class="muted search-suggestion">${label} <a href="${ctx.base}/${ctx.page.page_no}?${params}">${s}</a></p>`;
+  }
+  return '';
 }
 
 export async function renderSearch(ctx: PageContext, r: Region): Promise<Raw> {