@flanksource/clicky-ui 0.1.0 → 0.2.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"EndpointList.d.ts","sourceRoot":"","sources":["../../src/rpc/EndpointList.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAE7E,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEnE,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,SAAS,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAKF,MAAM,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,cAAc,KAAK,YAAY,CAAC;AAEhE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,UAAU,EAAE,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,YAAY,GAAG,kBAAkB,CAAC,CAAC;IAChF,UAAU,EAAE,UAAU,CAAC;IACvB,cAAc,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,iBAAiB,KAAK,MAAM,CAAC;CACzE,CAAC;AAIF,wBAAgB,YAAY,CAAC,EAC3B,UAAU,EACV,UAAU,EACV,UAAU,EACV,cAAmC,GACpC,EAAE,iBAAiB,2CA4DnB"}

package/dist/rpc/EndpointList.js

@@ -0,0 +1,56 @@
+import { jsxs, jsx, Fragment } from "react/jsx-runtime";
+import { useState, useMemo } from "react";
+import { MethodBadge } from "../data/MethodBadge.js";
+const defaultCommandHref = (operationId) => `/commands/${operationId}`;
+function EndpointList({
+  operations,
+  definition,
+  renderLink,
+  getCommandHref = defaultCommandHref
+}) {
+  const [search, setSearch] = useState("");
+  const filtered = useMemo(() => {
+    if (!search) return operations;
+    const q = search.toLowerCase();
+    return operations.filter(
+      (op) => {
+        var _a, _b;
+        return op.path.toLowerCase().includes(q) || ((_a = op.operation.summary) == null ? void 0 : _a.toLowerCase().includes(q)) || ((_b = op.operation.operationId) == null ? void 0 : _b.toLowerCase().includes(q));
+      }
+    );
+  }, [operations, search]);
+  if (operations.length === 0) {
+    return /* @__PURE__ */ jsxs("div", { className: "rounded-xl border border-dashed p-8", children: [
+      /* @__PURE__ */ jsx("h2", { className: "text-lg font-medium", children: definition.emptyTitle || `No ${definition.title} endpoints found` }),
+      /* @__PURE__ */ jsx("p", { className: "mt-2 max-w-2xl text-sm text-muted-foreground", children: definition.emptyDescription || "This area is reserved in the information architecture, but the current OpenAPI surface does not expose matching operations yet." })
+    ] });
+  }
+  return /* @__PURE__ */ jsxs("div", { className: "space-y-4", children: [
+    /* @__PURE__ */ jsx(
+      "input",
+      {
+        placeholder: `Search ${definition.title.toLowerCase()}...`,
+        value: search,
+        onChange: (e) => setSearch(e.target.value),
+        className: "w-full max-w-lg rounded-lg border bg-background px-3 py-2 text-sm outline-none placeholder:text-muted-foreground focus:ring-2 focus:ring-ring"
+      }
+    ),
+    /* @__PURE__ */ jsx("div", { className: "space-y-2", children: filtered.map((op) => {
+      const operationId = op.operation.operationId ?? `${op.method}:${op.path}`;
+      return renderLink({
+        key: `${op.method}:${op.path}`,
+        to: getCommandHref(operationId, op),
+        className: "flex items-center gap-3 rounded-xl border bg-card p-3 transition-colors hover:border-emerald-200 hover:bg-emerald-50/50",
+        children: /* @__PURE__ */ jsxs(Fragment, { children: [
+          /* @__PURE__ */ jsx(MethodBadge, { method: op.method }),
+          /* @__PURE__ */ jsx("code", { className: "text-sm", children: op.path }),
+          op.operation.summary && /* @__PURE__ */ jsx("span", { className: "ml-auto text-xs text-muted-foreground", children: op.operation.summary })
+        ] })
+      });
+    }) })
+  ] });
+}
+export {
+  EndpointList
+};
+//# sourceMappingURL=EndpointList.js.map

