@adaptabletools/adaptable 23.1.0-canary.2 → 24.0.0-canary.0

package/vendor/aql/validation/functionMetadata.js

@@ -0,0 +1,500 @@
+export const CLAUSE_OPERAND_KINDS = {
+    GROUP_BY: 'ref',
+    OVER: 'ref',
+    WEIGHT: 'numeric-ref',
+    CUMULATIVE: 'ref',
+    WHERE: 'predicate',
+    ANY_COL: 'column-list',
+    WITHIN: 'duration',
+    LAST_N: 'positive-int',
+    ALL_ROWS: 'none',
+    TRIGGER: 'trigger-list',
+};
+/** Accepted `TRIGGER(...)` operands (change origins recorded by the host). */
+export const TRIGGER_LITERALS = new Set(['edit', 'tick', 'undo', 'calculated']);
+/** The sort-direction literals accepted by OVER, CUMULATIVE and QUANT. */
+export const SORT_DIRECTION_LITERALS = ['ASC', 'DESC'];
+/**
+ * Reads a sort-direction literal (`'ASC'` / `'DESC'`, case-insensitive);
+ * `undefined` when the value is not one.
+ */
+export const toSortDirection = (value) => {
+    if (typeof value !== 'string') {
+        return undefined;
+    }
+    const upper = value.trim().toUpperCase();
+    return upper === 'ASC' ? 'asc' : upper === 'DESC' ? 'desc' : undefined;
+};
+const observableColumnInput = { ui: { label: 'Column', modes: ['column'] } };
+const OBSERVABLE_CLAUSES_FULL = [
+    { clause: 'WITHIN' },
+    { clause: 'LAST_N' },
+    { clause: 'ALL_ROWS' },
+    { clause: 'TRIGGER' },
+    { clause: 'WHERE' },
+];
+const OBSERVABLE_CLAUSES_ROW_EVENT = [
+    { clause: 'WITHIN' },
+    { clause: 'LAST_N' },
+    { clause: 'WHERE' },
+];
+const numericWatch = (resultType, inputTypes) => ({
+    parameters: { subject: 'column-or-field', list: [observableColumnInput] },
+    clauses: OBSERVABLE_CLAUSES_FULL,
+    requiresInput: true,
+    resultType,
+    input: 'required',
+    inputTypes,
+    windows: ['WITHIN', 'LAST_N', 'cumulative'],
+    scopes: ['row', 'grid'],
+});
+/** Activity readers: watch one column or the `ANY_COL(…)` union of columns. */
+const activityWatch = (resultType, windows) => ({
+    parameters: { subject: 'column-or-field', list: [{ ...observableColumnInput, optional: true }] },
+    clauses: [
+        { clause: 'ANY_COL' },
+        ...(windows.includes('WITHIN') ? [{ clause: 'WITHIN' }] : []),
+        ...(windows.includes('LAST_N') ? [{ clause: 'LAST_N' }] : []),
+        { clause: 'ALL_ROWS' },
+        { clause: 'TRIGGER' },
+        { clause: 'WHERE' },
+    ],
+    requiresInput: false,
+    resultType,
+    input: 'column-or-any',
+    windows,
+    scopes: ['row', 'grid'],
+});
+/** Sources that accept the `ANY_COL(…)` union subject. */
+export const ANY_COL_SOURCE_NAMES = [
+    'CHANGE_COUNT',
+    'NO_CHANGES',
+    'SINCE_CHANGE',
+    'CHANGED_AT',
+];
+/**
+ * Observable brace-callables. Every entry is a *value* (legal inside scalar
+ * math and comparisons). The catalogue naming applies: `CHANGE_COUNT`,
+ * `NO_CHANGES`, `SINCE_CHANGE`, `CHANGED_AT`, `NET_CHANGE`, `PERCENT_CHANGE{}`,
+ * `HIGHEST`, `LOWEST`, `PREVIOUS`, `ROW_AGE`, `ADDED_AT`, `ROWS_ADDED`,
+ * `ROWS_REMOVED`.
+ */
+export const OBSERVABLE_CALL_SPECS = {
+    CHANGE_COUNT: activityWatch('number', ['WITHIN', 'LAST_N', 'cumulative']),
+    NO_CHANGES: activityWatch('boolean', ['WITHIN', 'cumulative']),
+    SINCE_CHANGE: activityWatch('duration', ['cumulative']),
+    CHANGED_AT: activityWatch('date', ['cumulative']),
+    NET_CHANGE: numericWatch('number', ['number']),
+    PERCENT_CHANGE: numericWatch('number', ['number']),
+    HIGHEST: numericWatch('input', ['number', 'date']),
+    LOWEST: numericWatch('input', ['number', 'date']),
+    PREVIOUS: {
+        parameters: {
+            subject: 'column-or-field',
+            list: [observableColumnInput, { types: ['number'], optional: true, ui: { label: 'n' } }],
+        },
+        clauses: [{ clause: 'ALL_ROWS' }, { clause: 'TRIGGER' }, { clause: 'WHERE' }],
+        requiresInput: true,
+        resultType: 'input',
+        input: 'required',
+        windows: ['cumulative'],
+        scopes: ['row', 'grid'],
+        positional: [{ name: 'n', kind: 'positive-int', optional: true }],
+    },
+    ROW_AGE: {
+        parameters: { subject: 'none', list: [] },
+        clauses: [],
+        requiresInput: false,
+        resultType: 'duration',
+        input: 'forbidden',
+        windows: ['cumulative'],
+        scopes: ['row'],
+    },
+    ADDED_AT: {
+        parameters: { subject: 'none', list: [] },
+        clauses: [],
+        requiresInput: false,
+        resultType: 'date',
+        input: 'forbidden',
+        windows: ['cumulative'],
+        scopes: ['row'],
+    },
+    ROWS_ADDED: {
+        parameters: { subject: 'none', list: [] },
+        clauses: OBSERVABLE_CLAUSES_ROW_EVENT,
+        requiresInput: false,
+        resultType: 'number',
+        input: 'forbidden',
+        windows: ['WITHIN', 'LAST_N', 'cumulative'],
+        scopes: ['grid'],
+    },
+    ROWS_REMOVED: {
+        parameters: { subject: 'none', list: [] },
+        clauses: OBSERVABLE_CLAUSES_ROW_EVENT,
+        requiresInput: false,
+        resultType: 'number',
+        input: 'forbidden',
+        windows: ['WITHIN', 'LAST_N', 'cumulative'],
+        scopes: ['grid'],
+    },
+};
+/** Host-registered observable names without a system spec: accept the full clause set. */
+export const CUSTOM_OBSERVABLE_FALLBACK_SPEC = {
+    parameters: { subject: 'column-or-field', list: [{ ...observableColumnInput, optional: true }] },
+    clauses: OBSERVABLE_CLAUSES_FULL,
+    requiresInput: false,
+    resultType: 'number',
+    input: 'optional',
+    windows: ['WITHIN', 'LAST_N', 'cumulative'],
+    scopes: ['row', 'grid'],
+};
+export const isObservableSourceName = (name) => Object.prototype.hasOwnProperty.call(OBSERVABLE_CALL_SPECS, name);
+export const getObservableCallSpec = (name) => isObservableSourceName(name) ? OBSERVABLE_CALL_SPECS[name] : undefined;
+/**
+ * Documentation of the observable callables. Like {@link CLAUSE_DOCS}: pure
+ * data (description / signatures / examples / category) that hosts present
+ * in menus, hover docs and completion, adding labels and icons on their side.
+ *
+ * Signatures list the common shapes (bare, time window, count window, and —
+ * where the call accepts them — ANY_COL / ALL_ROWS / TRIGGER / WHERE). Examples include both
+ * bare values (Calculated Columns) and comparisons (Alerts / Format Columns).
+ */
+export const OBSERVABLE_DOCS = {
+    CHANGE_COUNT: {
+        description: 'How many times the cell changed — in the sliding timeframe (WITHIN / LAST_N) or since the grid loaded. Returns a number. Per row by default; ALL_ROWS() counts changes of the column across all rows. ANY_COL() counts changes of any column (ANY_COL([a], [b]) of the listed columns) instead of one. Optional TRIGGER limits which change origins count; WHERE filters which rows contribute under ALL_ROWS().',
+        signatures: [
+            'CHANGE_COUNT{[col]}',
+            'CHANGE_COUNT{[col], WITHIN(<duration>)}',
+            'CHANGE_COUNT{[col], LAST_N(<n>)}',
+            'CHANGE_COUNT{[col], WITHIN(<duration>), ALL_ROWS()}',
+            'CHANGE_COUNT{ANY_COL(), WITHIN(<duration>)}',
+            'CHANGE_COUNT{ANY_COL([col], [col]), WITHIN(<duration>), ALL_ROWS()}',
+            "CHANGE_COUNT{[col], TRIGGER('edit' | 'tick' | 'undo' | 'calculated')}",
+            'CHANGE_COUNT{[col] WHERE <boolean_query>, WITHIN(<duration>), ALL_ROWS()}',
+        ],
+        examples: [
+            'CHANGE_COUNT{[numCol], WITHIN(5m)}',
+            'CHANGE_COUNT{[numCol], WITHIN(5m)} >= 3',
+            "CHANGE_COUNT{[numCol], TRIGGER('edit')}",
+            "CHANGE_COUNT{[numCol] WHERE [stringCol] = 'FX', WITHIN(1m), ALL_ROWS()}",
+            'CHANGE_COUNT{ANY_COL(), WITHIN(1m)}',
+        ],
+        category: 'history',
+    },
+    NO_CHANGES: {
+        description: 'True when nothing in the watched column (or, with ANY_COL(), in any column) changed during the whole window. The window must have fully elapsed since the grid loaded (or the row was added), so it is false at startup and becomes true only after a full window of silence. Without WITHIN: true while the cell has never changed. Per row by default; ALL_ROWS() watches the whole grid. Accepts ANY_COL, WITHIN, ALL_ROWS, TRIGGER and WHERE.',
+        signatures: [
+            'NO_CHANGES{[col], WITHIN(<duration>)}',
+            'NO_CHANGES{[col], WITHIN(<duration>), ALL_ROWS()}',
+            'NO_CHANGES{ANY_COL(), WITHIN(<duration>)}',
+            'NO_CHANGES{ANY_COL(), WITHIN(<duration>), ALL_ROWS()}',
+            'NO_CHANGES{ANY_COL([col], [col]), WITHIN(<duration>), ALL_ROWS()}',
+            'NO_CHANGES{[col]}',
+        ],
+        examples: [
+            'NO_CHANGES{[numCol], WITHIN(30s)}',
+            'NO_CHANGES{ANY_COL(), WITHIN(1m)}',
+            'NO_CHANGES{ANY_COL(), WITHIN(5h), ALL_ROWS()}',
+            'NO_CHANGES{ANY_COL([numCol], [stringCol]), WITHIN(10s), ALL_ROWS()}',
+            "NO_CHANGES{[numCol], WITHIN(1m), TRIGGER('tick')}",
+        ],
+        category: 'history',
+    },
+    SINCE_CHANGE: {
+        description: 'How long ago the cell (or, with ANY_COL(), any column) last changed, as a duration; keeps growing on the clock. Null until the first change since the grid loaded. Per row by default; ALL_ROWS() reads the last change anywhere in the grid. For "no changes for x" rules prefer NO_CHANGES{…}.',
+        signatures: [
+            'SINCE_CHANGE{[col]}',
+            'SINCE_CHANGE{[col], ALL_ROWS()}',
+            'SINCE_CHANGE{ANY_COL()}',
+            'SINCE_CHANGE{ANY_COL(), ALL_ROWS()}',
+            "SINCE_CHANGE{[col], TRIGGER('tick')}",
+        ],
+        examples: [
+            'SINCE_CHANGE{[numCol]}',
+            'SINCE_CHANGE{[numCol]} > 30s',
+            'SINCE_CHANGE{ANY_COL()}',
+            'SINCE_CHANGE{ANY_COL(), ALL_ROWS()}',
+        ],
+        category: 'history',
+    },
+    CHANGED_AT: {
+        description: 'The instant the cell (or, with ANY_COL(), any column) last changed, as a date. Null until the first change since the grid loaded. Per row by default; ALL_ROWS() reads the last change anywhere in the grid.',
+        signatures: [
+            'CHANGED_AT{[col]}',
+            'CHANGED_AT{[col], ALL_ROWS()}',
+            'CHANGED_AT{ANY_COL()}',
+            "CHANGED_AT{[col], TRIGGER('edit')}",
+        ],
+        examples: ['CHANGED_AT{[numCol]}', 'CHANGED_AT{ANY_COL()}', 'IS_TODAY(CHANGED_AT{[numCol]})'],
+        category: 'history',
+    },
+    NET_CHANGE: {
+        description: 'Current value minus the value the cell had at the start of the window (or when the grid loaded). Returns a number: positive when the cell went up, negative when it went down; null while the cell has not changed. Accepts WITHIN, LAST_N, ALL_ROWS, TRIGGER and WHERE.',
+        signatures: [
+            'NET_CHANGE{[numCol]}',
+            'NET_CHANGE{[numCol], WITHIN(<duration>)}',
+            'NET_CHANGE{[numCol], LAST_N(<n>)}',
+            'NET_CHANGE{[numCol], WITHIN(<duration>), ALL_ROWS()}',
+            "NET_CHANGE{[numCol], TRIGGER('tick')}",
+        ],
+        examples: [
+            'NET_CHANGE{[numCol], WITHIN(1h)}',
+            'NET_CHANGE{[numCol], WITHIN(1h)} > 10',
+            'ABS(NET_CHANGE{[numCol], LAST_N(5)})',
+            'NET_CHANGE{[numCol], WITHIN(15m), ALL_ROWS()}',
+        ],
+        category: 'history',
+    },
+    PERCENT_CHANGE: {
+        description: 'Percentage move of the cell over the window: (current − start) / start × 100. A live history reader which accepts WITHIN, LAST_N, ALL_ROWS, TRIGGER and WHERE.',
+        signatures: [
+            'PERCENT_CHANGE{[numCol]}',
+            'PERCENT_CHANGE{[numCol], WITHIN(<duration>)}',
+            'PERCENT_CHANGE{[numCol], LAST_N(<n>)}',
+            'PERCENT_CHANGE{[numCol], WITHIN(<duration>), ALL_ROWS()}',
+        ],
+        examples: [
+            'PERCENT_CHANGE{[numCol], WITHIN(1h)}',
+            'PERCENT_CHANGE{[numCol], WITHIN(1h)} > 5',
+            'ABS(PERCENT_CHANGE{[numCol], LAST_N(10)}) >= 2',
+            'PERCENT_CHANGE{[numCol], WITHIN(15m), ALL_ROWS()}',
+        ],
+        category: 'history',
+    },
+    HIGHEST: {
+        description: 'Highest value the cell has taken in the timeframe (or since the grid loaded). Returns the same type as the watched column (number or date). Null until the cell changes. Accepts WITHIN, LAST_N, ALL_ROWS, TRIGGER and WHERE.',
+        signatures: [
+            'HIGHEST{[col]}',
+            'HIGHEST{[col], WITHIN(<duration>)}',
+            'HIGHEST{[col], LAST_N(<n>)}',
+            'HIGHEST{[col], WITHIN(<duration>), ALL_ROWS()}',
+        ],
+        examples: [
+            'HIGHEST{[numCol], WITHIN(1h)}',
+            '[numCol] = HIGHEST{[numCol], WITHIN(8h)}',
+            'HIGHEST{[numCol], LAST_N(20)} - [numCol]',
+            '[dateCol] = HIGHEST{[dateCol], WITHIN(8h)}',
+        ],
+        category: 'history',
+    },
+    LOWEST: {
+        description: 'Lowest value the cell has taken in the timeframe (or since the grid loaded). Returns the same type as the watched column (number or date). Null until the cell changes. Accepts WITHIN, LAST_N, ALL_ROWS, TRIGGER and WHERE.',
+        signatures: [
+            'LOWEST{[col]}',
+            'LOWEST{[col], WITHIN(<duration>)}',
+            'LOWEST{[col], LAST_N(<n>)}',
+            'LOWEST{[col], WITHIN(<duration>), ALL_ROWS()}',
+        ],
+        examples: [
+            'LOWEST{[numCol], WITHIN(1h)}',
+            '[numCol] = LOWEST{[numCol], WITHIN(8h)}',
+            '[numCol] - LOWEST{[numCol], LAST_N(50)}',
+            '[dateCol] = LOWEST{[dateCol], WITHIN(8h)}',
+        ],
+        category: 'history',
+    },
+    PREVIOUS: {
+        description: 'The value the cell had before its last change (or before its last n changes). Returns the same type as the watched column. Null while the cell has not changed that many times. Optional ALL_ROWS / TRIGGER / WHERE; no WITHIN or LAST_N (lookback is the positional n).',
+        signatures: [
+            'PREVIOUS{[col]}',
+            'PREVIOUS{[col], <n>}',
+            'PREVIOUS{[col], ALL_ROWS()}',
+            "PREVIOUS{[col], TRIGGER('edit')}",
+        ],
+        examples: [
+            'PREVIOUS{[numCol]}',
+            '[numCol] - PREVIOUS{[numCol]}',
+            '[numCol] > PREVIOUS{[numCol], 3}',
+            "PREVIOUS{[numCol], TRIGGER('tick')}",
+        ],
+        category: 'history',
+    },
+    ROW_AGE: {
+        description: 'How long ago the row was added to the grid, as a duration; keeps growing on the clock. Null for rows that were already present when the grid loaded. No column input and no timeframe clauses.',
+        signatures: ['ROW_AGE{}'],
+        examples: ['ROW_AGE{}', 'ROW_AGE{} < 30s', 'ROW_AGE{} > 1h'],
+        category: 'history',
+    },
+    ADDED_AT: {
+        description: 'The instant the row was added to the grid, as a date. Null for rows that were already present when the grid loaded. No column input and no timeframe clauses.',
+        signatures: ['ADDED_AT{}'],
+        examples: ['ADDED_AT{}', 'ADDED_AT{} > DATE("2026-01-01")', 'IS_TODAY(ADDED_AT{})'],
+        category: 'history',
+    },
+    ROWS_ADDED: {
+        description: 'How many rows were added to the grid in the timeframe (or since load). Always grid-scoped. WHERE filters which added rows count; WITHIN / LAST_N set the window.',
+        signatures: [
+            'ROWS_ADDED{}',
+            'ROWS_ADDED{WITHIN(<duration>)}',
+            'ROWS_ADDED{LAST_N(<n>)}',
+            'ROWS_ADDED{WHERE <boolean_query>, WITHIN(<duration>)}',
+            'ROWS_ADDED{WHERE <boolean_query>, LAST_N(<n>)}',
+        ],
+        examples: [
+            'ROWS_ADDED{WITHIN(1m)}',
+            'ROWS_ADDED{WITHIN(1m)} > 10',
+            'ROWS_ADDED{LAST_N(50)}',
+            "ROWS_ADDED{WHERE [stringCol] = 'FX', WITHIN(10s)} >= 1",
+        ],
+        category: 'history',
+    },
+    ROWS_REMOVED: {
+        description: 'How many rows were removed from the grid in the timeframe (or since load). Always grid-scoped. WHERE filters which removed rows count; WITHIN / LAST_N set the window.',
+        signatures: [
+            'ROWS_REMOVED{}',
+            'ROWS_REMOVED{WITHIN(<duration>)}',
+            'ROWS_REMOVED{LAST_N(<n>)}',
+            'ROWS_REMOVED{WHERE <boolean_query>, WITHIN(<duration>)}',
+            'ROWS_REMOVED{WHERE <boolean_query>, LAST_N(<n>)}',
+        ],
+        examples: [
+            'ROWS_REMOVED{WITHIN(1m)}',
+            'ROWS_REMOVED{WITHIN(1m)} > 0',
+            'ROWS_REMOVED{LAST_N(20)}',
+            "ROWS_REMOVED{WHERE [stringCol] = 'Ford', WITHIN(10s)}",
+        ],
+        category: 'history',
+    },
+};
+export const CLAUSE_DOCS = {
+    GROUP_BY: {
+        description: 'Partitions an aggregation (or window function) by one or more columns so each distinct key is computed separately. Pass as a clause on the aggregation (e.g. SUM, AVG, COUNT) or window function (e.g. FIRST, LAG, RANK) — including as a sibling of CUMULATIVE.',
+        signatures: ['GROUP_BY([stringCol])', 'GROUP_BY([stringCol], [dateCol])'],
+        examples: [
+            'SUM{[numCol], GROUP_BY([stringCol])}',
+            'AVG{[numCol], GROUP_BY([stringCol])}',
+            'COUNT{[numCol], GROUP_BY([stringCol], [dateCol])}',
+            'FIRST{[numCol], OVER([dateCol]), GROUP_BY([stringCol])}',
+            'SUM{[numCol], GROUP_BY([stringCol]), CUMULATIVE([dateCol])}',
+        ],
+        category: 'grouping',
+    },
+    OVER: {
+        description: "Orders the rows a window function reads (number or date column). Required by FIRST, LAST, LAG, LEAD and RANK. An optional second item sets the direction: 'ASC' (default, smallest first) or 'DESC' (largest first). Blank values always sort last. Cumulative aggregations use CUMULATIVE instead.",
+        signatures: ['OVER([dateCol])', 'OVER([numCol])', "OVER([numCol], 'ASC' | 'DESC')"],
+        examples: [
+            'OVER([dateCol])',
+            'OVER([numCol])',
+            'LAG{[numCol], 1, OVER([dateCol])}',
+            "RANK{OVER([numCol], 'DESC')}",
+        ],
+        category: 'window',
+    },
+    WEIGHT: {
+        description: 'Supplies a numeric weight column for a weighted aggregation (e.g. AVG{[numCol], WEIGHT([weightCol])}). Accepted by AVG and by custom aggregations that declare weight support.',
+        signatures: ['WEIGHT([numCol])'],
+        examples: [
+            'AVG{[numCol], WEIGHT([weightCol])}',
+            'AVG{[numCol], WEIGHT([weightCol]), GROUP_BY([stringCol])}',
+        ],
+        category: 'operand',
+    },
+    CUMULATIVE: {
+        description: 'Turns the aggregation into a running (cumulative) value ordered by the given column: each row receives the aggregate of the rows up to and including itself. Accepted by SUM, AVG, MIN, MAX, COUNT and by custom aggregations that declare cumulative support. Combine with GROUP_BY as a sibling clause to restart per group. An optional second item sets the direction: \'ASC\' (default) or \'DESC\' to accumulate from the largest value down. Blank values always sort last.',
+        signatures: [
+            'SUM{[numCol], CUMULATIVE([dateCol])}',
+            'AVG|MIN|MAX|COUNT{[numCol], CUMULATIVE([dateCol])}',
+            "SUM{[numCol], CUMULATIVE([dateCol], 'ASC' | 'DESC')}",
+        ],
+        examples: [
+            'SUM{[numCol], CUMULATIVE([dateCol])}',
+            "SUM{[numCol], CUMULATIVE([dateCol], 'DESC')}",
+            'AVG{[numCol], CUMULATIVE([dateCol])}',
+            'MIN{[numCol], CUMULATIVE([dateCol])}',
+            'MAX{[numCol], CUMULATIVE([dateCol])}',
+            'COUNT{[numCol], CUMULATIVE([dateCol])}',
+            'SUM{[numCol], GROUP_BY([stringCol]), CUMULATIVE([dateCol])}',
+        ],
+        category: 'cumulative',
+    },
+    WHERE: {
+        description: 'Restricts which rows contribute. Inside an aggregation brace call it filters that call; after an expression it scopes every aggregation in it. Inside an observable brace call (often with ALL_ROWS()) it filters which rows\' histories contribute. The predicate is an ordinary boolean expression evaluated per row.',
+        signatures: [
+            '<aggregation>{[col] WHERE <boolean_query>}',
+            '<expression> WHERE <boolean_query>',
+            '<observable>{[col] WHERE <boolean_query>, WITHIN(<duration>), ALL_ROWS()}',
+        ],
+        examples: [
+            'SUM{[numCol]} > 100 WHERE [stringCol] = "open"',
+            'AVG{[numCol]} WHERE [boolCol] = TRUE',
+            'COUNT{[numCol]} > 5 WHERE QUERY("myNamedQuery")',
+            "CHANGE_COUNT{[numCol] WHERE [stringCol] = 'FX', WITHIN(1m), ALL_ROWS()}",
+        ],
+        category: 'logical',
+    },
+    WITHIN: {
+        description: 'Sliding timeframe of a live (observable) function: only changes in the last <duration> count, e.g. WITHIN(5m). Old changes age out, so the value can change on the clock while nothing happens in the grid. Duration literals: 250ms, 30s, 5m, 1h, 1d. The timeframe cannot exceed the host maximum (AdapTable: expressionOptions.maxTimeframeSize, default 8h).',
+        signatures: ['WITHIN(<duration>)'],
+        examples: [
+            'CHANGE_COUNT{[numCol], WITHIN(5m)}',
+            'NET_CHANGE{[numCol], WITHIN(1h)}',
+            'HIGHEST{[numCol], WITHIN(8h)}',
+            'ROWS_ADDED{WITHIN(10s)}',
+        ],
+        category: 'timeframe',
+    },
+    LAST_N: {
+        description: 'Sliding count timeframe of a live (observable) function: only the last n change events count, however old. Never expires on the clock (unlike WITHIN).',
+        signatures: ['LAST_N(<n>)'],
+        examples: [
+            'LOWEST{[numCol], LAST_N(50)}',
+            'CHANGE_COUNT{[numCol], LAST_N(20)}',
+            'PERCENT_CHANGE{[numCol], LAST_N(10)}',
+            'ROWS_REMOVED{LAST_N(20)}',
+        ],
+        category: 'timeframe',
+    },
+    ANY_COL: {
+        description: 'Watch every column instead of one: a change to any column counts (ANY_COL()), or to any of the listed columns (ANY_COL([bid], [ask])). Takes the place of the [col] input of CHANGE_COUNT, NO_CHANGES, SINCE_CHANGE and CHANGED_AT. Calculated Column recomputations never count.',
+        signatures: ['ANY_COL()', 'ANY_COL([col], [col], …)'],
+        examples: [
+            'NO_CHANGES{ANY_COL(), WITHIN(1m)}',
+            'NO_CHANGES{ANY_COL(), WITHIN(5h), ALL_ROWS()}',
+            'CHANGE_COUNT{ANY_COL([numCol], [stringCol]), WITHIN(1m)}',
+            'SINCE_CHANGE{ANY_COL()}',
+        ],
+        category: 'history',
+    },
+    ALL_ROWS: {
+        description: 'All-rows scope for a live (observable) function: one shared history across all rows (passing WHERE, if any) instead of one per row. The value is the same on every row.',
+        signatures: ['ALL_ROWS()'],
+        examples: [
+            'CHANGE_COUNT{[numCol], WITHIN(1m), ALL_ROWS()}',
+            "CHANGE_COUNT{[numCol] WHERE [stringCol] = 'FX', WITHIN(1m), ALL_ROWS()}",
+            'NET_CHANGE{[numCol], WITHIN(15m), ALL_ROWS()}',
+            'NO_CHANGES{ANY_COL(), WITHIN(5h), ALL_ROWS()}',
+        ],
+        category: 'history',
+    },
+    TRIGGER: {
+        description: "Which change triggers a live (observable) function counts: 'edit', 'tick', 'undo' or 'calculated'. Default: every recorded change. Pass one or more origins.",
+        signatures: [
+            "TRIGGER('edit')",
+            "TRIGGER('tick')",
+            "TRIGGER('undo')",
+            "TRIGGER('calculated')",
+            "TRIGGER('edit', 'tick')",
+        ],
+        examples: [
+            "CHANGE_COUNT{[numCol], TRIGGER('edit')}",
+            "CHANGE_COUNT{[numCol], WITHIN(1m), TRIGGER('tick')}",
+            "PREVIOUS{[numCol], TRIGGER('edit')}",
+            "NET_CHANGE{[numCol], WITHIN(5m), TRIGGER('tick', 'undo')}",
+        ],
+        category: 'timeframe',
+    },
+};
+const anyInput = {};
+/**
+ * Baseline shape for a host-known aggregation name with no operator in the
+ * catalogue (one input, `GROUP_BY` / `WHERE`): validation and editors accept
+ * it so the rest of the expression still checks. Names *with* an operator
+ * get their spec derived from the operator's capabilities instead.
+ */
+export const BASELINE_CUSTOM_AGGREGATION_SPEC = {
+    parameters: { subject: 'column-or-field', list: [anyInput] },
+    clauses: [{ clause: 'GROUP_BY' }, { clause: 'WHERE' }],
+    requiresInput: true,
+    resultType: 'unknown',
+};
+//# sourceMappingURL=functionMetadata.js.map

