@flanksource/clicky-ui 0.1.0 → 0.2.1

package/dist/rpc/OperationEntityPage.js

@@ -0,0 +1,218 @@
+import { jsx, jsxs } from "react/jsx-runtime";
+import { useState, useMemo } from "react";
+import { useQuery } from "@tanstack/react-query";
+import { Button } from "../components/button.js";
+import { MethodBadge } from "../data/MethodBadge.js";
+import { Modal } from "../overlay/Modal.js";
+import { filterOperationsByDomain, findListEndpoint, findDetailEndpointForList } from "./classify.js";
+import { filterOperationsBySurface, findSurfaceListOperation, findSurfaceDetailOperation, findSurfaceEntityActions } from "./clickyMetadata.js";
+import { ExecutionResult } from "./ExecutionResult.js";
+import { FilterForm } from "./FilterForm.js";
+import { packParameterValues } from "./formMetadata.js";
+import { useOperations } from "./useOperations.js";
+function defaultRenderError(err, title) {
+  const message = err instanceof Error ? err.message : String(err ?? "");
+  return /* @__PURE__ */ jsxs("div", { className: "rounded-xl border border-destructive/40 bg-destructive/5 p-4 text-sm text-destructive", children: [
+    /* @__PURE__ */ jsx("div", { className: "font-medium", children: title }),
+    message && /* @__PURE__ */ jsx("div", { className: "mt-1 whitespace-pre-wrap text-xs opacity-80", children: message })
+  ] });
+}
+function OperationEntityPage({
+  id,
+  definition,
+  entities,
+  client,
+  renderLink,
+  allOperations = false,
+  operationIdPrefix,
+  listOperationId,
+  detailOperationId,
+  surfaceKey,
+  backHref,
+  backLabel = "Back",
+  renderError = defaultRenderError,
+  commandRuntime
+}) {
+  const { operations, isLoading } = useOperations(client);
+  const [activeAction, setActiveAction] = useState(null);
+  const [actionResult, setActionResult] = useState(null);
+  const [actionError, setActionError] = useState("");
+  const [isExecutingAction, setIsExecutingAction] = useState(false);
+  const surfaceOps = useMemo(
+    () => filterOperationsBySurface(operations, surfaceKey),
+    [operations, surfaceKey]
+  );
+  const useSurfaceMetadata = surfaceOps.length > 0;
+  const domainOps = useMemo(() => {
+    if (useSurfaceMetadata) {
+      return surfaceOps;
+    }
+    return (allOperations ? operations : filterOperationsByDomain(operations, entities)).filter(
+      (op) => operationIdPrefix ? (op.operation.operationId ?? "").startsWith(operationIdPrefix) : true
+    );
+  }, [allOperations, entities, operationIdPrefix, operations, surfaceOps, useSurfaceMetadata]);
+  const listEndpoint = useMemo(() => {
+    if (useSurfaceMetadata) {
+      return findSurfaceListOperation(domainOps, surfaceKey);
+    }
+    const explicitList = listOperationId ? domainOps.find((op) => op.method === "get" && op.operation.operationId === listOperationId) : void 0;
+    return explicitList ?? findListEndpoint(domainOps, entities);
+  }, [domainOps, entities, listOperationId, surfaceKey, useSurfaceMetadata]);
+  const resolvedDetailEndpoint = useMemo(() => {
+    if (useSurfaceMetadata) {
+      return findSurfaceDetailOperation(domainOps, surfaceKey);
+    }
+    return detailOperationId ? domainOps.find(
+      (op) => op.method === "get" && op.operation.operationId === detailOperationId
+    ) : findDetailEndpointForList(domainOps, listEndpoint);
+  }, [detailOperationId, domainOps, listEndpoint, surfaceKey, useSurfaceMetadata]);
+  const idParameterName = useMemo(
+    () => {
+      var _a, _b;
+      return ((_b = (_a = resolvedDetailEndpoint == null ? void 0 : resolvedDetailEndpoint.operation.parameters) == null ? void 0 : _a.find((param) => param.in === "path")) == null ? void 0 : _b.name) ?? "id";
+    },
+    [resolvedDetailEndpoint]
+  );
+  const detailValues = useMemo(() => id ? { [idParameterName]: id } : {}, [id, idParameterName]);
+  const actionOps = useMemo(() => {
+    if (useSurfaceMetadata) {
+      return findSurfaceEntityActions(domainOps, surfaceKey);
+    }
+    return resolvedDetailEndpoint == null ? [] : domainOps.filter(
+      (op) => op.method !== "get" && op.path.startsWith(`${resolvedDetailEndpoint.path}/`)
+    );
+  }, [domainOps, resolvedDetailEndpoint, surfaceKey, useSurfaceMetadata]);
+  const detailQuery = useQuery({
+    queryKey: ["entity-detail", definition.key, id, resolvedDetailEndpoint == null ? void 0 : resolvedDetailEndpoint.path],
+    queryFn: async () => client.executeCommand(
+      resolvedDetailEndpoint.path,
+      resolvedDetailEndpoint.method,
+      detailValues,
+      { Accept: "application/json+clicky" }
+    ),
+    enabled: !!resolvedDetailEndpoint && !!id,
+    staleTime: 3e4,
+    retry: 0
+  });
+  const backLink = backHref == null ? null : renderLink ? renderLink({
+    to: backHref,
+    className: "text-sm text-primary underline-offset-4 hover:underline",
+    children: backLabel
+  }) : /* @__PURE__ */ jsx("a", { href: backHref, className: "text-sm text-primary underline-offset-4 hover:underline", children: backLabel });
+  async function executeAction(values) {
+    if (!activeAction) return;
+    setIsExecutingAction(true);
+    setActionError("");
+    try {
+      const response = await client.executeCommand(
+        activeAction.path,
+        activeAction.method,
+        packParameterValues(values, activeAction.operation.parameters ?? []),
+        { Accept: "application/json+clicky" }
+      );
+      setActionResult(response);
+      await detailQuery.refetch();
+    } catch (err) {
+      setActionResult(null);
+      setActionError(err instanceof Error ? err.message : String(err ?? "Unknown error"));
+    } finally {
+      setIsExecutingAction(false);
+    }
+  }
+  if (isLoading) {
+    return /* @__PURE__ */ jsx("div", { className: "text-sm text-muted-foreground", children: "Loading entity…" });
+  }
+  if (!resolvedDetailEndpoint || !id) {
+    return /* @__PURE__ */ jsxs("div", { className: "space-y-4", children: [
+      backLink,
+      /* @__PURE__ */ jsx("div", { className: "text-sm text-muted-foreground", children: "Unknown entity detail route." })
+    ] });
+  }
+  return /* @__PURE__ */ jsxs("div", { className: "space-y-6", children: [
+    /* @__PURE__ */ jsxs("div", { className: "flex items-start justify-between gap-4", children: [
+      /* @__PURE__ */ jsxs("div", { className: "min-w-0 space-y-2", children: [
+        backLink,
+        /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-3", children: [
+          /* @__PURE__ */ jsx(MethodBadge, { method: resolvedDetailEndpoint.method }),
+          /* @__PURE__ */ jsx("code", { className: "rounded-md bg-muted px-2 py-1 text-sm", children: resolvedDetailEndpoint.path })
+        ] }),
+        /* @__PURE__ */ jsxs("div", { children: [
+          /* @__PURE__ */ jsxs("h1", { className: "text-2xl font-semibold tracking-tight", children: [
+            definition.title,
+            ": ",
+            id
+          ] }),
+          /* @__PURE__ */ jsx("p", { className: "mt-1 max-w-3xl text-sm text-muted-foreground", children: definition.description })
+        ] })
+      ] }),
+      actionOps.length > 0 && /* @__PURE__ */ jsx("div", { className: "flex shrink-0 flex-wrap justify-end gap-2", children: actionOps.map((op) => /* @__PURE__ */ jsx(
+        Button,
+        {
+          type: "button",
+          variant: "outline",
+          size: "sm",
+          onClick: () => {
+            setActiveAction(op);
+            setActionResult(null);
+            setActionError("");
+          },
+          children: op.operation.summary || op.operation.operationId || op.path
+        },
+        `${op.method}:${op.path}`
+      )) })
+    ] }),
+    detailQuery.isLoading ? /* @__PURE__ */ jsx("div", { className: "text-sm text-muted-foreground", children: "Loading detail…" }) : detailQuery.isError ? renderError(detailQuery.error, `Failed to load ${resolvedDetailEndpoint.path}`) : /* @__PURE__ */ jsxs("section", { className: "rounded-xl border bg-card p-4", children: [
+      /* @__PURE__ */ jsx("h2", { className: "text-lg font-medium", children: "Entity detail" }),
+      /* @__PURE__ */ jsx(
+        ExecutionResult,
+        {
+          response: detailQuery.data ?? null,
+          ...commandRuntime ? { commandRuntime } : {}
+        }
+      )
+    ] }),
+    /* @__PURE__ */ jsx(
+      Modal,
+      {
+        open: activeAction != null,
+        onClose: () => setActiveAction(null),
+        title: (activeAction == null ? void 0 : activeAction.operation.summary) || (activeAction == null ? void 0 : activeAction.operation.operationId) || "Action",
+        size: "lg",
+        children: activeAction && /* @__PURE__ */ jsxs("div", { className: "space-y-4", children: [
+          /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-3", children: [
+            /* @__PURE__ */ jsx(MethodBadge, { method: activeAction.method }),
+            /* @__PURE__ */ jsx("code", { className: "rounded-md bg-muted px-2 py-1 text-sm", children: activeAction.path })
+          ] }),
+          /* @__PURE__ */ jsx(
+            FilterForm,
+            {
+              client,
+              path: activeAction.path,
+              method: activeAction.method,
+              parameters: activeAction.operation.parameters ?? [],
+              lockedValues: { [idParameterName]: id },
+              hideLocked: true,
+              enableLookup: false,
+              submitLabel: "Execute request",
+              submittingLabel: "Executing…",
+              isSubmitting: isExecutingAction,
+              onSubmit: executeAction
+            }
+          ),
+          actionError ? /* @__PURE__ */ jsx("div", { className: "rounded-md border border-destructive/40 bg-destructive/5 p-3 text-sm text-destructive", children: actionError }) : actionResult ? /* @__PURE__ */ jsx(
+            ExecutionResult,
+            {
+              response: actionResult,
+              className: "mt-0",
+              ...commandRuntime ? { commandRuntime } : {}
+            }
+          ) : null
+        ] })
+      }
+    )
+  ] });
+}
+export {
+  OperationEntityPage
+};
+//# sourceMappingURL=OperationEntityPage.js.map

