zinkee 0.1.19 → 0.1.21

package/.claude/settings.local.json

@@ -0,0 +1,47 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(npm test *)",
+      "Bash(npm run *)",
+      "Bash(pnpm typecheck *)",
+      "Bash(pnpm test *)",
+      "Bash(npx tsc *)",
+      "Read(//home/guillermo/dev/z2-backend/api/src/main/java/com/zinkee/api/domain/model/v2/log/**)",
+      "Read(//home/guillermo/dev/z2-backend/**)",
+      "Bash(grep *)",
+      "Bash(npx vitest *)",
+      "Bash(npx tsx *)",
+      "Bash(node dist/index.js --help)",
+      "Bash(gh repo *)",
+      "WebFetch(domain:github.com)",
+      "Bash(git config *)",
+      "Read(//home/guillermo/.config/**)",
+      "Read(//home/guillermo/**)",
+      "Bash(curl *)",
+      "Bash(node dist/index.js --show-completion zsh)",
+      "Bash(node *)",
+      "Bash(_ZINKEE_COMPLETE=zsh_complete COMP_WORDS=\"zinkee\" COMP_CWORD=1 node *)",
+      "Bash(_ZINKEE_COMPLETE=zsh_complete COMP_WORDS=\"zinkee schemas\" COMP_CWORD=2 node *)",
+      "Bash(_ZINKEE_COMPLETE=zsh_complete COMP_WORDS=\"zinkee schemas fields\" COMP_CWORD=3 node dist/index.js)",
+      "Bash(_ZINKEE_COMPLETE=zsh_complete COMP_WORDS=\"zinkee schemas fields cr\" COMP_CWORD=3 node dist/index.js)",
+      "Bash(_ZINKEE_COMPLETE=zsh_complete COMP_WORDS=\"zinkee schemas list --j\" COMP_CWORD=3 node dist/index.js)",
+      "Bash(rm -rf /tmp/zinkee-install)",
+      "Bash(mkdir -p /tmp/zinkee-install)",
+      "Bash(HOME=/tmp/zinkee-install SHELL=/bin/zsh node dist/index.js --install-completion)",
+      "Read(//tmp/**)",
+      "Read(//tmp/zinkee-install/**)",
+      "Bash(rm -rf /tmp/zinkee-install-bash)",
+      "Bash(mkdir -p /tmp/zinkee-install-bash)",
+      "Bash(HOME=/tmp/zinkee-install-bash SHELL=/bin/bash node dist/index.js --install-completion)",
+      "Bash(rm -rf /tmp/zinkee-install-fish)",
+      "Bash(mkdir -p /tmp/zinkee-install-fish)",
+      "Bash(_ZINKEE_COMPLETE=zsh_complete node dist/index.js)",
+      "Bash(echo \"exit: $?\")",
+      "Bash(_ZINKEE_COMPLETE=zsh_complete COMP_WORDS=\"zinkee schemas\" COMP_CWORD=abc node dist/index.js)",
+      "Bash(_ZINKEE_COMPLETE=zsh_complete COMP_WORDS=\"zinkee config show --foo --bar baz quux ?\" COMP_CWORD=10 node dist/index.js)",
+      "Bash(git -C /home/guillermo/dev/cli status)",
+      "Bash(git -C /home/guillermo/dev/cli branch --show-current)",
+      "Bash(git -C /home/guillermo/dev/cli diff --stat)"
+    ]
+  }
+}

package/README.md

@@ -480,17 +480,25 @@ zinkee displays layout update <display-uuid> --template freeform --freeform-layo
 }'
 ```
 
-### KPI with filters
+### Widget filters
 
-The `--filter` flag doesn't work on KPI widgets. Pass filters in `--raw`:
+Pass `--filter "<field>:<comparator>:<value>"` (repeatable) and the CLI turns it into the structured `query.filters[]` payload the API expects. Field accepts UUID or slug. Supported comparators: `eq`, `neq`, `gt`, `gte`, `lt`, `lte`, `contains`, `in` (comma-separated values), `is_empty`, `is_not_empty`.
 
 ```bash