package/vendor/aql/validation/functionMetadata.js.map

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

package/vendor/aql/validation/index.d.ts

@@ -0,0 +1,5 @@
+export { validateExpressionTypes, inferStaticExpressionType, mapDataTypeToStaticType, type ExpressionTypeIssue, type ExpressionTypeIssueSeverity, type ExpressionTypeValidationResult, type StaticColumnType, type StaticExpressionType, type ValidateExpressionTypesOptions, } from './validateExpressionTypes';
+export { classifyExpression, getRootExpression, inferExpressionKind, type ExpressionKind, type ExpressionClassification, type ClassifyExpressionOptions, type ExpressionValidationRequest, } from './classifyExpression';
+export { validateAqlExpression, type AqlQuickFix, type AqlValidationCode, type AqlValidationIssue, type AqlValidationResult, type ValidateAqlExpressionOptions, } from './validateAqlExpression';
+export { BASELINE_CUSTOM_AGGREGATION_SPEC, CLAUSE_DOCS, CLAUSE_OPERAND_KINDS, OBSERVABLE_CALL_SPECS, OBSERVABLE_DOCS, CUSTOM_OBSERVABLE_FALLBACK_SPEC, TRIGGER_LITERALS, getObservableCallSpec, isObservableSourceName, type ObservableCallSpec, type ObservableSourceName, type ObservableWindowKind, type ObservableScope, type ObservableInputType, type ObservablePositionalParam, type AqlCallableSpec, type AqlClauseName, type ClauseDocs, type ClauseOperandKind, type ClauseUsage, type FunctionParameter, type FunctionParameters, type FunctionParameterUiHints, } from './functionMetadata';
+//# sourceMappingURL=index.d.ts.map

