@flanksource/clicky-ui 0.3.10 → 0.3.11

package/dist/rpc/SchemaActionForm.js

@@ -1,11 +1,19 @@
 import { jsx, Fragment, jsxs } from "react/jsx-runtime";
-import { useMemo, useState } from "react";
+import { useMemo, useState, useCallback, Suspense, lazy } from "react";
 import { useQuery } from "@tanstack/react-query";
+import { stringify, parse } from "yaml";
 import { Button } from "../components/button.js";
 import { JsonSchemaForm } from "../components/JsonSchemaForm.js";
 import { resolveLookupScope } from "../components/form-lookup-context.js";
+import { Tabs } from "../layout/Tabs.js";
 import { lookupOptionsToFieldOptions } from "./formMetadata.js";
 import { collectionPath, resolveActionPath, scalarValues } from "./schemaActionPath.js";
+const LazyMonacoSchemaEditor = lazy(
+  () => import("../monaco/MonacoSchemaEditor.js").then((module) => ({
+    default: module.MonacoSchemaEditor
+  }))
+);
+let schemaActionEditorSequence = 0;
 function SchemaActionForm({
   client,
   action,
@@ -16,10 +24,13 @@ function SchemaActionForm({
   formPre,
   formPost,
   footerActions,
+  renderLayout,
   fallback
 }) {
   const method = action.method.toUpperCase();
-  const canSchemaForm = Boolean(client.getSchema && client.submitForm && isMutation(method));
+  const canSchemaForm = Boolean(
+    client.getSchema && client.submitForm && isMutation(method)
+  );
   const schemaPath = collectionPath(action.path);
   const lookupFetcher = useMemo(() => {
     const lookup = client.lookupFilterOptions;
@@ -34,7 +45,10 @@ function SchemaActionForm({
         query,
         extra
       );
-      return lookupOptionsToFieldOptions(filter).map((o) => ({ value: o.value, label: o.label }));
+      return lookupOptionsToFieldOptions(filter).map((o) => ({
+        value: o.value,
+        label: o.label
+      }));
     };
   }, [client]);
   const schemaQuery = useQuery({
@@ -45,37 +59,122 @@ function SchemaActionForm({
     staleTime: 5 * 60 * 1e3,
     retry: 0
   });
-  const [value, setValue] = useState(initialValue ?? {});
+  const [value, setValue] = useState(
+    initialValue ?? {}
+  );
+  const [view, setView] = useState("form");
+  const [yamlText, setYamlText] = useState(
+    () => stringify(initialValue ?? {})
+  );
+  const [yamlError, setYamlError] = useState("");
+  const [yamlValidation, setYamlValidation] = useState({
+    status: "valid",
+    errors: []
+  });
   const [error, setError] = useState("");
   const [isSubmitting, setIsSubmitting] = useState(false);
-  if (!canSchemaForm) return /* @__PURE__ */ jsx(Fragment, { children: fallback });
+  const [editorId] = useState(() => ++schemaActionEditorSequence);
+  const editorPath = `file:///clicky-schema-action-${editorId}.yaml`;
+  const canSubmit = !yamlError && (view !== "yaml" || yamlValidation.status === "valid");
+  const handleValidationChange = useCallback((next) => {
+    setYamlValidation(next);
+  }, []);
+  function renderSlots(slots) {
+    if (renderLayout) return renderLayout(slots);
+    return /* @__PURE__ */ jsxs("div", { className: "space-y-4", children: [
+      slots.body,
+      slots.footer
+    ] });
+  }
+  if (!canSchemaForm) return /* @__PURE__ */ jsx(Fragment, { children: renderSlots({ body: fallback }) });
   if (schemaQuery.isLoading) {
-    return /* @__PURE__ */ jsx("div", { className: "text-sm text-muted-foreground", children: "Loading form…" });
+    return /* @__PURE__ */ jsx(Fragment, { children: renderSlots({
+      body: /* @__PURE__ */ jsx("div", { className: "text-sm text-muted-foreground", children: "Loading form…" })
+    }) });
   }
   const schema = schemaQuery.data;
-  if (!schema) return /* @__PURE__ */ jsx(Fragment, { children: fallback });
+  if (!schema) return /* @__PURE__ */ jsx(Fragment, { children: renderSlots({ body: fallback }) });
   async function handleSubmit() {
     if (!client.submitForm) return;
+    if (!canSubmit) {
+      setError("Fix the YAML before saving.");
+      return;
+    }
     setIsSubmitting(true);
     setError("");
     try {
-      const path = resolveActionPath(action.path, { ...scalarValues(value), ...lockedValues });
-      const response = await client.submitForm(path, method, value, {
-        Accept: "application/json+clicky"
+      const path = resolveActionPath(action.path, {
+        ...scalarValues(value),
+        ...lockedValues
       });
+      const pathParams = new Set(
+        Array.from(action.path.matchAll(/\{([^{}]+)\}/g), (match) => match[1])
+      );
+      const lockedBodyValues = Object.fromEntries(
+        Object.entries(lockedValues ?? {}).filter(
+          ([name]) => !pathParams.has(name)
+        )
+      );
+      const response = await client.submitForm(
+        path,
+        method,
+        { ...value, ...lockedBodyValues },
+        {
+          Accept: "application/json+clicky"
+        }
+      );
       if (response.error) {
         setError(response.error);
         return;
       }
       onSuccess == null ? void 0 : onSuccess(response);
     } catch (err) {
-      setError(err instanceof Error ? err.message : String(err ?? "Unknown error"));
+      setError(
+        err instanceof Error ? err.message : String(err ?? "Unknown error")
+      );
     } finally {
       setIsSubmitting(false);
     }
   }
-  return /* @__PURE__ */ jsxs("div", { className: "space-y-4", children: [
+  function changeView(next) {
+    if (next !== "form" && next !== "yaml") return;
+    if (next === "form") {
+      setYamlError("");
+    }
+    if (next === "yaml") {
+      setYamlText(stringify(value));
+      setYamlError("");
+      setYamlValidation({ status: "loading", errors: [] });
+    }
+    setView(next);
+  }
+  function changeYaml(next) {
+    setYamlText(next);
+    setError("");
+    try {
+      const parsed = next.trim() ? parse(next) : {};
+      if (!isRecord(parsed))
+        throw new Error("The YAML document must contain an object.");
+      setValue(parsed);
+      setYamlError("");
+      setYamlValidation({ status: "loading", errors: [] });
+    } catch (err) {
+      setYamlError(err instanceof Error ? err.message : String(err));
+    }
+  }
+  const body = /* @__PURE__ */ jsxs("div", { className: "space-y-4", children: [
     /* @__PURE__ */ jsx(
+      Tabs,
+      {
+        tabs: [
+          { id: "form", label: "Form" },
+          { id: "yaml", label: "YAML" }
+        ],
+        value: view,
+        onChange: changeView
+      }
+    ),
+    view === "form" ? /* @__PURE__ */ jsx("div", { role: "tabpanel", "aria-label": "Form", children: /* @__PURE__ */ jsx(
       JsonSchemaForm,
       {
         schema,
@@ -85,17 +184,52 @@ function SchemaActionForm({
         ...formPost ? { post: formPost } : {},
         ...lookupFetcher ? { lookupFetcher } : {}
       }
-    ),
-    error && /* @__PURE__ */ jsx("div", { className: "rounded-md border border-destructive/40 bg-destructive/5 p-3 text-sm text-destructive", children: error }),
-    /* @__PURE__ */ jsxs("div", { className: "flex items-center justify-end gap-2", children: [
-      footerActions == null ? void 0 : footerActions({ value, action }),
-      /* @__PURE__ */ jsx(Button, { type: "button", onClick: handleSubmit, disabled: isSubmitting, children: isSubmitting ? "Saving…" : submitLabel })
-    ] })
+    ) }) : /* @__PURE__ */ jsxs("div", { role: "tabpanel", "aria-label": "YAML", className: "space-y-2", children: [
+      /* @__PURE__ */ jsx(
+        Suspense,
+        {
+          fallback: /* @__PURE__ */ jsx("div", { className: "h-80 rounded-md border border-input p-3 text-sm text-muted-foreground", children: "Loading Monaco editor…" }),
+          children: /* @__PURE__ */ jsx(
+            LazyMonacoSchemaEditor,
+            {
+              language: "yaml",
+              value: yamlText,
+              onChange: changeYaml,
+              path: editorPath,
+              schemaUri: `${editorPath}.schema.json`,
+              schema,
+              onValidationChange: handleValidationChange
+            }
+          )
+        }
+      ),
+      /* @__PURE__ */ jsx("div", { className: "text-xs text-muted-foreground", children: "Returning through Form preserves values but discards YAML comments, anchors, ordering, and formatting." }),
+      (yamlValidation.status === "invalid" || yamlValidation.status === "unavailable") && yamlValidation.errors.length > 0 && /* @__PURE__ */ jsx("div", { className: "text-sm text-destructive", role: "alert", children: yamlValidation.errors[0] }),
+      yamlValidation.status === "loading" && !yamlError && /* @__PURE__ */ jsx("div", { className: "text-xs text-muted-foreground", children: "Validating YAML…" }),
+      yamlError && /* @__PURE__ */ jsx("div", { className: "text-sm text-destructive", role: "alert", children: yamlError })
+    ] }),
+    error && /* @__PURE__ */ jsx("div", { className: "rounded-md border border-destructive/40 bg-destructive/5 p-3 text-sm text-destructive", children: error })
+  ] });
+  const footer = /* @__PURE__ */ jsxs("div", { className: "flex items-center justify-end gap-2", children: [
+    footerActions == null ? void 0 : footerActions({ value, action, canSubmit }),
+    /* @__PURE__ */ jsx(
+      Button,
+      {
+        type: "button",
+        onClick: handleSubmit,
+        disabled: isSubmitting || !canSubmit,
+        children: isSubmitting ? "Saving…" : submitLabel
+      }
+    )
   ] });
+  return /* @__PURE__ */ jsx(Fragment, { children: renderSlots({ body, footer }) });
 }
 function isMutation(method) {
   return method === "POST" || method === "PUT" || method === "PATCH";
 }
+function isRecord(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
 export {
   SchemaActionForm
 };

package/dist/rpc/SchemaActionForm.js.map

@@ -1 +1 @@
-{"version":3,"file":"SchemaActionForm.js","sources":["../../src/rpc/SchemaActionForm.tsx"],"sourcesContent":["import { useMemo, useState, type ReactNode } from \"react\";\nimport { useQuery } from \"@tanstack/react-query\";\nimport { Button } from \"../components/button\";\nimport { JsonSchemaForm } from \"../components/JsonSchemaForm\";\nimport { resolveLookupScope } from \"../components/form-lookup-context\";\nimport type {\n  JsonSchemaObject,\n  LookupFetcher,\n  PreExtension,\n  PostExtension,\n} from \"../components/json-schema-form-types\";\nimport { lookupOptionsToFieldOptions } from \"./formMetadata\";\nimport { collectionPath, resolveActionPath, scalarValues } from \"./schemaActionPath\";\nimport type { ExecutionResponse, ResolvedOperation } from \"./types\";\nimport type { OperationsApiClient } from \"./useOperations\";\n\n// FormActionContext is handed to a footerActions renderer so a host app can add\n// form-level actions (e.g. a connection \"Test\" button) that operate on the live\n// form value.\nexport type FormActionContext = {\n  value: Record<string, unknown>;\n  action: ResolvedOperation;\n};\n\n// FormActionsRenderer renders extra action buttons in the form footer, left of\n// the Save button. Returns null/undefined to add none.\nexport type FormActionsRenderer = (ctx: FormActionContext) => ReactNode;\n\nexport type SchemaActionFormProps = {\n  client: OperationsApiClient;\n  // The create (POST) or update (PUT) operation this form submits to.\n  action: ResolvedOperation;\n  // Values used to resolve path parameters (e.g. { id } when editing a row).\n  lockedValues?: Record<string, string>;\n  // Pre-filled form value (the existing entity when editing).\n  initialValue?: Record<string, unknown>;\n  submitLabel?: string;\n  onSuccess?: (response: ExecutionResponse) => void;\n  // Custom JsonSchemaForm field extensions (e.g. a SecretKeySelector widget keyed\n  // on an `x-clicky-component` hint). Forwarded verbatim to the rendered form.\n  formPre?: PreExtension[];\n  formPost?: PostExtension[];\n  // Optional extra footer actions (e.g. a connection \"Test\" split-button) that\n  // operate on the current form value, rendered left of the Save button.\n  footerActions?: FormActionsRenderer;\n  // Rendered when the resource exposes no JSON Schema (or schema forms are not\n  // applicable to this action) — the existing parameter form.\n  fallback: ReactNode;\n};\n\n// SchemaActionForm renders a JSON-Schema-driven create/edit form for resources\n// that expose a schema via content negotiation (connections, profiles). It falls\n// back to the parameter form for everything else. Submission sends the full\n// nested form value as JSON (client.submitForm), so nested objects/arrays survive.\nexport function SchemaActionForm({\n  client,\n  action,\n  lockedValues,\n  initialValue,\n  submitLabel = \"Save\",\n  onSuccess,\n  formPre,\n  formPost,\n  footerActions,\n  fallback,\n}: SchemaActionFormProps) {\n  const method = action.method.toUpperCase();\n  const canSchemaForm = Boolean(client.getSchema && client.submitForm && isMutation(method));\n  const schemaPath = collectionPath(action.path);\n\n  // Resolve `x-clicky-lookup` fields against the live form value: fetch the\n  // referenced entity's lookup options (server-side search) and scope them by a\n  // sibling field. Undefined when the client has no lookup endpoint (the field\n  // then degrades to a free-text combobox).\n  const lookupFetcher: LookupFetcher | undefined = useMemo(() => {\n    const lookup = client.lookupFilterOptions;\n    if (!lookup) return undefined;\n    return async ({ descriptor, query, rootValue }) => {\n      const extra = resolveLookupScope(descriptor, rootValue);\n      const filter = await lookup.call(\n        client,\n        descriptor.url,\n        \"GET\",\n        descriptor.filter,\n        query,\n        extra,\n      );\n      return lookupOptionsToFieldOptions(filter).map((o) => ({ value: o.value, label: o.label }));\n    };\n  }, [client]);\n\n  const schemaQuery = useQuery<JsonSchemaObject | null>({\n    queryKey: [\"entity-schema\", schemaPath],\n    // react-query forbids undefined query data; normalize \"no schema\" to null.\n    queryFn: async () => (await client.getSchema!(schemaPath)) ?? null,\n    enabled: canSchemaForm,\n    staleTime: 5 * 60 * 1000,\n    retry: 0,\n  });\n\n  const [value, setValue] = useState<Record<string, unknown>>(initialValue ?? {});\n  const [error, setError] = useState(\"\");\n  const [isSubmitting, setIsSubmitting] = useState(false);\n\n  if (!canSchemaForm) return <>{fallback}</>;\n  if (schemaQuery.isLoading) {\n    return <div className=\"text-sm text-muted-foreground\">Loading form…</div>;\n  }\n  const schema = schemaQuery.data;\n  if (!schema) return <>{fallback}</>;\n\n  async function handleSubmit() {\n    if (!client.submitForm) return;\n    setIsSubmitting(true);\n    setError(\"\");\n    try {\n      const path = resolveActionPath(action.path, { ...scalarValues(value), ...lockedValues });\n      const response = await client.submitForm(path, method, value, {\n        Accept: \"application/json+clicky\",\n      });\n      if (response.error) {\n        setError(response.error);\n        return;\n      }\n      onSuccess?.(response);\n    } catch (err) {\n      setError(err instanceof Error ? err.message : String(err ?? \"Unknown error\"));\n    } finally {\n      setIsSubmitting(false);\n    }\n  }\n\n  return (\n    <div className=\"space-y-4\">\n      <JsonSchemaForm\n        schema={schema}\n        value={value}\n        onChange={setValue}\n        {...(formPre ? { pre: formPre } : {})}\n        {...(formPost ? { post: formPost } : {})}\n        {...(lookupFetcher ? { lookupFetcher } : {})}\n      />\n      {error && (\n        <div className=\"rounded-md border border-destructive/40 bg-destructive/5 p-3 text-sm text-destructive\">\n          {error}\n        </div>\n      )}\n      <div className=\"flex items-center justify-end gap-2\">\n        {footerActions?.({ value, action })}\n        <Button type=\"button\" onClick={handleSubmit} disabled={isSubmitting}>\n          {isSubmitting ? \"Saving…\" : submitLabel}\n        </Button>\n      </div>\n    </div>\n  );\n}\n\nfunction isMutation(method: string): boolean {\n  return method === \"POST\" || method === \"PUT\" || method === \"PATCH\";\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"SchemaActionForm.js","sources":["../../src/rpc/SchemaActionForm.tsx"],"sourcesContent":["import {\n  lazy,\n  Suspense,\n  useCallback,\n  useMemo,\n  useState,\n  type ReactNode,\n} from \"react\";\nimport { useQuery } from \"@tanstack/react-query\";\nimport { parse as parseYaml, stringify as stringifyYaml } from \"yaml\";\nimport { Button } from \"../components/button\";\nimport { JsonSchemaForm } from \"../components/JsonSchemaForm\";\nimport { resolveLookupScope } from \"../components/form-lookup-context\";\nimport { Tabs } from \"../layout/Tabs\";\nimport type {\n  JsonSchemaObject,\n  LookupFetcher,\n  PreExtension,\n  PostExtension,\n} from \"../components/json-schema-form-types\";\nimport { lookupOptionsToFieldOptions } from \"./formMetadata\";\nimport {\n  collectionPath,\n  resolveActionPath,\n  scalarValues,\n} from \"./schemaActionPath\";\nimport type { ExecutionResponse, ResolvedOperation } from \"./types\";\nimport type { OperationsApiClient } from \"./useOperations\";\nimport type { MonacoValidationState } from \"../monaco/types\";\n\nconst LazyMonacoSchemaEditor = lazy(() =>\n  import(\"../monaco/MonacoSchemaEditor\").then((module) => ({\n    default: module.MonacoSchemaEditor,\n  })),\n);\nlet schemaActionEditorSequence = 0;\n\n// FormActionContext is handed to a footerActions renderer so a host app can add\n// form-level actions (e.g. a connection \"Test\" button) that operate on the live\n// form value.\nexport type FormActionContext = {\n  value: Record<string, unknown>;\n  action: ResolvedOperation;\n  canSubmit: boolean;\n};\n\n// FormActionsRenderer renders extra action buttons in the form footer, left of\n// the Save button. Returns null/undefined to add none.\nexport type FormActionsRenderer = (ctx: FormActionContext) => ReactNode;\n\nexport type SchemaActionFormSlots = {\n  body: ReactNode;\n  footer?: ReactNode;\n};\n\nexport type SchemaActionFormProps = {\n  client: OperationsApiClient;\n  // The create (POST) or update (PUT) operation this form submits to.\n  action: ResolvedOperation;\n  // Values used to resolve path parameters (e.g. { id } when editing a row).\n  lockedValues?: Record<string, string>;\n  // Pre-filled form value (the existing entity when editing).\n  initialValue?: Record<string, unknown>;\n  submitLabel?: string;\n  onSuccess?: (response: ExecutionResponse) => void;\n  // Custom JsonSchemaForm field extensions (e.g. a SecretKeySelector widget keyed\n  // on an `x-clicky-component` hint). Forwarded verbatim to the rendered form.\n  formPre?: PreExtension[];\n  formPost?: PostExtension[];\n  // Optional extra footer actions (e.g. a connection \"Test\" split-button) that\n  // operate on the current form value, rendered left of the Save button.\n  footerActions?: FormActionsRenderer;\n  // Optional host layout. Dialog consumers use this to place footer controls in\n  // the modal's pinned footer while standalone consumers retain the inline\n  // layout below.\n  renderLayout?: (slots: SchemaActionFormSlots) => ReactNode;\n  // Rendered when the resource exposes no JSON Schema (or schema forms are not\n  // applicable to this action) — the existing parameter form.\n  fallback: ReactNode;\n};\n\n// SchemaActionForm renders a JSON-Schema-driven create/edit form for resources\n// that expose a schema via content negotiation (connections, profiles). It falls\n// back to the parameter form for everything else. Submission sends the full\n// nested form value as JSON (client.submitForm), so nested objects/arrays survive.\nexport function SchemaActionForm({\n  client,\n  action,\n  lockedValues,\n  initialValue,\n  submitLabel = \"Save\",\n  onSuccess,\n  formPre,\n  formPost,\n  footerActions,\n  renderLayout,\n  fallback,\n}: SchemaActionFormProps) {\n  const method = action.method.toUpperCase();\n  const canSchemaForm = Boolean(\n    client.getSchema && client.submitForm && isMutation(method),\n  );\n  const schemaPath = collectionPath(action.path);\n\n  // Resolve `x-clicky-lookup` fields against the live form value: fetch the\n  // referenced entity's lookup options (server-side search) and scope them by a\n  // sibling field. Undefined when the client has no lookup endpoint (the field\n  // then degrades to a free-text combobox).\n  const lookupFetcher: LookupFetcher | undefined = useMemo(() => {\n    const lookup = client.lookupFilterOptions;\n    if (!lookup) return undefined;\n    return async ({ descriptor, query, rootValue }) => {\n      const extra = resolveLookupScope(descriptor, rootValue);\n      const filter = await lookup.call(\n        client,\n        descriptor.url,\n        \"GET\",\n        descriptor.filter,\n        query,\n        extra,\n      );\n      return lookupOptionsToFieldOptions(filter).map((o) => ({\n        value: o.value,\n        label: o.label,\n      }));\n    };\n  }, [client]);\n\n  const schemaQuery = useQuery<JsonSchemaObject | null>({\n    queryKey: [\"entity-schema\", schemaPath],\n    // react-query forbids undefined query data; normalize \"no schema\" to null.\n    queryFn: async () => (await client.getSchema!(schemaPath)) ?? null,\n    enabled: canSchemaForm,\n    staleTime: 5 * 60 * 1000,\n    retry: 0,\n  });\n\n  const [value, setValue] = useState<Record<string, unknown>>(\n    initialValue ?? {},\n  );\n  const [view, setView] = useState<\"form\" | \"yaml\">(\"form\");\n  const [yamlText, setYamlText] = useState(() =>\n    stringifyYaml(initialValue ?? {}),\n  );\n  const [yamlError, setYamlError] = useState(\"\");\n  const [yamlValidation, setYamlValidation] = useState<MonacoValidationState>({\n    status: \"valid\",\n    errors: [],\n  });\n  const [error, setError] = useState(\"\");\n  const [isSubmitting, setIsSubmitting] = useState(false);\n  // Monaco keys models by path. A React useId can be reused after one dialog\n  // unmounts and another occupies the same tree position, briefly exposing the\n  // previous dialog's retained model during deferred StrictMode-safe cleanup.\n  const [editorId] = useState(() => ++schemaActionEditorSequence);\n  const editorPath = `file:///clicky-schema-action-${editorId}.yaml`;\n  const canSubmit =\n    !yamlError && (view !== \"yaml\" || yamlValidation.status === \"valid\");\n  const handleValidationChange = useCallback((next: MonacoValidationState) => {\n    setYamlValidation(next);\n  }, []);\n\n  function renderSlots(slots: SchemaActionFormSlots) {\n    if (renderLayout) return renderLayout(slots);\n    return (\n      <div className=\"space-y-4\">\n        {slots.body}\n        {slots.footer}\n      </div>\n    );\n  }\n\n  if (!canSchemaForm) return <>{renderSlots({ body: fallback })}</>;\n  if (schemaQuery.isLoading) {\n    return (\n      <>\n        {renderSlots({\n          body: (\n            <div className=\"text-sm text-muted-foreground\">Loading form…</div>\n          ),\n        })}\n      </>\n    );\n  }\n  const schema = schemaQuery.data;\n  if (!schema) return <>{renderSlots({ body: fallback })}</>;\n\n  async function handleSubmit() {\n    if (!client.submitForm) return;\n    if (!canSubmit) {\n      setError(\"Fix the YAML before saving.\");\n      return;\n    }\n    setIsSubmitting(true);\n    setError(\"\");\n    try {\n      const path = resolveActionPath(action.path, {\n        ...scalarValues(value),\n        ...lockedValues,\n      });\n      // Entity update operations do not always encode their identifier in the\n      // path. Clicky can expose an entity-scoped PUT on the collection path and\n      // use x-clicky.idParam to lock the row id in the action context. Keep\n      // locked values out of the editable form, but include any values that\n      // were not consumed by path placeholders in the request body.\n      const pathParams = new Set(\n        Array.from(action.path.matchAll(/\\{([^{}]+)\\}/g), (match) => match[1]),\n      );\n      const lockedBodyValues = Object.fromEntries(\n        Object.entries(lockedValues ?? {}).filter(\n          ([name]) => !pathParams.has(name),\n        ),\n      );\n      const response = await client.submitForm(\n        path,\n        method,\n        { ...value, ...lockedBodyValues },\n        {\n          Accept: \"application/json+clicky\",\n        },\n      );\n      if (response.error) {\n        setError(response.error);\n        return;\n      }\n      onSuccess?.(response);\n    } catch (err) {\n      setError(\n        err instanceof Error ? err.message : String(err ?? \"Unknown error\"),\n      );\n    } finally {\n      setIsSubmitting(false);\n    }\n  }\n\n  function changeView(next: string) {\n    if (next !== \"form\" && next !== \"yaml\") return;\n    if (next === \"form\") {\n      // Form mode uses the last successfully parsed object, so an invalid YAML\n      // draft should not trap the user in the editor or keep form actions disabled.\n      setYamlError(\"\");\n    }\n    if (next === \"yaml\") {\n      setYamlText(stringifyYaml(value));\n      setYamlError(\"\");\n      setYamlValidation({ status: \"loading\", errors: [] });\n    }\n    setView(next);\n  }\n\n  function changeYaml(next: string) {\n    setYamlText(next);\n    setError(\"\");\n    try {\n      const parsed = next.trim() ? parseYaml(next) : {};\n      if (!isRecord(parsed))\n        throw new Error(\"The YAML document must contain an object.\");\n      setValue(parsed);\n      setYamlError(\"\");\n      setYamlValidation({ status: \"loading\", errors: [] });\n    } catch (err) {\n      setYamlError(err instanceof Error ? err.message : String(err));\n    }\n  }\n\n  const body = (\n    <div className=\"space-y-4\">\n      <Tabs\n        tabs={[\n          { id: \"form\", label: \"Form\" },\n          { id: \"yaml\", label: \"YAML\" },\n        ]}\n        value={view}\n        onChange={changeView}\n      />\n      {view === \"form\" ? (\n        <div role=\"tabpanel\" aria-label=\"Form\">\n          <JsonSchemaForm\n            schema={schema}\n            value={value}\n            onChange={setValue}\n            {...(formPre ? { pre: formPre } : {})}\n            {...(formPost ? { post: formPost } : {})}\n            {...(lookupFetcher ? { lookupFetcher } : {})}\n          />\n        </div>\n      ) : (\n        <div role=\"tabpanel\" aria-label=\"YAML\" className=\"space-y-2\">\n          <Suspense\n            fallback={\n              <div className=\"h-80 rounded-md border border-input p-3 text-sm text-muted-foreground\">\n                Loading Monaco editor…\n              </div>\n            }\n          >\n            <LazyMonacoSchemaEditor\n              language=\"yaml\"\n              value={yamlText}\n              onChange={changeYaml}\n              path={editorPath}\n              schemaUri={`${editorPath}.schema.json`}\n              schema={schema}\n              onValidationChange={handleValidationChange}\n            />\n          </Suspense>\n          <div className=\"text-xs text-muted-foreground\">\n            Returning through Form preserves values but discards YAML comments,\n            anchors, ordering, and formatting.\n          </div>\n          {(yamlValidation.status === \"invalid\" ||\n            yamlValidation.status === \"unavailable\") &&\n            yamlValidation.errors.length > 0 && (\n              <div className=\"text-sm text-destructive\" role=\"alert\">\n                {yamlValidation.errors[0]}\n              </div>\n            )}\n          {yamlValidation.status === \"loading\" && !yamlError && (\n            <div className=\"text-xs text-muted-foreground\">\n              Validating YAML…\n            </div>\n          )}\n          {yamlError && (\n            <div className=\"text-sm text-destructive\" role=\"alert\">\n              {yamlError}\n            </div>\n          )}\n        </div>\n      )}\n      {error && (\n        <div className=\"rounded-md border border-destructive/40 bg-destructive/5 p-3 text-sm text-destructive\">\n          {error}\n        </div>\n      )}\n    </div>\n  );\n  const footer = (\n    <div className=\"flex items-center justify-end gap-2\">\n      {footerActions?.({ value, action, canSubmit })}\n      <Button\n        type=\"button\"\n        onClick={handleSubmit}\n        disabled={isSubmitting || !canSubmit}\n      >\n        {isSubmitting ? \"Saving…\" : submitLabel}\n      </Button>\n    </div>\n  );\n  return <>{renderSlots({ body, footer })}</>;\n}\n\nfunction isMutation(method: string): boolean {\n  return method === \"POST\" || method === \"PUT\" || method === \"PATCH\";\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return Boolean(value) && typeof value === \"object\" && !Array.isArray(value);\n}\n"],"names":["stringifyYaml","parseYaml"],"mappings":"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"}

package/dist/rpc/types.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"types.cjs","sources":["../../src/rpc/types.ts"],"sourcesContent":["import type { ClickyNode } from \"../data/Clicky\";\nimport type { TimeRangePresetGroup } from \"../components/TimeRange\";\n\nexport interface ExecutionRequest {\n  args?: string[];\n  flags?: Record<string, string>;\n}\n\nexport interface ExecutionPagination {\n  total?: number;\n  limit?: number;\n  offset?: number;\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  responseHeaders?: Record<string, string>;\n  pagination?: ExecutionPagination;\n  blob?: Blob;\n  parsed?: unknown;\n}\n\nexport interface OpenAPISchema {\n  type?: string;\n  format?: string;\n  default?: unknown;\n  enum?: unknown[];\n  description?: string;\n  properties?: Record<string, OpenAPISchema>;\n}\n\n// ClickyParameterRole tells the UI which widget owns a parameter:\n//   \"search\"    — render as the FilterBar's dedicated search input\n//   \"filter\"    — render as a FilterBar chip on the DataTable\n//   \"limit\"     — feed into DataTable pagination's pageSize\n//   \"offset\"    — feed into DataTable pagination's page (or skip)\n//   \"time-from\" — left edge of a time-range picker\n//   \"time-to\"   — right edge of a time-range picker\n// Set server-side by clicky's converter (see paramRole in clicky/rpc/openapi.go).\nexport type ClickyParameterRole =\n  | \"search\"\n  | \"filter\"\n  | \"limit\"\n  | \"offset\"\n  | \"time-from\"\n  | \"time-to\";\n\nexport interface ClickyParameterMeta {\n  role?: ClickyParameterRole;\n}\n\nexport interface OpenAPIParameter {\n  name: string;\n  in: \"query\" | \"path\" | \"header\";\n  description?: string;\n  required?: boolean;\n  schema?: OpenAPISchema;\n  /** Hint text shown inside the empty input. Distinct from `description`,\n   *  which is help text and must NOT be used as a placeholder. */\n  placeholder?: string;\n  \"x-clicky\"?: ClickyParameterMeta;\n  /** Vendor-extension placeholder, set server-side by clicky's converter.\n   *  Takes precedence over `placeholder` when both are present. */\n  \"x-clicky-placeholder\"?: string;\n}\n\n/** Resolves the input placeholder for a parameter, drawing ONLY from explicit\n *  placeholder fields — never from `description` (help text). Returns undefined\n *  when no placeholder is declared so callers can apply their own fallback. */\nexport function parameterPlaceholder(\n  param: OpenAPIParameter,\n): string | undefined {\n  return param[\"x-clicky-placeholder\"] ?? param.placeholder;\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  /** Opaque icon name emitted by the backend (x-clicky-icon), resolved to a glyph in the UI. */\n  icon?: 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  group?: string;\n}\n\nexport type OperationLookupFilterType =\n  | \"bool\"\n  | \"number\"\n  | \"date\"\n  | \"from\"\n  | \"to\"\n  | \"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  /** True when `options` is only the head of a larger set (server-side capped). */\n  truncated?: boolean;\n  /** True distinct count behind a truncated option set; drives \"… and N more\". */\n  total?: number;\n  presets?: Array<\n    { label: string; from: string; to: string } | TimeRangePresetGroup\n  >;\n  timeEnabled?: boolean;\n  timeZone?: string;\n  timeZones?: string[];\n}\n\nexport interface OperationLookupResponse {\n  filters: Record<string, OperationLookupFilter>;\n}\n\nexport function isPositionalParam(p: OpenAPIParameter): boolean {\n  return (\n    p.name === \"args\" ||\n    p.description?.toLowerCase().includes(\"positional argument\") === true\n  );\n}\n"],"names":[],"mappings":";;AA+EO,SAAS,qBACd,OACoB;AACpB,SAAO,MAAM,sBAAsB,KAAK,MAAM;AAChD;AA8FO,SAAS,kBAAkB,GAA8B;;AAC9D,SACE,EAAE,SAAS,YACX,OAAE,gBAAF,mBAAe,cAAc,SAAS,4BAA2B;AAErE;;;"}
+{"version":3,"file":"types.cjs","sources":["../../src/rpc/types.ts"],"sourcesContent":["import type { ClickyNode } from \"../data/Clicky\";\nimport type { TimeRangePresetGroup } from \"../components/TimeRange\";\n\nexport interface ExecutionRequest {\n  args?: string[];\n  flags?: Record<string, string>;\n}\n\nexport interface ExecutionPagination {\n  total?: number;\n  limit?: number;\n  offset?: number;\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  responseHeaders?: Record<string, string>;\n  pagination?: ExecutionPagination;\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  items?: OpenAPISchema;\n  oneOf?: OpenAPISchema[];\n  additionalProperties?: OpenAPISchema | boolean;\n  nullable?: boolean;\n}\n\n// ClickyParameterRole tells the UI which widget owns a parameter:\n//   \"search\"    — render as the FilterBar's dedicated search input\n//   \"filter\"    — render as a FilterBar chip on the DataTable\n//   \"limit\"     — feed into DataTable pagination's pageSize\n//   \"offset\"    — feed into DataTable pagination's page (or skip)\n//   \"time-from\" — left edge of a time-range picker\n//   \"time-to\"   — right edge of a time-range picker\n// Set server-side by clicky's converter (see paramRole in clicky/rpc/openapi.go).\nexport type ClickyParameterRole =\n  | \"search\"\n  | \"filter\"\n  | \"limit\"\n  | \"offset\"\n  | \"time-from\"\n  | \"time-to\";\n\nexport interface ClickyParameterMeta {\n  role?: ClickyParameterRole;\n}\n\nexport interface OpenAPIParameter {\n  name: string;\n  in: \"query\" | \"path\" | \"header\";\n  description?: string;\n  required?: boolean;\n  schema?: OpenAPISchema;\n  /** Hint text shown inside the empty input. Distinct from `description`,\n   *  which is help text and must NOT be used as a placeholder. */\n  placeholder?: string;\n  \"x-clicky\"?: ClickyParameterMeta;\n  /** Vendor-extension placeholder, set server-side by clicky's converter.\n   *  Takes precedence over `placeholder` when both are present. */\n  \"x-clicky-placeholder\"?: string;\n}\n\n/** Resolves the input placeholder for a parameter, drawing ONLY from explicit\n *  placeholder fields — never from `description` (help text). Returns undefined\n *  when no placeholder is declared so callers can apply their own fallback. */\nexport function parameterPlaceholder(\n  param: OpenAPIParameter,\n): string | undefined {\n  return param[\"x-clicky-placeholder\"] ?? param.placeholder;\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  /** Opaque icon name emitted by the backend (x-clicky-icon), resolved to a glyph in the UI. */\n  icon?: 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  group?: string;\n  toolHints?: ClickyToolHints;\n  export?: ClickyExportMeta;\n}\n\nexport interface ClickyExportMeta {\n  formats?: string[];\n  scopes?: Array<\"page\" | \"all\">;\n  allRowsMode?: \"streaming\" | \"buffered\";\n  formatMaxRows?: Record<string, number>;\n}\n\nexport interface ClickyToolHints {\n  title?: string;\n  readOnlyHint?: boolean;\n  destructiveHint?: boolean;\n  idempotentHint?: boolean;\n  openWorldHint?: boolean;\n  icon?: string;\n  group?: string;\n  parent?: string;\n  defaultPermission?: \"on\" | \"ask\" | \"off\" | \"auto\";\n  strict?: boolean;\n}\n\nexport type OperationLookupFilterType =\n  | \"bool\"\n  | \"number\"\n  | \"date\"\n  | \"from\"\n  | \"to\"\n  | \"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  /** True when `options` is only the head of a larger set (server-side capped). */\n  truncated?: boolean;\n  /** True distinct count behind a truncated option set; drives \"… and N more\". */\n  total?: number;\n  presets?: Array<\n    { label: string; from: string; to: string } | TimeRangePresetGroup\n  >;\n  timeEnabled?: boolean;\n  timeZone?: string;\n  timeZones?: string[];\n}\n\nexport interface OperationLookupResponse {\n  filters: Record<string, OperationLookupFilter>;\n}\n\nexport function isPositionalParam(p: OpenAPIParameter): boolean {\n  return (\n    p.name === \"args\" ||\n    p.description?.toLowerCase().includes(\"positional argument\") === true\n  );\n}\n"],"names":[],"mappings":";;AAmFO,SAAS,qBACd,OACoB;AACpB,SAAO,MAAM,sBAAsB,KAAK,MAAM;AAChD;AAoHO,SAAS,kBAAkB,GAA8B;;AAC9D,SACE,EAAE,SAAS,YACX,OAAE,gBAAF,mBAAe,cAAc,SAAS,4BAA2B;AAErE;;;"}

package/dist/rpc/types.d.ts

@@ -33,6 +33,10 @@ export interface OpenAPISchema {
     enum?: unknown[];
     description?: string;
     properties?: Record<string, OpenAPISchema>;
+    items?: OpenAPISchema;
+    oneOf?: OpenAPISchema[];
+    additionalProperties?: OpenAPISchema | boolean;
+    nullable?: boolean;
 }
 export type ClickyParameterRole = "search" | "filter" | "limit" | "offset" | "time-from" | "time-to";
 export interface ClickyParameterMeta {
@@ -119,6 +123,26 @@ export interface ClickyOperationMeta {
     supportsLookup?: boolean;
     supportsFilterMode?: boolean;
     group?: string;
+    toolHints?: ClickyToolHints;
+    export?: ClickyExportMeta;
+}
+export interface ClickyExportMeta {
+    formats?: string[];
+    scopes?: Array<"page" | "all">;
+    allRowsMode?: "streaming" | "buffered";
+    formatMaxRows?: Record<string, number>;
+}
+export interface ClickyToolHints {
+    title?: string;
+    readOnlyHint?: boolean;
+    destructiveHint?: boolean;
+    idempotentHint?: boolean;
+    openWorldHint?: boolean;
+    icon?: string;
+    group?: string;
+    parent?: string;
+    defaultPermission?: "on" | "ask" | "off" | "auto";
+    strict?: boolean;
 }
 export type OperationLookupFilterType = "bool" | "number" | "date" | "from" | "to" | "multi-filter";
 export interface OperationLookupFilter {

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

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

package/dist/rpc/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sources":["../../src/rpc/types.ts"],"sourcesContent":["import type { ClickyNode } from \"../data/Clicky\";\nimport type { TimeRangePresetGroup } from \"../components/TimeRange\";\n\nexport interface ExecutionRequest {\n  args?: string[];\n  flags?: Record<string, string>;\n}\n\nexport interface ExecutionPagination {\n  total?: number;\n  limit?: number;\n  offset?: number;\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  responseHeaders?: Record<string, string>;\n  pagination?: ExecutionPagination;\n  blob?: Blob;\n  parsed?: unknown;\n}\n\nexport interface OpenAPISchema {\n  type?: string;\n  format?: string;\n  default?: unknown;\n  enum?: unknown[];\n  description?: string;\n  properties?: Record<string, OpenAPISchema>;\n}\n\n// ClickyParameterRole tells the UI which widget owns a parameter:\n//   \"search\"    — render as the FilterBar's dedicated search input\n//   \"filter\"    — render as a FilterBar chip on the DataTable\n//   \"limit\"     — feed into DataTable pagination's pageSize\n//   \"offset\"    — feed into DataTable pagination's page (or skip)\n//   \"time-from\" — left edge of a time-range picker\n//   \"time-to\"   — right edge of a time-range picker\n// Set server-side by clicky's converter (see paramRole in clicky/rpc/openapi.go).\nexport type ClickyParameterRole =\n  | \"search\"\n  | \"filter\"\n  | \"limit\"\n  | \"offset\"\n  | \"time-from\"\n  | \"time-to\";\n\nexport interface ClickyParameterMeta {\n  role?: ClickyParameterRole;\n}\n\nexport interface OpenAPIParameter {\n  name: string;\n  in: \"query\" | \"path\" | \"header\";\n  description?: string;\n  required?: boolean;\n  schema?: OpenAPISchema;\n  /** Hint text shown inside the empty input. Distinct from `description`,\n   *  which is help text and must NOT be used as a placeholder. */\n  placeholder?: string;\n  \"x-clicky\"?: ClickyParameterMeta;\n  /** Vendor-extension placeholder, set server-side by clicky's converter.\n   *  Takes precedence over `placeholder` when both are present. */\n  \"x-clicky-placeholder\"?: string;\n}\n\n/** Resolves the input placeholder for a parameter, drawing ONLY from explicit\n *  placeholder fields — never from `description` (help text). Returns undefined\n *  when no placeholder is declared so callers can apply their own fallback. */\nexport function parameterPlaceholder(\n  param: OpenAPIParameter,\n): string | undefined {\n  return param[\"x-clicky-placeholder\"] ?? param.placeholder;\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  /** Opaque icon name emitted by the backend (x-clicky-icon), resolved to a glyph in the UI. */\n  icon?: 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  group?: string;\n}\n\nexport type OperationLookupFilterType =\n  | \"bool\"\n  | \"number\"\n  | \"date\"\n  | \"from\"\n  | \"to\"\n  | \"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  /** True when `options` is only the head of a larger set (server-side capped). */\n  truncated?: boolean;\n  /** True distinct count behind a truncated option set; drives \"… and N more\". */\n  total?: number;\n  presets?: Array<\n    { label: string; from: string; to: string } | TimeRangePresetGroup\n  >;\n  timeEnabled?: boolean;\n  timeZone?: string;\n  timeZones?: string[];\n}\n\nexport interface OperationLookupResponse {\n  filters: Record<string, OperationLookupFilter>;\n}\n\nexport function isPositionalParam(p: OpenAPIParameter): boolean {\n  return (\n    p.name === \"args\" ||\n    p.description?.toLowerCase().includes(\"positional argument\") === true\n  );\n}\n"],"names":[],"mappings":"AA+EO,SAAS,qBACd,OACoB;AACpB,SAAO,MAAM,sBAAsB,KAAK,MAAM;AAChD;AA8FO,SAAS,kBAAkB,GAA8B;AAlGzD;AAmGL,SACE,EAAE,SAAS,YACX,OAAE,gBAAF,mBAAe,cAAc,SAAS,4BAA2B;AAErE;"}
+{"version":3,"file":"types.js","sources":["../../src/rpc/types.ts"],"sourcesContent":["import type { ClickyNode } from \"../data/Clicky\";\nimport type { TimeRangePresetGroup } from \"../components/TimeRange\";\n\nexport interface ExecutionRequest {\n  args?: string[];\n  flags?: Record<string, string>;\n}\n\nexport interface ExecutionPagination {\n  total?: number;\n  limit?: number;\n  offset?: number;\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  responseHeaders?: Record<string, string>;\n  pagination?: ExecutionPagination;\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  items?: OpenAPISchema;\n  oneOf?: OpenAPISchema[];\n  additionalProperties?: OpenAPISchema | boolean;\n  nullable?: boolean;\n}\n\n// ClickyParameterRole tells the UI which widget owns a parameter:\n//   \"search\"    — render as the FilterBar's dedicated search input\n//   \"filter\"    — render as a FilterBar chip on the DataTable\n//   \"limit\"     — feed into DataTable pagination's pageSize\n//   \"offset\"    — feed into DataTable pagination's page (or skip)\n//   \"time-from\" — left edge of a time-range picker\n//   \"time-to\"   — right edge of a time-range picker\n// Set server-side by clicky's converter (see paramRole in clicky/rpc/openapi.go).\nexport type ClickyParameterRole =\n  | \"search\"\n  | \"filter\"\n  | \"limit\"\n  | \"offset\"\n  | \"time-from\"\n  | \"time-to\";\n\nexport interface ClickyParameterMeta {\n  role?: ClickyParameterRole;\n}\n\nexport interface OpenAPIParameter {\n  name: string;\n  in: \"query\" | \"path\" | \"header\";\n  description?: string;\n  required?: boolean;\n  schema?: OpenAPISchema;\n  /** Hint text shown inside the empty input. Distinct from `description`,\n   *  which is help text and must NOT be used as a placeholder. */\n  placeholder?: string;\n  \"x-clicky\"?: ClickyParameterMeta;\n  /** Vendor-extension placeholder, set server-side by clicky's converter.\n   *  Takes precedence over `placeholder` when both are present. */\n  \"x-clicky-placeholder\"?: string;\n}\n\n/** Resolves the input placeholder for a parameter, drawing ONLY from explicit\n *  placeholder fields — never from `description` (help text). Returns undefined\n *  when no placeholder is declared so callers can apply their own fallback. */\nexport function parameterPlaceholder(\n  param: OpenAPIParameter,\n): string | undefined {\n  return param[\"x-clicky-placeholder\"] ?? param.placeholder;\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  /** Opaque icon name emitted by the backend (x-clicky-icon), resolved to a glyph in the UI. */\n  icon?: 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  group?: string;\n  toolHints?: ClickyToolHints;\n  export?: ClickyExportMeta;\n}\n\nexport interface ClickyExportMeta {\n  formats?: string[];\n  scopes?: Array<\"page\" | \"all\">;\n  allRowsMode?: \"streaming\" | \"buffered\";\n  formatMaxRows?: Record<string, number>;\n}\n\nexport interface ClickyToolHints {\n  title?: string;\n  readOnlyHint?: boolean;\n  destructiveHint?: boolean;\n  idempotentHint?: boolean;\n  openWorldHint?: boolean;\n  icon?: string;\n  group?: string;\n  parent?: string;\n  defaultPermission?: \"on\" | \"ask\" | \"off\" | \"auto\";\n  strict?: boolean;\n}\n\nexport type OperationLookupFilterType =\n  | \"bool\"\n  | \"number\"\n  | \"date\"\n  | \"from\"\n  | \"to\"\n  | \"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  /** True when `options` is only the head of a larger set (server-side capped). */\n  truncated?: boolean;\n  /** True distinct count behind a truncated option set; drives \"… and N more\". */\n  total?: number;\n  presets?: Array<\n    { label: string; from: string; to: string } | TimeRangePresetGroup\n  >;\n  timeEnabled?: boolean;\n  timeZone?: string;\n  timeZones?: string[];\n}\n\nexport interface OperationLookupResponse {\n  filters: Record<string, OperationLookupFilter>;\n}\n\nexport function isPositionalParam(p: OpenAPIParameter): boolean {\n  return (\n    p.name === \"args\" ||\n    p.description?.toLowerCase().includes(\"positional argument\") === true\n  );\n}\n"],"names":[],"mappings":"AAmFO,SAAS,qBACd,OACoB;AACpB,SAAO,MAAM,sBAAsB,KAAK,MAAM;AAChD;AAoHO,SAAS,kBAAkB,GAA8B;AAxHzD;AAyHL,SACE,EAAE,SAAS,YACX,OAAE,gBAAF,mBAAe,cAAc,SAAS,4BAA2B;AAErE;"}

package/dist/rpc.cjs

@@ -11,6 +11,8 @@ const FilterForm = require("./rpc/FilterForm.cjs");
 const InlineError = require("./rpc/InlineError.cjs");
 const OperationActionDialog = require("./rpc/OperationActionDialog.cjs");
 const OperationEntityPage = require("./rpc/OperationEntityPage.cjs");
+const OperationEntityContextPicker = require("./rpc/OperationEntityContextPicker.cjs");
+const OperationEntityContextPicker_model = require("./rpc/OperationEntityContextPicker.model.cjs");
 const OperationCommandPage = require("./rpc/OperationCommandPage.cjs");
 const OperationResultView = require("./rpc/OperationResultView.cjs");
 const EndpointList = require("./rpc/EndpointList.cjs");
@@ -36,6 +38,10 @@ exports.FilterForm = FilterForm.FilterForm;
 exports.InlineError = InlineError.InlineError;
 exports.OperationActionDialog = OperationActionDialog.OperationActionDialog;
 exports.OperationEntityPage = OperationEntityPage.OperationEntityPage;
+exports.OperationEntityContextPicker = OperationEntityContextPicker.OperationEntityContextPicker;
+exports.clickyRowRecord = OperationEntityContextPicker_model.clickyRowRecord;
+exports.contextItemFromEntityRow = OperationEntityContextPicker_model.contextItemFromEntityRow;
+exports.entityContextItemID = OperationEntityContextPicker_model.entityContextItemID;
 exports.OperationCommandPage = OperationCommandPage.OperationCommandPage;
 exports.OperationResultView = OperationResultView.OperationResultView;
 exports.EndpointList = EndpointList.EndpointList;

package/dist/rpc.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"rpc.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"rpc.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/rpc.d.ts

@@ -1,14 +1,16 @@
 export { OperationCatalog, type OperationCatalogProps, } from './rpc/OperationCatalog';
-export { EntityExplorerApp, type EntityExplorerAppProps, } from './rpc/EntityExplorerApp';
+export { EntityExplorerApp, type EntityExplorerAppProps, type SurfaceActionLabels, } from './rpc/EntityExplorerApp';
 export { ACCEPT_OPTIONS, VIEW_OPTIONS, type AcceptOption, type AcceptValue, } from './rpc/accept-options';
-export { SchemaActionForm, type SchemaActionFormProps, type FormActionContext, type FormActionsRenderer, } from './rpc/SchemaActionForm';
+export { SchemaActionForm, type SchemaActionFormProps, type FormActionContext, type FormActionsRenderer, type SchemaActionFormSlots, } from './rpc/SchemaActionForm';
 export { CommandForm, type CommandFormProps } from './rpc/CommandForm';
 export { normalizeParameters, pathParamNames, submitValue, } from './rpc/command-form-utils';
 export { CommandOutput, type CommandOutputProps } from './rpc/CommandOutput';
 export { FilterForm, type FilterFormProps } from './rpc/FilterForm';
 export { InlineError, type InlineErrorProps } from './rpc/InlineError';
 export { OperationActionDialog, type OperationActionDialogProps, } from './rpc/OperationActionDialog';
-export { OperationEntityPage, type OperationEntityPageProps, } from './rpc/OperationEntityPage';
+export { OperationEntityPage, type OperationEntityPageProps, type EntityDetailBodyRenderContext, type EntityDetailBodyRenderer, type EntityDetailHeaderRenderContext, type EntityDetailHeaderRenderer, } from './rpc/OperationEntityPage';
+export { OperationEntityContextPicker, type OperationEntityContextPickerProps, type EntityContextSurfaceFilter, type EntityContextSurfaceText, type EntityContextSurfaceIcon, type EntityContextSurfaceColor, type EntityContextGroupIcon, type EntityContextGroupColor, } from './rpc/OperationEntityContextPicker';
+export { entityContextItemID, clickyRowRecord, contextItemFromEntityRow, } from './rpc/OperationEntityContextPicker.model';
 export { OperationCommandPage, type OperationCommandPageProps, } from './rpc/OperationCommandPage';
 export { OperationResultView, type OperationResultViewProps, type OperationResultFilterConfig, type ResultRenderer, type ResultRenderContext, } from './rpc/OperationResultView';
 export { EndpointList, type EndpointListProps, type RenderLink, type RenderLinkArgs, } from './rpc/EndpointList';

package/dist/rpc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../src/rpc.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,KAAK,qBAAqB,GAC3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,iBAAiB,EACjB,KAAK,sBAAsB,GAC5B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,cAAc,EACd,YAAY,EACZ,KAAK,YAAY,EACjB,KAAK,WAAW,GACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,gBAAgB,EAChB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,GACzB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,WAAW,GACZ,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EACL,qBAAqB,EACrB,KAAK,0BAA0B,GAChC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,mBAAmB,EACnB,KAAK,wBAAwB,GAC9B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,oBAAoB,EACpB,KAAK,yBAAyB,GAC/B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,mBAAmB,EACnB,KAAK,wBAAwB,EAC7B,KAAK,2BAA2B,EAChC,KAAK,cAAc,EACnB,KAAK,mBAAmB,GACzB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,YAAY,EACZ,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,KAAK,mBAAmB,GACzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,KAAK,gCAAgC,EACrC,KAAK,yBAAyB,EAC9B,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,GAC/B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EACL,KAAK,aAAa,EAClB,SAAS,EACT,gBAAgB,EAChB,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,iBAAiB,GACvB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../src/rpc.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,KAAK,qBAAqB,GAC3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,iBAAiB,EACjB,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,GACzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,cAAc,EACd,YAAY,EACZ,KAAK,YAAY,EACjB,KAAK,WAAW,GACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,gBAAgB,EAChB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,GAC3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,WAAW,GACZ,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EACL,qBAAqB,EACrB,KAAK,0BAA0B,GAChC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,mBAAmB,EACnB,KAAK,wBAAwB,EAC7B,KAAK,6BAA6B,EAClC,KAAK,wBAAwB,EAC7B,KAAK,+BAA+B,EACpC,KAAK,0BAA0B,GAChC,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,4BAA4B,EAC5B,KAAK,iCAAiC,EACtC,KAAK,0BAA0B,EAC/B,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,GAC7B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,wBAAwB,GACzB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EACL,oBAAoB,EACpB,KAAK,yBAAyB,GAC/B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,mBAAmB,EACnB,KAAK,wBAAwB,EAC7B,KAAK,2BAA2B,EAChC,KAAK,cAAc,EACnB,KAAK,mBAAmB,GACzB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,YAAY,EACZ,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,KAAK,mBAAmB,GACzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,KAAK,gCAAgC,EACrC,KAAK,yBAAyB,EAC9B,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,GAC/B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EACL,KAAK,aAAa,EAClB,SAAS,EACT,gBAAgB,EAChB,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,iBAAiB,GACvB,MAAM,aAAa,CAAC"}

package/dist/rpc.js

@@ -9,6 +9,8 @@ import { FilterForm } from "./rpc/FilterForm.js";
 import { InlineError } from "./rpc/InlineError.js";
 import { OperationActionDialog } from "./rpc/OperationActionDialog.js";
 import { OperationEntityPage } from "./rpc/OperationEntityPage.js";
+import { OperationEntityContextPicker } from "./rpc/OperationEntityContextPicker.js";
+import { clickyRowRecord, contextItemFromEntityRow, entityContextItemID } from "./rpc/OperationEntityContextPicker.model.js";
 import { OperationCommandPage } from "./rpc/OperationCommandPage.js";
 import { OperationResultView } from "./rpc/OperationResultView.js";
 import { EndpointList } from "./rpc/EndpointList.js";
@@ -31,6 +33,7 @@ export {
   OperationActionDialog,
   OperationCatalog,
   OperationCommandPage,
+  OperationEntityContextPicker,
   OperationEntityPage,
   OperationResultView,
   OperationsApiClientError,
@@ -38,7 +41,10 @@ export {
   SchemaActionForm,
   VIEW_OPTIONS,
   buildCommandHref,
+  clickyRowRecord,
+  contextItemFromEntityRow,
   createOperationsApiClient,
+  entityContextItemID,
   filterOperationsByDomain,
   findDetailEndpoint,
   findListEndpoint,

package/dist/rpc.js.map

@@ -1 +1 @@
-{"version":3,"file":"rpc.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"rpc.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;"}