udp-react-enterprise-component-library 26.7.0 → 26.8.0-beta.0

package/dist/searchIntent/compile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../src/searchIntent/compile.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,eAAe,EAGf,MAAM,EACP,MAAM,yCAAyC,CAAC;AAEjD,OAAO,KAAK,EAGV,qBAAqB,EACrB,WAAW,EACZ,MAAM,SAAS,CAAC;AA4DjB;;;;GAIG;AACH,eAAO,MAAM,aAAa,8GAkGzB,CAAC"}

package/dist/searchIntent/compile.js

@@ -0,0 +1,127 @@
+import { LogicalSearchOperator, SearchGroupingType } from 'udp-stencil-component-library';
+import { OPERATOR_TO_BACKEND } from './operators';
+const toLogicalOperator = (op) => op === 'or' ? LogicalSearchOperator.Or : LogicalSearchOperator.And;
+const toFilterElement = (cond, groupId) => {
+    var _a;
+    return ({
+        searchField: cond.field,
+        searchOperator: OPERATOR_TO_BACKEND[cond.operator],
+        // Multi-value operators are comma-joined ("v1,v2"), matching both the manual
+        // builder's storage format and the grid's search composition.
+        searchValue: cond.values ? cond.values.join(',') : ((_a = cond.value) !== null && _a !== void 0 ? _a : ''),
+        groupId
+    });
+};
+/**
+ * Compiles the filter spec into filterElements + filterGroups with
+ * deterministically assigned group ids: root group is 1, subgroups 2..n.
+ * This is the shape getNormalizedData in the advanced search builder expects.
+ */
+const compileFilters = (spec) => {
+    var _a, _b;
+    const ROOT_GROUP_ID = 1;
+    const filterGroups = [
+        {
+            groupId: ROOT_GROUP_ID,
+            parentGroupId: null,
+            logicalSearchOperator: toLogicalOperator(spec.op)
+        }
+    ];
+    const filterElements = ((_a = spec.conditions) !== null && _a !== void 0 ? _a : []).map((c) => toFilterElement(c, ROOT_GROUP_ID));
+    let nextGroupId = ROOT_GROUP_ID + 1;
+    for (const group of (_b = spec.groups) !== null && _b !== void 0 ? _b : []) {
+        const groupId = nextGroupId++;
+        filterGroups.push({
+            groupId,
+            parentGroupId: ROOT_GROUP_ID,
+            logicalSearchOperator: toLogicalOperator(group.op)
+        });
+        filterElements.push(...group.conditions.map((c) => toFilterElement(c, groupId)));
+    }
+    return {
+        filterElements,
+        filterGroups,
+        logicalSearchOperator: toLogicalOperator(spec.op)
+    };
+};
+/**
+ * Applies a validated intent to the current state, producing the next
+ * searchBody + columns. Pure: never mutates inputs. Sections that are
+ * null/omitted in the intent pass through unchanged.
+ */
+export const compileIntent = (intent, currentSearchBody, currentColumns) => {
+    var _a, _b, _c, _d, _e;
+    let searchBody = Object.assign({}, currentSearchBody);
+    if (intent.filters !== undefined && intent.filters !== null) {
+        searchBody = Object.assign(Object.assign({}, searchBody), compileFilters(intent.filters));
+    }
+    if (intent.sorts !== undefined && intent.sorts !== null) {
+        searchBody = Object.assign(Object.assign({}, searchBody), { orderElements: intent.sorts.map((s) => ({
+                sortColumn: s.field,
+                sortDirection: s.direction
+            })) });
+    }
+    if (intent.grouping !== undefined && intent.grouping !== null) {
+        const groupProperty = [...((_a = intent.grouping.groupBy) !== null && _a !== void 0 ? _a : [])];
+        const groupOperationList = ((_b = intent.grouping.aggregates) !== null && _b !== void 0 ? _b : []).map((a) => ({
+            operation: a.operation,
+            property: a.field
+        }));
+        // Aggregate when both groupBy and aggregates present, Distinct when only
+        // groupBy — the same derivation Data Builder's manual grouping UI applies.
+        const groupingType = groupProperty.length > 0
+            ? groupOperationList.length > 0
+                ? SearchGroupingType.Aggregate
+                : SearchGroupingType.Distinct
+            : SearchGroupingType.None;
+        searchBody = Object.assign(Object.assign({}, searchBody), { groupProperty,
+            groupOperationList,
+            groupingType });
+    }
+    if (intent.pageSize !== undefined && intent.pageSize !== null) {
+        searchBody = Object.assign(Object.assign({}, searchBody), { pageSize: intent.pageSize });
+    }
+    // Grouping-active invariants, mirroring the backend's own conventions
+    // (verified against the starter-project SearchUtil/DAO):
+    // - a grouped SELECT can only be ordered by grouped columns; the DB rejects
+    //   anything else ("ORDER BY items must appear in the select list"), and an
+    //   order on a grouped column is required for stable pagination
+    // - the AGGREGATE pk-list subquery only selects the pk expression when
+    //   EagerLoad is true (the backend service sets EagerLoad=true itself when
+    //   it builds aggregate searches)
+    const groupProperty = (_c = searchBody.groupProperty) !== null && _c !== void 0 ? _c : [];
+    if (groupProperty.length > 0) {
+        const grouped = new Set(groupProperty);
+        let orderElements = ((_d = searchBody.orderElements) !== null && _d !== void 0 ? _d : []).filter((o) => grouped.has(o.sortColumn));
+        if (orderElements.length === 0) {
+            orderElements = [{ sortColumn: groupProperty[0], sortDirection: 'ASC' }];
+        }
+        searchBody = Object.assign(Object.assign({}, searchBody), { orderElements });
+        if (((_e = searchBody.groupOperationList) !== null && _e !== void 0 ? _e : []).length > 0) {
+            searchBody = Object.assign(Object.assign({}, searchBody), { eagerLoad: true });
+        }
+    }
+    let columns = currentColumns;
+    if (intent.columns) {
+        const { showOnly, show, hide } = intent.columns;
+        const showSet = new Set(show !== null && show !== void 0 ? show : []);
+        const hideSet = new Set(hide !== null && hide !== void 0 ? hide : []);
+        const showOnlySet = showOnly ? new Set(showOnly) : null;
+        columns = currentColumns.map((col) => {
+            var _a;
+            const currentVisible = ((_a = col.extendedProperties) === null || _a === void 0 ? void 0 : _a.defaultVisible) !== false;
+            const nextVisible = showOnlySet
+                ? showOnlySet.has(col.name)
+                : showSet.has(col.name)
+                    ? true
+                    : hideSet.has(col.name)
+                        ? false
+                        : currentVisible;
+            if (nextVisible === currentVisible)
+                return col;
+            return Object.assign(Object.assign({}, col), { extendedProperties: Object.assign(Object.assign({}, col.extendedProperties), { defaultVisible: nextVisible }) });
+        });
+    }
+    return { searchBody, columns };
+};
+//# sourceMappingURL=compile.js.map

