@repobuddy/storybook 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright © 2024 Homa Wong (unional) (homawong@gmail.com)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/esm/index.d.ts

@@ -0,0 +1,5 @@
+export * from './parameters/define_actions_param.ts';
+export * from './parameters/define_layout_param.ts';
+export * from './parameters/define_parameters.ts';
+export * from './parameters/define_story_sort.ts';
+export * from './parameters/define_test_param.ts';

package/esm/index.js

@@ -0,0 +1,5 @@
+export * from "./parameters/define_actions_param.js";
+export * from "./parameters/define_layout_param.js";
+export * from "./parameters/define_parameters.js";
+export * from "./parameters/define_story_sort.js";
+export * from "./parameters/define_test_param.js";

package/esm/manager/tag_badges.d.ts

@@ -0,0 +1,2 @@
+import { type TagBadgeParameters } from 'storybook-addon-tag-badges';
+export declare const tagBadges: TagBadgeParameters;

package/esm/manager/tag_badges.js

@@ -0,0 +1,77 @@
+import { defaultConfig } from 'storybook-addon-tag-badges';
+const [, , , , , , versionBadge] = defaultConfig;
+export const tagBadges = [
+    {
+        tags: 'new',
+        badge: {
+            text: '🆕',
+            bgColor: 'transparent',
+            tooltip: 'New'
+        }
+    },
+    {
+        tags: 'beta',
+        badge: {
+            text: '🅱️',
+            bgColor: 'transparent',
+            tooltip: 'Beta'
+        }
+    },
+    {
+        tags: 'deprecated',
+        badge: {
+            text: '🪦',
+            bgColor: 'transparent',
+            tooltip: 'Deprecated'
+        }
+    },
+    {
+        tags: 'outdated',
+        badge: {
+            text: '⚠️',
+            bgColor: 'transparent',
+            tooltip: 'Outdated'
+        }
+    },
+    {
+        tags: 'danger',
+        badge: {
+            text: '🚨',
+            bgColor: 'transparent',
+            tooltip: 'Dangerous'
+        }
+    },
+    {
+        tags: 'todo',
+        badge: {
+            text: '📋',
+            bgColor: 'transparent',
+            tooltip: 'Todo'
+        }
+    },
+    {
+        tags: 'code-only',
+        badge: {
+            text: '📝',
+            bgColor: 'transparent',
+            tooltip: 'Code Only'
+        }
+    },
+    {
+        tags: 'unit',
+        badge: {
+            text: '🧪',
+            bgColor: 'transparent',
+            tooltip: 'Unit Test'
+        }
+    },
+    {
+        tags: 'integration',
+        badge: {
+            text: '🧱',
+            bgColor: 'transparent',
+            tooltip: 'Integration Test'
+        }
+    },
+    versionBadge
+];

package/esm/manager.d.ts

@@ -0,0 +1 @@
+export * from './manager/tag_badges.ts';

package/esm/manager.js

@@ -0,0 +1 @@
+export * from "./manager/tag_badges.js";

package/esm/parameters/define_actions_param.d.ts

@@ -0,0 +1,22 @@
+export interface ActionsParam {
+    actions: {
+        argTypesRegex?: string | undefined;
+        disable?: boolean | undefined;
+        handles?: string[] | undefined;
+    };
+}
+/**
+ * Defines actions parameters for Storybook stories.
+ *
+ * @see https://storybook.js.org/docs/essentials/actions#parameters
+ *
+ * @param actions - Configuration for actions parameters
+ * @returns An object containing the actions parameter configuration
+ */
+export declare function defineActionsParam(actions: ActionsParam['actions']): {
+    actions: {
+        argTypesRegex?: string | undefined;
+        disable?: boolean | undefined;
+        handles?: string[] | undefined;
+    };
+};

package/esm/parameters/define_actions_param.js

@@ -0,0 +1,11 @@
+/**
+ * Defines actions parameters for Storybook stories.
+ *
+ * @see https://storybook.js.org/docs/essentials/actions#parameters
+ *
+ * @param actions - Configuration for actions parameters
+ * @returns An object containing the actions parameter configuration
+ */
+export function defineActionsParam(actions) {
+    return { actions };
+}