package/dist/rpc/EndpointList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EndpointList.js","sources":["../../src/rpc/EndpointList.tsx"],"sourcesContent":["import { useMemo, useState, type ReactElement, type ReactNode } from \"react\";\nimport { MethodBadge } from \"../data/MethodBadge\";\nimport type { DomainDefinition, ResolvedOperation } from \"./types\";\n\nexport type RenderLinkArgs = {\n  to: string;\n  className?: string;\n  children: ReactNode;\n  title?: string;\n  key?: string;\n};\n\n// Render-prop form lets callers pass react-router's Link, a plain <a>, or\n// any custom navigation component without relying on React type equality\n// across nested type installs.\nexport type RenderLink = (args: RenderLinkArgs) => ReactElement;\n\nexport type EndpointListProps = {\n  operations: ResolvedOperation[];\n  definition: Pick<DomainDefinition, \"title\" | \"emptyTitle\" | \"emptyDescription\">;\n  renderLink: RenderLink;\n  getCommandHref?: (operationId: string, op: ResolvedOperation) => string;\n};\n\nconst defaultCommandHref = (operationId: string) => `/commands/${operationId}`;\n\nexport function EndpointList({\n  operations,\n  definition,\n  renderLink,\n  getCommandHref = defaultCommandHref,\n}: EndpointListProps) {\n  const [search, setSearch] = useState(\"\");\n\n  const filtered = useMemo(() => {\n    if (!search) return operations;\n    const q = search.toLowerCase();\n    return operations.filter(\n      (op) =>\n        op.path.toLowerCase().includes(q) ||\n        op.operation.summary?.toLowerCase().includes(q) ||\n        op.operation.operationId?.toLowerCase().includes(q),\n    );\n  }, [operations, search]);\n\n  if (operations.length === 0) {\n    return (\n      <div className=\"rounded-xl border border-dashed p-8\">\n        <h2 className=\"text-lg font-medium\">\n          {definition.emptyTitle || `No ${definition.title} endpoints found`}\n        </h2>\n        <p className=\"mt-2 max-w-2xl text-sm text-muted-foreground\">\n          {definition.emptyDescription ||\n            \"This area is reserved in the information architecture, but the current OpenAPI surface does not expose matching operations yet.\"}\n        </p>\n      </div>\n    );\n  }\n\n  return (\n    <div className=\"space-y-4\">\n      <input\n        placeholder={`Search ${definition.title.toLowerCase()}...`}\n        value={search}\n        onChange={(e) => setSearch(e.target.value)}\n        className=\"w-full max-w-lg rounded-lg border bg-background px-3 py-2 text-sm outline-none placeholder:text-muted-foreground focus:ring-2 focus:ring-ring\"\n      />\n      <div className=\"space-y-2\">\n        {filtered.map((op) => {\n          const operationId = op.operation.operationId ?? `${op.method}:${op.path}`;\n          return renderLink({\n            key: `${op.method}:${op.path}`,\n            to: getCommandHref(operationId, op),\n            className:\n              \"flex items-center gap-3 rounded-xl border bg-card p-3 transition-colors hover:border-emerald-200 hover:bg-emerald-50/50\",\n            children: (\n              <>\n                <MethodBadge method={op.method} />\n                <code className=\"text-sm\">{op.path}</code>\n                {op.operation.summary && (\n                  <span className=\"ml-auto text-xs text-muted-foreground\">\n                    {op.operation.summary}\n                  </span>\n                )}\n              </>\n            ),\n          });\n        })}\n      </div>\n    </div>\n  );\n}\n"],"names":[],"mappings":";;;AAwBA,MAAM,qBAAqB,CAAC,gBAAwB,aAAa,WAAW;AAErE,SAAS,aAAa;AAAA,EAC3B;AAAA,EACA;AAAA,EACA;AAAA,EACA,iBAAiB;AACnB,GAAsB;AACpB,QAAM,CAAC,QAAQ,SAAS,IAAI,SAAS,EAAE;AAEvC,QAAM,WAAW,QAAQ,MAAM;AAC7B,QAAI,CAAC,OAAQ,QAAO;AACpB,UAAM,IAAI,OAAO,YAAA;AACjB,WAAO,WAAW;AAAA,MAChB,CAAC;;AACC,kBAAG,KAAK,cAAc,SAAS,CAAC,OAChC,QAAG,UAAU,YAAb,mBAAsB,cAAc,SAAS,SAC7C,QAAG,UAAU,gBAAb,mBAA0B,cAAc,SAAS;AAAA;AAAA,IAAC;AAAA,EAExD,GAAG,CAAC,YAAY,MAAM,CAAC;AAEvB,MAAI,WAAW,WAAW,GAAG;AAC3B,WACE,qBAAC,OAAA,EAAI,WAAU,uCACb,UAAA;AAAA,MAAA,oBAAC,MAAA,EAAG,WAAU,uBACX,UAAA,WAAW,cAAc,MAAM,WAAW,KAAK,mBAAA,CAClD;AAAA,0BACC,KAAA,EAAE,WAAU,gDACV,UAAA,WAAW,oBACV,kIAAA,CACJ;AAAA,IAAA,GACF;AAAA,EAEJ;AAEA,SACE,qBAAC,OAAA,EAAI,WAAU,aACb,UAAA;AAAA,IAAA;AAAA,MAAC;AAAA,MAAA;AAAA,QACC,aAAa,UAAU,WAAW,MAAM,aAAa;AAAA,QACrD,OAAO;AAAA,QACP,UAAU,CAAC,MAAM,UAAU,EAAE,OAAO,KAAK;AAAA,QACzC,WAAU;AAAA,MAAA;AAAA,IAAA;AAAA,wBAEX,OAAA,EAAI,WAAU,aACZ,UAAA,SAAS,IAAI,CAAC,OAAO;AACpB,YAAM,cAAc,GAAG,UAAU,eAAe,GAAG,GAAG,MAAM,IAAI,GAAG,IAAI;AACvE,aAAO,WAAW;AAAA,QAChB,KAAK,GAAG,GAAG,MAAM,IAAI,GAAG,IAAI;AAAA,QAC5B,IAAI,eAAe,aAAa,EAAE;AAAA,QAClC,WACE;AAAA,QACF,UACE,qBAAA,UAAA,EACE,UAAA;AAAA,UAAA,oBAAC,aAAA,EAAY,QAAQ,GAAG,OAAA,CAAQ;AAAA,UAChC,oBAAC,QAAA,EAAK,WAAU,WAAW,aAAG,MAAK;AAAA,UAClC,GAAG,UAAU,WACZ,oBAAC,UAAK,WAAU,yCACb,UAAA,GAAG,UAAU,QAAA,CAChB;AAAA,QAAA,EAAA,CAEJ;AAAA,MAAA,CAEH;AAAA,IACH,CAAC,EAAA,CACH;AAAA,EAAA,GACF;AAEJ;"}

package/dist/rpc/EntityExplorerApp.d.ts

