@repobuddy/storybook 2.0.1 → 2.1.0

package/esm/index.js

@@ -1,12 +1,491 @@
-export * from "@repobuddy/test";
-export * from "./components/show_html.tsx";
-export * from "./decorators/show_doc_source.tsx";
-export * from "./parameters/define_actions_param.ts";
-export * from "./parameters/define_backgrounds_param.ts";
-export * from "./parameters/define_docs_param.ts";
-export * from "./parameters/define_layout_param.ts";
-export * from "./parameters/define_parameters.ts";
-export * from "./parameters/define_test_param.ts";
-export * from "./parameters/define_viewport_param.ts";
-export * from "./parameters/story_sort.ts";
-export * from "./testing/decorators/when_running_in_test.tsx";
+import { isRunningInTest } from "@repobuddy/test";
+import { prettify } from "htmlfy";
+import { useEffect, useState } from "react";
+import { SyntaxHighlighter } from "storybook/internal/components";
+import { addons } from "storybook/preview-api";
+import { ThemeProvider, convert, themes } from "storybook/theming";
+
+export * from "@repobuddy/test"
+
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __commonJS = (cb, mod) => function() {
+	return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, { get: (a, b) => (typeof require !== "undefined" ? require : a)[b] }) : x)(function(x) {
+	if (typeof require !== "undefined") return require.apply(this, arguments);
+	throw Error("Calling `require` for \"" + x + "\" in an environment that doesn't expose the `require` function.");
+});
+
+//#endregion
+//#region ../../node_modules/.pnpm/react@19.2.0/node_modules/react/cjs/react-jsx-runtime.development.js
+/**
+* @license React
+* react-jsx-runtime.development.js
+*
+* Copyright (c) Meta Platforms, Inc. and affiliates.
+*
+* This source code is licensed under the MIT license found in the
+* LICENSE file in the root directory of this source tree.
+*/
+var require_react_jsx_runtime_development = /* @__PURE__ */ __commonJS({ "../../node_modules/.pnpm/react@19.2.0/node_modules/react/cjs/react-jsx-runtime.development.js": ((exports) => {
+	(function() {
+		function getComponentNameFromType(type) {
+			if (null == type) return null;
+			if ("function" === typeof type) return type.$$typeof === REACT_CLIENT_REFERENCE ? null : type.displayName || type.name || null;
+			if ("string" === typeof type) return type;
+			switch (type) {
+				case REACT_FRAGMENT_TYPE: return "Fragment";
+				case REACT_PROFILER_TYPE: return "Profiler";
+				case REACT_STRICT_MODE_TYPE: return "StrictMode";
+				case REACT_SUSPENSE_TYPE: return "Suspense";
+				case REACT_SUSPENSE_LIST_TYPE: return "SuspenseList";
+				case REACT_ACTIVITY_TYPE: return "Activity";
+			}
+			if ("object" === typeof type) switch ("number" === typeof type.tag && console.error("Received an unexpected object in getComponentNameFromType(). This is likely a bug in React. Please file an issue."), type.$$typeof) {
+				case REACT_PORTAL_TYPE: return "Portal";
+				case REACT_CONTEXT_TYPE: return type.displayName || "Context";
+				case REACT_CONSUMER_TYPE: return (type._context.displayName || "Context") + ".Consumer";
+				case REACT_FORWARD_REF_TYPE:
+					var innerType = type.render;
+					type = type.displayName;
+					type || (type = innerType.displayName || innerType.name || "", type = "" !== type ? "ForwardRef(" + type + ")" : "ForwardRef");
+					return type;
+				case REACT_MEMO_TYPE: return innerType = type.displayName || null, null !== innerType ? innerType : getComponentNameFromType(type.type) || "Memo";
+				case REACT_LAZY_TYPE:
+					innerType = type._payload;
+					type = type._init;
+					try {
+						return getComponentNameFromType(type(innerType));
+					} catch (x) {}
+			}
+			return null;
+		}
+		function testStringCoercion(value) {
+			return "" + value;
+		}
+		function checkKeyStringCoercion(value) {
+			try {
+				testStringCoercion(value);
+				var JSCompiler_inline_result = !1;
+			} catch (e) {
+				JSCompiler_inline_result = !0;
+			}
+			if (JSCompiler_inline_result) {
+				JSCompiler_inline_result = console;
+				var JSCompiler_temp_const = JSCompiler_inline_result.error;
+				var JSCompiler_inline_result$jscomp$0 = "function" === typeof Symbol && Symbol.toStringTag && value[Symbol.toStringTag] || value.constructor.name || "Object";
+				JSCompiler_temp_const.call(JSCompiler_inline_result, "The provided key is an unsupported type %s. This value must be coerced to a string before using it here.", JSCompiler_inline_result$jscomp$0);
+				return testStringCoercion(value);
+			}
+		}
+		function getTaskName(type) {
+			if (type === REACT_FRAGMENT_TYPE) return "<>";
+			if ("object" === typeof type && null !== type && type.$$typeof === REACT_LAZY_TYPE) return "<...>";
+			try {
+				var name = getComponentNameFromType(type);
+				return name ? "<" + name + ">" : "<...>";
+			} catch (x) {
+				return "<...>";
+			}
+		}
+		function getOwner() {
+			var dispatcher = ReactSharedInternals.A;
+			return null === dispatcher ? null : dispatcher.getOwner();
+		}
+		function UnknownOwner() {
+			return Error("react-stack-top-frame");
+		}
+		function hasValidKey(config) {
+			if (hasOwnProperty.call(config, "key")) {
+				var getter = Object.getOwnPropertyDescriptor(config, "key").get;
+				if (getter && getter.isReactWarning) return !1;
+			}
+			return void 0 !== config.key;
+		}
+		function defineKeyPropWarningGetter(props, displayName) {
+			function warnAboutAccessingKey() {
+				specialPropKeyWarningShown || (specialPropKeyWarningShown = !0, console.error("%s: `key` is not a prop. Trying to access it will result in `undefined` being returned. If you need to access the same value within the child component, you should pass it as a different prop. (https://react.dev/link/special-props)", displayName));
+			}
+			warnAboutAccessingKey.isReactWarning = !0;
+			Object.defineProperty(props, "key", {
+				get: warnAboutAccessingKey,
+				configurable: !0
+			});
+		}
+		function elementRefGetterWithDeprecationWarning() {
+			var componentName = getComponentNameFromType(this.type);
+			didWarnAboutElementRef[componentName] || (didWarnAboutElementRef[componentName] = !0, console.error("Accessing element.ref was removed in React 19. ref is now a regular prop. It will be removed from the JSX Element type in a future release."));
+			componentName = this.props.ref;
+			return void 0 !== componentName ? componentName : null;
+		}
+		function ReactElement(type, key, props, owner, debugStack, debugTask) {
+			var refProp = props.ref;
+			type = {
+				$$typeof: REACT_ELEMENT_TYPE,
+				type,
+				key,
+				props,
+				_owner: owner
+			};
+			null !== (void 0 !== refProp ? refProp : null) ? Object.defineProperty(type, "ref", {
+				enumerable: !1,
+				get: elementRefGetterWithDeprecationWarning
+			}) : Object.defineProperty(type, "ref", {
+				enumerable: !1,
+				value: null
+			});
+			type._store = {};
+			Object.defineProperty(type._store, "validated", {
+				configurable: !1,
+				enumerable: !1,
+				writable: !0,
+				value: 0
+			});
+			Object.defineProperty(type, "_debugInfo", {
+				configurable: !1,
+				enumerable: !1,
+				writable: !0,
+				value: null
+			});
+			Object.defineProperty(type, "_debugStack", {
+				configurable: !1,
+				enumerable: !1,
+				writable: !0,
+				value: debugStack
+			});
+			Object.defineProperty(type, "_debugTask", {
+				configurable: !1,
+				enumerable: !1,
+				writable: !0,
+				value: debugTask
+			});
+			Object.freeze && (Object.freeze(type.props), Object.freeze(type));
+			return type;
+		}
+		function jsxDEVImpl(type, config, maybeKey, isStaticChildren, debugStack, debugTask) {
+			var children = config.children;
+			if (void 0 !== children) if (isStaticChildren) if (isArrayImpl(children)) {
+				for (isStaticChildren = 0; isStaticChildren < children.length; isStaticChildren++) validateChildKeys(children[isStaticChildren]);
+				Object.freeze && Object.freeze(children);
+			} else console.error("React.jsx: Static children should always be an array. You are likely explicitly calling React.jsxs or React.jsxDEV. Use the Babel transform instead.");
+			else validateChildKeys(children);
+			if (hasOwnProperty.call(config, "key")) {
+				children = getComponentNameFromType(type);
+				var keys = Object.keys(config).filter(function(k) {
+					return "key" !== k;
+				});
+				isStaticChildren = 0 < keys.length ? "{key: someKey, " + keys.join(": ..., ") + ": ...}" : "{key: someKey}";
+				didWarnAboutKeySpread[children + isStaticChildren] || (keys = 0 < keys.length ? "{" + keys.join(": ..., ") + ": ...}" : "{}", console.error("A props object containing a \"key\" prop is being spread into JSX:\n  let props = %s;\n  <%s {...props} />\nReact keys must be passed directly to JSX without using spread:\n  let props = %s;\n  <%s key={someKey} {...props} />", isStaticChildren, children, keys, children), didWarnAboutKeySpread[children + isStaticChildren] = !0);
+			}
+			children = null;
+			void 0 !== maybeKey && (checkKeyStringCoercion(maybeKey), children = "" + maybeKey);
+			hasValidKey(config) && (checkKeyStringCoercion(config.key), children = "" + config.key);
+			if ("key" in config) {
+				maybeKey = {};
+				for (var propName in config) "key" !== propName && (maybeKey[propName] = config[propName]);
+			} else maybeKey = config;
+			children && defineKeyPropWarningGetter(maybeKey, "function" === typeof type ? type.displayName || type.name || "Unknown" : type);
+			return ReactElement(type, children, maybeKey, getOwner(), debugStack, debugTask);
+		}
+		function validateChildKeys(node) {
+			isValidElement(node) ? node._store && (node._store.validated = 1) : "object" === typeof node && null !== node && node.$$typeof === REACT_LAZY_TYPE && ("fulfilled" === node._payload.status ? isValidElement(node._payload.value) && node._payload.value._store && (node._payload.value._store.validated = 1) : node._store && (node._store.validated = 1));
+		}
+		function isValidElement(object) {
+			return "object" === typeof object && null !== object && object.$$typeof === REACT_ELEMENT_TYPE;
+		}
+		var React = __require("react"), REACT_ELEMENT_TYPE = Symbol.for("react.transitional.element"), REACT_PORTAL_TYPE = Symbol.for("react.portal"), REACT_FRAGMENT_TYPE = Symbol.for("react.fragment"), REACT_STRICT_MODE_TYPE = Symbol.for("react.strict_mode"), REACT_PROFILER_TYPE = Symbol.for("react.profiler"), REACT_CONSUMER_TYPE = Symbol.for("react.consumer"), REACT_CONTEXT_TYPE = Symbol.for("react.context"), REACT_FORWARD_REF_TYPE = Symbol.for("react.forward_ref"), REACT_SUSPENSE_TYPE = Symbol.for("react.suspense"), REACT_SUSPENSE_LIST_TYPE = Symbol.for("react.suspense_list"), REACT_MEMO_TYPE = Symbol.for("react.memo"), REACT_LAZY_TYPE = Symbol.for("react.lazy"), REACT_ACTIVITY_TYPE = Symbol.for("react.activity"), REACT_CLIENT_REFERENCE = Symbol.for("react.client.reference"), ReactSharedInternals = React.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE, hasOwnProperty = Object.prototype.hasOwnProperty, isArrayImpl = Array.isArray, createTask = console.createTask ? console.createTask : function() {
+			return null;
+		};
+		React = { react_stack_bottom_frame: function(callStackForError) {
+			return callStackForError();
+		} };
+		var specialPropKeyWarningShown;
+		var didWarnAboutElementRef = {};
+		var unknownOwnerDebugStack = React.react_stack_bottom_frame.bind(React, UnknownOwner)();
+		var unknownOwnerDebugTask = createTask(getTaskName(UnknownOwner));
+		var didWarnAboutKeySpread = {};
+		exports.Fragment = REACT_FRAGMENT_TYPE;
+		exports.jsx = function(type, config, maybeKey) {
+			var trackActualOwner = 1e4 > ReactSharedInternals.recentlyCreatedOwnerStacks++;
+			return jsxDEVImpl(type, config, maybeKey, !1, trackActualOwner ? Error("react-stack-top-frame") : unknownOwnerDebugStack, trackActualOwner ? createTask(getTaskName(type)) : unknownOwnerDebugTask);
+		};
+		exports.jsxs = function(type, config, maybeKey) {
+			var trackActualOwner = 1e4 > ReactSharedInternals.recentlyCreatedOwnerStacks++;
+			return jsxDEVImpl(type, config, maybeKey, !0, trackActualOwner ? Error("react-stack-top-frame") : unknownOwnerDebugStack, trackActualOwner ? createTask(getTaskName(type)) : unknownOwnerDebugTask);
+		};
+	})();
+}) });
+
+//#endregion
+//#region ../../node_modules/.pnpm/react@19.2.0/node_modules/react/jsx-runtime.js
+var require_jsx_runtime = /* @__PURE__ */ __commonJS({ "../../node_modules/.pnpm/react@19.2.0/node_modules/react/jsx-runtime.js": ((exports, module) => {
+	module.exports = require_react_jsx_runtime_development();
+}) });
+
+//#endregion
+//#region src/components/show_html.tsx
+var import_jsx_runtime = /* @__PURE__ */ __toESM(require_jsx_runtime());
+/**
+* A component that displays the HTML of a subject element.
+* Uses `htmlfy` internally to format and prettify the HTML output.
+*
+* @param selector - CSS selector to find the subject element. Defaults to '[data-testid="subject"]'
+* @param config - Configuration options passed to htmlfy's prettify function
+* @param props - Additional props (className, style) passed to the pre element
+* @returns A pre element containing the formatted HTML
+*/
+function ShowHtml({ selector = "[data-testid=\"subject\"]", config, ...props }) {
+	const [html, setHtml] = useState("");
+	useEffect(() => {
+		const subject = document.querySelector(selector);
+		if (subject) setHtml(prettify(subject.outerHTML, {
+			tag_wrap: 40,
+			...config
+		}));
+		else setHtml("No subject found");
+	}, [selector]);
+	return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("pre", {
+		...props,
+		children: html
+	});
+}
+
+//#endregion
+//#region src/decorators/show_doc_source.tsx
+const channel = addons.getChannel();
+/**
+* A decorator that shows the source code of a story above the rendered story.
+* The source code is taken from the story's `parameters.docs.source.code`.
+*/
+function showDocSource() {
+	return (Story, { parameters: { docs, darkMode } }) => {
+		const storedItem = window.localStorage.getItem("sb-addon-themes-3");
+		const current = typeof storedItem === "string" ? JSON.parse(storedItem).current : darkMode?.current;
+		const [isDark, setIsDark] = useState((darkMode?.stylePreview && current === "dark") ?? false);
+		useEffect(() => {
+			channel.on("DARK_MODE", setIsDark);
+			return () => channel.off("DARK_MODE", setIsDark);
+		}, []);
+		return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(ThemeProvider, {
+			theme: convert(docs?.theme ?? (isDark ? themes.dark : themes.light)),
+			children: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("section", {
+				style: {
+					display: "flex",
+					flexDirection: "column",
+					gap: "1rem"
+				},
+				children: [/* @__PURE__ */ (0, import_jsx_runtime.jsx)(SyntaxHighlighter, {
+					language: docs?.source?.language,
+					children: docs?.source?.code
+				}), /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Story, {})]
+			})
+		});
+	};
+}
+
+//#endregion
+//#region src/parameters/define_actions_param.ts
+/**
+* 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
+*/
+function defineActionsParam(actions) {
+	return { actions };
+}
+
+//#endregion
+//#region src/parameters/define_backgrounds_param.ts
+/**
+* Defines backgrounds parameters for Storybook stories.
+*
+* @param backgrounds - The backgrounds configuration
+* @returns An object containing the backgrounds parameter configuration
+*/
+const defineBackgroundsParam = (backgrounds) => ({ backgrounds });
+
+//#endregion
+//#region src/parameters/define_docs_param.ts
+/**
+* Defines docs parameters for Storybook stories.
+*
+* @param docs - Configuration for docs parameters including options for:
+* - Controls display and sorting
+* - Story rendering (autoplay, height, inline vs iframe)
+* - And other docs-related settings
+* @returns An object containing the docs parameter configuration
+*
+* @example
+* ```ts
+* import { defineDocsParam } from '@repobuddy/storybook'
+*
+* export default {
+*   parameters: defineDocsParam({
+*     controls: {
+*       sort: 'alpha',
+*       exclude: ['internal*']
+*     },
+*     story: {
+*       inline: true,
+*       height: '400px'
+*     }
+*   })
+* }
+* ```
+*/
+function defineDocsParam(docs) {
+	return { docs };
+}
+
+//#endregion
+//#region src/parameters/define_layout_param.ts
+/**
+* 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')
+* }
+* ```
+*/
+const defineLayoutParam = (layout) => ({ layout });
+
+//#endregion
+//#region src/parameters/define_parameters.ts
+/**
+* Defines parameters for Storybook stories, combining built-in parameters with custom ones.
+*
+* @param parameters - Configuration object containing both built-in Storybook parameters and custom parameters
+* @returns The combined parameters object
+*
+* @example
+* ```ts
+* import { defineParameters } from '@repobuddy/storybook'
+*
+* export default {
+*   parameters: defineParameters({
+*     // Built-in parameters
+*     layout: 'centered',
+*     backgrounds: {
+*       default: 'light',
+*       values: [
+*         { name: 'light', value: '#ffffff' },
+*         { name: 'dark', value: '#333333' }
+*       ]
+*     },
+*     // Custom parameters
+*     myCustomParam: {
+*       someValue: true
+*     }
+*   })
+* }
+* ```
+*/
+function defineParameters(param, ...rest) {
+	return rest.reduce((acc, param$1) => Object.assign(acc, param$1), param);
+}
+
+//#endregion
+//#region src/parameters/define_test_param.ts
+/**
+* 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
+* })
+*/
+function defineTestParam(test) {
+	return { test };
+}
+
+//#endregion
+//#region src/parameters/define_viewport_param.ts
+/**
+* Defines viewport parameters for Storybook stories.
+*
+* @see https://storybook.js.org/docs/api/parameters#viewport
+*
+* @param viewport - Configuration for viewport parameters including:
+* - viewports: Custom viewport definitions
+* - defaultViewport: The default viewport to use
+* - defaultOrientation: Default orientation (landscape/portrait)
+* - disabled: Whether viewport controls are disabled
+* @returns An object containing the viewport parameter configuration
+*
+* @example
+* ```ts
+* defineViewportParam({
+*   viewports: {
+*     mobile: {
+*       name: 'Mobile',
+*       styles: { width: '320px', height: '568px' },
+*       type: 'mobile'
+*     }
+*   },
+*   defaultViewport: 'mobile',
+*   defaultOrientation: 'portrait'
+* })
+* ```
+*/
+function defineViewportParam(viewport) {
+	return { viewport };
+}
+
+//#endregion
+//#region src/testing/decorators/when_running_in_text.ctx.ts
+const ctx = { isRunningInTest };
+
+//#endregion
+//#region src/testing/decorators/when_running_in_test.tsx
+/**
+* executes the specified decorator or handler if the code is running in test.
+*/
+function whenRunningInTest(decoratorOrHandler) {
+	return function RunInTest(Story, context) {
+		return ctx.isRunningInTest() ? decoratorOrHandler(Story, context) ?? /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Story, {}) : /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Story, {});
+	};
+}
+
+//#endregion
+export { ShowHtml, defineActionsParam, defineBackgroundsParam, defineDocsParam, defineLayoutParam, defineParameters, defineTestParam, defineViewportParam, showDocSource, whenRunningInTest };

