@cloudcare/guance-front-tools 1.0.20 → 1.0.21

package/README.md

@@ -25,67 +25,3 @@ import { covert } from '@cloudcare/guance-front-tools'
 
 const guanceDashboard = covert(grafanaDashboard)
 ```
-
-## AI Skill Usage
-
-This repository also ships a Codex skill for Grafana-to-Guance dashboard conversion:
-
-- skill manifest:
-  - `skills/grafana-to-guance-dashboard/SKILL.md`
-- executable skill script:
-  - `skills/grafana-to-guance-dashboard/scripts/convert-grafana-dashboard.mjs`
-- skill converter core:
-  - `skills/grafana-to-guance-dashboard/scripts/convert-grafana-dashboard-core.js`
-- standalone validator:
-  - `skills/grafana-to-guance-dashboard/scripts/validate-file.mjs`
-- bundled schemas, fixtures, and tests:
-  - `skills/grafana-to-guance-dashboard/schemas/`
-  - `skills/grafana-to-guance-dashboard/fixtures/`
-  - `skills/grafana-to-guance-dashboard/test/`
-
-When an AI agent needs to convert or debug Grafana dashboards with the standalone skill, it should work inside the skill directory:
-
-```bash
-cd skills/grafana-to-guance-dashboard
-npm install
-npm run convert -- \
-  --input ./fixtures/grafana-dashboard.json \
-  --output ./output/guance-dashboard.json \
-  --validate
-```
-
-Optional modes:
-
-```bash
-npm run convert -- \
-  --input ./fixtures/grafana-dashboard.json \
-  --output ./output/guance-dashboard.guance-promql.json \
-  --validate \
-  --guance-promql-compatible
-
-npm run convert -- \
-  --input ./fixtures/grafana-dashboard.json \
-  --output ./output/guance-dashboard.keep-meta.json \
-  --validate \
-  --keep-grafana-meta
-```
-
-Implementation notes for AI agents:
-
-- The skill is self-contained and no longer syncs from `lib/scripts/*`.
-- The skill is intended to do more than execute conversion:
-  - preflight analysis
-  - unit inference review
-  - PromQL compatibility audit
-  - post-conversion gap analysis
-  - repair planning
-- For skill conversion logic changes, edit:
-  - `skills/grafana-to-guance-dashboard/scripts/convert-grafana-dashboard-core.js`
-- For skill CLI / validation behavior changes, edit:
-  - `skills/grafana-to-guance-dashboard/scripts/convert-grafana-dashboard.mjs`
-- Validate and regression-test inside the skill directory:
-
-```bash
-npm run validate:file -- ./output/guance-dashboard.json
-npm test
-```

package/lib/cjs/generated/dashboardCharts.d.ts

@@ -5,6 +5,51 @@
  * 图表视图变量列表结构
  */
 export type ChartVarsSettings = ChartVarsItem[];
+/**
+ * 图表完整结构
+ */
+export type ChartData = {
+    [k: string]: unknown;
+} & {
+    extend: {
+        links?: ChartsCommonChartLinksSchemaJson;
+        settings?: ChartSettings;
+        [k: string]: unknown;
+    };
+    group?: {
+        name?: string | null;
+        [k: string]: unknown;
+    };
+    /**
+     * 图表名称
+     */
+    name: string;
+    /**
+     * 图表位置信息
+     */
+    pos: {
+        /**
+         * 图表高度,每行的高度默认为10像素,比如 h 为12, 则实际高度为 12 * 10
+         */
+        h: number;
+        /**
+         * 图表宽度,栅格系统的最大列数为 24, 比如 w为12，则显示宽度则为容器宽度的 1/2 倍
+         */
+        w: number;
+        /**
+         * 图表距离容器的水平距离,栅格系统的最大列数为 24, 比如 x为12，则图表距离容器左边的水平距离为容器宽度 1/2 倍
+         */
+        x: number;
+        /**
+         * 图表距离容器垂直距离,每行的高度默认为10像素,比如 y为12, 则实际高度为 12 * 10
+         */
+        y: number;
+        [k: string]: unknown;
+    };
+    type: ChartType1;
+    queries: ChartQueries;
+    [k: string]: unknown;
+};
 /**
  * 图表跳转链接列表
  */