package/dist/rpc/OperationEntityPage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OperationEntityPage.js","sources":["../../src/rpc/OperationEntityPage.tsx"],"sourcesContent":["import { useMemo, useState, type ReactNode } from \"react\";\nimport { useQuery } from \"@tanstack/react-query\";\nimport { Button } from \"../components/button\";\nimport type { ClickyCommandRuntime } from \"../data/Clicky\";\nimport { MethodBadge } from \"../data/MethodBadge\";\nimport { Modal } from \"../overlay/Modal\";\nimport { filterOperationsByDomain, findDetailEndpointForList, findListEndpoint } from \"./classify\";\nimport {\n  filterOperationsBySurface,\n  findSurfaceDetailOperation,\n  findSurfaceEntityActions,\n  findSurfaceListOperation,\n} from \"./clickyMetadata\";\nimport { ExecutionResult } from \"./ExecutionResult\";\nimport { FilterForm } from \"./FilterForm\";\nimport { packParameterValues } from \"./formMetadata\";\nimport type { RenderLink } from \"./EndpointList\";\nimport type { DomainDefinition, ExecutionResponse, ResolvedOperation } from \"./types\";\nimport { useOperations, type OperationsApiClient } from \"./useOperations\";\n\nexport type OperationEntityPageProps = {\n  id?: string;\n  definition: DomainDefinition;\n  entities: string[];\n  client: OperationsApiClient;\n  renderLink?: RenderLink;\n  allOperations?: boolean;\n  operationIdPrefix?: string;\n  listOperationId?: string;\n  detailOperationId?: string;\n  surfaceKey?: string;\n  backHref?: string;\n  backLabel?: string;\n  renderError?: (err: unknown, title: string) => ReactNode;\n  commandRuntime?: ClickyCommandRuntime;\n};\n\nfunction defaultRenderError(err: unknown, title: string) {\n  const message = err instanceof Error ? err.message : String(err ?? \"\");\n  return (\n    <div className=\"rounded-xl border border-destructive/40 bg-destructive/5 p-4 text-sm text-destructive\">\n      <div className=\"font-medium\">{title}</div>\n      {message && <div className=\"mt-1 whitespace-pre-wrap text-xs opacity-80\">{message}</div>}\n    </div>\n  );\n}\n\nexport function OperationEntityPage({\n  id,\n  definition,\n  entities,\n  client,\n  renderLink,\n  allOperations = false,\n  operationIdPrefix,\n  listOperationId,\n  detailOperationId,\n  surfaceKey,\n  backHref,\n  backLabel = \"Back\",\n  renderError = defaultRenderError,\n  commandRuntime,\n}: OperationEntityPageProps) {\n  const { operations, isLoading } = useOperations(client);\n  const [activeAction, setActiveAction] = useState<ResolvedOperation | null>(null);\n  const [actionResult, setActionResult] = useState<ExecutionResponse | null>(null);\n  const [actionError, setActionError] = useState(\"\");\n  const [isExecutingAction, setIsExecutingAction] = useState(false);\n  const surfaceOps = useMemo(\n    () => filterOperationsBySurface(operations, surfaceKey),\n    [operations, surfaceKey],\n  );\n  const useSurfaceMetadata = surfaceOps.length > 0;\n\n  const domainOps = useMemo(() => {\n    if (useSurfaceMetadata) {\n      return surfaceOps;\n    }\n\n    return (allOperations ? operations : filterOperationsByDomain(operations, entities)).filter(\n      (op) =>\n        operationIdPrefix ? (op.operation.operationId ?? \"\").startsWith(operationIdPrefix) : true,\n    );\n  }, [allOperations, entities, operationIdPrefix, operations, surfaceOps, useSurfaceMetadata]);\n\n  const listEndpoint = useMemo(() => {\n    if (useSurfaceMetadata) {\n      return findSurfaceListOperation(domainOps, surfaceKey);\n    }\n\n    const explicitList = listOperationId\n      ? domainOps.find((op) => op.method === \"get\" && op.operation.operationId === listOperationId)\n      : undefined;\n    return explicitList ?? findListEndpoint(domainOps, entities);\n  }, [domainOps, entities, listOperationId, surfaceKey, useSurfaceMetadata]);\n\n  const resolvedDetailEndpoint = useMemo(() => {\n    if (useSurfaceMetadata) {\n      return findSurfaceDetailOperation(domainOps, surfaceKey);\n    }\n\n    return detailOperationId\n      ? domainOps.find(\n          (op) => op.method === \"get\" && op.operation.operationId === detailOperationId,\n        )\n      : findDetailEndpointForList(domainOps, listEndpoint);\n  }, [detailOperationId, domainOps, listEndpoint, surfaceKey, useSurfaceMetadata]);\n\n  const idParameterName = useMemo(\n    () =>\n      resolvedDetailEndpoint?.operation.parameters?.find((param) => param.in === \"path\")?.name ??\n      \"id\",\n    [resolvedDetailEndpoint],\n  );\n  const detailValues = useMemo(() => (id ? { [idParameterName]: id } : {}), [id, idParameterName]);\n  const actionOps = useMemo(() => {\n    if (useSurfaceMetadata) {\n      return findSurfaceEntityActions(domainOps, surfaceKey);\n    }\n\n    return resolvedDetailEndpoint == null\n      ? []\n      : domainOps.filter(\n          (op) => op.method !== \"get\" && op.path.startsWith(`${resolvedDetailEndpoint.path}/`),\n        );\n  }, [domainOps, resolvedDetailEndpoint, surfaceKey, useSurfaceMetadata]);\n\n  const detailQuery = useQuery({\n    queryKey: [\"entity-detail\", definition.key, id, resolvedDetailEndpoint?.path],\n    queryFn: async () =>\n      client.executeCommand(\n        resolvedDetailEndpoint!.path,\n        resolvedDetailEndpoint!.method,\n        detailValues,\n        { Accept: \"application/json+clicky\" },\n      ),\n    enabled: !!resolvedDetailEndpoint && !!id,\n    staleTime: 30_000,\n    retry: 0,\n  });\n\n  const backLink =\n    backHref == null ? null : renderLink ? (\n      renderLink({\n        to: backHref,\n        className: \"text-sm text-primary underline-offset-4 hover:underline\",\n        children: backLabel,\n      })\n    ) : (\n      <a href={backHref} className=\"text-sm text-primary underline-offset-4 hover:underline\">\n        {backLabel}\n      </a>\n    );\n\n  async function executeAction(values: Record<string, string>) {\n    if (!activeAction) return;\n    setIsExecutingAction(true);\n    setActionError(\"\");\n\n    try {\n      const response = await client.executeCommand(\n        activeAction.path,\n        activeAction.method,\n        packParameterValues(values, activeAction.operation.parameters ?? []),\n        { Accept: \"application/json+clicky\" },\n      );\n      setActionResult(response);\n      await detailQuery.refetch();\n    } catch (err) {\n      setActionResult(null);\n      setActionError(err instanceof Error ? err.message : String(err ?? \"Unknown error\"));\n    } finally {\n      setIsExecutingAction(false);\n    }\n  }\n\n  if (isLoading) {\n    return <div className=\"text-sm text-muted-foreground\">Loading entity…</div>;\n  }\n\n  if (!resolvedDetailEndpoint || !id) {\n    return (\n      <div className=\"space-y-4\">\n        {backLink}\n        <div className=\"text-sm text-muted-foreground\">Unknown entity detail route.</div>\n      </div>\n    );\n  }\n\n  return (\n    <div className=\"space-y-6\">\n      <div className=\"flex items-start justify-between gap-4\">\n        <div className=\"min-w-0 space-y-2\">\n          {backLink}\n          <div className=\"flex items-center gap-3\">\n            <MethodBadge method={resolvedDetailEndpoint.method} />\n            <code className=\"rounded-md bg-muted px-2 py-1 text-sm\">\n              {resolvedDetailEndpoint.path}\n            </code>\n          </div>\n          <div>\n            <h1 className=\"text-2xl font-semibold tracking-tight\">\n              {definition.title}: {id}\n            </h1>\n            <p className=\"mt-1 max-w-3xl text-sm text-muted-foreground\">{definition.description}</p>\n          </div>\n        </div>\n        {actionOps.length > 0 && (\n          <div className=\"flex shrink-0 flex-wrap justify-end gap-2\">\n            {actionOps.map((op) => (\n              <Button\n                key={`${op.method}:${op.path}`}\n                type=\"button\"\n                variant=\"outline\"\n                size=\"sm\"\n                onClick={() => {\n                  setActiveAction(op);\n                  setActionResult(null);\n                  setActionError(\"\");\n                }}\n              >\n                {op.operation.summary || op.operation.operationId || op.path}\n              </Button>\n            ))}\n          </div>\n        )}\n      </div>\n\n      {detailQuery.isLoading ? (\n        <div className=\"text-sm text-muted-foreground\">Loading detail…</div>\n      ) : detailQuery.isError ? (\n        renderError(detailQuery.error, `Failed to load ${resolvedDetailEndpoint.path}`)\n      ) : (\n        <section className=\"rounded-xl border bg-card p-4\">\n          <h2 className=\"text-lg font-medium\">Entity detail</h2>\n          <ExecutionResult\n            response={detailQuery.data ?? null}\n            {...(commandRuntime ? { commandRuntime } : {})}\n          />\n        </section>\n      )}\n\n      <Modal\n        open={activeAction != null}\n        onClose={() => setActiveAction(null)}\n        title={activeAction?.operation.summary || activeAction?.operation.operationId || \"Action\"}\n        size=\"lg\"\n      >\n        {activeAction && (\n          <div className=\"space-y-4\">\n            <div className=\"flex items-center gap-3\">\n              <MethodBadge method={activeAction.method} />\n              <code className=\"rounded-md bg-muted px-2 py-1 text-sm\">{activeAction.path}</code>\n            </div>\n            <FilterForm\n              client={client}\n              path={activeAction.path}\n              method={activeAction.method}\n              parameters={activeAction.operation.parameters ?? []}\n              lockedValues={{ [idParameterName]: id }}\n              hideLocked\n              enableLookup={false}\n              submitLabel=\"Execute request\"\n              submittingLabel=\"Executing…\"\n              isSubmitting={isExecutingAction}\n              onSubmit={executeAction}\n            />\n            {actionError ? (\n              <div className=\"rounded-md border border-destructive/40 bg-destructive/5 p-3 text-sm text-destructive\">\n                {actionError}\n              </div>\n            ) : actionResult ? (\n              <ExecutionResult\n                response={actionResult}\n                className=\"mt-0\"\n                {...(commandRuntime ? { commandRuntime } : {})}\n              />\n            ) : null}\n          </div>\n        )}\n      </Modal>\n    </div>\n  );\n}\n"],"names":[],"mappings":"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"}

