@flanksource/clicky-ui 0.3.21 → 0.3.23

package/dist/rpc/formMetadata.cjs

@@ -2,10 +2,14 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const react = require("react");
 const dataTableFilterValues = require("../data/data-table-filter-values.cjs");
+const filterShapes = require("./filterShapes.cjs");
 const types = require("./types.cjs");
 function truncationProps(filter) {
   if (!filter.truncated) return {};
-  return { truncated: true, ...filter.total !== void 0 ? { total: filter.total } : {} };
+  return {
+    truncated: true,
+    ...filter.total !== void 0 ? { total: filter.total } : {}
+  };
 }
 function searchProps(filter, key, search) {
   if (!filter.truncated) return {};
@@ -37,7 +41,10 @@ function defaultValueForParameter(param, method) {
 }
 function buildInitialParameterValues(parameters, method, lockedValues = {}, initialValues = {}) {
   const values = Object.fromEntries(
-    parameters.map((param) => [param.name, defaultValueForParameter(param, method)])
+    parameters.map((param) => [
+      param.name,
+      defaultValueForParameter(param, method)
+    ])
   );
   return { ...values, ...initialValues, ...lockedValues };
 }
@@ -45,8 +52,8 @@ const OFFSET_DEPTH_LIMIT = 1e4;
 function dataTablePaginationFromForm(pagination, response) {
   var _a, _b;
   if (!pagination) return void 0;
-  const pageSize = positiveInt(pagination.limitValue) ?? ((_a = response == null ? void 0 : response.pagination) == null ? void 0 : _a.limit) ?? 25;
-  const offset = nonNegativeInt(pagination.offsetValue) ?? ((_b = response == null ? void 0 : response.pagination) == null ? void 0 : _b.offset) ?? 0;
+  const pageSize = ((_a = response == null ? void 0 : response.pagination) == null ? void 0 : _a.limit) ?? positiveInt(pagination.limitValue) ?? 25;
+  const offset = ((_b = response == null ? void 0 : response.pagination) == null ? void 0 : _b.offset) ?? nonNegativeInt(pagination.offsetValue) ?? 0;
   const page = Math.floor(offset / pageSize);
   const served = response == null ? void 0 : response.pagination;
   const setCursor = pagination.setCursor;
@@ -65,7 +72,7 @@ function dataTablePaginationFromForm(pagination, response) {
     // continues, and a shallow page keeps its jump controls until the next one
     // would cross OFFSET_DEPTH_LIMIT — the point past which the offset would be
     // refused anyway.
-    ...setCursor && (pagination.cursorValue || (served == null ? void 0 : served.nextCursor) && offset + pageSize >= OFFSET_DEPTH_LIMIT) ? {
+    ...setCursor && (pagination.cursorValue || (served == null ? void 0 : served.nextCursor) && (!setOffset || offset + pageSize >= OFFSET_DEPTH_LIMIT)) ? {
       cursor: {
         ...pagination.cursorValue ? { current: pagination.cursorValue } : {},
         ...(served == null ? void 0 : served.nextCursor) ? { next: served.nextCursor } : {},
@@ -95,32 +102,46 @@ function dataTablePaginationFromForm(pagination, response) {
   };
 }
 function pruneParameterValues(values) {
-  return Object.fromEntries(Object.entries(values).filter(([, value]) => value !== ""));
+  return Object.fromEntries(
+    Object.entries(values).filter(([, value]) => value !== "")
+  );
 }
 function packParameterValues(values, parameters) {
-  const positionalNames = new Set(
-    parameters.filter((param) => param.in !== "path" && types.isPositionalParam(param)).map((p) => p.name)
-  );
   const params = {};
   const args = [];
-  for (const [key, value] of Object.entries(values)) {
+  for (const parameter of parameters) {
+    const value = values[parameter.name];
     if (!value) continue;
-    if (positionalNames.has(key)) {
+    if (parameter.in !== "path" && types.isPositionalParam(parameter)) {
       args.push(value);
     } else {
-      params[key] = value;
+      params[parameter.name] = value;
     }
   }
   if (args.length > 0) {
-    params.args = args.join(",");
+    params.args = args;
   }
   return params;
 }
+function packLookupParameterValues(values, parameters) {
+  return packParameterValues(
+    values,
+    parameters.filter(
+      (parameter) => {
+        var _a, _b, _c, _d, _e;
+        return ((_a = parameter["x-clicky"]) == null ? void 0 : _a.role) !== "limit" && ((_b = parameter["x-clicky"]) == null ? void 0 : _b.role) !== "offset" && ((_c = parameter["x-clicky"]) == null ? void 0 : _c.role) !== "cursor" && ((_d = parameter["x-clicky"]) == null ? void 0 : _d.role) !== "sort" && ((_e = parameter["x-clicky"]) == null ? void 0 : _e.role) !== "order";
+      }
+    )
+  );
+}
 function parametersToFormConfig(parameters, values, setValues, options = {}) {
-  var _a, _b, _c;
+  var _a, _b, _c, _d, _e, _f;
   const emitFilters = [];
   const lookupFilters = ((_a = options.lookup) == null ? void 0 : _a.filters) ?? {};
-  const includeLocations = new Set(options.includeLocations ?? ["path", "query", "header"]);
+  const shapes = filterShapes.filterShapesByName(parameters, options.components);
+  const includeLocations = new Set(
+    options.includeLocations ?? ["path", "query", "header"]
+  );
   const lockedValues = options.lockedValues ?? {};
   const hideLocked = options.hideLocked ?? false;
   const limitParam = parameters.find((p) => {
@@ -135,10 +156,23 @@ function parametersToFormConfig(parameters, values, setValues, options = {}) {
     var _a2;
     return ((_a2 = p["x-clicky"]) == null ? void 0 : _a2.role) === "cursor";
   });
+  const sortParam = parameters.find((p) => {
+    var _a2;
+    return ((_a2 = p["x-clicky"]) == null ? void 0 : _a2.role) === "sort";
+  });
+  const orderParam = parameters.find((p) => {
+    var _a2;
+    return ((_a2 = p["x-clicky"]) == null ? void 0 : _a2.role) === "order";
+  });
+  if (sortParam == null !== (orderParam == null)) {
+    throw new Error("Server sorting requires both sort and order parameters");
+  }
   const paginationOmitNames = /* @__PURE__ */ new Set();
   if (limitParam) paginationOmitNames.add(limitParam.name);
   if (offsetParam) paginationOmitNames.add(offsetParam.name);
   if (cursorParam) paginationOmitNames.add(cursorParam.name);
+  if (sortParam) paginationOmitNames.add(sortParam.name);
+  if (orderParam) paginationOmitNames.add(orderParam.name);
   const searchParam = parameters.find(
     (p) => {
       var _a2;
@@ -152,26 +186,28 @@ function parametersToFormConfig(parameters, values, setValues, options = {}) {
     ...offsetParam ? { [offsetParam.name]: "0" } : {},
     ...cursorParam ? { [cursorParam.name]: "" } : {}
   });
-  const roleRangeStart = parameters.find((p) => {
-    var _a2;
-    return ((_a2 = p["x-clicky"]) == null ? void 0 : _a2.role) === "time-from";
-  });
-  const roleRangeEnd = parameters.find((p) => {
-    var _a2;
-    return ((_a2 = p["x-clicky"]) == null ? void 0 : _a2.role) === "time-to";
-  });
-  const rangeStart = roleRangeStart ?? parameters.find(
-    (param) => {
+  const roleRangeStart = parameters.find(
+    (p) => {
       var _a2;
-      return includeLocations.has(param.in) && param.in === "query" && ((_a2 = lookupFilters[param.name]) == null ? void 0 : _a2.type) === "from";
+      return ((_a2 = p["x-clicky"]) == null ? void 0 : _a2.role) === "time-from";
     }
   );
-  const rangeEnd = roleRangeEnd ?? parameters.find(
-    (param) => {
+  const roleRangeEnd = parameters.find(
+    (p) => {
       var _a2;
-      return includeLocations.has(param.in) && param.in === "query" && ((_a2 = lookupFilters[param.name]) == null ? void 0 : _a2.type) === "to";
+      return ((_a2 = p["x-clicky"]) == null ? void 0 : _a2.role) === "time-to";
     }
   );
+  const edgeType = (param) => {
+    var _a2, _b2;
+    return ((_a2 = shapes.get(param.name)) == null ? void 0 : _a2.type) ?? ((_b2 = lookupFilters[param.name]) == null ? void 0 : _b2.type);
+  };
+  const rangeStart = roleRangeStart ?? parameters.find(
+    (param) => includeLocations.has(param.in) && param.in === "query" && edgeType(param) === "from"
+  );
+  const rangeEnd = roleRangeEnd ?? parameters.find(
+    (param) => includeLocations.has(param.in) && param.in === "query" && edgeType(param) === "to"
+  );
   const hasTimeRange = rangeStart != null && rangeEnd != null;
   for (const param of parameters) {
     if (!includeLocations.has(param.in)) continue;
@@ -179,10 +215,14 @@ function parametersToFormConfig(parameters, values, setValues, options = {}) {
     if (hasTimeRange && (param.name === (rangeStart == null ? void 0 : rangeStart.name) || param.name === (rangeEnd == null ? void 0 : rangeEnd.name))) {
       continue;
     }
-    const disabled = Object.prototype.hasOwnProperty.call(lockedValues, param.name);
+    const disabled = Object.prototype.hasOwnProperty.call(
+      lockedValues,
+      param.name
+    );
     if (disabled && hideLocked) continue;
     const value = disabled ? lockedValues[param.name] ?? "" : values[param.name] ?? "";
-    const label = ((_b = lookupFilters[param.name]) == null ? void 0 : _b.label) ?? titleCase(param.name);
+    const shape = shapes.get(param.name);
+    const label = (shape == null ? void 0 : shape.label) ?? ((_b = lookupFilters[param.name]) == null ? void 0 : _b.label) ?? titleCase(param.name);
     const placeholder = types.parameterPlaceholder(param);
     const placeholderProp = placeholder !== void 0 ? { placeholder } : {};
     const onChange = (next) => {
@@ -192,8 +232,65 @@ function parametersToFormConfig(parameters, values, setValues, options = {}) {
     };
     const schema = param.schema;
     const lookupFilter = lookupFilters[param.name];
-    if ((lookupFilter == null ? void 0 : lookupFilter.type) === "date-range" && param.in === "query") {
-      const bounds = dataTableFilterValues.parseBoundsValue(value);
+    const filterType = (shape == null ? void 0 : shape.type) ?? (lookupFilter == null ? void 0 : lookupFilter.type);
+    if (filterType === "workload" && param.in === "query") {
+      emitFilters.push({
+        key: param.name,
+        kind: "workload",
+        label,
+        value,
+        disabled,
+        kinds: ["pod", "deployment", "statefulset", "daemonset"],
+        loadWorkloads: async (kinds) => lookupFilter ? workloadsFromLookup(lookupFilter, kinds) : {},
+        // A server-generated workload filter is scoped by the operation itself,
+        // so a lookup returning one workload means the scope already picked it.
+        collapseSingleOption: true,
+        onChange: (next) => onChange(next)
+      });
+      continue;
+    }
+    if (filterType === "labels" && param.in === "query") {
+      const fieldOptions = lookupFilter ? lookupOptionsToFieldOptions(lookupFilter) : [];
+      const selection = dataTableFilterValues.parseMultiFilterValue(value);
+      const grouped = fieldOptions.some((option) => option.value.includes("=")) || Object.keys(selection).some((selected) => selected.includes("="));
+      if (grouped) {
+        emitFilters.push({
+          key: param.name,
+          kind: "nested-multi",
+          label,
+          value: selection,
+          disabled,
+          groups: labelOptionGroups(fieldOptions),
+          onChange: (next) => setValues(
+            (current) => rewind({
+              ...current,
+              [param.name]: dataTableFilterValues.serializeMultiFilterValue(next)
+            })
+          )
+        });
+      } else {
+        emitFilters.push({
+          key: param.name,
+          kind: "multi",
+          label,
+          value: selection,
+          disabled,
+          options: fieldOptions,
+          ...lookupFilter ? searchProps(lookupFilter, param.name, options.lookupSearch) : {},
+          onChange: (next) => setValues(
+            (current) => rewind({
+              ...current,
+              [param.name]: dataTableFilterValues.serializeMultiFilterValue(next)
+            })
+          )
+        });
+      }
+      continue;
+    }
+    if ((filterType === "date-range" || filterType === "day-range") && param.in === "query") {
+      const bounds = dataTableFilterValues.parseBoundsValue(
+        value || String(((_c = param.schema) == null ? void 0 : _c.default) ?? "")
+      );
       emitFilters.push({
         key: param.name,
         kind: "date-range",
@@ -201,20 +298,23 @@ function parametersToFormConfig(parameters, values, setValues, options = {}) {
         disabled,
         ...bounds.min !== void 0 ? { from: bounds.min } : {},
         ...bounds.max !== void 0 ? { to: bounds.max } : {},
-        ...lookupFilter.presets ? { presets: lookupFilter.presets } : {},
-        timeEnabled: lookupFilter.timeEnabled ?? true,
-        ...lookupFilter.timeZone ? { timeZone: lookupFilter.timeZone } : {},
-        ...lookupFilter.timeZones ? { timeZones: lookupFilter.timeZones } : {},
+        ...(lookupFilter == null ? void 0 : lookupFilter.presets) ? { presets: lookupFilter.presets } : {},
+        timeEnabled: filterType === "day-range" ? false : (lookupFilter == null ? void 0 : lookupFilter.timeEnabled) ?? true,
+        ...(lookupFilter == null ? void 0 : lookupFilter.timeZone) ? { timeZone: lookupFilter.timeZone } : {},
+        ...(lookupFilter == null ? void 0 : lookupFilter.timeZones) ? { timeZones: lookupFilter.timeZones } : {},
         onApply: (from, to) => {
           if (disabled) return;
           setValues(
-            (current) => rewind({ ...current, [param.name]: dataTableFilterValues.serializeBoundsValue({ min: from, max: to }) })
+            (current) => rewind({
+              ...current,
+              [param.name]: dataTableFilterValues.serializeBoundsValue({ min: from, max: to })
+            })
           );
         }
       });
       continue;
     }
-    if ((lookupFilter == null ? void 0 : lookupFilter.type) === "value" && param.in === "query") {
+    if (filterType === "value" && param.in === "query") {
       emitFilters.push({
         key: param.name,
         kind: "text",
@@ -226,17 +326,20 @@ function parametersToFormConfig(parameters, values, setValues, options = {}) {
       });
       continue;
     }
-    if ((lookupFilter == null ? void 0 : lookupFilter.type) === "multi-filter" && param.in === "query") {
+    if (filterType === "multi-filter" && param.in === "query") {
       emitFilters.push({
         key: param.name,
         kind: "multi",
         label,
         value: dataTableFilterValues.parseMultiFilterValue(value),
         disabled,
-        options: lookupOptionsToFieldOptions(lookupFilter),
-        ...searchProps(lookupFilter, param.name, options.lookupSearch),
+        options: lookupFilter ? lookupOptionsToFieldOptions(lookupFilter) : [],
+        ...lookupFilter ? searchProps(lookupFilter, param.name, options.lookupSearch) : {},
         onChange: (next) => setValues(
-          (current) => rewind({ ...current, [param.name]: dataTableFilterValues.serializeMultiFilterValue(next) })
+          (current) => rewind({
+            ...current,
+            [param.name]: dataTableFilterValues.serializeMultiFilterValue(next)
+          })
         )
       });
       continue;
@@ -256,7 +359,7 @@ function parametersToFormConfig(parameters, values, setValues, options = {}) {
       });
       continue;
     }
-    if ((lookupFilter == null ? void 0 : lookupFilter.type) === "bool" || (schema == null ? void 0 : schema.type) === "boolean") {
+    if (filterType === "bool" || (schema == null ? void 0 : schema.type) === "boolean") {
       emitFilters.push({
         key: param.name,
         kind: "boolean",
@@ -267,21 +370,23 @@ function parametersToFormConfig(parameters, values, setValues, options = {}) {
       });
       continue;
     }
-    if (lookupFilter != null && param.in === "query") {
-      if (lookupFilter.multi) {
+    if ((shape != null || lookupFilter != null) && param.in === "query") {
+      if ((shape == null ? void 0 : shape.multi) ?? (lookupFilter == null ? void 0 : lookupFilter.multi)) {
         emitFilters.push({
           key: param.name,
           kind: "lookup-multi",
           label,
           value: dataTableFilterValues.splitCommaValues(value),
           disabled,
-          options: lookupOptionsToFieldOptions(lookupFilter),
+          options: lookupFilter ? lookupOptionsToFieldOptions(lookupFilter) : [],
           // Reported, not searched: this control's onSearch hands the query back
           // to the consumer to refetch and re-feed `options`, which is a
           // different contract from the one searchProps satisfies.
-          ...truncationProps(lookupFilter),
+          ...lookupFilter ? truncationProps(lookupFilter) : {},
           ...placeholderProp,
-          onChange: (next) => setValues((current) => rewind({ ...current, [param.name]: next.join(",") }))
+          onChange: (next) => setValues(
+            (current) => rewind({ ...current, [param.name]: next.join(",") })
+          )
         });
         continue;
       }
@@ -291,9 +396,9 @@ function parametersToFormConfig(parameters, values, setValues, options = {}) {
         label,
         value,
         disabled,
-        options: lookupOptionsToFieldOptions(lookupFilter),
+        options: lookupFilter ? lookupOptionsToFieldOptions(lookupFilter) : [],
         ...placeholderProp,
-        inputType: lookupFilter.type === "number" ? "number" : lookupFilter.type === "date" ? "date" : "text",
+        inputType: filterType === "number" ? "number" : filterType === "date" ? "date" : "text",
         onChange: (next) => onChange(next)
       });
       continue;
@@ -309,18 +414,44 @@ function parametersToFormConfig(parameters, values, setValues, options = {}) {
     });
   }
   const config = { filters: emitFilters };
+  if (sortParam && orderParam) {
+    const key = values[sortParam.name] ?? "";
+    const direction = values[orderParam.name] || "asc";
+    if (direction !== "asc" && direction !== "desc") {
+      throw new Error(`Unsupported server sort direction ${direction}`);
+    }
+    config.sort = {
+      value: key ? { key, dir: direction } : null,
+      onChange: (next) => setValues((current) => {
+        const updated = { ...current };
+        if (next) {
+          updated[sortParam.name] = next.key;
+          updated[orderParam.name] = next.dir;
+        } else {
+          delete updated[sortParam.name];
+          delete updated[orderParam.name];
+        }
+        return rewind(updated);
+      })
+    };
+  }
   if (searchParam) {
-    const searchDisabled = Object.prototype.hasOwnProperty.call(lockedValues, searchParam.name);
+    const searchDisabled = Object.prototype.hasOwnProperty.call(
+      lockedValues,
+      searchParam.name
+    );
     const searchValue = searchDisabled ? lockedValues[searchParam.name] ?? "" : values[searchParam.name] ?? "";
     const searchPlaceholder = types.parameterPlaceholder(searchParam);
     config.search = {
       value: searchValue,
       onChange: (next) => {
         if (searchDisabled) return;
-        setValues((current) => rewind({ ...current, [searchParam.name]: next }));
+        setValues(
+          (current) => rewind({ ...current, [searchParam.name]: next })
+        );
       },
       ...searchPlaceholder ? { placeholder: searchPlaceholder } : {},
-      ariaLabel: ((_c = lookupFilters[searchParam.name]) == null ? void 0 : _c.label) ?? titleCase(searchParam.name)
+      ariaLabel: ((_d = lookupFilters[searchParam.name]) == null ? void 0 : _d.label) ?? titleCase(searchParam.name)
     };
   }
   if (limitParam) {
@@ -331,12 +462,18 @@ function parametersToFormConfig(parameters, values, setValues, options = {}) {
       ...offsetParam ? {
         offsetParam: offsetParam.name,
         offsetValue: values[offsetParam.name] ?? "",
-        setOffset: (next) => setValues((current) => ({ ...current, [offsetParam.name]: next }))
+        setOffset: (next) => setValues((current) => ({
+          ...current,
+          [offsetParam.name]: next
+        }))
       } : {},
       ...cursorParam ? {
         cursorParam: cursorParam.name,
         cursorValue: values[cursorParam.name] ?? "",
-        setCursor: (next) => setValues((current) => ({ ...current, [cursorParam.name]: next }))
+        setCursor: (next) => setValues((current) => ({
+          ...current,
+          [cursorParam.name]: next
+        }))
       } : {}
     };
   }
@@ -344,6 +481,7 @@ function parametersToFormConfig(parameters, values, setValues, options = {}) {
     const rangeStartMeta = lookupFilters[rangeStart.name];
     const rangeEndMeta = lookupFilters[rangeEnd.name];
     const rangeMeta = rangeStartMeta ?? rangeEndMeta;
+    const explicitTimeEnabled = (rangeStartMeta == null ? void 0 : rangeStartMeta.timeEnabled) ?? (rangeEndMeta == null ? void 0 : rangeEndMeta.timeEnabled);
     config.timeRange = {
       from: values[rangeStart.name] ?? "",
       to: values[rangeEnd.name] ?? "",
@@ -351,7 +489,7 @@ function parametersToFormConfig(parameters, values, setValues, options = {}) {
         (current) => rewind({ ...current, [rangeStart.name]: from, [rangeEnd.name]: to })
       ),
       ...(rangeMeta == null ? void 0 : rangeMeta.presets) ? { presets: rangeMeta.presets } : {},
-      timeEnabled: (rangeMeta == null ? void 0 : rangeMeta.timeEnabled) ?? false,
+      timeEnabled: explicitTimeEnabled ?? (((_e = rangeStart.schema) == null ? void 0 : _e.format) === "date-time" || ((_f = rangeEnd.schema) == null ? void 0 : _f.format) === "date-time"),
       ...(rangeMeta == null ? void 0 : rangeMeta.timeZone) ? { timeZone: rangeMeta.timeZone } : {},
       ...(rangeMeta == null ? void 0 : rangeMeta.timeZones) ? { timeZones: rangeMeta.timeZones } : {},
       ...rangeStart.description ? { fromPlaceholder: rangeStart.description } : {},
@@ -398,6 +536,38 @@ function lookupOptionsToFieldOptions(filter) {
     title: meta.title ?? value
   }));
 }
+function workloadsFromLookup(filter, kinds) {
+  var _a, _b;
+  const requested = new Set(kinds);
+  const result = {};
+  for (const kind of kinds) result[kind] = [];
+  for (const option of lookupOptionsToFieldOptions(filter)) {
+    const parts = option.value.split("/");
+    const name = parts.at(-1);
+    const providerKind = (_a = parts.at(-2)) == null ? void 0 : _a.toLowerCase();
+    const namespace = parts.length > 2 ? parts.slice(0, -2).join("/") : void 0;
+    if (!name || !providerKind || !requested.has(providerKind)) continue;
+    (_b = result[providerKind]) == null ? void 0 : _b.push({ name, ...namespace ? { namespace } : {} });
+  }
+  return result;
+}
+function labelOptionGroups(options) {
+  const grouped = /* @__PURE__ */ new Map();
+  for (const option of options) {
+    const separator = option.value.indexOf("=");
+    if (separator <= 0) continue;
+    const key = option.value.slice(0, separator);
+    const value = option.value.slice(separator + 1);
+    const values = grouped.get(key) ?? [];
+    values.push({ ...option, label: value || option.label });
+    grouped.set(key, values);
+  }
+  return Array.from(grouped, ([groupKey, groupOptions]) => ({
+    groupKey,
+    label: groupKey,
+    options: groupOptions
+  }));
+}
 function clickyNodeToPlainText(node) {
   if (node == null) return "";
   if (node.plain) return node.plain;
@@ -409,6 +579,7 @@ exports.buildInitialParameterValues = buildInitialParameterValues;
 exports.dataTablePaginationFromForm = dataTablePaginationFromForm;
 exports.defaultValueForParameter = defaultValueForParameter;
 exports.lookupOptionsToFieldOptions = lookupOptionsToFieldOptions;
+exports.packLookupParameterValues = packLookupParameterValues;
 exports.packParameterValues = packParameterValues;
 exports.parametersToFormConfig = parametersToFormConfig;
 exports.pruneParameterValues = pruneParameterValues;