@@ -12,7 +57,7 @@ export type ChartsCommonChartLinksSchemaJson = ChartsCommonChartLinkItemSchemaJs
 /**
  * 图表设置配置完整结构。
  */
-export type ChartSettings = ChartAlarmSettings | ChartBarSettings | ChartChinaMapSettings | ChartFunnelSettings | ChartGaugeSettings | ChartHeatmapSettings | ChartHexgonSettings | ChartHistogramSettings | ChartIframeSettings | ChartLogSettings | ChartObjectSettings | ChartPictureSettings | ChartPieSettings | ChartSankeySettings | ChartScatterBubbleSettings | ChartSequenceSettings | ChartSinglestatSettings | ChartTableSettings | ChartTextSettings | ChartToplistSettings | ChartTopologySettings | ChartTreeMapSettings | ChartWorldMapSettings;
+export type ChartSettings = ChartAlarmSettings | ChartBarSettings | ChartChinaMapSettings | ChartChangeSettings | ChartCommandSettings | ChartFunnelSettings | ChartGaugeSettings | ChartHeatmapSettings | ChartHexgonSettings | ChartHistogramSettings | ChartIframeSettings | ChartLogSettings | ChartMonitorSettings | ChartObjectSettings | ChartPictureSettings | ChartPieSettings | ChartSankeySettings | ChartScatterBubbleSettings | ChartSequenceSettings | ChartSinglestatSettings | ChartTableSettings | ChartTextSettings | ChartToplistSettings | ChartTopologySettings | ChartVideoSettings | ChartTreeMapSettings | ChartWorldMapSettings;
 /**
  * 告警统计图配置信息
  */
@@ -156,6 +201,10 @@ export type ChartAliasSettings = {
      * 需要替换为别名对应的指标名称,冗余字段
      */
     key: string;
+    /**
+     * 当别名绑定到具体查询时，对应的查询编码，例如 A/B/C
+     */
+    queryCode?: string;
     [k: string]: unknown;
 }[];
 /**
@@ -204,22 +253,16 @@ export type CommonChartStackTypeSettings = 'time' | 'percent';
 export type CommonChartStackContentSettings = 'group' | 'index';
 /**
  * 图表全局设置单位
- *
- * @minItems 2
- * @maxItems 2
  */