package/esm/parameters/define_layout_param.d.ts

@@ -0,0 +1,22 @@
+export interface LayoutParam {
+    layout: 'padded' | 'fullscreen' | 'centered';
+}
+/**
+ * Helper function to define the layout parameter for a story
+ *
+ * @see https://storybook.js.org/docs/api/parameters#layout
+ *
+ * @param layout - The layout type to use ('padded', 'fullscreen', or 'centered')
+ * @returns An object containing the layout parameter
+ * @example
+ * ```ts
+ * export const MyStory = {
+ *   parameters: {
+ *     ...defineLayoutParam('centered')
+ *   }
+ * }
+ * ```
+ */
+export declare const defineLayoutParam: (layout: LayoutParam["layout"]) => {
+    layout: "padded" | "fullscreen" | "centered";
+};

package/esm/parameters/define_layout_param.js

@@ -0,0 +1,19 @@
+/**
+ * Helper function to define the layout parameter for a story
+ *
+ * @see https://storybook.js.org/docs/api/parameters#layout
+ *
+ * @param layout - The layout type to use ('padded', 'fullscreen', or 'centered')
+ * @returns An object containing the layout parameter
+ * @example
+ * ```ts
+ * export const MyStory = {
+ *   parameters: {
+ *     ...defineLayoutParam('centered')
+ *   }
+ * }
+ * ```
+ */
+export const defineLayoutParam = (layout) => ({
+    layout
+});

package/esm/parameters/define_parameters.d.ts

@@ -0,0 +1,6 @@
+import type { LayoutParam } from './define_layout_param.ts';
+import type { StorySortParam } from './define_story_sort.ts';
+import type { TestParam } from './define_test_param.ts';
+export interface StorybookBuiltInParams extends Partial<LayoutParam>, Partial<StorySortParam>, Partial<TestParam> {
+}
+export declare function defineParameters<P extends Record<string, any>>(parameters: P & StorybookBuiltInParams): P & StorybookBuiltInParams;

package/esm/parameters/define_parameters.js

@@ -0,0 +1,3 @@
+export function defineParameters(parameters) {
+    return parameters;
+}

package/esm/parameters/define_story_sort.d.ts

@@ -0,0 +1,54 @@
+type StorySortConfig = {
+    includeNames?: boolean;
+    locales?: string;
+    method?: 'alphabetical' | 'alphabetical-by-kind' | 'custom';
+    order?: string[];
+};
+type Story = {
+    id: string;
+    importPath: string;
+    name: string;
+    title: string;
+};
+type StorySortFn = (a: Story, b: Story) => number;
+/**
+ * Interface for story sorting parameters in Storybook.
+ * Used to define how stories should be sorted in the navigation sidebar.
+ */
+export interface StorySortParam {
+    /**
+     * Configuration for story sorting. Can be either:
+     * - A StorySortConfig object specifying sort method and options
+     * - A custom sorting function that takes two stories and returns their sort order
+     */
+    storySort: StorySortConfig | StorySortFn;
+}
+/**
+ * Defines story sorting parameters for Storybook navigation.
+ *
+ * @see https://storybook.js.org/docs/api/parameters#optionsstorysort
+ *
+ * @param storySort - Configuration for how stories should be sorted. Can be either:
+ *   - A configuration object specifying sort method and options
+ *   - A custom sorting function that takes two stories and returns their sort order
+ * @returns An object containing the story sort configuration
+ *
+ * @example
+ * // Alphabetical sorting
+ * defineStorySort({ method: 'alphabetical' })
+ *
+ * @example
+ * // Custom order
+ * defineStorySort({
+ *   method: 'custom',
+ *   order: ['Introduction', 'Components', '*']
+ * })
+ *
+ * @example
+ * // Custom sort function
+ * defineStorySort((a, b) => a.title.localeCompare(b.title))
+ */
+export declare function defineStorySort(storySort: StorySortParam['storySort']): {
+    storySort: StorySortConfig | StorySortFn;
+};
+export {};