package/dist/rpc/classify.d.ts

@@ -0,0 +1,8 @@
+import { ExecutionResponse, ResolvedOperation } from './types';
+export declare function findListEndpoint(operations: ResolvedOperation[], entities: string[]): ResolvedOperation | undefined;
+export declare function findDetailEndpoint(operations: ResolvedOperation[]): ResolvedOperation | undefined;
+export declare function findDetailEndpointForList(operations: ResolvedOperation[], listEndpoint: ResolvedOperation | undefined): ResolvedOperation | undefined;
+export declare function parseJsonBody(response: ExecutionResponse | undefined): unknown;
+export declare function normalizeRows(data: unknown): Record<string, unknown>[];
+export declare function filterOperationsByDomain(operations: ResolvedOperation[], entities: string[]): ResolvedOperation[];
+//# sourceMappingURL=classify.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"classify.d.ts","sourceRoot":"","sources":["../../src/rpc/classify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAO5F,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,iBAAiB,EAAE,EAC/B,QAAQ,EAAE,MAAM,EAAE,GACjB,iBAAiB,GAAG,SAAS,CAO/B;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,iBAAiB,EAAE,GAAG,iBAAiB,GAAG,SAAS,CAMjG;AAUD,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,iBAAiB,EAAE,EAC/B,YAAY,EAAE,iBAAiB,GAAG,SAAS,GAC1C,iBAAiB,GAAG,SAAS,CA2B/B;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,iBAAiB,GAAG,SAAS,GAAG,OAAO,CAS9E;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAQtE;AAMD,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,iBAAiB,EAAE,EAC/B,QAAQ,EAAE,MAAM,EAAE,GACjB,iBAAiB,EAAE,CAIrB"}