@@ -0,0 +1,15 @@
+import { AnyApiReferenceConfiguration } from '@scalar/api-reference-react';
+import { RenderLink } from './EndpointList';
+import { OperationsApiClient } from './useOperations';
+export type EntityExplorerAppProps = {
+    client: OperationsApiClient;
+    pathname: string;
+    renderLink: RenderLink;
+    basePath?: string;
+    showApiExplorer?: boolean;
+    apiExplorerMode?: "scalar" | "operations";
+    apiExplorerUrl?: string;
+    apiExplorerConfiguration?: AnyApiReferenceConfiguration;
+};
+export declare function EntityExplorerApp({ client, pathname, renderLink, basePath, showApiExplorer, apiExplorerMode, apiExplorerUrl, apiExplorerConfiguration, }: EntityExplorerAppProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=EntityExplorerApp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EntityExplorerApp.d.ts","sourceRoot":"","sources":["../../src/rpc/EntityExplorerApp.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAC;AAKhF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAKjD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAG3D,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,UAAU,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,eAAe,CAAC,EAAE,QAAQ,GAAG,YAAY,CAAC;IAC1C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wBAAwB,CAAC,EAAE,4BAA4B,CAAC;CACzD,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,EAChC,MAAM,EACN,QAAQ,EACR,UAAU,EACV,QAAa,EACb,eAAsB,EACtB,eAA0B,EAC1B,cAAc,EACd,wBAAwB,GACzB,EAAE,sBAAsB,2CAsJxB"}

package/dist/rpc/EntityExplorerApp.js

@@ -0,0 +1,282 @@
+import { jsxs, jsx } from "react/jsx-runtime";
+import { useMemo, useEffect } from "react";
+import { ThemeSwitcher } from "../components/theme-switcher.js";
+import { ApiExplorer } from "./ApiExplorer.js";
+import { getClickySurfaces, makeSurfaceDefinition } from "./clickyMetadata.js";
+import { OperationCatalog } from "./OperationCatalog.js";
+import { OperationCommandPage } from "./OperationCommandPage.js";
+import { OperationEntityPage } from "./OperationEntityPage.js";
+import { useOperations } from "./useOperations.js";
+function EntityExplorerApp({
+  client,
+  pathname,
+  renderLink,
+  basePath = "",
+  showApiExplorer = true,
+  apiExplorerMode = "scalar",
+  apiExplorerUrl,
+  apiExplorerConfiguration
+}) {
+  const { spec } = useOperations(client);
+  const surfaces = useMemo(() => getClickySurfaces(spec), [spec]);
+  const defaultSurface = useMemo(
+    () => surfaces.find((surface) => !surface.admin) ?? surfaces[0],
+    [surfaces]
+  );
+  const relativePath = useMemo(() => stripBasePath(pathname, basePath), [basePath, pathname]);
+  const route = useMemo(() => parseExplorerRoute(relativePath), [relativePath]);
+  const resolvedRoute = useMemo(() => resolveRouteSurface(route, surfaces), [route, surfaces]);
+  const commandRuntime = useMemo(
+    () => ({
+      client,
+      hrefForCommand: (resolved) => buildCommandHref(basePath, resolved),
+      onNavigate: (resolved) => {
+        const href = buildCommandHref(basePath, resolved);
+        if (!href || typeof window === "undefined") return;
+        window.history.pushState(window.history.state, "", href);
+        window.dispatchEvent(new PopStateEvent("popstate"));
+      }
+    }),
+    [basePath, client]
+  );
+  const { initialValues: commandInitialValues, autoRun: commandAutoRun } = useMemo(
+    () => resolvedRoute.kind === "command" ? readCommandQueryParams() : { initialValues: {}, autoRun: false },
+    [resolvedRoute.kind, pathname]
+  );
+  const explorerDefinition = useMemo(
+    () => ({
+      key: "explorer",
+      title: "API Explorer",
+      description: "Every operation exposed by the current OpenAPI spec."
+    }),
+    []
+  );
+  useEffect(() => {
+    if (typeof window === "undefined" || defaultSurface == null || relativePath !== "/" || window.location.pathname !== withBasePath(basePath, "/")) {
+      return;
+    }
+    const target = withBasePath(basePath, `/${defaultSurface.key}`);
+    window.history.replaceState(window.history.state, "", target);
+    window.dispatchEvent(new PopStateEvent("popstate"));
+  }, [basePath, defaultSurface, relativePath]);
+  return /* @__PURE__ */ jsxs("div", { className: "flex h-full", children: [
+    /* @__PURE__ */ jsxs("aside", { className: "flex w-64 shrink-0 flex-col border-r border-border bg-muted/30 p-4", children: [
+      /* @__PURE__ */ jsxs("div", { className: "mb-6", children: [
+        /* @__PURE__ */ jsx("div", { className: "text-sm font-semibold", children: (spec == null ? void 0 : spec.info.title) ?? "Clicky Explorer" }),
+        /* @__PURE__ */ jsx("div", { className: "text-xs text-muted-foreground", children: "Metadata-driven entity explorer" })
+      ] }),
+      /* @__PURE__ */ jsxs("nav", { className: "flex flex-col gap-1", children: [
+        surfaces.map(
+          (surface) => renderLink({
+            key: surface.key,
+            to: withBasePath(basePath, `/${surface.key}`),
+            className: navLinkClassName(isSurfaceRouteActive(resolvedRoute, surface.key)),
+            children: surface.title
+          })
+        ),
+        showApiExplorer && renderLink({
+          key: explorerDefinition.key,
+          to: withBasePath(basePath, "/explorer"),
+          className: navLinkClassName(
+            resolvedRoute.kind === "explorer" || resolvedRoute.kind === "command"
+          ),
+          children: explorerDefinition.title
+        })
+      ] }),
+      /* @__PURE__ */ jsx("div", { className: "mt-auto pt-4", children: /* @__PURE__ */ jsx(ThemeSwitcher, {}) })
+    ] }),
+    /* @__PURE__ */ jsx("main", { className: "flex-1 overflow-auto p-6", children: resolvedRoute.kind === "surface" ? resolvedRoute.surface ? /* @__PURE__ */ jsx(
+      OperationCatalog,
+      {
+        definition: makeSurfaceDefinition(resolvedRoute.surface),
+        entities: [resolvedRoute.surface.entity],
+        client,
+        renderLink,
+        surfaceKey: resolvedRoute.surface.key,
+        commandRuntime
+      }
+    ) : /* @__PURE__ */ jsx(UnknownSurface, { surfaceKey: resolvedRoute.surfaceKey }) : resolvedRoute.kind === "entity" ? resolvedRoute.surface ? /* @__PURE__ */ jsx(
+      OperationEntityPage,
+      {
+        definition: makeSurfaceDefinition(resolvedRoute.surface),
+        entities: [resolvedRoute.surface.entity],
+        client,
+        renderLink,
+        surfaceKey: resolvedRoute.surface.key,
+        backHref: withBasePath(basePath, `/${resolvedRoute.surface.key}`),
+        backLabel: `Back to ${resolvedRoute.surface.title}`,
+        commandRuntime,
+        ...resolvedRoute.id ? { id: resolvedRoute.id } : {}
+      }
+    ) : /* @__PURE__ */ jsx(UnknownSurface, { surfaceKey: resolvedRoute.surfaceKey }) : resolvedRoute.kind === "command" ? /* @__PURE__ */ jsx(
+      OperationCommandPage,
+      {
+        client,
+        backHref: withBasePath(basePath, "/explorer"),
+        backLabel: "Back to API Explorer",
+        renderLink,
+        commandRuntime,
+        initialValues: commandInitialValues,
+        autoRun: commandAutoRun,
+        ...resolvedRoute.operationId ? { operationId: resolvedRoute.operationId } : {}
+      }
+    ) : resolvedRoute.kind === "explorer" ? apiExplorerMode === "scalar" ? /* @__PURE__ */ jsx(
+      ApiExplorer,
+      {
+        ...apiExplorerUrl ? { openApiUrl: apiExplorerUrl } : {},
+        ...apiExplorerConfiguration ? { configuration: apiExplorerConfiguration } : {}
+      }
+    ) : /* @__PURE__ */ jsx(
+      OperationCatalog,
+      {
+        definition: explorerDefinition,
+        entities: [],
+        allOperations: true,
+        client,
+        renderLink,
+        commandRuntime
+      }
+    ) : defaultSurface == null ? /* @__PURE__ */ jsx("div", { className: "text-sm text-muted-foreground", children: "Loading surfaces…" }) : /* @__PURE__ */ jsx("div", { className: "text-sm text-muted-foreground", children: "Redirecting…" }) })
+  ] });
+}
+function parseExplorerRoute(pathname) {
+  const normalized = trimTrailingSlash(pathname) || "/";
+  if (normalized === "/") {
+    return { kind: "root" };
+  }
+  const segments = normalized.replace(/^\/+/, "").split("/");
+  if (segments[0] === "explorer") {
+    return { kind: "explorer" };
+  }
+  if (segments[0] === "commands") {
+    return segments[1] ? { kind: "command", operationId: segments[1] } : { kind: "command" };
+  }
+  const surfaceKey = segments[0] ?? "";
+  if (segments[1]) {
+    return {
+      kind: "entity",
+      surfaceKey,
+      id: decodeURIComponent(segments[1])
+    };
+  }
+  return { kind: "surface", surfaceKey };
+}
+function resolveRouteSurface(route, surfaces) {
+  if (route.kind !== "surface" && route.kind !== "entity") {
+    return route;
+  }
+  const surface = surfaces.find((item) => item.key === route.surfaceKey);
+  return surface ? { ...route, surface } : route;
+}
+function isSurfaceRouteActive(route, surfaceKey) {
+  return route.kind === "surface" && route.surfaceKey === surfaceKey || route.kind === "entity" && route.surfaceKey === surfaceKey;
+}
+function navLinkClassName(active) {
+  return [
+    "rounded-md px-2 py-1.5 text-sm transition-colors",
+    active ? "bg-accent text-accent-foreground" : "text-foreground hover:bg-accent"
+  ].join(" ");
+}
+function stripBasePath(pathname, basePath) {
+  const base = trimTrailingSlash(basePath);
+  if (!base || base === "/") {
+    return trimTrailingSlash(pathname) || "/";
+  }
+  if (pathname === base) {
+    return "/";
+  }
+  if (pathname.startsWith(`${base}/`)) {
+    return trimTrailingSlash(pathname.slice(base.length)) || "/";
+  }
+  return trimTrailingSlash(pathname) || "/";
+}
+function withBasePath(basePath, pathname) {
+  const base = trimTrailingSlash(basePath);
+  if (!base || base === "/") {
+    return pathname;
+  }
+  return `${base}${pathname}`;
+}
+function trimTrailingSlash(value) {
+  if (!value) return "";
+  return value.length > 1 ? value.replace(/\/+$/, "") : value;
+}
+function UnknownSurface({ surfaceKey }) {
+  return /* @__PURE__ */ jsxs("div", { className: "p-6 text-sm text-muted-foreground", children: [
+    "Unknown surface: ",
+    /* @__PURE__ */ jsx("code", { children: surfaceKey })
+  ] });
+}
+const AUTORUN_QUERY_PARAM = "__autoRun";
+const ARG_QUERY_PREFIX = "__arg";
+function buildCommandHref(basePath, resolved) {
+  var _a, _b;
+  const commandId = ((_a = resolved.operation) == null ? void 0 : _a.operation.operationId) ?? resolved.request.command;
+  if (!commandId) return void 0;
+  const meta = (_b = resolved.operation) == null ? void 0 : _b.operation["x-clicky"];
+  const args = resolved.request.args ?? [];
+  const flags = resolved.request.flags ?? {};
+  if ((meta == null ? void 0 : meta.verb) === "get" && (meta == null ? void 0 : meta.scope) === "entity" && meta.surface && args[0]) {
+    const search2 = new URLSearchParams();
+    for (const [key, value] of Object.entries(flags)) {
+      if (value !== void 0 && value !== "") {
+        search2.set(key, value);
+      }
+    }
+    const query2 = search2.toString();
+    const suffix2 = query2 ? `?${query2}` : "";
+    return withBasePath(
+      basePath,
+      `/${encodeURIComponent(meta.surface)}/${encodeURIComponent(args[0])}${suffix2}`
+    );
+  }
+  const search = new URLSearchParams();
+  args.forEach((value, index) => {
+    if (value !== void 0 && value !== "") {
+      search.set(`${ARG_QUERY_PREFIX}${index}`, value);
+    }
+  });
+  for (const [key, value] of Object.entries(flags)) {
+    if (value !== void 0 && value !== "") {
+      search.set(key, value);
+    }
+  }
+  if (resolved.request.autoRun) {
+    search.set(AUTORUN_QUERY_PARAM, "1");
+  }
+  const query = search.toString();
+  const suffix = query ? `?${query}` : "";
+  return withBasePath(basePath, `/commands/${encodeURIComponent(commandId)}${suffix}`);
+}
+function readCommandQueryParams() {
+  if (typeof window === "undefined") {
+    return { initialValues: {}, autoRun: false };
+  }
+  const search = new URLSearchParams(window.location.search);
+  const initialValues = {};
+  let autoRun = false;
+  const positional = [];
+  for (const [key, value] of search.entries()) {
+    if (key === AUTORUN_QUERY_PARAM) {
+      autoRun = value === "1" || value === "true";
+      continue;
+    }
+    if (key.startsWith(ARG_QUERY_PREFIX)) {
+      const index = Number.parseInt(key.slice(ARG_QUERY_PREFIX.length), 10);
+      if (Number.isFinite(index) && index >= 0) {
+        positional[index] = value;
+      }
+      continue;
+    }
+    initialValues[key] = value;
+  }
+  const packedArgs = positional.filter((value) => value !== void 0).join(" ");
+  if (packedArgs !== "") {
+    initialValues.args = packedArgs;
+  }
+  return { initialValues, autoRun };
+}
+export {
+  EntityExplorerApp
+};
+//# sourceMappingURL=EntityExplorerApp.js.map

package/dist/rpc/EntityExplorerApp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityExplorerApp.js","sources":["../../src/rpc/EntityExplorerApp.tsx"],"sourcesContent":["import { useEffect, useMemo } from \"react\";\nimport type { AnyApiReferenceConfiguration } from \"@scalar/api-reference-react\";\nimport { ThemeSwitcher } from \"../components/theme-switcher\";\nimport type { ClickyCommandRuntime, ClickyResolvedCommand } from \"../data/Clicky\";\nimport { ApiExplorer } from \"./ApiExplorer\";\nimport { getClickySurfaces, makeSurfaceDefinition } from \"./clickyMetadata\";\nimport type { RenderLink } from \"./EndpointList\";\nimport { OperationCatalog } from \"./OperationCatalog\";\nimport { OperationCommandPage } from \"./OperationCommandPage\";\nimport { OperationEntityPage } from \"./OperationEntityPage\";\nimport type { ClickySurface } from \"./types\";\nimport type { OperationsApiClient } from \"./useOperations\";\nimport { useOperations } from \"./useOperations\";\n\nexport type EntityExplorerAppProps = {\n  client: OperationsApiClient;\n  pathname: string;\n  renderLink: RenderLink;\n  basePath?: string;\n  showApiExplorer?: boolean;\n  apiExplorerMode?: \"scalar\" | \"operations\";\n  apiExplorerUrl?: string;\n  apiExplorerConfiguration?: AnyApiReferenceConfiguration;\n};\n\nexport function EntityExplorerApp({\n  client,\n  pathname,\n  renderLink,\n  basePath = \"\",\n  showApiExplorer = true,\n  apiExplorerMode = \"scalar\",\n  apiExplorerUrl,\n  apiExplorerConfiguration,\n}: EntityExplorerAppProps) {\n  const { spec } = useOperations(client);\n  const surfaces = useMemo(() => getClickySurfaces(spec), [spec]);\n  const defaultSurface = useMemo(\n    () => surfaces.find((surface) => !surface.admin) ?? surfaces[0],\n    [surfaces],\n  );\n  const relativePath = useMemo(() => stripBasePath(pathname, basePath), [basePath, pathname]);\n  const route = useMemo(() => parseExplorerRoute(relativePath), [relativePath]);\n  const resolvedRoute = useMemo(() => resolveRouteSurface(route, surfaces), [route, surfaces]);\n  const commandRuntime = useMemo<ClickyCommandRuntime>(\n    () => ({\n      client,\n      hrefForCommand: (resolved) => buildCommandHref(basePath, resolved),\n      onNavigate: (resolved) => {\n        const href = buildCommandHref(basePath, resolved);\n        if (!href || typeof window === \"undefined\") return;\n        window.history.pushState(window.history.state, \"\", href);\n        window.dispatchEvent(new PopStateEvent(\"popstate\"));\n      },\n    }),\n    [basePath, client],\n  );\n  const { initialValues: commandInitialValues, autoRun: commandAutoRun } = useMemo(\n    () =>\n      resolvedRoute.kind === \"command\"\n        ? readCommandQueryParams()\n        : { initialValues: {}, autoRun: false },\n    [resolvedRoute.kind, pathname],\n  );\n  const explorerDefinition = useMemo(\n    () => ({\n      key: \"explorer\",\n      title: \"API Explorer\",\n      description: \"Every operation exposed by the current OpenAPI spec.\",\n    }),\n    [],\n  );\n\n  useEffect(() => {\n    if (\n      typeof window === \"undefined\" ||\n      defaultSurface == null ||\n      relativePath !== \"/\" ||\n      window.location.pathname !== withBasePath(basePath, \"/\")\n    ) {\n      return;\n    }\n\n    const target = withBasePath(basePath, `/${defaultSurface.key}`);\n    window.history.replaceState(window.history.state, \"\", target);\n    window.dispatchEvent(new PopStateEvent(\"popstate\"));\n  }, [basePath, defaultSurface, relativePath]);\n\n  return (\n    <div className=\"flex h-full\">\n      <aside className=\"flex w-64 shrink-0 flex-col border-r border-border bg-muted/30 p-4\">\n        <div className=\"mb-6\">\n          <div className=\"text-sm font-semibold\">{spec?.info.title ?? \"Clicky Explorer\"}</div>\n          <div className=\"text-xs text-muted-foreground\">Metadata-driven entity explorer</div>\n        </div>\n        <nav className=\"flex flex-col gap-1\">\n          {surfaces.map((surface) =>\n            renderLink({\n              key: surface.key,\n              to: withBasePath(basePath, `/${surface.key}`),\n              className: navLinkClassName(isSurfaceRouteActive(resolvedRoute, surface.key)),\n              children: surface.title,\n            }),\n          )}\n          {showApiExplorer &&\n            renderLink({\n              key: explorerDefinition.key,\n              to: withBasePath(basePath, \"/explorer\"),\n              className: navLinkClassName(\n                resolvedRoute.kind === \"explorer\" || resolvedRoute.kind === \"command\",\n              ),\n              children: explorerDefinition.title,\n            })}\n        </nav>\n        <div className=\"mt-auto pt-4\">\n          <ThemeSwitcher />\n        </div>\n      </aside>\n\n      <main className=\"flex-1 overflow-auto p-6\">\n        {resolvedRoute.kind === \"surface\" ? (\n          resolvedRoute.surface ? (\n            <OperationCatalog\n              definition={makeSurfaceDefinition(resolvedRoute.surface)}\n              entities={[resolvedRoute.surface.entity]}\n              client={client}\n              renderLink={renderLink}\n              surfaceKey={resolvedRoute.surface.key}\n              commandRuntime={commandRuntime}\n            />\n          ) : (\n            <UnknownSurface surfaceKey={resolvedRoute.surfaceKey} />\n          )\n        ) : resolvedRoute.kind === \"entity\" ? (\n          resolvedRoute.surface ? (\n            <OperationEntityPage\n              definition={makeSurfaceDefinition(resolvedRoute.surface)}\n              entities={[resolvedRoute.surface.entity]}\n              client={client}\n              renderLink={renderLink}\n              surfaceKey={resolvedRoute.surface.key}\n              backHref={withBasePath(basePath, `/${resolvedRoute.surface.key}`)}\n              backLabel={`Back to ${resolvedRoute.surface.title}`}\n              commandRuntime={commandRuntime}\n              {...(resolvedRoute.id ? { id: resolvedRoute.id } : {})}\n            />\n          ) : (\n            <UnknownSurface surfaceKey={resolvedRoute.surfaceKey} />\n          )\n        ) : resolvedRoute.kind === \"command\" ? (\n          <OperationCommandPage\n            client={client}\n            backHref={withBasePath(basePath, \"/explorer\")}\n            backLabel=\"Back to API Explorer\"\n            renderLink={renderLink}\n            commandRuntime={commandRuntime}\n            initialValues={commandInitialValues}\n            autoRun={commandAutoRun}\n            {...(resolvedRoute.operationId ? { operationId: resolvedRoute.operationId } : {})}\n          />\n        ) : resolvedRoute.kind === \"explorer\" ? (\n          apiExplorerMode === \"scalar\" ? (\n            <ApiExplorer\n              {...(apiExplorerUrl ? { openApiUrl: apiExplorerUrl } : {})}\n              {...(apiExplorerConfiguration ? { configuration: apiExplorerConfiguration } : {})}\n            />\n          ) : (\n            <OperationCatalog\n              definition={explorerDefinition}\n              entities={[]}\n              allOperations\n              client={client}\n              renderLink={renderLink}\n              commandRuntime={commandRuntime}\n            />\n          )\n        ) : defaultSurface == null ? (\n          <div className=\"text-sm text-muted-foreground\">Loading surfaces…</div>\n        ) : (\n          <div className=\"text-sm text-muted-foreground\">Redirecting…</div>\n        )}\n      </main>\n    </div>\n  );\n}\n\ntype ExplorerRoute =\n  | { kind: \"root\" }\n  | { kind: \"explorer\" }\n  | { kind: \"command\"; operationId?: string }\n  | { kind: \"surface\"; surfaceKey: string; surface?: ClickySurface }\n  | {\n      kind: \"entity\";\n      surfaceKey: string;\n      surface?: ClickySurface;\n      id?: string;\n    };\n\nfunction parseExplorerRoute(pathname: string): ExplorerRoute {\n  const normalized = trimTrailingSlash(pathname) || \"/\";\n  if (normalized === \"/\") {\n    return { kind: \"root\" };\n  }\n\n  const segments = normalized.replace(/^\\/+/, \"\").split(\"/\");\n  if (segments[0] === \"explorer\") {\n    return { kind: \"explorer\" };\n  }\n  if (segments[0] === \"commands\") {\n    return segments[1] ? { kind: \"command\", operationId: segments[1] } : { kind: \"command\" };\n  }\n  const surfaceKey = segments[0] ?? \"\";\n  if (segments[1]) {\n    return {\n      kind: \"entity\",\n      surfaceKey,\n      id: decodeURIComponent(segments[1]),\n    };\n  }\n  return { kind: \"surface\", surfaceKey };\n}\n\nfunction resolveRouteSurface(route: ExplorerRoute, surfaces: ClickySurface[]): ExplorerRoute {\n  if (route.kind !== \"surface\" && route.kind !== \"entity\") {\n    return route;\n  }\n  const surface = surfaces.find((item) => item.key === route.surfaceKey);\n  return surface ? { ...route, surface } : route;\n}\n\nfunction isSurfaceRouteActive(route: ExplorerRoute, surfaceKey: string) {\n  return (\n    (route.kind === \"surface\" && route.surfaceKey === surfaceKey) ||\n    (route.kind === \"entity\" && route.surfaceKey === surfaceKey)\n  );\n}\n\nfunction navLinkClassName(active: boolean) {\n  return [\n    \"rounded-md px-2 py-1.5 text-sm transition-colors\",\n    active ? \"bg-accent text-accent-foreground\" : \"text-foreground hover:bg-accent\",\n  ].join(\" \");\n}\n\nfunction stripBasePath(pathname: string, basePath: string) {\n  const base = trimTrailingSlash(basePath);\n  if (!base || base === \"/\") {\n    return trimTrailingSlash(pathname) || \"/\";\n  }\n  if (pathname === base) {\n    return \"/\";\n  }\n  if (pathname.startsWith(`${base}/`)) {\n    return trimTrailingSlash(pathname.slice(base.length)) || \"/\";\n  }\n  return trimTrailingSlash(pathname) || \"/\";\n}\n\nfunction withBasePath(basePath: string, pathname: string) {\n  const base = trimTrailingSlash(basePath);\n  if (!base || base === \"/\") {\n    return pathname;\n  }\n  return `${base}${pathname}`;\n}\n\nfunction trimTrailingSlash(value: string) {\n  if (!value) return \"\";\n  return value.length > 1 ? value.replace(/\\/+$/, \"\") : value;\n}\n\nfunction UnknownSurface({ surfaceKey }: { surfaceKey: string }) {\n  return (\n    <div className=\"p-6 text-sm text-muted-foreground\">\n      Unknown surface: <code>{surfaceKey}</code>\n    </div>\n  );\n}\n\nconst AUTORUN_QUERY_PARAM = \"__autoRun\";\nconst ARG_QUERY_PREFIX = \"__arg\";\n\nfunction buildCommandHref(basePath: string, resolved: ClickyResolvedCommand): string | undefined {\n  const commandId = resolved.operation?.operation.operationId ?? resolved.request.command;\n  if (!commandId) return undefined;\n\n  const meta = resolved.operation?.operation[\"x-clicky\"];\n  const args = resolved.request.args ?? [];\n  const flags = resolved.request.flags ?? {};\n\n  // Entity `get` commands route to the surface detail URL: /<surface>/<id>?<flags>\n  if (meta?.verb === \"get\" && meta?.scope === \"entity\" && meta.surface && args[0]) {\n    const search = new URLSearchParams();\n    for (const [key, value] of Object.entries(flags)) {\n      if (value !== undefined && value !== \"\") {\n        search.set(key, value);\n      }\n    }\n    const query = search.toString();\n    const suffix = query ? `?${query}` : \"\";\n    return withBasePath(\n      basePath,\n      `/${encodeURIComponent(meta.surface)}/${encodeURIComponent(args[0])}${suffix}`,\n    );\n  }\n\n  const search = new URLSearchParams();\n  args.forEach((value, index) => {\n    if (value !== undefined && value !== \"\") {\n      search.set(`${ARG_QUERY_PREFIX}${index}`, value);\n    }\n  });\n  for (const [key, value] of Object.entries(flags)) {\n    if (value !== undefined && value !== \"\") {\n      search.set(key, value);\n    }\n  }\n  if (resolved.request.autoRun) {\n    search.set(AUTORUN_QUERY_PARAM, \"1\");\n  }\n\n  const query = search.toString();\n  const suffix = query ? `?${query}` : \"\";\n  return withBasePath(basePath, `/commands/${encodeURIComponent(commandId)}${suffix}`);\n}\n\nfunction readCommandQueryParams(): { initialValues: Record<string, string>; autoRun: boolean } {\n  if (typeof window === \"undefined\") {\n    return { initialValues: {}, autoRun: false };\n  }\n  const search = new URLSearchParams(window.location.search);\n  const initialValues: Record<string, string> = {};\n  let autoRun = false;\n  const positional: string[] = [];\n\n  for (const [key, value] of search.entries()) {\n    if (key === AUTORUN_QUERY_PARAM) {\n      autoRun = value === \"1\" || value === \"true\";\n      continue;\n    }\n    if (key.startsWith(ARG_QUERY_PREFIX)) {\n      const index = Number.parseInt(key.slice(ARG_QUERY_PREFIX.length), 10);\n      if (Number.isFinite(index) && index >= 0) {\n        positional[index] = value;\n      }\n      continue;\n    }\n    initialValues[key] = value;\n  }\n\n  const packedArgs = positional.filter((value) => value !== undefined).join(\" \");\n  if (packedArgs !== \"\") {\n    initialValues.args = packedArgs;\n  }\n\n  return { initialValues, autoRun };\n}\n"],"names":["search","query","suffix"],"mappings":"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"}

