@repobuddy/storybook 2.15.0 → 2.17.0

package/esm/index.js

@@ -93,11 +93,11 @@ function generateKey(prefix) {
 }
 
 //#endregion
-//#region src/contexts/story_card_registry_context.tsx
+//#region src/contexts/_story_card_registry_context.tsx
 const StoryCardRegistryContext = createContext(null);
 
 //#endregion
-//#region src/contexts/story_card_scope.tsx
+//#region src/contexts/_story_card_scope.tsx
 /**
 * Ensures a story-card collection scope: creates the root container when no context exists,
 * otherwise renders the collector so this card participates in the existing scope.

package/esm/storybook-addon-tag-badges/index.d.ts

@@ -8,26 +8,7 @@ type TagBadgeParameter = TagBadgeParameters[0];
 /**
  * Type representing the names of predefined tags used in Storybook stories.
  */
-type TagNames = 'editor' | 'source' | 'type' | 'new' | 'beta' | 'props' | 'deprecated' | 'outdated' | 'danger' | 'todo' | 'code-only' | 'snapshot' | 'unit' | 'integration' | 'keyboard' | 'internal' | 'usecase' | 'version:next';
-/**
- * Configuration for story tag badges that appear in the Storybook sidebar.
- * Each badge is associated with a specific tag and displays an emoji with a tooltip.
- *
- * The badges help visually identify stories with certain characteristics:
- * - ✏️ Editor - Stories with live editor
- * - 🆕 New - Recently added stories
- * - 🅱️ Beta - Stories for features in beta
- * - 🪦 Deprecated - Stories for deprecated features
- * - ⚠️ Outdated - Stories that need updating
- * - 🚨 Danger - Stories demonstrating dangerous patterns
- * - 📋 Todo - Stories marked as todo/incomplete
- * - 📝 Code Only - Stories without visual examples
- * - 📸 Snapshot - Stories with snapshot tests
- * - 🧪 Unit - Stories with unit tests
- * - 🔗 Integration - Stories with integration tests
- *
- * Also includes the default version badge from `storybook-addon-tag-badges`.
- */
+type TagNames = 'editor' | 'source' | 'type' | 'func' | 'var' | 'new' | 'beta' | 'props' | 'deprecated' | 'outdated' | 'danger' | 'todo' | 'code-only' | 'snapshot' | 'unit' | 'integration' | 'keyboard' | 'internal' | 'usecase' | 'use-case' | 'version:next';
 /** Badge (✏️) for stories with a live editor. Shown in sidebar on story and inherited. */
 declare const editorBadge: TagBadgeParameter;
 /** Badge (🆕) for recently added stories. */
@@ -48,6 +29,10 @@ declare const todoBadge: TagBadgeParameter;
 declare const codeOnlyBadge: TagBadgeParameter;
 /** Badge (<T>) for stories that showcase or document TypeScript types. Hidden in MDX. */
 declare const typeBadge: TagBadgeParameter;
+/** Badge (ƒ(x)) for stories that showcase or document functions. Hidden in MDX. */
+declare const functionBadge: TagBadgeParameter;
+/** Badge (var) for stories that describe values and variables. */
+declare const varBadge: TagBadgeParameter;
 /** Badge (`</>`) for source-code-focused stories. Hidden in MDX. */
 declare const sourceBadge: TagBadgeParameter;
 /** Badge (📸) for stories with snapshot tests. Shown in toolbar only, not in sidebar. */
@@ -60,7 +45,32 @@ declare const integrationBadge: TagBadgeParameter;
 declare const keyboardBadge: TagBadgeParameter;
 /** Badge (🔒) for internal or private-use-only stories. */
 declare const internalBadge: TagBadgeParameter;
-/** Ordered list of all tag badge configs used by the addon (includes version badge). */
+/**
+ * Configuration for story tag badges that appear in the Storybook sidebar.
+ * Each badge is associated with a specific tag and displays an emoji or symbol with a tooltip.
+ *
+ * The badges help visually identify stories with certain characteristics:
+ * - 🆕 New - Recently added stories
+ * - 🅱️ Beta - Stories for features in beta
+ * - 🪦 Deprecated - Stories for deprecated features
+ * - ⚠️ Outdated - Stories that need updating
+ * - ✏️ Editor - Stories with live editor
+ * - 🧪 Unit - Stories with unit tests
+ * - 🔗 Integration - Stories with integration tests
+ * - ⌨️ Keyboard - Stories that demonstrate or test keyboard interaction
+ * - 🚨 Danger - Stories demonstrating dangerous patterns
+ * - `</>` Source - Source-code-focused stories
+ * - `<T>` Type - Stories that showcase or document TypeScript types
+ * - `ƒ(x)` Function - Stories that showcase or document functions
+ * - `var` Variables - Stories that describe values and variables
+ * - 🔧 Props - Stories that demonstrate props or configuration
+ * - 📝 Code Only - Stories without visual examples
+ * - 📋 Todo - Stories marked as todo/incomplete
+ * - `next` - (`version:next`) The component or function is available in the next version
+ * - `x.y` - (`version:x.y`) The component or function was created or updated in the x.y version
+ * - 🔒 Internal - Internal or private-use-only stories
+ * - 📸 Snapshot - Stories with snapshot tests
+ */
 declare const tagBadges: TagBadgeParameters;
 //#endregion
 //#region src/types/_extract_string_literals.d.ts