package/dist/rpc/classify.js

@@ -0,0 +1,76 @@
+import { isPositionalParam } from "./types.js";
+function findListEndpoint(operations, entities) {
+  const wanted = new Set(entities.map((e) => `${e}_list`));
+  if (wanted.size === 0) return void 0;
+  return operations.find(
+    (op) => op.method === "get" && !!op.operation.operationId && wanted.has(op.operation.operationId)
+  );
+}
+function findDetailEndpoint(operations) {
+  return operations.find(
+    (op) => {
+      var _a;
+      return op.method === "get" && ((_a = op.operation.parameters) == null ? void 0 : _a.some((p) => p.in === "path" || isPositionalParam(p)));
+    }
+  );
+}
+function splitPath(path) {
+  return path.split("/").filter(Boolean);
+}
+function findDetailEndpointForList(operations, listEndpoint) {
+  if (!listEndpoint) {
+    return findDetailEndpoint(operations);
+  }
+  const baseSegments = splitPath(listEndpoint.path);
+  const candidates = operations.filter(
+    (op) => {
+      var _a;
+      return op.method === "get" && op.path !== listEndpoint.path && ((_a = op.operation.parameters) == null ? void 0 : _a.some((p) => p.in === "path" || isPositionalParam(p)));
+    }
+  );
+  const exactChild = candidates.find((op) => {
+    const segments = splitPath(op.path);
+    if (segments.length !== baseSegments.length + 1) {
+      return false;
+    }
+    return baseSegments.every((segment, index) => segments[index] === segment);
+  });
+  if (exactChild) {
+    return exactChild;
+  }
+  const descendant = candidates.find((op) => op.path.startsWith(`${listEndpoint.path}/`));
+  return descendant ?? findDetailEndpoint(operations);
+}
+function parseJsonBody(response) {
+  if (!response) return null;
+  const text = response.stdout || response.output || "";
+  if (!text.trim()) return null;
+  try {
+    return JSON.parse(text);
+  } catch {
+    return null;
+  }
+}
+function normalizeRows(data) {
+  if (Array.isArray(data)) return data;
+  if (data && typeof data === "object") {
+    for (const value of Object.values(data)) {
+      if (Array.isArray(value)) return value;
+    }
+  }
+  return [];
+}
+function filterOperationsByDomain(operations, entities) {
+  if (entities.length === 0) return [];
+  const wanted = new Set(entities);
+  return operations.filter((op) => (op.operation.tags ?? []).some((tag) => wanted.has(tag)));
+}
+export {
+  filterOperationsByDomain,
+  findDetailEndpoint,
+  findDetailEndpointForList,
+  findListEndpoint,
+  normalizeRows,
+  parseJsonBody
+};
+//# sourceMappingURL=classify.js.map

