@chkit/core 0.1.2-beta.5 → 0.2.0-beta.11

package/dist/text-index-sql.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-index-sql.js","sourceRoot":"","sources":["../src/text-index-sql.ts"],"names":[],"mappings":"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"}

package/dist/text-index.d.ts

@@ -0,0 +1,10 @@
+import type { TextSkipIndex } from './model-types.js';
+export { normalizeTextIndexSQL } from './text-index-sql.js';
+export declare const TEXT_INDEX_GRANULARITY = 100000000;
+type Params = Omit<TextSkipIndex, 'name' | 'type' | 'expression' | 'granularity'>;
+export declare function renderTextIndexType(index: Params): string;
+/** Fail explicitly on unknown or malformed parameters rather than losing them on pull. */
+export declare function parseTextIndexParams(args: string): Params;
+export declare function canonicalizeTextIndex(index: TextSkipIndex): TextSkipIndex;
+export declare function textIndexFingerprint(index: TextSkipIndex): string;
+//# sourceMappingURL=text-index.d.ts.map

package/dist/text-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-index.d.ts","sourceRoot":"","sources":["../src/text-index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AASrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,eAAO,MAAM,sBAAsB,YAAc,CAAA;AAEjD,KAAK,MAAM,GAAG,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,YAAY,GAAG,aAAa,CAAC,CAAA;AAYjF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CA4BzD;AAED,0FAA0F;AAC1F,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAoCzD;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,aAAa,GAAG,aAAa,CAUzE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAajE"}

package/dist/text-index.js

@@ -0,0 +1,121 @@
+import { formatTextSQL, normalizeTextIndexSQL, textExpressionFingerprint, textSQLTokens, textSQLFingerprint, } from './text-index-sql.js';
+export { normalizeTextIndexSQL } from './text-index-sql.js';
+export const TEXT_INDEX_GRANULARITY = 100_000_000;
+const PARAMETERS = [
+    ['tokenizer', 'tokenizer', 'sql'],
+    ['preprocessor', 'preprocessor', 'sql'],
+    ['postprocessor', 'postprocessor', 'sql'],
+    ['supportPhraseSearch', 'support_phrase_search', 'boolean'],
+    ['dictionaryBlockSize', 'dictionary_block_size', 'number'],
+    ['dictionaryBlockFrontcodingCompression', 'dictionary_block_frontcoding_compression', 'boolean'],
+    ['postingListBlockSize', 'posting_list_block_size', 'number'],
+    ['postingListCodec', 'posting_list_codec', 'codec'],
+];
+export function renderTextIndexType(index) {
+    if (typeof index.tokenizer !== 'string' || !textSQLTokens(index.tokenizer).length) {
+        throw new Error('A non-empty tokenizer is required');
+    }
+    const parts = [];
+    for (const [field, key, kind] of PARAMETERS) {
+        const value = index[field];
+        if (value === undefined)
+            continue;
+        let sql;
+        if (kind === 'sql') {
+            if (typeof value !== 'string' || !textSQLTokens(value).length)
+                throw new Error(`${field} must be non-empty SQL`);
+            sql = normalizeTextIndexSQL(value);
+        }
+        else if (kind === 'boolean') {
+            if (typeof value !== 'boolean')
+                throw new Error(`${field} must be a boolean`);
+            sql = value ? '1' : '0';
+        }
+        else if (kind === 'number') {
+            if (typeof value !== 'number' || !Number.isSafeInteger(value) || value <= 0)
+                throw new Error(`${field} must be a positive safe integer`);
+            sql = String(value);
+        }
+        else {
+            if (value !== 'none' && value !== 'bitpacking')
+                throw new Error(`${field} must be none or bitpacking`);
+            sql = `'${value}'`;
+        }
+        parts.push(`${key} = ${sql}`);
+    }
+    return `text(${parts.join(', ')})`;
+}
+/** Fail explicitly on unknown or malformed parameters rather than losing them on pull. */
+export function parseTextIndexParams(args) {
+    const tokens = textSQLTokens(args);
+    let group = [];
+    const groups = [group];
+    let depth = 0;
+    for (const token of tokens) {
+        if (['(', '[', '{'].includes(token))
+            depth++;
+        if ([')', ']', '}'].includes(token))
+            depth--;
+        if (token === ',' && depth === 0) {
+            group = [];
+            groups.push(group);
+        }
+        else
+            group.push(token);
+    }
+    const params = {};
+    for (const group of groups) {
+        const [key, equals, ...value] = group;
+        const parameter = PARAMETERS.find((item) => item[1] === key);
+        if (!parameter || equals !== '=' || value.length === 0)
+            throw new Error(`Invalid or unsupported text index parameter: ${formatTextSQL(group)}`);
+        const [field, , kind] = parameter;
+        if (field in params)
+            throw new Error(`Duplicate text index parameter: ${key}`);
+        const raw = formatTextSQL(value);
+        if (kind === 'boolean') {
+            if (!/^(0|1|true|false)$/i.test(raw))
+                throw new Error(`Invalid boolean for ${key}: ${raw}`);
+            params[field] = raw === '1' || raw.toLowerCase() === 'true';
+        }
+        else if (kind === 'number') {
+            if (!/^\d+$/.test(raw))
+                throw new Error(`Invalid integer for ${key}: ${raw}`);
+            params[field] = Number(raw);
+        }
+        else if (kind === 'codec') {
+            params[field] = raw.slice(1, -1);
+            if (raw !== "'none'" && raw !== "'bitpacking'")
+                throw new Error(`Invalid codec: ${raw}`);
+        }
+        else
+            params[field] = raw;
+    }
+    const result = params;
+    renderTextIndexType(result);
+    return result;
+}
+export function canonicalizeTextIndex(index) {
+    // Parse/render fixes key order as well as SQL formatting for migration snapshots.
+    const type = renderTextIndexType(index);
+    return {
+        name: index.name,
+        expression: textExpressionFingerprint(index.expression),
+        type: 'text',
+        granularity: TEXT_INDEX_GRANULARITY,
+        ...parseTextIndexParams(type.slice(5, -1)),
+    };
+}
+export function textIndexFingerprint(index) {
+    const canonical = canonicalizeTextIndex(index);
+    return JSON.stringify({
+        ...canonical,
+        expression: textSQLFingerprint(canonical.expression),
+        tokenizer: textSQLFingerprint(canonical.tokenizer),
+        preprocessor: canonical.preprocessor === undefined ? undefined : textSQLFingerprint(canonical.preprocessor),
+        postprocessor: canonical.postprocessor === undefined
+            ? undefined
+            : textSQLFingerprint(canonical.postprocessor),
+    });
+}
+//# sourceMappingURL=text-index.js.map