package/esm/parameters/define_story_sort.js

@@ -0,0 +1,28 @@
+/**
+ * Defines story sorting parameters for Storybook navigation.
+ *
+ * @see https://storybook.js.org/docs/api/parameters#optionsstorysort
+ *
+ * @param storySort - Configuration for how stories should be sorted. Can be either:
+ *   - A configuration object specifying sort method and options
+ *   - A custom sorting function that takes two stories and returns their sort order
+ * @returns An object containing the story sort configuration
+ *
+ * @example
+ * // Alphabetical sorting
+ * defineStorySort({ method: 'alphabetical' })
+ *
+ * @example
+ * // Custom order
+ * defineStorySort({
+ *   method: 'custom',
+ *   order: ['Introduction', 'Components', '*']
+ * })
+ *
+ * @example
+ * // Custom sort function
+ * defineStorySort((a, b) => a.title.localeCompare(b.title))
+ */
+export function defineStorySort(storySort) {
+    return { storySort };
+}

package/esm/parameters/define_test_param.d.ts

@@ -0,0 +1,32 @@
+export interface TestParam {
+    test: {
+        clearMocks?: boolean | undefined;
+        mockReset?: boolean | undefined;
+        restoreMocks?: boolean | undefined;
+        dangerouslyIgnoreUnhandledErrors?: boolean | undefined;
+    };
+}
+/**
+ * Defines test parameters for Storybook stories.
+ *
+ * @see https://storybook.js.org/docs/api/parameters#test
+ *
+ * @param test - Configuration for test parameters
+ * @returns An object containing the test parameter configuration
+ *
+ * @example
+ * defineTestParam({
+ *   clearMocks: true,
+ *   mockReset: true,
+ *   restoreMocks: true,
+ *   dangerouslyIgnoreUnhandledErrors: true
+ * })
+ */
+export declare function defineTestParam(test: TestParam['test']): {
+    test: {
+        clearMocks?: boolean | undefined;
+        mockReset?: boolean | undefined;
+        restoreMocks?: boolean | undefined;
+        dangerouslyIgnoreUnhandledErrors?: boolean | undefined;
+    };
+};

package/esm/parameters/define_test_param.js

@@ -0,0 +1,19 @@
+/**
+ * Defines test parameters for Storybook stories.
+ *
+ * @see https://storybook.js.org/docs/api/parameters#test
+ *
+ * @param test - Configuration for test parameters
+ * @returns An object containing the test parameter configuration
+ *
+ * @example
+ * defineTestParam({
+ *   clearMocks: true,
+ *   mockReset: true,
+ *   restoreMocks: true,
+ *   dangerouslyIgnoreUnhandledErrors: true
+ * })
+ */
+export function defineTestParam(test) {
+    return { test };
+}

package/esm/testing/index.d.ts

@@ -0,0 +1 @@
+export * from './it.ts';

package/esm/testing/index.js

@@ -0,0 +1 @@
+export * from "./it.js";

package/esm/testing/it.d.ts

@@ -0,0 +1,6 @@
+import type { Args, Renderer, StoryAnnotations } from 'storybook/internal/csf';
+export type ItObj<TRenderer extends Renderer, TArgs extends Args> = StoryAnnotations<TRenderer, TArgs>;
+export declare function it<TRenderer extends Renderer, TArgs extends Args>(description: string, story: StoryAnnotations<TRenderer, TArgs>): StoryAnnotations<TRenderer, TArgs>;
+export declare namespace it {
+    var skip: <TRenderer extends Renderer, TArgs extends Args>(description: string, story: StoryAnnotations<TRenderer, TArgs>) => StoryAnnotations<TRenderer, TArgs>;
+}

package/esm/testing/it.js

