@flanksource/clicky-ui 0.2.2 → 0.2.4

package/dist/rpc/formMetadata.cjs

@@ -0,0 +1,308 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const react = require("react");
+const types = require("./types.cjs");
+function titleCase(value) {
+  return value.split(/[-_]/).filter(Boolean).map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join(" ");
+}
+function defaultValueForParameter(param, method) {
+  var _a;
+  if (method.toUpperCase() === "GET" && param.in === "query" && !param.required) {
+    return "";
+  }
+  const fallback = param.in === "path" ? "" : void 0;
+  const value = ((_a = param.schema) == null ? void 0 : _a.default) ?? fallback;
+  if (typeof value === "boolean") {
+    return value ? "true" : "false";
+  }
+  if (Array.isArray(value) || value != null && typeof value === "object") {
+    return "";
+  }
+  if (value == null) {
+    return "";
+  }
+  return String(value);
+}
+function buildInitialParameterValues(parameters, method, lockedValues = {}, initialValues = {}) {
+  const values = Object.fromEntries(
+    parameters.map((param) => [param.name, defaultValueForParameter(param, method)])
+  );
+  return { ...values, ...initialValues, ...lockedValues };
+}
+function pruneParameterValues(values) {
+  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)) {
+    if (!value) continue;
+    if (positionalNames.has(key)) {
+      args.push(value);
+    } else {
+      params[key] = value;
+    }
+  }
+  if (args.length > 0) {
+    params.args = args.join(",");
+  }
+  return params;
+}
+function parametersToFormConfig(parameters, values, setValues, options = {}) {
+  var _a, _b, _c;
+  const emitFilters = [];
+  const lookupFilters = ((_a = options.lookup) == null ? void 0 : _a.filters) ?? {};
+  const includeLocations = new Set(options.includeLocations ?? ["path", "query", "header"]);
+  const lockedValues = options.lockedValues ?? {};
+  const hideLocked = options.hideLocked ?? false;
+  const limitParam = parameters.find((p) => {
+    var _a2;
+    return ((_a2 = p["x-clicky"]) == null ? void 0 : _a2.role) === "limit";
+  });
+  const offsetParam = parameters.find((p) => {
+    var _a2;
+    return ((_a2 = p["x-clicky"]) == null ? void 0 : _a2.role) === "offset";
+  });
+  const paginationOmitNames = /* @__PURE__ */ new Set();
+  if (limitParam) paginationOmitNames.add(limitParam.name);
+  if (offsetParam) paginationOmitNames.add(offsetParam.name);
+  const searchParam = parameters.find(
+    (p) => {
+      var _a2;
+      return ((_a2 = p["x-clicky"]) == null ? void 0 : _a2.role) === "search" && includeLocations.has(p.in);
+    }
+  );
+  const omitNames = new Set(paginationOmitNames);
+  if (searchParam) omitNames.add(searchParam.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) => {
+      var _a2;
+      return includeLocations.has(param.in) && param.in === "query" && ((_a2 = lookupFilters[param.name]) == null ? void 0 : _a2.type) === "from";
+    }
+  );
+  const rangeEnd = roleRangeEnd ?? parameters.find(
+    (param) => {
+      var _a2;
+      return includeLocations.has(param.in) && param.in === "query" && ((_a2 = lookupFilters[param.name]) == null ? void 0 : _a2.type) === "to";
+    }
+  );
+  const hasTimeRange = rangeStart != null && rangeEnd != null;
+  for (const param of parameters) {
+    if (!includeLocations.has(param.in)) continue;
+    if (omitNames.has(param.name)) continue;
+    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);
+    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 onChange = (next) => {
+      if (disabled) return;
+      const stringValue = typeof next === "boolean" ? next ? "true" : "false" : next;
+      setValues((current) => ({ ...current, [param.name]: stringValue }));
+    };
+    const schema = param.schema;
+    const lookupFilter = lookupFilters[param.name];
+    if ((lookupFilter == null ? void 0 : lookupFilter.type) === "multi-filter" && param.in === "query") {
+      emitFilters.push({
+        key: param.name,
+        kind: "multi",
+        label,
+        value: parseMultiFilterValue(value),
+        disabled,
+        options: lookupOptionsToFieldOptions(lookupFilter),
+        onChange: (next) => setValues((current) => ({
+          ...current,
+          [param.name]: serializeMultiFilterValue(next)
+        }))
+      });
+      continue;
+    }
+    if (schema == null ? void 0 : schema.enum) {
+      emitFilters.push({
+        key: param.name,
+        kind: "enum",
+        label,
+        value,
+        disabled,
+        options: schema.enum.map((item) => ({
+          value: String(item),
+          label: String(item)
+        })),
+        onChange: (next) => onChange(next)
+      });
+      continue;
+    }
+    if ((lookupFilter == null ? void 0 : lookupFilter.type) === "bool" || (schema == null ? void 0 : schema.type) === "boolean") {
+      emitFilters.push({
+        key: param.name,
+        kind: "boolean",
+        label,
+        value: value === "true",
+        disabled,
+        onChange: (next) => onChange(next)
+      });
+      continue;
+    }
+    if (lookupFilter != null && param.in === "query") {
+      if (lookupFilter.multi) {
+        emitFilters.push({
+          key: param.name,
+          kind: "lookup-multi",
+          label,
+          value: splitCommaValues(value),
+          disabled,
+          options: lookupOptionsToFieldOptions(lookupFilter),
+          placeholder: param.description ?? "value-1, value-2",
+          onChange: (next) => setValues((current) => ({ ...current, [param.name]: next.join(",") }))
+        });
+        continue;
+      }
+      emitFilters.push({
+        key: param.name,
+        kind: "lookup",
+        label,
+        value,
+        disabled,
+        options: lookupOptionsToFieldOptions(lookupFilter),
+        placeholder: param.description ?? label,
+        inputType: lookupFilter.type === "number" ? "number" : lookupFilter.type === "date" ? "date" : "text",
+        onChange: (next) => onChange(next)
+      });
+      continue;
+    }
+    emitFilters.push({
+      key: param.name,
+      kind: "text",
+      label,
+      value,
+      disabled,
+      placeholder: param.description ?? label,
+      onChange: (next) => onChange(next)
+    });
+  }
+  const config = { filters: emitFilters };
+  if (searchParam) {
+    const searchDisabled = Object.prototype.hasOwnProperty.call(lockedValues, searchParam.name);
+    const searchValue = searchDisabled ? lockedValues[searchParam.name] ?? "" : values[searchParam.name] ?? "";
+    config.search = {
+      value: searchValue,
+      onChange: (next) => {
+        if (searchDisabled) return;
+        setValues((current) => ({ ...current, [searchParam.name]: next }));
+      },
+      ...searchParam.description ? { placeholder: searchParam.description } : {},
+      ariaLabel: ((_c = lookupFilters[searchParam.name]) == null ? void 0 : _c.label) ?? titleCase(searchParam.name)
+    };
+  }
+  if (limitParam && offsetParam) {
+    config.pagination = {
+      limitParam: limitParam.name,
+      offsetParam: offsetParam.name,
+      limitValue: values[limitParam.name] ?? "",
+      offsetValue: values[offsetParam.name] ?? "",
+      setLimit: (next) => setValues((current) => ({ ...current, [limitParam.name]: next })),
+      setOffset: (next) => setValues((current) => ({ ...current, [offsetParam.name]: next }))
+    };
+  }
+  if (hasTimeRange && rangeStart != null && rangeEnd != null) {
+    const rangeStartMeta = lookupFilters[rangeStart.name];
+    const rangeEndMeta = lookupFilters[rangeEnd.name];
+    const rangeMeta = rangeStartMeta ?? rangeEndMeta;
+    config.timeRange = {
+      from: values[rangeStart.name] ?? "",
+      to: values[rangeEnd.name] ?? "",
+      onApply: (from, to) => setValues((current) => ({
+        ...current,
+        [rangeStart.name]: from,
+        [rangeEnd.name]: to
+      })),
+      ...(rangeMeta == null ? void 0 : rangeMeta.presets) ? { presets: rangeMeta.presets } : {},
+      ...(rangeMeta == null ? void 0 : rangeMeta.timeEnabled) !== void 0 ? { timeEnabled: rangeMeta.timeEnabled } : {},
+      ...(rangeMeta == null ? void 0 : rangeMeta.timeZone) ? { timeZone: rangeMeta.timeZone } : {},
+      ...(rangeMeta == null ? void 0 : rangeMeta.timeZones) ? { timeZones: rangeMeta.timeZones } : {},
+      ...rangeStart.description ? { fromPlaceholder: rangeStart.description } : {},
+      ...rangeEnd.description ? { toPlaceholder: rangeEnd.description } : {}
+    };
+  }
+  return config;
+}
+function useDebouncedRecord(value, delayMs) {
+  const [debounced, setDebounced] = react.useState(value);
+  react.useEffect(() => {
+    const timeoutId = window.setTimeout(() => setDebounced(value), delayMs);
+    return () => window.clearTimeout(timeoutId);
+  }, [delayMs, value]);
+  return debounced;
+}
+function parseMultiFilterValue(value) {
+  const parsed = {};
+  for (const item of splitCommaValues(value)) {
+    if (item.startsWith("!") && item.length > 1) {
+      parsed[item.slice(1)] = "exclude";
+    } else {
+      parsed[item] = "include";
+    }
+  }
+  return parsed;
+}
+function serializeMultiFilterValue(value) {
+  return Object.entries(value).flatMap(([key, mode]) => {
+    if (mode === "include") return [key];
+    if (mode === "exclude") return [`!${key}`];
+    return [];
+  }).join(",");
+}
+function splitCommaValues(value) {
+  return value.split(",").map((item) => item.trim()).filter(Boolean);
+}
+function lookupOptionsToFieldOptions(filter) {
+  const merged = /* @__PURE__ */ new Map();
+  for (const [value, node] of Object.entries(filter.options ?? {})) {
+    merged.set(value, {
+      label: clickyNodeToPlainText(node) || value,
+      title: clickyNodeToPlainText(node) || value
+    });
+  }
+  for (const [value, node] of Object.entries(filter.selected ?? {})) {
+    if (!merged.has(value)) {
+      merged.set(value, {
+        label: clickyNodeToPlainText(node) || value,
+        title: clickyNodeToPlainText(node) || value
+      });
+    }
+  }
+  return Array.from(merged.entries()).map(([value, meta]) => ({
+    value,
+    label: meta.label ?? value,
+    title: meta.title ?? value
+  }));
+}
+function clickyNodeToPlainText(node) {
+  if (node == null) return "";
+  if (node.plain) return node.plain;
+  if (node.text) return node.text;
+  return (node.children ?? []).map((child) => clickyNodeToPlainText(child)).join("");
+}
+exports.buildInitialParameterValues = buildInitialParameterValues;
+exports.defaultValueForParameter = defaultValueForParameter;
+exports.packParameterValues = packParameterValues;
+exports.parametersToFormConfig = parametersToFormConfig;
+exports.parseMultiFilterValue = parseMultiFilterValue;
+exports.pruneParameterValues = pruneParameterValues;
+exports.serializeMultiFilterValue = serializeMultiFilterValue;
+exports.titleCase = titleCase;
+exports.useDebouncedRecord = useDebouncedRecord;
+//# sourceMappingURL=formMetadata.cjs.map