package/dist/rpc/classify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.js","sources":["../../src/rpc/classify.ts"],"sourcesContent":["import { isPositionalParam, type ExecutionResponse, type ResolvedOperation } from \"./types\";\n\n// findListEndpoint picks the canonical list operation for a set of\n// entities. Clicky-rpc auto-registers `<entity> list` commands and mints\n// operationIds of the form `<entity>_list`. Matching exactly on that form\n// keeps the default table view deterministic — a non-list GET never gets\n// promoted to list by accident.\nexport function findListEndpoint(\n  operations: ResolvedOperation[],\n  entities: string[],\n): ResolvedOperation | undefined {\n  const wanted = new Set(entities.map((e) => `${e}_list`));\n  if (wanted.size === 0) return undefined;\n  return operations.find(\n    (op) =>\n      op.method === \"get\" && !!op.operation.operationId && wanted.has(op.operation.operationId),\n  );\n}\n\nexport function findDetailEndpoint(operations: ResolvedOperation[]): ResolvedOperation | undefined {\n  return operations.find(\n    (op) =>\n      op.method === \"get\" &&\n      op.operation.parameters?.some((p) => p.in === \"path\" || isPositionalParam(p)),\n  );\n}\n\nfunction splitPath(path: string) {\n  return path.split(\"/\").filter(Boolean);\n}\n\n// findDetailEndpointForList prefers the detail GET that belongs to the\n// resolved list route. This keeps sibling surfaces that share tags\n// (for example `stack_*` and `admin_stack_*`) from cross-contaminating\n// default entity-detail routing.\nexport function findDetailEndpointForList(\n  operations: ResolvedOperation[],\n  listEndpoint: ResolvedOperation | undefined,\n): ResolvedOperation | undefined {\n  if (!listEndpoint) {\n    return findDetailEndpoint(operations);\n  }\n\n  const baseSegments = splitPath(listEndpoint.path);\n  const candidates = operations.filter(\n    (op) =>\n      op.method === \"get\" &&\n      op.path !== listEndpoint.path &&\n      op.operation.parameters?.some((p) => p.in === \"path\" || isPositionalParam(p)),\n  );\n\n  const exactChild = candidates.find((op) => {\n    const segments = splitPath(op.path);\n    if (segments.length !== baseSegments.length + 1) {\n      return false;\n    }\n    return baseSegments.every((segment, index) => segments[index] === segment);\n  });\n\n  if (exactChild) {\n    return exactChild;\n  }\n\n  const descendant = candidates.find((op) => op.path.startsWith(`${listEndpoint.path}/`));\n  return descendant ?? findDetailEndpoint(operations);\n}\n\nexport function parseJsonBody(response: ExecutionResponse | undefined): unknown {\n  if (!response) return null;\n  const text = response.stdout || response.output || \"\";\n  if (!text.trim()) return null;\n  try {\n    return JSON.parse(text);\n  } catch {\n    return null;\n  }\n}\n\nexport function normalizeRows(data: unknown): Record<string, unknown>[] {\n  if (Array.isArray(data)) return data as Record<string, unknown>[];\n  if (data && typeof data === \"object\") {\n    for (const value of Object.values(data)) {\n      if (Array.isArray(value)) return value as Record<string, unknown>[];\n    }\n  }\n  return [];\n}\n\n// filterOperationsByDomain returns operations whose OpenAPI `tags` intersect\n// the given entity list. Clicky-rpc's converter stamps the parent command\n// name into `op.tags`, so passing the entities that belong to a domain\n// yields that domain's operations.\nexport function filterOperationsByDomain(\n  operations: ResolvedOperation[],\n  entities: string[],\n): ResolvedOperation[] {\n  if (entities.length === 0) return [];\n  const wanted = new Set(entities);\n  return operations.filter((op) => (op.operation.tags ?? []).some((tag) => wanted.has(tag)));\n}\n"],"names":[],"mappings":";AAOO,SAAS,iBACd,YACA,UAC+B;AAC/B,QAAM,SAAS,IAAI,IAAI,SAAS,IAAI,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC;AACvD,MAAI,OAAO,SAAS,EAAG,QAAO;AAC9B,SAAO,WAAW;AAAA,IAChB,CAAC,OACC,GAAG,WAAW,SAAS,CAAC,CAAC,GAAG,UAAU,eAAe,OAAO,IAAI,GAAG,UAAU,WAAW;AAAA,EAAA;AAE9F;AAEO,SAAS,mBAAmB,YAAgE;AACjG,SAAO,WAAW;AAAA,IAChB,CAAC,OAAA;;AACC,gBAAG,WAAW,WACd,QAAG,UAAU,eAAb,mBAAyB,KAAK,CAAC,MAAM,EAAE,OAAO,UAAU,kBAAkB,CAAC;AAAA;AAAA,EAAC;AAElF;AAEA,SAAS,UAAU,MAAc;AAC/B,SAAO,KAAK,MAAM,GAAG,EAAE,OAAO,OAAO;AACvC;AAMO,SAAS,0BACd,YACA,cAC+B;AAC/B,MAAI,CAAC,cAAc;AACjB,WAAO,mBAAmB,UAAU;AAAA,EACtC;AAEA,QAAM,eAAe,UAAU,aAAa,IAAI;AAChD,QAAM,aAAa,WAAW;AAAA,IAC5B,CAAC;;AACC,gBAAG,WAAW,SACd,GAAG,SAAS,aAAa,UACzB,QAAG,UAAU,eAAb,mBAAyB,KAAK,CAAC,MAAM,EAAE,OAAO,UAAU,kBAAkB,CAAC;AAAA;AAAA,EAAC;AAGhF,QAAM,aAAa,WAAW,KAAK,CAAC,OAAO;AACzC,UAAM,WAAW,UAAU,GAAG,IAAI;AAClC,QAAI,SAAS,WAAW,aAAa,SAAS,GAAG;AAC/C,aAAO;AAAA,IACT;AACA,WAAO,aAAa,MAAM,CAAC,SAAS,UAAU,SAAS,KAAK,MAAM,OAAO;AAAA,EAC3E,CAAC;AAED,MAAI,YAAY;AACd,WAAO;AAAA,EACT;AAEA,QAAM,aAAa,WAAW,KAAK,CAAC,OAAO,GAAG,KAAK,WAAW,GAAG,aAAa,IAAI,GAAG,CAAC;AACtF,SAAO,cAAc,mBAAmB,UAAU;AACpD;AAEO,SAAS,cAAc,UAAkD;AAC9E,MAAI,CAAC,SAAU,QAAO;AACtB,QAAM,OAAO,SAAS,UAAU,SAAS,UAAU;AACnD,MAAI,CAAC,KAAK,KAAA,EAAQ,QAAO;AACzB,MAAI;AACF,WAAO,KAAK,MAAM,IAAI;AAAA,EACxB,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEO,SAAS,cAAc,MAA0C;AACtE,MAAI,MAAM,QAAQ,IAAI,EAAG,QAAO;AAChC,MAAI,QAAQ,OAAO,SAAS,UAAU;AACpC,eAAW,SAAS,OAAO,OAAO,IAAI,GAAG;AACvC,UAAI,MAAM,QAAQ,KAAK,EAAG,QAAO;AAAA,IACnC;AAAA,EACF;AACA,SAAO,CAAA;AACT;AAMO,SAAS,yBACd,YACA,UACqB;AACrB,MAAI,SAAS,WAAW,EAAG,QAAO,CAAA;AAClC,QAAM,SAAS,IAAI,IAAI,QAAQ;AAC/B,SAAO,WAAW,OAAO,CAAC,QAAQ,GAAG,UAAU,QAAQ,CAAA,GAAI,KAAK,CAAC,QAAQ,OAAO,IAAI,GAAG,CAAC,CAAC;AAC3F;"}