package/dist/rpc/ExecutionResult.d.ts

@@ -0,0 +1,14 @@
+import { ClickyCommandRuntime, ClickyTableRowHref, ClickyTableRowClick, ClickyTableRowPredicate } from '../data/Clicky';
+import { ExecutionResponse } from './types';
+export type ExecutionResultProps = {
+    response?: ExecutionResponse | null;
+    emptyMessage?: string;
+    ariaLabel?: string;
+    className?: string;
+    commandRuntime?: ClickyCommandRuntime;
+    onTableRowClick?: ClickyTableRowClick;
+    getTableRowHref?: ClickyTableRowHref;
+    isTableRowClickable?: ClickyTableRowPredicate;
+};
+export declare function ExecutionResult({ response, emptyMessage, ariaLabel, className, commandRuntime, onTableRowClick, getTableRowHref, isTableRowClickable, }: ExecutionResultProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ExecutionResult.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ExecutionResult.d.ts","sourceRoot":"","sources":["../../src/rpc/ExecutionResult.tsx"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,oBAAoB,EAGzB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC7B,MAAM,gBAAgB,CAAC;AAGxB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,oBAAoB,CAAC;IACtC,eAAe,CAAC,EAAE,mBAAmB,CAAC;IACtC,eAAe,CAAC,EAAE,kBAAkB,CAAC;IACrC,mBAAmB,CAAC,EAAE,uBAAuB,CAAC;CAC/C,CAAC;AAEF,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,EACR,YAAiC,EACjC,SAA2B,EAC3B,SAAS,EACT,cAAc,EACd,eAAe,EACf,eAAe,EACf,mBAAmB,GACpB,EAAE,oBAAoB,2CA+CtB"}