@@ -0,0 +1,19 @@
+export function it(description, story) {
+    const { play, ...rest } = story;
+    return {
+        ...rest,
+        async play(context) {
+            await context.step(description, async () => {
+                await play?.(context);
+            });
+        }
+    };
+}
+// does not work
+it.skip = (description, story) => {
+    const { tags = [], ...rest } = story;
+    return it(description, {
+        tags: [...tags, '!test'],
+        ...rest
+    });
+};

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@repobuddy/storybook",
+  "version": "0.1.0",
+  "description": "Storybook repo buddy",
+  "keywords": [
+    "storybook",
+    "testing",
+    "documentation"
+  ],
+  "license": "MIT",
+  "author": {
+    "name": "Homa Wong",
+    "email": "homawong@gmail.com",
+    "url": "https://github.com/unional"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./esm/index.d.ts",
+      "default": "./esm/index.js"
+    },
+    "./manager": {
+      "types": "./esm/manager.d.ts",
+      "default": "./esm/manager.js"
+    }
+  },
+  "files": [
+    "esm",
+    "src",
+    "!**/*.{spec,test,unit,accept,integrate,system,perf,stress,study,stories}.*"
+  ],
+  "devDependencies": {
+    "@storybook/addon-essentials": "^8.6.12",
+    "@storybook/addon-storysource": "^8.6.12",
+    "@storybook/blocks": "^8.6.12",
+    "@storybook/experimental-addon-test": "^8.6.12",
+    "@storybook/react": "^8.6.12",
+    "@storybook/react-vite": "^8.6.12",
+    "@storybook/test": "^8.6.12",
+    "@storybook/theming": "^8.6.12",
+    "@vitest/browser": "^3.1.2",
+    "@vitest/coverage-v8": "^3.1.2",
+    "react": "^19.1.0",
+    "react-dom": "^19.1.0",
+    "rimraf": "^6.0.1",
+    "storybook": "^8.6.12",
+    "storybook-addon-tag-badges": "^1.4.0",
+    "storybook-addon-vis": "^0.19.4",
+    "vitest": "^3.1.2"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rimraf .turbo coverage esm storybook-static *.tsbuildinfo",
+    "coverage": "vitest run --coverage",
+    "sb": "storybook dev -p 6006",
+    "sb:build": "storybook build",
+    "test": "vitest run",
+    "w": "vitest"
+  }
+}

package/readme.md

@@ -0,0 +1,74 @@
+# @repobuddy/storybook
+
+Your repo buddy for Storybook.
+
+## Install
+
+```bash
+pnpm add -D @repobuddy/storybook
+```
+
+## Features
+
+### Typed Parameters
+
+Storybook supports some built-in parameters, but the `StoryObj` type does not include them.
+
+[`@repobuddy/storybook`] adds these types as well as their corresponding define-functions so that you can use them in your stories.
+
+For example:
+
+```ts
+import { defineLayoutParam } from '@repobuddy/storybook'
+
+export const MyStory: StoryObj = {
+  parameters: defineLayoutParam('fullscreen')
+}
+```
+
+We also have a `defineParameters` function that types the built-in parameters from Storybook,
+and also allow you to specify additional parameter types.
+
+```ts
+import { defineParameters, type ActionsParam } from '@repobuddy/storybook'
+
+export const MyStory: StoryObj = {
+  parameters: defineParameters<ActionsParam>({
+    layout: 'fullscreen',
+    // this is typed
+    actions: {
+      disable: true
+    }
+  })
+}
+```
+
+### Manager Customizations
+
+#### Tag Badges
+
+If you use [`storybook-addon-tag-badges`],
+we provide a different set of badges that uses icons:
+
+- 🆕 New components/features
+- 🅱️ Beta status
+- 🪦 Deprecated notices
+- ⚠️ Outdated warnings
+- 🚨 Dangerous
+- 📋 To-do items
+- 📝 Code-only stories
+- 🧪 Unit tests
+- 🧱 Integration tests
+- Version indicators (unchanged)
+
+To use them, add them to your `.storybook/manager.ts`:
+
+```ts
+import { tagBadges } from '@repobuddy/storybook/manager'
+import { addons } from '@storybook/manager-api'
+
+addons.setConfig({ tagBadges })
+```
+
+[`@repobuddy/storybook`]: https://github.com/repobuddy/storybook
+[`storybook-addon-tag-badges`]: https://github.com/Sidnioulz/storybook-addon-tag-badges

package/src/index.ts

@@ -0,0 +1,5 @@
+export * from './parameters/define_actions_param.ts'
+export * from './parameters/define_layout_param.ts'
+export * from './parameters/define_parameters.ts'
+export * from './parameters/define_story_sort.ts'
+export * from './parameters/define_test_param.ts'

package/src/manager/tag_badges.ts

@@ -0,0 +1,80 @@
+import { type TagBadgeParameters, defaultConfig } from 'storybook-addon-tag-badges'
+
+const [, , , , , , versionBadge] = defaultConfig
+
+export const tagBadges: TagBadgeParameters = [
+	{
+		tags: 'new',
+		badge: {
+			text: '🆕',
+			bgColor: 'transparent',
+			tooltip: 'New'
+		}
+	},
+	{
+		tags: 'beta',
+		badge: {
+			text: '🅱️',
+			bgColor: 'transparent',
+			tooltip: 'Beta'
+		}
+	},
+	{
+		tags: 'deprecated',
+		badge: {
+			text: '🪦',
+			bgColor: 'transparent',
+			tooltip: 'Deprecated'
+		}
+	},
+	{
+		tags: 'outdated',
+		badge: {
+			text: '⚠️',
+			bgColor: 'transparent',
+			tooltip: 'Outdated'
+		}
+	},
+	{
+		tags: 'danger',
+		badge: {
+			text: '🚨',
+			bgColor: 'transparent',
+			tooltip: 'Dangerous'
+		}
+	},
+	{
+		tags: 'todo',
+		badge: {
+			text: '📋',
+			bgColor: 'transparent',
+			tooltip: 'Todo'
+		}
+	},
+	{
+		tags: 'code-only',
+		badge: {
+			text: '📝',
+			bgColor: 'transparent',
+			tooltip: 'Code Only'
+		}
+	},
+
+	{
+		tags: 'unit',
+		badge: {
+			text: '🧪',
+			bgColor: 'transparent',
+			tooltip: 'Unit Test'
+		}
+	},
+	{
+		tags: 'integration',
+		badge: {
+			text: '🧱',
+			bgColor: 'transparent',
+			tooltip: 'Integration Test'
+		}
+	},
+	versionBadge
+]

package/src/manager.ts

@@ -0,0 +1 @@
+export * from './manager/tag_badges.ts'

package/src/parameters/define_actions_param.ts

@@ -0,0 +1,19 @@
+export interface ActionsParam {
+	actions: {
+		argTypesRegex?: string | undefined
+		disable?: boolean | undefined
+		handles?: string[] | undefined
+	}
+}
+
+/**
+ * Defines actions parameters for Storybook stories.
+ *
+ * @see https://storybook.js.org/docs/essentials/actions#parameters
+ *
+ * @param actions - Configuration for actions parameters
+ * @returns An object containing the actions parameter configuration
+ */
+export function defineActionsParam(actions: ActionsParam['actions']) {
+	return { actions }
+}

package/src/parameters/define_layout_param.ts

@@ -0,0 +1,23 @@
+export interface LayoutParam {
+	layout: 'padded' | 'fullscreen' | 'centered'
+}
+
+/**
+ * Helper function to define the layout parameter for a story
+ *
+ * @see https://storybook.js.org/docs/api/parameters#layout
+ *
+ * @param layout - The layout type to use ('padded', 'fullscreen', or 'centered')
+ * @returns An object containing the layout parameter
+ * @example
+ * ```ts
+ * export const MyStory = {
+ *   parameters: {
+ *     ...defineLayoutParam('centered')
+ *   }
+ * }
+ * ```
+ */
+export const defineLayoutParam = (layout: LayoutParam['layout']) => ({
+	layout
+})

package/src/parameters/define_parameters.ts

@@ -0,0 +1,9 @@
+import type { LayoutParam } from './define_layout_param.ts'
+import type { StorySortParam } from './define_story_sort.ts'
+import type { TestParam } from './define_test_param.ts'
+
+export interface StorybookBuiltInParams extends Partial<LayoutParam>, Partial<StorySortParam>, Partial<TestParam> {}
+
+export function defineParameters<P extends Record<string, any>>(parameters: P & StorybookBuiltInParams) {
+	return parameters
+}

package/src/parameters/define_story_sort.ts

@@ -0,0 +1,57 @@
+type StorySortConfig = {
+	includeNames?: boolean
+	locales?: string
+	method?: 'alphabetical' | 'alphabetical-by-kind' | 'custom'
+	order?: string[]
+}
+
+type Story = {
+	id: string
+	importPath: string
+	name: string
+	title: string
+}
+
+type StorySortFn = (a: Story, b: Story) => number
+
+/**
+ * Interface for story sorting parameters in Storybook.
+ * Used to define how stories should be sorted in the navigation sidebar.
+ */
+export interface StorySortParam {
+	/**
+	 * Configuration for story sorting. Can be either:
+	 * - A StorySortConfig object specifying sort method and options
+	 * - A custom sorting function that takes two stories and returns their sort order
+	 */
+	storySort: StorySortConfig | StorySortFn
+}
+
+/**
+ * Defines story sorting parameters for Storybook navigation.
+ *
+ * @see https://storybook.js.org/docs/api/parameters#optionsstorysort
+ *
+ * @param storySort - Configuration for how stories should be sorted. Can be either:
+ *   - A configuration object specifying sort method and options
+ *   - A custom sorting function that takes two stories and returns their sort order
+ * @returns An object containing the story sort configuration
+ *
+ * @example
+ * // Alphabetical sorting
+ * defineStorySort({ method: 'alphabetical' })
+ *
+ * @example
+ * // Custom order
+ * defineStorySort({
+ *   method: 'custom',
+ *   order: ['Introduction', 'Components', '*']
+ * })
+ *
+ * @example
+ * // Custom sort function
+ * defineStorySort((a, b) => a.title.localeCompare(b.title))
+ */
+export function defineStorySort(storySort: StorySortParam['storySort']) {
+	return { storySort }
+}

package/src/parameters/define_test_param.ts

@@ -0,0 +1,28 @@
+export interface TestParam {
+	test: {
+		clearMocks?: boolean | undefined
+		mockReset?: boolean | undefined
+		restoreMocks?: boolean | undefined
+		dangerouslyIgnoreUnhandledErrors?: boolean | undefined
+	}
+}
+
+/**
+ * Defines test parameters for Storybook stories.
+ *
+ * @see https://storybook.js.org/docs/api/parameters#test
+ *
+ * @param test - Configuration for test parameters
+ * @returns An object containing the test parameter configuration
+ *
+ * @example
+ * defineTestParam({
+ *   clearMocks: true,
+ *   mockReset: true,
+ *   restoreMocks: true,
+ *   dangerouslyIgnoreUnhandledErrors: true
+ * })
+ */
+export function defineTestParam(test: TestParam['test']) {
+	return { test }
+}

package/src/testing/index.ts

@@ -0,0 +1 @@
+export * from './it.ts'

package/src/testing/it.ts

@@ -0,0 +1,30 @@
+import type { Args, Renderer, StoryAnnotations } from 'storybook/internal/csf'
+
+export type ItObj<TRenderer extends Renderer, TArgs extends Args> = StoryAnnotations<TRenderer, TArgs>
+
+export function it<TRenderer extends Renderer, TArgs extends Args>(
+	description: string,
+	story: StoryAnnotations<TRenderer, TArgs>
+): StoryAnnotations<TRenderer, TArgs> {
+	const { play, ...rest } = story
+	return {
+		...rest,
+		async play(context) {
+			await context.step(description, async () => {
+				await play?.(context)
+			})
+		}
+	}
+}
+
+// does not work
+it.skip = <TRenderer extends Renderer, TArgs extends Args>(
+	description: string,
+	story: StoryAnnotations<TRenderer, TArgs>
+) => {
+	const { tags = [], ...rest } = story
+	return it(description, {
+		tags: [...tags, '!test'],
+		...rest
+	})
+}