package/dist/rpc/clickyMetadata.d.ts

@@ -0,0 +1,12 @@
+import { ClickyOperationMeta, ClickySpecMeta, ClickySurface, DomainDefinition, OpenAPISpec, ResolvedOperation } from './types';
+export declare function getClickySpecMeta(spec: OpenAPISpec | undefined): ClickySpecMeta | undefined;
+export declare function getClickySurfaces(spec: OpenAPISpec | undefined): ClickySurface[];
+export declare function getOperationClickyMeta(operation: Pick<ResolvedOperation, "operation">): ClickyOperationMeta | undefined;
+export declare function filterOperationsBySurface(operations: ResolvedOperation[], surfaceKey: string | undefined): ResolvedOperation[];
+export declare function findSurfaceOperation(operations: ResolvedOperation[], surfaceKey: string | undefined, predicate: (meta: ClickyOperationMeta) => boolean): ResolvedOperation | undefined;
+export declare function findSurfaceListOperation(operations: ResolvedOperation[], surfaceKey: string | undefined): ResolvedOperation | undefined;
+export declare function findSurfaceDetailOperation(operations: ResolvedOperation[], surfaceKey: string | undefined): ResolvedOperation | undefined;
+export declare function findSurfaceCollectionActions(operations: ResolvedOperation[], surfaceKey: string | undefined): ResolvedOperation[];
+export declare function findSurfaceEntityActions(operations: ResolvedOperation[], surfaceKey: string | undefined): ResolvedOperation[];
+export declare function makeSurfaceDefinition(surface: ClickySurface): DomainDefinition;
+//# sourceMappingURL=clickyMetadata.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clickyMetadata.d.ts","sourceRoot":"","sources":["../../src/rpc/clickyMetadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAEjB,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,GAAG,cAAc,GAAG,SAAS,CAE3F;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,GAAG,aAAa,EAAE,CAEhF;AAED,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,IAAI,CAAC,iBAAiB,EAAE,WAAW,CAAC,GAC9C,mBAAmB,GAAG,SAAS,CAEjC;AAED,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,iBAAiB,EAAE,EAC/B,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,iBAAiB,EAAE,CAKrB;AAED,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,iBAAiB,EAAE,EAC/B,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,SAAS,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,OAAO,GAChD,iBAAiB,GAAG,SAAS,CAK/B;AAED,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,iBAAiB,EAAE,EAC/B,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,iBAAiB,GAAG,SAAS,CAM/B;AAED,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,iBAAiB,EAAE,EAC/B,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,iBAAiB,GAAG,SAAS,CAM/B;AAED,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,iBAAiB,EAAE,EAC/B,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,iBAAiB,EAAE,CAKrB;AAED,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,iBAAiB,EAAE,EAC/B,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,iBAAiB,EAAE,CAKrB;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,aAAa,GAAG,gBAAgB,CAM9E"}