package/dist/rpc/ExecutionResult.js

@@ -0,0 +1,51 @@
+import { jsx } from "react/jsx-runtime";
+import { parseClickyData, Clicky } from "../data/Clicky.js";
+import { cn } from "../lib/utils.js";
+import { parseJsonBody } from "./classify.js";
+function ExecutionResult({
+  response,
+  emptyMessage = "No response yet.",
+  ariaLabel = "Response body",
+  className,
+  commandRuntime,
+  onTableRowClick,
+  getTableRowHref,
+  isTableRowClickable
+}) {
+  if (!response) {
+    return /* @__PURE__ */ jsx("p", { className: cn("mt-3 text-sm text-muted-foreground", className), children: emptyMessage });
+  }
+  const rawText = response.stdout || response.output || response.message || "";
+  const parsedPayload = response.parsed ?? parseJsonBody(response);
+  const clickyPayload = typeof parsedPayload === "string" || parsedPayload != null && typeof parsedPayload === "object" ? parsedPayload : rawText;
+  const parsedClicky = clickyPayload === "" ? null : parseClickyData(clickyPayload);
+  if (parsedClicky == null ? void 0 : parsedClicky.ok) {
+    return /* @__PURE__ */ jsx("div", { role: "region", "aria-label": ariaLabel, className: cn("mt-3", className), children: /* @__PURE__ */ jsx(
+      Clicky,
+      {
+        data: parsedClicky.document,
+        ...response.requestUrl ? { url: response.requestUrl } : {},
+        ...commandRuntime ? { commandRuntime } : {},
+        ...onTableRowClick ? { onTableRowClick } : {},
+        ...getTableRowHref ? { getTableRowHref } : {},
+        ...isTableRowClickable ? { isTableRowClickable } : {}
+      }
+    ) });
+  }
+  const renderedText = parsedPayload != null ? JSON.stringify(parsedPayload, null, 2) : rawText;
+  if (!renderedText) {
+    return /* @__PURE__ */ jsx("p", { className: cn("mt-3 text-sm text-muted-foreground", className), children: "Response completed with no body." });
+  }
+  return /* @__PURE__ */ jsx(
+    "pre",
+    {
+      "aria-label": ariaLabel,
+      className: cn("mt-3 overflow-auto rounded-md bg-muted p-4 text-xs", className),
+      children: renderedText
+    }
+  );
+}
+export {
+  ExecutionResult
+};
+//# sourceMappingURL=ExecutionResult.js.map

