semanticdb-core 1.1.36 → 1.1.38

package/dist/index.d.ts

@@ -7,6 +7,7 @@ export * from './schema/schema.utils';
 export * from './schema/property.utils';
 export { getDrilldownDimensions } from './schema/schema.utils/getDrilldownDimensions';
 export * from './logicform/logicform';
+export * from './logicform/explainLogicform';
 export * from './logicform/logicform.utils';
 export * from './logicform/types/query';
 export * from './logicform/preds/nameForPredItem';

package/dist/index.js

@@ -25,6 +25,7 @@ __exportStar(require("./schema/property.utils"), exports);
 var getDrilldownDimensions_1 = require("./schema/schema.utils/getDrilldownDimensions");
 Object.defineProperty(exports, "getDrilldownDimensions", { enumerable: true, get: function () { return getDrilldownDimensions_1.getDrilldownDimensions; } });
 __exportStar(require("./logicform/logicform"), exports);
+__exportStar(require("./logicform/explainLogicform"), exports);
 __exportStar(require("./logicform/logicform.utils"), exports);
 __exportStar(require("./logicform/types/query"), exports);
 __exportStar(require("./logicform/preds/nameForPredItem"), exports);

package/dist/logicform/explainLogicform.d.ts

@@ -0,0 +1,13 @@
+import { LogicformType } from './logicform';
+import { SchemaType } from '../schema/schema';
+export declare const DEFAULT_EXPLAIN_LOGICFORM_LOCALE = "zh-CN";
+export type ExplainLogicformSchemas = Record<string, SchemaType>;
+export declare const normalizeExplainLogicformLocale: (locale?: string) => string;
+export declare const explainGroupbyLevel: (level?: string) => string;
+export declare const explainSchema: (logicform: LogicformType, schemas: ExplainLogicformSchemas, locale?: string) => string;
+export declare const explainQuery: (logicform: LogicformType, _schemas: ExplainLogicformSchemas, locale?: string) => string;
+export declare const explainPreds: (logicform: LogicformType, _schemas: ExplainLogicformSchemas, locale?: string) => string;
+export declare const explainGroupby: (logicform: LogicformType, _schemas: ExplainLogicformSchemas, locale?: string) => string;
+export declare const explainLimit: (logicform: LogicformType, _schemas: ExplainLogicformSchemas, locale?: string) => string;
+export declare const explainHaving: (logicform: LogicformType, _schemas: ExplainLogicformSchemas, locale?: string) => string;
+export declare const explainLogicform: (logicform: LogicformType, schemas: ExplainLogicformSchemas, locale?: string) => string[];