package/vendor/aql/validation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/validation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,uBAAuB,EACvB,KAAK,mBAAmB,EACxB,KAAK,2BAA2B,EAChC,KAAK,8BAA8B,EACnC,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,8BAA8B,GACpC,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,KAAK,cAAc,EACnB,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,2BAA2B,GACjC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,qBAAqB,EACrB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,4BAA4B,GAClC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,gCAAgC,EAChC,WAAW,EACX,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,EACf,+BAA+B,EAC/B,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,EAC9B,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,GAC9B,MAAM,oBAAoB,CAAC"}

package/vendor/aql/validation/index.js

@@ -0,0 +1,5 @@
+export { validateExpressionTypes, inferStaticExpressionType, mapDataTypeToStaticType, } from './validateExpressionTypes.js';
+export { classifyExpression, getRootExpression, inferExpressionKind, } from './classifyExpression.js';
+export { validateAqlExpression, } from './validateAqlExpression.js';
+export { BASELINE_CUSTOM_AGGREGATION_SPEC, CLAUSE_DOCS, CLAUSE_OPERAND_KINDS, OBSERVABLE_CALL_SPECS, OBSERVABLE_DOCS, CUSTOM_OBSERVABLE_FALLBACK_SPEC, TRIGGER_LITERALS, getObservableCallSpec, isObservableSourceName, } from './functionMetadata.js';
+//# sourceMappingURL=index.js.map