package/dist/rpc/ExecutionResult.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExecutionResult.js","sources":["../../src/rpc/ExecutionResult.tsx"],"sourcesContent":["import {\n  Clicky,\n  parseClickyData,\n  type ClickyCommandRuntime,\n  type ClickyDocument,\n  type ClickyNode,\n  type ClickyTableRowHref,\n  type ClickyTableRowClick,\n  type ClickyTableRowPredicate,\n} from \"../data/Clicky\";\nimport { cn } from \"../lib/utils\";\nimport { parseJsonBody } from \"./classify\";\nimport type { ExecutionResponse } from \"./types\";\n\nexport type ExecutionResultProps = {\n  response?: ExecutionResponse | null;\n  emptyMessage?: string;\n  ariaLabel?: string;\n  className?: string;\n  commandRuntime?: ClickyCommandRuntime;\n  onTableRowClick?: ClickyTableRowClick;\n  getTableRowHref?: ClickyTableRowHref;\n  isTableRowClickable?: ClickyTableRowPredicate;\n};\n\nexport function ExecutionResult({\n  response,\n  emptyMessage = \"No response yet.\",\n  ariaLabel = \"Response body\",\n  className,\n  commandRuntime,\n  onTableRowClick,\n  getTableRowHref,\n  isTableRowClickable,\n}: ExecutionResultProps) {\n  if (!response) {\n    return <p className={cn(\"mt-3 text-sm text-muted-foreground\", className)}>{emptyMessage}</p>;\n  }\n\n  const rawText = response.stdout || response.output || response.message || \"\";\n  const parsedPayload = response.parsed ?? parseJsonBody(response);\n  const clickyPayload: string | ClickyNode | ClickyDocument | undefined =\n    typeof parsedPayload === \"string\" ||\n    (parsedPayload != null && typeof parsedPayload === \"object\")\n      ? (parsedPayload as ClickyNode | ClickyDocument)\n      : rawText;\n  const parsedClicky = clickyPayload === \"\" ? null : parseClickyData(clickyPayload);\n\n  if (parsedClicky?.ok) {\n    return (\n      <div role=\"region\" aria-label={ariaLabel} className={cn(\"mt-3\", className)}>\n        <Clicky\n          data={parsedClicky.document}\n          {...(response.requestUrl ? { url: response.requestUrl } : {})}\n          {...(commandRuntime ? { commandRuntime } : {})}\n          {...(onTableRowClick ? { onTableRowClick } : {})}\n          {...(getTableRowHref ? { getTableRowHref } : {})}\n          {...(isTableRowClickable ? { isTableRowClickable } : {})}\n        />\n      </div>\n    );\n  }\n\n  const renderedText = parsedPayload != null ? JSON.stringify(parsedPayload, null, 2) : rawText;\n\n  if (!renderedText) {\n    return (\n      <p className={cn(\"mt-3 text-sm text-muted-foreground\", className)}>\n        Response completed with no body.\n      </p>\n    );\n  }\n\n  return (\n    <pre\n      aria-label={ariaLabel}\n      className={cn(\"mt-3 overflow-auto rounded-md bg-muted p-4 text-xs\", className)}\n    >\n      {renderedText}\n    </pre>\n  );\n}\n"],"names":[],"mappings":";;;;AAyBO,SAAS,gBAAgB;AAAA,EAC9B;AAAA,EACA,eAAe;AAAA,EACf,YAAY;AAAA,EACZ;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAAyB;AACvB,MAAI,CAAC,UAAU;AACb,+BAAQ,KAAA,EAAE,WAAW,GAAG,sCAAsC,SAAS,GAAI,UAAA,cAAa;AAAA,EAC1F;AAEA,QAAM,UAAU,SAAS,UAAU,SAAS,UAAU,SAAS,WAAW;AAC1E,QAAM,gBAAgB,SAAS,UAAU,cAAc,QAAQ;AAC/D,QAAM,gBACJ,OAAO,kBAAkB,YACxB,iBAAiB,QAAQ,OAAO,kBAAkB,WAC9C,gBACD;AACN,QAAM,eAAe,kBAAkB,KAAK,OAAO,gBAAgB,aAAa;AAEhF,MAAI,6CAAc,IAAI;AACpB,WACE,oBAAC,OAAA,EAAI,MAAK,UAAS,cAAY,WAAW,WAAW,GAAG,QAAQ,SAAS,GACvE,UAAA;AAAA,MAAC;AAAA,MAAA;AAAA,QACC,MAAM,aAAa;AAAA,QAClB,GAAI,SAAS,aAAa,EAAE,KAAK,SAAS,WAAA,IAAe,CAAA;AAAA,QACzD,GAAI,iBAAiB,EAAE,eAAA,IAAmB,CAAA;AAAA,QAC1C,GAAI,kBAAkB,EAAE,gBAAA,IAAoB,CAAA;AAAA,QAC5C,GAAI,kBAAkB,EAAE,gBAAA,IAAoB,CAAA;AAAA,QAC5C,GAAI,sBAAsB,EAAE,wBAAwB,CAAA;AAAA,MAAC;AAAA,IAAA,GAE1D;AAAA,EAEJ;AAEA,QAAM,eAAe,iBAAiB,OAAO,KAAK,UAAU,eAAe,MAAM,CAAC,IAAI;AAEtF,MAAI,CAAC,cAAc;AACjB,+BACG,KAAA,EAAE,WAAW,GAAG,sCAAsC,SAAS,GAAG,UAAA,oCAEnE;AAAA,EAEJ;AAEA,SACE;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,cAAY;AAAA,MACZ,WAAW,GAAG,sDAAsD,SAAS;AAAA,MAE5E,UAAA;AAAA,IAAA;AAAA,EAAA;AAGP;"}