@@ -134,4 +144,4 @@ type StoryObj<TMetaOrCmpOrArgs = Args> = ExtendStoryObj<TMetaOrCmpOrArgs, StoryO
   tag: TagNames;
 }>;
 //#endregion
-export { Meta, StoryObj, TagNames, betaBadge, codeOnlyBadge, dangerBadge, deprecatedBadge, editorBadge, integrationBadge, internalBadge, keyboardBadge, newBadge, outdatedBadge, propsBadge, snapshotBadge, sourceBadge, tagBadges, todoBadge, typeBadge, unitBadge };
+export { Meta, StoryObj, TagNames, betaBadge, codeOnlyBadge, dangerBadge, deprecatedBadge, editorBadge, functionBadge, integrationBadge, internalBadge, keyboardBadge, newBadge, outdatedBadge, propsBadge, snapshotBadge, sourceBadge, tagBadges, todoBadge, typeBadge, unitBadge, varBadge };

package/esm/storybook-addon-tag-badges/index.js

@@ -3,25 +3,6 @@ import { defaultConfig } from "storybook-addon-tag-badges/manager-helpers";
 
 //#region src/storybook-addon-tag-badges/tag_badges.ts
 const [, , , , , , versionBadge] = defaultConfig;
-/**
-* Configuration for story tag badges that appear in the Storybook sidebar.
-* Each badge is associated with a specific tag and displays an emoji with a tooltip.
-*
-* The badges help visually identify stories with certain characteristics:
-* - ✏️ Editor - Stories with live editor
-* - 🆕 New - Recently added stories
-* - 🅱️ Beta - Stories for features in beta
-* - 🪦 Deprecated - Stories for deprecated features
-* - ⚠️ Outdated - Stories that need updating
-* - 🚨 Danger - Stories demonstrating dangerous patterns
-* - 📋 Todo - Stories marked as todo/incomplete
-* - 📝 Code Only - Stories without visual examples
-* - 📸 Snapshot - Stories with snapshot tests
-* - 🧪 Unit - Stories with unit tests
-* - 🔗 Integration - Stories with integration tests
-*
-* Also includes the default version badge from `storybook-addon-tag-badges`.
-*/
 /** Badge (✏️) for stories with a live editor. Shown in sidebar on story and inherited. */
 const editorBadge = {
 	tags: "editor",
@@ -146,7 +127,33 @@ const typeBadge = {
 		},
 		tooltip: "TypeScript Types"
 	},
-	display: { mdx: false }
+	display: { mdx: true }
+};
+/** Badge (ƒ(x)) for stories that showcase or document functions. Hidden in MDX. */
+const functionBadge = {
+	tags: "func",
+	badge: {
+		text: "ƒ(x)",
+		style: {
+			backgroundColor: "transparent",
+			borderColor: "transparent"
+		},
+		tooltip: "Function"
+	},
+	display: { mdx: true }
+};
+/** Badge (var) for stories that describe values and variables. */
+const varBadge = {
+	tags: "var",
+	badge: {
+		text: "var",
+		style: {
+			backgroundColor: "transparent",
+			borderColor: "transparent"
+		},
+		tooltip: "Variables"
+	},
+	display: { mdx: true }
 };
 /** Badge (`</>`) for source-code-focused stories. Hidden in MDX. */
 const sourceBadge = {
@@ -227,26 +234,53 @@ const internalBadge = {
 		tooltip: "Internal"
 	}
 };