package/esm/manager/index.d.ts

@@ -1 +1,38 @@
-export * from './brand_title.js';
+//#region src/manager/brand_title.d.ts
+interface BrandTitleOptions {
+  /**
+   * The title to display in the brand title.
+   * It can be a simple string or raw HTML.
+   */
+  title: string;
+  /**
+   * The logo to display in the brand title.
+   * It can be a simple string or raw HTML (e.g. `<svg>`).
+   */
+  logo?: string | undefined;
+}
+/**
+ * Creates a brand title element for the Storybook manager UI.
+ *
+ * @param options - The options for customizing the brand title
+ * @param options.title - The title text or HTML to display
+ * @param options.logo - Optional logo HTML to display before the title
+ * @returns An HTML string containing the brand title element
+ *
+ * @example
+ *
+ * ```ts
+ * import { brandTitle } from '@repobuddy/storybook'
+ * import { addons } from 'storybook/manager-api'
+ *
+ * addons.setConfig({
+ *   brandTitle: brandTitle({
+ *     title: 'My Storybook',
+ *     logo: '<img src="logo.png" alt="Logo" width="24" height="24">'
+ *   })
+ * })
+ * ```
+ */
+declare function brandTitle(options: BrandTitleOptions): string;
+//#endregion
+export { BrandTitleOptions, brandTitle };