package/vendor/aql/validation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/validation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,uBAAuB,GAOxB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,GAKpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,qBAAqB,GAMtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,gCAAgC,EAChC,WAAW,EACX,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,EACf,+BAA+B,EAC/B,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,GAevB,MAAM,oBAAoB,CAAC"}

package/vendor/aql/validation/validateAqlExpression.d.ts

@@ -0,0 +1,81 @@
+import type { AST, Overload } from '../types';
+import { type ExpressionClassification, type ExpressionValidationRequest } from './classifyExpression';
+import { type AggregationCatalogue } from '../plan/catalogue';
+import { type StaticColumnType } from './validateExpressionTypes';
+/**
+ * Structural validation of AQL expressions.
+ *
+ * Runs the guard rails on the *authored* AST (spelling rails 1/2/4/5 need
+ * the raw shape), normalizes, then checks structure, clauses, and types on
+ * the canonical contract-v3 tree. Every diagnostic is targeted (code +
+ * range) and, where a rewrite exists, carries a quick-fix payload for the
+ * expression editor.
+ *
+ * Leftover legacy spellings are errors (no silent rewrite). Convert them
+ * with `migrateExpression` / the state upgrade before validate/evaluate.
+ * The legacy observable sources (`ROW_CHANGE{…}`, …) carry their observable
+ * rewrite as the quick-fix.
+ */
+export type AqlValidationCode = 'AQL_UNKNOWN_FUNCTION' | 'AQL_UNKNOWN_BRACE_CALL' | 'AQL_AGG_PAREN_CALL' | 'AQL_DUAL_PAREN_AGG' | 'AQL_NESTED_AGG' | 'AQL_DUPLICATE_CLAUSE' | 'AQL_DUPLICATE_FILTER' | 'AQL_MISSING_COMMA_BEFORE_WHERE' | 'AQL_MISSING_INPUT' | 'AQL_WITHIN_EXCEEDS_MAX' | 'AQL_CLAUSE_NOT_ALLOWED' | 'AQL_CUMULATIVE_UNSUPPORTED' | 'AQL_MISSING_REQUIRED_CLAUSE' | 'AQL_CLAUSE_OPERAND_TYPE' | 'AQL_ROOT_NOT_BOOLEAN' | 'AQL_AGG_NOT_ALLOWED' | 'AQL_AGG_REQUIRED' | 'AQL_TYPE_MISMATCH' | 'AQL_DURATION_TYPE' | 'AQL_LEGACY_SPELLING' | 'AQL_CLAUSE_CONFLICT' | 'AQL_OBSERVABLE_INPUT' | 'AQL_OBSERVABLE_NUMERIC_INPUT' | 'AQL_LAST_N_EXCEEDS_MAX' | 'AQL_TRIGGER_KIND' | 'AQL_OBSERVABLE_IN_OBSERVABLE' | 'AQL_OBSERVABLE_IN_AGGREGATION' | 'AQL_OBSERVABLE_NOT_ALLOWED';
+export interface AqlQuickFix {
+    label: string;
+    replacement: string;
+    /** Character span in the source text the replacement applies to. */
+    range?: [number, number];
+}
+export interface AqlValidationIssue {
+    code: AqlValidationCode;
+    message: string;
+    severity: 'error' | 'warning' | 'info';
+    range?: [number, number];
+    functionName?: string;
+    quickFix?: AqlQuickFix;
+}
+export interface AqlValidationResult {
+    /** True when there are no ERROR-severity issues. Warnings never invalidate. */
+    isValid: boolean;
+    issues: AqlValidationIssue[];
+    classification: ExpressionClassification;
+    /** The normalized contract-v3 program the structural checks ran on. */
+    normalizedAst: AST;
+}
+interface ScalarFunctionMeta {
+    returnType?: string;
+    operands?: Overload[];
+    enforceOperandTypes?: boolean;
+    /** Value depends on the clock (`NOW()`, `IS_PAST()`, …). */
+    isTimeVolatile?: boolean;
+}
+export interface ValidateAqlExpressionOptions {
+    /**
+     * What the host context requires (return type, aggregation / observable
+     * capabilities). When omitted only the intrinsic guard rails run. A
+     * host's own binding vocabulary maps onto this request on the host side.
+     */
+    request?: ExpressionValidationRequest;
+    /** The scalar pool — enables the unknown-name checks and the type walk. */
+    scalarFunctions?: Record<string, ScalarFunctionMeta | undefined>;
+    /**
+     * Aggregation catalogue (system + host-registered operators). Drives the
+     * brace-call schema (clauses, required input, result type) and the custom
+     * aggregation names. Defaults to the system catalogue.
+     */
+    catalogue?: AggregationCatalogue;
+    /**
+     * Additional custom aggregation brace-call names known to the host but
+     * not present in `catalogue` (rare). Names from the catalogue are always
+     * included.
+     */
+    customAggregatedNames?: Iterable<string>;
+    /** Custom observable source names registered by the host. */
+    customObservableNames?: Iterable<string>;
+    /** Rail 9: maximum `WITHIN` window. Default 24h. */
+    maxWithinMs?: number;
+    /** Maximum `LAST_N(n)` (per-cell history cap). Default 1000. */
+    maxHistoryPerCell?: number;
+    /** Column type resolver for `numeric-ref` clause operands and the type walk. */
+    getColumnType?: (columnId: string) => StaticColumnType | undefined;
+}
+export declare const validateAqlExpression: (ast: AST, options?: ValidateAqlExpressionOptions) => AqlValidationResult;
+export {};
+//# sourceMappingURL=validateAqlExpression.d.ts.map