-/** Ordered list of all tag badge configs used by the addon (includes version badge). */
+/**
+* Configuration for story tag badges that appear in the Storybook sidebar.
+* Each badge is associated with a specific tag and displays an emoji or symbol with a tooltip.
+*
+* The badges help visually identify stories with certain characteristics:
+* - 🆕 New - Recently added stories
+* - 🅱️ Beta - Stories for features in beta
+* - 🪦 Deprecated - Stories for deprecated features
+* - ⚠️ Outdated - Stories that need updating
+* - ✏️ Editor - Stories with live editor
+* - 🧪 Unit - Stories with unit tests
+* - 🔗 Integration - Stories with integration tests
+* - ⌨️ Keyboard - Stories that demonstrate or test keyboard interaction
+* - 🚨 Danger - Stories demonstrating dangerous patterns
+* - `</>` Source - Source-code-focused stories
+* - `<T>` Type - Stories that showcase or document TypeScript types
+* - `ƒ(x)` Function - Stories that showcase or document functions
+* - `var` Variables - Stories that describe values and variables
+* - 🔧 Props - Stories that demonstrate props or configuration
+* - 📝 Code Only - Stories without visual examples
+* - 📋 Todo - Stories marked as todo/incomplete
+* - `next` - (`version:next`) The component or function is available in the next version
+* - `x.y` - (`version:x.y`) The component or function was created or updated in the x.y version
+* - 🔒 Internal - Internal or private-use-only stories
+* - 📸 Snapshot - Stories with snapshot tests
+*/
 const tagBadges = [
-	editorBadge,
-	sourceBadge,
-	typeBadge,
-	unitBadge,
-	integrationBadge,
-	keyboardBadge,
 	newBadge,
 	betaBadge,
 	deprecatedBadge,
 	outdatedBadge,
+	editorBadge,
+	unitBadge,
+	integrationBadge,
+	keyboardBadge,
 	dangerBadge,
+	sourceBadge,
+	typeBadge,
+	functionBadge,
+	varBadge,
 	propsBadge,
-	todoBadge,
 	codeOnlyBadge,
+	todoBadge,
 	versionBadge,
 	internalBadge,
 	snapshotBadge
 ];
 
 //#endregion
-export { betaBadge, codeOnlyBadge, dangerBadge, deprecatedBadge, editorBadge, integrationBadge, internalBadge, keyboardBadge, newBadge, outdatedBadge, propsBadge, snapshotBadge, sourceBadge, tagBadges, todoBadge, typeBadge, unitBadge };
+export { betaBadge, codeOnlyBadge, dangerBadge, deprecatedBadge, editorBadge, functionBadge, integrationBadge, internalBadge, keyboardBadge, newBadge, outdatedBadge, propsBadge, snapshotBadge, sourceBadge, tagBadges, todoBadge, typeBadge, unitBadge, varBadge };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@repobuddy/storybook",
-  "version": "2.15.0",
+  "version": "2.17.0",
   "description": "Storybook repo buddy",
   "keywords": [
     "storybook",

package/src/contexts/{story_card_scope.tsx → _story_card_scope.tsx}

@@ -5,7 +5,7 @@ import {
 	type StoryCardEntry,
 	StoryCardRegistryContext,
 	type StoryCardRegistryContextValue
-} from './story_card_registry_context.js'
+} from './_story_card_registry_context.js'
 
 export type StoryCardScopeProps = { Story: ComponentType } & StoryCardEntry
 

package/src/decorators/show_doc_source.tsx

@@ -5,7 +5,7 @@ import { addons } from 'storybook/preview-api'
 import { convert, ThemeProvider, themes } from 'storybook/theming'
 import { twJoin } from 'tailwind-merge'
 import { StoryCard, type StoryCardProps } from '../components/story_card'
-import { StoryCardScope } from '../contexts/story_card_scope'
+import { StoryCardScope } from '../contexts/_story_card_scope'
 
 const channel = addons.getChannel()
 

package/src/decorators/with_story_card.tsx

@@ -1,7 +1,7 @@
 import type { ReactNode } from 'react'
 import type { DecoratorFunction, Renderer } from 'storybook/internal/csf'
 import type { StoryCardProps, StoryCardStatus } from '../components/story_card.js'
