@perses-dev/plugin-system 0.55.0-beta.9 → 0.55.0-rc.1

package/dist/components/PanelSpecEditor/PanelSpecEditor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PanelSpecEditor.d.ts","sourceRoot":"","sources":["../../../src/components/PanelSpecEditor/PanelSpecEditor.tsx"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGtG,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAG/C,OAAO,KAAK,EAAE,iBAAiB,EAAe,MAAM,aAAa,CAAC;AAElE,OAAO,KAAK,EAAE,UAAU,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAM3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGvD,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACpC,eAAe,EAAE,eAAe,CAAC;IACjC,wBAAwB,EAAE,uBAAuB,EAAE,CAAC;IACpD,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,eAAe,EAAE,CAAC,OAAO,EAAE,eAAe,EAAE,KAAK,IAAI,CAAC;IACtD,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IAC5D,kBAAkB,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CAAC;IAChD,mBAAmB,EAAE,CAAC,WAAW,EAAE,cAAc,EAAE,KAAK,IAAI,CAAC;IAC7D,YAAY,EAAE,CAAC,kBAAkB,EAAE,MAAM,KAAK,IAAI,CAAC;CACpD;AAED,eAAO,MAAM,eAAe,kHA4I1B,CAAC"}
+{"version":3,"file":"PanelSpecEditor.d.ts","sourceRoot":"","sources":["../../../src/components/PanelSpecEditor/PanelSpecEditor.tsx"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGtG,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAG/C,OAAO,KAAK,EAAE,iBAAiB,EAAe,MAAM,aAAa,CAAC;AAElE,OAAO,KAAK,EAAE,UAAU,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAM3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGvD,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACpC,eAAe,EAAE,eAAe,CAAC;IACjC,wBAAwB,EAAE,uBAAuB,EAAE,CAAC;IACpD,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,eAAe,EAAE,CAAC,OAAO,EAAE,eAAe,EAAE,KAAK,IAAI,CAAC;IACtD,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IAC5D,kBAAkB,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CAAC;IAChD,mBAAmB,EAAE,CAAC,WAAW,EAAE,cAAc,EAAE,KAAK,IAAI,CAAC;IAC7D,YAAY,EAAE,CAAC,kBAAkB,EAAE,MAAM,KAAK,IAAI,CAAC;CACpD;AAED,eAAO,MAAM,eAAe,kHAmJ1B,CAAC"}

package/dist/components/PanelSpecEditor/PanelSpecEditor.js

@@ -23,7 +23,10 @@ import { PanelAnnotationsEditor } from "./PanelAnnotationsEditor.js";
 export const PanelSpecEditor = /*#__PURE__*/ forwardRef((props, ref)=>{
     const { control, panelDefinition, variableDefinitionGroups, panelGroups, onQueriesChange, onQueryRun, onPluginSpecChange, onAnnotationsChange, onJSONChange } = props;
     const { kind } = panelDefinition.spec.plugin;
-    const { data: plugin, isLoading, error } = usePlugin('Panel', kind);
+    const { data: plugin, isLoading, error } = usePlugin('Panel', kind, {
+        version: panelDefinition.spec.plugin.metadata?.version,
+        registry: panelDefinition.spec.plugin.metadata?.registry
+    });
     const { queryResults } = useDataQueriesContext();
     if (error) {
         return /*#__PURE__*/ _jsx(ErrorAlert, {

package/dist/components/PanelSpecEditor/PanelSpecEditor.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/components/PanelSpecEditor/PanelSpecEditor.tsx"],"sourcesContent":["// Copyright The Perses Authors\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n// http://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n\nimport { ErrorAlert, JSONEditor } from '@perses-dev/components';\nimport type { AnnotationSpec, PanelDefinition, QueryDefinition, UnknownSpec } from '@perses-dev/spec';\nimport type { ReactElement } from 'react';\nimport { forwardRef } from 'react';\nimport type { Control } from 'react-hook-form';\nimport { Controller } from 'react-hook-form';\n\nimport type { PanelEditorValues, PanelPlugin } from '../../model';\nimport { useDataQueriesContext, usePlugin } from '../../runtime';\nimport type { PanelGroup, VariableDefinitionGroup } from '../LayoutEditor';\nimport { LayoutEditor } from '../LayoutEditor';\nimport { LinksEditor } from '../LinksEditor';\nimport { MultiQueryEditor } from '../MultiQueryEditor';\nimport type { OptionsEditorTabsProps } from '../OptionsEditorTabs';\nimport { OptionsEditorTabs } from '../OptionsEditorTabs';\nimport type { PluginEditorRef } from '../PluginEditor';\nimport { PanelAnnotationsEditor } from './PanelAnnotationsEditor';\n\nexport interface PanelSpecEditorProps {\n  control: Control<PanelEditorValues>;\n  panelDefinition: PanelDefinition;\n  variableDefinitionGroups: VariableDefinitionGroup[];\n  panelGroups?: PanelGroup[];\n  onQueriesChange: (queries: QueryDefinition[]) => void;\n  onQueryRun: (index: number, query: QueryDefinition) => void;\n  onPluginSpecChange: (spec: UnknownSpec) => void;\n  onAnnotationsChange: (annotations: AnnotationSpec[]) => void;\n  onJSONChange: (panelDefinitionStr: string) => void;\n}\n\nexport const PanelSpecEditor = forwardRef<PluginEditorRef, PanelSpecEditorProps>((props, ref): ReactElement | null => {\n  const {\n    control,\n    panelDefinition,\n    variableDefinitionGroups,\n    panelGroups,\n    onQueriesChange,\n    onQueryRun,\n    onPluginSpecChange,\n    onAnnotationsChange,\n    onJSONChange,\n  } = props;\n  const { kind } = panelDefinition.spec.plugin;\n  const { data: plugin, isLoading, error } = usePlugin('Panel', kind);\n\n  const { queryResults } = useDataQueriesContext();\n\n  if (error) {\n    return <ErrorAlert error={error} />;\n  }\n\n  if (isLoading) {\n    return null;\n  }\n\n  if (!plugin) {\n    throw new Error(`Missing implementation for panel plugin with kind '${kind}'`);\n  }\n\n  const { panelOptionsEditorComponents, hideQueryEditor, supportsAnnotations } = plugin as PanelPlugin;\n  let tabs: OptionsEditorTabsProps['tabs'] = [];\n\n  if (!hideQueryEditor) {\n    tabs.push({\n      label: 'Query',\n      content: (\n        <Controller\n          control={control}\n          name=\"panelDefinition.spec.queries\"\n          render={({ field }) => (\n            <MultiQueryEditor\n              ref={ref}\n              queryTypes={plugin.supportedQueryTypes ?? []}\n              queries={panelDefinition.spec.queries ?? []}\n              queryResults={queryResults}\n              onChange={(queries) => {\n                field.onChange(queries);\n                onQueriesChange(queries);\n              }}\n              onQueryRun={(index, query) => {\n                onQueryRun(index, query);\n                // If spec has not changed, refetch to update the data\n                if (JSON.stringify(panelDefinition.spec.queries?.[index]) === JSON.stringify(query)) {\n                  queryResults[index]?.refetch?.();\n                }\n              }}\n            />\n          )}\n        />\n      ),\n    });\n  }\n\n  if (panelOptionsEditorComponents) {\n    tabs = tabs.concat(\n      panelOptionsEditorComponents.map(({ label, content: OptionsEditorComponent }) => ({\n        label,\n        content: (\n          <Controller\n            control={control}\n            name=\"panelDefinition.spec.plugin.spec\"\n            render={({ field }) => (\n              <OptionsEditorComponent\n                value={panelDefinition.spec.plugin.spec}\n                onChange={(spec) => {\n                  field.onChange(spec);\n                  onPluginSpecChange(spec);\n                }}\n              />\n            )}\n          />\n        ),\n      })),\n    );\n  }\n\n  // annotations are common to all panel plugins, but only shown for plugins that render them\n  if (supportsAnnotations) {\n    tabs.push({\n      label: 'Annotations',\n      content: (\n        <Controller\n          control={control}\n          name=\"panelDefinition.spec.annotations\"\n          render={({ field }) => (\n            <PanelAnnotationsEditor\n              value={panelDefinition.spec.annotations ?? []}\n              onChange={(annotations) => {\n                field.onChange(annotations);\n                onAnnotationsChange(annotations);\n              }}\n            />\n          )}\n        />\n      ),\n    });\n  }\n\n  // Always show the JSON editor, Links editor, and Layout editor by default.\n  tabs.push({\n    label: 'Links',\n    content: <LinksEditor control={control} />,\n  });\n  tabs.push({\n    label: 'JSON',\n    content: (\n      <Controller\n        control={control}\n        name=\"panelDefinition\"\n        render={({ field }) => (\n          <JSONEditor\n            maxHeight=\"80vh\"\n            value={panelDefinition}\n            onChange={(json) => {\n              field.onChange(JSON.parse(json));\n              onJSONChange(json);\n            }}\n          />\n        )}\n      />\n    ),\n  });\n  tabs.push({\n    label: 'Layout',\n    content: (\n      <LayoutEditor control={control} variableDefinitionGroups={variableDefinitionGroups} panelGroups={panelGroups} />\n    ),\n  });\n\n  return <OptionsEditorTabs key={tabs.length} tabs={tabs} />;\n});\n\nPanelSpecEditor.displayName = 'PanelSpecEditor';\n"],"names":["ErrorAlert","JSONEditor","forwardRef","Controller","useDataQueriesContext","usePlugin","LayoutEditor","LinksEditor","MultiQueryEditor","OptionsEditorTabs","PanelAnnotationsEditor","PanelSpecEditor","props","ref","control","panelDefinition","variableDefinitionGroups","panelGroups","onQueriesChange","onQueryRun","onPluginSpecChange","onAnnotationsChange","onJSONChange","kind","spec","plugin","data","isLoading","error","queryResults","Error","panelOptionsEditorComponents","hideQueryEditor","supportsAnnotations","tabs","push","label","content","name","render","field","queryTypes","supportedQueryTypes","queries","onChange","index","query","JSON","stringify","refetch","concat","map","OptionsEditorComponent","value","annotations","maxHeight","json","parse","length","displayName"],"mappings":"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"}
+{"version":3,"sources":["../../../src/components/PanelSpecEditor/PanelSpecEditor.tsx"],"sourcesContent":["// Copyright The Perses Authors\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n// http://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n\nimport { ErrorAlert, JSONEditor } from '@perses-dev/components';\nimport type { AnnotationSpec, PanelDefinition, QueryDefinition, UnknownSpec } from '@perses-dev/spec';\nimport type { ReactElement } from 'react';\nimport { forwardRef } from 'react';\nimport type { Control } from 'react-hook-form';\nimport { Controller } from 'react-hook-form';\n\nimport type { PanelEditorValues, PanelPlugin } from '../../model';\nimport { useDataQueriesContext, usePlugin } from '../../runtime';\nimport type { PanelGroup, VariableDefinitionGroup } from '../LayoutEditor';\nimport { LayoutEditor } from '../LayoutEditor';\nimport { LinksEditor } from '../LinksEditor';\nimport { MultiQueryEditor } from '../MultiQueryEditor';\nimport type { OptionsEditorTabsProps } from '../OptionsEditorTabs';\nimport { OptionsEditorTabs } from '../OptionsEditorTabs';\nimport type { PluginEditorRef } from '../PluginEditor';\nimport { PanelAnnotationsEditor } from './PanelAnnotationsEditor';\n\nexport interface PanelSpecEditorProps {\n  control: Control<PanelEditorValues>;\n  panelDefinition: PanelDefinition;\n  variableDefinitionGroups: VariableDefinitionGroup[];\n  panelGroups?: PanelGroup[];\n  onQueriesChange: (queries: QueryDefinition[]) => void;\n  onQueryRun: (index: number, query: QueryDefinition) => void;\n  onPluginSpecChange: (spec: UnknownSpec) => void;\n  onAnnotationsChange: (annotations: AnnotationSpec[]) => void;\n  onJSONChange: (panelDefinitionStr: string) => void;\n}\n\nexport const PanelSpecEditor = forwardRef<PluginEditorRef, PanelSpecEditorProps>((props, ref): ReactElement | null => {\n  const {\n    control,\n    panelDefinition,\n    variableDefinitionGroups,\n    panelGroups,\n    onQueriesChange,\n    onQueryRun,\n    onPluginSpecChange,\n    onAnnotationsChange,\n    onJSONChange,\n  } = props;\n  const { kind } = panelDefinition.spec.plugin;\n  const {\n    data: plugin,\n    isLoading,\n    error,\n  } = usePlugin('Panel', kind, {\n    version: panelDefinition.spec.plugin.metadata?.version,\n    registry: panelDefinition.spec.plugin.metadata?.registry,\n  });\n\n  const { queryResults } = useDataQueriesContext();\n\n  if (error) {\n    return <ErrorAlert error={error} />;\n  }\n\n  if (isLoading) {\n    return null;\n  }\n\n  if (!plugin) {\n    throw new Error(`Missing implementation for panel plugin with kind '${kind}'`);\n  }\n\n  const { panelOptionsEditorComponents, hideQueryEditor, supportsAnnotations } = plugin as PanelPlugin;\n  let tabs: OptionsEditorTabsProps['tabs'] = [];\n\n  if (!hideQueryEditor) {\n    tabs.push({\n      label: 'Query',\n      content: (\n        <Controller\n          control={control}\n          name=\"panelDefinition.spec.queries\"\n          render={({ field }) => (\n            <MultiQueryEditor\n              ref={ref}\n              queryTypes={plugin.supportedQueryTypes ?? []}\n              queries={panelDefinition.spec.queries ?? []}\n              queryResults={queryResults}\n              onChange={(queries) => {\n                field.onChange(queries);\n                onQueriesChange(queries);\n              }}\n              onQueryRun={(index, query) => {\n                onQueryRun(index, query);\n                // If spec has not changed, refetch to update the data\n                if (JSON.stringify(panelDefinition.spec.queries?.[index]) === JSON.stringify(query)) {\n                  queryResults[index]?.refetch?.();\n                }\n              }}\n            />\n          )}\n        />\n      ),\n    });\n  }\n\n  if (panelOptionsEditorComponents) {\n    tabs = tabs.concat(\n      panelOptionsEditorComponents.map(({ label, content: OptionsEditorComponent }) => ({\n        label,\n        content: (\n          <Controller\n            control={control}\n            name=\"panelDefinition.spec.plugin.spec\"\n            render={({ field }) => (\n              <OptionsEditorComponent\n                value={panelDefinition.spec.plugin.spec}\n                onChange={(spec) => {\n                  field.onChange(spec);\n                  onPluginSpecChange(spec);\n                }}\n              />\n            )}\n          />\n        ),\n      })),\n    );\n  }\n\n  // annotations are common to all panel plugins, but only shown for plugins that render them\n  if (supportsAnnotations) {\n    tabs.push({\n      label: 'Annotations',\n      content: (\n        <Controller\n          control={control}\n          name=\"panelDefinition.spec.annotations\"\n          render={({ field }) => (\n            <PanelAnnotationsEditor\n              value={panelDefinition.spec.annotations ?? []}\n              onChange={(annotations) => {\n                field.onChange(annotations);\n                onAnnotationsChange(annotations);\n              }}\n            />\n          )}\n        />\n      ),\n    });\n  }\n\n  // Always show the JSON editor, Links editor, and Layout editor by default.\n  tabs.push({\n    label: 'Links',\n    content: <LinksEditor control={control} />,\n  });\n  tabs.push({\n    label: 'JSON',\n    content: (\n      <Controller\n        control={control}\n        name=\"panelDefinition\"\n        render={({ field }) => (\n          <JSONEditor\n            maxHeight=\"80vh\"\n            value={panelDefinition}\n            onChange={(json) => {\n              field.onChange(JSON.parse(json));\n              onJSONChange(json);\n            }}\n          />\n        )}\n      />\n    ),\n  });\n  tabs.push({\n    label: 'Layout',\n    content: (\n      <LayoutEditor control={control} variableDefinitionGroups={variableDefinitionGroups} panelGroups={panelGroups} />\n    ),\n  });\n\n  return <OptionsEditorTabs key={tabs.length} tabs={tabs} />;\n});\n\nPanelSpecEditor.displayName = 'PanelSpecEditor';\n"],"names":["ErrorAlert","JSONEditor","forwardRef","Controller","useDataQueriesContext","usePlugin","LayoutEditor","LinksEditor","MultiQueryEditor","OptionsEditorTabs","PanelAnnotationsEditor","PanelSpecEditor","props","ref","control","panelDefinition","variableDefinitionGroups","panelGroups","onQueriesChange","onQueryRun","onPluginSpecChange","onAnnotationsChange","onJSONChange","kind","spec","plugin","data","isLoading","error","version","metadata","registry","queryResults","Error","panelOptionsEditorComponents","hideQueryEditor","supportsAnnotations","tabs","push","label","content","name","render","field","queryTypes","supportedQueryTypes","queries","onChange","index","query","JSON","stringify","refetch","concat","map","OptionsEditorComponent","value","annotations","maxHeight","json","parse","length","displayName"],"mappings":"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"}

package/dist/components/PluginEditor/plugin-editor-api.d.ts

@@ -1,9 +1,15 @@
 import type { BoxProps } from '@mui/material';
-import type { DatasourceSpec, UnknownSpec } from '@perses-dev/spec';
+import type { DatasourceSpec, PluginDefinitionMetadata, UnknownSpec } from '@perses-dev/spec';
 import type { PluginType } from '../../model';
 export interface PluginEditorSelection {
     type: PluginType;
     kind: string;
+    /**
+     * Optional plugin definition metadata (version and/or registry), matching the `metadata` field of a spec
+     * `Definition`. Only set when the user explicitly picks a specific version/registry of a plugin that has several of
+     * them available. When omitted, the latest available version is used.
+     */
+    metadata?: PluginDefinitionMetadata;
 }
 export interface PluginEditorValue {
     selection: PluginEditorSelection;

package/dist/components/PluginEditor/plugin-editor-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-editor-api.d.ts","sourceRoot":"","sources":["../../../src/components/PluginEditor/plugin-editor-api.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAIpE,OAAO,KAAK,EAAe,UAAU,EAAE,MAAM,aAAa,CAAC;AAM3D,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,qBAAqB,CAAC;IACjC,IAAI,EAAE,WAAW,CAAC;CACnB;AAID,KAAK,eAAe,GAAG,UAAU,GAAG,OAAO,GAAG,UAAU,CAAC;AAEzD,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,QAAQ,EAAE,eAAe,CAAC;IACxE,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,iBAAiB,CAAC;IACzB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,QAAQ,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC5C,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACnF;AAED,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B;AAKD;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,iBAAiB,EAAE,aAAa,GAAG,OAAO,GAAG,UAAU,CAAC,GAAG;IACjG,uBAAuB,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;CACvD,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG;IAC5D,gBAAgB,CAAC,EAAE,qBAAqB,CAAC;IACzC,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,iBAAiB,EAAE,CAAC,CAAC,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACtD,YAAY,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CAAC;IAC1C,wBAAwB,EAAE,MAAM,IAAI,CAAC;CACtC,CAkIA"}
+{"version":3,"file":"plugin-editor-api.d.ts","sourceRoot":"","sources":["../../../src/components/PluginEditor/plugin-editor-api.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,wBAAwB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAK9F,OAAO,KAAK,EAAe,UAAU,EAAwB,MAAM,aAAa,CAAC;AAMjF,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,QAAQ,CAAC,EAAE,wBAAwB,CAAC;CACrC;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,qBAAqB,CAAC;IACjC,IAAI,EAAE,WAAW,CAAC;CACnB;AAID,KAAK,eAAe,GAAG,UAAU,GAAG,OAAO,GAAG,UAAU,CAAC;AAEzD,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,QAAQ,EAAE,eAAe,CAAC;IACxE,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,iBAAiB,CAAC;IACzB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,QAAQ,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC5C,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACnF;AAED,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B;AAKD;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,iBAAiB,EAAE,aAAa,GAAG,OAAO,GAAG,UAAU,CAAC,GAAG;IACjG,uBAAuB,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;CACvD,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG;IAC5D,gBAAgB,CAAC,EAAE,qBAAqB,CAAC;IACzC,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,iBAAiB,EAAE,CAAC,CAAC,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACtD,YAAY,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CAAC;IAC1C,wBAAwB,EAAE,MAAM,IAAI,CAAC;CACtC,CAkIA"}

package/dist/components/PluginEditor/plugin-editor-api.js

@@ -10,9 +10,10 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
+import { useMutation, useQueryClient } from "@tanstack/react-query";
 import { produce } from "immer";
-import { useState, useRef, useEffect } from "react";
-import { usePlugin, usePluginRegistry } from "../../runtime/index.js";
+import { useRef, useEffect } from "react";
+import { usePluginRegistry } from "../../runtime/index.js";
 import { useEvent } from "../../utils/index.js";
 /**
  * Returns the state/handlers that power the `PluginEditor` component. Useful for custom components that want to provide
@@ -20,7 +21,6 @@ import { useEvent } from "../../utils/index.js";
  * remembers previous `spec` values that it's seen, allowing and restores those values if a user switches the plugin
  * kind back.
  */ export function usePluginEditor(props) {
-    // eslint-disable-next-line @typescript-eslint/no-empty-function
     const { pluginTypes, value, onHideQueryEditorChange = ()=>{} } = props; // setting onHideQueryEditorChange to empty function here because useEvent requires a function
     // Keep a stable reference, so we don't run the effect below when we don't need to
     const onChange = useEvent(props.onChange);
@@ -43,56 +43,63 @@ import { useEvent } from "../../utils/index.js";
     const hideQueryState = useRef({
         [value.selection.kind]: false
     });
-    const { defaultPluginKinds } = usePluginRegistry();
+    const { defaultPluginKinds, getPlugin } = usePluginRegistry();
+    const queryClient = useQueryClient();
+    const currentRequest = useRef(undefined);
+    const selectionLoad = useMutation({
+        mutationFn: (selection)=>queryClient.fetchQuery({
+                queryKey: [
+                    'getPlugin',
+                    selection.type,
+                    selection.kind,
+                    selection.metadata?.version ?? '',
+                    selection.metadata?.registry ?? ''
+                ],
+                queryFn: ()=>getPlugin({
+                        kind: selection.type,
+                        name: selection.kind,
+                        version: selection.metadata?.version,
+                        registry: selection.metadata?.registry
+                    })
+            })
+    });
+    const pendingSelection = selectionLoad.isSuccess ? undefined : selectionLoad.variables;
     const defaultPluginType = pluginTypes[0];
     const defaultPluginKind = defaultPluginType ? defaultPluginKinds?.[defaultPluginType] : undefined;
-    const defaultPluginSelection = defaultPluginType && defaultPluginKind ? {
-        type: defaultPluginType,
-        kind: defaultPluginKind
-    } : undefined;
-    const initPendingSelection = !value.selection && defaultPluginSelection ? defaultPluginSelection : undefined;
-    // When kind changes and we haven't loaded that plugin before, we will need to enter a "pending" state so that we
-    // can generate proper initial spec values that match the new plugin kind
-    const [pendingSelection, setPendingSelection] = useState(initPendingSelection);
-    // Take a default kind in case user write explicitly an empty kind in the initial value
+    // Notify the owner instead of mutating the selection passed by the caller.
     useEffect(()=>{
-        if (value.selection.kind === '') {
-            value.selection.kind = defaultPluginKind || '';
+        if (value.selection.kind === '' && defaultPluginKind) {
+            onChange({
+                ...value,
+                selection: {
+                    ...value.selection,
+                    kind: defaultPluginKind
+                }
+            });
         }
     }, [
-        value.selection,
-        defaultPluginKind
+        value,
+        defaultPluginKind,
+        onChange
     ]);
-    const { data: plugin, isFetching, error } = usePlugin(pendingSelection?.type, pendingSelection?.kind || '');
-    useEffect(()=>{
-        // Nothing to do if no new plugin kind is pending
-        if (!pendingSelection) return;
-        // Can't get spec value until we have a plugin
-        if (plugin === undefined || isFetching) return;
-        // Fire an onChange to change to the pending kind with initial values from the plugin
+    // Apply each completed load once, independently of how the owner stores the selection metadata.
+    const applyLoadedSelection = useEvent((plugin, selection)=>{
+        // v4 `reset()` still observes the in-flight load, which then reports the current (empty or newer) result.
+        if (!plugin || selection !== currentRequest.current) return;
+        currentRequest.current = undefined;
         rememberCurrentSpecState();
         onChange({
-            selection: pendingSelection,
+            selection,
             spec: plugin.createInitialOptions ? plugin.createInitialOptions() : {}
         });
-        if (pendingSelection.type === 'Panel') {
+        if (selection.type === 'Panel') {
             const panelPlugin = plugin;
-            hideQueryState.current[pendingSelection.kind] = !!panelPlugin.hideQueryEditor;
+            hideQueryState.current[selection.kind] = !!panelPlugin.hideQueryEditor;
             if (!!panelPlugin.hideQueryEditor !== hideQueryState.current[value.selection.kind]) {
                 onHideQuery(!!panelPlugin.hideQueryEditor);
             }
         }
-        setPendingSelection(undefined);
-    }, [
-        pendingSelection,
-        plugin,
-        isFetching,
-        rememberCurrentSpecState,
-        onChange,
-        onHideQuery,
-        hideQueryState,
-        value.selection
-    ]);
+    });
     /**
    * When the user tries to change the plugin kind, make sure we have the correct spec for that plugin kind before we
    * make the switch.
@@ -100,6 +107,8 @@ import { useEvent } from "../../utils/index.js";
         // If we already have state for this plugin type/kind from a previous selection, just use it
         const previousState = prevSpecState.current[nextSelection.type]?.[nextSelection.kind];
         if (previousState !== undefined) {
+            currentRequest.current = undefined;
+            selectionLoad.reset();
             rememberCurrentSpecState();
             onChange({
                 selection: nextSelection,
@@ -107,7 +116,11 @@ import { useEvent } from "../../utils/index.js";
             });
         } else {
             // Otherwise, kick off the async loading process
-            setPendingSelection(nextSelection);
+            // Per-call callbacks run only for the latest mutation while the editor is mounted.
+            currentRequest.current = nextSelection;
+            selectionLoad.mutate(nextSelection, {
+                onSuccess: applyLoadedSelection
+            });
         }
         if (nextSelection.type === 'Panel' && hideQueryState.current[nextSelection.kind] !== undefined && hideQueryState.current[value.selection.kind] !== hideQueryState.current[nextSelection.kind]) {
             onHideQuery(!!hideQueryState.current[nextSelection.kind]);
@@ -122,8 +135,8 @@ import { useEvent } from "../../utils/index.js";
     };
     return {
         pendingSelection,
-        isLoading: isFetching,
-        error,
+        isLoading: selectionLoad.isLoading,
+        error: selectionLoad.error,
         onSelectionChange,
         onSpecChange,
         rememberCurrentSpecState

package/dist/components/PluginEditor/plugin-editor-api.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/components/PluginEditor/plugin-editor-api.ts"],"sourcesContent":["// Copyright The Perses Authors\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n// http://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n\nimport type { BoxProps } from '@mui/material';\nimport type { DatasourceSpec, UnknownSpec } from '@perses-dev/spec';\nimport { produce } from 'immer';\nimport { useState, useRef, useEffect } from 'react';\n\nimport type { PanelPlugin, PluginType } from '../../model';\nimport { usePlugin, usePluginRegistry } from '../../runtime';\nimport { useEvent } from '../../utils';\nimport type { PluginKindSelectProps } from '../PluginKindSelect';\nimport type { PluginSpecEditorProps } from '../PluginSpecEditor';\n\nexport interface PluginEditorSelection {\n  type: PluginType;\n  kind: string;\n}\n\nexport interface PluginEditorValue {\n  selection: PluginEditorSelection;\n  spec: UnknownSpec;\n}\n\n// Props on MUI Box that we don't want people to pass because we're either redefining them or providing them in\n// this component\ntype OmittedMuiProps = 'children' | 'value' | 'onChange';\n\nexport interface PluginEditorProps extends Omit<BoxProps, OmittedMuiProps> {\n  pluginTypes: PluginType[];\n  pluginKindLabel: string;\n  value: PluginEditorValue;\n  isReadonly?: boolean;\n  withRunQueryButton?: boolean;\n  filteredQueryPlugins?: string[];\n  onChange: (next: PluginEditorValue) => void;\n  onRunQuery?: () => void;\n  testConnection?: (spec: DatasourceSpec, healthCheckPath: string) => Promise<void>;\n}\n\nexport interface PluginEditorRef {\n  flushChanges?: () => void;\n}\n\ntype PreviousSpecState = Record<string, Record<string, UnknownSpec>>;\ntype HideQueryEditorState = Record<string, boolean>;\n\n/**\n * Props needed by the usePluginEditor hook.\n */\nexport type UsePluginEditorProps = Pick<PluginEditorProps, 'pluginTypes' | 'value' | 'onChange'> & {\n  onHideQueryEditorChange?: (isHidden: boolean) => void;\n};\n\n/**\n * Returns the state/handlers that power the `PluginEditor` component. Useful for custom components that want to provide\n * a different UI, but want the same behavior of changing `kind` and `spec` together on plugin kind changes. Also\n * remembers previous `spec` values that it's seen, allowing and restores those values if a user switches the plugin\n * kind back.\n */\nexport function usePluginEditor(props: UsePluginEditorProps): {\n  pendingSelection?: PluginEditorSelection;\n  isLoading: boolean;\n  error: Error | null;\n  onSelectionChange: (s: PluginEditorSelection) => void;\n  onSpecChange: (next: UnknownSpec) => void;\n  rememberCurrentSpecState: () => void;\n} {\n  // eslint-disable-next-line @typescript-eslint/no-empty-function\n  const { pluginTypes, value, onHideQueryEditorChange = (): void => {} } = props; // setting onHideQueryEditorChange to empty function here because useEvent requires a function\n\n  // Keep a stable reference, so we don't run the effect below when we don't need to\n  const onChange = useEvent(props.onChange);\n  const onHideQuery = useEvent(onHideQueryEditorChange);\n\n  // The previous spec state for PluginType and kind and a helper function for remembering current values\n  const prevSpecState = useRef<PreviousSpecState>({\n    [value.selection.type]: { [value.selection.kind]: value.spec },\n  });\n  const rememberCurrentSpecState = useEvent(() => {\n    let byPluginType = prevSpecState.current[value.selection.type];\n    if (byPluginType === undefined) {\n      byPluginType = {};\n      prevSpecState.current[value.selection.type] = byPluginType;\n    }\n    byPluginType[value.selection.kind] = value.spec;\n  });\n\n  // The previous hide query state for each panel kind\n  const hideQueryState = useRef<HideQueryEditorState>({\n    [value.selection.kind]: false,\n  });\n\n  const { defaultPluginKinds } = usePluginRegistry();\n  const defaultPluginType = pluginTypes[0];\n  const defaultPluginKind = defaultPluginType ? defaultPluginKinds?.[defaultPluginType] : undefined;\n  const defaultPluginSelection =\n    defaultPluginType && defaultPluginKind\n      ? {\n          type: defaultPluginType,\n          kind: defaultPluginKind,\n        }\n      : undefined;\n  const initPendingSelection = !value.selection && defaultPluginSelection ? defaultPluginSelection : undefined;\n\n  // When kind changes and we haven't loaded that plugin before, we will need to enter a \"pending\" state so that we\n  // can generate proper initial spec values that match the new plugin kind\n  const [pendingSelection, setPendingSelection] = useState<PluginEditorSelection | undefined>(initPendingSelection);\n\n  // Take a default kind in case user write explicitly an empty kind in the initial value\n  useEffect(() => {\n    if (value.selection.kind === '') {\n      value.selection.kind = defaultPluginKind || '';\n    }\n  }, [value.selection, defaultPluginKind]);\n\n  const { data: plugin, isFetching, error } = usePlugin(pendingSelection?.type, pendingSelection?.kind || '');\n\n  useEffect(() => {\n    // Nothing to do if no new plugin kind is pending\n    if (!pendingSelection) return;\n\n    // Can't get spec value until we have a plugin\n    if (plugin === undefined || isFetching) return;\n\n    // Fire an onChange to change to the pending kind with initial values from the plugin\n    rememberCurrentSpecState();\n    onChange({\n      selection: pendingSelection,\n      spec: plugin.createInitialOptions ? plugin.createInitialOptions() : {},\n    });\n\n    if (pendingSelection.type === 'Panel') {\n      const panelPlugin = plugin as PanelPlugin;\n      hideQueryState.current[pendingSelection.kind] = !!panelPlugin.hideQueryEditor;\n      if (!!panelPlugin.hideQueryEditor !== hideQueryState.current[value.selection.kind]) {\n        onHideQuery(!!panelPlugin.hideQueryEditor);\n      }\n    }\n    setPendingSelection(undefined);\n  }, [\n    pendingSelection,\n    plugin,\n    isFetching,\n    rememberCurrentSpecState,\n    onChange,\n    onHideQuery,\n    hideQueryState,\n    value.selection,\n  ]);\n\n  /**\n   * When the user tries to change the plugin kind, make sure we have the correct spec for that plugin kind before we\n   * make the switch.\n   */\n  const onSelectionChange: PluginKindSelectProps['onChange'] = (nextSelection) => {\n    // If we already have state for this plugin type/kind from a previous selection, just use it\n    const previousState = prevSpecState.current[nextSelection.type]?.[nextSelection.kind];\n    if (previousState !== undefined) {\n      rememberCurrentSpecState();\n      onChange({\n        selection: nextSelection,\n        spec: previousState,\n      });\n    } else {\n      // Otherwise, kick off the async loading process\n      setPendingSelection(nextSelection);\n    }\n\n    if (\n      nextSelection.type === 'Panel' &&\n      hideQueryState.current[nextSelection.kind] !== undefined &&\n      hideQueryState.current[value.selection.kind] !== hideQueryState.current[nextSelection.kind]\n    ) {\n      onHideQuery(!!hideQueryState.current[nextSelection.kind]);\n    }\n  };\n\n  /**\n   * Spec changes are independent and always just set the spec state.\n   */\n  const onSpecChange: PluginSpecEditorProps['onChange'] = (next) => {\n    onChange(\n      produce(value, (draft) => {\n        draft.spec = next;\n      }),\n    );\n  };\n\n  return {\n    pendingSelection,\n    isLoading: isFetching,\n    error,\n    onSelectionChange,\n    onSpecChange,\n    rememberCurrentSpecState,\n  };\n}\n"],"names":["produce","useState","useRef","useEffect","usePlugin","usePluginRegistry","useEvent","usePluginEditor","props","pluginTypes","value","onHideQueryEditorChange","onChange","onHideQuery","prevSpecState","selection","type","kind","spec","rememberCurrentSpecState","byPluginType","current","undefined","hideQueryState","defaultPluginKinds","defaultPluginType","defaultPluginKind","defaultPluginSelection","initPendingSelection","pendingSelection","setPendingSelection","data","plugin","isFetching","error","createInitialOptions","panelPlugin","hideQueryEditor","onSelectionChange","nextSelection","previousState","onSpecChange","next","draft","isLoading"],"mappings":"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"}
+{"version":3,"sources":["../../../src/components/PluginEditor/plugin-editor-api.ts"],"sourcesContent":["// Copyright The Perses Authors\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n// http://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n\nimport type { BoxProps } from '@mui/material';\nimport type { DatasourceSpec, PluginDefinitionMetadata, UnknownSpec } from '@perses-dev/spec';\nimport { useMutation, useQueryClient } from '@tanstack/react-query';\nimport { produce } from 'immer';\nimport { useRef, useEffect } from 'react';\n\nimport type { PanelPlugin, PluginType, PluginImplementation } from '../../model';\nimport { usePluginRegistry } from '../../runtime';\nimport { useEvent } from '../../utils';\nimport type { PluginKindSelectProps } from '../PluginKindSelect';\nimport type { PluginSpecEditorProps } from '../PluginSpecEditor';\n\nexport interface PluginEditorSelection {\n  type: PluginType;\n  kind: string;\n  /**\n   * Optional plugin definition metadata (version and/or registry), matching the `metadata` field of a spec\n   * `Definition`. Only set when the user explicitly picks a specific version/registry of a plugin that has several of\n   * them available. When omitted, the latest available version is used.\n   */\n  metadata?: PluginDefinitionMetadata;\n}\n\nexport interface PluginEditorValue {\n  selection: PluginEditorSelection;\n  spec: UnknownSpec;\n}\n\n// Props on MUI Box that we don't want people to pass because we're either redefining them or providing them in\n// this component\ntype OmittedMuiProps = 'children' | 'value' | 'onChange';\n\nexport interface PluginEditorProps extends Omit<BoxProps, OmittedMuiProps> {\n  pluginTypes: PluginType[];\n  pluginKindLabel: string;\n  value: PluginEditorValue;\n  isReadonly?: boolean;\n  withRunQueryButton?: boolean;\n  filteredQueryPlugins?: string[];\n  onChange: (next: PluginEditorValue) => void;\n  onRunQuery?: () => void;\n  testConnection?: (spec: DatasourceSpec, healthCheckPath: string) => Promise<void>;\n}\n\nexport interface PluginEditorRef {\n  flushChanges?: () => void;\n}\n\ntype PreviousSpecState = Record<string, Record<string, UnknownSpec>>;\ntype HideQueryEditorState = Record<string, boolean>;\n\n/**\n * Props needed by the usePluginEditor hook.\n */\nexport type UsePluginEditorProps = Pick<PluginEditorProps, 'pluginTypes' | 'value' | 'onChange'> & {\n  onHideQueryEditorChange?: (isHidden: boolean) => void;\n};\n\n/**\n * Returns the state/handlers that power the `PluginEditor` component. Useful for custom components that want to provide\n * a different UI, but want the same behavior of changing `kind` and `spec` together on plugin kind changes. Also\n * remembers previous `spec` values that it's seen, allowing and restores those values if a user switches the plugin\n * kind back.\n */\nexport function usePluginEditor(props: UsePluginEditorProps): {\n  pendingSelection?: PluginEditorSelection;\n  isLoading: boolean;\n  error: Error | null;\n  onSelectionChange: (s: PluginEditorSelection) => void;\n  onSpecChange: (next: UnknownSpec) => void;\n  rememberCurrentSpecState: () => void;\n} {\n  const { pluginTypes, value, onHideQueryEditorChange = (): void => {} } = props; // setting onHideQueryEditorChange to empty function here because useEvent requires a function\n\n  // Keep a stable reference, so we don't run the effect below when we don't need to\n  const onChange = useEvent(props.onChange);\n  const onHideQuery = useEvent(onHideQueryEditorChange);\n\n  // The previous spec state for PluginType and kind and a helper function for remembering current values\n  const prevSpecState = useRef<PreviousSpecState>({\n    [value.selection.type]: { [value.selection.kind]: value.spec },\n  });\n  const rememberCurrentSpecState = useEvent(() => {\n    let byPluginType = prevSpecState.current[value.selection.type];\n    if (byPluginType === undefined) {\n      byPluginType = {};\n      prevSpecState.current[value.selection.type] = byPluginType;\n    }\n    byPluginType[value.selection.kind] = value.spec;\n  });\n\n  // The previous hide query state for each panel kind\n  const hideQueryState = useRef<HideQueryEditorState>({\n    [value.selection.kind]: false,\n  });\n\n  const { defaultPluginKinds, getPlugin } = usePluginRegistry();\n  const queryClient = useQueryClient();\n  const currentRequest = useRef<PluginEditorSelection | undefined>(undefined);\n  const selectionLoad = useMutation<PluginImplementation<PluginType>, Error, PluginEditorSelection>({\n    mutationFn: (selection) =>\n      queryClient.fetchQuery({\n        queryKey: [\n          'getPlugin',\n          selection.type,\n          selection.kind,\n          selection.metadata?.version ?? '',\n          selection.metadata?.registry ?? '',\n        ],\n        queryFn: () =>\n          getPlugin({\n            kind: selection.type,\n            name: selection.kind,\n            version: selection.metadata?.version,\n            registry: selection.metadata?.registry,\n          }),\n      }),\n  });\n  const pendingSelection = selectionLoad.isSuccess ? undefined : selectionLoad.variables;\n  const defaultPluginType = pluginTypes[0];\n  const defaultPluginKind = defaultPluginType ? defaultPluginKinds?.[defaultPluginType] : undefined;\n\n  // Notify the owner instead of mutating the selection passed by the caller.\n  useEffect(() => {\n    if (value.selection.kind === '' && defaultPluginKind) {\n      onChange({ ...value, selection: { ...value.selection, kind: defaultPluginKind } });\n    }\n  }, [value, defaultPluginKind, onChange]);\n\n  // Apply each completed load once, independently of how the owner stores the selection metadata.\n  const applyLoadedSelection = useEvent(\n    (plugin: PluginImplementation<PluginType> | undefined, selection: PluginEditorSelection) => {\n      // v4 `reset()` still observes the in-flight load, which then reports the current (empty or newer) result.\n      if (!plugin || selection !== currentRequest.current) return;\n      currentRequest.current = undefined;\n      rememberCurrentSpecState();\n      onChange({\n        selection,\n        spec: plugin.createInitialOptions ? plugin.createInitialOptions() : {},\n      });\n\n      if (selection.type === 'Panel') {\n        const panelPlugin = plugin as PanelPlugin;\n        hideQueryState.current[selection.kind] = !!panelPlugin.hideQueryEditor;\n        if (!!panelPlugin.hideQueryEditor !== hideQueryState.current[value.selection.kind]) {\n          onHideQuery(!!panelPlugin.hideQueryEditor);\n        }\n      }\n    },\n  );\n\n  /**\n   * When the user tries to change the plugin kind, make sure we have the correct spec for that plugin kind before we\n   * make the switch.\n   */\n  const onSelectionChange: PluginKindSelectProps['onChange'] = (nextSelection) => {\n    // If we already have state for this plugin type/kind from a previous selection, just use it\n    const previousState = prevSpecState.current[nextSelection.type]?.[nextSelection.kind];\n    if (previousState !== undefined) {\n      currentRequest.current = undefined;\n      selectionLoad.reset();\n      rememberCurrentSpecState();\n      onChange({\n        selection: nextSelection,\n        spec: previousState,\n      });\n    } else {\n      // Otherwise, kick off the async loading process\n      // Per-call callbacks run only for the latest mutation while the editor is mounted.\n      currentRequest.current = nextSelection;\n      selectionLoad.mutate(nextSelection, { onSuccess: applyLoadedSelection });\n    }\n\n    if (\n      nextSelection.type === 'Panel' &&\n      hideQueryState.current[nextSelection.kind] !== undefined &&\n      hideQueryState.current[value.selection.kind] !== hideQueryState.current[nextSelection.kind]\n    ) {\n      onHideQuery(!!hideQueryState.current[nextSelection.kind]);\n    }\n  };\n\n  /**\n   * Spec changes are independent and always just set the spec state.\n   */\n  const onSpecChange: PluginSpecEditorProps['onChange'] = (next) => {\n    onChange(\n      produce(value, (draft) => {\n        draft.spec = next;\n      }),\n    );\n  };\n\n  return {\n    pendingSelection,\n    isLoading: selectionLoad.isLoading,\n    error: selectionLoad.error,\n    onSelectionChange,\n    onSpecChange,\n    rememberCurrentSpecState,\n  };\n}\n"],"names":["useMutation","useQueryClient","produce","useRef","useEffect","usePluginRegistry","useEvent","usePluginEditor","props","pluginTypes","value","onHideQueryEditorChange","onChange","onHideQuery","prevSpecState","selection","type","kind","spec","rememberCurrentSpecState","byPluginType","current","undefined","hideQueryState","defaultPluginKinds","getPlugin","queryClient","currentRequest","selectionLoad","mutationFn","fetchQuery","queryKey","metadata","version","registry","queryFn","name","pendingSelection","isSuccess","variables","defaultPluginType","defaultPluginKind","applyLoadedSelection","plugin","createInitialOptions","panelPlugin","hideQueryEditor","onSelectionChange","nextSelection","previousState","reset","mutate","onSuccess","onSpecChange","next","draft","isLoading","error"],"mappings":"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"}

package/dist/components/PluginKindSelect/PluginKindSelect.d.ts

@@ -6,6 +6,20 @@ export interface PluginKindSelectProps extends Omit<TextFieldProps, 'value' | 'o
     pluginTypes: PluginType[];
     value?: PluginEditorSelection;
     onChange?: (s: PluginEditorSelection) => void;
+    /**
+     * When true, a plugin that has more than one version available is listed with a `<display name> - Latest` option and
+     * once per version, labeled `<display name> - <version>`. Selecting a specific version sets `metadata.version` on the
+     * selection so it can be persisted on the definition, while selecting Latest leaves the version unpinned. A plugin
+     * with a single available version is listed without a version, so it keeps resolving to the latest one. Defaults to
+     * false.
+     */
+    enableVersionSelection?: boolean;
+    /**
+     * When true, a plugin that is available in more than one registry is listed once per registry, labeled
+     * `<display name> (<registry>)`. Selecting such an option sets `metadata.registry` on the selection. A plugin
+     * available in a single registry is listed without it. Defaults to false.
+     */
+    enableRegistrySelection?: boolean;
 }
 /**
  * Displays a MUI Select input for selecting a plugin's kind from a list of all the available plugins of some specific

package/dist/components/PluginKindSelect/PluginKindSelect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PluginKindSelect.d.ts","sourceRoot":"","sources":["../../../src/components/PluginKindSelect/PluginKindSelect.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAKpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAE7D,MAAM,WAAW,qBAAsB,SAAQ,IAAI,CAAC,cAAc,EAAE,OAAO,GAAG,UAAU,GAAG,UAAU,CAAC;IACpG,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,qBAAqB,CAAC;IAC9B,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,qBAAqB,KAAK,IAAI,CAAC;CAC/C;AAED;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,wHAyD3B,CAAC"}
+{"version":3,"file":"PluginKindSelect.d.ts","sourceRoot":"","sources":["../../../src/components/PluginKindSelect/PluginKindSelect.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAMpD,OAAO,KAAK,EAA4B,UAAU,EAAE,MAAM,aAAa,CAAC;AAGxE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAE7D,MAAM,WAAW,qBAAsB,SAAQ,IAAI,CAAC,cAAc,EAAE,OAAO,GAAG,UAAU,GAAG,UAAU,CAAC;IACpG,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,qBAAqB,CAAC;IAC9B,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAC9C;;;;;;OAMG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC;;;;OAIG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAsFD;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,wHAkH3B,CAAC"}

package/dist/components/PluginKindSelect/PluginKindSelect.js

@@ -14,6 +14,86 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { MenuItem, TextField } from "@mui/material";
 import { forwardRef, useCallback, useMemo } from "react";
 import { useListPluginMetadata } from "../../runtime/index.js";
+import { comparePluginVersions } from "../../utils/index.js";
+function getVariant(metadata) {
+    return {
+        version: metadata.metadata?.version ?? metadata.module?.version,
+        registry: metadata.metadata?.registry ?? metadata.module?.registry
+    };
+}
+function getVariantKey(variant) {
+    return `${variant.version ?? ''}:${variant.registry ?? ''}`;
+}
+/**
+ * Build the selectable entries of a plugin kind. A version (resp. registry) is only part of the entries when the caller
+ * enabled its selection *and* the plugin is actually installed in more than one version (resp. registry): there is
+ * nothing to pick otherwise, and leaving it out keeps the definition floating on the latest version.
+ */ function getGroupOptions(group, enableVersionSelection, enableRegistrySelection) {
+    const showVersion = enableVersionSelection && group.hasMultipleVersions;
+    const showRegistry = enableRegistrySelection && group.hasMultipleRegistries;
+    if (!showVersion && !showRegistry) {
+        const selection = {
+            type: group.type,
+            kind: group.kind
+        };
+        return [
+            {
+                selection,
+                label: group.displayName,
+                value: selectionToOptionValue(selection)
+            }
+        ];
+    }
+    const options = [];
+    const seen = new Set();
+    if (showVersion) {
+        const selection = {
+            type: group.type,
+            kind: group.kind
+        };
+        options.push({
+            selection,
+            label: `${group.displayName} - Latest`,
+            value: selectionToOptionValue(selection)
+        });
+        seen.add(getVariantKey({}));
+    }
+    for (const variant of group.variants){
+        const version = showVersion ? variant.version : undefined;
+        const registry = showRegistry ? variant.registry : undefined;
+        const metadata = {
+            ...version ? {
+                version
+            } : {},
+            ...registry ? {
+                registry
+            } : {}
+        };
+        // Variants that only differ on a field we don't display collapse into a single entry.
+        const key = getVariantKey({
+            version,
+            registry
+        });
+        if (seen.has(key)) {
+            continue;
+        }
+        seen.add(key);
+        const selection = {
+            type: group.type,
+            kind: group.kind,
+            ...version || registry ? {
+                metadata
+            } : {}
+        };
+        const label = `${group.displayName}${version ? ` - ${version}` : ''}${registry ? ` (${registry})` : ''}`;
+        options.push({
+            selection,
+            label,
+            value: selectionToOptionValue(selection)
+        });
+    }
+    return options;
+}
 /**
  * Displays a MUI Select input for selecting a plugin's kind from a list of all the available plugins of some specific
  * plugin types. (e.g. "Show a list of all the Panel plugins", or "Show a list of all the Variable plugins", or "Show
@@ -21,19 +101,78 @@ import { useListPluginMetadata } from "../../runtime/index.js";
  * The value of the select is the kind of the plugin, but you can also listen to the `onPluginTypeChange` event to know
  * when the user changes the plugin type (it fires at start for the default value.)
  */ export const PluginKindSelect = /*#__PURE__*/ forwardRef((props, ref)=>{
-    const { pluginTypes, value: propValue, onChange, filteredQueryPlugins, ...others } = props;
+    const { pluginTypes, value: propValue, onChange, filteredQueryPlugins, enableVersionSelection = false, enableRegistrySelection = false, ...others } = props;
     const { data, isLoading } = useListPluginMetadata(pluginTypes);
     const sortedData = useMemo(()=>{
-        if (filteredQueryPlugins?.length) {
-            return data?.filter((i)=>filteredQueryPlugins.includes(i.spec.name))?.toSorted((a, b)=>a.spec.display.name.localeCompare(b.spec.display.name));
-        }
-        return data?.toSorted((a, b)=>a.spec.display.name.localeCompare(b.spec.display.name));
+        const filtered = filteredQueryPlugins?.length ? data?.filter((i)=>filteredQueryPlugins.includes(i.spec.name)) : data;
+        return filtered?.toSorted((a, b)=>a.spec.display.name.localeCompare(b.spec.display.name));
     }, [
         data,
         filteredQueryPlugins
     ]);
+    // Group the metadata by plugin kind, collecting all the variants each one is installed under (newest version first).
+    const kindGroups = useMemo(()=>{
+        const groups = new Map();
+        for (const metadata of sortedData ?? []){
+            const key = `${metadata.kind}:${metadata.spec.name}`;
+            let group = groups.get(key);
+            if (group === undefined) {
+                group = {
+                    type: metadata.kind,
+                    kind: metadata.spec.name,
+                    displayName: metadata.spec.display.name,
+                    variants: [],
+                    hasMultipleVersions: false,
+                    hasMultipleRegistries: false
+                };
+                groups.set(key, group);
+            }
+            const variant = getVariant(metadata);
+            if (!group.variants.some((existing)=>getVariantKey(existing) === getVariantKey(variant))) {
+                group.variants.push(variant);
+            }
+        }
+        for (const group of groups.values()){
+            group.variants = group.variants.toSorted((a, b)=>comparePluginVersions(b.version ?? '', a.version ?? ''));
+            group.hasMultipleVersions = new Set(group.variants.map((v)=>v.version ?? '')).size > 1;
+            group.hasMultipleRegistries = new Set(group.variants.map((v)=>v.registry ?? '')).size > 1;
+        }
+        return [
+            ...groups.values()
+        ];
+    }, [
+        sortedData
+    ]);
+    const options = useMemo(()=>kindGroups.flatMap((group)=>getGroupOptions(group, enableVersionSelection, enableRegistrySelection)), [
+        kindGroups,
+        enableVersionSelection,
+        enableRegistrySelection
+    ]);
+    const labelsByValue = useMemo(()=>new Map(options.map((option)=>[
+                option.value,
+                option.label
+            ])), [
+        options
+    ]);
     // Pass an empty value while options are still loading so MUI doesn't complain about us using an "out of range" value
-    const value = !propValue || isLoading ? '' : selectionToOptionValue(propValue);
+    const value = useMemo(()=>{
+        if (!propValue || isLoading) {
+            return '';
+        }
+        const optionValue = selectionToOptionValue(propValue);
+        if (labelsByValue.has(optionValue)) {
+            return optionValue;
+        }
+        // The definition is not pinned (or is pinned to something we don't list): fall back to the first entry of that
+        // plugin kind, which is the one that will actually be used, so the Select has a matching value.
+        const fallback = options.find((option)=>option.selection.type === propValue.type && option.selection.kind === propValue.kind);
+        return fallback?.value ?? optionValue;
+    }, [
+        propValue,
+        isLoading,
+        labelsByValue,
+        options
+    ]);
     const handleChange = (event)=>{
         onChange?.(optionValueToSelection(event.target.value));
     };
@@ -41,10 +180,16 @@ import { useListPluginMetadata } from "../../runtime/index.js";
         if (selected === '') {
             return '';
         }
-        const selectedValue = optionValueToSelection(selected);
-        return sortedData?.find((v)=>v.kind === selectedValue.type && v.spec.name === selectedValue.kind)?.spec.display.name;
+        const optionValue = selected;
+        const label = labelsByValue.get(optionValue);
+        if (label !== undefined) {
+            return label;
+        }
+        const selectedValue = optionValueToSelection(optionValue);
+        return kindGroups.find((group)=>group.type === selectedValue.type && group.kind === selectedValue.kind)?.displayName;
     }, [
-        sortedData
+        labelsByValue,
+        kindGroups
     ]);
     // TODO: Does this need a loading indicator of some kind?
     return /*#__PURE__*/ _jsxs(TextField, {
@@ -63,14 +208,11 @@ import { useListPluginMetadata } from "../../runtime/index.js";
                 value: "",
                 children: "Loading..."
             }),
-            sortedData?.map((metadata)=>/*#__PURE__*/ _jsx(MenuItem, {
+            options.map((option)=>/*#__PURE__*/ _jsx(MenuItem, {
                     "data-testid": "option",
-                    value: selectionToOptionValue({
-                        type: metadata.kind,
-                        kind: metadata.spec.name
-                    }),
-                    children: metadata.spec.display.name
-                }, metadata.kind + metadata.spec.name))
+                    value: option.value,
+                    children: option.label
+                }, option.value))
         ]
     });
 });
@@ -78,29 +220,51 @@ PluginKindSelect.displayName = 'PluginKindSelect';
 // Delimiter used to stringify/parse option values
 const OPTION_VALUE_DELIMITER = '_____';
 /**
- * Given a PluginEditorSelection,
- * returns a string value like `{type}_____{kind}` that can be used as a Select input value.
+ * Given a PluginEditorSelection, returns a string value like `{type}_____{kind}` that can be used as a Select input
+ * value. A pinned version and/or registry is appended as `{type}_____{kind}_____{version}_____{registry}`, with empty
+ * segments for the parts that are not pinned.
  * @param selector
  */ function selectionToOptionValue(selector) {
-    return [
+    const { version, registry } = selector.metadata ?? {};
+    const parts = [
         selector.type,
         selector.kind
-    ].join(OPTION_VALUE_DELIMITER);
+    ];
+    if (version || registry) {
+        parts.push(version ?? '');
+    }
+    if (registry) {
+        parts.push(registry);
+    }
+    return parts.join(OPTION_VALUE_DELIMITER);
 }
 /**
- * Given an option value name like `{type}_____{kind}`,
- * returns a PluginEditorSelection to be used by the query data model.
+ * Given an option value name like `{type}_____{kind}` or `{type}_____{kind}_____{version}_____{registry}`, returns a
+ * PluginEditorSelection to be used by the query data model.
  * @param optionValue
  */ function optionValueToSelection(optionValue) {
     const words = optionValue.split(OPTION_VALUE_DELIMITER);
     const type = words[0];
     const kind = words[1];
+    const version = words[2];
+    const registry = words[3];
     if (type === undefined || kind === undefined) {
         throw new Error('Invalid optionValue string');
     }
+    const metadata = {
+        ...version ? {
+            version
+        } : {},
+        ...registry ? {
+            registry
+        } : {}
+    };
     return {
         type,
-        kind
+        kind,
+        ...version || registry ? {
+            metadata
+        } : {}
     };
 }