package/vendor/aql/validation/validateAqlExpression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateAqlExpression.d.ts","sourceRoot":"","sources":["../../../src/validation/validateAqlExpression.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAgC,QAAQ,EAAE,MAAM,UAAU,CAAC;AAiB5E,OAAO,EAGL,KAAK,wBAAwB,EAC7B,KAAK,2BAA2B,EACjC,MAAM,sBAAsB,CAAC;AAc9B,OAAO,EAAgC,KAAK,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE5F,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,2BAA2B,CAAC;AAEnC;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,iBAAiB,GACzB,sBAAsB,GACtB,wBAAwB,GACxB,oBAAoB,GACpB,oBAAoB,GACpB,gBAAgB,GAChB,sBAAsB,GACtB,sBAAsB,GACtB,gCAAgC,GAChC,mBAAmB,GACnB,wBAAwB,GACxB,wBAAwB,GACxB,4BAA4B,GAC5B,6BAA6B,GAC7B,yBAAyB,GACzB,sBAAsB,GACtB,qBAAqB,GACrB,kBAAkB,GAClB,mBAAmB,GACnB,mBAAmB,GACnB,qBAAqB,GAErB,qBAAqB,GACrB,sBAAsB,GACtB,8BAA8B,GAC9B,wBAAwB,GACxB,kBAAkB,GAClB,8BAA8B,GAC9B,+BAA+B,GAC/B,4BAA4B,CAAC;AAEjC,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,WAAW,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,+EAA+E;IAC/E,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,cAAc,EAAE,wBAAwB,CAAC;IACzC,uEAAuE;IACvE,aAAa,EAAE,GAAG,CAAC;CACpB;AAED,UAAU,kBAAkB;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC;IACtB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,4DAA4D;IAC5D,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,4BAA4B;IAC3C;;;;OAIG;IACH,OAAO,CAAC,EAAE,2BAA2B,CAAC;IACtC,2EAA2E;IAC3E,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,SAAS,CAAC,CAAC;IACjE;;;;OAIG;IACH,SAAS,CAAC,EAAE,oBAAoB,CAAC;IACjC;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACzC,6DAA6D;IAC7D,qBAAqB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACzC,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gFAAgF;IAChF,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,gBAAgB,GAAG,SAAS,CAAC;CACpE;AAsiCD,eAAO,MAAM,qBAAqB,QAC3B,GAAG,YACC,4BAA4B,KACpC,mBA2FF,CAAC"}