@storybook/addon-docs 0.0.0-pr-30457-sha-e6b0c6dc → 0.0.0-pr-30516-sha-0cd4ee4f

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -1,217 +1,10 @@
1
- import * as core_dist_types from 'storybook/internal/types';
2
1
  export * from '@storybook/blocks';
3
- import { Renderer as Renderer$1, DocsRenderFunction, ModuleExports, ModuleExport } from 'storybook/internal/types';
2
+ import { Renderer, DocsRenderFunction } from 'storybook/internal/types';
4
3
 
5
- declare global {
6
- interface SymbolConstructor {
7
- readonly observable: symbol;
8
- }
9
- }
10
-
11
- interface Renderer {
12
- /** What is the type of the `component` annotation in this renderer? */
13
- component: any;
14
- /** What does the story function return in this renderer? */
15
- storyResult: any;
16
- /** What type of element does this renderer render to? */
17
- canvasElement: any;
18
- mount(): Promise<Canvas>;
19
- T?: unknown;
20
- }
21
- interface Canvas {
22
- }
23
-
24
- declare class DocsRenderer<TRenderer extends Renderer$1> {
4
+ declare class DocsRenderer<TRenderer extends Renderer> {
25
5
  render: DocsRenderFunction<TRenderer>;
26
6
  unmount: (element: HTMLElement) => void;
27
7
  constructor();
28
8
  }
29
9
 
30
- type StoryBlockParameters = {
31
- /** Whether a story's play function runs when shown in docs page */
32
- autoplay?: boolean;
33
- /**
34
- * Set a minimum height (note for an iframe this is the actual height) when rendering a story in
35
- * an iframe or inline. This overrides `parameters.docs.story.iframeHeight` for iframes.
36
- */
37
- height?: string;
38
- /** IFrame configuration */
39
- iframeHeight?: string;
40
- /**
41
- * Whether the story is rendered inline (in the same browser frame as the other docs content) or
42
- * in an iframe
43
- */
44
- inline?: boolean;
45
- /** Specifies the CSF file to which the story is associated */
46
- meta: ModuleExports;
47
- /**
48
- * Specifies which story is rendered by the Story block. If no `of` is defined and the MDX file is
49
- * attached, the primary (first) story will be rendered.
50
- */
51
- of: ModuleExport;
52
- };
53
- type ControlsBlockParameters = {
54
- /** Exclude specific properties from the Controls panel */
55
- exclude?: string[] | RegExp;
56
- /** Exclude only specific properties in the Controls panel */
57
- include?: string[] | RegExp;
58
- /** Controls sorting order */
59
- sort?: 'none' | 'alpha' | 'requiredFirst';
60
- };
61
- type ArgTypesBlockParameters = {
62
- /** Exclude specific arg types from the args table */
63
- exclude?: string[] | RegExp;
64
- /** Exclude only specific arg types from the args table */
65
- include?: string[] | RegExp;
66
- /**
67
- * Specifies which story to get the arg types from. If a CSF file exports is provided, it will use
68
- * the primary (first) story in the file.
69
- */
70
- of: ModuleExport | ModuleExports;
71
- /**
72
- * Controls arg types order
73
- *
74
- * @see https://storybook.js.org/docs/api/doc-blocks/doc-block-argtypes#sort
75
- */
76
- sort?: 'none' | 'alpha' | 'requiredFirst';
77
- };
78
- type CanvasBlockParameters = {
79
- /**
80
- * Provides any additional custom actions to show in the bottom right corner. These are simple
81
- * buttons that do anything you specify in the onClick function.
82
- */
83
- additionalActions?: {
84
- className?: string;
85
- disabled?: boolean;
86
- onClick: () => void;
87
- title: string | JSX.Element;
88
- }[];
89
- /** Provide HTML class(es) to the preview element, for custom styling. */
90
- className?: string;
91
- /**
92
- * Specify how the canvas should layout the story.
93
- *
94
- * @see https://storybook.js.org/docs/api/doc-blocks/doc-block-canvas#layout
95
- */
96
- layout?: 'centered' | 'fullscreen' | 'padded';
97
- /** Specifies which story is rendered */
98
- of: ModuleExport;
99
- /** Show story source code */
100
- sourceState?: 'hidden' | 'shown';
101
- /**
102
- * Story configuration
103
- *
104
- * @see https://storybook.js.org/docs/api/doc-blocks/doc-block-canvas#story
105
- */
106
- story?: StoryBlockParameters;
107
- /** Disable story source code */
108
- withSource?: 'open' | 'closed' | 'none';
109
- /** Whether to render a toolbar containing tools to interact with the story. */
110
- withToolbar?: 'open' | 'closed' | 'none';
111
- };
112
- type DescriptionBlockParameters = {
113
- /** Component description */
114
- component?: string;
115
- /** Story description */
116
- story?: string;
117
- };
118
- type SourceBlockParameters = {
119
- /** The source code to be rendered. Will be inferred if not passed */
120
- code?: string;
121
- /** Whether to render the code in dark mode */
122
- dark?: boolean;
123
- /** Determines if decorators are rendered in the source code snippet. */
124
- excludeDecorators?: boolean;
125
- /**
126
- * The formatting used on source code. Both true and 'dedent' have the same effect of removing any
127
- * extraneous indentation. Supports all valid prettier parser names.
128
- *
129
- * @see https://storybook.js.org/docs/api/doc-blocks/doc-block-source#format
130
- */
131
- format?: boolean | 'dedent' | string;
132
- /** Source code language */
133
- language?: 'bash' | 'css' | 'graphql' | 'html' | 'json' | 'jsextra' | 'jsx' | 'md' | 'text' | 'tsx' | 'typescript' | 'yml';
134
- /**
135
- * Specifies which story is rendered by the Source block. If no of is defined and the MDX file is
136
- * attached, the primary (first) story will be rendered.
137
- */
138
- of: ModuleExport;
139
- /** Source code transformations */
140
- transform?: (code: string, storyContext: any) => string;
141
- /**
142
- * Specifies how the source code is rendered.
143
- *
144
- * @default 'auto'
145
- * @see https://storybook.js.org/docs/api/doc-blocks/doc-block-source#type
146
- */
147
- type?: 'auto' | 'code' | 'dynamic';
148
- };
149
- interface DocsParameters {
150
- /**
151
- * Docs configuration
152
- *
153
- * @see https://storybook.js.org/docs/writing-docs
154
- */
155
- docs?: {
156
- /**
157
- * The subtitle displayed when shown in docs page
158
- *
159
- * @see https://storybook.js.org/docs/api/doc-blocks/doc-block-argtypes
160
- */
161
- argTypes?: ArgTypesBlockParameters;
162
- /**
163
- * Canvas configuration when shown in docs page
164
- *
165
- * @see https://storybook.js.org/docs/api/doc-blocks/doc-block-canvas
166
- */
167
- canvas?: CanvasBlockParameters;
168
- /**
169
- * Controls block configuration
170
- *
171
- * @see https://storybook.js.org/docs/api/doc-blocks/doc-block-controls
172
- */
173
- controls?: ControlsBlockParameters;
174
- /**
175
- * Component/story description when shown in docs page
176
- *
177
- * @see https://storybook.js.org/docs/api/doc-blocks/doc-block-description#writing-descriptions
178
- */
179
- description?: DescriptionBlockParameters;
180
- /** Remove the addon panel and disable the addon's behavior */
181
- disable?: boolean;
182
- /**
183
- * Replace the default documentation template used by Storybook with your own
184
- *
185
- * @see https://storybook.js.org/docs/writing-docs/autodocs#write-a-custom-template
186
- */
187
- page?: unknown;
188
- /**
189
- * Source code configuration when shown in docs page
190
- *
191
- * @see https://storybook.js.org/docs/api/doc-blocks/doc-block-source
192
- */
193
- source?: SourceBlockParameters;
194
- /**
195
- * Story configuration
196
- *
197
- * @see https://storybook.js.org/docs/api/doc-blocks/doc-block-story
198
- */
199
- story?: StoryBlockParameters;
200
- /**
201
- * The subtitle displayed when shown in docs page
202
- *
203
- * @see https://storybook.js.org/docs/api/doc-blocks/doc-block-subtitle
204
- */
205
- subtitle?: string;
206
- /**
207
- * The title displayed when shown in docs page
208
- *
209
- * @see https://storybook.js.org/docs/api/doc-blocks/doc-block-title
210
- */
211
- title?: string;
212
- };
213
- }
214
-
215
- declare const _default: () => core_dist_types.ProjectAnnotations<Renderer>;
216
-
217
- export { DocsParameters, DocsRenderer, _default as default };
10
+ export { DocsRenderer };
package/dist/index.js CHANGED
@@ -1 +1 @@
1
- "use strict";var __create=Object.create;var __defProp=Object.defineProperty;var __getOwnPropDesc=Object.getOwnPropertyDescriptor;var __getOwnPropNames=Object.getOwnPropertyNames;var __getProtoOf=Object.getPrototypeOf,__hasOwnProp=Object.prototype.hasOwnProperty;var __esm=(fn,res)=>function(){return fn&&(res=(0,fn[__getOwnPropNames(fn)[0]])(fn=0)),res};var __export=(target,all)=>{for(var name in all)__defProp(target,name,{get:all[name],enumerable:!0})},__copyProps=(to,from,except,desc)=>{if(from&&typeof from=="object"||typeof from=="function")for(let key of __getOwnPropNames(from))!__hasOwnProp.call(to,key)&&key!==except&&__defProp(to,key,{get:()=>from[key],enumerable:!(desc=__getOwnPropDesc(from,key))||desc.enumerable});return to},__reExport=(target,mod,secondTarget)=>(__copyProps(target,mod,"default"),secondTarget&&__copyProps(secondTarget,mod,"default")),__toESM=(mod,isNodeMode,target)=>(target=mod!=null?__create(__getProtoOf(mod)):{},__copyProps(isNodeMode||!mod||!mod.__esModule?__defProp(target,"default",{value:mod,enumerable:!0}):target,mod)),__toCommonJS=mod=>__copyProps(__defProp({},"__esModule",{value:!0}),mod);var DocsRenderer_exports={};__export(DocsRenderer_exports,{DocsRenderer:()=>DocsRenderer,defaultComponents:()=>defaultComponents});var import_react,import_blocks,import_react_dom_shim,defaultComponents,ErrorBoundary,DocsRenderer,init_DocsRenderer=__esm({"src/DocsRenderer.tsx"(){"use strict";import_react=__toESM(require("react")),import_blocks=require("@storybook/blocks"),import_react_dom_shim=require("@storybook/react-dom-shim"),defaultComponents={code:import_blocks.CodeOrSourceMdx,a:import_blocks.AnchorMdx,...import_blocks.HeadersMdx},ErrorBoundary=class extends import_react.Component{constructor(){super(...arguments);this.state={hasError:!1}}static getDerivedStateFromError(){return{hasError:!0}}componentDidCatch(err){let{showException}=this.props;showException(err)}render(){let{hasError}=this.state,{children}=this.props;return hasError?null:import_react.default.createElement(import_react.default.Fragment,null,children)}},DocsRenderer=class{constructor(){this.render=async(context,docsParameter,element)=>{let components={...defaultComponents,...docsParameter?.components},TDocs=import_blocks.Docs;return new Promise((resolve,reject)=>{import("@mdx-js/react").then(({MDXProvider})=>(0,import_react_dom_shim.renderElement)(import_react.default.createElement(ErrorBoundary,{showException:reject,key:Math.random()},import_react.default.createElement(MDXProvider,{components},import_react.default.createElement(TDocs,{context,docsParameter}))),element)).then(()=>resolve())})},this.unmount=element=>{(0,import_react_dom_shim.unmountElement)(element)}}}}});var src_exports={};__export(src_exports,{DocsRenderer:()=>DocsRenderer,default:()=>src_default});module.exports=__toCommonJS(src_exports);var import_preview_api=require("storybook/internal/preview-api");var preview_exports={};__export(preview_exports,{parameters:()=>parameters});var excludeTags=Object.entries(globalThis.TAGS_OPTIONS??{}).reduce((acc,entry)=>{let[tag,option]=entry;return option.excludeFromDocsStories&&(acc[tag]=!0),acc},{}),parameters={docs:{renderer:async()=>{let{DocsRenderer:DocsRenderer2}=await Promise.resolve().then(()=>(init_DocsRenderer(),DocsRenderer_exports));return new DocsRenderer2},stories:{filter:story=>(story.tags||[]).filter(tag=>excludeTags[tag]).length===0&&!story.parameters.docs?.disable}}};__reExport(src_exports,require("@storybook/blocks"),module.exports);init_DocsRenderer();var src_default=()=>(0,import_preview_api.definePreview)(preview_exports);0&&(module.exports={DocsRenderer,...require("@storybook/blocks")});
1
+ "use strict";var __create=Object.create;var __defProp=Object.defineProperty;var __getOwnPropDesc=Object.getOwnPropertyDescriptor;var __getOwnPropNames=Object.getOwnPropertyNames;var __getProtoOf=Object.getPrototypeOf,__hasOwnProp=Object.prototype.hasOwnProperty;var __export=(target,all)=>{for(var name in all)__defProp(target,name,{get:all[name],enumerable:!0})},__copyProps=(to,from,except,desc)=>{if(from&&typeof from=="object"||typeof from=="function")for(let key of __getOwnPropNames(from))!__hasOwnProp.call(to,key)&&key!==except&&__defProp(to,key,{get:()=>from[key],enumerable:!(desc=__getOwnPropDesc(from,key))||desc.enumerable});return to},__reExport=(target,mod,secondTarget)=>(__copyProps(target,mod,"default"),secondTarget&&__copyProps(secondTarget,mod,"default")),__toESM=(mod,isNodeMode,target)=>(target=mod!=null?__create(__getProtoOf(mod)):{},__copyProps(isNodeMode||!mod||!mod.__esModule?__defProp(target,"default",{value:mod,enumerable:!0}):target,mod)),__toCommonJS=mod=>__copyProps(__defProp({},"__esModule",{value:!0}),mod);var src_exports={};__export(src_exports,{DocsRenderer:()=>DocsRenderer});module.exports=__toCommonJS(src_exports);__reExport(src_exports,require("@storybook/blocks"),module.exports);var import_react=__toESM(require("react")),import_blocks=require("@storybook/blocks"),import_react_dom_shim=require("@storybook/react-dom-shim"),defaultComponents={code:import_blocks.CodeOrSourceMdx,a:import_blocks.AnchorMdx,...import_blocks.HeadersMdx},ErrorBoundary=class extends import_react.Component{constructor(){super(...arguments);this.state={hasError:!1}}static getDerivedStateFromError(){return{hasError:!0}}componentDidCatch(err){let{showException}=this.props;showException(err)}render(){let{hasError}=this.state,{children}=this.props;return hasError?null:import_react.default.createElement(import_react.default.Fragment,null,children)}},DocsRenderer=class{constructor(){this.render=async(context,docsParameter,element)=>{let components={...defaultComponents,...docsParameter?.components},TDocs=import_blocks.Docs;return new Promise((resolve,reject)=>{import("@mdx-js/react").then(({MDXProvider})=>(0,import_react_dom_shim.renderElement)(import_react.default.createElement(ErrorBoundary,{showException:reject,key:Math.random()},import_react.default.createElement(MDXProvider,{components},import_react.default.createElement(TDocs,{context,docsParameter}))),element)).then(()=>resolve())})},this.unmount=element=>{(0,import_react_dom_shim.unmountElement)(element)}}};0&&(module.exports={DocsRenderer,...require("@storybook/blocks")});
package/dist/index.mjs CHANGED
@@ -1,9 +1,3 @@
1
- import { preview_exports } from './chunk-PRSJUHPQ.mjs';
2
1
  export { DocsRenderer } from './chunk-NUUEMKO5.mjs';
3
2
  import './chunk-H6MOWX77.mjs';
4
- import { definePreview } from 'storybook/internal/preview-api';
5
3
  export * from '@storybook/blocks';
6
-
7
- var src_default=()=>definePreview(preview_exports);
8
-
9
- export { src_default as default };