package/dist/rpc/FilterForm.d.ts

@@ -0,0 +1,22 @@
+import { ParameterValues } from './formMetadata';
+import { OpenAPIParameter } from './types';
+import { OperationsApiClient } from './useOperations';
+export type FilterFormProps = {
+    client: OperationsApiClient;
+    path: string;
+    method: string;
+    parameters?: OpenAPIParameter[];
+    initialValues?: ParameterValues | undefined;
+    lockedValues?: ParameterValues | undefined;
+    hideLocked?: boolean | undefined;
+    enableLookup?: boolean | undefined;
+    autoSubmit?: boolean | undefined;
+    submitLabel?: string | undefined;
+    submittingLabel?: string | undefined;
+    emptyMessage?: string | undefined;
+    isSubmitting?: boolean | undefined;
+    className?: string | undefined;
+    onSubmit: (values: ParameterValues) => void | Promise<void>;
+};
+export declare function FilterForm({ client, path, method, parameters, initialValues, lockedValues, hideLocked, enableLookup, autoSubmit, submitLabel, submittingLabel, emptyMessage, isSubmitting, className, onSubmit, }: FilterFormProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=FilterForm.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FilterForm.d.ts","sourceRoot":"","sources":["../../src/rpc/FilterForm.tsx"],"names":[],"mappings":"AAWA,OAAO,EAOL,KAAK,eAAe,EACrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE3D,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,mBAAmB,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAChC,aAAa,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;IAC5C,YAAY,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;IAC3C,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACnC,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,QAAQ,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D,CAAC;AAEF,wBAAgB,UAAU,CAAC,EACzB,MAAM,EACN,IAAI,EACJ,MAAM,EACN,UAAe,EACf,aAAkB,EAClB,YAAiB,EACjB,UAAkB,EAClB,YAA6C,EAC7C,UAAkB,EAClB,WAA+B,EAC/B,eAA8B,EAC9B,YAAuD,EACvD,YAAoB,EACpB,SAAS,EACT,QAAQ,GACT,EAAE,eAAe,2CAsHjB"}