@genspectrum/dashboard-components 0.1.3 → 0.1.5

package/custom-elements.json

@@ -56,12 +56,44 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/web-components/app.ts",
+      "path": "src/web-components/app.stories.ts",
       "declarations": [
+        {
+          "kind": "variable",
+          "name": "meta",
+          "type": {
+            "text": "Meta"
+          },
+          "default": "{ title: 'Wrapper/App', component: 'gs-app', parameters: withComponentDocs({ fetchMock: {}, componentDocs: { tag: 'gs-app', opensShadowDom: false, expectsChildren: true, codeExample, }, }), decorators: [withActions], tags: ['autodocs'], }"
+        },
+        {
+          "kind": "variable",
+          "name": "Default",
+          "type": {
+            "text": "StoryObj<{ lapis: string }>"
+          },
+          "default": "{ ...Template, play: async ({ canvasElement }) => { const canvas = within(canvasElement); await waitFor(() => { expect(canvas.getByText(LAPIS_URL)).toBeVisible(); expect(canvas.getByText('\"name\": \"ORF1a\",', { exact: false })).toBeVisible(); }); }, }"
+        },
+        {
+          "kind": "variable",
+          "name": "DelayFetchingReferenceGenome",
+          "type": {
+            "text": "StoryObj<{ lapis: string }>"
+          },
+          "default": "{ ...Template, parameters: { fetchMock: { mocks: [ { matcher: { name: 'referenceGenome', url: REFERENCE_GENOME_ENDPOINT, }, response: { status: 200, body: referenceGenome, }, options: { delay: 5000, }, }, ], }, }, }"
+        },
+        {
+          "kind": "variable",
+          "name": "FailsToFetchReferenceGenome",
+          "type": {
+            "text": "StoryObj<{ lapis: string }>"
+          },
+          "default": "{ ...Template, args: { lapis: 'definitely-not-a-valid-url', }, play: async ({ canvasElement }) => { const canvas = within(canvasElement); await waitFor(() => { expect(canvas.getByText('Error')).toBeVisible(); }); }, }"
+        },
         {
           "kind": "class",
           "description": "",
-          "name": "App",
+          "name": "AppDisplay",
           "members": [
             {
               "kind": "field",
@@ -69,8 +101,7 @@
               "type": {
                 "text": "string"
               },
-              "default": "''",
-              "attribute": "lapis"
+              "default": "''"
             },
             {
               "kind": "field",
@@ -78,17 +109,78 @@
               "type": {
                 "text": "ReferenceGenome"
               },
-              "default": "{\n        nucleotideSequences: [],\n        genes: [],\n    }"
-            },
+              "default": "{ nucleotideSequences: [], genes: [], }"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "gs-app-display",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "meta",
+            "module": "src/web-components/app.stories.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "Default",
+          "declaration": {
+            "name": "Default",
+            "module": "src/web-components/app.stories.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "DelayFetchingReferenceGenome",
+          "declaration": {
+            "name": "DelayFetchingReferenceGenome",
+            "module": "src/web-components/app.stories.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "FailsToFetchReferenceGenome",
+          "declaration": {
+            "name": "FailsToFetchReferenceGenome",
+            "module": "src/web-components/app.stories.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "gs-app-display",
+          "declaration": {
+            "name": "AppDisplay",
+            "module": "src/web-components/app.stories.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/web-components/app.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "## Context\n\nThis component provides the main application context.\nAll other `gs-*` components must be (possibly nested) children of this component.\nIt makes use of the [Lit Context](https://lit.dev/docs/data/context/) to\n- provide the URL to the LAPIS instance to all its children\n- fetch the reference genomes from LAPIS and provide it to all its children\n\nThis will show an error message if the reference genome cannot be fetched\n(e.g., due to an invalid LAPIS URL).\n\n## Shadow DOM\n\nThis component does __not__ use a shadow DOM. Children of this component will be rendered directly in the light DOM.",
+          "name": "App",
+          "members": [
             {
               "kind": "field",
-              "name": "updateReferenceGenome",
-              "privacy": "private",
-              "default": "new Task(this, {\n        task: async () => {\n            this.referenceGenome = await fetchReferenceGenome(this.lapis);\n        },\n        args: () => [this.lapis],\n    })"
-            },
-            {
-              "kind": "method",
-              "name": "createRenderRoot"
+              "name": "lapis",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The URL of the LAPIS instance that all children of this component will use.",
+              "attribute": "lapis"
             }
           ],
           "attributes": [
@@ -98,6 +190,7 @@
                 "text": "string"
               },
               "default": "''",
+              "description": "The URL of the LAPIS instance that all children of this component will use.",
               "fieldName": "lapis"
             }
           ],
@@ -128,12 +221,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "src/web-components/display/aggregate-component.mdx",
-      "declarations": [],
-      "exports": []
-    },
     {
       "kind": "javascript-module",
       "path": "src/web-components/display/aggregate-component.stories.ts",
@@ -144,7 +231,7 @@
           "type": {
             "text": "Meta<AggregateProps>"
           },
-          "default": "{\n    title: 'Visualization/Aggregate',\n    component: 'gs-aggregate-component',\n    argTypes: {\n        fields: [{ control: 'object' }],\n        views: {\n            options: ['table'],\n            control: { type: 'check' },\n        },\n    },\n    parameters: {\n        fetchMock: {\n            mocks: [\n                {\n                    matcher: {\n                        name: 'aggregatedData',\n                        url: AGGREGATED_ENDPOINT,\n                        body: {\n                            fields: ['division', 'host'],\n                            country: 'USA',\n                        },\n                    },\n                    response: {\n                        status: 200,\n                        body: aggregatedData,\n                    },\n                },\n            ],\n        },\n    },\n}"
+          "default": "{ title: 'Visualization/Aggregate', component: 'gs-aggregate-component', argTypes: { fields: [{ control: 'object' }], views: { options: ['table'], control: { type: 'check' }, }, size: [{ control: 'object' }], headline: { control: 'text' }, }, parameters: withComponentDocs({ fetchMock: { mocks: [ { matcher: { name: 'aggregatedData', url: AGGREGATED_ENDPOINT, body: { fields: ['division', 'host'], country: 'USA', }, }, response: { status: 200, body: aggregatedData, }, }, ], }, componentDocs: { tag: 'gs-aggregate-component', opensShadowDom: true, expectsChildren: false, codeExample: `<gs-aggregate-component fields='[\"division\", \"host\"]' filter='{\"country\": \"USA\"}' views='[\"table\"]'></gs-aggregate-component>`, }, }), tags: ['autodocs'], }"
         },
         {
           "kind": "variable",
@@ -152,7 +239,7 @@
           "type": {
             "text": "StoryObj<AggregateProps>"
           },
-          "default": "{\n    render: (args) => html`\n        <div class=\"w-11/12 h-11/12\">\n            <gs-app lapis=\"${LAPIS_URL}\">\n                <gs-aggregate-component\n                    .fields=${args.fields}\n                    .filter=${args.filter}\n                    .views=${args.views}\n                ></gs-aggregate-component>\n            </gs-app>\n        </div>\n    `,\n    args: {\n        fields: ['division', 'host'],\n        views: ['table'],\n        filter: {\n            country: 'USA',\n        },\n    },\n}"
+          "default": "{ render: (args) => html` <gs-app lapis=\"${LAPIS_URL}\"> <gs-aggregate-component .fields=${args.fields} .filter=${args.filter} .views=${args.views} .size=${args.size} .headline=${args.headline} ></gs-aggregate-component> </gs-app> `, args: { fields: ['division', 'host'], views: ['table'], filter: { country: 'USA', }, size: { width: '100%', height: '700px' }, headline: 'Aggregate', }, }"
         }
       ],
       "exports": [
@@ -180,7 +267,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "## Tag\n\n`gs-aggregate-component`\n\n## Context\n\nThis component displays aggregated data, which can provide an overview of the underlying data.\n\nIt expects a list of fields to aggregate by and a filter to apply to the data.",
+          "description": "## Context\n\nThis component displays aggregated data, which can provide an overview of the underlying data.\n\nIt expects a list of fields to aggregate by and a filter to apply to the data.",
           "name": "AggregateComponent",
           "members": [
             {
@@ -212,6 +299,26 @@
               "default": "{}",
               "description": "The filter to apply to the data.",
               "attribute": "filter"
+            },
+            {
+              "kind": "field",
+              "name": "size",
+              "type": {
+                "text": "{ width?: string; height?: string } | undefined"
+              },
+              "default": "undefined",
+              "description": "The size of the component.\n\nIf not set, the component will take the full width of its container with height 700px.\n\nThe width and height should be a string with a unit in css style, e.g. '100%', '500px' or '50vh'.\nIf the unit is %, the size will be relative to the container of the component.",
+              "attribute": "size"
+            },
+            {
+              "kind": "field",
+              "name": "headline",
+              "type": {
+                "text": "string | undefined"
+              },
+              "default": "'Aggregate'",
+              "description": "The headline of the component. Set to an empty string to hide the headline.",
+              "attribute": "headline"
             }
           ],
           "attributes": [
@@ -241,6 +348,24 @@
               "default": "{}",
               "description": "The filter to apply to the data.",
               "fieldName": "filter"
+            },
+            {
+              "name": "size",
+              "type": {
+                "text": "{ width?: string; height?: string } | undefined"
+              },
+              "default": "undefined",
+              "description": "The size of the component.\n\nIf not set, the component will take the full width of its container with height 700px.\n\nThe width and height should be a string with a unit in css style, e.g. '100%', '500px' or '50vh'.\nIf the unit is %, the size will be relative to the container of the component.",
+              "fieldName": "size"
+            },
+            {
+              "name": "headline",
+              "type": {
+                "text": "string | undefined"
+              },
+              "default": "'Aggregate'",
+              "description": "The headline of the component. Set to an empty string to hide the headline.",
+              "fieldName": "headline"
             }
           ],
           "superclass": {
@@ -327,7 +452,7 @@
           "type": {
             "text": "Meta<MutationComparisonProps>"
           },
-          "default": "{\n    title: 'Visualization/Mutation comparison',\n    component: 'gs-mutation-comparison-component',\n    argTypes: {\n        variants: { control: 'object' },\n        sequenceType: {\n            options: ['nucleotide', 'amino acid'],\n            control: { type: 'radio' },\n        },\n        views: {\n            options: ['table', 'venn'],\n            control: { type: 'check' },\n        },\n    },\n}"
+          "default": "{ title: 'Visualization/Mutation comparison', component: 'gs-mutation-comparison-component', argTypes: { variants: { control: 'object' }, sequenceType: { options: ['nucleotide', 'amino acid'], control: { type: 'radio' }, }, views: { options: ['table', 'venn'], control: { type: 'check' }, }, size: { control: 'object' }, headline: { control: 'text' }, }, parameters: withComponentDocs({ componentDocs: { tag: 'gs-mutation-comparison-component', opensShadowDom: true, expectsChildren: false, codeExample, }, }), tags: ['autodocs'], }"
         },
         {
           "kind": "variable",
@@ -335,7 +460,7 @@
           "type": {
             "text": "StoryObj<MutationComparisonProps>"
           },
-          "default": "{\n    ...Template,\n    args: {\n        variants: [\n            {\n                displayName: 'Some variant',\n                lapisFilter: { country: 'Switzerland', pangoLineage: 'B.1.1.7', dateTo },\n            },\n            {\n                displayName: 'Other variant',\n                lapisFilter: {\n                    country: 'Switzerland',\n                    pangoLineage: 'B.1.1.7',\n                    dateFrom,\n                    dateTo,\n                },\n            },\n        ],\n        sequenceType: 'nucleotide',\n        views: ['table', 'venn'],\n    },\n    parameters: {\n        fetchMock: {\n            mocks: [\n                {\n                    matcher: {\n                        name: 'nucleotideMutationsSomeVariant',\n                        url: NUCLEOTIDE_MUTATIONS_ENDPOINT,\n                        body: {\n                            country: 'Switzerland',\n                            pangoLineage: 'B.1.1.7',\n                            dateTo,\n                            minProportion: 0,\n                        },\n                    },\n                    response: {\n                        status: 200,\n                        body: nucleotideMutationsSomeVariant,\n                    },\n                },\n                {\n                    matcher: {\n                        name: 'nucleotideMutationsOtherVariant',\n                        url: NUCLEOTIDE_MUTATIONS_ENDPOINT,\n                        body: {\n                            country: 'Switzerland',\n                            pangoLineage: 'B.1.1.7',\n                            dateFrom,\n                            dateTo,\n                            minProportion: 0,\n                        },\n                    },\n                    response: {\n                        status: 200,\n                        body: nucleotideMutationsOtherVariant,\n                    },\n                },\n            ],\n        },\n    },\n    play: async ({ canvasElement, step }) => {\n        const canvas = await withinShadowRoot(canvasElement, 'gs-mutation-comparison-component');\n\n        await step('Min and max proportions should be 50% and 100%', async () => {\n            const minInput = () => canvas.getAllByLabelText('%')[0];\n            const maxInput = () => canvas.getAllByLabelText('%')[1];\n\n            await waitFor(() => expect(minInput()).toHaveValue(50));\n            await waitFor(() => expect(maxInput()).toHaveValue(100));\n        });\n    },\n}"
+          "default": "{ ...Template, args: { variants: [ { displayName: 'Some variant', lapisFilter: { country: 'Switzerland', pangoLineage: 'B.1.1.7', dateTo }, }, { displayName: 'Other variant', lapisFilter: { country: 'Switzerland', pangoLineage: 'B.1.1.7', dateFrom, dateTo, }, }, ], sequenceType: 'nucleotide', views: ['table', 'venn'], size: { width: '100%', height: '700px' }, headline: 'Mutation comparison', }, parameters: { fetchMock: { mocks: [ { matcher: { name: 'nucleotideMutationsSomeVariant', url: NUCLEOTIDE_MUTATIONS_ENDPOINT, body: { country: 'Switzerland', pangoLineage: 'B.1.1.7', dateTo, minProportion: 0, }, }, response: { status: 200, body: nucleotideMutationsSomeVariant, }, }, { matcher: { name: 'nucleotideMutationsOtherVariant', url: NUCLEOTIDE_MUTATIONS_ENDPOINT, body: { country: 'Switzerland', pangoLineage: 'B.1.1.7', dateFrom, dateTo, minProportion: 0, }, }, response: { status: 200, body: nucleotideMutationsOtherVariant, }, }, ], }, }, play: async ({ canvasElement, step }) => { const canvas = await withinShadowRoot(canvasElement, 'gs-mutation-comparison-component'); await step('Min and max proportions should be 50% and 100%', async () => { const minInput = () => canvas.getAllByLabelText('%')[0]; const maxInput = () => canvas.getAllByLabelText('%')[1]; await waitFor(() => expect(minInput()).toHaveValue(50)); await waitFor(() => expect(maxInput()).toHaveValue(100)); }); }, }"
         },
         {
           "kind": "variable",
@@ -343,7 +468,7 @@
           "type": {
             "text": "StoryObj<MutationComparisonProps>"
           },
-          "default": "{\n    ...Default,\n    play: async ({ canvasElement, step }) => {\n        const canvas = await withinShadowRoot(canvasElement, 'gs-mutation-comparison-component');\n\n        await step('Switch to Venn diagram view', async () => {\n            await waitFor(() => expect(canvas.getByLabelText('Venn', { selector: 'input' })).toBeInTheDocument());\n\n            await fireEvent.click(canvas.getByLabelText('Venn', { selector: 'input' }));\n\n            await waitFor(() =>\n                expect(\n                    canvas.getByText('You have no elements selected. Click in the venn diagram to select.'),\n                ).toBeVisible(),\n            );\n        });\n    },\n}"
+          "default": "{ ...Default, play: async ({ canvasElement, step }) => { const canvas = await withinShadowRoot(canvasElement, 'gs-mutation-comparison-component'); await step('Switch to Venn diagram view', async () => { await waitFor(() => expect(canvas.getByRole('button', { name: 'Venn' })).toBeInTheDocument()); await fireEvent.click(canvas.getByRole('button', { name: 'Venn' })); await waitFor(() => expect( canvas.getByText('You have no elements selected. Click in the venn diagram to select.'), ).toBeVisible(), ); }); }, }"
         }
       ],
       "exports": [
@@ -379,61 +504,105 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "",
+          "description": "This component allows to compare mutations between different variants.\nA variant is defined by its LAPIS filter.\n\nIt only shows substitutions and deletions, it does not show insertions.\n\n## Views\n\n### Table View\n\nThe table view shows mutations\nand the proportions with which the mutation occurs in the respective variant.\nIt only shows mutations that are present in at least one of the variants\nand where the proportion is within the selected proportion interval for at least one variant.\n\n### Venn View\n\nThe Venn view shows the overlap of mutations between the variants in a Venn diagram.\nA variant is considered to have a certain mutation,\nif the proportion of the mutation in the variant is within the selected proportion interval.\nThus, changing the proportion interval may change a mutations from being \"common\" between variant\nto being \"for one variant only\".",
           "name": "MutationComparisonComponent",
           "members": [
             {
               "kind": "field",
               "name": "variants",
               "type": {
-                "text": "MutationComparisonVariant[]"
+                "text": "{\n        lapisFilter: Record<string, string | number | null | boolean>;\n        displayName: string;\n    }[]"
               },
               "default": "[]",
+              "description": "An array of variants to compare.\n\nThe `lapisFilter` will be sent as is to LAPIS to filter the mutation data.\nIt must be a valid LAPIS filter object.\n\nThe `displayName` will be used as the label for the variant in the views.\nIt should be human-readable.",
               "attribute": "variants"
             },
             {
               "kind": "field",
               "name": "sequenceType",
               "type": {
-                "text": "SequenceType"
+                "text": "'nucleotide' | 'amino acid'"
               },
               "default": "'nucleotide'",
+              "description": "The type of the sequence for which the mutations should be shown.",
               "attribute": "sequenceType"
             },
             {
               "kind": "field",
               "name": "views",
               "type": {
-                "text": "View[]"
+                "text": "('table' | 'venn')[]"
               },
               "default": "['table']",
+              "description": "A list of tabs with views that this component should provide.",
               "attribute": "views"
+            },
+            {
+              "kind": "field",
+              "name": "size",
+              "type": {
+                "text": "{ width?: string; height?: string } | undefined"
+              },
+              "default": "undefined",
+              "description": "The size of the component.\n\nIf not set, the component will take the full width of its container with height 700px.\n\nThe width and height should be a string with a unit in css style, e.g. '100%', '500px' or '50vh'.\nIf the unit is %, the size will be relative to the container of the component.",
+              "attribute": "size"
+            },
+            {
+              "kind": "field",
+              "name": "headline",
+              "type": {
+                "text": "string | undefined"
+              },
+              "default": "'Mutation comparison'",
+              "description": "The headline of the component. Set to an empty string to hide the headline.",
+              "attribute": "headline"
             }
           ],
           "attributes": [
             {
               "name": "variants",
               "type": {
-                "text": "MutationComparisonVariant[]"
+                "text": "{\n        lapisFilter: Record<string, string | number | null | boolean>;\n        displayName: string;\n    }[]"
               },
               "default": "[]",
+              "description": "An array of variants to compare.\n\nThe `lapisFilter` will be sent as is to LAPIS to filter the mutation data.\nIt must be a valid LAPIS filter object.\n\nThe `displayName` will be used as the label for the variant in the views.\nIt should be human-readable.",
               "fieldName": "variants"
             },
             {
               "name": "sequenceType",
               "type": {
-                "text": "SequenceType"
+                "text": "'nucleotide' | 'amino acid'"
               },
               "default": "'nucleotide'",
+              "description": "The type of the sequence for which the mutations should be shown.",
               "fieldName": "sequenceType"
             },
             {
               "name": "views",
               "type": {
-                "text": "View[]"
+                "text": "('table' | 'venn')[]"
               },
               "default": "['table']",
+              "description": "A list of tabs with views that this component should provide.",
               "fieldName": "views"
+            },
+            {
+              "name": "size",
+              "type": {
+                "text": "{ width?: string; height?: string } | undefined"
+              },
+              "default": "undefined",
+              "description": "The size of the component.\n\nIf not set, the component will take the full width of its container with height 700px.\n\nThe width and height should be a string with a unit in css style, e.g. '100%', '500px' or '50vh'.\nIf the unit is %, the size will be relative to the container of the component.",
+              "fieldName": "size"
+            },
+            {
+              "name": "headline",
+              "type": {
+                "text": "string | undefined"
+              },
+              "default": "'Mutation comparison'",
+              "description": "The headline of the component. Set to an empty string to hide the headline.",
+              "fieldName": "headline"
             }
           ],
           "superclass": {
@@ -473,7 +642,7 @@
           "type": {
             "text": "Meta<MutationsProps>"
           },
-          "default": "{\n    title: 'Visualization/Mutations',\n    component: 'gs-mutations',\n    argTypes: {\n        variant: { control: 'object' },\n        sequenceType: {\n            options: ['nucleotide', 'amino acid'],\n            control: { type: 'radio' },\n        },\n        views: {\n            options: ['table', 'grid', 'insertions'],\n            control: { type: 'check' },\n        },\n    },\n}"
+          "default": "{ title: 'Visualization/Mutations', component: 'gs-mutations-component', argTypes: { variant: { control: 'object' }, sequenceType: { options: ['nucleotide', 'amino acid'], control: { type: 'radio' }, }, views: { options: ['table', 'grid', 'insertions'], control: { type: 'check' }, }, size: { control: 'object' }, headline: { control: 'text' }, }, args: { variant: { country: 'Switzerland', pangoLineage: 'B.1.1.7', dateTo: '2022-01-01' }, sequenceType: 'nucleotide', views: ['grid', 'table', 'insertions'], size: { width: '100%', height: '700px' }, headline: 'Mutations', }, parameters: withComponentDocs({ componentDocs: { tag: 'gs-mutations-component', opensShadowDom: true, expectsChildren: false, codeExample, }, }), tags: ['autodocs'], }"
         },
         {
           "kind": "variable",
@@ -481,7 +650,7 @@
           "type": {
             "text": "StoryObj<MutationsProps>"
           },
-          "default": "{\n    ...Template,\n    args: {\n        variant: { country: 'Switzerland', pangoLineage: 'B.1.1.7', dateTo: '2022-01-01' },\n        sequenceType: 'nucleotide',\n        views: ['grid', 'table', 'insertions'],\n    },\n    parameters: {\n        fetchMock: {\n            mocks: [\n                {\n                    matcher: {\n                        name: 'nucleotideMutations',\n                        url: NUCLEOTIDE_MUTATIONS_ENDPOINT,\n                        body: {\n                            country: 'Switzerland',\n                            pangoLineage: 'B.1.1.7',\n                            dateTo: '2022-01-01',\n                            minProportion: 0,\n                        },\n                    },\n                    response: {\n                        status: 200,\n                        body: nucleotideMutations,\n                    },\n                },\n                {\n                    matcher: {\n                        name: 'nucleotideInsertions',\n                        url: NUCLEOTIDE_INSERTIONS_ENDPOINT,\n                        body: { country: 'Switzerland', pangoLineage: 'B.1.1.7', dateTo: '2022-01-01' },\n                    },\n                    response: {\n                        status: 200,\n                        body: nucleotideInsertions,\n                    },\n                },\n            ],\n        },\n    },\n}"
+          "default": "{ ...Template, parameters: { fetchMock: { mocks: [ { matcher: { name: 'nucleotideMutations', url: NUCLEOTIDE_MUTATIONS_ENDPOINT, body: { country: 'Switzerland', pangoLineage: 'B.1.1.7', dateTo: '2022-01-01', minProportion: 0, }, }, response: { status: 200, body: nucleotideMutations, }, }, { matcher: { name: 'nucleotideInsertions', url: NUCLEOTIDE_INSERTIONS_ENDPOINT, body: { country: 'Switzerland', pangoLineage: 'B.1.1.7', dateTo: '2022-01-01' }, }, response: { status: 200, body: nucleotideInsertions, }, }, ], }, }, }"
         },
         {
           "kind": "variable",
@@ -489,7 +658,7 @@
           "type": {
             "text": "StoryObj<MutationsProps>"
           },
-          "default": "{\n    ...Default,\n    play: async ({ canvasElement }) => {\n        const canvas = await withinShadowRoot(canvasElement, 'gs-mutations-component');\n\n        await waitFor(() => expect(canvas.getByLabelText('Table', { selector: 'input' })).toBeInTheDocument());\n\n        await fireEvent.click(canvas.getByLabelText('Table', { selector: 'input' }));\n    },\n}"
+          "default": "{ ...Default, play: async ({ canvasElement }) => { const canvas = await withinShadowRoot(canvasElement, 'gs-mutations-component'); await waitFor(() => expect(canvas.getByRole('button', { name: 'Table' })).toBeInTheDocument()); await fireEvent.click(canvas.getByRole('button', { name: 'Table' })); }, }"
         },
         {
           "kind": "variable",
@@ -497,7 +666,7 @@
           "type": {
             "text": "StoryObj<MutationsProps>"
           },
-          "default": "{\n    ...Default,\n    play: async ({ canvasElement }) => {\n        const canvas = await withinShadowRoot(canvasElement, 'gs-mutations-component');\n\n        await waitFor(() => expect(canvas.getByLabelText('Insertions', { selector: 'input' })).toBeInTheDocument());\n\n        await fireEvent.click(canvas.getByLabelText('Insertions', { selector: 'input' }));\n    },\n}"
+          "default": "{ ...Default, play: async ({ canvasElement }) => { const canvas = await withinShadowRoot(canvasElement, 'gs-mutations-component'); await waitFor(() => expect(canvas.getByRole('button', { name: 'Insertions' })).toBeInTheDocument()); await fireEvent.click(canvas.getByRole('button', { name: 'Insertions' })); }, }"
         }
       ],
       "exports": [
@@ -541,61 +710,105 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "",
+          "description": "This component displays mutations (substitutions, deletions and insertions) for a given variant.\n\n## Views\n\n### Table View\n\nThe table view shows all substitutions and deletions for the given variant.\nIt shows the type (substitution or deletion), the total count of the mutation\nand the proportion of the mutation in the variant.\nThe proportion is relative to the total number of sequences matching\nthe specified sequence filters with non-ambiguous reads at that position.\n\nThe proportion interval filter can be used to filter the displayed mutations on client side.\n\n### Grid View\n\nThe grid view shows the proportion of each sequence symbol (nucleotide or amino acid) for each position that has a mutation.\nOnly positions with at least one mutation in the selected proportion interval are shown.\n\n### Insertions View\n\nThe insertions view shows the count of all insertions for the given variant.",
           "name": "MutationsComponent",
           "members": [
             {
               "kind": "field",
               "name": "variant",
               "type": {
-                "text": "LapisFilter"
+                "text": "Record<string, string | number | null | boolean>"
               },
               "default": "{ displayName: '' }",
+              "description": "The `variant` will be sent as is to LAPIS to filter the mutation data.\nIt must be a valid LAPIS filter object.",
               "attribute": "variant"
             },
             {
               "kind": "field",
               "name": "sequenceType",
               "type": {
-                "text": "SequenceType"
+                "text": "'nucleotide' | 'amino acid'"
               },
               "default": "'nucleotide'",
+              "description": "The type of the sequence for which the mutations should be shown.",
               "attribute": "sequenceType"
             },
             {
               "kind": "field",
               "name": "views",
               "type": {
-                "text": "View[]"
+                "text": "('table' | 'grid' | 'insertions')[]"
               },
               "default": "['table', 'grid']",
+              "description": "A list of tabs with views that this component should provide.",
               "attribute": "views"
+            },
+            {
+              "kind": "field",
+              "name": "size",
+              "type": {
+                "text": "{ width?: string; height?: string } | undefined"
+              },
+              "default": "undefined",
+              "description": "The size of the component.\n\nIf not set, the component will take the full width of its container with height 700px.\n\nThe width and height should be a string with a unit in css style, e.g. '100%', '500px' or '50vh'.\nIf the unit is %, the size will be relative to the container of the component.",
+              "attribute": "size"
+            },
+            {
+              "kind": "field",
+              "name": "headline",
+              "type": {
+                "text": "string | undefined"
+              },
+              "default": "'Mutations'",
+              "description": "The headline of the component. Set to an empty string to hide the headline.",
+              "attribute": "headline"
             }
           ],
           "attributes": [
             {
               "name": "variant",
               "type": {
-                "text": "LapisFilter"
+                "text": "Record<string, string | number | null | boolean>"
               },
               "default": "{ displayName: '' }",
+              "description": "The `variant` will be sent as is to LAPIS to filter the mutation data.\nIt must be a valid LAPIS filter object.",
               "fieldName": "variant"
             },
             {
               "name": "sequenceType",
               "type": {
-                "text": "SequenceType"
+                "text": "'nucleotide' | 'amino acid'"
               },
               "default": "'nucleotide'",
+              "description": "The type of the sequence for which the mutations should be shown.",
               "fieldName": "sequenceType"
             },
             {
               "name": "views",
               "type": {
-                "text": "View[]"
+                "text": "('table' | 'grid' | 'insertions')[]"
               },
               "default": "['table', 'grid']",
+              "description": "A list of tabs with views that this component should provide.",
               "fieldName": "views"
+            },
+            {
+              "name": "size",
+              "type": {
+                "text": "{ width?: string; height?: string } | undefined"
+              },
+              "default": "undefined",
+              "description": "The size of the component.\n\nIf not set, the component will take the full width of its container with height 700px.\n\nThe width and height should be a string with a unit in css style, e.g. '100%', '500px' or '50vh'.\nIf the unit is %, the size will be relative to the container of the component.",
+              "fieldName": "size"
+            },
+            {
+              "name": "headline",
+              "type": {
+                "text": "string | undefined"
+              },
+              "default": "'Mutations'",
+              "description": "The headline of the component. Set to an empty string to hide the headline.",
+              "fieldName": "headline"
             }
           ],
           "superclass": {
@@ -635,7 +848,7 @@
           "type": {
             "text": "Meta<PrevalenceOverTimeProps>"
           },
-          "default": "{\n    title: 'Visualization/Prevalence over time',\n    component: 'gs-prevalence-over-time',\n    argTypes: {\n        numerator: { control: 'object' },\n        denominator: { control: 'object' },\n        granularity: {\n            options: ['day', 'week', 'month', 'year'],\n            control: { type: 'radio' },\n        },\n        smoothingWindow: { control: 'number' },\n        views: {\n            options: ['bar', 'line', 'bubble', 'table'],\n            control: { type: 'check' },\n        },\n        confidenceIntervalMethods: {\n            options: ['wilson'],\n            control: { type: 'check' },\n        },\n    },\n}"
+          "default": "{ title: 'Visualization/Prevalence over time', component: 'gs-prevalence-over-time', argTypes: { numerator: { control: 'object' }, denominator: { control: 'object' }, granularity: { options: ['day', 'week', 'month', 'year'], control: { type: 'radio' }, }, smoothingWindow: { control: 'number' }, views: { options: ['bar', 'line', 'bubble', 'table'], control: { type: 'check' }, }, confidenceIntervalMethods: { options: ['wilson'], control: { type: 'check' }, }, size: [{ control: 'object' }], headline: { control: 'text' }, }, parameters: withComponentDocs({ componentDocs: { tag: 'gs-prevalence-over-time', opensShadowDom: true, expectsChildren: false, codeExample, }, }), tags: ['autodocs'], }"
         },
         {
           "kind": "variable",
@@ -643,7 +856,7 @@
           "type": {
             "text": "StoryObj<PrevalenceOverTimeProps>"
           },
-          "default": "{\n    ...Template,\n    args: {\n        numerator: [\n            { displayName: 'EG', country: 'USA', pangoLineage: 'EG*', dateFrom: '2023-01-01' },\n            { displayName: 'JN.1', country: 'USA', pangoLineage: 'JN.1*', dateFrom: '2023-01-01' },\n        ],\n        denominator: { country: 'USA', dateFrom: '2023-01-01', displayName: 'All' },\n        granularity: 'month',\n        smoothingWindow: 0,\n        views: ['bar', 'line', 'bubble', 'table'],\n        confidenceIntervalMethods: ['wilson'],\n    },\n    parameters: {\n        fetchMock: {\n            mocks: [\n                {\n                    matcher: {\n                        name: 'numeratorEG',\n                        url: AGGREGATED_ENDPOINT,\n                        body: {\n                            country: 'USA',\n                            pangoLineage: 'EG*',\n                            dateFrom: '2023-01-01',\n                            fields: ['date'],\n                        },\n                    },\n                    response: {\n                        status: 200,\n                        body: numeratorEG,\n                    },\n                },\n                {\n                    matcher: {\n                        name: 'numeratorJN1',\n                        url: AGGREGATED_ENDPOINT,\n                        body: {\n                            country: 'USA',\n                            pangoLineage: 'JN.1*',\n                            dateFrom: '2023-01-01',\n                            fields: ['date'],\n                        },\n                    },\n                    response: {\n                        status: 200,\n                        body: numeratorJN1,\n                    },\n                },\n                {\n                    matcher: {\n                        name: 'denominator',\n                        url: AGGREGATED_ENDPOINT,\n                        body: {\n                            country: 'USA',\n                            dateFrom: '2023-01-01',\n                            fields: ['date'],\n                        },\n                    },\n                    response: {\n                        status: 200,\n                        body: denominator,\n                    },\n                },\n            ],\n        },\n    },\n}"
+          "default": "{ ...Template, args: { numerator: [ { displayName: 'EG', country: 'USA', pangoLineage: 'EG*', dateFrom: '2023-01-01' }, { displayName: 'JN.1', country: 'USA', pangoLineage: 'JN.1*', dateFrom: '2023-01-01' }, ], denominator: { country: 'USA', dateFrom: '2023-01-01', displayName: 'All' }, granularity: 'month', smoothingWindow: 0, views: ['bar', 'line', 'bubble', 'table'], confidenceIntervalMethods: ['wilson'], size: { width: '100%', height: '700px' }, headline: 'Prevalence over time', }, parameters: { fetchMock: { mocks: [ { matcher: { name: 'numeratorEG', url: AGGREGATED_ENDPOINT, body: { country: 'USA', pangoLineage: 'EG*', dateFrom: '2023-01-01', fields: ['date'], }, }, response: { status: 200, body: numeratorEG, }, }, { matcher: { name: 'numeratorJN1', url: AGGREGATED_ENDPOINT, body: { country: 'USA', pangoLineage: 'JN.1*', dateFrom: '2023-01-01', fields: ['date'], }, }, response: { status: 200, body: numeratorJN1, }, }, { matcher: { name: 'denominator', url: AGGREGATED_ENDPOINT, body: { country: 'USA', dateFrom: '2023-01-01', fields: ['date'], }, }, response: { status: 200, body: denominator, }, }, ], }, }, }"
         },
         {
           "kind": "variable",
@@ -651,7 +864,7 @@
           "type": {
             "text": "StoryObj<PrevalenceOverTimeProps>"
           },
-          "default": "{\n    ...Template,\n    args: {\n        numerator: { displayName: 'EG', country: 'USA', pangoLineage: 'BA.2.86*', dateFrom: '2023-10-01' },\n        denominator: { country: 'USA', dateFrom: '2023-10-01', displayName: 'All' },\n        granularity: 'day',\n        smoothingWindow: 7,\n        views: ['bar', 'line', 'bubble', 'table'],\n        confidenceIntervalMethods: ['wilson'],\n    },\n    parameters: {\n        fetchMock: {\n            mocks: [\n                {\n                    matcher: {\n                        name: 'numeratorOneVariant',\n                        url: AGGREGATED_ENDPOINT,\n                        body: {\n                            country: 'USA',\n                            pangoLineage: 'BA.2.86*',\n                            dateFrom: '2023-10-01',\n                            fields: ['date'],\n                        },\n                    },\n                    response: {\n                        status: 200,\n                        body: numeratorOneVariant,\n                    },\n                },\n                {\n                    matcher: {\n                        name: 'denominatorOneVariant',\n                        url: AGGREGATED_ENDPOINT,\n                        body: {\n                            country: 'USA',\n                            dateFrom: '2023-10-01',\n                            fields: ['date'],\n                        },\n                    },\n                    response: {\n                        status: 200,\n                        body: denominatorOneVariant,\n                    },\n                },\n            ],\n        },\n    },\n}"
+          "default": "{ ...Template, args: { numerator: { displayName: 'EG', country: 'USA', pangoLineage: 'BA.2.86*', dateFrom: '2023-10-01' }, denominator: { country: 'USA', dateFrom: '2023-10-01', displayName: 'All' }, granularity: 'day', smoothingWindow: 7, views: ['bar', 'line', 'bubble', 'table'], confidenceIntervalMethods: ['wilson'], size: { width: '100%', height: '700px' }, headline: 'Prevalence over time', }, parameters: { fetchMock: { mocks: [ { matcher: { name: 'numeratorOneVariant', url: AGGREGATED_ENDPOINT, body: { country: 'USA', pangoLineage: 'BA.2.86*', dateFrom: '2023-10-01', fields: ['date'], }, }, response: { status: 200, body: numeratorOneVariant, }, }, { matcher: { name: 'denominatorOneVariant', url: AGGREGATED_ENDPOINT, body: { country: 'USA', dateFrom: '2023-10-01', fields: ['date'], }, }, response: { status: 200, body: denominatorOneVariant, }, }, ], }, }, }"
         },
         {
           "kind": "variable",
@@ -659,7 +872,7 @@
           "type": {
             "text": "StoryObj<PrevalenceOverTimeProps>"
           },
-          "default": "{\n    ...OneVariant,\n    play: async ({ canvasElement }) => {\n        const canvas = await withinShadowRoot(canvasElement, 'gs-prevalence-over-time');\n\n        await waitFor(() => expect(canvas.getByLabelText('Line', { selector: 'input' })).toBeInTheDocument());\n\n        await fireEvent.click(canvas.getByLabelText('Line', { selector: 'input' }));\n    },\n}"
+          "default": "{ ...OneVariant, play: async ({ canvasElement }) => { const canvas = await withinShadowRoot(canvasElement, 'gs-prevalence-over-time'); await waitFor(() => expect(canvas.getByRole('button', { name: 'Line' })).toBeInTheDocument()); await fireEvent.click(canvas.getByRole('button', { name: 'Line' })); }, }"
         },
         {
           "kind": "variable",
@@ -667,7 +880,7 @@
           "type": {
             "text": "StoryObj<PrevalenceOverTimeProps>"
           },
-          "default": "{\n    ...OneVariant,\n    play: async ({ canvasElement }) => {\n        const canvas = await withinShadowRoot(canvasElement, 'gs-prevalence-over-time');\n\n        await waitFor(() => expect(canvas.getByLabelText('Bubble', { selector: 'input' })).toBeInTheDocument());\n\n        await fireEvent.click(canvas.getByLabelText('Bubble', { selector: 'input' }));\n    },\n}"
+          "default": "{ ...OneVariant, play: async ({ canvasElement }) => { const canvas = await withinShadowRoot(canvasElement, 'gs-prevalence-over-time'); await waitFor(() => expect(canvas.getByRole('button', { name: 'Bubble' })).toBeInTheDocument()); await fireEvent.click(canvas.getByRole('button', { name: 'Bubble' })); }, }"
         },
         {
           "kind": "variable",
@@ -675,7 +888,7 @@
           "type": {
             "text": "StoryObj<PrevalenceOverTimeProps>"
           },
-          "default": "{\n    ...OneVariant,\n    play: async ({ canvasElement }) => {\n        const canvas = await withinShadowRoot(canvasElement, 'gs-prevalence-over-time');\n\n        await waitFor(() => expect(canvas.getByLabelText('Table', { selector: 'input' })).toBeInTheDocument());\n\n        await fireEvent.click(canvas.getByLabelText('Table', { selector: 'input' }));\n    },\n}"
+          "default": "{ ...OneVariant, play: async ({ canvasElement }) => { const canvas = await withinShadowRoot(canvasElement, 'gs-prevalence-over-time'); await waitFor(() => expect(canvas.getByRole('button', { name: 'Table' })).toBeInTheDocument()); await fireEvent.click(canvas.getByRole('button', { name: 'Table' })); }, }"
         }
       ],
       "exports": [
@@ -735,34 +948,37 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "",
+          "description": "This component displays the prevalence over time of one or more variants.\nThe prevalence is calculated as the ratio of the number of cases of each variant given as `numerator`\nto the number of cases of the variant given as `denominator`.\n\nIn the chart views,\n- the user can select whether to display a confidence interval (not available in the bubble chart).\n  The confidence interval is calculated using [Wilson score interval](https://en.wikipedia.org/wiki/Binomial_proportion_confidence_interval),\n  with a confidence level of 95%.\n- the x-axis shows time steps in the selected `granularity`.\n- the user can select the y-axis scale (linear, logistic, logit).\n\n## Views\n\n### Bar View\n\nDisplays the prevalence over time as a bar chart.\nShows a bar for each variant in the `numerator` on every time step.\n\n### Line View\n\nDisplays the prevalence over time as a line chart.\nEach data point is connected for better visibility.\nShows a line for each variant in the `numerator`.\n\n### Bubble View\n\nDisplays the prevalence over time as a bubble chart.\nThe size of the bubbles represents the number of cases of the `denominator` variant.\nThe height of the bubbles represents the prevalence of the `numerator` variants.\n\n### Table View\n\nDisplays the prevalence over time as a table with one row per time point.",
           "name": "PrevalenceOverTimeComponent",
           "members": [
             {
               "kind": "field",
               "name": "numerator",
               "type": {
-                "text": "NamedLapisFilter | NamedLapisFilter[]"
+                "text": "| (Record<string, string | number | null | boolean> & { displayName: string })\n        | (Record<string, string | number | null | boolean> & {\n              displayName: string;\n          })[]"
               },
               "default": "{ displayName: '' }",
+              "description": "Either a single variant or an array of variants to compare.\nThis must be a valid LAPIS filter object with an additional `displayName` property\nwhich will be used as the label for the variant in the views,\nor an array of such objects.",
               "attribute": "numerator"
             },
             {
               "kind": "field",
               "name": "denominator",
               "type": {
-                "text": "NamedLapisFilter"
+                "text": "Record<string, string | number | null | boolean> & { displayName: string }"
               },
               "default": "{ displayName: '' }",
+              "description": "The variant that the variants in `numerator` are compared to.",
               "attribute": "denominator"
             },
             {
               "kind": "field",
               "name": "granularity",
               "type": {
-                "text": "TemporalGranularity"
+                "text": "'day' | 'week' | 'month' | 'year'"
               },
               "default": "'day'",
+              "description": "The granularity of the time axis.",
               "attribute": "granularity"
             },
             {
@@ -772,50 +988,76 @@
                 "text": "number"
               },
               "default": "0",
+              "description": "The number of time steps to use for smoothing the data.\n`0` means no smoothing.\nMust be a non-negative integer.\n\nFor a given time, the shown value is the mean of the neighbouring measured values.\nThe `smoothingWindow` value provides the number of neighbouring values to take into account.\nThe resulting time is computed via `Math.floor(smoothingWindow / 2)`.",
               "attribute": "smoothingWindow"
             },
             {
               "kind": "field",
               "name": "views",
               "type": {
-                "text": "View[]"
+                "text": "('bar' | 'line' | 'bubble' | 'table')[]"
               },
               "default": "['bar', 'line', 'bubble', 'table']",
+              "description": "A list of tabs with views that this component should provide.",
               "attribute": "views"
             },
             {
               "kind": "field",
               "name": "confidenceIntervalMethods",
               "type": {
-                "text": "ConfidenceIntervalMethod[]"
+                "text": "('wilson' | 'none')[]"
               },
               "default": "['wilson']",
+              "description": "A list of methods to calculate the confidence interval.\nThe option `none` is always available and disables confidence intervals.\nPass an empty array to disable the confidence interval selector.",
               "attribute": "confidenceIntervalMethods"
+            },
+            {
+              "kind": "field",
+              "name": "headline",
+              "type": {
+                "text": "string | undefined"
+              },
+              "default": "'Prevalence over time'",
+              "description": "The headline of the component. Set to an empty string to hide the headline.",
+              "attribute": "headline"
+            },
+            {
+              "kind": "field",
+              "name": "size",
+              "type": {
+                "text": "{ width?: string; height?: string } | undefined"
+              },
+              "default": "undefined",
+              "description": "The size of the component.\n\nIf not set, the component will take the full width of its container with height 700px.\n\nThe width and height should be a string with a unit in css style, e.g. '100%', '500px' or '50vh'.\nIf the unit is %, the size will be relative to the container of the component.",
+              "attribute": "size"
             }
           ],
           "attributes": [
             {
               "name": "numerator",
               "type": {
-                "text": "NamedLapisFilter | NamedLapisFilter[]"
+                "text": "| (Record<string, string | number | null | boolean> & { displayName: string })\n        | (Record<string, string | number | null | boolean> & {\n              displayName: string;\n          })[]"
               },
               "default": "{ displayName: '' }",
+              "description": "Either a single variant or an array of variants to compare.\nThis must be a valid LAPIS filter object with an additional `displayName` property\nwhich will be used as the label for the variant in the views,\nor an array of such objects.",
               "fieldName": "numerator"
             },
             {
               "name": "denominator",
               "type": {
-                "text": "NamedLapisFilter"
+                "text": "Record<string, string | number | null | boolean> & { displayName: string }"
               },
               "default": "{ displayName: '' }",
+              "description": "The variant that the variants in `numerator` are compared to.",
               "fieldName": "denominator"
             },
             {
               "name": "granularity",
               "type": {
-                "text": "TemporalGranularity"
+                "text": "'day' | 'week' | 'month' | 'year'"
               },
               "default": "'day'",
+              "description": "The granularity of the time axis.",
               "fieldName": "granularity"
             },
             {
@@ -824,23 +1066,44 @@
                 "text": "number"
               },
               "default": "0",
+              "description": "The number of time steps to use for smoothing the data.\n`0` means no smoothing.\nMust be a non-negative integer.\n\nFor a given time, the shown value is the mean of the neighbouring measured values.\nThe `smoothingWindow` value provides the number of neighbouring values to take into account.\nThe resulting time is computed via `Math.floor(smoothingWindow / 2)`.",
               "fieldName": "smoothingWindow"
             },
             {
               "name": "views",
               "type": {
-                "text": "View[]"
+                "text": "('bar' | 'line' | 'bubble' | 'table')[]"
               },
               "default": "['bar', 'line', 'bubble', 'table']",
+              "description": "A list of tabs with views that this component should provide.",
               "fieldName": "views"
             },
             {
               "name": "confidenceIntervalMethods",
               "type": {
-                "text": "ConfidenceIntervalMethod[]"
+                "text": "('wilson' | 'none')[]"
               },
               "default": "['wilson']",
+              "description": "A list of methods to calculate the confidence interval.\nThe option `none` is always available and disables confidence intervals.\nPass an empty array to disable the confidence interval selector.",
               "fieldName": "confidenceIntervalMethods"
+            },
+            {
+              "name": "headline",
+              "type": {
+                "text": "string | undefined"
+              },
+              "default": "'Prevalence over time'",
+              "description": "The headline of the component. Set to an empty string to hide the headline.",
+              "fieldName": "headline"
+            },
+            {
+              "name": "size",
+              "type": {
+                "text": "{ width?: string; height?: string } | undefined"
+              },
+              "default": "undefined",
+              "description": "The size of the component.\n\nIf not set, the component will take the full width of its container with height 700px.\n\nThe width and height should be a string with a unit in css style, e.g. '100%', '500px' or '50vh'.\nIf the unit is %, the size will be relative to the container of the component.",
+              "fieldName": "size"
             }
           ],
           "superclass": {
@@ -880,7 +1143,7 @@
           "type": {
             "text": "Meta<RelativeGrowthAdvantageProps>"
           },
-          "default": "{\n    title: 'Visualization/Relative growth advantage',\n    component: 'gs-relative-growth-advantage',\n    argTypes: {\n        numerator: { control: 'object' },\n        denominator: { control: 'object' },\n        generationTime: { control: 'number' },\n        views: {\n            options: ['line'],\n            control: { type: 'check' },\n        },\n    },\n}"
+          "default": "{ title: 'Visualization/Relative growth advantage', component: 'gs-relative-growth-advantage', argTypes: { numerator: { control: 'object' }, denominator: { control: 'object' }, generationTime: { control: 'number' }, views: { options: ['line'], control: { type: 'check' }, }, size: [{ control: 'object' }], headline: { control: 'text' }, }, parameters: withComponentDocs({ componentDocs: { tag: 'gs-relative-growth-advantage', opensShadowDom: true, expectsChildren: false, codeExample, }, }), tags: ['autodocs'], }"
         },
         {
           "kind": "variable",
@@ -888,7 +1151,7 @@
           "type": {
             "text": "StoryObj<RelativeGrowthAdvantageProps>"
           },
-          "default": "{\n    ...Template,\n    args: {\n        numerator: { country: 'Switzerland', pangoLineage: 'B.1.1.7', dateFrom: '2020-12-01', dateTo: '2021-03-01' },\n        denominator: { country: 'Switzerland', dateFrom: '2020-12-01', dateTo: '2021-03-01' },\n        generationTime: 7,\n        views: ['line'],\n    },\n    parameters: {\n        fetchMock: {\n            mocks: [\n                {\n                    matcher: {\n                        name: 'numerator',\n                        url: AGGREGATED_ENDPOINT,\n                        body: {\n                            country: 'Switzerland',\n                            pangoLineage: 'B.1.1.7',\n                            dateFrom: '2020-12-01',\n                            dateTo: '2021-03-01',\n                            fields: ['date'],\n                        },\n                    },\n                    response: {\n                        status: 200,\n                        body: numerator,\n                    },\n                },\n                {\n                    matcher: {\n                        name: 'denominator',\n                        url: AGGREGATED_ENDPOINT,\n                        body: {\n                            country: 'Switzerland',\n                            dateFrom: '2020-12-01',\n                            dateTo: '2021-03-01',\n                            fields: ['date'],\n                        },\n                    },\n                    response: {\n                        status: 200,\n                        body: denominator,\n                    },\n                },\n            ],\n        },\n    },\n}"
+          "default": "{ ...Template, args: { numerator: { country: 'Switzerland', pangoLineage: 'B.1.1.7', dateFrom: '2020-12-01', dateTo: '2021-03-01' }, denominator: { country: 'Switzerland', dateFrom: '2020-12-01', dateTo: '2021-03-01' }, generationTime: 7, views: ['line'], size: { width: '100%', height: '700px' }, headline: 'Relative growth advantage', }, parameters: { fetchMock: { mocks: [ { matcher: { name: 'numerator', url: AGGREGATED_ENDPOINT, body: { country: 'Switzerland', pangoLineage: 'B.1.1.7', dateFrom: '2020-12-01', dateTo: '2021-03-01', fields: ['date'], }, }, response: { status: 200, body: numerator, }, }, { matcher: { name: 'denominator', url: AGGREGATED_ENDPOINT, body: { country: 'Switzerland', dateFrom: '2020-12-01', dateTo: '2021-03-01', fields: ['date'], }, }, response: { status: 200, body: denominator, }, }, ], }, }, }"
         }
       ],
       "exports": [
@@ -916,25 +1179,27 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "",
+          "description": "We assume a discrete time model, where new infections happen exactly every `generationTime` days.\nThis is what we call a \"generation\".\n\nThis component estimates the relative growth advantage of a variant by performing a logistic regression.\nBased on the inferred logistic growth rate, we derive the relative growth advantage (per generation).\n\nFor details on the scientific method, see:\nChen, Chaoran, et al. \"Quantification of the spread of SARS-CoV-2 variant B.1.1.7 in Switzerland.\" Epidemics (2021);\ndoi: [10.1016/j.epidem.2021.100480](https://doi.org/10.1016/j.epidem.2021.100480)\n\nThis component fetches aggregated data from LAPIS.\nThen the data is sent to `https://cov-spectrum.org/api/v2/computed/model/chen2021Fitness`\nwhich performs the logistic regression and calculates the relative growth advantage.\n\n## Views\n\n### Line View\n\nThe line view shows the relative growth advantage over time in a line chart.\nThe dots in the plot show the proportions of the focal variant (`numerator`) to the `denominator` variant\nfor every day as observed in the data.\nThe line shows a logistic curve fitted to the data points, including a 95% confidence interval.",
           "name": "RelativeGrowthAdvantageComponent",
           "members": [
             {
               "kind": "field",
               "name": "numerator",
               "type": {
-                "text": "LapisFilter"
+                "text": "Record<string, string | number | null | boolean>"
               },
               "default": "{}",
+              "description": "The LAPIS filter for the focal variant.",
               "attribute": "numerator"
             },
             {
               "kind": "field",
               "name": "denominator",
               "type": {
-                "text": "LapisFilter"
+                "text": "Record<string, string | number | null | boolean>"
               },
               "default": "{}",
+              "description": "The LAPIS filter for the variant that the focal variant (`numerator`) should be compared to.",
               "attribute": "denominator"
             },
             {
@@ -944,33 +1209,57 @@
                 "text": "number"
               },
               "default": "7",
+              "description": "The generation time represents the number of days over which the variant's relative growth advantage is measured.\nFor example, if we set a generation time of 7 days, then we estimate the growth advantage per week.",
               "attribute": "generationTime"
             },
             {
               "kind": "field",
               "name": "views",
               "type": {
-                "text": "View[]"
+                "text": "'line'[]"
               },
               "default": "['line']",
+              "description": "A list of tabs with views that this component should provide.",
               "attribute": "views"
+            },
+            {
+              "kind": "field",
+              "name": "headline",
+              "type": {
+                "text": "string | undefined"
+              },
+              "default": "'Relative growth advantage'",
+              "description": "The headline of the component. Set to an empty string to hide the headline.",
+              "attribute": "headline"
+            },
+            {
+              "kind": "field",
+              "name": "size",
+              "type": {
+                "text": "{ width?: string; height?: string } | undefined"
+              },
+              "default": "undefined",
+              "description": "The size of the component.\n\nIf not set, the component will take the full width of its container with height 700px.\n\nThe width and height should be a string with a unit in css style, e.g. '100%', '500px' or '50vh'.\nIf the unit is %, the size will be relative to the container of the component.",
+              "attribute": "size"
             }
           ],
           "attributes": [
             {
               "name": "numerator",
               "type": {
-                "text": "LapisFilter"
+                "text": "Record<string, string | number | null | boolean>"
               },
               "default": "{}",
+              "description": "The LAPIS filter for the focal variant.",
               "fieldName": "numerator"
             },
             {
               "name": "denominator",
               "type": {
-                "text": "LapisFilter"
+                "text": "Record<string, string | number | null | boolean>"
               },
               "default": "{}",
+              "description": "The LAPIS filter for the variant that the focal variant (`numerator`) should be compared to.",
               "fieldName": "denominator"
             },
             {
@@ -979,15 +1268,35 @@
                 "text": "number"
               },
               "default": "7",
+              "description": "The generation time represents the number of days over which the variant's relative growth advantage is measured.\nFor example, if we set a generation time of 7 days, then we estimate the growth advantage per week.",
               "fieldName": "generationTime"
             },
             {
               "name": "views",
               "type": {
-                "text": "View[]"
+                "text": "'line'[]"
               },
               "default": "['line']",
+              "description": "A list of tabs with views that this component should provide.",
               "fieldName": "views"
+            },
+            {
+              "name": "headline",
+              "type": {
+                "text": "string | undefined"
+              },
+              "default": "'Relative growth advantage'",
+              "description": "The headline of the component. Set to an empty string to hide the headline.",
+              "fieldName": "headline"
+            },
+            {
+              "name": "size",
+              "type": {
+                "text": "{ width?: string; height?: string } | undefined"
+              },
+              "default": "undefined",
+              "description": "The size of the component.\n\nIf not set, the component will take the full width of its container with height 700px.\n\nThe width and height should be a string with a unit in css style, e.g. '100%', '500px' or '50vh'.\nIf the unit is %, the size will be relative to the container of the component.",
+              "fieldName": "size"
             }
           ],
           "superclass": {
@@ -1056,17 +1365,17 @@
           "kind": "variable",
           "name": "meta",
           "type": {
-            "text": "Meta<DateRangeSelectorProps>"
+            "text": "Meta<DateRangeSelectorProps<'CustomDateRange'>>"
           },
-          "default": "{\n    title: 'Input/DateRangeSelector',\n    component: 'gs-date-range-selector',\n    parameters: {\n        actions: {\n            handles: ['gs-date-range-changed'],\n        },\n        fetchMock: {},\n    },\n    decorators: [withActions],\n}"
+          "default": "{ title: 'Input/DateRangeSelector', component: 'gs-date-range-selector', parameters: withComponentDocs({ actions: { handles: ['gs-date-range-changed'], }, fetchMock: {}, componentDocs: { tag: 'gs-date-range-selector', opensShadowDom: true, expectsChildren: false, codeExample, }, }), argTypes: { initialValue: { control: { type: 'select', }, options: [ PRESET_VALUE_CUSTOM, PRESET_VALUE_ALL_TIMES, PRESET_VALUE_LAST_2_WEEKS, PRESET_VALUE_LAST_MONTH, PRESET_VALUE_LAST_2_MONTHS, PRESET_VALUE_LAST_3_MONTHS, PRESET_VALUE_LAST_6_MONTHS, 'CustomDateRange', ], }, }, args: { customSelectOptions: [{ label: 'CustomDateRange', dateFrom: '2021-01-01', dateTo: '2021-12-31' }], earliestDate: '1970-01-01', initialValue: PRESET_VALUE_LAST_6_MONTHS, }, decorators: [withActions], tags: ['autodocs'], }"
         },
         {
           "kind": "variable",
           "name": "DateRangeSelectorStory",
           "type": {
-            "text": "StoryObj<DateRangeSelectorProps>"
+            "text": "StoryObj<DateRangeSelectorProps<'CustomDateRange'>>"
           },
-          "default": "{\n    render: (args) =>\n        html` <gs-app lapis=\"${LAPIS_URL}\">\n            <div class=\"max-w-screen-lg\">\n                <gs-date-range-selector\n                    .customSelectOptions=${args.customSelectOptions}\n                    .earliestDate=${args.earliestDate}\n                ></gs-date-range-selector>\n            </div>\n        </gs-app>`,\n\n    play: async ({ canvasElement, step }) => {\n        const canvas = await withinShadowRoot(canvasElement, 'gs-date-range-selector');\n        const dateTo = () => canvas.getByPlaceholderText('Date to');\n\n        await step('Expect last 6 months to be selected', async () => {\n            await expect(canvas.getByRole('combobox')).toHaveValue('last6Months');\n            await waitFor(() => {\n                expect(dateTo()).toHaveValue(toYYYYMMDD(new Date()));\n            });\n        });\n    },\n    args: {\n        customSelectOptions: [{ label: 'CustomDateRange', dateFrom: '2021-01-01', dateTo: '2021-12-31' }],\n        earliestDate: '1970-01-01',\n    },\n}"
+          "default": "{ render: (args) => html` <gs-app lapis=\"${LAPIS_URL}\"> <div class=\"max-w-screen-lg\"> <gs-date-range-selector .customSelectOptions=${args.customSelectOptions} .earliestDate=${args.earliestDate} .initialValue=${args.initialValue} ></gs-date-range-selector> </div> </gs-app>`, play: async ({ canvasElement, step }) => { const canvas = await withinShadowRoot(canvasElement, 'gs-date-range-selector'); const dateTo = () => canvas.getByPlaceholderText('Date to'); await step('Expect last 6 months to be selected', async () => { await expect(canvas.getByRole('combobox')).toHaveValue('last6Months'); await waitFor(() => { expect(dateTo()).toHaveValue(toYYYYMMDD(new Date())); }); }); }, }"
         }
       ],
       "exports": [
@@ -1094,16 +1403,17 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "",
+          "description": "## Context\nThis component is a group of input fields designed to specify a date range. It consists of 3 fields:\n\n- a select field to choose a predefined date range,\n- an input field with an attached date picker for the start date,\n- an input field with an attached date picker for the end date.\n\nSetting a value in the select field will overwrite the previous values of the start and end date.\nSetting a value in either of the date pickers will set the select field to \"custom\",\nwhich represents an arbitrary date range.",
           "name": "DateRangeSelectorComponent",
           "members": [
             {
               "kind": "field",
               "name": "customSelectOptions",
               "type": {
-                "text": "CustomSelectOption[]"
+                "text": "{ label: string; dateFrom: string; dateTo: string }[]"
               },
               "default": "[]",
+              "description": "An array of custom options that the select field should provide,\nin addition to the predefined options.\nThe `label` will be shown to the user, and it will be available as `initialValue`.\nThe dates must be in the format `YYYY-MM-DD`.",
               "attribute": "customSelectOptions"
             },
             {
@@ -1113,7 +1423,18 @@
                 "text": "string | undefined"
               },
               "default": "'1900-01-01'",
+              "description": "The `dateFrom` value to use in the `allTimes` preset in the format `YYYY-MM-DD`.",
               "attribute": "earliestDate"
+            },
+            {
+              "kind": "field",
+              "name": "initialValue",
+              "type": {
+                "text": "'custom'\n        | 'allTimes'\n        | 'last2Weeks'\n        | 'lastMonth'\n        | 'last2Months'\n        | 'last3Months'\n        | 'last6Months'\n        | string\n        | undefined"
+              },
+              "default": "'last6Months'",
+              "description": "The initial value to use for this date range selector.\nMust be a valid label from the preset labels or a `label` given in the `customSelectOptions`.\n\nIf the value is invalid, the component will default to `'last6Months'`.",
+              "attribute": "initialValue"
             }
           ],
           "events": [
@@ -1121,7 +1442,7 @@
               "type": {
                 "text": "CustomEvent<{ dateFrom: string; dateTo: string; }>"
               },
-              "description": "When the date range has changed",
+              "description": "Fired when: - The select field is changed, - A date is selected in either of the date pickers, - A date was typed into either of the date input fields, and the input field loses focus (\"on blur\"). Contains the dates in the format `YYYY-MM-DD`.",
               "name": "gs-date-range-changed"
             }
           ],