package/dist/rpc/clickyMetadata.js

@@ -0,0 +1,71 @@
+function getClickySpecMeta(spec) {
+  return spec == null ? void 0 : spec["x-clicky"];
+}
+function getClickySurfaces(spec) {
+  var _a;
+  return ((_a = getClickySpecMeta(spec)) == null ? void 0 : _a.surfaces) ?? [];
+}
+function getOperationClickyMeta(operation) {
+  return operation.operation["x-clicky"];
+}
+function filterOperationsBySurface(operations, surfaceKey) {
+  if (!surfaceKey) return [];
+  return operations.filter(
+    (operation) => {
+      var _a;
+      return ((_a = getOperationClickyMeta(operation)) == null ? void 0 : _a.surface) === surfaceKey;
+    }
+  );
+}
+function findSurfaceOperation(operations, surfaceKey, predicate) {
+  return filterOperationsBySurface(operations, surfaceKey).find((operation) => {
+    const meta = getOperationClickyMeta(operation);
+    return meta != null && predicate(meta);
+  });
+}
+function findSurfaceListOperation(operations, surfaceKey) {
+  return findSurfaceOperation(
+    operations,
+    surfaceKey,
+    (meta) => meta.verb === "list" && meta.scope === "collection"
+  );
+}
+function findSurfaceDetailOperation(operations, surfaceKey) {
+  return findSurfaceOperation(
+    operations,
+    surfaceKey,
+    (meta) => meta.verb === "get" && meta.scope === "entity"
+  );
+}
+function findSurfaceCollectionActions(operations, surfaceKey) {
+  return filterOperationsBySurface(operations, surfaceKey).filter((operation) => {
+    const meta = getOperationClickyMeta(operation);
+    return meta != null && meta.scope === "collection" && meta.verb !== "list";
+  });
+}
+function findSurfaceEntityActions(operations, surfaceKey) {
+  return filterOperationsBySurface(operations, surfaceKey).filter((operation) => {
+    const meta = getOperationClickyMeta(operation);
+    return meta != null && meta.scope === "entity" && meta.verb !== "get";
+  });
+}
+function makeSurfaceDefinition(surface) {
+  return {
+    key: surface.key,
+    title: surface.title,
+    description: surface.description || `Manage ${surface.title.toLowerCase()} resources.`
+  };
+}
+export {
+  filterOperationsBySurface,
+  findSurfaceCollectionActions,
+  findSurfaceDetailOperation,
+  findSurfaceEntityActions,
+  findSurfaceListOperation,
+  findSurfaceOperation,
+  getClickySpecMeta,
+  getClickySurfaces,
+  getOperationClickyMeta,
+  makeSurfaceDefinition
+};
+//# sourceMappingURL=clickyMetadata.js.map