-import { StoryCardScope } from '../contexts/story_card_scope.js'
+import { StoryCardScope } from '../contexts/_story_card_scope.js'
 import type { StoryCardParam } from '../parameters/define_story_card_param.js'
 
 export type WithStoryCardProps = Omit<StoryCardProps, 'children' | 'className'> & {

package/src/storybook-addon-tag-badges/tag_badges.ts

@@ -11,6 +11,8 @@ export type TagNames =
 	| 'editor'
 	| 'source'
 	| 'type'
+	| 'func'
+	| 'var'
 	| 'new'
 	| 'beta'
 	| 'props'
@@ -25,28 +27,9 @@ export type TagNames =
 	| 'keyboard'
 	| 'internal'
 	| 'usecase'
+	| 'use-case'
 	| 'version:next'
 
-/**
- * Configuration for story tag badges that appear in the Storybook sidebar.
- * Each badge is associated with a specific tag and displays an emoji with a tooltip.
- *
- * The badges help visually identify stories with certain characteristics:
- * - ✏️ Editor - Stories with live editor
- * - 🆕 New - Recently added stories
- * - 🅱️ Beta - Stories for features in beta
- * - 🪦 Deprecated - Stories for deprecated features
- * - ⚠️ Outdated - Stories that need updating
- * - 🚨 Danger - Stories demonstrating dangerous patterns
- * - 📋 Todo - Stories marked as todo/incomplete
- * - 📝 Code Only - Stories without visual examples
- * - 📸 Snapshot - Stories with snapshot tests
- * - 🧪 Unit - Stories with unit tests
- * - 🔗 Integration - Stories with integration tests
- *
- * Also includes the default version badge from `storybook-addon-tag-badges`.
- */
-
 /** Badge (✏️) for stories with a live editor. Shown in sidebar on story and inherited. */
 export const editorBadge: TagBadgeParameter = {
 	tags: 'editor',
@@ -185,7 +168,39 @@ export const typeBadge: TagBadgeParameter = {
 		tooltip: 'TypeScript Types'
 	},
 	display: {
-		mdx: false
+		mdx: true
+	}
+}
+
+/** Badge (ƒ(x)) for stories that showcase or document functions. Hidden in MDX. */
+export const functionBadge: TagBadgeParameter = {
+	tags: 'func',
+	badge: {
+		text: 'ƒ(x)',
+		style: {
+			backgroundColor: 'transparent',
+			borderColor: 'transparent'
+		},
+		tooltip: 'Function'
+	},
+	display: {
+		mdx: true
+	}
+}
+
+/** Badge (var) for stories that describe values and variables. */
+export const varBadge: TagBadgeParameter = {
+	tags: 'var',
+	badge: {
+		text: 'var',
+		style: {
+			backgroundColor: 'transparent',
+			borderColor: 'transparent'
+		},
+		tooltip: 'Variables'
+	},
+	display: {
+		mdx: true
 	}
 }
 
@@ -280,22 +295,49 @@ export const internalBadge: TagBadgeParameter = {
 	}
 }
 
-/** Ordered list of all tag badge configs used by the addon (includes version badge). */
+/**
+ * Configuration for story tag badges that appear in the Storybook sidebar.
+ * Each badge is associated with a specific tag and displays an emoji or symbol with a tooltip.
+ *
+ * The badges help visually identify stories with certain characteristics:
+ * - 🆕 New - Recently added stories
+ * - 🅱️ Beta - Stories for features in beta
+ * - 🪦 Deprecated - Stories for deprecated features
+ * - ⚠️ Outdated - Stories that need updating
+ * - ✏️ Editor - Stories with live editor
+ * - 🧪 Unit - Stories with unit tests
+ * - 🔗 Integration - Stories with integration tests
+ * - ⌨️ Keyboard - Stories that demonstrate or test keyboard interaction
+ * - 🚨 Danger - Stories demonstrating dangerous patterns
+ * - `</>` Source - Source-code-focused stories
+ * - `<T>` Type - Stories that showcase or document TypeScript types
+ * - `ƒ(x)` Function - Stories that showcase or document functions
+ * - `var` Variables - Stories that describe values and variables
+ * - 🔧 Props - Stories that demonstrate props or configuration
+ * - 📝 Code Only - Stories without visual examples
+ * - 📋 Todo - Stories marked as todo/incomplete
+ * - `next` - (`version:next`) The component or function is available in the next version
+ * - `x.y` - (`version:x.y`) The component or function was created or updated in the x.y version
+ * - 🔒 Internal - Internal or private-use-only stories
+ * - 📸 Snapshot - Stories with snapshot tests
+ */
 export const tagBadges: TagBadgeParameters = [
-	editorBadge,
-	sourceBadge,
-	typeBadge,
-	unitBadge,
-	integrationBadge,
-	keyboardBadge,
 	newBadge,
 	betaBadge,
 	deprecatedBadge,
 	outdatedBadge,
+	editorBadge,
+	unitBadge,
+	integrationBadge,
+	keyboardBadge,
 	dangerBadge,
+	sourceBadge,
+	typeBadge,
+	functionBadge,
+	varBadge,
 	propsBadge,
-	todoBadge,
 	codeOnlyBadge,
+	todoBadge,
 	versionBadge,
 	internalBadge,
 	snapshotBadge