@@ -1129,9 +1450,10 @@
             {
               "name": "customSelectOptions",
               "type": {
-                "text": "CustomSelectOption[]"
+                "text": "{ label: string; dateFrom: string; dateTo: string }[]"
               },
               "default": "[]",
+              "description": "An array of custom options that the select field should provide,\nin addition to the predefined options.\nThe `label` will be shown to the user, and it will be available as `initialValue`.\nThe dates must be in the format `YYYY-MM-DD`.",
               "fieldName": "customSelectOptions"
             },
             {
@@ -1140,7 +1462,17 @@
                 "text": "string | undefined"
               },
               "default": "'1900-01-01'",
+              "description": "The `dateFrom` value to use in the `allTimes` preset in the format `YYYY-MM-DD`.",
               "fieldName": "earliestDate"
+            },
+            {
+              "name": "initialValue",
+              "type": {
+                "text": "'custom'\n        | 'allTimes'\n        | 'last2Weeks'\n        | 'lastMonth'\n        | 'last2Months'\n        | 'last3Months'\n        | 'last6Months'\n        | string\n        | undefined"
+              },
+              "default": "'last6Months'",
+              "description": "The initial value to use for this date range selector.\nMust be a valid label from the preset labels or a `label` given in the `customSelectOptions`.\n\nIf the value is invalid, the component will default to `'last6Months'`.",
+              "fieldName": "initialValue"
             }
           ],
           "superclass": {
@@ -1219,7 +1551,7 @@
           "type": {
             "text": "Meta"
           },
-          "default": "{\n    title: 'Input/Location filter',\n    component: 'gs-location-filter',\n    parameters: {\n        actions: {\n            handles: ['gs-location-changed'],\n        },\n    },\n    decorators: [withActions],\n}"
+          "default": "{ title: 'Input/Location filter', component: 'gs-location-filter', parameters: withComponentDocs({ actions: { handles: ['gs-location-changed'], }, componentDocs: { tag: 'gs-location-filter', opensShadowDom: true, expectsChildren: false, codeExample: `<gs-location-filter fields=\"['continent', 'country']\" value='Europe / Switzerland'></gs-location-filter>`, }, }), decorators: [withActions], tags: ['autodocs'], }"
         },
         {
           "kind": "variable",
@@ -1227,7 +1559,7 @@
           "type": {
             "text": "StoryObj<LocationFilterProps>"
           },
-          "default": "{\n    ...Template,\n    parameters: {\n        fetchMock: {\n            mocks: [\n                {\n                    matcher: aggregatedEndpointMatcher,\n                    response: {\n                        status: 200,\n                        body: data,\n                    },\n                },\n            ],\n        },\n    },\n    play: async ({ canvasElement }) => {\n        const canvas = await withinShadowRoot(canvasElement, 'gs-location-filter');\n        await waitFor(() => {\n            return expect(canvas.getByRole('combobox')).toBeEnabled();\n        });\n    },\n}"
+          "default": "{ ...Template, parameters: { fetchMock: { mocks: [ { matcher: aggregatedEndpointMatcher, response: { status: 200, body: data, }, }, ], }, }, play: async ({ canvasElement }) => { const canvas = await withinShadowRoot(canvasElement, 'gs-location-filter'); await waitFor(() => { return expect(canvas.getByRole('combobox')).toBeEnabled(); }); }, }"
         },
         {
           "kind": "variable",
@@ -1235,7 +1567,7 @@
           "type": {
             "text": "StoryObj<LocationFilterProps>"
           },
-          "default": "{\n    ...Template,\n    parameters: {\n        fetchMock: {\n            mocks: [\n                {\n                    matcher: aggregatedEndpointMatcher,\n                    response: {\n                        status: 200,\n                        body: data,\n                    },\n                    options: {\n                        delay: 5000,\n                    },\n                },\n            ],\n        },\n    },\n}"
+          "default": "{ ...Template, parameters: { fetchMock: { mocks: [ { matcher: aggregatedEndpointMatcher, response: { status: 200, body: data, }, options: { delay: 5000, }, }, ], }, }, }"
         },
         {
           "kind": "variable",
@@ -1243,7 +1575,7 @@
           "type": {
             "text": "StoryObj<LocationFilterProps>"
           },
-          "default": "{\n    ...Template,\n    parameters: {\n        fetchMock: {\n            mocks: [\n                {\n                    matcher: aggregatedEndpointMatcher,\n                    response: {\n                        status: 400,\n                        body: { error: 'no data' },\n                    },\n                },\n            ],\n        },\n    },\n    play: async ({ canvasElement }) => {\n        const canvas = await withinShadowRoot(canvasElement, 'gs-location-filter');\n\n        await waitFor(() =>\n            expect(canvas.getByText('Bad Request: {\"error\":\"no data\"} ', { exact: false })).toBeInTheDocument(),\n        );\n    },\n}"
+          "default": "{ ...Template, parameters: { fetchMock: { mocks: [ { matcher: aggregatedEndpointMatcher, response: { status: 400, body: { error: 'no data' }, }, }, ], }, }, play: async ({ canvasElement }) => { const canvas = await withinShadowRoot(canvasElement, 'gs-location-filter'); await waitFor(() => expect(canvas.getByText('Bad Request: {\"error\":\"no data\"} ', { exact: false })).toBeInTheDocument(), ); }, }"
         },
         {
           "kind": "variable",
@@ -1251,7 +1583,7 @@
           "type": {
             "text": "StoryObj<LocationFilterProps>"
           },
-          "default": "{\n    ...Template,\n    parameters: {\n        fetchMock: {\n            mocks: [\n                {\n                    matcher: aggregatedEndpointMatcher,\n                    response: {\n                        status: 200,\n                        body: data,\n                    },\n                },\n            ],\n        },\n    },\n    play: async ({ canvasElement, step }) => {\n        const canvas = await withinShadowRoot(canvasElement, 'gs-location-filter');\n\n        const submitButton = () => canvas.getByRole('button', { name: 'Submit' });\n        const inputField = () => canvas.getByRole('combobox');\n\n        const listenerMock = fn();\n        await step('Setup event listener mock', async () => {\n            canvasElement.addEventListener('gs-location-changed', listenerMock);\n        });\n\n        await step('wait until data is loaded', async () => {\n            await waitFor(() => {\n                return expect(inputField()).toBeEnabled();\n            });\n        });\n\n        await step('Input invalid location', async () => {\n            await userEvent.type(inputField(), 'Not / A / Location');\n            await userEvent.click(submitButton());\n            await expect(listenerMock).not.toHaveBeenCalled();\n            await userEvent.type(inputField(), '{backspace>18/}');\n        });\n\n        await step('Select Asia', async () => {\n            await userEvent.type(inputField(), 'Asia');\n            await userEvent.click(submitButton());\n            await expect(listenerMock).toHaveBeenCalledWith(\n                expect.objectContaining({\n                    detail: {\n                        region: 'Asia',\n                    },\n                }),\n            );\n        });\n\n        await step('Select Asia / Bangladesh / Rajshahi / Chapainawabgonj', async () => {\n            await userEvent.type(inputField(), ' / Bangladesh / Rajshahi / Chapainawabgonj');\n            await userEvent.click(submitButton());\n            await expect(listenerMock).toHaveBeenCalledWith(\n                expect.objectContaining({\n                    detail: {\n                        region: 'Asia',\n                        country: 'Bangladesh',\n                        division: 'Rajshahi',\n                        location: 'Chapainawabgonj',\n                    },\n                }),\n            );\n        });\n    },\n}"
+          "default": "{ ...Template, parameters: { fetchMock: { mocks: [ { matcher: aggregatedEndpointMatcher, response: { status: 200, body: data, }, }, ], }, }, play: async ({ canvasElement, step }) => { const canvas = await withinShadowRoot(canvasElement, 'gs-location-filter'); const submitButton = () => canvas.getByRole('button', { name: 'Submit' }); const inputField = () => canvas.getByRole('combobox'); const listenerMock = fn(); await step('Setup event listener mock', async () => { canvasElement.addEventListener('gs-location-changed', listenerMock); }); await step('wait until data is loaded', async () => { await waitFor(() => { return expect(inputField()).toBeEnabled(); }); }); await step('Input invalid location', async () => { await userEvent.type(inputField(), 'Not / A / Location'); await userEvent.click(submitButton()); await expect(listenerMock).not.toHaveBeenCalled(); await userEvent.type(inputField(), '{backspace>18/}'); }); await step('Select Asia', async () => { await userEvent.type(inputField(), 'Asia'); await userEvent.click(submitButton()); await expect(listenerMock).toHaveBeenCalledWith( expect.objectContaining({ detail: { region: 'Asia', }, }), ); }); await step('Select Asia / Bangladesh / Rajshahi / Chapainawabgonj', async () => { await userEvent.type(inputField(), ' / Bangladesh / Rajshahi / Chapainawabgonj'); await userEvent.click(submitButton()); await expect(listenerMock).toHaveBeenCalledWith( expect.objectContaining({ detail: { region: 'Asia', country: 'Bangladesh', division: 'Rajshahi', location: 'Chapainawabgonj', }, }), ); }); }, }"
         }
       ],
       "exports": [
@@ -1303,18 +1635,18 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "## Tag\n\n`gs-location-filter`\n\n## Context\n\nThis component provides an input field to specify filters for locations.\n\nIt expects a list of fields that form a strict hierarchical order, such as continent, country, and city.\nThe component retrieves a list of all possible values for these fields from the Lapis instance.\nThis list is then utilized to display autocomplete suggestions and to validate the input.\n\nGiven `fields` are `['field1', 'field2', ..., 'fieldN']`,\nthen valid values for the location filter must be in the form `valueForField1 / valueForField2 / ... / valueForFieldK`,\nwhere `1 <= K <= N`.\nValues for the fields `i > K` are considered `undefined`.",
+          "description": "## Context\n\nThis component provides an input field to specify filters for locations.\n\nIt expects a list of fields that form a strict hierarchical order, such as continent, country, and city.\nThe component retrieves a list of all possible values for these fields from the Lapis instance.\nThis list is then utilized to display autocomplete suggestions and to validate the input.\n\nGiven `fields` are `['field1', 'field2', ..., 'fieldN']`,\nthen valid values for the location filter must be in the form `valueForField1 / valueForField2 / ... / valueForFieldK`,\nwhere `1 <= K <= N`.\nValues for the fields `i > K` are considered `undefined`.",
           "name": "LocationFilterComponent",
           "members": [
             {
               "kind": "field",
-              "name": "value",
+              "name": "initialValue",
               "type": {
                 "text": "string"
               },
               "default": "''",
               "description": "The initial value to use for this location filter.\nMust be of the form `valueForField1 / valueForField2 / ... / valueForFieldN`.",
-              "attribute": "value"
+              "attribute": "initialValue"
             },
             {
               "kind": "field",
@@ -1338,13 +1670,13 @@
           ],
           "attributes": [
             {
-              "name": "value",
+              "name": "initialValue",
               "type": {
                 "text": "string"
               },
               "default": "''",
               "description": "The initial value to use for this location filter.\nMust be of the form `valueForField1 / valueForField2 / ... / valueForFieldN`.",
-              "fieldName": "value"
+              "fieldName": "initialValue"
             },
             {
               "name": "fields",
@@ -1383,12 +1715,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "src/web-components/input/location-filter.mdx",
-      "declarations": [],
-      "exports": []
-    },
     {
       "kind": "javascript-module",
       "path": "src/web-components/input/mutation-filter-component.stories.ts",
@@ -1397,33 +1723,33 @@
           "kind": "variable",
           "name": "meta",
           "type": {
-            "text": "Meta"
+            "text": "Meta<MutationFilterProps>"
           },
-          "default": "{\n    title: 'Input/Mutation filter',\n    component: 'gs-mutation-filter',\n    parameters: {\n        actions: {\n            handles: ['gs-mutation-filter-changed', 'gs-mutation-filter-on-blur'],\n        },\n        fetchMock: {},\n    },\n    decorators: [withActions],\n}"
+          "default": "{ title: 'Input/Mutation filter', component: 'gs-mutation-filter', parameters: withComponentDocs({ actions: { handles: ['gs-mutation-filter-changed', 'gs-mutation-filter-on-blur'], }, fetchMock: {}, componentDocs: { tag: 'gs-mutation-filter', opensShadowDom: true, expectsChildren: false, codeExample, }, }), decorators: [withActions], tags: ['autodocs'], }"
         },
         {
           "kind": "variable",
           "name": "Default",
           "type": {
-            "text": "StoryObj<{ lapisField: string; placeholderText: string }>"
+            "text": "StoryObj<MutationFilterProps>"
           },
-          "default": "{\n    render: () => {\n        return html` <gs-app lapis=\"${LAPIS_URL}\">\n            <div class=\"max-w-screen-lg\">\n                <gs-mutation-filter></gs-mutation-filter>\n            </div>\n        </gs-app>`;\n    },\n}"
+          "default": "{ ...Template, args: { initialValue: ['A123T'], }, }"
         },
         {
           "kind": "variable",
           "name": "FiresFilterChangedEvent",
           "type": {
-            "text": "StoryObj<{ lapisField: string; placeholderText: string }>"
+            "text": "StoryObj<MutationFilterProps>"
           },
-          "default": "{\n    ...Default,\n    play: async ({ canvasElement, step }) => {\n        const canvas = await withinShadowRoot(canvasElement, 'gs-mutation-filter');\n\n        const inputField = () => canvas.getByPlaceholderText('Enter a mutation');\n        const submitButton = () => canvas.getByRole('button', { name: '+' });\n        const listenerMock = fn();\n        await step('Setup event listener mock', async () => {\n            canvasElement.addEventListener('gs-mutation-filter-changed', listenerMock);\n        });\n\n        await step('wait until data is loaded', async () => {\n            await waitFor(() => {\n                return expect(inputField()).toBeEnabled();\n            });\n        });\n\n        await step('Enter a valid mutation', async () => {\n            await userEvent.type(inputField(), 'A123T');\n            await waitFor(() => submitButton().click());\n\n            await waitFor(() =>\n                expect(listenerMock).toHaveBeenCalledWith(\n                    expect.objectContaining({\n                        detail: {\n                            nucleotideMutations: ['A123T'],\n                            aminoAcidMutations: [],\n                            nucleotideInsertions: [],\n                            aminoAcidInsertions: [],\n                        },\n                    }),\n                ),\n            );\n        });\n    },\n}"
+          "default": "{ ...Template, play: async ({ canvasElement, step }) => { const canvas = await withinShadowRoot(canvasElement, 'gs-mutation-filter'); const inputField = () => canvas.getByPlaceholderText('Enter a mutation', { exact: false }); const submitButton = () => canvas.getByRole('button', { name: '+' }); const listenerMock = fn(); await step('Setup event listener mock', async () => { canvasElement.addEventListener('gs-mutation-filter-changed', listenerMock); }); await step('wait until data is loaded', async () => { await waitFor(() => { return expect(inputField()).toBeEnabled(); }); }); await step('Enter a valid mutation', async () => { await userEvent.type(inputField(), 'A123T'); await waitFor(() => submitButton().click()); await waitFor(() => expect(listenerMock).toHaveBeenCalledWith( expect.objectContaining({ detail: { nucleotideMutations: ['A123T'], aminoAcidMutations: [], nucleotideInsertions: [], aminoAcidInsertions: [], }, }), ), ); }); }, }"
         },
         {
           "kind": "variable",
           "name": "FiresFilterOnBlurEvent",
           "type": {
-            "text": "StoryObj<{ lapisField: string; placeholderText: string }>"
+            "text": "StoryObj<MutationFilterProps>"
           },
-          "default": "{\n    ...Default,\n    play: async ({ canvasElement, step }) => {\n        const canvas = await withinShadowRoot(canvasElement, 'gs-mutation-filter');\n\n        const inputField = () => canvas.getByPlaceholderText('Enter a mutation');\n        const listenerMock = fn();\n        await step('Setup event listener mock', async () => {\n            canvasElement.addEventListener('gs-mutation-filter-on-blur', listenerMock);\n        });\n\n        await step('wait until data is loaded', async () => {\n            await waitFor(() => {\n                return expect(inputField()).toBeEnabled();\n            });\n        });\n\n        await step('Move outside of input', async () => {\n            await userEvent.type(inputField(), 'A123T');\n            await userEvent.tab();\n\n            await expect(listenerMock).toHaveBeenCalled();\n        });\n    },\n}"
+          "default": "{ ...Template, play: async ({ canvasElement, step }) => { const canvas = await withinShadowRoot(canvasElement, 'gs-mutation-filter'); const inputField = () => canvas.getByPlaceholderText('Enter a mutation', { exact: false }); const listenerMock = fn(); await step('Setup event listener mock', async () => { canvasElement.addEventListener('gs-mutation-filter-on-blur', listenerMock); }); await step('wait until data is loaded', async () => { await waitFor(() => { return expect(inputField()).toBeEnabled(); }); }); await step('Move outside of input', async () => { await userEvent.type(inputField(), 'A123T'); await userEvent.tab(); await expect(listenerMock).toHaveBeenCalled(); }); }, }"
         }
       ],
       "exports": [
@@ -1467,25 +1793,47 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "",
+          "description": "## Context\nThis component provides an input field to specify filters for nucleotide and amino acid mutations and insertions.\n\nInput values have to be provided one at a time and submitted by pressing the Enter key or by clicking the '+' button.\nAfter submission, the component validates the input and fires an event with the selected mutations.\nAll previously selected mutations are displayed at the input field and added to the event.\nUsers can remove a mutation by clicking the 'x' button next to the mutation.\n\nValidation of the input is performed according to the following rules:\n\nMutations have to conform to the following format: `<gene/segment>:<symbol at reference><position><Substituted symbol/Deletion>`\n    - Gene/segment: The gene or segment where the mutation occurs. Must be contained in the reference genome\n      (Optional for elements with only one gene/segment)\n    - Symbol at reference: The symbol at the reference position. (Optional)\n    - Position: The position of the mutation. (Required)\n    - Substituted symbol/Deletion: The substituted symbol or '-' for a deletion. (Required)\n    Example: S:614G, 614G, 614- or 614G\n\nInsertions have to conform to the following format: `ins_<gene/segment>:<position>:<Inserted symbols>`\n    - Gene/segment: The gene or segment where the insertion occurs. Must be contained in the reference genome\n      (Optional for elements with only one gene/segment)\n    - Position: The position of the insertion. (Required)\n    - Inserted symbols: The symbols that are inserted. (Required)\n    Example: ins_S:614:G, ins_614:G",
           "name": "MutationFilterComponent",
-          "members": [],
+          "members": [
+            {
+              "kind": "field",
+              "name": "initialValue",
+              "type": {
+                "text": "SelectedMutationFilterStrings | string[] | undefined"
+              },
+              "default": "undefined",
+              "description": "The initial value to use for this mutation filter.\nMust be either\n- an array of strings of valid mutations.\n- an object with the keys `nucleotideMutations`, `aminoAcidMutations`, `nucleotideInsertions` and `aminoAcidInsertions` and corresponding string arrays.",
+              "attribute": "initialValue"
+            }
+          ],
           "events": [
             {
               "type": {
-                "text": "CustomEvent<SelectedMutationFilterStrings>"
+                "text": "CustomEvent<{nucleotideMutations: string[],aminoAcidMutations: string[],nucleotideInsertions: string[],aminoAcidInsertions: string[]}>"
               },
-              "description": "When the mutation filter values have changed",
+              "description": "Fired when: - The user has submitted a valid mutation or insertion - The user has removed a mutation or insertion",
               "name": "gs-mutation-filter-changed"
             },
             {
               "type": {
-                "text": "CustomEvent<SelectedMutationFilterStrings>"
+                "text": "CustomEvent<{nucleotideMutations: string[],aminoAcidMutations: string[],nucleotideInsertions: string[],aminoAcidInsertions: string[]}>"
               },
-              "description": "When the mutation filter has lost focus",
+              "description": "Fired when: - the mutation filter has lost focus Contains the selected mutations in the format",
               "name": "gs-mutation-filter-on-blur"
             }
           ],
+          "attributes": [
+            {
+              "name": "initialValue",
+              "type": {
+                "text": "SelectedMutationFilterStrings | string[] | undefined"
+              },
+              "default": "undefined",
+              "description": "The initial value to use for this mutation filter.\nMust be either\n- an array of strings of valid mutations.\n- an object with the keys `nucleotideMutations`, `aminoAcidMutations`, `nucleotideInsertions` and `aminoAcidInsertions` and corresponding string arrays.",
+              "fieldName": "initialValue"
+            }
+          ],
           "superclass": {
             "name": "PreactLitAdapter",
             "module": "/src/web-components/PreactLitAdapter"
@@ -1521,25 +1869,25 @@
           "kind": "variable",
           "name": "meta",
           "type": {
-            "text": "Meta"
+            "text": "Meta<TextInputProps>"
           },
-          "default": "{\n    title: 'Input/Text input',\n    component: 'gs-text-input',\n    parameters: {\n        actions: {\n            handles: ['gs-text-input-changed'],\n        },\n        fetchMock: {\n            mocks: [\n                {\n                    matcher: {\n                        name: 'hosts',\n                        url: AGGREGATED_ENDPOINT,\n                        body: {\n                            fields: ['host'],\n                        },\n                    },\n                    response: {\n                        status: 200,\n                        body: data,\n                    },\n                },\n            ],\n        },\n    },\n    decorators: [withActions],\n    tags: ['autodocs'],\n}"
+          "default": "{ title: 'Input/Text input', component: 'gs-text-input', parameters: withComponentDocs({ actions: { handles: ['gs-text-input-changed'], }, fetchMock: { mocks: [ { matcher: { name: 'hosts', url: AGGREGATED_ENDPOINT, body: { fields: ['host'], }, }, response: { status: 200, body: data, }, }, ], }, componentDocs: { tag: 'gs-text-input', opensShadowDom: true, expectsChildren: false, codeExample, }, }), decorators: [withActions], tags: ['autodocs'], }"
         },
         {
           "kind": "variable",
           "name": "Default",
           "type": {
-            "text": "StoryObj<{ lapisField: string; placeholderText: string }>"
+            "text": "StoryObj<TextInputProps>"
           },
-          "default": "{\n    render: (args) => {\n        return html` <gs-app lapis=\"${LAPIS_URL}\">\n            <div class=\"max-w-screen-lg\">\n                <gs-text-input .lapisField=${args.lapisField} .placeholderText=${args.placeholderText}></gs-text-input>\n            </div>\n        </gs-app>`;\n    },\n    args: {\n        lapisField: 'host',\n        placeholderText: 'Enter host name',\n    },\n}"
+          "default": "{ render: (args) => { return html` <gs-app lapis=\"${LAPIS_URL}\"> <div class=\"max-w-screen-lg\"> <gs-text-input .lapisField=${args.lapisField} .placeholderText=${args.placeholderText} .initialValue=${args.initialValue} ></gs-text-input> </div> </gs-app>`; }, args: { lapisField: 'host', placeholderText: 'Enter host name', initialValue: 'Homo sapiens', }, }"
         },
         {
           "kind": "variable",
           "name": "FiresEvent",
           "type": {
-            "text": "StoryObj<{ lapisField: string; placeholderText: string }>"
+            "text": "StoryObj<TextInputProps>"
           },
-          "default": "{\n    ...Default,\n    play: async ({ canvasElement, step }) => {\n        const canvas = await withinShadowRoot(canvasElement, 'gs-text-input');\n\n        const inputField = () => canvas.getByPlaceholderText('Enter host name');\n        const listenerMock = fn();\n        await step('Setup event listener mock', async () => {\n            canvasElement.addEventListener('gs-text-input-changed', listenerMock);\n        });\n\n        await step('wait until data is loaded', async () => {\n            await waitFor(() => {\n                return expect(inputField()).toBeEnabled();\n            });\n        });\n\n        await step('Enters an invalid host name', async () => {\n            await userEvent.type(inputField(), 'notInList');\n            await expect(listenerMock).not.toHaveBeenCalled();\n            await userEvent.type(inputField(), '{backspace>9/}');\n        });\n\n        await step('Enter a valid host name', async () => {\n            await userEvent.type(inputField(), 'Homo');\n\n            await expect(listenerMock).toHaveBeenCalledWith(\n                expect.objectContaining({\n                    detail: {\n                        host: 'Homo',\n                    },\n                }),\n            );\n        });\n    },\n}"
+          "default": "{ ...Default, play: async ({ canvasElement, step }) => { const canvas = await withinShadowRoot(canvasElement, 'gs-text-input'); const inputField = () => canvas.getByPlaceholderText('Enter host name'); const listenerMock = fn(); await step('Setup event listener mock', async () => { canvasElement.addEventListener('gs-text-input-changed', listenerMock); }); await step('wait until data is loaded', async () => { await waitFor(() => { return expect(inputField()).toBeEnabled(); }); }); await step('Enters an invalid host name', async () => { await userEvent.type(inputField(), 'notInList'); await expect(listenerMock).not.toHaveBeenCalled(); await userEvent.type(inputField(), '{backspace>9/}'); }); await step('Enter a valid host name', async () => { await userEvent.type(inputField(), 'Homo'); await expect(listenerMock).toHaveBeenCalledWith( expect.objectContaining({ detail: { host: 'Homo', }, }), ); }); }, args: { ...Default.args, initialValue: '', }, }"
         }
       ],
       "exports": [
@@ -1575,9 +1923,19 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "",
+          "description": "\n## Context\n\nThis component provides a text input field to specify filters for arbitrary fields of this Lapis instance.",
           "name": "TextInputComponent",
           "members": [
+            {
+              "kind": "field",
+              "name": "initialValue",
+              "type": {
+                "text": "string | undefined"
+              },
+              "default": "''",
+              "description": "The initial value to use for this text input.",
+              "attribute": "initialValue"
+            },
             {
               "kind": "field",
               "name": "lapisField",
@@ -1585,15 +1943,17 @@
                 "text": "string"
               },
               "default": "''",
+              "description": "The Lapis field name to use for this text input.",
               "attribute": "lapisField"
             },
             {
               "kind": "field",
               "name": "placeholderText",
               "type": {
-                "text": "string"
+                "text": "string | undefined"
               },
               "default": "''",
+              "description": "The placeholder text to display in the input field.",
               "attribute": "placeholderText"
             }
           ],
@@ -1602,25 +1962,36 @@
               "type": {
                 "text": "CustomEvent<Record<string, string>>"
               },
-              "description": "When the text input has changed",
+              "description": "Fired when the input field is changed. The `details` of this event contain an object with the `lapisField` as key and the input value as value. Example: ``` { \"host\": \"Homo sapiens\" } ```",
               "name": "gs-text-input-changed"
             }
           ],
           "attributes": [
+            {
+              "name": "initialValue",
+              "type": {
+                "text": "string | undefined"
+              },
+              "default": "''",
+              "description": "The initial value to use for this text input.",
+              "fieldName": "initialValue"
+            },
             {
               "name": "lapisField",
               "type": {
                 "text": "string"
               },
               "default": "''",
+              "description": "The Lapis field name to use for this text input.",
               "fieldName": "lapisField"
             },
             {
               "name": "placeholderText",
               "type": {
-                "text": "string"
+                "text": "string | undefined"
               },
               "default": "''",
+              "description": "The placeholder text to display in the input field.",
               "fieldName": "placeholderText"
             }
           ],