package/dist/rpc/clickyMetadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clickyMetadata.js","sources":["../../src/rpc/clickyMetadata.ts"],"sourcesContent":["import type {\n  ClickyOperationMeta,\n  ClickySpecMeta,\n  ClickySurface,\n  DomainDefinition,\n  OpenAPISpec,\n  ResolvedOperation,\n} from \"./types\";\n\nexport function getClickySpecMeta(spec: OpenAPISpec | undefined): ClickySpecMeta | undefined {\n  return spec?.[\"x-clicky\"];\n}\n\nexport function getClickySurfaces(spec: OpenAPISpec | undefined): ClickySurface[] {\n  return getClickySpecMeta(spec)?.surfaces ?? [];\n}\n\nexport function getOperationClickyMeta(\n  operation: Pick<ResolvedOperation, \"operation\">,\n): ClickyOperationMeta | undefined {\n  return operation.operation[\"x-clicky\"];\n}\n\nexport function filterOperationsBySurface(\n  operations: ResolvedOperation[],\n  surfaceKey: string | undefined,\n): ResolvedOperation[] {\n  if (!surfaceKey) return [];\n  return operations.filter(\n    (operation) => getOperationClickyMeta(operation)?.surface === surfaceKey,\n  );\n}\n\nexport function findSurfaceOperation(\n  operations: ResolvedOperation[],\n  surfaceKey: string | undefined,\n  predicate: (meta: ClickyOperationMeta) => boolean,\n): ResolvedOperation | undefined {\n  return filterOperationsBySurface(operations, surfaceKey).find((operation) => {\n    const meta = getOperationClickyMeta(operation);\n    return meta != null && predicate(meta);\n  });\n}\n\nexport function findSurfaceListOperation(\n  operations: ResolvedOperation[],\n  surfaceKey: string | undefined,\n): ResolvedOperation | undefined {\n  return findSurfaceOperation(\n    operations,\n    surfaceKey,\n    (meta) => meta.verb === \"list\" && meta.scope === \"collection\",\n  );\n}\n\nexport function findSurfaceDetailOperation(\n  operations: ResolvedOperation[],\n  surfaceKey: string | undefined,\n): ResolvedOperation | undefined {\n  return findSurfaceOperation(\n    operations,\n    surfaceKey,\n    (meta) => meta.verb === \"get\" && meta.scope === \"entity\",\n  );\n}\n\nexport function findSurfaceCollectionActions(\n  operations: ResolvedOperation[],\n  surfaceKey: string | undefined,\n): ResolvedOperation[] {\n  return filterOperationsBySurface(operations, surfaceKey).filter((operation) => {\n    const meta = getOperationClickyMeta(operation);\n    return meta != null && meta.scope === \"collection\" && meta.verb !== \"list\";\n  });\n}\n\nexport function findSurfaceEntityActions(\n  operations: ResolvedOperation[],\n  surfaceKey: string | undefined,\n): ResolvedOperation[] {\n  return filterOperationsBySurface(operations, surfaceKey).filter((operation) => {\n    const meta = getOperationClickyMeta(operation);\n    return meta != null && meta.scope === \"entity\" && meta.verb !== \"get\";\n  });\n}\n\nexport function makeSurfaceDefinition(surface: ClickySurface): DomainDefinition {\n  return {\n    key: surface.key,\n    title: surface.title,\n    description: surface.description || `Manage ${surface.title.toLowerCase()} resources.`,\n  };\n}\n"],"names":[],"mappings":"AASO,SAAS,kBAAkB,MAA2D;AAC3F,SAAO,6BAAO;AAChB;AAEO,SAAS,kBAAkB,MAAgD;AAJ3E;AAKL,WAAO,uBAAkB,IAAI,MAAtB,mBAAyB,aAAY,CAAA;AAC9C;AAEO,SAAS,uBACd,WACiC;AACjC,SAAO,UAAU,UAAU,UAAU;AACvC;AAEO,SAAS,0BACd,YACA,YACqB;AACrB,MAAI,CAAC,WAAY,QAAO,CAAA;AACxB,SAAO,WAAW;AAAA,IAChB,CAAC,cAAA;AApBE;AAoBY,2CAAuB,SAAS,MAAhC,mBAAmC,aAAY;AAAA;AAAA,EAAA;AAElE;AAEO,SAAS,qBACd,YACA,YACA,WAC+B;AAC/B,SAAO,0BAA0B,YAAY,UAAU,EAAE,KAAK,CAAC,cAAc;AAC3E,UAAM,OAAO,uBAAuB,SAAS;AAC7C,WAAO,QAAQ,QAAQ,UAAU,IAAI;AAAA,EACvC,CAAC;AACH;AAEO,SAAS,yBACd,YACA,YAC+B;AAC/B,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,CAAC,SAAS,KAAK,SAAS,UAAU,KAAK,UAAU;AAAA,EAAA;AAErD;AAEO,SAAS,2BACd,YACA,YAC+B;AAC/B,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,CAAC,SAAS,KAAK,SAAS,SAAS,KAAK,UAAU;AAAA,EAAA;AAEpD;AAEO,SAAS,6BACd,YACA,YACqB;AACrB,SAAO,0BAA0B,YAAY,UAAU,EAAE,OAAO,CAAC,cAAc;AAC7E,UAAM,OAAO,uBAAuB,SAAS;AAC7C,WAAO,QAAQ,QAAQ,KAAK,UAAU,gBAAgB,KAAK,SAAS;AAAA,EACtE,CAAC;AACH;AAEO,SAAS,yBACd,YACA,YACqB;AACrB,SAAO,0BAA0B,YAAY,UAAU,EAAE,OAAO,CAAC,cAAc;AAC7E,UAAM,OAAO,uBAAuB,SAAS;AAC7C,WAAO,QAAQ,QAAQ,KAAK,UAAU,YAAY,KAAK,SAAS;AAAA,EAClE,CAAC;AACH;AAEO,SAAS,sBAAsB,SAA0C;AAC9E,SAAO;AAAA,IACL,KAAK,QAAQ;AAAA,IACb,OAAO,QAAQ;AAAA,IACf,aAAa,QAAQ,eAAe,UAAU,QAAQ,MAAM,aAAa;AAAA,EAAA;AAE7E;"}

package/dist/rpc/formMetadata.d.ts

@@ -0,0 +1,27 @@
+import { Dispatch, SetStateAction } from 'react';
+import { FilterBarFilter, FilterBarMultiFilterMode, FilterBarRangeProps } from '../components/FilterBar';
+import { OpenAPIParameter, OperationLookupResponse } from './types';
+export type ParameterValues = Record<string, string>;
+export type ParameterValuesSetter = Dispatch<SetStateAction<ParameterValues>>;
+export type ParameterFormConfig = {
+    filters: FilterBarFilter[];
+    timeRange?: FilterBarRangeProps;
+};
+export type ParameterFormOptions = {
+    includeLocations?: OpenAPIParameter["in"][];
+    lookup?: OperationLookupResponse | undefined;
+    lockedValues?: ParameterValues | undefined;
+    hideLocked?: boolean;
+};
+export declare function titleCase(value: string): string;
+export declare function defaultValueForParameter(param: OpenAPIParameter, method: string): string;
+export declare function buildInitialParameterValues(parameters: OpenAPIParameter[], method: string, lockedValues?: ParameterValues, initialValues?: ParameterValues): ParameterValues;
+export declare function pruneParameterValues(values: ParameterValues): {
+    [k: string]: string;
+};
+export declare function packParameterValues(values: ParameterValues, parameters: OpenAPIParameter[]): ParameterValues;
+export declare function parametersToFormConfig(parameters: OpenAPIParameter[], values: ParameterValues, setValues: ParameterValuesSetter, options?: ParameterFormOptions): ParameterFormConfig;
+export declare function useDebouncedRecord<T>(value: T, delayMs: number): T;
+export declare function parseMultiFilterValue(value: string): Record<string, FilterBarMultiFilterMode>;
+export declare function serializeMultiFilterValue(value: Record<string, FilterBarMultiFilterMode>): string;
+//# sourceMappingURL=formMetadata.d.ts.map

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

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