@flanksource/clicky-ui 0.1.0 → 0.2.2

package/dist/rpc/formMetadata.js

@@ -0,0 +1,250 @@
+import { useState, useEffect } from "react";
+import { isPositionalParam } from "./types.js";
+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" && 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;
+  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(
+    (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(
+    (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 (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 (hasTimeRange && rangeStart != null && rangeEnd != null) {
+    config.timeRange = {
+      from: values[rangeStart.name] ?? "",
+      to: values[rangeEnd.name] ?? "",
+      onApply: (from, to) => setValues((current) => ({
+        ...current,
+        [rangeStart.name]: from,
+        [rangeEnd.name]: to
+      })),
+      ...rangeStart.description ? { fromPlaceholder: rangeStart.description } : {},
+      ...rangeEnd.description ? { toPlaceholder: rangeEnd.description } : {}
+    };
+  }
+  return config;
+}
+function useDebouncedRecord(value, delayMs) {
+  const [debounced, setDebounced] = useState(value);
+  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("");
+}
+export {
+  buildInitialParameterValues,
+  defaultValueForParameter,
+  packParameterValues,
+  parametersToFormConfig,
+  parseMultiFilterValue,
+  pruneParameterValues,
+  serializeMultiFilterValue,
+  titleCase,
+  useDebouncedRecord
+};
+//# sourceMappingURL=formMetadata.js.map

package/dist/rpc/formMetadata.js.map

@@ -0,0 +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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"}

package/dist/rpc/types.d.ts

@@ -0,0 +1,109 @@
+import { ClickyNode } from '../data/Clicky';
+export interface ExecutionRequest {
+    args?: string[];
+    flags?: Record<string, string>;
+}
+export interface ExecutionResponse {
+    success: boolean;
+    message?: string;
+    output?: string;
+    stdout?: string;
+    stderr?: string;
+    exit_code: number;
+    error?: string;
+    cli?: string;
+    input?: ExecutionRequest;
+    contentType?: string;
+    requestUrl?: string;
+    blob?: Blob;
+    parsed?: unknown;
+}
+export interface OpenAPISchema {
+    type?: string;
+    format?: string;
+    default?: unknown;
+    enum?: unknown[];
+    description?: string;
+    properties?: Record<string, OpenAPISchema>;
+}
+export interface OpenAPIParameter {
+    name: string;
+    in: "query" | "path" | "header";
+    description?: string;
+    required?: boolean;
+    schema?: OpenAPISchema;
+}
+export interface OpenAPIOperation {
+    tags?: string[];
+    summary?: string;
+    description?: string;
+    operationId?: string;
+    parameters?: OpenAPIParameter[];
+    requestBody?: {
+        content?: Record<string, {
+            schema?: OpenAPISchema;
+        }>;
+    };
+    responses: Record<string, unknown>;
+    "x-clicky"?: ClickyOperationMeta;
+}
+export interface OpenAPISpec {
+    openapi: string;
+    info: {
+        title: string;
+        description?: string;
+        version: string;
+    };
+    paths: Record<string, Record<string, OpenAPIOperation>>;
+    tags?: Array<{
+        name: string;
+        description?: string;
+    }>;
+    "x-clicky"?: ClickySpecMeta;
+}
+export interface ResolvedOperation {
+    path: string;
+    method: string;
+    operation: OpenAPIOperation;
+}
+export interface DomainDefinition {
+    key: string;
+    title: string;
+    description: string;
+    emptyTitle?: string;
+    emptyDescription?: string;
+}
+export interface ClickySpecMeta {
+    surfaces?: ClickySurface[];
+}
+export interface ClickySurface {
+    key: string;
+    entity: string;
+    title: string;
+    parent?: string;
+    admin?: boolean;
+    description?: string;
+}
+export interface ClickyOperationMeta {
+    command?: string;
+    surface?: string;
+    verb: "list" | "get" | "create" | "update" | "delete" | "action";
+    scope: "collection" | "entity";
+    actionName?: string;
+    idParam?: string;
+    supportsLookup?: boolean;
+    supportsFilterMode?: boolean;
+}
+export type OperationLookupFilterType = "bool" | "number" | "date" | "from" | "to" | "multi-filter";
+export interface OperationLookupFilter {
+    label?: string;
+    options?: Record<string, ClickyNode>;
+    selected?: Record<string, ClickyNode>;
+    multi?: boolean;
+    type?: OperationLookupFilterType;
+}
+export interface OperationLookupResponse {
+    filters: Record<string, OperationLookupFilter>;
+}
+export declare function isPositionalParam(p: OpenAPIParameter): boolean;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/rpc/types.ts"],"names":[],"mappings":"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"}

package/dist/rpc/types.js

@@ -0,0 +1,8 @@
+function isPositionalParam(p) {
+  var _a;
+  return p.name === "args" || ((_a = p.description) == null ? void 0 : _a.toLowerCase().includes("positional argument")) === true;
+}
+export {
+  isPositionalParam
+};
+//# sourceMappingURL=types.js.map

package/dist/rpc/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sources":["../../src/rpc/types.ts"],"sourcesContent":["import type { ClickyNode } from \"../data/Clicky\";\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\nexport interface OpenAPIParameter {\n  name: string;\n  in: \"query\" | \"path\" | \"header\";\n  description?: string;\n  required?: boolean;\n  schema?: OpenAPISchema;\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}\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":"AAiHO,SAAS,kBAAkB,GAA8B;AAAzD;AACL,SAAO,EAAE,SAAS,YAAU,OAAE,gBAAF,mBAAe,cAAc,SAAS,4BAA2B;AAC/F;"}