package/dist/searchIntent/compile.js.map

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

package/dist/searchIntent/compile.mjs

@@ -0,0 +1,120 @@
+import { OPERATOR_TO_BACKEND } from "./operators.mjs";
+import { LogicalSearchOperator, SearchGroupingType } from "udp-stencil-component-library";
+//#region src/searchIntent/compile.ts
+const toLogicalOperator = (op) => op === "or" ? LogicalSearchOperator.Or : LogicalSearchOperator.And;
+const toFilterElement = (cond, groupId) => ({
+	searchField: cond.field,
+	searchOperator: OPERATOR_TO_BACKEND[cond.operator],
+	searchValue: cond.values ? cond.values.join(",") : cond.value ?? "",
+	groupId
+});
+/**
+* Compiles the filter spec into filterElements + filterGroups with
+* deterministically assigned group ids: root group is 1, subgroups 2..n.
+* This is the shape getNormalizedData in the advanced search builder expects.
+*/
+const compileFilters = (spec) => {
+	const ROOT_GROUP_ID = 1;
+	const filterGroups = [{
+		groupId: ROOT_GROUP_ID,
+		parentGroupId: null,
+		logicalSearchOperator: toLogicalOperator(spec.op)
+	}];
+	const filterElements = (spec.conditions ?? []).map((c) => toFilterElement(c, ROOT_GROUP_ID));
+	let nextGroupId = ROOT_GROUP_ID + 1;
+	for (const group of spec.groups ?? []) {
+		const groupId = nextGroupId++;
+		filterGroups.push({
+			groupId,
+			parentGroupId: ROOT_GROUP_ID,
+			logicalSearchOperator: toLogicalOperator(group.op)
+		});
+		filterElements.push(...group.conditions.map((c) => toFilterElement(c, groupId)));
+	}
+	return {
+		filterElements,
+		filterGroups,
+		logicalSearchOperator: toLogicalOperator(spec.op)
+	};
+};
+/**
+* Applies a validated intent to the current state, producing the next
+* searchBody + columns. Pure: never mutates inputs. Sections that are
+* null/omitted in the intent pass through unchanged.
+*/
+const compileIntent = (intent, currentSearchBody, currentColumns) => {
+	let searchBody = { ...currentSearchBody };
+	if (intent.filters !== void 0 && intent.filters !== null) searchBody = {
+		...searchBody,
+		...compileFilters(intent.filters)
+	};
+	if (intent.sorts !== void 0 && intent.sorts !== null) searchBody = {
+		...searchBody,
+		orderElements: intent.sorts.map((s) => ({
+			sortColumn: s.field,
+			sortDirection: s.direction
+		}))
+	};
+	if (intent.grouping !== void 0 && intent.grouping !== null) {
+		const groupProperty = [...intent.grouping.groupBy ?? []];
+		const groupOperationList = (intent.grouping.aggregates ?? []).map((a) => ({
+			operation: a.operation,
+			property: a.field
+		}));
+		const groupingType = groupProperty.length > 0 ? groupOperationList.length > 0 ? SearchGroupingType.Aggregate : SearchGroupingType.Distinct : SearchGroupingType.None;
+		searchBody = {
+			...searchBody,
+			groupProperty,
+			groupOperationList,
+			groupingType
+		};
+	}
+	if (intent.pageSize !== void 0 && intent.pageSize !== null) searchBody = {
+		...searchBody,
+		pageSize: intent.pageSize
+	};
+	const groupProperty = searchBody.groupProperty ?? [];
+	if (groupProperty.length > 0) {
+		const grouped = new Set(groupProperty);
+		let orderElements = (searchBody.orderElements ?? []).filter((o) => grouped.has(o.sortColumn));
+		if (orderElements.length === 0) orderElements = [{
+			sortColumn: groupProperty[0],
+			sortDirection: "ASC"
+		}];
+		searchBody = {
+			...searchBody,
+			orderElements
+		};
+		if ((searchBody.groupOperationList ?? []).length > 0) searchBody = {
+			...searchBody,
+			eagerLoad: true
+		};
+	}
+	let columns = currentColumns;
+	if (intent.columns) {
+		const { showOnly, show, hide } = intent.columns;
+		const showSet = new Set(show ?? []);
+		const hideSet = new Set(hide ?? []);
+		const showOnlySet = showOnly ? new Set(showOnly) : null;
+		columns = currentColumns.map((col) => {
+			const currentVisible = col.extendedProperties?.defaultVisible !== false;
+			const nextVisible = showOnlySet ? showOnlySet.has(col.name) : showSet.has(col.name) ? true : hideSet.has(col.name) ? false : currentVisible;
+			if (nextVisible === currentVisible) return col;
+			return {
+				...col,
+				extendedProperties: {
+					...col.extendedProperties,
+					defaultVisible: nextVisible
+				}
+			};
+		});
+	}
+	return {
+		searchBody,
+		columns
+	};
+};
+//#endregion
+export { compileIntent };
+
+//# sourceMappingURL=compile.mjs.map