package/esm/manager/index.js

@@ -1 +1,32 @@
-export * from "./brand_title.js";
+//#region src/manager/brand_title.ts
+/**
+* Creates a brand title element for the Storybook manager UI.
+*
+* @param options - The options for customizing the brand title
+* @param options.title - The title text or HTML to display
+* @param options.logo - Optional logo HTML to display before the title
+* @returns An HTML string containing the brand title element
+*
+* @example
+*
+* ```ts
+* import { brandTitle } from '@repobuddy/storybook'
+* import { addons } from 'storybook/manager-api'
+*
+* addons.setConfig({
+*   brandTitle: brandTitle({
+*     title: 'My Storybook',
+*     logo: '<img src="logo.png" alt="Logo" width="24" height="24">'
+*   })
+* })
+* ```
+*/
+function brandTitle(options) {
+	return `<span style="display: flex; align-items: center; gap: 2px;">
+		${options.logo ?? ""}
+		${options.title}
+	</span>`;
+}
+
+//#endregion
+export { brandTitle };

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

@@ -1,2 +1,95 @@
-export * from './tag_badges.js';
-export type * from './types.js';
+import { TagBadgeParameters } from "storybook-addon-tag-badges/manager-helpers";
+import { Args, Meta as Meta$1, StoryObj as StoryObj$1 } from "@storybook/react-vite";
+
+//#region src/storybook-addon-tag-badges/tag_badges.d.ts
+type TagBadgeParameter = TagBadgeParameters[0];
+/**
+ * Type representing the names of predefined tags used in Storybook stories.
+ */
+type TagNames = 'editor' | 'new' | 'beta' | 'props' | 'deprecated' | 'outdated' | 'danger' | 'todo' | 'code-only' | 'snapshot' | 'unit' | 'integration' | 'keyboard' | 'internal';
+/**
+ * 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`.
+ */
+declare const editorBadge: TagBadgeParameter;
+declare const newBadge: TagBadgeParameter;
+declare const betaBadge: TagBadgeParameter;
+declare const propsBadge: TagBadgeParameter;
+declare const deprecatedBadge: TagBadgeParameter;
+declare const outdatedBadge: TagBadgeParameter;
+declare const dangerBadge: TagBadgeParameter;
+declare const todoBadge: TagBadgeParameter;
+declare const codeOnlyBadge: TagBadgeParameter;
+declare const snapshotBadge: TagBadgeParameter;
+declare const unitBadge: TagBadgeParameter;
+declare const integrationBadge: TagBadgeParameter;
+declare const keyboardBadge: TagBadgeParameter;
+declare const internalBadge: TagBadgeParameter;
+declare const tagBadges: TagBadgeParameters;
+//#endregion
+//#region src/types.d.ts
+/**
+ * Extends the Storybook Meta type with custom tag types
+ * @template TCmpOrArgs - The component or args type
+ * @template M - The base Meta type
+ * @template E - The extension type containing tagType
+ *
+ * @example
+ * ```ts
+ * // Create a generic Meta type for a project
+ * type Meta<TCmpOrArgs = Args> = ExtendMeta<TCmpOrArgs, Meta<TCmpOrArgs>, { tagType: 'tag1' | 'tag2' }>
+ *
+ * // Create a specific Meta type for a component
+ * type Meta = ExtendMeta<typeof Component, Meta<typeof Component>, { tagType: 'tag1' | 'tag2' }>
+ * ```
+ */
+type ExtendMeta<TCmpOrArgs, M extends Meta$1<TCmpOrArgs>, E extends {
+  tag: string;
+}> = Omit<M, 'tags'> & {
+  tags?: Array<E['tag'] | (string & {})> | undefined;
+};
+/**
+ * Extends the Storybook StoryObj type with custom tag types
+ * @template TMetaOrCmpOrArgs - The meta, component or args type
+ * @template S - The base StoryObj type
+ * @template E - The extension type containing tagType
+ *
+ * @example
+ * ```ts
+ * // Create a generic StoryObj type for a project
+ * type StoryObj<TMetaOrCmpOrArgs = Args> = ExtendStoryObj<TMetaOrCmpOrArgs, StoryObj<TMetaOrCmpOrArgs>, { tagType: 'tag1' | 'tag2' }>
+ *
+ * // Create a specific StoryObj type for a component
+ * type StoryObj = ExtendStoryObj<typeof Component, StoryObj<typeof Component>, { tagType: 'tag1' | 'tag2' }>
+ * ```
+ */
+type ExtendStoryObj<TMetaOrCmpOrArgs, S extends StoryObj$1<TMetaOrCmpOrArgs>, E extends {
+  tag: string;
+}> = Omit<S, 'tags'> & {
+  tags?: Array<E['tag'] | (string & {})> | undefined;
+};
+//#endregion
+//#region src/storybook-addon-tag-badges/types.d.ts
+type Meta<TCmpOrArgs = Args> = ExtendMeta<TCmpOrArgs, Meta$1<TCmpOrArgs>, {
+  tag: TagNames;
+}>;
+type StoryObj<TMetaOrCmpOrArgs = Args> = ExtendStoryObj<TMetaOrCmpOrArgs, StoryObj$1<TMetaOrCmpOrArgs>, {
+  tag: TagNames;
+}>;
+//#endregion
+export { Meta, StoryObj, TagNames, betaBadge, codeOnlyBadge, dangerBadge, deprecatedBadge, editorBadge, integrationBadge, internalBadge, keyboardBadge, newBadge, outdatedBadge, propsBadge, snapshotBadge, tagBadges, todoBadge, unitBadge };