-export type ChartUnitItemsSettings = [
-    ('custom' | 'length' | 'area' | 'mass' | 'volume' | 'each' | 'temperature' | 'time' | 'digital' | 'diitalUnit' | 'partsPer' | 'speed' | 'pace' | 'pressure' | 'current' | 'voltage' | 'power' | 'reactivePower' | 'apparentPower' | 'energy' | 'reactiveEnergy' | 'volumeFlowRate' | 'illuminance' | 'frequency' | 'angle' | 'throughput' | 'percent' | 'rmb' | 'currencySymbol'),
+export type ChartUnitItemsSettings = [] | [
+    ('custom' | 'length' | 'area' | 'mass' | 'volume' | 'each' | 'temperature' | 'time' | 'timeStamp' | 'digital' | 'diitalUnit' | 'partsPer' | 'speed' | 'pace' | 'pressure' | 'current' | 'voltage' | 'power' | 'reactivePower' | 'apparentPower' | 'energy' | 'reactiveEnergy' | 'volumeFlowRate' | 'illuminance' | 'frequency' | 'angle' | 'traffic' | 'bandWidth' | 'throughput' | 'percent' | 'rmb' | 'currencySymbol' | 'number'),
     (('mm' | 'cm' | 'm' | 'in' | 'ft-us' | 'ft' | 'mi' | 'mm2' | 'cm2' | 'm2' | 'ha' | 'km2' | 'in2' | 'ft2' | 'ac' | 'mi2' | 'mcg' | 'mg' | 'g' | 'kg' | 'oz' | 'lb' | 'mt' | 't' | 'mm3' | 'cm3' | 'ml' | 'l' | 'kl' | 'm3' | 'km3' | 'tsp' | 'Tbs' | 'in3' | 'fl-oz' | 'cup' | 'pnt' | 'qt' | 'gal' | 'ft3' | 'yd3' | 'mm3/s' | 'cm3/s' | 'ml/s' | 'cl/s' | 'dl/s' | 'l/s' | 'l/min' | 'l/h' | 'kl/s' | 'kl/min' | 'kl/h' | 'm3/s' | 'm3/min' | 'm3/h' | 'km3/s' | 'tsp/s' | 'Tbs/s' | 'in3/s' | 'in3/min' | 'in3/h' | 'fl-oz/s' | 'fl-oz/min' | 'fl-oz/h' | 'cup/s' | 'pnt/s' | 'pnt/min' | 'pnt/h' | 'qt/s' | 'gal/s' | 'gal/min' | 'gal/h' | 'ft3/s' | 'ft3/min' | 'ft3/h' | 'yd3/s' | 'yd3/min' | 'yd3/h' | 'C' | 'F' | 'K' | 'R' | 'ns' | 'μs' | 'ms' | 's' | 'min' | 'h' | 'd' | 'week' | 'month' | 'year' | 'Hz' | 'mHz' | 'kHz' | 'MHz' | 'GHz' | 'THz' | 'rpm' | 'deg/s' | 'rad/s' | 'm/s' | 'km/h' | 'm/h' | 'knot' | 'ft/s' | 's/m' | 'min/km' | 's/ft' | 'Pa' | 'hPa' | 'kPa' | 'MPa' | 'bar' | 'torr' | 'psi' | 'ksi' | 'b' | 'Kb' | 'Mb' | 'Gb' | 'Tb' | 'B' | 'KB' | 'MB' | 'GB' | 'TB' | 'lx' | 'ft-cd' | 'ppm' | 'ppb' | 'ppt' | 'ppq' | 'V' | 'mV' | 'kV' | 'A' | 'mA' | 'kA' | 'W' | 'mW' | 'kW' | 'MW' | 'GW' | 'VA' | 'mVA' | 'kVA' | 'MVA' | 'GVA' | 'VAR' | 'mVAR' | 'kVAR' | 'MVAR' | 'GVAR' | 'Wh' | 'mWh' | 'kWh' | 'MWh' | 'GWh' | 'J' | 'kJ' | 'VARh' | 'mVARh' | 'kVARh' | 'MVARh' | 'GVARh' | 'deg' | 'rad' | 'grad' | 'arcmin' | 'arcsec') | string)
 ];
 /**
  * 图表单位数据配置
- *
- * @minItems 2
- * @maxItems 2
  */
-export type ChartUnitItemsSettings1 = [
-    ('custom' | 'length' | 'area' | 'mass' | 'volume' | 'each' | 'temperature' | 'time' | 'digital' | 'diitalUnit' | 'partsPer' | 'speed' | 'pace' | 'pressure' | 'current' | 'voltage' | 'power' | 'reactivePower' | 'apparentPower' | 'energy' | 'reactiveEnergy' | 'volumeFlowRate' | 'illuminance' | 'frequency' | 'angle' | 'throughput' | 'percent' | 'rmb' | 'currencySymbol'),
+export type ChartUnitItemsSettings1 = [] | [
+    ('custom' | 'length' | 'area' | 'mass' | 'volume' | 'each' | 'temperature' | 'time' | 'timeStamp' | 'digital' | 'diitalUnit' | 'partsPer' | 'speed' | 'pace' | 'pressure' | 'current' | 'voltage' | 'power' | 'reactivePower' | 'apparentPower' | 'energy' | 'reactiveEnergy' | 'volumeFlowRate' | 'illuminance' | 'frequency' | 'angle' | 'traffic' | 'bandWidth' | 'throughput' | 'percent' | 'rmb' | 'currencySymbol' | 'number'),
     (('mm' | 'cm' | 'm' | 'in' | 'ft-us' | 'ft' | 'mi' | 'mm2' | 'cm2' | 'm2' | 'ha' | 'km2' | 'in2' | 'ft2' | 'ac' | 'mi2' | 'mcg' | 'mg' | 'g' | 'kg' | 'oz' | 'lb' | 'mt' | 't' | 'mm3' | 'cm3' | 'ml' | 'l' | 'kl' | 'm3' | 'km3' | 'tsp' | 'Tbs' | 'in3' | 'fl-oz' | 'cup' | 'pnt' | 'qt' | 'gal' | 'ft3' | 'yd3' | 'mm3/s' | 'cm3/s' | 'ml/s' | 'cl/s' | 'dl/s' | 'l/s' | 'l/min' | 'l/h' | 'kl/s' | 'kl/min' | 'kl/h' | 'm3/s' | 'm3/min' | 'm3/h' | 'km3/s' | 'tsp/s' | 'Tbs/s' | 'in3/s' | 'in3/min' | 'in3/h' | 'fl-oz/s' | 'fl-oz/min' | 'fl-oz/h' | 'cup/s' | 'pnt/s' | 'pnt/min' | 'pnt/h' | 'qt/s' | 'gal/s' | 'gal/min' | 'gal/h' | 'ft3/s' | 'ft3/min' | 'ft3/h' | 'yd3/s' | 'yd3/min' | 'yd3/h' | 'C' | 'F' | 'K' | 'R' | 'ns' | 'μs' | 'ms' | 's' | 'min' | 'h' | 'd' | 'week' | 'month' | 'year' | 'Hz' | 'mHz' | 'kHz' | 'MHz' | 'GHz' | 'THz' | 'rpm' | 'deg/s' | 'rad/s' | 'm/s' | 'km/h' | 'm/h' | 'knot' | 'ft/s' | 's/m' | 'min/km' | 's/ft' | 'Pa' | 'hPa' | 'kPa' | 'MPa' | 'bar' | 'torr' | 'psi' | 'ksi' | 'b' | 'Kb' | 'Mb' | 'Gb' | 'Tb' | 'B' | 'KB' | 'MB' | 'GB' | 'TB' | 'lx' | 'ft-cd' | 'ppm' | 'ppb' | 'ppt' | 'ppq' | 'V' | 'mV' | 'kV' | 'A' | 'mA' | 'kA' | 'W' | 'mW' | 'kW' | 'MW' | 'GW' | 'VA' | 'mVA' | 'kVA' | 'MVA' | 'GVA' | 'VAR' | 'mVAR' | 'kVAR' | 'MVAR' | 'GVAR' | 'Wh' | 'mWh' | 'kWh' | 'MWh' | 'GWh' | 'J' | 'kJ' | 'VARh' | 'mVARh' | 'kVARh' | 'MVARh' | 'GVARh' | 'deg' | 'rad' | 'grad' | 'arcmin' | 'arcsec') | string)
 ];
 /**
@@ -236,7 +279,7 @@ export type ChartChinaMapSettings = CommonChartSettings & {
     /**
      * 区间颜色选择色系的唯一对应健
      */
-    rangeColorKey?: 'light-blue' | 'light-red' | 'dark-red' | 'dark-yellow' | 'dark-green' | 'dark-blue' | 'dark-purple' | 'light-yellow' | 'light-purple' | 'light-green';
+    rangeColorKey?: 'light-blue' | 'blue' | 'light-red' | 'dark-red' | 'dark-yellow' | 'dark-green' | 'dark-blue' | 'dark-purple' | 'light-yellow' | 'light-purple' | 'light-green';
     /**
      * 区间颜色配置
      */
@@ -277,6 +320,43 @@ export type ChartChinaMapSettings = CommonChartSettings & {
     provinceKey?: string;
     [k: string]: unknown;
 } & ChartUnitsSettings;
+/**
+ * 变化图配置信息
+ */
+export type ChartChangeSettings = CommonChartSettings & {
+    alias?: ChartAliasSettings;
+    colors?: ChartColorsSettings;
+    levels?: ChartLevelsSettings;
+    /**
+     * 变化值计算方式
+     */
+    calcType?: 'absolute' | 'relative';
+    /**
+     * 参与变化图计算的查询 code
+     */
+    queryCodes?: string[];
+    /**
+     * 颜色方案
+     */
+    colorScheme?: number;
+    /**
+     * 图例位置
+     */
+    legendPosition?: 'left' | 'right' | 'top' | 'bottom' | 'none';
+    /**
+     * 图例中是否包含基准值
+     */
+    legendIncludeBaseValue?: boolean;
+    /**
+     * 是否开启时间分片
+     */
+    isTimeInterval?: boolean;
+    [k: string]: unknown;
+} & ChartUnitsSettings;
+/**
+ * 命令图表配置信息
+ */
+export type ChartCommandSettings = CommonChartSettings & ChartUnitsSettings;
 /**
  * 漏斗图配置信息
  */
@@ -355,7 +435,7 @@ export type ChartHexgonSettings = CommonChartSettings & {
     /**
      * 区间颜色选择色系的唯一对应健
      */
-    rangeColorKey?: 'light-blue' | 'light-red' | 'dark-red' | 'dark-yellow' | 'dark-green' | 'dark-blue' | 'dark-purple' | 'light-yellow' | 'light-purple' | 'light-green';
+    rangeColorKey?: 'light-blue' | 'blue' | 'light-red' | 'dark-red' | 'dark-yellow' | 'dark-green' | 'dark-blue' | 'dark-purple' | 'light-yellow' | 'light-purple' | 'light-green';
     /**
      * 区间颜色配置
      */
@@ -472,6 +552,42 @@ export type ChartLogSettings = CommonChartSettings & {
     }[];
     [k: string]: unknown;
 } & ChartUnitsSettings;
+/**
+ * 监控器图表配置信息
+ */
+export type ChartMonitorSettings = CommonChartSettings & {
+    /**
+     * 是否开启时间分片
+     */
+    isTimeInterval?: boolean;
+    /**
+     * 监控器图显示模式，可选配置分别为全部、仅统计图、仅列表
+     */
+    showPart?: 'all' | 'statistic' | 'list';
+    /**
+     * 列表每页显示的最大记录数量
+     */
+    pageSize?: 10 | 20 | 50 | 100;
+    /**
+     * 默认固定显示的列
+     */
+    inColumns?: {
+        field?: string;
+        headerName?: string;
+        hide?: boolean;
+        [k: string]: unknown;
+    }[];
+    /**
+     * 添加显示列
+     */
+    addColumns?: {
+        field?: string;
+        headerName?: string;
+        hide?: boolean;
+        [k: string]: unknown;
+    }[];
+    [k: string]: unknown;
+} & ChartUnitsSettings;
 /**
  * 对象列表图配置信息
  */
@@ -609,9 +725,9 @@ export type ChartSequenceSettings = CommonChartSettings & {
      */
     xAxisShowType?: 'time';
     /**
-     * 主指标对应的code 名称，在时序图中固定为 A
+     * 主指标对应的code 名称
      */
-    mainMeasurementQueryCode?: 'A';
+    mainMeasurementQueryCode?: string;
     [k: string]: unknown;
 } & CommonChartGroupbySettings & ChartUnitsSettings & ChartCompare;
 /**
@@ -623,7 +739,7 @@ export type CommonChartShowLineSettings = boolean;
  */
 export type CommonChartShowLabelSettings = boolean;
 export type CommonChartConnectNullSettings = boolean;
-export type CommonChartLegendValuesSettings = ('first' | 'last' | 'avg' | 'min' | 'max' | 'sum' | 'count')[];
+export type CommonChartLegendValuesSettings = '' | ('first' | 'last' | 'avg' | 'min' | 'max' | 'sum' | 'count')[];
 /**
  * 支持图表类型枚举
  */
@@ -826,6 +942,36 @@ export type ChartToplistSettings = CommonChartSettings & {
     };
     [k: string]: unknown;
 } & ChartUnitsSettings;
+/**
+ * 视频图表配置信息
+ */
+export type ChartVideoSettings = CommonChartSettings & {
+    /**
+     * 当前音量
+     */
+    volume?: number;
+    /**
+     * 最小音量
+     */
+    minVolume?: number;
+    /**
+     * 最大音量
+     */
+    maxVolume?: number;
+    /**
+     * 是否自动播放
+     */
+    autoplay?: boolean;
+    /**
+     * 是否循环播放
+     */
+    repeatPlay?: boolean;
+    /**
+     * 是否开启时间分片
+     */
+    isTimeInterval?: boolean;
+    [k: string]: unknown;
+} & ChartUnitsSettings;
 /**
  * 矩形树图配置信息
  */
@@ -877,7 +1023,7 @@ export type ChartWorldMapSettings = CommonChartSettings & {
     /**
      * 区间颜色选择色系的唯一对应健
      */
-    rangeColorKey?: 'light-blue' | 'light-red' | 'dark-red' | 'dark-yellow' | 'dark-green' | 'dark-blue' | 'dark-purple' | 'light-yellow' | 'light-purple' | 'light-green';
+    rangeColorKey?: 'light-blue' | 'blue' | 'light-red' | 'dark-red' | 'dark-yellow' | 'dark-green' | 'dark-blue' | 'dark-purple' | 'light-yellow' | 'light-purple' | 'light-green';
     /**
      * 区间颜色配置
      */
@@ -1069,49 +1215,6 @@ export interface ChartVarsItem {
     valueSort?: 'asc' | 'desc';
     [k: string]: unknown;
 }
-/**
- * 图表完整结构
- */
-export interface ChartData {
-    extend: {
-        links?: ChartsCommonChartLinksSchemaJson;
-        settings?: ChartSettings;
-        [k: string]: unknown;
-    };
-    group?: {
-        name?: string | null;
-        [k: string]: unknown;
-    };
-    /**
-     * 图表名称
-     */
-    name: string;
-    /**
-     * 图表位置信息
-     */
-    pos: {
-        /**
-         * 图表高度,每行的高度默认为10像素,比如 h 为12, 则实际高度为 12 * 10
-         */
-        h: number;
-        /**
-         * 图表宽度,栅格系统的最大列数为 24, 比如 w为12，则显示宽度则为容器宽度的 1/2 倍
-         */
-        w: number;
-        /**
-         * 图表距离容器的水平距离,栅格系统的最大列数为 24, 比如 x为12，则图表距离容器左边的水平距离为容器宽度 1/2 倍
-         */
-        x: number;
-        /**
-         * 图表距离容器垂直距离,每行的高度默认为10像素,比如 y为12, 则实际高度为 12 * 10
-         */
-        y: number;
-        [k: string]: unknown;
-    };
-    type: ChartType1;
-    queries: ChartQueries;
-    [k: string]: unknown;
-}
 /**
  * 图表联动跳转项
  */
@@ -1142,11 +1245,11 @@ export interface ChartsCommonChartLinkItemSchemaJson {
  * 图表时间相关配置完整结构。
  */
 export interface ChartTimeSettings {
-    timeInterval?: 'auto' | '1ms' | '10ms' | '50ms' | '100ms' | '500ms' | '1s' | '10s' | '20s' | '30s' | '1m' | '5m' | '10m' | '30m' | '1h' | '6h' | '12h' | '1d' | '7d' | '30d';
+    timeInterval?: '' | ('auto' | '1ms' | '10ms' | '50ms' | '100ms' | '500ms' | '1s' | '10s' | '20s' | '30s' | '1m' | '5m' | '10m' | '30m' | '1h' | '6h' | '12h' | '1d' | '7d' | '30d');
     /**
      * 返回最大数据电枢
      */
-    maxPointCount?: number;
+    maxPointCount?: number | null;
     fixedTime?: ChartsSettingsSettingsFixedTimeSchemaJson;
     [k: string]: unknown;
 }
@@ -1157,7 +1260,7 @@ export interface ChartUnitsSettings {
     /**
      * 单位设置类型，分为全局和自定义两种类型
      */
-    unitType: 'global' | 'custom';
+    unitType?: 'global' | 'custom';
     globalUnit?: ChartUnitItemsSettings;
     /**
      * 根据指标自定义单位
@@ -1199,11 +1302,11 @@ export interface CommonGradualColorSettings {
         /**
          * 在自动模式下，可以手动设置区间范围最小值
          */
-        minVal?: number;
+        minVal?: number | null;
         /**
          * 在自动模式下，可以手动设置的区间范围最大值
          */
-        maxVal?: number;
+        maxVal?: number | null;
         /**
          * 在渐变区间发范围内，可以手动填写生成的色块数量
          */
@@ -1308,7 +1411,7 @@ export interface ChartCompare {
     /**
      * 选择的同环比类型
      */
-    compareType?: ('hourCompare' | 'dayCompare' | 'weekCompare' | 'monthCompare' | 'circleCompare')[];
+    compareType?: '' | ('hourCompare' | 'dayCompare' | 'weekCompare' | 'monthCompare' | 'circleCompare')[];
     /**
      * 选择同环比对比的详细映射信息，与 compareType 对应
      */
@@ -1360,9 +1463,9 @@ export interface ChartTopologySettings {
         /**
          * 颜色色系
          */
-        key: 'color-first' | 'color-second' | 'color-third';
-        min: number | null;
-        max: number | null;
+        key?: 'color-first' | 'color-second' | 'color-third';
+        min?: number | null;
+        max?: number | null;
         [k: string]: unknown;
     };
     [k: string]: unknown;