package/dist/searchIntent/compile.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.mjs","names":["LogicalSearchOperator","SearchGroupingType","CatalogProperty","FilterElement","FilterGroup","Search","OPERATOR_TO_BACKEND","AiCondition","AiFilterSpec","CompiledSearchChanges","QueryIntent","toLogicalOperator","op","Or","And","toFilterElement","cond","groupId","searchField","field","searchOperator","operator","searchValue","values","join","value","compileFilters","spec","Pick","ROOT_GROUP_ID","filterGroups","parentGroupId","logicalSearchOperator","filterElements","conditions","map","c","nextGroupId","group","groups","push","compileIntent","intent","currentSearchBody","currentColumns","searchBody","filters","undefined","sorts","orderElements","s","sortColumn","sortDirection","direction","grouping","groupProperty","groupBy","groupOperationList","aggregates","a","operation","property","groupingType","length","Aggregate","Distinct","None","pageSize","grouped","Set","filter","o","has","eagerLoad","columns","showOnly","show","hide","showSet","hideSet","showOnlySet","col","currentVisible","extendedProperties","defaultVisible","nextVisible","name"],"sources":["../../src/searchIntent/compile.ts"],"sourcesContent":["import {\n  LogicalSearchOperator,\n  SearchGroupingType\n} from '@univerus/udp-stencil-component-library';\nimport type {\n  CatalogProperty,\n  FilterElement,\n  FilterGroup,\n  Search\n} from '@univerus/udp-stencil-component-library';\nimport { OPERATOR_TO_BACKEND } from './operators';\nimport type {\n  AiCondition,\n  AiFilterSpec,\n  CompiledSearchChanges,\n  QueryIntent\n} from './types';\n\nconst toLogicalOperator = (op: 'and' | 'or'): number =>\n  op === 'or' ? LogicalSearchOperator.Or : LogicalSearchOperator.And;\n\nconst toFilterElement = (\n  cond: AiCondition,\n  groupId: number\n): FilterElement => ({\n  searchField: cond.field,\n  searchOperator: OPERATOR_TO_BACKEND[cond.operator],\n  // Multi-value operators are comma-joined (\"v1,v2\"), matching both the manual\n  // builder's storage format and the grid's search composition.\n  searchValue: cond.values ? cond.values.join(',') : (cond.value ?? ''),\n  groupId\n});\n\n/**\n * Compiles the filter spec into filterElements + filterGroups with\n * deterministically assigned group ids: root group is 1, subgroups 2..n.\n * This is the shape getNormalizedData in the advanced search builder expects.\n */\nconst compileFilters = (\n  spec: AiFilterSpec\n): Pick<\n  Search,\n  'filterElements' | 'filterGroups' | 'logicalSearchOperator'\n> => {\n  const ROOT_GROUP_ID = 1;\n  const filterGroups: FilterGroup[] = [\n    {\n      groupId: ROOT_GROUP_ID,\n      parentGroupId: null,\n      logicalSearchOperator: toLogicalOperator(spec.op)\n    }\n  ];\n  const filterElements: FilterElement[] = (spec.conditions ?? []).map((c) =>\n    toFilterElement(c, ROOT_GROUP_ID)\n  );\n\n  let nextGroupId = ROOT_GROUP_ID + 1;\n  for (const group of spec.groups ?? []) {\n    const groupId = nextGroupId++;\n    filterGroups.push({\n      groupId,\n      parentGroupId: ROOT_GROUP_ID,\n      logicalSearchOperator: toLogicalOperator(group.op)\n    });\n    filterElements.push(\n      ...group.conditions.map((c) => toFilterElement(c, groupId))\n    );\n  }\n\n  return {\n    filterElements,\n    filterGroups,\n    logicalSearchOperator: toLogicalOperator(spec.op)\n  };\n};\n\n/**\n * Applies a validated intent to the current state, producing the next\n * searchBody + columns. Pure: never mutates inputs. Sections that are\n * null/omitted in the intent pass through unchanged.\n */\nexport const compileIntent = (\n  intent: QueryIntent,\n  currentSearchBody: Search,\n  currentColumns: CatalogProperty[]\n): CompiledSearchChanges => {\n  let searchBody: Search = { ...currentSearchBody };\n\n  if (intent.filters !== undefined && intent.filters !== null) {\n    searchBody = { ...searchBody, ...compileFilters(intent.filters) };\n  }\n\n  if (intent.sorts !== undefined && intent.sorts !== null) {\n    searchBody = {\n      ...searchBody,\n      orderElements: intent.sorts.map((s) => ({\n        sortColumn: s.field,\n        sortDirection: s.direction\n      }))\n    };\n  }\n\n  if (intent.grouping !== undefined && intent.grouping !== null) {\n    const groupProperty = [...(intent.grouping.groupBy ?? [])];\n    const groupOperationList = (intent.grouping.aggregates ?? []).map((a) => ({\n      operation: a.operation,\n      property: a.field\n    }));\n    // Aggregate when both groupBy and aggregates present, Distinct when only\n    // groupBy — the same derivation Data Builder's manual grouping UI applies.\n    const groupingType =\n      groupProperty.length > 0\n        ? groupOperationList.length > 0\n          ? SearchGroupingType.Aggregate\n          : SearchGroupingType.Distinct\n        : SearchGroupingType.None;\n    searchBody = {\n      ...searchBody,\n      groupProperty,\n      groupOperationList,\n      groupingType\n    };\n  }\n\n  if (intent.pageSize !== undefined && intent.pageSize !== null) {\n    searchBody = { ...searchBody, pageSize: intent.pageSize };\n  }\n\n  // Grouping-active invariants, mirroring the backend's own conventions\n  // (verified against the starter-project SearchUtil/DAO):\n  // - a grouped SELECT can only be ordered by grouped columns; the DB rejects\n  //   anything else (\"ORDER BY items must appear in the select list\"), and an\n  //   order on a grouped column is required for stable pagination\n  // - the AGGREGATE pk-list subquery only selects the pk expression when\n  //   EagerLoad is true (the backend service sets EagerLoad=true itself when\n  //   it builds aggregate searches)\n  const groupProperty = searchBody.groupProperty ?? [];\n  if (groupProperty.length > 0) {\n    const grouped = new Set(groupProperty);\n    let orderElements = (searchBody.orderElements ?? []).filter((o) =>\n      grouped.has(o.sortColumn)\n    );\n    if (orderElements.length === 0) {\n      orderElements = [{ sortColumn: groupProperty[0], sortDirection: 'ASC' }];\n    }\n    searchBody = { ...searchBody, orderElements };\n    if ((searchBody.groupOperationList ?? []).length > 0) {\n      searchBody = { ...searchBody, eagerLoad: true };\n    }\n  }\n\n  let columns = currentColumns;\n  if (intent.columns) {\n    const { showOnly, show, hide } = intent.columns;\n    const showSet = new Set(show ?? []);\n    const hideSet = new Set(hide ?? []);\n    const showOnlySet = showOnly ? new Set(showOnly) : null;\n\n    columns = currentColumns.map((col) => {\n      const currentVisible = col.extendedProperties?.defaultVisible !== false;\n      const nextVisible = showOnlySet\n        ? showOnlySet.has(col.name)\n        : showSet.has(col.name)\n          ? true\n          : hideSet.has(col.name)\n            ? false\n            : currentVisible;\n      if (nextVisible === currentVisible) return col;\n      return {\n        ...col,\n        extendedProperties: {\n          ...col.extendedProperties,\n          defaultVisible: nextVisible\n        }\n      };\n    });\n  }\n\n  return { searchBody, columns };\n};\n"],"mappings":"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"}

package/dist/searchIntent/diff.d.ts

@@ -0,0 +1,10 @@
+import type { AiDiffLine, QueryIntent } from './types';
+/** Fluent icon names per diff-line kind, for AiProposalDetail rendering. */
+export declare const AI_DIFF_ICONS: Record<AiDiffLine['kind'], string>;
+/**
+ * Human-readable summary of what applying the intent will change. Because
+ * sections are declarative replacements, each line describes the resulting
+ * state of a changed section rather than an add/remove delta.
+ */
+export declare const describeIntent: (intent: QueryIntent) => AiDiffLine[];
+//# sourceMappingURL=diff.d.ts.map

package/dist/searchIntent/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/searchIntent/diff.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAe,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEpE,4EAA4E;AAC5E,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,CAM5D,CAAC;AAiBF;;;;GAIG;AACH,eAAO,MAAM,cAAc,uCAiE1B,CAAC"}

package/dist/searchIntent/diff.js

@@ -0,0 +1,90 @@
+import { OPERATOR_LABELS } from './operators';
+/** Fluent icon names per diff-line kind, for AiProposalDetail rendering. */
+export const AI_DIFF_ICONS = {
+    filters: 'filter',
+    sorts: 'sort',
+    grouping: 'group',
+    columns: 'table',
+    pageSize: 'page'
+};
+const describeCondition = (cond) => {
+    var _a, _b;
+    const op = (_a = OPERATOR_LABELS[cond.operator]) !== null && _a !== void 0 ? _a : cond.operator;
+    if (cond.operator === 'is_empty' || cond.operator === 'is_not_empty') {
+        return `${cond.field} ${op}`;
+    }
+    if (cond.operator === 'between') {
+        const [lo, hi] = (_b = cond.values) !== null && _b !== void 0 ? _b : [];
+        return `${cond.field} ${op} ${lo} and ${hi}`;
+    }
+    if (cond.values) {
+        return `${cond.field} ${op} [${cond.values.join(', ')}]`;
+    }
+    return `${cond.field} ${op} ${cond.value}`;
+};
+/**
+ * Human-readable summary of what applying the intent will change. Because
+ * sections are declarative replacements, each line describes the resulting
+ * state of a changed section rather than an add/remove delta.
+ */
+export const describeIntent = (intent) => {
+    const lines = [];
+    if (intent.filters !== undefined && intent.filters !== null) {
+        const { op, conditions = [], groups = [] } = intent.filters;
+        if (conditions.length === 0 && groups.length === 0) {
+            lines.push({ kind: 'filters', text: 'Filters: cleared' });
+        }
+        else {
+            const joiner = ` ${op.toUpperCase()} `;
+            const parts = conditions.map(describeCondition);
+            for (const group of groups) {
+                parts.push(`(${group.conditions.map(describeCondition).join(` ${group.op.toUpperCase()} `)})`);
+            }
+            lines.push({ kind: 'filters', text: `Filters: ${parts.join(joiner)}` });
+        }
+    }
+    if (intent.sorts !== undefined && intent.sorts !== null) {
+        lines.push({
+            kind: 'sorts',
+            text: intent.sorts.length === 0
+                ? 'Sort: cleared'
+                : `Sort: ${intent.sorts.map((s) => `${s.field} ${s.direction}`).join(', ')}`
+        });
+    }
+    if (intent.grouping !== undefined && intent.grouping !== null) {
+        const { groupBy = [], aggregates = [] } = intent.grouping;
+        if (groupBy.length === 0 && aggregates.length === 0) {
+            lines.push({ kind: 'grouping', text: 'Grouping: cleared' });
+        }
+        else {
+            const parts = [`Group by: ${groupBy.join(', ') || '—'}`];
+            if (aggregates.length > 0) {
+                parts.push(`Aggregates: ${aggregates.map((a) => `${a.operation}(${a.field})`).join(', ')}`);
+            }
+            lines.push({ kind: 'grouping', text: parts.join(' · ') });
+        }
+    }
+    if (intent.columns) {
+        const { showOnly, show = [], hide = [] } = intent.columns;
+        if (showOnly) {
+            lines.push({
+                kind: 'columns',
+                text: `Columns: show only ${showOnly.join(', ')}`
+            });
+        }
+        else {
+            const parts = [];
+            if (show.length)
+                parts.push(`show ${show.join(', ')}`);
+            if (hide.length)
+                parts.push(`hide ${hide.join(', ')}`);
+            if (parts.length)
+                lines.push({ kind: 'columns', text: `Columns: ${parts.join(' · ')}` });
+        }
+    }
+    if (intent.pageSize !== undefined && intent.pageSize !== null) {
+        lines.push({ kind: 'pageSize', text: `Page size: ${intent.pageSize}` });
+    }
+    return lines;
+};
+//# sourceMappingURL=diff.js.map

package/dist/searchIntent/diff.js.map

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

package/dist/searchIntent/diff.mjs

@@ -0,0 +1,88 @@
+import { OPERATOR_LABELS } from "./operators.mjs";
+//#region src/searchIntent/diff.ts
+/** Fluent icon names per diff-line kind, for AiProposalDetail rendering. */
+const AI_DIFF_ICONS = {
+	filters: "filter",
+	sorts: "sort",
+	grouping: "group",
+	columns: "table",
+	pageSize: "page"
+};
+const describeCondition = (cond) => {
+	const op = OPERATOR_LABELS[cond.operator] ?? cond.operator;
+	if (cond.operator === "is_empty" || cond.operator === "is_not_empty") return `${cond.field} ${op}`;
+	if (cond.operator === "between") {
+		const [lo, hi] = cond.values ?? [];
+		return `${cond.field} ${op} ${lo} and ${hi}`;
+	}
+	if (cond.values) return `${cond.field} ${op} [${cond.values.join(", ")}]`;
+	return `${cond.field} ${op} ${cond.value}`;
+};
+/**
+* Human-readable summary of what applying the intent will change. Because
+* sections are declarative replacements, each line describes the resulting
+* state of a changed section rather than an add/remove delta.
+*/
+const describeIntent = (intent) => {
+	const lines = [];
+	if (intent.filters !== void 0 && intent.filters !== null) {
+		const { op, conditions = [], groups = [] } = intent.filters;
+		if (conditions.length === 0 && groups.length === 0) lines.push({
+			kind: "filters",
+			text: "Filters: cleared"
+		});
+		else {
+			const joiner = ` ${op.toUpperCase()} `;
+			const parts = conditions.map(describeCondition);
+			for (const group of groups) parts.push(`(${group.conditions.map(describeCondition).join(` ${group.op.toUpperCase()} `)})`);
+			lines.push({
+				kind: "filters",
+				text: `Filters: ${parts.join(joiner)}`
+			});
+		}
+	}
+	if (intent.sorts !== void 0 && intent.sorts !== null) lines.push({
+		kind: "sorts",
+		text: intent.sorts.length === 0 ? "Sort: cleared" : `Sort: ${intent.sorts.map((s) => `${s.field} ${s.direction}`).join(", ")}`
+	});
+	if (intent.grouping !== void 0 && intent.grouping !== null) {
+		const { groupBy = [], aggregates = [] } = intent.grouping;
+		if (groupBy.length === 0 && aggregates.length === 0) lines.push({
+			kind: "grouping",
+			text: "Grouping: cleared"
+		});
+		else {
+			const parts = [`Group by: ${groupBy.join(", ") || "—"}`];
+			if (aggregates.length > 0) parts.push(`Aggregates: ${aggregates.map((a) => `${a.operation}(${a.field})`).join(", ")}`);
+			lines.push({
+				kind: "grouping",
+				text: parts.join(" · ")
+			});
+		}
+	}
+	if (intent.columns) {
+		const { showOnly, show = [], hide = [] } = intent.columns;
+		if (showOnly) lines.push({
+			kind: "columns",
+			text: `Columns: show only ${showOnly.join(", ")}`
+		});
+		else {
+			const parts = [];
+			if (show.length) parts.push(`show ${show.join(", ")}`);
+			if (hide.length) parts.push(`hide ${hide.join(", ")}`);
+			if (parts.length) lines.push({
+				kind: "columns",
+				text: `Columns: ${parts.join(" · ")}`
+			});
+		}
+	}
+	if (intent.pageSize !== void 0 && intent.pageSize !== null) lines.push({
+		kind: "pageSize",
+		text: `Page size: ${intent.pageSize}`
+	});
+	return lines;
+};
+//#endregion
+export { AI_DIFF_ICONS, describeIntent };
+
+//# sourceMappingURL=diff.mjs.map

package/dist/searchIntent/diff.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.mjs","names":["OPERATOR_LABELS","AiCondition","AiDiffLine","QueryIntent","AI_DIFF_ICONS","Record","filters","sorts","grouping","columns","pageSize","describeCondition","cond","op","operator","field","lo","hi","values","join","value","describeIntent","intent","lines","undefined","conditions","groups","length","push","kind","text","joiner","toUpperCase","parts","map","group","s","direction","groupBy","aggregates","a","operation","showOnly","show","hide"],"sources":["../../src/searchIntent/diff.ts"],"sourcesContent":["import { OPERATOR_LABELS } from './operators';\nimport type { AiCondition, AiDiffLine, QueryIntent } from './types';\n\n/** Fluent icon names per diff-line kind, for AiProposalDetail rendering. */\nexport const AI_DIFF_ICONS: Record<AiDiffLine['kind'], string> = {\n  filters: 'filter',\n  sorts: 'sort',\n  grouping: 'group',\n  columns: 'table',\n  pageSize: 'page'\n};\n\nconst describeCondition = (cond: AiCondition): string => {\n  const op = OPERATOR_LABELS[cond.operator] ?? cond.operator;\n  if (cond.operator === 'is_empty' || cond.operator === 'is_not_empty') {\n    return `${cond.field} ${op}`;\n  }\n  if (cond.operator === 'between') {\n    const [lo, hi] = cond.values ?? [];\n    return `${cond.field} ${op} ${lo} and ${hi}`;\n  }\n  if (cond.values) {\n    return `${cond.field} ${op} [${cond.values.join(', ')}]`;\n  }\n  return `${cond.field} ${op} ${cond.value}`;\n};\n\n/**\n * Human-readable summary of what applying the intent will change. Because\n * sections are declarative replacements, each line describes the resulting\n * state of a changed section rather than an add/remove delta.\n */\nexport const describeIntent = (intent: QueryIntent): AiDiffLine[] => {\n  const lines: AiDiffLine[] = [];\n\n  if (intent.filters !== undefined && intent.filters !== null) {\n    const { op, conditions = [], groups = [] } = intent.filters;\n    if (conditions.length === 0 && groups.length === 0) {\n      lines.push({ kind: 'filters', text: 'Filters: cleared' });\n    } else {\n      const joiner = ` ${op.toUpperCase()} `;\n      const parts = conditions.map(describeCondition);\n      for (const group of groups) {\n        parts.push(\n          `(${group.conditions.map(describeCondition).join(` ${group.op.toUpperCase()} `)})`\n        );\n      }\n      lines.push({ kind: 'filters', text: `Filters: ${parts.join(joiner)}` });\n    }\n  }\n\n  if (intent.sorts !== undefined && intent.sorts !== null) {\n    lines.push({\n      kind: 'sorts',\n      text:\n        intent.sorts.length === 0\n          ? 'Sort: cleared'\n          : `Sort: ${intent.sorts.map((s) => `${s.field} ${s.direction}`).join(', ')}`\n    });\n  }\n\n  if (intent.grouping !== undefined && intent.grouping !== null) {\n    const { groupBy = [], aggregates = [] } = intent.grouping;\n    if (groupBy.length === 0 && aggregates.length === 0) {\n      lines.push({ kind: 'grouping', text: 'Grouping: cleared' });\n    } else {\n      const parts = [`Group by: ${groupBy.join(', ') || '—'}`];\n      if (aggregates.length > 0) {\n        parts.push(\n          `Aggregates: ${aggregates.map((a) => `${a.operation}(${a.field})`).join(', ')}`\n        );\n      }\n      lines.push({ kind: 'grouping', text: parts.join(' · ') });\n    }\n  }\n\n  if (intent.columns) {\n    const { showOnly, show = [], hide = [] } = intent.columns;\n    if (showOnly) {\n      lines.push({\n        kind: 'columns',\n        text: `Columns: show only ${showOnly.join(', ')}`\n      });\n    } else {\n      const parts: string[] = [];\n      if (show.length) parts.push(`show ${show.join(', ')}`);\n      if (hide.length) parts.push(`hide ${hide.join(', ')}`);\n      if (parts.length)\n        lines.push({ kind: 'columns', text: `Columns: ${parts.join(' · ')}` });\n    }\n  }\n\n  if (intent.pageSize !== undefined && intent.pageSize !== null) {\n    lines.push({ kind: 'pageSize', text: `Page size: ${intent.pageSize}` });\n  }\n\n  return lines;\n};\n"],"mappings":"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"}

package/dist/searchIntent/index.d.ts

@@ -0,0 +1,13 @@
+// Shared NL → Search-object copilot layer: the declarative intent IR, the
+// propose-tool schema, the validator core, the deterministic Search compiler,
+// diff rendering, and prompt building blocks. Proven in Data Builder's query
+// assistant; hosts adapt their schema source to AiSearchSchemaContext and
+// keep prompt copy + apply/undo wiring surface-specific.
+export * from './types';
+export * from './operators';
+export * from './tools';
+export * from './validate';
+export * from './compile';
+export * from './diff';
+export * from './prompt';
+//# sourceMappingURL=index.d.ts.map

package/dist/searchIntent/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/searchIntent/index.ts"],"names":[],"mappings":"AAAA,4EAA0E;AAC1E,8EAA8E;AAC9E,6EAA6E;AAC7E,0EAA0E;AAC1E,yDAAyD;AACzD,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC"}

package/dist/searchIntent/index.js

@@ -0,0 +1,13 @@
+// Shared NL → Search-object copilot layer: the declarative intent IR, the
+// propose-tool schema, the validator core, the deterministic Search compiler,
+// diff rendering, and prompt building blocks. Proven in Data Builder's query
+// assistant; hosts adapt their schema source to AiSearchSchemaContext and
+// keep prompt copy + apply/undo wiring surface-specific.
+export * from './types';
+export * from './operators';
+export * from './tools';
+export * from './validate';
+export * from './compile';
+export * from './diff';
+export * from './prompt';
+//# sourceMappingURL=index.js.map

package/dist/searchIntent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/searchIntent/index.ts"],"names":[],"mappings":"AAAA,4EAA0E;AAC1E,8EAA8E;AAC9E,6EAA6E;AAC7E,0EAA0E;AAC1E,yDAAyD;AACzD,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC"}

package/dist/searchIntent/operators.d.ts

@@ -0,0 +1,28 @@
+// Operator availability per normalized type. Mirrors
+// advanced-search-builder/helperFunctions/udpOperatorHelper.ts — keep in sync.
+export declare const OPERATORS_BY_TYPE: Record<string, string[]>;
+export declare const SINGLE_VALUE_OPERATORS: Set<string>;
+export declare const MULTI_VALUE_OPERATORS: Set<string>;
+export declare const NO_VALUE_OPERATORS: Set<string>;
+// Semantic operator → backend SearchHelper constant. Values are sent raw:
+// the backend applies substring semantics to LIKE itself (matching the grid's
+// buildSearchObject behavior), so no % wrapping here.
+export declare const OPERATOR_TO_BACKEND: Record<string, string>;
+/**
+ * Backend SearchHelper constant → semantic operator: the inverse of
+ * OPERATOR_TO_BACKEND, for reading an existing Search back into the vocabulary
+ * the model speaks (see describeCurrentSearchState). Backend operators with no
+ * intent equivalent (NOTLIKE, ENDSWITH) are absent — callers fall back to the
+ * raw constant rather than inventing one.
+ */
+export declare const OPERATOR_FROM_BACKEND: Record<string, string>;
+/** Human-readable operator labels for proposal diff cards. */
+export declare const OPERATOR_LABELS: Record<string, string>;
+/** Returns an error fragment when a value doesn't fit the field type, else null. */
+export declare const checkValueFormat: (type: string, value: string) => string;
+/**
+ * Normalizes a catalog/.NET type name to the vocabulary OPERATORS_BY_TYPE and
+ * checkValueFormat use (same normalization catalogTree.ts applies).
+ */
+export declare const normalizeSearchFieldType: (netType: string) => string;
+//# sourceMappingURL=operators.d.ts.map

package/dist/searchIntent/operators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operators.d.ts","sourceRoot":"","sources":["../../src/searchIntent/operators.ts"],"names":[],"mappings":"AAEA,qDAAqD;AACrD,iFAA+E;AAC/E,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAoEtD,CAAC;AAEF,eAAO,MAAM,sBAAsB,aASjC,CAAC;AACH,eAAO,MAAM,qBAAqB,aAAuC,CAAC;AAC1E,eAAO,MAAM,kBAAkB,aAAwC,CAAC;AAExE,4EAA0E;AAC1E,8EAA8E;AAC9E,sDAAsD;AACtD,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CActD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAKxD,CAAC;AAEF,8DAA8D;AAC9D,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAclD,CAAC;AAMF,oFAAoF;AACpF,eAAO,MAAM,gBAAgB,yCAuB5B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,6BAsBpC,CAAC"}