---raw '{"query":{"filters":[{"fieldId":"<field-uuid>","operator":"EQUALS","value":"2"}]}}'
+zinkee --json displays widgets update <display-uuid> <widget-uuid> \
+  --filter "status:eq:2" \
+  --filter "amount:gte:500"
+```
+
+For comparators the parser does not cover yet (e.g. `NOT_CONTAINS`, `RANGE`) keep using `--raw`:
+
+```bash
+--raw '{"query":{"filters":[{"origin":{"fieldId":"<field>"},"comparisonOperator":"RANGE","values":["2025-01-01","2025-12-31"]}]}}'
 ```
 
 ### Slug support
 
-Slugs are resolved to UUIDs in: `--field`, `--source-schema`, `--source-field`, `--x-axis-field`, `kpi.fieldCalc`, `chart.xAxisFieldId`, `chart.yAxisSeries[].fieldCalc`, `bindings.variableMap` values.
+Slugs are resolved to UUIDs in: `--field`, `--source-schema`, `--source-field`, `--x-axis-field`, `--filter` field reference, `kpi.fieldCalc`, `chart.xAxisFieldId`, `chart.yAxisSeries[].fieldCalc`, `bindings.variableMap` values.
 
 Display UUIDs are required for `displays widgets create/update` and `displays variables create`.
 

package/dist/index.js

@@ -3387,8 +3387,38 @@ var specificExamples = {
 }`
     },
     {
-      description: "Create a bars CHART widget with a time-serie x-axis and two y-axis series.",
-      command: `zinkee --json displays widgets create 0f6f062f-1478-4df2-96a1-c495d037d260 --type CHART --name "Revenue by month" --origin-resource 2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e --layout '{"x":0,"y":0,"w":8,"h":6}' --chart-type bars --x-axis-field due-date --x-axis-date-format MONTH --x-axis-time-series --y-axis-serie '{"typeCalc":"SUM","fieldCalc":"amount","color":"#4B9CD3","axisType":"PRIMARY"}' --y-axis-serie '{"typeCalc":"COUNT","fieldCalc":"id","color":"#E57373","axisType":"SECONDARY"}' --legend '{"position":"bottom"}'`,
+      description: "Create a CHART widget with a daily time-serie x-axis.",
+      command: `zinkee --json displays widgets create 0f6f062f-1478-4df2-96a1-c495d037d260 --type CHART --name "Revenue by day" --origin-resource 2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e --layout '{"x":0,"y":0,"w":8,"h":6}' --chart-type lines --x-axis-field due-date --x-axis-date-format DATE --x-axis-time-series --y-axis-serie '{"typeCalc":"SUM","fieldCalc":"amount","color":"#4B9CD3","axisType":"PRIMARY"}' --legend '{"position":"bottom"}'`,
+      raw: `{
+  "type": "CHART",
+  "source": {
+    "originResourceId": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
+    "isOriginSubSchema": false
+  },
+  "placement": {
+    "layout": { "x": 0, "y": 0, "w": 8, "h": 6 }
+  },
+  "presentation": { "name": "Revenue by day" },
+  "chart": {
+    "chartType": "lines",
+    "xAxisFieldId": "due-date",
+    "xAxisDateFormat": "DATE",
+    "xAxisAsTimeSerie": true,
+    "yAxisSeries": [
+      {
+        "typeCalc": "SUM",
+        "fieldCalc": "amount",
+        "color": "#4B9CD3",
+        "axisType": "PRIMARY"
+      }
+    ],
+    "legend": { "position": "bottom" }
+  }
+}`
+    },
+    {
+      description: "Create a bars CHART widget with a monthly time-serie x-axis and two y-axis series.",
+      command: `zinkee --json displays widgets create 0f6f062f-1478-4df2-96a1-c495d037d260 --type CHART --name "Revenue by month" --origin-resource 2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e --layout '{"x":0,"y":0,"w":8,"h":6}' --chart-type bars --x-axis-field due-date --x-axis-date-format MONTH_YEAR --x-axis-time-series --y-axis-serie '{"typeCalc":"SUM","fieldCalc":"amount","color":"#4B9CD3","axisType":"PRIMARY"}' --y-axis-serie '{"typeCalc":"COUNT","fieldCalc":"id","color":"#E57373","axisType":"SECONDARY"}' --legend '{"position":"bottom"}'`,
       raw: `{
   "type": "CHART",
   "source": {
@@ -3402,7 +3432,7 @@ var specificExamples = {
   "chart": {
     "chartType": "bars",
     "xAxisFieldId": "due-date",
-    "xAxisDateFormat": "MONTH",
+    "xAxisDateFormat": "MONTH_YEAR",
     "xAxisAsTimeSerie": true,
     "yAxisSeries": [
       {
@@ -3420,6 +3450,66 @@ var specificExamples = {
     ],
     "legend": { "position": "bottom" }
   }
+}`
+    },
+    {
+      description: "Create a bars CHART widget with a quarterly time-serie x-axis.",
+      command: `zinkee --json displays widgets create 0f6f062f-1478-4df2-96a1-c495d037d260 --type CHART --name "Revenue by quarter" --origin-resource 2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e --layout '{"x":0,"y":0,"w":8,"h":6}' --chart-type bars --x-axis-field due-date --x-axis-date-format QUARTER_YEAR --x-axis-time-series --y-axis-serie '{"typeCalc":"SUM","fieldCalc":"amount","color":"#4B9CD3","axisType":"PRIMARY"}' --legend '{"position":"bottom"}'`,
+      raw: `{
+  "type": "CHART",
+  "source": {
+    "originResourceId": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
+    "isOriginSubSchema": false
+  },
+  "placement": {
+    "layout": { "x": 0, "y": 0, "w": 8, "h": 6 }
+  },
+  "presentation": { "name": "Revenue by quarter" },
+  "chart": {
+    "chartType": "bars",
+    "xAxisFieldId": "due-date",
+    "xAxisDateFormat": "QUARTER_YEAR",
+    "xAxisAsTimeSerie": true,
+    "yAxisSeries": [
+      {
+        "typeCalc": "SUM",
+        "fieldCalc": "amount",
+        "color": "#4B9CD3",
+        "axisType": "PRIMARY"
+      }
+    ],
+    "legend": { "position": "bottom" }
+  }
+}`
+    },
+    {
+      description: "Create a CHART widget with a yearly time-serie x-axis.",
+      command: `zinkee --json displays widgets create 0f6f062f-1478-4df2-96a1-c495d037d260 --type CHART --name "Revenue by year" --origin-resource 2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e --layout '{"x":0,"y":0,"w":8,"h":6}' --chart-type lines --x-axis-field due-date --x-axis-date-format YEAR --x-axis-time-series --y-axis-serie '{"typeCalc":"SUM","fieldCalc":"amount","color":"#4B9CD3","axisType":"PRIMARY"}' --legend '{"position":"bottom"}'`,
+      raw: `{
+  "type": "CHART",
+  "source": {
+    "originResourceId": "2eb8bdcf-6d9c-4fbb-9018-7fa8180f4c5e",
+    "isOriginSubSchema": false
+  },
+  "placement": {
+    "layout": { "x": 0, "y": 0, "w": 8, "h": 6 }
+  },
+  "presentation": { "name": "Revenue by year" },
+  "chart": {
+    "chartType": "lines",
+    "xAxisFieldId": "due-date",
+    "xAxisDateFormat": "YEAR",
+    "xAxisAsTimeSerie": true,
+    "yAxisSeries": [
+      {
+        "typeCalc": "SUM",
+        "fieldCalc": "amount",
+        "color": "#4B9CD3",
+        "axisType": "PRIMARY"
+      }
+    ],
+    "legend": { "position": "bottom" }
+  }
 }`
     },
     {
@@ -3513,29 +3603,38 @@ var specificExamples = {
 }`
     },
     {
-      description: "Add query filters that match the full comparisonOperator contract (requires --raw because --filter only accepts free-form expressions).",
-      command: `zinkee --json displays widgets update 0f6f062f-1478-4df2-96a1-c495d037d260 11111111-1111-4111-a111-111111111111 --raw '{"query":{"filters":[{"origin":{"schemaId":"contacts","fieldId":"status"},"comparisonOperator":"EQUAL","values":["2"]},{"origin":{"schemaId":"contacts","fieldId":"amount"},"comparisonOperator":"GREATER_OR_EQUAL","values":["500"]}]}}'`,
+      description: "Add query filters with --filter. The CLI parses the expression and emits the structured comparisonOperator payload the API expects.",
+      command: `zinkee --json displays widgets update 0f6f062f-1478-4df2-96a1-c495d037d260 11111111-1111-4111-a111-111111111111 --filter "status:eq:2" --filter "amount:gte:500"`,
       raw: `{
   "query": {
     "filters": [
       {
-        "origin": {
-          "schemaId": "contacts",
-          "fieldId": "status"
-        },
+        "origin": { "fieldId": "status" },
         "comparisonOperator": "EQUAL",
         "values": ["2"]
       },
       {
-        "origin": {
-          "schemaId": "contacts",
-          "fieldId": "amount"
-        },
+        "origin": { "fieldId": "amount" },
         "comparisonOperator": "GREATER_OR_EQUAL",
         "values": ["500"]
       }
     ]
   }
+}`
+    },
+    {
+      description: "Fall back to --raw for comparators the parser does not cover yet (e.g. NOT_CONTAINS, RANGE).",
+      command: `zinkee --json displays widgets update 0f6f062f-1478-4df2-96a1-c495d037d260 11111111-1111-4111-a111-111111111111 --raw '{"query":{"filters":[{"origin":{"fieldId":"due-date"},"comparisonOperator":"RANGE","values":["2025-01-01","2025-12-31"]}]}}'`,
+      raw: `{
+  "query": {
+    "filters": [
+      {
+        "origin": { "fieldId": "due-date" },
+        "comparisonOperator": "RANGE",
+        "values": ["2025-01-01", "2025-12-31"]
+      }
+    ]
+  }
 }`
     },
     {
@@ -3561,13 +3660,13 @@ var specificExamples = {
 }`
     },
     {
-      description: "Replace the chart series with weekly lines.",
-      command: `zinkee --json displays widgets update 0f6f062f-1478-4df2-96a1-c495d037d260 22222222-2222-4222-a222-222222222222 --chart-type lines --x-axis-field due-date --x-axis-date-format WEEK --x-axis-time-series --y-axis-serie '{"typeCalc":"SUM","fieldCalc":"amount","color":"#2E7D32","axisType":"PRIMARY"}'`,
+      description: "Replace the chart series with quarterly lines.",
+      command: `zinkee --json displays widgets update 0f6f062f-1478-4df2-96a1-c495d037d260 22222222-2222-4222-a222-222222222222 --chart-type lines --x-axis-field due-date --x-axis-date-format QUARTER_YEAR --x-axis-time-series --y-axis-serie '{"typeCalc":"SUM","fieldCalc":"amount","color":"#2E7D32","axisType":"PRIMARY"}'`,
       raw: `{
   "chart": {
     "chartType": "lines",
     "xAxisFieldId": "due-date",
-    "xAxisDateFormat": "WEEK",
+    "xAxisDateFormat": "QUARTER_YEAR",
     "xAxisAsTimeSerie": true,
     "yAxisSeries": [
       {
@@ -7886,6 +7985,86 @@ var DisplaysApi = class {
   }
 };
 
+// src/parsers/expressions.ts
+var supportedComparators = /* @__PURE__ */ new Set([
+  "eq",
+  "neq",
+  "gt",
+  "gte",
+  "lt",
+  "lte",
+  "contains",
+  "in",
+  "is_empty",
+  "is_not_empty"
+]);
+var noValueComparators = /* @__PURE__ */ new Set(["is_empty", "is_not_empty"]);
+function parseColonExpression(input) {
+  const parts = input.split(":");
+  if (parts.length < 2) {
+    throw new Error(`Expected a field:comparator[:value] expression, got "${input}".`);
+  }
+  const field = parts[0]?.trim();
+  const comparator = parts[1]?.trim();
+  if (!field) {
+    throw new Error(`Expected a field before ":", got "${input}".`);
+  }
+  if (!comparator) {
+    throw new Error(`Expected a comparator after "${field}:", got "${input}".`);
+  }
+  return [field, comparator, parts.slice(2).join(":").trim()];
+}
+function parseSpaceExpression(input) {
+  const parts = input.trim().split(/\s+/);
+  if (parts.length < 2) {
+    throw new Error(`Expected a field comparator expression, got "${input}".`);
+  }
+  const field = parts[0];
+  const comparator = parts[1];
+  if (!field) {
+    throw new Error(`Expected a field comparator expression, got "${input}".`);
+  }
+  if (!comparator) {
+    throw new Error(`Expected a comparator after "${field}", got "${input}".`);
+  }
+  return [field.trim(), comparator.trim(), parts.slice(2).join(" ").trim()];
+}
+function normalizeValue(comparator, rawValue) {
+  if (noValueComparators.has(comparator)) {
+    if (rawValue.length > 0) {
+      throw new Error(`Comparator "${comparator}" does not accept a value.`);
+    }
+    return null;
+  }
+  if (comparator === "in") {
+    const values = rawValue.split(",").map((value) => value.trim()).filter(Boolean);
+    if (values.length === 0) {
+      throw new Error(`Comparator "${comparator}" requires at least one value.`);
+    }
+    return values;
+  }
+  if (rawValue.length === 0) {
+    throw new Error(`Comparator "${comparator}" requires a value.`);
+  }
+  return rawValue;
+}
+function parseExpression(input) {
+  const trimmed = input.trim();
+  const [field, comparatorCandidate, rawValue] = trimmed.includes(":") && !trimmed.includes(" ") ? parseColonExpression(trimmed) : parseSpaceExpression(trimmed);
+  if (!supportedComparators.has(comparatorCandidate)) {
+    throw new Error(
+      `Unsupported comparator "${comparatorCandidate}" in expression "${input}".`
+    );
+  }
+  const comparator = comparatorCandidate;
+  return {
+    field,
+    comparator,
+    value: normalizeValue(comparator, rawValue),
+    raw: trimmed
+  };
+}
+
 // src/commands/displays.ts
 function getCommandIo4(stdout) {
   return stdout ?? process.stdout;
@@ -7950,6 +8129,37 @@ function parseUuidOrSlugSelector3(input) {
     throw new InvalidArgumentError3(message);
   }
 }
+var COMPARATOR_TO_DISPLAY_OPERATOR = {
+  eq: "EQUAL",
+  neq: "NOT_EQUAL",
+  gt: "GREATER",
+  gte: "GREATER_OR_EQUAL",
+  lt: "LESS",
+  lte: "LESS_OR_EQUAL",
+  contains: "CONTAINS",
+  in: "ANY_OF",
+  is_empty: "IS_EMPTY",
+  is_not_empty: "IS_NOT_EMPTY"
+};
+function toDisplayFilter(parsed) {
+  const values = parsed.value === null ? [] : Array.isArray(parsed.value) ? [...parsed.value] : [parsed.value];
+  return {
+    origin: { fieldId: parsed.field },
+    comparisonOperator: COMPARATOR_TO_DISPLAY_OPERATOR[parsed.comparator],
+    values
+  };
+}
+function parseFilterExpression(input) {
+  try {
+    return parseExpression(input);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Invalid filter expression.";
+    throw new InvalidArgumentError3(message);
+  }
+}
+function collectFilters(value, previous = []) {
+  return [...previous, parseFilterExpression(value)];
+}
 function readRawObject2(raw, rawFile) {
   if (raw && rawFile) {
     throw new CliError("invalid_cli_usage", 'Use either "--raw" or "--raw-file", not both.');
@@ -8016,7 +8226,7 @@ function buildVariableBody(options) {
     };
   }
   if (options.filter && options.filter.length > 0) {
-    body.filters = options.filter.map((entry) => ({ raw: entry }));
+    body.filters = options.filter.map(toDisplayFilter);
   }
   if (options.dateMode || options.dateDynamicOption || options.dateSpecific || options.dateRangeStart || options.dateRangeEnd) {
     body.date = {
@@ -8065,15 +8275,19 @@ function buildWidgetBody(options) {
       layout
     };
   }
-  if (options.field?.length || options.sort?.length || options.filter?.length) {
+  if (options.field && options.field.length > 0) {
     body.view = {
       ...typeof body.view === "object" && body.view ? body.view : {},
       fields: options.field
     };
+  }
+  const queryMerge = {};
+  if (options.sort && options.sort.length > 0) queryMerge.sorts = options.sort;
+  if (options.filter && options.filter.length > 0) queryMerge.filters = options.filter.map(toDisplayFilter);
+  if (Object.keys(queryMerge).length > 0) {
     body.query = {
       ...typeof body.query === "object" && body.query ? body.query : {},
-      sorts: options.sort,
-      filters: options.filter?.map((entry) => ({ raw: entry }))
+      ...queryMerge
     };
   }
   if (options.widgetReadOnly !== void 0 || options.hideAddButton !== void 0 || options.hideDeleteButton !== void 0 || options.hideSortButton !== void 0 || options.hideFilterButton !== void 0 || options.hideSeeButton !== void 0) {
@@ -8288,7 +8502,7 @@ function registerDisplaysCommands(program, options = {}) {
     }
     printTable([match], void 0, stdout);
   });
-  variables.command("create").description("Create variable").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).option("--type <type>").option("--name <name>").option("--allow-multiple").option("--static").option("--default <value>").option("--default-value <value>", "repeatable default value", (v, p = []) => [...p, v], []).option("--source-schema <id>").option("--source-field <id>").option("--filter <expr>", "repeatable filter", (v, p = []) => [...p, v], []).option("--date-mode <mode>").option("--date-dynamic-option <option>").option("--date-specific <iso>").option("--date-range-start <iso>").option("--date-range-end <iso>").option("--raw <json>").option("--raw-file <path>").action(async function action(display, commandOptions) {
+  variables.command("create").description("Create variable").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).option("--type <type>").option("--name <name>").option("--allow-multiple").option("--static").option("--default <value>").option("--default-value <value>", "repeatable default value", (v, p = []) => [...p, v], []).option("--source-schema <id>").option("--source-field <id>").option("--filter <expr>", "repeatable filter", collectFilters, []).option("--date-mode <mode>").option("--date-dynamic-option <option>").option("--date-specific <iso>").option("--date-range-start <iso>").option("--date-range-end <iso>").option("--raw <json>").option("--raw-file <path>").action(async function action(display, commandOptions) {
     const { api, json, readOnly } = createDisplaysApi(this, filePath);
     ensureWritable3("displays variables create", readOnly, "write");
     const data = await api.createVariable(display, buildVariableBody(commandOptions));
@@ -8298,7 +8512,7 @@ function registerDisplaysCommands(program, options = {}) {
     }
     writeLine4(stdout, `Created variable on display "${display.value}".`);
   });
-  variables.command("update").description("Update variable").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).argument("<variable>", "variable id").option("--type <type>").option("--name <name>").option("--allow-multiple").option("--static").option("--default <value>").option("--default-value <value>", "repeatable default value", (v, p = []) => [...p, v], []).option("--source-schema <id>").option("--source-field <id>").option("--filter <expr>", "repeatable filter", (v, p = []) => [...p, v], []).option("--date-mode <mode>").option("--date-dynamic-option <option>").option("--date-specific <iso>").option("--date-range-start <iso>").option("--date-range-end <iso>").option("--raw <json>").option("--raw-file <path>").action(async function action(display, variableId, commandOptions) {
+  variables.command("update").description("Update variable").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).argument("<variable>", "variable id").option("--type <type>").option("--name <name>").option("--allow-multiple").option("--static").option("--default <value>").option("--default-value <value>", "repeatable default value", (v, p = []) => [...p, v], []).option("--source-schema <id>").option("--source-field <id>").option("--filter <expr>", "repeatable filter", collectFilters, []).option("--date-mode <mode>").option("--date-dynamic-option <option>").option("--date-specific <iso>").option("--date-range-start <iso>").option("--date-range-end <iso>").option("--raw <json>").option("--raw-file <path>").action(async function action(display, variableId, commandOptions) {
     const { api, json, readOnly } = createDisplaysApi(this, filePath);
     ensureWritable3("displays variables update", readOnly, "write");
     const data = await api.updateVariable(display, variableId, buildVariableBody(commandOptions));
@@ -8338,7 +8552,7 @@ function registerDisplaysCommands(program, options = {}) {
     }
     printTable([data], void 0, stdout);
   });
-  widgets.command("create").description("Create widget").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).requiredOption("--type <type>", "widget type").option("--name <name>").option("--description <text>").option("--icon <icon>").option("--color <color>").option("--origin-resource <uuid>").option("--origin-subschema").option("--tab <tabId>").option("--slot <slotId>").option("--layout <json>").option("--layout-file <path>").option("--field <field>", "repeatable field", (v, p = []) => [...p, v], []).option("--sort <sort>", "repeatable sort", (v, p = []) => [...p, v], []).option("--filter <expr>", "repeatable filter", (v, p = []) => [...p, v], []).option("--widget-read-only").option("--hide-add-button").option("--hide-delete-button").option("--hide-sort-button").option("--hide-filter-button").option("--hide-see-button").option("--calc <type>").option("--calc-field <uuid>").option("--kpi-config <json>").option("--chart-type <type>").option("--x-axis-field <uuid>").option("--x-axis-date-format <granularity>").option("--x-axis-time-series").option("--y-axis-serie <json>", "repeatable y axis serie", (v, p = []) => [...p, v], []).option("--legend <json>").option("--raw <json>").option("--raw-file <path>").action(async function action(display, commandOptions) {
+  widgets.command("create").description("Create widget").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).requiredOption("--type <type>", "widget type").option("--name <name>").option("--description <text>").option("--icon <icon>").option("--color <color>").option("--origin-resource <uuid>").option("--origin-subschema").option("--tab <tabId>").option("--slot <slotId>").option("--layout <json>").option("--layout-file <path>").option("--field <field>", "repeatable field", (v, p = []) => [...p, v], []).option("--sort <sort>", "repeatable sort", (v, p = []) => [...p, v], []).option("--filter <expr>", "repeatable filter", collectFilters, []).option("--widget-read-only").option("--hide-add-button").option("--hide-delete-button").option("--hide-sort-button").option("--hide-filter-button").option("--hide-see-button").option("--calc <type>").option("--calc-field <uuid>").option("--kpi-config <json>").option("--chart-type <type>", "chart type (lines, bars, stackedBars, combined)").option("--x-axis-field <uuid>").option("--x-axis-date-format <granularity>", "time granularity (DATE, MONTH_YEAR, QUARTER_YEAR, YEAR)").option("--x-axis-time-series").option("--y-axis-serie <json>", "repeatable y axis serie", (v, p = []) => [...p, v], []).option("--legend <json>").option("--raw <json>").option("--raw-file <path>").action(async function action(display, commandOptions) {
     const { api, json, readOnly } = createDisplaysApi(this, filePath);
     ensureWritable3("displays widgets create", readOnly, "write");
     const data = await api.createWidget(display, buildWidgetBody(commandOptions));
@@ -8348,7 +8562,7 @@ function registerDisplaysCommands(program, options = {}) {
     }
     writeLine4(stdout, `Created widget on display "${display.value}".`);
   });
-  widgets.command("update").description("Update widget").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).argument("<widget>", "widget id").option("--type <type>").option("--name <name>").option("--description <text>").option("--icon <icon>").option("--color <color>").option("--origin-resource <uuid>").option("--origin-subschema").option("--tab <tabId>").option("--slot <slotId>").option("--layout <json>").option("--layout-file <path>").option("--field <field>", "repeatable field", (v, p = []) => [...p, v], []).option("--sort <sort>", "repeatable sort", (v, p = []) => [...p, v], []).option("--filter <expr>", "repeatable filter", (v, p = []) => [...p, v], []).option("--widget-read-only").option("--hide-add-button").option("--hide-delete-button").option("--hide-sort-button").option("--hide-filter-button").option("--hide-see-button").option("--calc <type>").option("--calc-field <uuid>").option("--kpi-config <json>").option("--chart-type <type>").option("--x-axis-field <uuid>").option("--x-axis-date-format <granularity>").option("--x-axis-time-series").option("--y-axis-serie <json>", "repeatable y axis serie", (v, p = []) => [...p, v], []).option("--legend <json>").option("--raw <json>").option("--raw-file <path>").action(async function action(display, widgetId, commandOptions) {
+  widgets.command("update").description("Update widget").argument("<display>", "display uuid or slug", parseUuidOrSlugSelector3).argument("<widget>", "widget id").option("--type <type>").option("--name <name>").option("--description <text>").option("--icon <icon>").option("--color <color>").option("--origin-resource <uuid>").option("--origin-subschema").option("--tab <tabId>").option("--slot <slotId>").option("--layout <json>").option("--layout-file <path>").option("--field <field>", "repeatable field", (v, p = []) => [...p, v], []).option("--sort <sort>", "repeatable sort", (v, p = []) => [...p, v], []).option("--filter <expr>", "repeatable filter", collectFilters, []).option("--widget-read-only").option("--hide-add-button").option("--hide-delete-button").option("--hide-sort-button").option("--hide-filter-button").option("--hide-see-button").option("--calc <type>").option("--calc-field <uuid>").option("--kpi-config <json>").option("--chart-type <type>", "chart type (lines, bars, stackedBars, combined)").option("--x-axis-field <uuid>").option("--x-axis-date-format <granularity>", "time granularity (DATE, MONTH_YEAR, QUARTER_YEAR, YEAR)").option("--x-axis-time-series").option("--y-axis-serie <json>", "repeatable y axis serie", (v, p = []) => [...p, v], []).option("--legend <json>").option("--raw <json>").option("--raw-file <path>").action(async function action(display, widgetId, commandOptions) {
     const { api, json, readOnly } = createDisplaysApi(this, filePath);
     ensureWritable3("displays widgets update", readOnly, "write");
     const data = await api.updateWidget(display, widgetId, buildWidgetBody(commandOptions));
@@ -9369,86 +9583,6 @@ var SchemasApi = class {
   }
 };
 
-// src/parsers/expressions.ts
-var supportedComparators = /* @__PURE__ */ new Set([
-  "eq",
-  "neq",
-  "gt",
-  "gte",
-  "lt",
-  "lte",
-  "contains",
-  "in",
-  "is_empty",
-  "is_not_empty"
-]);
-var noValueComparators = /* @__PURE__ */ new Set(["is_empty", "is_not_empty"]);
-function parseColonExpression(input) {
-  const parts = input.split(":");
-  if (parts.length < 2) {
-    throw new Error(`Expected a field:comparator[:value] expression, got "${input}".`);
-  }
-  const field = parts[0]?.trim();
-  const comparator = parts[1]?.trim();
-  if (!field) {
-    throw new Error(`Expected a field before ":", got "${input}".`);
-  }
-  if (!comparator) {
-    throw new Error(`Expected a comparator after "${field}:", got "${input}".`);
-  }
-  return [field, comparator, parts.slice(2).join(":").trim()];
-}
-function parseSpaceExpression(input) {
-  const parts = input.trim().split(/\s+/);
-  if (parts.length < 2) {
-    throw new Error(`Expected a field comparator expression, got "${input}".`);
-  }
-  const field = parts[0];
-  const comparator = parts[1];
-  if (!field) {
-    throw new Error(`Expected a field comparator expression, got "${input}".`);
-  }
-  if (!comparator) {
-    throw new Error(`Expected a comparator after "${field}", got "${input}".`);
-  }
-  return [field.trim(), comparator.trim(), parts.slice(2).join(" ").trim()];
-}
-function normalizeValue(comparator, rawValue) {
-  if (noValueComparators.has(comparator)) {
-    if (rawValue.length > 0) {
-      throw new Error(`Comparator "${comparator}" does not accept a value.`);
-    }
-    return null;
-  }
-  if (comparator === "in") {
-    const values = rawValue.split(",").map((value) => value.trim()).filter(Boolean);
-    if (values.length === 0) {
-      throw new Error(`Comparator "${comparator}" requires at least one value.`);
-    }
-    return values;
-  }
-  if (rawValue.length === 0) {
-    throw new Error(`Comparator "${comparator}" requires a value.`);
-  }
-  return rawValue;
-}
-function parseExpression(input) {
-  const trimmed = input.trim();
-  const [field, comparatorCandidate, rawValue] = trimmed.includes(":") && !trimmed.includes(" ") ? parseColonExpression(trimmed) : parseSpaceExpression(trimmed);
-  if (!supportedComparators.has(comparatorCandidate)) {
-    throw new Error(
-      `Unsupported comparator "${comparatorCandidate}" in expression "${input}".`
-    );
-  }
-  const comparator = comparatorCandidate;
-  return {
-    field,
-    comparator,
-    value: normalizeValue(comparator, rawValue),
-    raw: trimmed
-  };
-}
-
 // src/commands/records.ts
 function getCommandIo9(stdout) {
   return stdout ?? process.stdout;