package/dist/text-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-index.js","sourceRoot":"","sources":["../src/text-index.ts"],"names":[],"mappings":"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"}

package/dist/ts-import.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ts-import.d.ts","sourceRoot":"","sources":["../src/ts-import.ts"],"names":[],"mappings":"AAEA,KAAK,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAiB9C;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAMrF"}
+{"version":3,"file":"ts-import.d.ts","sourceRoot":"","sources":["../src/ts-import.ts"],"names":[],"mappings":"AAGA,KAAK,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAyB9C;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAIrF"}

package/dist/ts-import.js

@@ -1,5 +1,13 @@
+import { realpath } from 'node:fs/promises';
 import { pathToFileURL } from 'node:url';
 let cachedNodeImporter = null;
+// Bun never settles a second import() of a file that failed to parse, even after
+// the file is fixed, and a second import() of a module whose evaluation threw
+// resolves to the half-evaluated module. Each failure is kept and thrown again,
+// so importing the same file twice in one process fails the same way. Bun knows
+// a module by its real path, so the import and the kept failure use it too: a
+// path through a symlink (such as /tmp on macOS) is the same file.
+const failedBunImports = new Map();
 function isBun() {
     return typeof globalThis.Bun !== 'undefined';
 }
@@ -20,10 +28,22 @@ async function getNodeImporter() {
  * modules load the same way under either runtime.
  */
 export async function importModuleFile(absolutePath) {
-    if (isBun()) {
-        return (await import(pathToFileURL(absolutePath).href));
-    }
+    if (isBun())
+        return importWithBun(absolutePath);
     const nodeImport = await getNodeImporter();
     return nodeImport(absolutePath);
 }
+async function importWithBun(absolutePath) {
+    // A path that does not resolve is imported as given, so the import reports it.
+    const href = pathToFileURL(await realpath(absolutePath).catch(() => absolutePath)).href;
+    if (failedBunImports.has(href))
+        throw failedBunImports.get(href);
+    try {
+        return (await import(href));
+    }
+    catch (error) {
+        failedBunImports.set(href, error);
+        throw error;
+    }
+}
 //# sourceMappingURL=ts-import.js.map

package/dist/ts-import.js.map

@@ -1 +1 @@
-{"version":3,"file":"ts-import.js","sourceRoot":"","sources":["../src/ts-import.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAKxC,IAAI,kBAAkB,GAA0B,IAAI,CAAA;AAEpD,SAAS,KAAK;IACZ,OAAO,OAAQ,UAAgC,CAAC,GAAG,KAAK,WAAW,CAAA;AACrE,CAAC;AAED,KAAK,UAAU,eAAe;IAC5B,IAAI,kBAAkB;QAAE,OAAO,kBAAkB,CAAA;IACjD,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAA;IAC3C,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACxC,kBAAkB,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAA6B,CAAA;IACxE,OAAO,kBAAkB,CAAA;AAC3B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,YAAoB;IACzD,IAAI,KAAK,EAAE,EAAE,CAAC;QACZ,OAAO,CAAC,MAAM,MAAM,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAoB,CAAA;IAC5E,CAAC;IACD,MAAM,UAAU,GAAG,MAAM,eAAe,EAAE,CAAA;IAC1C,OAAO,UAAU,CAAC,YAAY,CAAC,CAAA;AACjC,CAAC"}
+{"version":3,"file":"ts-import.js","sourceRoot":"","sources":["../src/ts-import.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAKxC,IAAI,kBAAkB,GAA0B,IAAI,CAAA;AAEpD,iFAAiF;AACjF,8EAA8E;AAC9E,gFAAgF;AAChF,gFAAgF;AAChF,8EAA8E;AAC9E,mEAAmE;AACnE,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAmB,CAAA;AAEnD,SAAS,KAAK;IACZ,OAAO,OAAQ,UAAgC,CAAC,GAAG,KAAK,WAAW,CAAA;AACrE,CAAC;AAED,KAAK,UAAU,eAAe;IAC5B,IAAI,kBAAkB;QAAE,OAAO,kBAAkB,CAAA;IACjD,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAA;IAC3C,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACxC,kBAAkB,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAA6B,CAAA;IACxE,OAAO,kBAAkB,CAAA;AAC3B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,YAAoB;IACzD,IAAI,KAAK,EAAE;QAAE,OAAO,aAAa,CAAC,YAAY,CAAC,CAAA;IAC/C,MAAM,UAAU,GAAG,MAAM,eAAe,EAAE,CAAA;IAC1C,OAAO,UAAU,CAAC,YAAY,CAAC,CAAA;AACjC,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,YAAoB;IAC/C,+EAA+E;IAC/E,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,QAAQ,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAA;IACvF,IAAI,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,MAAM,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAChE,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,CAAoB,CAAA;IAChD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,gBAAgB,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;QACjC,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC"}

package/dist/validate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAIV,gBAAgB,EAEhB,eAAe,EAEhB,MAAM,YAAY,CAAA;AA0OnB,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,gBAAgB,EAAE,GAAG,eAAe,EAAE,CAwBtF;AAED,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAG5E"}
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAMV,gBAAgB,EAEhB,eAAe,EAEhB,MAAM,YAAY,CAAA;AAiqBnB,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,gBAAgB,EAAE,GAAG,eAAe,EAAE,CA2BtF;AAED,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAG5E"}

package/dist/validate.js

@@ -1,7 +1,15 @@
+import { renderTextIndexType } from './text-index.js';
 import { definitionKey } from './canonical.js';
 import { canonicalizeCodec, isGeneralCodec, isRawCodec } from './codec.js';
-import { isPlainColumnReference, normalizeKeyColumns } from './key-clause.js';
+import { LEGACY_EXPRESSION_PREFIX, columnTypeAcceptsStringLiteral, isSQLExpression, parseColumnDefault, readsUnparsableEphemeralLiteralAsNull, renderDefault, startsWithFunctionCall, storesUnparsableLiteralAsNull, trimExpression, } from './column-default.js';
+import { describeInvalidIdentifier } from './identifier.js';
+import { isPlainColumnReference, normalizeKeyColumns, splitTopLevelComma } from './key-clause.js';
 import { isIndexProjection, normalizeProjectionIndex } from './projection.js';
+import { stripWrappingParens } from './sql-scan.js';
+import { isKafkaEngine } from './kafka.js';
+import { tokenizeSQL } from './sql-lexer.js';
+import { normalizeSQLFragment } from './sql-normalizer.js';
+import { textSQLTokens } from './text-index-sql.js';
 import { ChxValidationError as ValidationError } from './model.js';
 function pushValidationIssue(issues, def, code, message) {
     issues.push({
@@ -38,7 +46,174 @@ function validateColumnCodec(def, column, issues) {
         pushValidationIssue(issues, def, 'codec_chain_must_end_with_general', `Table ${def.database}.${def.name} column "${column.name}" codec chain must end with a general codec (NONE, LZ4, LZ4HC, ZSTD, T64, GCD, ALP)`);
     }
 }
+const COLUMN_DEFAULT_KINDS = new Set(['DEFAULT', 'MATERIALIZED', 'ALIAS', 'EPHEMERAL']);
+// Runs on raw definitions (toCreateSQL) and canonical ones (planDiff), where
+// `{ expression }` is already the `fn:` string; parseColumnDefault reads both.
+function validateColumnDefault(def, column, issues) {
+    const subject = `Table ${def.database}.${def.name} column "${column.name}"`;
+    const kind = column.defaultKind ?? 'DEFAULT';
+    const value = column.default;
+    if (value === undefined) {
+        if (kind === 'MATERIALIZED' || kind === 'ALIAS') {
+            pushValidationIssue(issues, def, 'column_expression_required', `${subject} is ${kind} and requires a non-empty expression. Set default: { expression: "<sql>" }.`);
+        }
+        return;
+    }
+    if (value === null)
+        return;
+    if (typeof value === 'object' && !isSQLExpression(value)) {
+        pushValidationIssue(issues, def, 'column_default_invalid', `${subject} has an unsupported default value. Use a string, number, or boolean literal, or { expression: "<sql>" } for a SQL expression.`);
+        return;
+    }
+    const parsed = parseColumnDefault(value);
+    if (parsed.kind === 'expression') {
+        validateDefaultExpression(def, subject, kind, parsed.sql, issues);
+        return;
+    }
+    if (typeof parsed.value !== 'string')
+        return;
+    // A string renders as a quoted literal for every kind. MATERIALIZED and ALIAS
+    // compute their value, so there it is almost always SQL written without
+    // { expression }; a constant string is spelled { expression: "'text'" }.
+    if (kind === 'MATERIALIZED' || kind === 'ALIAS') {
+        pushValidationIssue(issues, def, 'column_expression_requires_fn', describePlainStringExpression(subject, kind, parsed.value));
+        return;
+    }
+    // DEFAULT and EPHEMERAL keep a string as a literal. On a column that cannot
+    // hold a string, one that starts with a function call is SQL written without
+    // { expression }: ClickHouse rejects the literal, or reads it as NULL (#234).
+    if ((kind !== 'DEFAULT' && kind !== 'EPHEMERAL') || !startsWithFunctionCall(parsed.value))
+        return;
+    const type = typeof column.type === 'string' ? column.type.trim() : '';
+    if (columnTypeAcceptsStringLiteral(type))
+        return;
+    pushValidationIssue(issues, def, 'column_default_looks_like_expression', describeQuotedFunctionDefault(subject, kind, column.nullable ? `Nullable(${type})` : type, parsed.value));
+}
+function validateDefaultExpression(def, subject, kind, sql, issues) {
+    const rendered = renderDefault({ expression: sql });
+    if (rendered === '') {
+        const removable = kind !== 'MATERIALIZED' && kind !== 'ALIAS';
+        pushValidationIssue(issues, def, 'column_expression_required', `${subject} has an empty default expression. Put the SQL in default: { expression: "<sql>" }${removable ? ', or remove default' : ''}.`);
+        return;
+    }
+    // The expression is rendered mid-statement, so an open string, quoted
+    // identifier or block comment would swallow the SQL after it, the next
+    // statements of the migration file included.
+    const tokens = tokenizeSQL(sql);
+    const unterminated = tokens.find((token) => !token.terminated);
+    if (unterminated !== undefined) {
+        pushValidationIssue(issues, def, 'column_default_invalid', `${subject} has default expression ${JSON.stringify(sql)} with an unterminated ${describeOpenToken(unterminated)}, which would swallow the rest of the generated SQL. Close it or remove it.`);
+    }
+    // ClickHouse reads `#` as a comment only before a space or `!`; any other
+    // `#` is a syntax error. Report it here instead of at migrate: at the end of
+    // an expression it used to turn the ` COMMENT` or ` CODEC` rendered after it
+    // into a comment, and the statement applied without them.
+    if (tokens.some(isStrayHash)) {
+        pushValidationIssue(issues, def, 'column_default_invalid', `${subject} has default expression ${JSON.stringify(sql)} with a # that starts no comment, which ClickHouse rejects. Remove it, or put a space after it to start a comment: "# note".`);
+    }
+    // The prefix only marks a plain string as SQL. Inside an expression it is
+    // text: `{ expression: 'fn:now()' }` would render `DEFAULT fn:now()`.
+    if (keepsLegacyPrefix(rendered)) {
+        const unprefixed = rendered.slice(LEGACY_EXPRESSION_PREFIX.length).trim();
+        pushValidationIssue(issues, def, 'column_default_invalid', `${subject} has default expression ${JSON.stringify(rendered)}, which keeps the legacy fn: prefix and would render ${kind} ${rendered}, a syntax error. Remove the prefix: default: { expression: ${JSON.stringify(unprefixed)} }.`);
+    }
+}
+// Whether validateDefaultExpression accepts `sql`, so that a message can
+// suggest it as the fix.
+function passesExpressionChecks(sql) {
+    const rendered = renderDefault({ expression: sql });
+    return (rendered !== '' &&
+        !keepsLegacyPrefix(rendered) &&
+        tokenizeSQL(sql).every((token) => token.terminated && !isStrayHash(token)));
+}
+// `fn::String` is not a leftover prefix: it casts a column named fn.
+function keepsLegacyPrefix(sql) {
+    return sql.startsWith(LEGACY_EXPRESSION_PREFIX) && sql[LEGACY_EXPRESSION_PREFIX.length] !== ':';
+}
+function isStrayHash(token) {
+    return token.kind === 'punctuation' && token.text === '#';
+}
+// The lexer leaves only strings, quoted identifiers and block comments open.
+function describeOpenToken(token) {
+    if (token.kind === 'block_comment')
+        return 'block comment';
+    if (token.kind === 'quoted_identifier')
+        return 'quoted identifier';
+    return 'string literal';
+}
+function describePlainStringExpression(subject, kind, value) {
+    const literal = renderDefault(value);
+    const fix = suggestedExpression(value);
+    const asSQL = fix === undefined
+        ? 'default: { expression: "<sql>" } for a SQL expression'
+        : `default: { expression: ${JSON.stringify(fix.expression)} } to render ${kind} ${fix.rendered} (legacy spelling: ${JSON.stringify(`${LEGACY_EXPRESSION_PREFIX}${fix.expression}`)})`;
+    return `${subject} is ${kind} with plain string default ${JSON.stringify(value)}, which renders as the quoted literal ${literal} instead of SQL. Use ${asSQL}, or default: { expression: ${JSON.stringify(literal)} } for a constant string.`;
+}
+// `effectiveType` is the type as rendered, with `nullable: true` applied. The
+// quoted-text option is for a type chkit misreads, such as a string type it
+// does not know: on the types it recognizes, that literal is what fails.
+function describeQuotedFunctionDefault(subject, kind, effectiveType, value) {
+    const literal = renderDefault(value);
+    const fix = suggestedExpression(value);
+    const readsNull = kind === 'EPHEMERAL'
+        ? readsUnparsableEphemeralLiteralAsNull(effectiveType)
+        : storesUnparsableLiteralAsNull(effectiveType);
+    const outcome = readsNull
+        ? `which ClickHouse accepts for type ${effectiveType} but ${kind === 'EPHEMERAL' ? 'reads' : 'stores'} as NULL`
+        : `which ClickHouse rejects for type ${effectiveType}`;
+    const asSQL = fix === undefined
+        ? 'Use default: { expression: "<sql>" } for a SQL expression.'
+        : `Use default: { expression: ${JSON.stringify(fix.expression)} } to render ${kind} ${fix.rendered}.`;
+    return `${subject} has default ${JSON.stringify(value)}, a plain string that looks like a SQL function call. Plain strings render as quoted literals (${kind} ${literal}), ${outcome}. ${asSQL} If chkit misjudged the type and the column should ${kind === 'EPHEMERAL' ? 'hold' : 'store'} this text, use default: { expression: ${JSON.stringify(literal)} }.`;
+}
+/**
+ * The plain string as the `{ expression }` a message suggests, with the SQL it
+ * renders on one line, or undefined when validation would reject that
+ * expression too (no SQL, a leftover `fn:` prefix, an unterminated token or a
+ * stray `#`).
+ */
+function suggestedExpression(value) {
+    const expression = trimExpression(value);
+    if (!passesExpressionChecks(expression))
+        return undefined;
+    const rendered = tokenizeSQL(renderDefault({ expression }))
+        .map((token) => (token.kind === 'whitespace' ? ' ' : token.text))
+        .join('');
+    return { expression, rendered };
+}
 function validateTableDefinition(def, issues) {
+    const kafka = isKafkaEngine(def.engine);
+    if (kafka) {
+        for (const field of ['primaryKey', 'orderBy', 'uniqueKey', 'partitionBy', 'ttl', 'indexes', 'projections']) {
+            const value = def[field];
+            if (Array.isArray(value) ? value.length > 0 : Boolean(value)) {
+                pushValidationIssue(issues, def, 'kafka_unsupported_clause', `Kafka table ${def.database}.${def.name} does not support ${field}. Put storage clauses on the destination table.`);
+            }
+        }
+        for (const column of def.columns) {
+            if (column.default !== undefined || (column.defaultKind ?? 'DEFAULT') !== 'DEFAULT') {
+                pushValidationIssue(issues, def, 'kafka_column_default', `Kafka table ${def.database}.${def.name} column "${column.name}" cannot have a DEFAULT, MATERIALIZED, ALIAS, or EPHEMERAL definition. Compute values in the materialized view.`);
+            }
+        }
+        if (/^Kafka\s*(?:\(\s*\))?$/i.test(def.engine.trim())) {
+            for (const key of ['kafka_broker_list', 'kafka_topic_list', 'kafka_group_name', 'kafka_format']) {
+                if (typeof def.settings?.[key] !== 'string' || !String(def.settings[key]).trim()) {
+                    pushValidationIssue(issues, def, 'kafka_missing_setting', `Kafka table ${def.database}.${def.name} requires a nonempty ${key} string (or engine arguments / a named collection).`);
+                }
+            }
+        }
+        for (const [key, value] of Object.entries(def.settings ?? {})) {
+            if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(key) || (typeof value === 'number' && !Number.isFinite(value))) {
+                pushValidationIssue(issues, def, 'kafka_invalid_setting', `Kafka table ${def.database}.${def.name} has an invalid setting key or value: ${key}.`);
+            }
+            if (key === 'kafka_auto_offset_reset') {
+                pushValidationIssue(issues, def, 'kafka_invalid_setting', 'kafka_auto_offset_reset is not a Kafka table setting on standard ClickHouse. Configure auto_offset_reset in the server Kafka configuration.');
+            }
+            if (/password|secret|token/i.test(key) && value === '[HIDDEN]') {
+                pushValidationIssue(issues, def, 'kafka_invalid_setting', `Kafka setting ${key} was redacted by ClickHouse. Restore the credential or use server-side configuration before generating migrations.`);
+            }
+        }
+    }
     const columnSeen = new Set();
     const columnSet = new Set();
     for (const column of def.columns) {
@@ -48,7 +223,17 @@ function validateTableDefinition(def, issues) {
         }
         columnSeen.add(column.name);
         columnSet.add(column.name);
+        if (column.defaultKind !== undefined && !COLUMN_DEFAULT_KINDS.has(column.defaultKind)) {
+            pushValidationIssue(issues, def, 'column_default_kind_invalid', `Invalid defaultKind on column "${column.name}"`);
+        }
+        // Kafka already rejects every default and column kind (kafka_column_default),
+        // which also covers the codec of an ALIAS or EPHEMERAL column; one error per
+        // mistake.
+        if (!kafka)
+            validateUnstoredColumnCodec(def, column, issues);
         validateColumnCodec(def, column, issues);
+        if (!kafka)
+            validateColumnDefault(def, column, issues);
     }
     const indexSeen = new Set();
     for (const index of def.indexes ?? []) {
@@ -57,6 +242,14 @@ function validateTableDefinition(def, issues) {
             continue;
         }
         indexSeen.add(index.name);
+        if (index.type === 'text') {
+            try {
+                renderTextIndexType(index);
+            }
+            catch (error) {
+                pushValidationIssue(issues, def, 'text_index_invalid_parameters', `Text index "${index.name}": ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
     }
     const projectionSeen = new Set();
     for (const projection of def.projections ?? []) {
@@ -75,16 +268,86 @@ function validateTableDefinition(def, issues) {
             pushValidationIssue(issues, def, 'projection_empty_index', `Table ${def.database}.${def.name} projection "${projection.name}" has an empty index expression`);
         }
     }
-    for (const column of normalizeKeyColumns(def.primaryKey)) {
+    for (const column of normalizeKeyColumns(def.primaryKey, columnSet)) {
         if (isPlainColumnReference(column) && !columnSet.has(column)) {
             pushValidationIssue(issues, def, 'primary_key_missing_column', `Table ${def.database}.${def.name} primaryKey references missing column "${column}"`);
         }
     }
-    for (const column of normalizeKeyColumns(def.orderBy)) {
+    for (const column of normalizeKeyColumns(def.orderBy, columnSet)) {
         if (isPlainColumnReference(column) && !columnSet.has(column)) {
             pushValidationIssue(issues, def, 'order_by_missing_column', `Table ${def.database}.${def.name} orderBy references missing column "${column}"`);
         }
     }
+    validateUnstoredColumnReferences(def, columnSet, issues);
+}
+function validateUnstoredColumnCodec(def, column, issues) {
+    const kind = column.defaultKind;
+    // A bare `EPHEMERAL CODEC(...)` parses the codec as the default expression.
+    // After an EPHEMERAL default or comment ClickHouse accepts the codec.
+    const bareEphemeral = kind === 'EPHEMERAL' && column.default === undefined && !column.comment;
+    if (column.codec && (kind === 'ALIAS' || bareEphemeral)) {
+        pushValidationIssue(issues, def, 'column_kind_codec_unsupported', `Column "${column.name}" is ${kind} and cannot have a codec; ClickHouse stores no data for it.`);
+    }
+}
+/**
+ * Flags ALIAS and EPHEMERAL columns named directly where ClickHouse needs a
+ * stored column. References inside larger expressions (`toStartOfDay(day)`,
+ * TTL) are left for ClickHouse to report at migrate time.
+ */
+function validateUnstoredColumnReferences(def, columnSet, issues) {
+    const unstored = new Map(def.columns.flatMap((column) => column.defaultKind === 'ALIAS' || column.defaultKind === 'EPHEMERAL' ? [[column.name, column.defaultKind]] : []));
+    if (unstored.size === 0)
+        return;
+    const check = (field, parts, kinds = ['ALIAS', 'EPHEMERAL']) => {
+        for (const part of parts) {
+            const name = unquoteColumnName(part);
+            const kind = unstored.get(name);
+            if (kind && kinds.includes(kind)) {
+                pushValidationIssue(issues, def, 'column_kind_not_stored', `Table ${def.database}.${def.name} ${field} references ${kind} column "${name}", which ClickHouse does not store; use a MATERIALIZED column instead.`);
+            }
+        }
+    };
+    check('orderBy', normalizeKeyColumns(def.orderBy, columnSet));
+    check('primaryKey', normalizeKeyColumns(def.primaryKey, columnSet));
+    // Fragments are read without their comments, as canonicalization stores them
+    // (#232), so raw definitions (toCreateSQL) and canonical ones (planDiff)
+    // check the same fragment text.
+    check('partitionBy', splitTopLevelComma(stripWrappingParens(normalizeSQLFragment(def.partitionBy ?? ''))));
+    check('engine', engineArguments(def.engine));
+    // ClickHouse indexes an ALIAS column by its expression, but not an EPHEMERAL one.
+    for (const index of def.indexes ?? []) {
+        check(`index "${index.name}"`, [normalizeSQLFragment(index.expression)], ['EPHEMERAL']);
+    }
+    for (const projection of def.projections ?? []) {
+        let tokens;
+        try {
+            tokens = textSQLTokens(normalizeSQLFragment(isIndexProjection(projection) ? projection.index : projection.query));
+        }
+        catch {
+            continue;
+        }
+        // A token followed by `(` is a function that merely shares the column's name,
+        // and one after AS names an output alias.
+        const names = tokens.map(unquoteColumnName);
+        const read = new Set(names.filter((name, i) => unstored.get(name) === 'EPHEMERAL' && tokens[i + 1] !== '(' && tokens[i - 1]?.toUpperCase() !== 'AS'));
+        for (const name of read) {
+            pushValidationIssue(issues, def, 'column_ephemeral_in_projection', `Table ${def.database}.${def.name} projection "${projection.name}" reads EPHEMERAL column "${name}", which ClickHouse does not store, so the table is rejected or every INSERT fails. Use a MATERIALIZED column instead.`);
+        }
+    }
+}
+/** Bare engine arguments, with one tuple level flattened: `SummingMergeTree((a, b))`. */
+function engineArguments(engine) {
+    // Only MergeTree-family parameters name columns; e.g. Distributed takes a cluster name.
+    const args = /^\s*\w*MergeTree\s*\(([\s\S]*)\)\s*$/.exec(engine)?.[1] ?? '';
+    return splitTopLevelComma(args)
+        .flatMap((arg) => splitTopLevelComma(stripWrappingParens(arg)))
+        .filter((arg) => !arg.startsWith("'"));
+}
+/** A column name with its backtick or double-quote identifier quotes removed. */
+function unquoteColumnName(token) {
+    const trimmed = token.trim();
+    const quote = trimmed.charAt(0);
+    return trimmed.length > 1 && (quote === '`' || quote === '"') && trimmed.endsWith(quote) ? trimmed.slice(1, -1) : trimmed;
 }
 const INTERVAL_PATTERN = /^\s*\d+\s+(SECOND|MINUTE|HOUR|DAY|WEEK|MONTH|YEAR)(\s+\d+\s+(SECOND|MINUTE|HOUR|DAY|WEEK|MONTH|YEAR))*\s*$/i;
 const REPLICATED_ENGINE_PATTERN = /^(Shared|Replicated)/;
@@ -123,6 +386,86 @@ function validateMaterializedViewDefinition(def, issues, definitions) {
         }
     }
 }
+function validateDictionaryDefinition(def, issues) {
+    const attributeSeen = new Set();
+    const attributeSet = new Set();
+    for (const attribute of def.attributes) {
+        if (attributeSeen.has(attribute.name)) {
+            pushValidationIssue(issues, def, 'duplicate_column_name', `Dictionary ${def.database}.${def.name} has duplicate attribute name "${attribute.name}"`);
+            continue;
+        }
+        attributeSeen.add(attribute.name);
+        attributeSet.add(attribute.name);
+        if (attribute.default !== undefined && attribute.expression !== undefined) {
+            pushValidationIssue(issues, def, 'dictionary_attribute_default_expression_exclusive', `Dictionary ${def.database}.${def.name} attribute "${attribute.name}" sets both "default" and "expression"; choose one`);
+        }
+        if (attribute.bidirectional && !attribute.hierarchical) {
+            pushValidationIssue(issues, def, 'dictionary_bidirectional_requires_hierarchical', `Dictionary ${def.database}.${def.name} attribute "${attribute.name}" sets "bidirectional" without "hierarchical"; bidirectional only applies to hierarchical attributes`);
+        }
+    }
+    if (def.primaryKey.length === 0) {
+        pushValidationIssue(issues, def, 'dictionary_missing_primary_key', `Dictionary ${def.database}.${def.name} requires a non-empty primaryKey`);
+    }
+    else {
+        for (const column of def.primaryKey) {
+            if (!attributeSet.has(column)) {
+                pushValidationIssue(issues, def, 'dictionary_primary_key_missing_attribute', `Dictionary ${def.database}.${def.name} primaryKey references missing attribute "${column}"`);
+            }
+        }
+    }
+    if (def.source.trim().length === 0) {
+        pushValidationIssue(issues, def, 'dictionary_missing_source', `Dictionary ${def.database}.${def.name} requires a non-empty "source"`);
+    }
+    if (def.layout.trim().length === 0) {
+        pushValidationIssue(issues, def, 'dictionary_missing_layout', `Dictionary ${def.database}.${def.name} requires a non-empty "layout"`);
+    }
+    if (def.lifetime.trim().length === 0) {
+        pushValidationIssue(issues, def, 'dictionary_missing_lifetime', `Dictionary ${def.database}.${def.name} requires a non-empty "lifetime"`);
+    }
+    if (def.range) {
+        for (const column of [def.range.min, def.range.max]) {
+            if (!attributeSet.has(column)) {
+                pushValidationIssue(issues, def, 'dictionary_range_missing_attribute', `Dictionary ${def.database}.${def.name} range references missing attribute "${column}"`);
+            }
+        }
+    }
+}
+function collectIdentifiers(def) {
+    const identifiers = [
+        { label: 'database name', name: def.database },
+        { label: 'name', name: def.name },
+    ];
+    if (def.kind === 'table') {
+        for (const column of def.columns)
+            identifiers.push({ label: 'column name', name: column.name });
+        for (const index of def.indexes ?? [])
+            identifiers.push({ label: 'index name', name: index.name });
+        for (const projection of def.projections ?? []) {
+            identifiers.push({ label: 'projection name', name: projection.name });
+        }
+    }
+    else if (def.kind === 'dictionary') {
+        for (const attribute of def.attributes) {
+            identifiers.push({ label: 'attribute name', name: attribute.name });
+        }
+    }
+    else if (def.kind === 'materialized_view') {
+        identifiers.push({ label: 'target database name', name: def.to.database });
+        identifiers.push({ label: 'target name', name: def.to.name });
+    }
+    return identifiers;
+}
+// Names are quoted and escaped when rendered, so any character is safe except
+// those ClickHouse cannot store in a name. Catching them here gives a clear
+// error instead of a server-side failure (e.g. names from a CDC source catalog).
+function validateIdentifiers(def, issues) {
+    for (const { label, name } of collectIdentifiers(def)) {
+        const problem = describeInvalidIdentifier(name);
+        if (problem) {
+            pushValidationIssue(issues, def, 'invalid_identifier', `${def.kind} ${JSON.stringify(def.database)}.${JSON.stringify(def.name)} ${label} ${JSON.stringify(name)} ${problem}`);
+        }
+    }
+}
 export function validateDefinitions(definitions) {
     const issues = [];
     const objectKeys = new Set();
@@ -133,12 +476,16 @@ export function validateDefinitions(definitions) {
             continue;
         }
         objectKeys.add(key);
+        validateIdentifiers(def, issues);
         if (def.kind === 'table') {
             validateTableDefinition(def, issues);
         }
         else if (def.kind === 'materialized_view') {
             validateMaterializedViewDefinition(def, issues, definitions);
         }
+        else if (def.kind === 'dictionary') {
+            validateDictionaryDefinition(def, issues);
+        }
     }
     return issues;
 }