package/dist/rpc/formMetadata.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"formMetadata.cjs","sources":["../../src/rpc/formMetadata.ts"],"sourcesContent":["import { useEffect, useState, type Dispatch, type SetStateAction } from \"react\";\nimport type {\n  FilterBarFilter,\n  FilterBarMultiFilterMode,\n  FilterBarRangeProps,\n  FilterBarSearchProps,\n} from \"../components/FilterBar\";\nimport type { OpenAPIParameter, OperationLookupFilter, OperationLookupResponse } from \"./types\";\nimport { isPositionalParam } from \"./types\";\n\nexport type ParameterValues = Record<string, string>;\nexport type ParameterValuesSetter = Dispatch<SetStateAction<ParameterValues>>;\n\n// ParameterPagination plumbs limit/offset query parameters into the\n// DataTable's pagination footer. The UI exposes both as the\n// {pageSize, pageIndex} tuple but here we keep raw string limit/offset\n// values so the executor sees exactly what the operation declared.\nexport type ParameterPagination = {\n  limitParam: string; // parameter name on the operation, e.g. \"limit\"\n  offsetParam: string;\n  limitValue: string;\n  offsetValue: string;\n  setLimit: (next: string) => void;\n  setOffset: (next: string) => void;\n};\n\nexport type ParameterFormConfig = {\n  filters: FilterBarFilter[];\n  search?: FilterBarSearchProps;\n  timeRange?: FilterBarRangeProps;\n  pagination?: ParameterPagination;\n};\nexport type ParameterFormOptions = {\n  includeLocations?: OpenAPIParameter[\"in\"][];\n  lookup?: OperationLookupResponse | undefined;\n  lockedValues?: ParameterValues | undefined;\n  hideLocked?: boolean;\n};\n\nexport function titleCase(value: string) {\n  return value\n    .split(/[-_]/)\n    .filter(Boolean)\n    .map((part) => part.charAt(0).toUpperCase() + part.slice(1))\n    .join(\" \");\n}\n\nexport function defaultValueForParameter(param: OpenAPIParameter, method: string): string {\n  if (method.toUpperCase() === \"GET\" && param.in === \"query\" && !param.required) {\n    return \"\";\n  }\n  const fallback = param.in === \"path\" ? \"\" : undefined;\n  const value = param.schema?.default ?? fallback;\n  if (typeof value === \"boolean\") {\n    return value ? \"true\" : \"false\";\n  }\n  if (Array.isArray(value) || (value != null && typeof value === \"object\")) {\n    return \"\";\n  }\n  if (value == null) {\n    return \"\";\n  }\n  return String(value);\n}\n\nexport function buildInitialParameterValues(\n  parameters: OpenAPIParameter[],\n  method: string,\n  lockedValues: ParameterValues = {},\n  initialValues: ParameterValues = {},\n): ParameterValues {\n  const values = Object.fromEntries(\n    parameters.map((param) => [param.name, defaultValueForParameter(param, method)]),\n  );\n  return { ...values, ...initialValues, ...lockedValues };\n}\n\nexport function pruneParameterValues(values: ParameterValues) {\n  return Object.fromEntries(Object.entries(values).filter(([, value]) => value !== \"\"));\n}\n\nexport function packParameterValues(\n  values: ParameterValues,\n  parameters: OpenAPIParameter[],\n): ParameterValues {\n  const positionalNames = new Set(\n    parameters\n      .filter((param) => param.in !== \"path\" && isPositionalParam(param))\n      .map((p) => p.name),\n  );\n  const params: ParameterValues = {};\n  const args: string[] = [];\n\n  for (const [key, value] of Object.entries(values)) {\n    if (!value) continue;\n    if (positionalNames.has(key)) {\n      args.push(value);\n    } else {\n      params[key] = value;\n    }\n  }\n\n  if (args.length > 0) {\n    params.args = args.join(\",\");\n  }\n\n  return params;\n}\n\nexport function parametersToFormConfig(\n  parameters: OpenAPIParameter[],\n  values: ParameterValues,\n  setValues: ParameterValuesSetter,\n  options: ParameterFormOptions = {},\n): ParameterFormConfig {\n  const emitFilters: FilterBarFilter[] = [];\n  const lookupFilters = options.lookup?.filters ?? {};\n  const includeLocations = new Set(options.includeLocations ?? [\"path\", \"query\", \"header\"]);\n  const lockedValues = options.lockedValues ?? {};\n  const hideLocked = options.hideLocked ?? false;\n\n  // Pull limit/offset out of the filter loop entirely — they drive pagination,\n  // not filter pills. Roles come from server-side `paramRole` (see\n  // clicky/rpc/openapi.go); the older \"named limit on a GET\" heuristic is\n  // intentionally not duplicated here so the server stays the single source\n  // of truth for parameter classification.\n  const limitParam = parameters.find((p) => p[\"x-clicky\"]?.role === \"limit\");\n  const offsetParam = parameters.find((p) => p[\"x-clicky\"]?.role === \"offset\");\n  const paginationOmitNames = new Set<string>();\n  if (limitParam) paginationOmitNames.add(limitParam.name);\n  if (offsetParam) paginationOmitNames.add(offsetParam.name);\n\n  // The search-role param drives the FilterBar's dedicated search input rather\n  // than a filter chip; pull it out of the chip loop the same way pagination is.\n  const searchParam = parameters.find(\n    (p) => p[\"x-clicky\"]?.role === \"search\" && includeLocations.has(p.in),\n  );\n  const omitNames = new Set(paginationOmitNames);\n  if (searchParam) omitNames.add(searchParam.name);\n\n  // Time-range first looks for server-stamped roles, then falls back to the\n  // existing lookup-driven \"from\"/\"to\" detection so older specs keep working.\n  const roleRangeStart = parameters.find((p) => p[\"x-clicky\"]?.role === \"time-from\");\n  const roleRangeEnd = parameters.find((p) => p[\"x-clicky\"]?.role === \"time-to\");\n  const rangeStart =\n    roleRangeStart ??\n    parameters.find(\n      (param) =>\n        includeLocations.has(param.in) &&\n        param.in === \"query\" &&\n        lookupFilters[param.name]?.type === \"from\",\n    );\n  const rangeEnd =\n    roleRangeEnd ??\n    parameters.find(\n      (param) =>\n        includeLocations.has(param.in) &&\n        param.in === \"query\" &&\n        lookupFilters[param.name]?.type === \"to\",\n    );\n  const hasTimeRange = rangeStart != null && rangeEnd != null;\n\n  for (const param of parameters) {\n    if (!includeLocations.has(param.in)) continue;\n    if (omitNames.has(param.name)) continue;\n    if (hasTimeRange && (param.name === rangeStart?.name || param.name === rangeEnd?.name)) {\n      continue;\n    }\n\n    const disabled = Object.prototype.hasOwnProperty.call(lockedValues, param.name);\n    if (disabled && hideLocked) continue;\n    const value = disabled ? (lockedValues[param.name] ?? \"\") : (values[param.name] ?? \"\");\n    const label = lookupFilters[param.name]?.label ?? titleCase(param.name);\n    const onChange = (next: string | boolean) => {\n      if (disabled) return;\n      const stringValue = typeof next === \"boolean\" ? (next ? \"true\" : \"false\") : next;\n      setValues((current) => ({ ...current, [param.name]: stringValue }));\n    };\n\n    const schema = param.schema;\n    const lookupFilter = lookupFilters[param.name];\n\n    if (lookupFilter?.type === \"multi-filter\" && param.in === \"query\") {\n      emitFilters.push({\n        key: param.name,\n        kind: \"multi\",\n        label,\n        value: parseMultiFilterValue(value),\n        disabled,\n        options: lookupOptionsToFieldOptions(lookupFilter),\n        onChange: (next) =>\n          setValues((current) => ({\n            ...current,\n            [param.name]: serializeMultiFilterValue(next),\n          })),\n      });\n      continue;\n    }\n\n    if (schema?.enum) {\n      emitFilters.push({\n        key: param.name,\n        kind: \"enum\",\n        label,\n        value,\n        disabled,\n        options: schema.enum.map((item) => ({\n          value: String(item),\n          label: String(item),\n        })),\n        onChange: (next) => onChange(next),\n      });\n      continue;\n    }\n\n    if (lookupFilter?.type === \"bool\" || schema?.type === \"boolean\") {\n      emitFilters.push({\n        key: param.name,\n        kind: \"boolean\",\n        label,\n        value: value === \"true\",\n        disabled,\n        onChange: (next) => onChange(next),\n      });\n      continue;\n    }\n\n    if (lookupFilter != null && param.in === \"query\") {\n      if (lookupFilter.multi) {\n        emitFilters.push({\n          key: param.name,\n          kind: \"lookup-multi\",\n          label,\n          value: splitCommaValues(value),\n          disabled,\n          options: lookupOptionsToFieldOptions(lookupFilter),\n          placeholder: param.description ?? \"value-1, value-2\",\n          onChange: (next) =>\n            setValues((current) => ({ ...current, [param.name]: next.join(\",\") })),\n        });\n        continue;\n      }\n\n      emitFilters.push({\n        key: param.name,\n        kind: \"lookup\",\n        label,\n        value,\n        disabled,\n        options: lookupOptionsToFieldOptions(lookupFilter),\n        placeholder: param.description ?? label,\n        inputType:\n          lookupFilter.type === \"number\"\n            ? \"number\"\n            : lookupFilter.type === \"date\"\n              ? \"date\"\n              : \"text\",\n        onChange: (next) => onChange(next),\n      });\n      continue;\n    }\n\n    emitFilters.push({\n      key: param.name,\n      kind: \"text\",\n      label,\n      value,\n      disabled,\n      placeholder: param.description ?? label,\n      onChange: (next) => onChange(next),\n    });\n  }\n\n  const config: ParameterFormConfig = { filters: emitFilters };\n  if (searchParam) {\n    const searchDisabled = Object.prototype.hasOwnProperty.call(lockedValues, searchParam.name);\n    const searchValue = searchDisabled\n      ? (lockedValues[searchParam.name] ?? \"\")\n      : (values[searchParam.name] ?? \"\");\n    config.search = {\n      value: searchValue,\n      onChange: (next) => {\n        if (searchDisabled) return;\n        setValues((current) => ({ ...current, [searchParam.name]: next }));\n      },\n      ...(searchParam.description ? { placeholder: searchParam.description } : {}),\n      ariaLabel: lookupFilters[searchParam.name]?.label ?? titleCase(searchParam.name),\n    };\n  }\n  if (limitParam && offsetParam) {\n    config.pagination = {\n      limitParam: limitParam.name,\n      offsetParam: offsetParam.name,\n      limitValue: values[limitParam.name] ?? \"\",\n      offsetValue: values[offsetParam.name] ?? \"\",\n      setLimit: (next) => setValues((current) => ({ ...current, [limitParam.name]: next })),\n      setOffset: (next) => setValues((current) => ({ ...current, [offsetParam.name]: next })),\n    };\n  }\n  if (hasTimeRange && rangeStart != null && rangeEnd != null) {\n    const rangeStartMeta = lookupFilters[rangeStart.name];\n    const rangeEndMeta = lookupFilters[rangeEnd.name];\n    const rangeMeta = rangeStartMeta ?? rangeEndMeta;\n    config.timeRange = {\n      from: values[rangeStart.name] ?? \"\",\n      to: values[rangeEnd.name] ?? \"\",\n      onApply: (from, to) =>\n        setValues((current) => ({\n          ...current,\n          [rangeStart.name]: from,\n          [rangeEnd.name]: to,\n        })),\n      ...(rangeMeta?.presets ? { presets: rangeMeta.presets } : {}),\n      ...(rangeMeta?.timeEnabled !== undefined ? { timeEnabled: rangeMeta.timeEnabled } : {}),\n      ...(rangeMeta?.timeZone ? { timeZone: rangeMeta.timeZone } : {}),\n      ...(rangeMeta?.timeZones ? { timeZones: rangeMeta.timeZones } : {}),\n      ...(rangeStart.description ? { fromPlaceholder: rangeStart.description } : {}),\n      ...(rangeEnd.description ? { toPlaceholder: rangeEnd.description } : {}),\n    };\n  }\n\n  return config;\n}\n\nexport function useDebouncedRecord<T>(value: T, delayMs: number) {\n  const [debounced, setDebounced] = useState(value);\n\n  useEffect(() => {\n    const timeoutId = window.setTimeout(() => setDebounced(value), delayMs);\n    return () => window.clearTimeout(timeoutId);\n  }, [delayMs, value]);\n\n  return debounced;\n}\n\nexport function parseMultiFilterValue(value: string): Record<string, FilterBarMultiFilterMode> {\n  const parsed: Record<string, FilterBarMultiFilterMode> = {};\n  for (const item of splitCommaValues(value)) {\n    if (item.startsWith(\"!\") && item.length > 1) {\n      parsed[item.slice(1)] = \"exclude\";\n    } else {\n      parsed[item] = \"include\";\n    }\n  }\n  return parsed;\n}\n\nexport function serializeMultiFilterValue(value: Record<string, FilterBarMultiFilterMode>): string {\n  return Object.entries(value)\n    .flatMap(([key, mode]) => {\n      if (mode === \"include\") return [key];\n      if (mode === \"exclude\") return [`!${key}`];\n      return [];\n    })\n    .join(\",\");\n}\n\nfunction splitCommaValues(value: string) {\n  return value\n    .split(\",\")\n    .map((item) => item.trim())\n    .filter(Boolean);\n}\n\nfunction lookupOptionsToFieldOptions(filter: OperationLookupFilter) {\n  const merged = new Map<string, { label?: string; title?: string }>();\n\n  for (const [value, node] of Object.entries(filter.options ?? {})) {\n    merged.set(value, {\n      label: clickyNodeToPlainText(node) || value,\n      title: clickyNodeToPlainText(node) || value,\n    });\n  }\n\n  for (const [value, node] of Object.entries(filter.selected ?? {})) {\n    if (!merged.has(value)) {\n      merged.set(value, {\n        label: clickyNodeToPlainText(node) || value,\n        title: clickyNodeToPlainText(node) || value,\n      });\n    }\n  }\n\n  return Array.from(merged.entries()).map(([value, meta]) => ({\n    value,\n    label: meta.label ?? value,\n    title: meta.title ?? value,\n  }));\n}\n\ntype PlainTextClickyNode = {\n  plain?: string;\n  text?: string;\n  children?: PlainTextClickyNode[];\n  tooltip?: { plain?: string; text?: string };\n};\n\nfunction clickyNodeToPlainText(node: PlainTextClickyNode | null | undefined): string {\n  if (node == null) return \"\";\n  if (node.plain) return node.plain;\n  if (node.text) return node.text;\n  return (node.children ?? []).map((child) => clickyNodeToPlainText(child)).join(\"\");\n}\n"],"names":["isPositionalParam","_a","useState","useEffect"],"mappings":"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"}