package/dist/logicform/explainLogicform.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.explainLogicform = exports.explainHaving = exports.explainLimit = exports.explainGroupby = exports.explainPreds = exports.explainQuery = exports.explainSchema = exports.explainGroupbyLevel = exports.normalizeExplainLogicformLocale = exports.DEFAULT_EXPLAIN_LOGICFORM_LOCALE = void 0;
+exports.DEFAULT_EXPLAIN_LOGICFORM_LOCALE = 'zh-CN';
+const normalizeExplainLogicformLocale = (locale) => {
+    if (locale === exports.DEFAULT_EXPLAIN_LOGICFORM_LOCALE) {
+        return locale;
+    }
+    return exports.DEFAULT_EXPLAIN_LOGICFORM_LOCALE;
+};
+exports.normalizeExplainLogicformLocale = normalizeExplainLogicformLocale;
+const GROUPBY_LEVEL_NAME_DICT = {
+    year: '年',
+    quarter: '季度',
+    toQuarter: '季度',
+    month: '月',
+    toMonth: '月',
+    week: '周',
+    toWeek: '周',
+    day: '日',
+    date: '日',
+    hour: '小时',
+    minute: '分钟',
+    second: '秒',
+};
+const stringifyJson = (value) => {
+    if (value === undefined) {
+        return '无';
+    }
+    const stringified = JSON.stringify(value);
+    return stringified === undefined ? String(value) : stringified;
+};
+const getEntityIdFromValue = (value) => {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        return undefined;
+    }
+    if (!('entity_id' in value)) {
+        return undefined;
+    }
+    const entityId = value.entity_id;
+    return typeof entityId === 'string' && entityId ? entityId : undefined;
+};
+const explainFilterLikeQuery = (query, prefix = '筛选', separator = ' ') => {
+    if (!query || Object.keys(query).length === 0) {
+        return '';
+    }
+    const parts = Object.keys(query)
+        .filter((k) => k !== 'entity_id')
+        .map((k) => {
+        const key = k.split('_').pop() || '';
+        const entityId = getEntityIdFromValue(query[k]);
+        if (entityId) {
+            return `${key}(${entityId})`;
+        }
+        return key;
+    });
+    const queryEntityId = getEntityIdFromValue(query);
+    if (queryEntityId) {
+        parts.push(`ID为${queryEntityId}`);
+    }
+    return parts.length > 0 ? `${prefix}${separator}${parts.join('、')}` : '';
+};
+const explainGroupbyLevel = (level) => {
+    if (!level) {
+        return '';
+    }
+    return GROUPBY_LEVEL_NAME_DICT[level] || level;
+};
+exports.explainGroupbyLevel = explainGroupbyLevel;
+const explainSchema = (logicform, schemas, locale = exports.DEFAULT_EXPLAIN_LOGICFORM_LOCALE) => {
+    var _a;
+    (0, exports.normalizeExplainLogicformLocale)(locale);
+    if (!logicform.schema) {
+        return '未指定主题';
+    }
+    const schemaName = ((_a = schemas[logicform.schema]) === null || _a === void 0 ? void 0 : _a.name) || logicform.schema;
+    return `${schemaName}主题`;
+};
+exports.explainSchema = explainSchema;
+const explainQuery = (logicform, _schemas, locale = exports.DEFAULT_EXPLAIN_LOGICFORM_LOCALE) => {
+    (0, exports.normalizeExplainLogicformLocale)(locale);
+    return explainFilterLikeQuery(logicform.query, '筛选');
+};
+exports.explainQuery = explainQuery;
+const explainPreds = (logicform, _schemas, locale = exports.DEFAULT_EXPLAIN_LOGICFORM_LOCALE) => {
+    (0, exports.normalizeExplainLogicformLocale)(locale);
+    if (!logicform.preds || logicform.preds.length === 0) {
+        return '';
+    }
+    return `计算 ${logicform.preds.map((p) => p.name).join('、')}`;
+};
+exports.explainPreds = explainPreds;
+const explainGroupby = (logicform, _schemas, locale = exports.DEFAULT_EXPLAIN_LOGICFORM_LOCALE) => {
+    (0, exports.normalizeExplainLogicformLocale)(locale);
+    if (!logicform.groupby || logicform.groupby.length === 0) {
+        return '';
+    }
+    return `按 ${logicform.groupby
+        .map((gi) => (0, exports.explainGroupbyLevel)(gi.level) || gi.name || '')
+        .join('、')} 分组`;
+};
+exports.explainGroupby = explainGroupby;
+const explainLimit = (logicform, _schemas, locale = exports.DEFAULT_EXPLAIN_LOGICFORM_LOCALE) => {
+    (0, exports.normalizeExplainLogicformLocale)(locale);
+    if (typeof logicform.limit !== 'number') {
+        return '';
+    }
+    return `限制 ${logicform.limit} 条记录`;
+};
+exports.explainLimit = explainLimit;
+const explainHaving = (logicform, _schemas, locale = exports.DEFAULT_EXPLAIN_LOGICFORM_LOCALE) => {
+    (0, exports.normalizeExplainLogicformLocale)(locale);
+    return explainFilterLikeQuery(logicform.having, '结果过滤：', '');
+};
+exports.explainHaving = explainHaving;
+const explainLogicform = (logicform, schemas, locale = exports.DEFAULT_EXPLAIN_LOGICFORM_LOCALE) => {
+    const normalizedLocale = (0, exports.normalizeExplainLogicformLocale)(locale);
+    return [
+        (0, exports.explainSchema)(logicform, schemas, normalizedLocale),
+        (0, exports.explainQuery)(logicform, schemas, normalizedLocale),
+        (0, exports.explainPreds)(logicform, schemas, normalizedLocale),
+        (0, exports.explainGroupby)(logicform, schemas, normalizedLocale),
+        (0, exports.explainLimit)(logicform, schemas, normalizedLocale),
+        (0, exports.explainHaving)(logicform, schemas, normalizedLocale),
+    ];
+};
+exports.explainLogicform = explainLogicform;

package/dist/result/index.js

@@ -18,13 +18,13 @@ const logicformResultToMarkdown = (ret, number_only) => {
         markdownText += `总记录数: ${total}\n`;
     }
     if (!logicform.groupby && !(0, logicform_utils_1.isSimpleQuery)(logicform)) {
-        markdownText = columnProperties
+        markdownText += columnProperties
             .map((p) => (number_only ? '' : (p.name + ': ')) +
             (0, property_utils_1.formatWithProperty)(p.ref ? schemas[p.ref] : schemas[logicform.schema], p, result[0][p.name], true))
             .join(',');
     }
     else {
-        markdownText =
+        markdownText +=
             '\n' +
                 (0, json2md_1.default)([
                     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "semanticdb-core",
-  "version": "1.1.36",
+  "version": "1.1.38",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [