@repobuddy/storybook 2.6.0 → 2.8.0

package/esm/index.d.ts

@@ -70,6 +70,18 @@ type StoryCardProps = {
    */
   children?: ReactNode | undefined;
 };
+/**
+ * A card component that displays information with optional title and status styling.
+ *
+ * @param props - StoryCard component props
+ * @returns A section element containing the card content
+ */
+declare function StoryCard({
+  status,
+  className,
+  children,
+  title
+}: StoryCardProps): react_jsx_runtime0.JSX.Element;
 //#endregion
 //#region src/decorators/show_doc_source.d.ts
 /**
@@ -79,9 +91,11 @@ type StoryCardProps = {
  * @param options - Options for the showDocSource decorator
  * @param options.showOriginalSource - Whether to show the original source code in a card
  * @param options.className - Class name to apply to the card
+ * @param options.source - Source code to show if provided.
  * @returns A decorator function that shows the source code of a story above the rendered story
  */
 declare function showDocSource<TRenderer extends Renderer = Renderer, TArgs = Args>(options?: Pick<StoryCardProps, 'className'> & {
+  source?: string | undefined;
   showOriginalSource?: boolean | undefined;
 }): DecoratorFunction<TRenderer, TArgs>;
 //#endregion
@@ -798,4 +812,4 @@ type ExtendsStoryObj<S extends {
   tags?: ExtractStringLiterals<NonNullable<S['tags']>[number]> extends infer MT ? IsStringLiteral<MT> extends true ? Array<(string & {}) | MT | E['tag']> | undefined : Array<(string & {}) | E['tag']> | undefined : never;
 };
 //#endregion
-export { ActionsParam, BackgroundsParam, DocsParam, ExtendMeta, ExtendStoryObj, ExtendsMeta, ExtendsStoryObj, FnToArgTypes, GlobalApiBackgroundsParam, GlobalApiViewportParam, LayoutParam, ShowHtml, ShowHtmlProps, SourceProps, StorySortParam, StorybookBuiltInParams, TestParam, Viewport, ViewportParam, WithStoryCardProps, defineActionsParam, defineBackgroundsParam, defineDocsParam, defineLayoutParam, defineParameters, defineTestParam, defineViewportParam, showDocSource, whenRunningInTest, withStoryCard };
+export { ActionsParam, BackgroundsParam, DocsParam, ExtendMeta, ExtendStoryObj, ExtendsMeta, ExtendsStoryObj, FnToArgTypes, GlobalApiBackgroundsParam, GlobalApiViewportParam, LayoutParam, ShowHtml, ShowHtmlProps, SourceProps, StoryCard, StoryCardProps, StorySortParam, StorybookBuiltInParams, TestParam, Viewport, ViewportParam, WithStoryCardProps, defineActionsParam, defineBackgroundsParam, defineDocsParam, defineLayoutParam, defineParameters, defineTestParam, defineViewportParam, showDocSource, whenRunningInTest, withStoryCard };

package/esm/index.js

@@ -3,11 +3,11 @@ import { isRunningInTest } from "@repobuddy/test";
 import { prettify } from "htmlfy";
 import { createContext, useContext, useEffect, useLayoutEffect, useMemo, useRef, useState } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
+import { cva } from "class-variance-authority";
+import { twJoin, twMerge } from "tailwind-merge";
 import { SyntaxHighlighter } from "storybook/internal/components";
 import { addons } from "storybook/preview-api";
 import { ThemeProvider, convert, themes } from "storybook/theming";
-import { twJoin, twMerge } from "tailwind-merge";
-import { cva } from "class-variance-authority";
 
 export * from "@repobuddy/test"
 
@@ -81,6 +81,7 @@ const channel = addons.getChannel();
 * @param options - Options for the showDocSource decorator
 * @param options.showOriginalSource - Whether to show the original source code in a card
 * @param options.className - Class name to apply to the card
+* @param options.source - Source code to show if provided.
 * @returns A decorator function that shows the source code of a story above the rendered story
 */
 function showDocSource(options) {
@@ -92,7 +93,7 @@ function showDocSource(options) {
 			channel.on("DARK_MODE", setIsDark);
 			return () => channel.off("DARK_MODE", setIsDark);
 		}, []);
-		const code = options?.showOriginalSource ? docs?.source?.originalSource : docs?.source?.code ?? docs?.source?.originalSource;
+		const code = options?.source ?? (options?.showOriginalSource ? docs?.source?.originalSource : docs?.source?.code ?? docs?.source?.originalSource);
 		const language = code === docs?.source?.originalSource ? void 0 : docs?.source?.language;
 		const isOriginalSource = code === docs?.source?.originalSource;
 		const content = /* @__PURE__ */ jsx(SyntaxHighlighter, {
@@ -454,4 +455,4 @@ function whenRunningInTest(decoratorOrHandler) {
 }
 
 //#endregion
-export { ShowHtml, defineActionsParam, defineBackgroundsParam, defineDocsParam, defineLayoutParam, defineParameters, defineTestParam, defineViewportParam, showDocSource, whenRunningInTest, withStoryCard };
+export { ShowHtml, StoryCard, defineActionsParam, defineBackgroundsParam, defineDocsParam, defineLayoutParam, defineParameters, defineTestParam, defineViewportParam, showDocSource, whenRunningInTest, withStoryCard };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@repobuddy/storybook",
-  "version": "2.6.0",
+  "version": "2.8.0",
   "description": "Storybook repo buddy",
   "keywords": [
     "storybook",
@@ -60,9 +60,9 @@
   "devDependencies": {
     "@repobuddy/vitest": "^2.0.0",
     "@storybook-community/storybook-dark-mode": "^7.0.2",
-    "@storybook/addon-docs": "^10.1.10",
+    "@storybook/addon-docs": "^10.2.4",
     "@storybook/addon-vitest": "^10.1.10",
-    "@storybook/react-vite": "^10.1.10",
+    "@storybook/react-vite": "^10.2.4",
     "@tailwindcss/cli": "^4.1.17",
     "@tailwindcss/vite": "^4.1.17",
     "@vitest/browser": "^4.0.16",
@@ -82,7 +82,7 @@
   },
   "peerDependencies": {
     "@storybook-community/storybook-dark-mode": "^7.0.0",
-    "@storybook/addon-docs": "^10.1.10",
+    "@storybook/addon-docs": "^10.2.4",
     "storybook-addon-tag-badges": "^3.0.2"
   },
   "peerDependenciesMeta": {

package/src/decorators/show_doc_source.tsx

@@ -15,10 +15,12 @@ const channel = addons.getChannel()
  * @param options - Options for the showDocSource decorator
  * @param options.showOriginalSource - Whether to show the original source code in a card
  * @param options.className - Class name to apply to the card
+ * @param options.source - Source code to show if provided.
  * @returns A decorator function that shows the source code of a story above the rendered story
  */
 export function showDocSource<TRenderer extends Renderer = Renderer, TArgs = Args>(
 	options?: Pick<StoryCardProps, 'className'> & {
+		source?: string | undefined
 		showOriginalSource?: boolean | undefined
 	}
 ): DecoratorFunction<TRenderer, TArgs> {
@@ -34,9 +36,11 @@ export function showDocSource<TRenderer extends Renderer = Renderer, TArgs = Arg
 			return () => channel.off('DARK_MODE', setIsDark)
 		}, [])
 
-		const code = options?.showOriginalSource
-			? docs?.source?.originalSource
-			: (docs?.source?.code ?? docs?.source?.originalSource)
+		const code =
+			options?.source ??
+			(options?.showOriginalSource
+				? docs?.source?.originalSource
+				: (docs?.source?.code ?? docs?.source?.originalSource))
 
 		const language = code === docs?.source?.originalSource ? undefined : docs?.source?.language
 

package/src/index.ts

@@ -1,6 +1,7 @@
 export * from '@repobuddy/test'
 export type * from './arg-types/fn-to-arg-types.ts'
 export * from './components/show_html.tsx'
+export * from './components/story_card.tsx'
 export * from './decorators/show_doc_source.tsx'
 export * from './decorators/with_story_card.tsx'
 export * from './parameters/define_actions_param.ts'