package/dist/rpc/formMetadata.d.ts

@@ -1,11 +1,21 @@
 import { Dispatch, SetStateAction } from 'react';
-import { FilterBarFilter, FilterBarMultiFilterMode, FilterBarRangeProps } from '../components/FilterBar';
+import { FilterBarFilter, FilterBarMultiFilterMode, FilterBarRangeProps, FilterBarSearchProps } from '../components/FilterBar';
 import { OpenAPIParameter, OperationLookupResponse } from './types';
 export type ParameterValues = Record<string, string>;
 export type ParameterValuesSetter = Dispatch<SetStateAction<ParameterValues>>;
+export type ParameterPagination = {
+    limitParam: string;
+    offsetParam: string;
+    limitValue: string;
+    offsetValue: string;
+    setLimit: (next: string) => void;
+    setOffset: (next: string) => void;
+};
 export type ParameterFormConfig = {
     filters: FilterBarFilter[];
+    search?: FilterBarSearchProps;
     timeRange?: FilterBarRangeProps;
+    pagination?: ParameterPagination;
 };
 export type ParameterFormOptions = {
     includeLocations?: OpenAPIParameter["in"][];

package/dist/rpc/formMetadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"formMetadata.d.ts","sourceRoot":"","sources":["../../src/rpc/formMetadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,OAAO,CAAC;AAChF,OAAO,KAAK,EACV,eAAe,EACf,wBAAwB,EACxB,mBAAmB,EACpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,gBAAgB,EAAyB,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAGhG,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACrD,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC,CAAC;AAC9E,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,SAAS,CAAC,EAAE,mBAAmB,CAAC;CACjC,CAAC;AACF,MAAM,MAAM,oBAAoB,GAAG;IACjC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;IAC5C,MAAM,CAAC,EAAE,uBAAuB,GAAG,SAAS,CAAC;IAC7C,YAAY,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;IAC3C,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,UAMtC;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAgBxF;AAED,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,gBAAgB,EAAE,EAC9B,MAAM,EAAE,MAAM,EACd,YAAY,GAAE,eAAoB,EAClC,aAAa,GAAE,eAAoB,GAClC,eAAe,CAKjB;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe;;EAE3D;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,eAAe,EACvB,UAAU,EAAE,gBAAgB,EAAE,GAC7B,eAAe,CAuBjB;AAED,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,gBAAgB,EAAE,EAC9B,MAAM,EAAE,eAAe,EACvB,SAAS,EAAE,qBAAqB,EAChC,OAAO,GAAE,oBAAyB,GACjC,mBAAmB,CAmJrB;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,KAS9D;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAU7F;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,GAAG,MAAM,CAQjG"}
+{"version":3,"file":"formMetadata.d.ts","sourceRoot":"","sources":["../../src/rpc/formMetadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,OAAO,CAAC;AAChF,OAAO,KAAK,EACV,eAAe,EACf,wBAAwB,EACxB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,gBAAgB,EAAyB,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAGhG,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACrD,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC,CAAC;AAM9E,MAAM,MAAM,mBAAmB,GAAG;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,UAAU,CAAC,EAAE,mBAAmB,CAAC;CAClC,CAAC;AACF,MAAM,MAAM,oBAAoB,GAAG;IACjC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;IAC5C,MAAM,CAAC,EAAE,uBAAuB,GAAG,SAAS,CAAC;IAC7C,YAAY,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;IAC3C,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,UAMtC;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAgBxF;AAED,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,gBAAgB,EAAE,EAC9B,MAAM,EAAE,MAAM,EACd,YAAY,GAAE,eAAoB,EAClC,aAAa,GAAE,eAAoB,GAClC,eAAe,CAKjB;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe;;EAE3D;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,eAAe,EACvB,UAAU,EAAE,gBAAgB,EAAE,GAC7B,eAAe,CAuBjB;AAED,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,gBAAgB,EAAE,EAC9B,MAAM,EAAE,eAAe,EACvB,SAAS,EAAE,qBAAqB,EAChC,OAAO,GAAE,oBAAyB,GACjC,mBAAmB,CAgNrB;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,KAS9D;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAU7F;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,GAAG,MAAM,CAQjG"}

package/dist/rpc/formMetadata.js

@@ -50,19 +50,46 @@ function packParameterValues(values, parameters) {
   return params;
 }
 function parametersToFormConfig(parameters, values, setValues, options = {}) {
-  var _a, _b;
+  var _a, _b, _c;
   const emitFilters = [];
   const lookupFilters = ((_a = options.lookup) == null ? void 0 : _a.filters) ?? {};
   const includeLocations = new Set(options.includeLocations ?? ["path", "query", "header"]);
   const lockedValues = options.lockedValues ?? {};
   const hideLocked = options.hideLocked ?? false;
-  const rangeStart = parameters.find(
+  const limitParam = parameters.find((p) => {
+    var _a2;
+    return ((_a2 = p["x-clicky"]) == null ? void 0 : _a2.role) === "limit";
+  });
+  const offsetParam = parameters.find((p) => {
+    var _a2;
+    return ((_a2 = p["x-clicky"]) == null ? void 0 : _a2.role) === "offset";
+  });
+  const paginationOmitNames = /* @__PURE__ */ new Set();
+  if (limitParam) paginationOmitNames.add(limitParam.name);
+  if (offsetParam) paginationOmitNames.add(offsetParam.name);
+  const searchParam = parameters.find(
+    (p) => {
+      var _a2;
+      return ((_a2 = p["x-clicky"]) == null ? void 0 : _a2.role) === "search" && includeLocations.has(p.in);
+    }
+  );
+  const omitNames = new Set(paginationOmitNames);
+  if (searchParam) omitNames.add(searchParam.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) => {
       var _a2;
       return includeLocations.has(param.in) && param.in === "query" && ((_a2 = lookupFilters[param.name]) == null ? void 0 : _a2.type) === "from";
     }
   );
-  const rangeEnd = parameters.find(
+  const rangeEnd = roleRangeEnd ?? parameters.find(
     (param) => {
       var _a2;
       return includeLocations.has(param.in) && param.in === "query" && ((_a2 = lookupFilters[param.name]) == null ? void 0 : _a2.type) === "to";
@@ -71,6 +98,7 @@ function parametersToFormConfig(parameters, values, setValues, options = {}) {
   const hasTimeRange = rangeStart != null && rangeEnd != null;
   for (const param of parameters) {
     if (!includeLocations.has(param.in)) continue;
+    if (omitNames.has(param.name)) continue;
     if (hasTimeRange && (param.name === (rangeStart == null ? void 0 : rangeStart.name) || param.name === (rangeEnd == null ? void 0 : rangeEnd.name))) {
       continue;
     }
@@ -164,7 +192,33 @@ function parametersToFormConfig(parameters, values, setValues, options = {}) {
     });
   }
   const config = { filters: emitFilters };
+  if (searchParam) {
+    const searchDisabled = Object.prototype.hasOwnProperty.call(lockedValues, searchParam.name);
+    const searchValue = searchDisabled ? lockedValues[searchParam.name] ?? "" : values[searchParam.name] ?? "";
+    config.search = {
+      value: searchValue,
+      onChange: (next) => {
+        if (searchDisabled) return;
+        setValues((current) => ({ ...current, [searchParam.name]: next }));
+      },
+      ...searchParam.description ? { placeholder: searchParam.description } : {},
+      ariaLabel: ((_c = lookupFilters[searchParam.name]) == null ? void 0 : _c.label) ?? titleCase(searchParam.name)
+    };
+  }
+  if (limitParam && offsetParam) {
+    config.pagination = {
+      limitParam: limitParam.name,
+      offsetParam: offsetParam.name,
+      limitValue: values[limitParam.name] ?? "",
+      offsetValue: values[offsetParam.name] ?? "",
+      setLimit: (next) => setValues((current) => ({ ...current, [limitParam.name]: next })),
+      setOffset: (next) => setValues((current) => ({ ...current, [offsetParam.name]: next }))
+    };
+  }
   if (hasTimeRange && rangeStart != null && rangeEnd != null) {
+    const rangeStartMeta = lookupFilters[rangeStart.name];
+    const rangeEndMeta = lookupFilters[rangeEnd.name];
+    const rangeMeta = rangeStartMeta ?? rangeEndMeta;
     config.timeRange = {
       from: values[rangeStart.name] ?? "",
       to: values[rangeEnd.name] ?? "",
@@ -173,6 +227,10 @@ function parametersToFormConfig(parameters, values, setValues, options = {}) {
         [rangeStart.name]: from,
         [rangeEnd.name]: to
       })),
+      ...(rangeMeta == null ? void 0 : rangeMeta.presets) ? { presets: rangeMeta.presets } : {},
+      ...(rangeMeta == null ? void 0 : rangeMeta.timeEnabled) !== void 0 ? { timeEnabled: rangeMeta.timeEnabled } : {},
+      ...(rangeMeta == null ? void 0 : rangeMeta.timeZone) ? { timeZone: rangeMeta.timeZone } : {},
+      ...(rangeMeta == null ? void 0 : rangeMeta.timeZones) ? { timeZones: rangeMeta.timeZones } : {},
       ...rangeStart.description ? { fromPlaceholder: rangeStart.description } : {},
       ...rangeEnd.description ? { toPlaceholder: rangeEnd.description } : {}
     };

package/dist/rpc/formMetadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"formMetadata.js","sources":["../../src/rpc/formMetadata.ts"],"sourcesContent":["import { useEffect, useState, type Dispatch, type SetStateAction } from \"react\";\nimport type {\n  FilterBarFilter,\n  FilterBarMultiFilterMode,\n  FilterBarRangeProps,\n} from \"../components/FilterBar\";\nimport type { OpenAPIParameter, OperationLookupFilter, OperationLookupResponse } from \"./types\";\nimport { isPositionalParam } from \"./types\";\n\nexport type ParameterValues = Record<string, string>;\nexport type ParameterValuesSetter = Dispatch<SetStateAction<ParameterValues>>;\nexport type ParameterFormConfig = {\n  filters: FilterBarFilter[];\n  timeRange?: FilterBarRangeProps;\n};\nexport type ParameterFormOptions = {\n  includeLocations?: OpenAPIParameter[\"in\"][];\n  lookup?: OperationLookupResponse | undefined;\n  lockedValues?: ParameterValues | undefined;\n  hideLocked?: boolean;\n};\n\nexport function titleCase(value: string) {\n  return value\n    .split(/[-_]/)\n    .filter(Boolean)\n    .map((part) => part.charAt(0).toUpperCase() + part.slice(1))\n    .join(\" \");\n}\n\nexport function defaultValueForParameter(param: OpenAPIParameter, method: string): string {\n  if (method.toUpperCase() === \"GET\" && param.in === \"query\" && !param.required) {\n    return \"\";\n  }\n  const fallback = param.in === \"path\" ? \"\" : undefined;\n  const value = param.schema?.default ?? fallback;\n  if (typeof value === \"boolean\") {\n    return value ? \"true\" : \"false\";\n  }\n  if (Array.isArray(value) || (value != null && typeof value === \"object\")) {\n    return \"\";\n  }\n  if (value == null) {\n    return \"\";\n  }\n  return String(value);\n}\n\nexport function buildInitialParameterValues(\n  parameters: OpenAPIParameter[],\n  method: string,\n  lockedValues: ParameterValues = {},\n  initialValues: ParameterValues = {},\n): ParameterValues {\n  const values = Object.fromEntries(\n    parameters.map((param) => [param.name, defaultValueForParameter(param, method)]),\n  );\n  return { ...values, ...initialValues, ...lockedValues };\n}\n\nexport function pruneParameterValues(values: ParameterValues) {\n  return Object.fromEntries(Object.entries(values).filter(([, value]) => value !== \"\"));\n}\n\nexport function packParameterValues(\n  values: ParameterValues,\n  parameters: OpenAPIParameter[],\n): ParameterValues {\n  const positionalNames = new Set(\n    parameters\n      .filter((param) => param.in !== \"path\" && isPositionalParam(param))\n      .map((p) => p.name),\n  );\n  const params: ParameterValues = {};\n  const args: string[] = [];\n\n  for (const [key, value] of Object.entries(values)) {\n    if (!value) continue;\n    if (positionalNames.has(key)) {\n      args.push(value);\n    } else {\n      params[key] = value;\n    }\n  }\n\n  if (args.length > 0) {\n    params.args = args.join(\",\");\n  }\n\n  return params;\n}\n\nexport function parametersToFormConfig(\n  parameters: OpenAPIParameter[],\n  values: ParameterValues,\n  setValues: ParameterValuesSetter,\n  options: ParameterFormOptions = {},\n): ParameterFormConfig {\n  const emitFilters: FilterBarFilter[] = [];\n  const lookupFilters = options.lookup?.filters ?? {};\n  const includeLocations = new Set(options.includeLocations ?? [\"path\", \"query\", \"header\"]);\n  const lockedValues = options.lockedValues ?? {};\n  const hideLocked = options.hideLocked ?? false;\n  const rangeStart = parameters.find(\n    (param) =>\n      includeLocations.has(param.in) &&\n      param.in === \"query\" &&\n      lookupFilters[param.name]?.type === \"from\",\n  );\n  const rangeEnd = parameters.find(\n    (param) =>\n      includeLocations.has(param.in) &&\n      param.in === \"query\" &&\n      lookupFilters[param.name]?.type === \"to\",\n  );\n  const hasTimeRange = rangeStart != null && rangeEnd != null;\n\n  for (const param of parameters) {\n    if (!includeLocations.has(param.in)) continue;\n    if (hasTimeRange && (param.name === rangeStart?.name || param.name === rangeEnd?.name)) {\n      continue;\n    }\n\n    const disabled = Object.prototype.hasOwnProperty.call(lockedValues, param.name);\n    if (disabled && hideLocked) continue;\n    const value = disabled ? (lockedValues[param.name] ?? \"\") : (values[param.name] ?? \"\");\n    const label = lookupFilters[param.name]?.label ?? titleCase(param.name);\n    const onChange = (next: string | boolean) => {\n      if (disabled) return;\n      const stringValue = typeof next === \"boolean\" ? (next ? \"true\" : \"false\") : next;\n      setValues((current) => ({ ...current, [param.name]: stringValue }));\n    };\n\n    const schema = param.schema;\n    const lookupFilter = lookupFilters[param.name];\n\n    if (lookupFilter?.type === \"multi-filter\" && param.in === \"query\") {\n      emitFilters.push({\n        key: param.name,\n        kind: \"multi\",\n        label,\n        value: parseMultiFilterValue(value),\n        disabled,\n        options: lookupOptionsToFieldOptions(lookupFilter),\n        onChange: (next) =>\n          setValues((current) => ({\n            ...current,\n            [param.name]: serializeMultiFilterValue(next),\n          })),\n      });\n      continue;\n    }\n\n    if (schema?.enum) {\n      emitFilters.push({\n        key: param.name,\n        kind: \"enum\",\n        label,\n        value,\n        disabled,\n        options: schema.enum.map((item) => ({\n          value: String(item),\n          label: String(item),\n        })),\n        onChange: (next) => onChange(next),\n      });\n      continue;\n    }\n\n    if (lookupFilter?.type === \"bool\" || schema?.type === \"boolean\") {\n      emitFilters.push({\n        key: param.name,\n        kind: \"boolean\",\n        label,\n        value: value === \"true\",\n        disabled,\n        onChange: (next) => onChange(next),\n      });\n      continue;\n    }\n\n    if (lookupFilter != null && param.in === \"query\") {\n      if (lookupFilter.multi) {\n        emitFilters.push({\n          key: param.name,\n          kind: \"lookup-multi\",\n          label,\n          value: splitCommaValues(value),\n          disabled,\n          options: lookupOptionsToFieldOptions(lookupFilter),\n          placeholder: param.description ?? \"value-1, value-2\",\n          onChange: (next) =>\n            setValues((current) => ({ ...current, [param.name]: next.join(\",\") })),\n        });\n        continue;\n      }\n\n      emitFilters.push({\n        key: param.name,\n        kind: \"lookup\",\n        label,\n        value,\n        disabled,\n        options: lookupOptionsToFieldOptions(lookupFilter),\n        placeholder: param.description ?? label,\n        inputType:\n          lookupFilter.type === \"number\"\n            ? \"number\"\n            : lookupFilter.type === \"date\"\n              ? \"date\"\n              : \"text\",\n        onChange: (next) => onChange(next),\n      });\n      continue;\n    }\n\n    emitFilters.push({\n      key: param.name,\n      kind: \"text\",\n      label,\n      value,\n      disabled,\n      placeholder: param.description ?? label,\n      onChange: (next) => onChange(next),\n    });\n  }\n\n  const config: ParameterFormConfig = { filters: emitFilters };\n  if (hasTimeRange && rangeStart != null && rangeEnd != null) {\n    config.timeRange = {\n      from: values[rangeStart.name] ?? \"\",\n      to: values[rangeEnd.name] ?? \"\",\n      onApply: (from, to) =>\n        setValues((current) => ({\n          ...current,\n          [rangeStart.name]: from,\n          [rangeEnd.name]: to,\n        })),\n      ...(rangeStart.description ? { fromPlaceholder: rangeStart.description } : {}),\n      ...(rangeEnd.description ? { toPlaceholder: rangeEnd.description } : {}),\n    };\n  }\n\n  return config;\n}\n\nexport function useDebouncedRecord<T>(value: T, delayMs: number) {\n  const [debounced, setDebounced] = useState(value);\n\n  useEffect(() => {\n    const timeoutId = window.setTimeout(() => setDebounced(value), delayMs);\n    return () => window.clearTimeout(timeoutId);\n  }, [delayMs, value]);\n\n  return debounced;\n}\n\nexport function parseMultiFilterValue(value: string): Record<string, FilterBarMultiFilterMode> {\n  const parsed: Record<string, FilterBarMultiFilterMode> = {};\n  for (const item of splitCommaValues(value)) {\n    if (item.startsWith(\"!\") && item.length > 1) {\n      parsed[item.slice(1)] = \"exclude\";\n    } else {\n      parsed[item] = \"include\";\n    }\n  }\n  return parsed;\n}\n\nexport function serializeMultiFilterValue(value: Record<string, FilterBarMultiFilterMode>): string {\n  return Object.entries(value)\n    .flatMap(([key, mode]) => {\n      if (mode === \"include\") return [key];\n      if (mode === \"exclude\") return [`!${key}`];\n      return [];\n    })\n    .join(\",\");\n}\n\nfunction splitCommaValues(value: string) {\n  return value\n    .split(\",\")\n    .map((item) => item.trim())\n    .filter(Boolean);\n}\n\nfunction lookupOptionsToFieldOptions(filter: OperationLookupFilter) {\n  const merged = new Map<string, { label?: string; title?: string }>();\n\n  for (const [value, node] of Object.entries(filter.options ?? {})) {\n    merged.set(value, {\n      label: clickyNodeToPlainText(node) || value,\n      title: clickyNodeToPlainText(node) || value,\n    });\n  }\n\n  for (const [value, node] of Object.entries(filter.selected ?? {})) {\n    if (!merged.has(value)) {\n      merged.set(value, {\n        label: clickyNodeToPlainText(node) || value,\n        title: clickyNodeToPlainText(node) || value,\n      });\n    }\n  }\n\n  return Array.from(merged.entries()).map(([value, meta]) => ({\n    value,\n    label: meta.label ?? value,\n    title: meta.title ?? value,\n  }));\n}\n\ntype PlainTextClickyNode = {\n  plain?: string;\n  text?: string;\n  children?: PlainTextClickyNode[];\n  tooltip?: { plain?: string; text?: string };\n};\n\nfunction clickyNodeToPlainText(node: PlainTextClickyNode | null | undefined): string {\n  if (node == null) return \"\";\n  if (node.plain) return node.plain;\n  if (node.text) return node.text;\n  return (node.children ?? []).map((child) => clickyNodeToPlainText(child)).join(\"\");\n}\n"],"names":["_a"],"mappings":"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"}
+{"version":3,"file":"formMetadata.js","sources":["../../src/rpc/formMetadata.ts"],"sourcesContent":["import { useEffect, useState, type Dispatch, type SetStateAction } from \"react\";\nimport type {\n  FilterBarFilter,\n  FilterBarMultiFilterMode,\n  FilterBarRangeProps,\n  FilterBarSearchProps,\n} from \"../components/FilterBar\";\nimport type { OpenAPIParameter, OperationLookupFilter, OperationLookupResponse } from \"./types\";\nimport { isPositionalParam } from \"./types\";\n\nexport type ParameterValues = Record<string, string>;\nexport type ParameterValuesSetter = Dispatch<SetStateAction<ParameterValues>>;\n\n// ParameterPagination plumbs limit/offset query parameters into the\n// DataTable's pagination footer. The UI exposes both as the\n// {pageSize, pageIndex} tuple but here we keep raw string limit/offset\n// values so the executor sees exactly what the operation declared.\nexport type ParameterPagination = {\n  limitParam: string; // parameter name on the operation, e.g. \"limit\"\n  offsetParam: string;\n  limitValue: string;\n  offsetValue: string;\n  setLimit: (next: string) => void;\n  setOffset: (next: string) => void;\n};\n\nexport type ParameterFormConfig = {\n  filters: FilterBarFilter[];\n  search?: FilterBarSearchProps;\n  timeRange?: FilterBarRangeProps;\n  pagination?: ParameterPagination;\n};\nexport type ParameterFormOptions = {\n  includeLocations?: OpenAPIParameter[\"in\"][];\n  lookup?: OperationLookupResponse | undefined;\n  lockedValues?: ParameterValues | undefined;\n  hideLocked?: boolean;\n};\n\nexport function titleCase(value: string) {\n  return value\n    .split(/[-_]/)\n    .filter(Boolean)\n    .map((part) => part.charAt(0).toUpperCase() + part.slice(1))\n    .join(\" \");\n}\n\nexport function defaultValueForParameter(param: OpenAPIParameter, method: string): string {\n  if (method.toUpperCase() === \"GET\" && param.in === \"query\" && !param.required) {\n    return \"\";\n  }\n  const fallback = param.in === \"path\" ? \"\" : undefined;\n  const value = param.schema?.default ?? fallback;\n  if (typeof value === \"boolean\") {\n    return value ? \"true\" : \"false\";\n  }\n  if (Array.isArray(value) || (value != null && typeof value === \"object\")) {\n    return \"\";\n  }\n  if (value == null) {\n    return \"\";\n  }\n  return String(value);\n}\n\nexport function buildInitialParameterValues(\n  parameters: OpenAPIParameter[],\n  method: string,\n  lockedValues: ParameterValues = {},\n  initialValues: ParameterValues = {},\n): ParameterValues {\n  const values = Object.fromEntries(\n    parameters.map((param) => [param.name, defaultValueForParameter(param, method)]),\n  );\n  return { ...values, ...initialValues, ...lockedValues };\n}\n\nexport function pruneParameterValues(values: ParameterValues) {\n  return Object.fromEntries(Object.entries(values).filter(([, value]) => value !== \"\"));\n}\n\nexport function packParameterValues(\n  values: ParameterValues,\n  parameters: OpenAPIParameter[],\n): ParameterValues {\n  const positionalNames = new Set(\n    parameters\n      .filter((param) => param.in !== \"path\" && isPositionalParam(param))\n      .map((p) => p.name),\n  );\n  const params: ParameterValues = {};\n  const args: string[] = [];\n\n  for (const [key, value] of Object.entries(values)) {\n    if (!value) continue;\n    if (positionalNames.has(key)) {\n      args.push(value);\n    } else {\n      params[key] = value;\n    }\n  }\n\n  if (args.length > 0) {\n    params.args = args.join(\",\");\n  }\n\n  return params;\n}\n\nexport function parametersToFormConfig(\n  parameters: OpenAPIParameter[],\n  values: ParameterValues,\n  setValues: ParameterValuesSetter,\n  options: ParameterFormOptions = {},\n): ParameterFormConfig {\n  const emitFilters: FilterBarFilter[] = [];\n  const lookupFilters = options.lookup?.filters ?? {};\n  const includeLocations = new Set(options.includeLocations ?? [\"path\", \"query\", \"header\"]);\n  const lockedValues = options.lockedValues ?? {};\n  const hideLocked = options.hideLocked ?? false;\n\n  // Pull limit/offset out of the filter loop entirely — they drive pagination,\n  // not filter pills. Roles come from server-side `paramRole` (see\n  // clicky/rpc/openapi.go); the older \"named limit on a GET\" heuristic is\n  // intentionally not duplicated here so the server stays the single source\n  // of truth for parameter classification.\n  const limitParam = parameters.find((p) => p[\"x-clicky\"]?.role === \"limit\");\n  const offsetParam = parameters.find((p) => p[\"x-clicky\"]?.role === \"offset\");\n  const paginationOmitNames = new Set<string>();\n  if (limitParam) paginationOmitNames.add(limitParam.name);\n  if (offsetParam) paginationOmitNames.add(offsetParam.name);\n\n  // The search-role param drives the FilterBar's dedicated search input rather\n  // than a filter chip; pull it out of the chip loop the same way pagination is.\n  const searchParam = parameters.find(\n    (p) => p[\"x-clicky\"]?.role === \"search\" && includeLocations.has(p.in),\n  );\n  const omitNames = new Set(paginationOmitNames);\n  if (searchParam) omitNames.add(searchParam.name);\n\n  // Time-range first looks for server-stamped roles, then falls back to the\n  // existing lookup-driven \"from\"/\"to\" detection so older specs keep working.\n  const roleRangeStart = parameters.find((p) => p[\"x-clicky\"]?.role === \"time-from\");\n  const roleRangeEnd = parameters.find((p) => p[\"x-clicky\"]?.role === \"time-to\");\n  const rangeStart =\n    roleRangeStart ??\n    parameters.find(\n      (param) =>\n        includeLocations.has(param.in) &&\n        param.in === \"query\" &&\n        lookupFilters[param.name]?.type === \"from\",\n    );\n  const rangeEnd =\n    roleRangeEnd ??\n    parameters.find(\n      (param) =>\n        includeLocations.has(param.in) &&\n        param.in === \"query\" &&\n        lookupFilters[param.name]?.type === \"to\",\n    );\n  const hasTimeRange = rangeStart != null && rangeEnd != null;\n\n  for (const param of parameters) {\n    if (!includeLocations.has(param.in)) continue;\n    if (omitNames.has(param.name)) continue;\n    if (hasTimeRange && (param.name === rangeStart?.name || param.name === rangeEnd?.name)) {\n      continue;\n    }\n\n    const disabled = Object.prototype.hasOwnProperty.call(lockedValues, param.name);\n    if (disabled && hideLocked) continue;\n    const value = disabled ? (lockedValues[param.name] ?? \"\") : (values[param.name] ?? \"\");\n    const label = lookupFilters[param.name]?.label ?? titleCase(param.name);\n    const onChange = (next: string | boolean) => {\n      if (disabled) return;\n      const stringValue = typeof next === \"boolean\" ? (next ? \"true\" : \"false\") : next;\n      setValues((current) => ({ ...current, [param.name]: stringValue }));\n    };\n\n    const schema = param.schema;\n    const lookupFilter = lookupFilters[param.name];\n\n    if (lookupFilter?.type === \"multi-filter\" && param.in === \"query\") {\n      emitFilters.push({\n        key: param.name,\n        kind: \"multi\",\n        label,\n        value: parseMultiFilterValue(value),\n        disabled,\n        options: lookupOptionsToFieldOptions(lookupFilter),\n        onChange: (next) =>\n          setValues((current) => ({\n            ...current,\n            [param.name]: serializeMultiFilterValue(next),\n          })),\n      });\n      continue;\n    }\n\n    if (schema?.enum) {\n      emitFilters.push({\n        key: param.name,\n        kind: \"enum\",\n        label,\n        value,\n        disabled,\n        options: schema.enum.map((item) => ({\n          value: String(item),\n          label: String(item),\n        })),\n        onChange: (next) => onChange(next),\n      });\n      continue;\n    }\n\n    if (lookupFilter?.type === \"bool\" || schema?.type === \"boolean\") {\n      emitFilters.push({\n        key: param.name,\n        kind: \"boolean\",\n        label,\n        value: value === \"true\",\n        disabled,\n        onChange: (next) => onChange(next),\n      });\n      continue;\n    }\n\n    if (lookupFilter != null && param.in === \"query\") {\n      if (lookupFilter.multi) {\n        emitFilters.push({\n          key: param.name,\n          kind: \"lookup-multi\",\n          label,\n          value: splitCommaValues(value),\n          disabled,\n          options: lookupOptionsToFieldOptions(lookupFilter),\n          placeholder: param.description ?? \"value-1, value-2\",\n          onChange: (next) =>\n            setValues((current) => ({ ...current, [param.name]: next.join(\",\") })),\n        });\n        continue;\n      }\n\n      emitFilters.push({\n        key: param.name,\n        kind: \"lookup\",\n        label,\n        value,\n        disabled,\n        options: lookupOptionsToFieldOptions(lookupFilter),\n        placeholder: param.description ?? label,\n        inputType:\n          lookupFilter.type === \"number\"\n            ? \"number\"\n            : lookupFilter.type === \"date\"\n              ? \"date\"\n              : \"text\",\n        onChange: (next) => onChange(next),\n      });\n      continue;\n    }\n\n    emitFilters.push({\n      key: param.name,\n      kind: \"text\",\n      label,\n      value,\n      disabled,\n      placeholder: param.description ?? label,\n      onChange: (next) => onChange(next),\n    });\n  }\n\n  const config: ParameterFormConfig = { filters: emitFilters };\n  if (searchParam) {\n    const searchDisabled = Object.prototype.hasOwnProperty.call(lockedValues, searchParam.name);\n    const searchValue = searchDisabled\n      ? (lockedValues[searchParam.name] ?? \"\")\n      : (values[searchParam.name] ?? \"\");\n    config.search = {\n      value: searchValue,\n      onChange: (next) => {\n        if (searchDisabled) return;\n        setValues((current) => ({ ...current, [searchParam.name]: next }));\n      },\n      ...(searchParam.description ? { placeholder: searchParam.description } : {}),\n      ariaLabel: lookupFilters[searchParam.name]?.label ?? titleCase(searchParam.name),\n    };\n  }\n  if (limitParam && offsetParam) {\n    config.pagination = {\n      limitParam: limitParam.name,\n      offsetParam: offsetParam.name,\n      limitValue: values[limitParam.name] ?? \"\",\n      offsetValue: values[offsetParam.name] ?? \"\",\n      setLimit: (next) => setValues((current) => ({ ...current, [limitParam.name]: next })),\n      setOffset: (next) => setValues((current) => ({ ...current, [offsetParam.name]: next })),\n    };\n  }\n  if (hasTimeRange && rangeStart != null && rangeEnd != null) {\n    const rangeStartMeta = lookupFilters[rangeStart.name];\n    const rangeEndMeta = lookupFilters[rangeEnd.name];\n    const rangeMeta = rangeStartMeta ?? rangeEndMeta;\n    config.timeRange = {\n      from: values[rangeStart.name] ?? \"\",\n      to: values[rangeEnd.name] ?? \"\",\n      onApply: (from, to) =>\n        setValues((current) => ({\n          ...current,\n          [rangeStart.name]: from,\n          [rangeEnd.name]: to,\n        })),\n      ...(rangeMeta?.presets ? { presets: rangeMeta.presets } : {}),\n      ...(rangeMeta?.timeEnabled !== undefined ? { timeEnabled: rangeMeta.timeEnabled } : {}),\n      ...(rangeMeta?.timeZone ? { timeZone: rangeMeta.timeZone } : {}),\n      ...(rangeMeta?.timeZones ? { timeZones: rangeMeta.timeZones } : {}),\n      ...(rangeStart.description ? { fromPlaceholder: rangeStart.description } : {}),\n      ...(rangeEnd.description ? { toPlaceholder: rangeEnd.description } : {}),\n    };\n  }\n\n  return config;\n}\n\nexport function useDebouncedRecord<T>(value: T, delayMs: number) {\n  const [debounced, setDebounced] = useState(value);\n\n  useEffect(() => {\n    const timeoutId = window.setTimeout(() => setDebounced(value), delayMs);\n    return () => window.clearTimeout(timeoutId);\n  }, [delayMs, value]);\n\n  return debounced;\n}\n\nexport function parseMultiFilterValue(value: string): Record<string, FilterBarMultiFilterMode> {\n  const parsed: Record<string, FilterBarMultiFilterMode> = {};\n  for (const item of splitCommaValues(value)) {\n    if (item.startsWith(\"!\") && item.length > 1) {\n      parsed[item.slice(1)] = \"exclude\";\n    } else {\n      parsed[item] = \"include\";\n    }\n  }\n  return parsed;\n}\n\nexport function serializeMultiFilterValue(value: Record<string, FilterBarMultiFilterMode>): string {\n  return Object.entries(value)\n    .flatMap(([key, mode]) => {\n      if (mode === \"include\") return [key];\n      if (mode === \"exclude\") return [`!${key}`];\n      return [];\n    })\n    .join(\",\");\n}\n\nfunction splitCommaValues(value: string) {\n  return value\n    .split(\",\")\n    .map((item) => item.trim())\n    .filter(Boolean);\n}\n\nfunction lookupOptionsToFieldOptions(filter: OperationLookupFilter) {\n  const merged = new Map<string, { label?: string; title?: string }>();\n\n  for (const [value, node] of Object.entries(filter.options ?? {})) {\n    merged.set(value, {\n      label: clickyNodeToPlainText(node) || value,\n      title: clickyNodeToPlainText(node) || value,\n    });\n  }\n\n  for (const [value, node] of Object.entries(filter.selected ?? {})) {\n    if (!merged.has(value)) {\n      merged.set(value, {\n        label: clickyNodeToPlainText(node) || value,\n        title: clickyNodeToPlainText(node) || value,\n      });\n    }\n  }\n\n  return Array.from(merged.entries()).map(([value, meta]) => ({\n    value,\n    label: meta.label ?? value,\n    title: meta.title ?? value,\n  }));\n}\n\ntype PlainTextClickyNode = {\n  plain?: string;\n  text?: string;\n  children?: PlainTextClickyNode[];\n  tooltip?: { plain?: string; text?: string };\n};\n\nfunction clickyNodeToPlainText(node: PlainTextClickyNode | null | undefined): string {\n  if (node == null) return \"\";\n  if (node.plain) return node.plain;\n  if (node.text) return node.text;\n  return (node.children ?? []).map((child) => clickyNodeToPlainText(child)).join(\"\");\n}\n"],"names":["_a"],"mappings":"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"}

package/dist/rpc/types.cjs

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+function isPositionalParam(p) {
+  var _a;
+  return p.name === "args" || ((_a = p.description) == null ? void 0 : _a.toLowerCase().includes("positional argument")) === true;
+}
+exports.isPositionalParam = isPositionalParam;
+//# sourceMappingURL=types.cjs.map

package/dist/rpc/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.cjs","sources":["../../src/rpc/types.ts"],"sourcesContent":["import type { ClickyNode } from \"../data/Clicky\";\nimport type { TimeRangePresetGroup } from \"../components/TimeRange\";\n\nexport interface ExecutionRequest {\n  args?: string[];\n  flags?: Record<string, string>;\n}\n\nexport interface ExecutionResponse {\n  success: boolean;\n  message?: string;\n  output?: string;\n  stdout?: string;\n  stderr?: string;\n  exit_code: number;\n  error?: string;\n  cli?: string;\n  input?: ExecutionRequest;\n  contentType?: string;\n  requestUrl?: string;\n  blob?: Blob;\n  parsed?: unknown;\n}\n\nexport interface OpenAPISchema {\n  type?: string;\n  format?: string;\n  default?: unknown;\n  enum?: unknown[];\n  description?: string;\n  properties?: Record<string, OpenAPISchema>;\n}\n\n// ClickyParameterRole tells the UI which widget owns a parameter:\n//   \"search\"    — render as the FilterBar's dedicated search input\n//   \"filter\"    — render as a FilterBar chip on the DataTable\n//   \"limit\"     — feed into DataTable pagination's pageSize\n//   \"offset\"    — feed into DataTable pagination's page (or skip)\n//   \"time-from\" — left edge of a time-range picker\n//   \"time-to\"   — right edge of a time-range picker\n// Set server-side by clicky's converter (see paramRole in clicky/rpc/openapi.go).\nexport type ClickyParameterRole =\n  | \"search\"\n  | \"filter\"\n  | \"limit\"\n  | \"offset\"\n  | \"time-from\"\n  | \"time-to\";\n\nexport interface ClickyParameterMeta {\n  role?: ClickyParameterRole;\n}\n\nexport interface OpenAPIParameter {\n  name: string;\n  in: \"query\" | \"path\" | \"header\";\n  description?: string;\n  required?: boolean;\n  schema?: OpenAPISchema;\n  \"x-clicky\"?: ClickyParameterMeta;\n}\n\nexport interface OpenAPIOperation {\n  tags?: string[];\n  summary?: string;\n  description?: string;\n  operationId?: string;\n  parameters?: OpenAPIParameter[];\n  requestBody?: {\n    content?: Record<string, { schema?: OpenAPISchema }>;\n  };\n  responses: Record<string, unknown>;\n  \"x-clicky\"?: ClickyOperationMeta;\n}\n\nexport interface OpenAPISpec {\n  openapi: string;\n  info: { title: string; description?: string; version: string };\n  paths: Record<string, Record<string, OpenAPIOperation>>;\n  tags?: Array<{ name: string; description?: string }>;\n  \"x-clicky\"?: ClickySpecMeta;\n}\n\nexport interface ResolvedOperation {\n  path: string;\n  method: string;\n  operation: OpenAPIOperation;\n}\n\nexport interface DomainDefinition {\n  key: string;\n  title: string;\n  description: string;\n  emptyTitle?: string;\n  emptyDescription?: string;\n}\n\nexport interface ClickySpecMeta {\n  surfaces?: ClickySurface[];\n}\n\nexport interface ClickySurface {\n  key: string;\n  entity: string;\n  title: string;\n  parent?: string;\n  admin?: boolean;\n  description?: string;\n}\n\nexport interface ClickyOperationMeta {\n  command?: string;\n  surface?: string;\n  verb: \"list\" | \"get\" | \"create\" | \"update\" | \"delete\" | \"action\";\n  scope: \"collection\" | \"entity\";\n  actionName?: string;\n  idParam?: string;\n  supportsLookup?: boolean;\n  supportsFilterMode?: boolean;\n}\n\nexport type OperationLookupFilterType = \"bool\" | \"number\" | \"date\" | \"from\" | \"to\" | \"multi-filter\";\n\nexport interface OperationLookupFilter {\n  label?: string;\n  options?: Record<string, ClickyNode>;\n  selected?: Record<string, ClickyNode>;\n  multi?: boolean;\n  type?: OperationLookupFilterType;\n  presets?: Array<{ label: string; from: string; to: string } | TimeRangePresetGroup>;\n  timeEnabled?: boolean;\n  timeZone?: string;\n  timeZones?: string[];\n}\n\nexport interface OperationLookupResponse {\n  filters: Record<string, OperationLookupFilter>;\n}\n\nexport function isPositionalParam(p: OpenAPIParameter): boolean {\n  return p.name === \"args\" || p.description?.toLowerCase().includes(\"positional argument\") === true;\n}\n"],"names":[],"mappings":";;AA2IO,SAAS,kBAAkB,GAA8B;;AAC9D,SAAO,EAAE,SAAS,YAAU,OAAE,gBAAF,mBAAe,cAAc,SAAS,4BAA2B;AAC/F;;"}

package/dist/rpc/types.d.ts

@@ -1,4 +1,5 @@
 import { ClickyNode } from '../data/Clicky';
+import { TimeRangePresetGroup } from '../components/TimeRange';
 export interface ExecutionRequest {
     args?: string[];
     flags?: Record<string, string>;
@@ -26,12 +27,17 @@ export interface OpenAPISchema {
     description?: string;
     properties?: Record<string, OpenAPISchema>;
 }
+export type ClickyParameterRole = "search" | "filter" | "limit" | "offset" | "time-from" | "time-to";
+export interface ClickyParameterMeta {
+    role?: ClickyParameterRole;
+}
 export interface OpenAPIParameter {
     name: string;
     in: "query" | "path" | "header";
     description?: string;
     required?: boolean;
     schema?: OpenAPISchema;
+    "x-clicky"?: ClickyParameterMeta;
 }
 export interface OpenAPIOperation {
     tags?: string[];
@@ -101,6 +107,14 @@ export interface OperationLookupFilter {
     selected?: Record<string, ClickyNode>;
     multi?: boolean;
     type?: OperationLookupFilterType;
+    presets?: Array<{
+        label: string;
+        from: string;
+        to: string;
+    } | TimeRangePresetGroup>;
+    timeEnabled?: boolean;
+    timeZone?: string;
+    timeZones?: string[];
 }
 export interface OperationLookupResponse {
     filters: Record<string, OperationLookupFilter>;