@fluentui/react-storybook-addon 0.4.0 → 0.4.1

package/lib/docs/FluentDocsPage.js

@@ -0,0 +1,296 @@
+import * as React from 'react';
+import { DocsContext, ArgsTable, Title, Subtitle, Description, HeaderMdx, Primary, Stories } from '@storybook/addon-docs';
+import { tokens } from '@fluentui/react-theme';
+import { Link } from '@fluentui/react-link';
+import { Text } from '@fluentui/react-text';
+import { makeStyles } from '@griffel/react';
+import { InfoFilled } from '@fluentui/react-icons';
+import { DIR_ID, THEME_ID } from '../constants';
+import { themes } from '../theme';
+import { getDocsPageConfig } from './utils';
+import { DirSwitch } from './DirSwitch';
+import { ThemePicker } from './ThemePicker';
+import { Toc, nameToHash } from './Toc';
+const useStyles = makeStyles({
+    divider: {
+        height: '1px',
+        backgroundColor: '#e1dfdd',
+        border: '0px none',
+        margin: '48px 0px'
+    },
+    wrapper: {
+        display: 'flex',
+        gap: '16px'
+    },
+    toc: {
+        flexBasis: '200px',
+        flexShrink: 0,
+        [`@media screen and (max-width: 1000px)`]: {
+            display: 'none'
+        }
+    },
+    container: {
+        // without a width, this div grows wider than its parent
+        width: '200px',
+        flexGrow: 1
+    },
+    globalTogglesContainer: {
+        columnGap: tokens.spacingHorizontalXXXL,
+        display: 'flex'
+    },
+    description: {
+        display: 'grid',
+        gridTemplateColumns: '1fr min-content'
+    },
+    additionalInfoWrapper: {
+        display: 'flex',
+        flexDirection: 'column',
+        gap: tokens.spacingVerticalM
+    },
+    additionalInfo: {
+        display: 'flex',
+        flexDirection: 'column',
+        gap: tokens.spacingVerticalM,
+        border: `1px solid ${tokens.colorNeutralStroke1}`,
+        borderRadius: tokens.borderRadiusMedium,
+        padding: tokens.spacingHorizontalM,
+        margin: `0 ${tokens.spacingHorizontalM}`
+    },
+    additionalInfoIcon: {
+        alignSelf: 'center',
+        color: tokens.colorBrandForeground1,
+        fontSize: '24px',
+        marginRight: tokens.spacingHorizontalM
+    },
+    additionalInfoMessage: {
+        display: 'flex',
+        flexDirection: 'row',
+        alignItems: 'center',
+        gap: tokens.spacingVerticalXS
+    },
+    infoIcon: {
+        display: 'flex',
+        flexDirection: 'column',
+        gap: tokens.spacingVerticalXS,
+        flex: 1
+    }
+});
+const useVideoClasses = makeStyles({
+    container: {
+        display: 'flex',
+        flexDirection: 'column',
+        gap: tokens.spacingHorizontalMNudge
+    },
+    preview: {
+        borderRadius: tokens.borderRadiusSmall,
+        display: 'flex',
+        flexDirection: 'column',
+        gap: tokens.spacingHorizontalM,
+        padding: tokens.spacingHorizontalM,
+        backgroundColor: tokens.colorNeutralBackground2,
+        ':hover': {
+            backgroundColor: tokens.colorNeutralBackground2Hover
+        }
+    },
+    image: {
+        width: '200px'
+    }
+});
+const VideoPreviews = (props)=>{
+    const { videos } = props;
+    const classes = useVideoClasses();
+    return /*#__PURE__*/ React.createElement("div", {
+        className: classes.container
+    }, videos.map((video)=>/*#__PURE__*/ React.createElement(Link, {
+            className: classes.preview,
+            href: video.href,
+            target: "_blank",
+            key: video.href
+        }, /*#__PURE__*/ React.createElement("img", {
+            alt: `Video: ${video.preview}`,
+            src: video.preview,
+            className: classes.image
+        }), /*#__PURE__*/ React.createElement(Text, null, video.title))));
+};
+const getNativeElementsList = (elements)=>{
+    const elementsArr = elements === null || elements === void 0 ? void 0 : elements.map((el, idx)=>[
+            /*#__PURE__*/ React.createElement("code", {
+                key: idx
+            }, `<${el}>`),
+            idx !== elements.length - 1 ? ', ' : ' '
+        ]);
+    return /*#__PURE__*/ React.createElement(React.Fragment, null, elementsArr, elementsArr.length > 1 ? 'elements' : 'element');
+};
+const slotRegex = /as\?:\s*"([^"]+)"/;
+/**
+ * NOTE: this function mutates original story argTypes including all story subcomponents if they are present
+ */ function withSlotEnhancer(story, options) {
+    var _story_argTypes_as_type, _story_argTypes_as;
+    const hasArgAsProp = options.nativePropsApi ? ((_story_argTypes_as = story.argTypes.as) === null || _story_argTypes_as === void 0 ? void 0 : (_story_argTypes_as_type = _story_argTypes_as.type) === null || _story_argTypes_as_type === void 0 ? void 0 : _story_argTypes_as_type.name) === 'enum' : false;
+    const argAsProp = hasArgAsProp ? story.argTypes.as.type.value : null;
+    let hasArgAsSlot = false;
+    const transformPropsWithSlotShorthand = (props)=>{
+        Object.entries(props).forEach(([key, argType])=>{
+            var _argType_type;
+            const value = argType === null || argType === void 0 ? void 0 : (_argType_type = argType.type) === null || _argType_type === void 0 ? void 0 : _argType_type.name;
+            // If DocGen was already transformed, skip the transformation but set hasArgAsSlot to true so that we can show the info message
+            if (value.includes('Slot')) {
+                hasArgAsSlot = true;
+                return;
+            }
+            // Initial Render Transformation for shorthand slot values (mutates DocGen Object reference)
+            if (value.includes('WithSlotShorthandValue')) {
+                hasArgAsSlot = true;
+                const match = value.match(slotRegex);
+                if (match) {
+                    props[key].type.name = `Slot<\"${match[1]}\">`;
+                } else {
+                    props[key].type.name = `Slot`;
+                }
+            }
+        });
+    };
+    const transformComponent = (component)=>{
+        var _component___docgenInfo;
+        const docGenProps = component === null || component === void 0 ? void 0 : (_component___docgenInfo = component.__docgenInfo) === null || _component___docgenInfo === void 0 ? void 0 : _component___docgenInfo.props;
+        if (docGenProps) {
+            transformPropsWithSlotShorthand(docGenProps);
+        }
+    };
+    const component = story.component;
+    const subcomponents = story.subcomponents;
+    if (options.slotsApi) {
+        transformComponent(component);
+        if (subcomponents) {
+            Object.values(subcomponents).forEach((subcomponent)=>{
+                transformComponent(subcomponent);
+            });
+        }
+    }
+    return {
+        component,
+        hasArgAsSlot,
+        hasArgAsProp,
+        argAsProp
+    };
+}
+const AdditionalApiDocs = ({ children })=>{
+    const styles = useStyles();
+    return /*#__PURE__*/ React.createElement("div", {
+        className: styles.additionalInfo
+    }, /*#__PURE__*/ React.createElement("div", {
+        className: styles.additionalInfoMessage
+    }, /*#__PURE__*/ React.createElement(InfoFilled, {
+        className: styles.additionalInfoIcon
+    }), /*#__PURE__*/ React.createElement("div", {
+        className: styles.infoIcon
+    }, children)));
+};
+const RenderArgsTable = ({ story, hideArgsTable, showSlotsApi, showNativePropsApi })=>{
+    const { component, hasArgAsProp, hasArgAsSlot, argAsProp } = withSlotEnhancer(story, {
+        slotsApi: showSlotsApi,
+        nativePropsApi: showNativePropsApi
+    });
+    const styles = useStyles();
+    return hideArgsTable ? null : /*#__PURE__*/ React.createElement(React.Fragment, null, /*#__PURE__*/ React.createElement("div", {
+        className: styles.additionalInfoWrapper
+    }, hasArgAsProp && /*#__PURE__*/ React.createElement(AdditionalApiDocs, null, /*#__PURE__*/ React.createElement("p", null, /*#__PURE__*/ React.createElement("b", null, "Native props are supported ", /*#__PURE__*/ React.createElement("span", {
+        role: "presentation"
+    }, "🙌"), /*#__PURE__*/ React.createElement("br", null)), /*#__PURE__*/ React.createElement("span", null, "All HTML attributes native to the", getNativeElementsList(argAsProp), ", including all ", /*#__PURE__*/ React.createElement("code", null, "aria-*"), " and ", /*#__PURE__*/ React.createElement("code", null, "data-*"), ' ', "attributes, can be applied as native props on this component."))), hasArgAsSlot && /*#__PURE__*/ React.createElement(AdditionalApiDocs, null, /*#__PURE__*/ React.createElement("p", null, /*#__PURE__*/ React.createElement("b", null, "Customizing components with slots ", /*#__PURE__*/ React.createElement("span", {
+        role: "presentation"
+    }, "🙌")), /*#__PURE__*/ React.createElement("br", null), /*#__PURE__*/ React.createElement("span", null, "Slots in Fluent UI React components are designed to be modified or replaced, providing a flexible approach to customizing components. Each slot is exposed as a top-level prop and can be filled with primitive values, JSX/TSX, props objects, or render functions. This allows for more dynamic and reusable component structures, similar to slots in other frameworks.", ' ', /*#__PURE__*/ React.createElement(Link, {
+        href: "/?path=/docs/concepts-developer-customizing-components-with-slots--docs"
+    }, "Customizing components with slots", ' '))))), /*#__PURE__*/ React.createElement(ArgsTable, {
+        of: component
+    }));
+};
+const RenderPrimaryStory = ({ primaryStory, skipPrimaryStory })=>{
+    const styles = useStyles();
+    return skipPrimaryStory ? null : /*#__PURE__*/ React.createElement(React.Fragment, null, /*#__PURE__*/ React.createElement("hr", {
+        className: styles.divider
+    }), /*#__PURE__*/ React.createElement(HeaderMdx, {
+        as: "h3",
+        id: nameToHash(primaryStory.name)
+    }, primaryStory.name), /*#__PURE__*/ React.createElement(Primary, null));
+};
+export const FluentDocsPage = ()=>{
+    var _primaryStoryContext_parameters, _primaryStoryContext_globals, _primaryStoryContext_parameters_docs, _primaryStoryContext_parameters1, _primaryStoryContext_parameters_docs1, _primaryStoryContext_parameters2, _primaryStoryContext_parameters3;
+    const context = React.useContext(DocsContext);
+    // Get the fluent docs page configuration from context
+    const docsPageConfig = getDocsPageConfig(context);
+    const stories = context.componentStories();
+    const primaryStory = stories[0];
+    const primaryStoryContext = context.getStoryContext(primaryStory);
+    assertStoryMetaValues(primaryStory);
+    var _primaryStoryContext_parameters_dir, _ref;
+    const dir = (_ref = (_primaryStoryContext_parameters_dir = (_primaryStoryContext_parameters = primaryStoryContext.parameters) === null || _primaryStoryContext_parameters === void 0 ? void 0 : _primaryStoryContext_parameters.dir) !== null && _primaryStoryContext_parameters_dir !== void 0 ? _primaryStoryContext_parameters_dir : (_primaryStoryContext_globals = primaryStoryContext.globals) === null || _primaryStoryContext_globals === void 0 ? void 0 : _primaryStoryContext_globals[DIR_ID]) !== null && _ref !== void 0 ? _ref : 'ltr';
+    const selectedTheme = themes.find((theme)=>theme.id === primaryStoryContext.globals[THEME_ID]);
+    const hideArgsTable = Boolean((_primaryStoryContext_parameters1 = primaryStoryContext.parameters) === null || _primaryStoryContext_parameters1 === void 0 ? void 0 : (_primaryStoryContext_parameters_docs = _primaryStoryContext_parameters1.docs) === null || _primaryStoryContext_parameters_docs === void 0 ? void 0 : _primaryStoryContext_parameters_docs.hideArgsTable);
+    const skipPrimaryStory = Boolean((_primaryStoryContext_parameters2 = primaryStoryContext.parameters) === null || _primaryStoryContext_parameters2 === void 0 ? void 0 : (_primaryStoryContext_parameters_docs1 = _primaryStoryContext_parameters2.docs) === null || _primaryStoryContext_parameters_docs1 === void 0 ? void 0 : _primaryStoryContext_parameters_docs1.skipPrimaryStory);
+    var _primaryStoryContext_parameters_videos;
+    const videos = (_primaryStoryContext_parameters_videos = (_primaryStoryContext_parameters3 = primaryStoryContext.parameters) === null || _primaryStoryContext_parameters3 === void 0 ? void 0 : _primaryStoryContext_parameters3.videos) !== null && _primaryStoryContext_parameters_videos !== void 0 ? _primaryStoryContext_parameters_videos : null;
+    const styles = useStyles();
+    // If docs page is disabled, return Storybook's default docs page
+    if (!docsPageConfig) {
+        return /*#__PURE__*/ React.createElement("div", {
+            className: "sb-unstyled"
+        }, /*#__PURE__*/ React.createElement(Title, null), /*#__PURE__*/ React.createElement(Subtitle, null), /*#__PURE__*/ React.createElement(Description, null), /*#__PURE__*/ React.createElement(RenderPrimaryStory, {
+            primaryStory: primaryStory,
+            skipPrimaryStory: skipPrimaryStory
+        }), /*#__PURE__*/ React.createElement(RenderArgsTable, {
+            story: primaryStory,
+            hideArgsTable: hideArgsTable
+        }), /*#__PURE__*/ React.createElement(Stories, null));
+    }
+    // Determine what to show based on configuration
+    const { tableOfContents: showTableOfContents, dirSwitcher: showDirSwitcher, themePicker: showThemePicker, argTable } = docsPageConfig;
+    // DEBUG
+    // console.log('FluentDocsPage', context);
+    // console.table(stories.map((s: StoreItem) => ({ id: s.id, kind: s.kind, name: s.name, story: s.story })));
+    // console.table(
+    //   Object.values((context as any).argTypes).map(arg => ({
+    //     name: arg.name,
+    //     description: arg.description,
+    //     type: arg.table?.type?.summary ?? '?',
+    //     default: arg.table?.defaultValue?.summary ?? '-',
+    //   })),
+    // );
+    return /*#__PURE__*/ React.createElement("div", {
+        className: "sb-unstyled"
+    }, /*#__PURE__*/ React.createElement(Title, null), /*#__PURE__*/ React.createElement("div", {
+        className: styles.wrapper
+    }, /*#__PURE__*/ React.createElement("div", {
+        className: styles.container
+    }, (showThemePicker || showDirSwitcher) && /*#__PURE__*/ React.createElement("div", {
+        className: styles.globalTogglesContainer
+    }, showThemePicker && /*#__PURE__*/ React.createElement(ThemePicker, {
+        selectedThemeId: selectedTheme === null || selectedTheme === void 0 ? void 0 : selectedTheme.id
+    }), showDirSwitcher && /*#__PURE__*/ React.createElement(DirSwitch, {
+        dir: dir
+    })), /*#__PURE__*/ React.createElement(Subtitle, null), /*#__PURE__*/ React.createElement("div", {
+        className: styles.description
+    }, /*#__PURE__*/ React.createElement(Description, null), videos && /*#__PURE__*/ React.createElement(VideoPreviews, {
+        videos: videos
+    })), /*#__PURE__*/ React.createElement(RenderPrimaryStory, {
+        primaryStory: primaryStory,
+        skipPrimaryStory: skipPrimaryStory
+    }), /*#__PURE__*/ React.createElement(RenderArgsTable, {
+        story: primaryStory,
+        hideArgsTable: hideArgsTable,
+        showSlotsApi: argTable.slotsApi,
+        showNativePropsApi: argTable.nativePropsApi
+    }), /*#__PURE__*/ React.createElement(Stories, null)), showTableOfContents && /*#__PURE__*/ React.createElement("div", {
+        className: styles.toc
+    }, /*#__PURE__*/ React.createElement(Toc, {
+        stories: stories
+    }))));
+};
+function assertStoryMetaValues(story) {
+    if (story.component === null) {
+        throw new Error([
+            '🚨 Invalid Story Meta declaration:',
+            `- primaryStory.component of componentId:${story.componentId} is "null"`,
+            '- to resolve this error, please update "component" property value in your story definition to reference a React Component or remove it if it is not needed.'
+        ].join('\n'));
+    }
+}

package/lib/docs/FluentDocsPage.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/docs/FluentDocsPage.tsx"],"sourcesContent":["import * as React from 'react';\nimport {\n  DocsContext,\n  ArgsTable,\n  Title,\n  Subtitle,\n  Description,\n  HeaderMdx,\n  Primary,\n  Stories,\n  type DocsContextProps,\n} from '@storybook/addon-docs';\nimport type { PreparedStory, Renderer, SBEnumType } from '@storybook/types';\n\nimport { tokens } from '@fluentui/react-theme';\nimport { Link } from '@fluentui/react-link';\nimport { Text } from '@fluentui/react-text';\nimport { makeStyles } from '@griffel/react';\nimport { InfoFilled } from '@fluentui/react-icons';\n\nimport { DIR_ID, THEME_ID } from '../constants';\nimport { themes } from '../theme';\n\nimport { getDocsPageConfig } from './utils';\nimport { DirSwitch } from './DirSwitch';\nimport { ThemePicker } from './ThemePicker';\nimport { Toc, nameToHash } from './Toc';\n\ntype PrimaryStory = PreparedStory<Renderer>;\n\nconst useStyles = makeStyles({\n  divider: {\n    height: '1px',\n    backgroundColor: '#e1dfdd',\n    border: '0px none',\n    margin: '48px 0px',\n  },\n  wrapper: {\n    display: 'flex',\n    gap: '16px',\n  },\n  toc: {\n    flexBasis: '200px',\n    flexShrink: 0,\n    [`@media screen and (max-width: 1000px)`]: {\n      display: 'none',\n    },\n  },\n  container: {\n    // without a width, this div grows wider than its parent\n    width: '200px',\n    flexGrow: 1,\n  },\n  globalTogglesContainer: {\n    columnGap: tokens.spacingHorizontalXXXL,\n    display: 'flex',\n  },\n  description: {\n    display: 'grid',\n    gridTemplateColumns: '1fr min-content',\n  },\n  additionalInfoWrapper: {\n    display: 'flex',\n    flexDirection: 'column',\n    gap: tokens.spacingVerticalM,\n  },\n  additionalInfo: {\n    display: 'flex',\n    flexDirection: 'column',\n    gap: tokens.spacingVerticalM,\n    border: `1px solid ${tokens.colorNeutralStroke1}`,\n    borderRadius: tokens.borderRadiusMedium,\n    padding: tokens.spacingHorizontalM,\n    margin: `0 ${tokens.spacingHorizontalM}`,\n  },\n  additionalInfoIcon: {\n    alignSelf: 'center',\n    color: tokens.colorBrandForeground1,\n    fontSize: '24px',\n    marginRight: tokens.spacingHorizontalM,\n  },\n  additionalInfoMessage: {\n    display: 'flex',\n    flexDirection: 'row',\n    alignItems: 'center',\n    gap: tokens.spacingVerticalXS,\n  },\n  infoIcon: {\n    display: 'flex',\n    flexDirection: 'column',\n    gap: tokens.spacingVerticalXS,\n    flex: 1,\n  },\n});\n\nconst useVideoClasses = makeStyles({\n  container: {\n    display: 'flex',\n    flexDirection: 'column',\n    gap: tokens.spacingHorizontalMNudge,\n  },\n  preview: {\n    borderRadius: tokens.borderRadiusSmall,\n    display: 'flex',\n    flexDirection: 'column',\n    gap: tokens.spacingHorizontalM,\n    padding: tokens.spacingHorizontalM,\n    backgroundColor: tokens.colorNeutralBackground2,\n\n    ':hover': {\n      backgroundColor: tokens.colorNeutralBackground2Hover,\n    },\n  },\n  image: {\n    width: '200px',\n  },\n});\n\nconst VideoPreviews: React.FC<{\n  videos: {\n    href: string;\n    preview: string;\n    source: 'youtube';\n    title: string;\n  }[];\n}> = props => {\n  const { videos } = props;\n  const classes = useVideoClasses();\n\n  return (\n    <div className={classes.container}>\n      {videos.map(video => (\n        <Link className={classes.preview} href={video.href} target=\"_blank\" key={video.href}>\n          <img alt={`Video: ${video.preview}`} src={video.preview} className={classes.image} />\n          <Text>{video.title}</Text>\n        </Link>\n      ))}\n    </div>\n  );\n};\n\nconst getNativeElementsList = (elements: SBEnumType['value']): React.ReactElement => {\n  const elementsArr = elements?.map((el, idx) => [\n    <code key={idx}>{`<${el}>`}</code>,\n    idx !== elements.length - 1 ? ', ' : ' ',\n  ]);\n\n  return (\n    <>\n      {elementsArr}\n      {elementsArr.length > 1 ? 'elements' : 'element'}\n    </>\n  );\n};\n\nconst slotRegex = /as\\?:\\s*\"([^\"]+)\"/;\n/**\n * NOTE: this function mutates original story argTypes including all story subcomponents if they are present\n */\nfunction withSlotEnhancer(story: PreparedStory, options: { slotsApi?: boolean; nativePropsApi?: boolean }) {\n  const hasArgAsProp = options.nativePropsApi ? story.argTypes.as?.type?.name === 'enum' : false;\n  const argAsProp = hasArgAsProp ? (story.argTypes.as.type as SBEnumType).value : null;\n  let hasArgAsSlot = false;\n\n  type InternalComponentApi = {\n    __docgenInfo: {\n      props?: Record<string, { type: { name: string } }>;\n    };\n    [k: string]: unknown;\n  };\n\n  const transformPropsWithSlotShorthand = (props: Record<string, { type: { name: string } }>) => {\n    Object.entries(props).forEach(([key, argType]) => {\n      const value: string = argType?.type?.name;\n\n      // If DocGen was already transformed, skip the transformation but set hasArgAsSlot to true so that we can show the info message\n      if (value.includes('Slot')) {\n        hasArgAsSlot = true;\n        return;\n      }\n      // Initial Render Transformation for shorthand slot values (mutates DocGen Object reference)\n      if (value.includes('WithSlotShorthandValue')) {\n        hasArgAsSlot = true;\n        const match = value.match(slotRegex);\n        if (match) {\n          props[key].type.name = `Slot<\\\"${match[1]}\\\">`;\n        } else {\n          props[key].type.name = `Slot`;\n        }\n      }\n    });\n  };\n\n  const transformComponent = (component: InternalComponentApi) => {\n    const docGenProps = component?.__docgenInfo?.props;\n    if (docGenProps) {\n      transformPropsWithSlotShorthand(docGenProps);\n    }\n  };\n\n  const component = story.component as InternalComponentApi;\n  const subcomponents = story.subcomponents as Record<string, InternalComponentApi>;\n\n  if (options.slotsApi) {\n    transformComponent(component);\n    if (subcomponents) {\n      Object.values(subcomponents).forEach(subcomponent => {\n        transformComponent(subcomponent);\n      });\n    }\n  }\n\n  return { component, hasArgAsSlot, hasArgAsProp, argAsProp };\n}\n\nconst AdditionalApiDocs: React.FC<{ children: React.ReactElement | React.ReactElement[] }> = ({ children }) => {\n  const styles = useStyles();\n  return (\n    <div className={styles.additionalInfo}>\n      <div className={styles.additionalInfoMessage}>\n        <InfoFilled className={styles.additionalInfoIcon} />\n        <div className={styles.infoIcon}>{children}</div>\n      </div>\n    </div>\n  );\n};\n\nconst RenderArgsTable = ({\n  story,\n  hideArgsTable,\n  showSlotsApi,\n  showNativePropsApi,\n}: {\n  story: PrimaryStory;\n  hideArgsTable: boolean;\n  showSlotsApi?: boolean;\n  showNativePropsApi?: boolean;\n}) => {\n  const { component, hasArgAsProp, hasArgAsSlot, argAsProp } = withSlotEnhancer(story, {\n    slotsApi: showSlotsApi,\n    nativePropsApi: showNativePropsApi,\n  });\n  const styles = useStyles();\n\n  return hideArgsTable ? null : (\n    <>\n      <div className={styles.additionalInfoWrapper}>\n        {hasArgAsProp && (\n          <AdditionalApiDocs>\n            <p>\n              <b>\n                Native props are supported <span role=\"presentation\">🙌</span>\n                <br />\n              </b>\n              <span>\n                All HTML attributes native to the\n                {getNativeElementsList(argAsProp!)}, including all <code>aria-*</code> and <code>data-*</code>{' '}\n                attributes, can be applied as native props on this component.\n              </span>\n            </p>\n          </AdditionalApiDocs>\n        )}\n        {hasArgAsSlot && (\n          <AdditionalApiDocs>\n            <p>\n              <b>\n                Customizing components with slots <span role=\"presentation\">🙌</span>\n              </b>\n              <br />\n              <span>\n                Slots in Fluent UI React components are designed to be modified or replaced, providing a flexible\n                approach to customizing components. Each slot is exposed as a top-level prop and can be filled with\n                primitive values, JSX/TSX, props objects, or render functions. This allows for more dynamic and reusable\n                component structures, similar to slots in other frameworks.{' '}\n                <Link href=\"/?path=/docs/concepts-developer-customizing-components-with-slots--docs\">\n                  Customizing components with slots{' '}\n                </Link>\n              </span>\n            </p>\n          </AdditionalApiDocs>\n        )}\n      </div>\n      <ArgsTable of={component} />\n    </>\n  );\n};\n\nconst RenderPrimaryStory = ({\n  primaryStory,\n  skipPrimaryStory,\n}: {\n  primaryStory: PrimaryStory;\n  skipPrimaryStory: boolean;\n}) => {\n  const styles = useStyles();\n  return skipPrimaryStory ? null : (\n    <>\n      <hr className={styles.divider} />\n      <HeaderMdx as=\"h3\" id={nameToHash(primaryStory.name)}>\n        {primaryStory.name}\n      </HeaderMdx>\n      <Primary />\n    </>\n  );\n};\n\nexport const FluentDocsPage = () => {\n  const context = React.useContext(DocsContext);\n\n  // Get the fluent docs page configuration from context\n  const docsPageConfig = getDocsPageConfig(context);\n\n  const stories = context.componentStories();\n\n  const primaryStory = stories[0];\n  const primaryStoryContext = context.getStoryContext(primaryStory);\n\n  assertStoryMetaValues(primaryStory);\n\n  const dir = primaryStoryContext.parameters?.dir ?? primaryStoryContext.globals?.[DIR_ID] ?? 'ltr';\n  const selectedTheme = themes.find(theme => theme.id === primaryStoryContext.globals![THEME_ID]);\n\n  const hideArgsTable = Boolean(primaryStoryContext.parameters?.docs?.hideArgsTable);\n  const skipPrimaryStory = Boolean(primaryStoryContext.parameters?.docs?.skipPrimaryStory);\n\n  const videos = primaryStoryContext.parameters?.videos ?? null;\n  const styles = useStyles();\n\n  // If docs page is disabled, return Storybook's default docs page\n  if (!docsPageConfig) {\n    return (\n      <div className=\"sb-unstyled\">\n        <Title />\n        <Subtitle />\n        <Description />\n        <RenderPrimaryStory primaryStory={primaryStory} skipPrimaryStory={skipPrimaryStory} />\n        <RenderArgsTable story={primaryStory} hideArgsTable={hideArgsTable} />\n        <Stories />\n      </div>\n    );\n  }\n\n  // Determine what to show based on configuration\n  const {\n    tableOfContents: showTableOfContents,\n    dirSwitcher: showDirSwitcher,\n    themePicker: showThemePicker,\n    argTable,\n  } = docsPageConfig;\n\n  // DEBUG\n  // console.log('FluentDocsPage', context);\n  // console.table(stories.map((s: StoreItem) => ({ id: s.id, kind: s.kind, name: s.name, story: s.story })));\n  // console.table(\n  //   Object.values((context as any).argTypes).map(arg => ({\n  //     name: arg.name,\n  //     description: arg.description,\n  //     type: arg.table?.type?.summary ?? '?',\n  //     default: arg.table?.defaultValue?.summary ?? '-',\n  //   })),\n  // );\n\n  return (\n    <div className=\"sb-unstyled\">\n      <Title />\n      <div className={styles.wrapper}>\n        <div className={styles.container}>\n          {(showThemePicker || showDirSwitcher) && (\n            <div className={styles.globalTogglesContainer}>\n              {showThemePicker && <ThemePicker selectedThemeId={selectedTheme?.id} />}\n              {showDirSwitcher && <DirSwitch dir={dir} />}\n            </div>\n          )}\n          <Subtitle />\n          <div className={styles.description}>\n            <Description />\n            {videos && <VideoPreviews videos={videos} />}\n          </div>\n          <RenderPrimaryStory primaryStory={primaryStory} skipPrimaryStory={skipPrimaryStory} />\n          <RenderArgsTable\n            story={primaryStory}\n            hideArgsTable={hideArgsTable}\n            showSlotsApi={argTable.slotsApi}\n            showNativePropsApi={argTable.nativePropsApi}\n          />\n          <Stories />\n        </div>\n        {showTableOfContents && (\n          <div className={styles.toc}>\n            <Toc stories={stories} />\n          </div>\n        )}\n      </div>\n    </div>\n  );\n};\n\nfunction assertStoryMetaValues(story: ReturnType<DocsContextProps['componentStories']>[number]) {\n  if (story.component === null) {\n    throw new Error(\n      [\n        '🚨 Invalid Story Meta declaration:',\n        `- primaryStory.component of componentId:${story.componentId} is \"null\"`,\n        '- to resolve this error, please update \"component\" property value in your story definition to reference a React Component or remove it if it is not needed.',\n      ].join('\\n'),\n    );\n  }\n}\n"],"names":["React","DocsContext","ArgsTable","Title","Subtitle","Description","HeaderMdx","Primary","Stories","tokens","Link","Text","makeStyles","InfoFilled","DIR_ID","THEME_ID","themes","getDocsPageConfig","DirSwitch","ThemePicker","Toc","nameToHash","useStyles","divider","height","backgroundColor","border","margin","wrapper","display","gap","toc","flexBasis","flexShrink","container","width","flexGrow","globalTogglesContainer","columnGap","spacingHorizontalXXXL","description","gridTemplateColumns","additionalInfoWrapper","flexDirection","spacingVerticalM","additionalInfo","colorNeutralStroke1","borderRadius","borderRadiusMedium","padding","spacingHorizontalM","additionalInfoIcon","alignSelf","color","colorBrandForeground1","fontSize","marginRight","additionalInfoMessage","alignItems","spacingVerticalXS","infoIcon","flex","useVideoClasses","spacingHorizontalMNudge","preview","borderRadiusSmall","colorNeutralBackground2","colorNeutralBackground2Hover","image","VideoPreviews","props","videos","classes","div","className","map","video","href","target","key","img","alt","src","title","getNativeElementsList","elements","elementsArr","el","idx","code","length","slotRegex","withSlotEnhancer","story","options","hasArgAsProp","nativePropsApi","argTypes","as","type","name","argAsProp","value","hasArgAsSlot","transformPropsWithSlotShorthand","Object","entries","forEach","argType","includes","match","transformComponent","component","docGenProps","__docgenInfo","subcomponents","slotsApi","values","subcomponent","AdditionalApiDocs","children","styles","RenderArgsTable","hideArgsTable","showSlotsApi","showNativePropsApi","p","b","span","role","br","of","RenderPrimaryStory","primaryStory","skipPrimaryStory","hr","id","FluentDocsPage","primaryStoryContext","context","useContext","docsPageConfig","stories","componentStories","getStoryContext","assertStoryMetaValues","dir","parameters","globals","selectedTheme","find","theme","Boolean","docs","tableOfContents","showTableOfContents","dirSwitcher","showDirSwitcher","themePicker","showThemePicker","argTable","selectedThemeId","Error","componentId","join"],"mappings":"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"}

package/lib/docs/ThemePicker.js

@@ -0,0 +1,61 @@
+import * as React from 'react';
+import { addons } from '@storybook/preview-api';
+import { Menu, MenuItemRadio, MenuList, MenuPopover, MenuTrigger } from '@fluentui/react-menu';
+import { MenuButton } from '@fluentui/react-button';
+import { makeStyles } from '@griffel/react';
+import { themes, THEME_ID } from '..';
+const useStyles = makeStyles({
+    menuButton: {
+        minWidth: '210px',
+        justifyContent: 'flex-start'
+    },
+    chevronIcon: {
+        marginLeft: 'auto'
+    },
+    menuPopover: {
+        minWidth: '210px'
+    }
+});
+/**
+ * Theme picker used in the react-components docs header
+ */ export const ThemePicker = ({ selectedThemeId })=>{
+    const styles = useStyles();
+    const [currentThemeId, setCurrentThemeId] = React.useState(selectedThemeId !== null && selectedThemeId !== void 0 ? selectedThemeId : null);
+    const setGlobalTheme = (themeId)=>{
+        addons.getChannel().emit('updateGlobals', {
+            globals: {
+                [THEME_ID]: themeId
+            }
+        });
+    };
+    const onCheckedValueChange = (e, data)=>{
+        const newThemeId = data.checkedItems[0];
+        setGlobalTheme(newThemeId);
+        setCurrentThemeId(newThemeId);
+    };
+    const selectedTheme = themes.find((theme)=>theme.id === currentThemeId);
+    var _selectedTheme_label;
+    return /*#__PURE__*/ React.createElement(Menu, {
+        // eslint-disable-next-line react/jsx-no-bind
+        onCheckedValueChange: onCheckedValueChange,
+        checkedValues: {
+            theme: selectedThemeId ? [
+                selectedThemeId
+            ] : []
+        },
+        positioning: {
+            autoSize: true
+        }
+    }, /*#__PURE__*/ React.createElement(MenuTrigger, null, /*#__PURE__*/ React.createElement(MenuButton, {
+        className: styles.menuButton,
+        menuIcon: {
+            className: styles.chevronIcon
+        }
+    }, (_selectedTheme_label = selectedTheme === null || selectedTheme === void 0 ? void 0 : selectedTheme.label) !== null && _selectedTheme_label !== void 0 ? _selectedTheme_label : 'Theme')), /*#__PURE__*/ React.createElement(MenuPopover, {
+        className: styles.menuPopover
+    }, /*#__PURE__*/ React.createElement(MenuList, null, themes.map((theme)=>/*#__PURE__*/ React.createElement(MenuItemRadio, {
+            name: "theme",
+            value: theme.id,
+            key: theme.id
+        }, theme.label)))));
+};

package/lib/docs/ThemePicker.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/docs/ThemePicker.tsx"],"sourcesContent":["import * as React from 'react';\nimport { addons } from '@storybook/preview-api';\n\nimport { Menu, MenuItemRadio, MenuList, MenuPopover, MenuTrigger } from '@fluentui/react-menu';\nimport type { MenuProps } from '@fluentui/react-menu';\nimport { MenuButton } from '@fluentui/react-button';\nimport { makeStyles } from '@griffel/react';\n\nimport { themes, ThemeIds, THEME_ID } from '..';\n\nconst useStyles = makeStyles({\n  menuButton: {\n    minWidth: '210px',\n    justifyContent: 'flex-start',\n  },\n\n  chevronIcon: {\n    marginLeft: 'auto',\n  },\n\n  menuPopover: {\n    minWidth: '210px',\n  },\n});\n\n/**\n * Theme picker used in the react-components docs header\n */\nexport const ThemePicker: React.FC<{ selectedThemeId?: string }> = ({ selectedThemeId }) => {\n  const styles = useStyles();\n  const [currentThemeId, setCurrentThemeId] = React.useState(selectedThemeId ?? null);\n\n  const setGlobalTheme = (themeId: ThemeIds): void => {\n    addons.getChannel().emit('updateGlobals', { globals: { [THEME_ID]: themeId } });\n  };\n  const onCheckedValueChange: MenuProps['onCheckedValueChange'] = (e, data) => {\n    const newThemeId = data.checkedItems[0] as ThemeIds;\n    setGlobalTheme(newThemeId);\n    setCurrentThemeId(newThemeId);\n  };\n\n  const selectedTheme = themes.find(theme => theme.id === currentThemeId);\n\n  return (\n    <Menu\n      // eslint-disable-next-line react/jsx-no-bind\n      onCheckedValueChange={onCheckedValueChange}\n      checkedValues={{ theme: selectedThemeId ? [selectedThemeId] : [] }}\n      positioning={{ autoSize: true }}\n    >\n      <MenuTrigger>\n        <MenuButton className={styles.menuButton} menuIcon={{ className: styles.chevronIcon }}>\n          {selectedTheme?.label ?? 'Theme'}\n        </MenuButton>\n      </MenuTrigger>\n      <MenuPopover className={styles.menuPopover}>\n        <MenuList>\n          {themes.map(theme => (\n            <MenuItemRadio name=\"theme\" value={theme.id} key={theme.id}>\n              {theme.label}\n            </MenuItemRadio>\n          ))}\n        </MenuList>\n      </MenuPopover>\n    </Menu>\n  );\n};\n"],"names":["React","addons","Menu","MenuItemRadio","MenuList","MenuPopover","MenuTrigger","MenuButton","makeStyles","themes","THEME_ID","useStyles","menuButton","minWidth","justifyContent","chevronIcon","marginLeft","menuPopover","ThemePicker","selectedThemeId","styles","currentThemeId","setCurrentThemeId","useState","setGlobalTheme","themeId","getChannel","emit","globals","onCheckedValueChange","e","data","newThemeId","checkedItems","selectedTheme","find","theme","id","checkedValues","positioning","autoSize","className","menuIcon","label","map","name","value","key"],"mappings":"AAAA,YAAYA,WAAW,QAAQ;AAC/B,SAASC,MAAM,QAAQ,yBAAyB;AAEhD,SAASC,IAAI,EAAEC,aAAa,EAAEC,QAAQ,EAAEC,WAAW,EAAEC,WAAW,QAAQ,uBAAuB;AAE/F,SAASC,UAAU,QAAQ,yBAAyB;AACpD,SAASC,UAAU,QAAQ,iBAAiB;AAE5C,SAASC,MAAM,EAAYC,QAAQ,QAAQ,KAAK;AAEhD,MAAMC,YAAYH,WAAW;IAC3BI,YAAY;QACVC,UAAU;QACVC,gBAAgB;IAClB;IAEAC,aAAa;QACXC,YAAY;IACd;IAEAC,aAAa;QACXJ,UAAU;IACZ;AACF;AAEA;;CAEC,GACD,OAAO,MAAMK,cAAsD,CAAC,EAAEC,eAAe,EAAE;IACrF,MAAMC,SAAST;IACf,MAAM,CAACU,gBAAgBC,kBAAkB,GAAGtB,MAAMuB,QAAQ,CAACJ,4BAAAA,6BAAAA,kBAAmB;IAE9E,MAAMK,iBAAiB,CAACC;QACtBxB,OAAOyB,UAAU,GAAGC,IAAI,CAAC,iBAAiB;YAAEC,SAAS;gBAAE,CAAClB,SAAS,EAAEe;YAAQ;QAAE;IAC/E;IACA,MAAMI,uBAA0D,CAACC,GAAGC;QAClE,MAAMC,aAAaD,KAAKE,YAAY,CAAC,EAAE;QACvCT,eAAeQ;QACfV,kBAAkBU;IACpB;IAEA,MAAME,gBAAgBzB,OAAO0B,IAAI,CAACC,CAAAA,QAASA,MAAMC,EAAE,KAAKhB;QAW/Ca;IATT,qBACE,oBAAChC;QACC,6CAA6C;QAC7C2B,sBAAsBA;QACtBS,eAAe;YAAEF,OAAOjB,kBAAkB;gBAACA;aAAgB,GAAG,EAAE;QAAC;QACjEoB,aAAa;YAAEC,UAAU;QAAK;qBAE9B,oBAAClC,iCACC,oBAACC;QAAWkC,WAAWrB,OAAOR,UAAU;QAAE8B,UAAU;YAAED,WAAWrB,OAAOL,WAAW;QAAC;OACjFmB,CAAAA,uBAAAA,0BAAAA,oCAAAA,cAAeS,KAAK,cAApBT,kCAAAA,uBAAwB,yBAG7B,oBAAC7B;QAAYoC,WAAWrB,OAAOH,WAAW;qBACxC,oBAACb,gBACEK,OAAOmC,GAAG,CAACR,CAAAA,sBACV,oBAACjC;YAAc0C,MAAK;YAAQC,OAAOV,MAAMC,EAAE;YAAEU,KAAKX,MAAMC,EAAE;WACvDD,MAAMO,KAAK;AAO1B,EAAE"}

package/lib/docs/Toc.js

@@ -0,0 +1,130 @@
+import * as React from 'react';
+import { addons } from '@storybook/preview-api';
+import { NAVIGATE_URL } from '@storybook/core-events';
+import { makeStyles } from '@griffel/react';
+const useTocStyles = makeStyles({
+    root: {
+        top: '64px',
+        position: 'sticky',
+        marginLeft: '40px'
+    },
+    heading: {
+        fontSize: '11px',
+        fontWeight: 'bold',
+        textTransform: 'uppercase',
+        marginBottom: '20px'
+    },
+    ol: {
+        position: 'relative',
+        listStyleType: 'none',
+        marginLeft: 0,
+        marginTop: 0,
+        paddingInlineStart: '20px',
+        '& li': {
+            marginBottom: '15px',
+            lineHeight: '16px'
+        },
+        '& a': {
+            textDecorationLine: 'none',
+            color: '#201F1E',
+            fontSize: '14px',
+            ':hover': {
+                color: '#201F1E'
+            }
+        },
+        '&:before': {
+            content: '""',
+            position: 'absolute',
+            left: 0,
+            height: '100%',
+            width: '3px',
+            backgroundColor: '#EDEBE9',
+            borderRadius: '4px'
+        }
+    },
+    selected: {
+        position: 'relative',
+        '&:after': {
+            content: '""',
+            position: 'absolute',
+            left: '-20px',
+            top: 0,
+            bottom: 0,
+            width: '3px',
+            backgroundColor: '#436DCD',
+            borderRadius: '4px'
+        }
+    }
+});
+// // Alternative approach to navigate - rerenders the iframe
+// // Usage: selectStory({ story: s.name, kind: s.kind });
+// const selectStory = (story: { kind: string; story: string }) => {
+//   console.log('Select Story', story);
+//   addons.getChannel().emit(SELECT_STORY, story);
+// };
+const navigate = (url)=>{
+    addons.getChannel().emit(NAVIGATE_URL, url);
+};
+export const nameToHash = (id)=>id.toLowerCase().replace(/[^a-z0-9]/gi, '-');
+export const Toc = ({ stories })=>{
+    const [selected, setSelected] = React.useState('');
+    const isNavigating = React.useRef(false);
+    React.useEffect(()=>{
+        // eslint-disable-next-line @nx/workspace-no-restricted-globals
+        const observer = new IntersectionObserver((entries)=>{
+            if (isNavigating.current) {
+                isNavigating.current = false;
+                return;
+            }
+            for (const entry of entries){
+                const { intersectionRatio, target } = entry;
+                if (intersectionRatio > 0.5) {
+                    setSelected(target.id);
+                    return;
+                }
+            }
+        }, {
+            threshold: [
+                0.5
+            ]
+        });
+        stories.forEach((link)=>{
+            // eslint-disable-next-line @nx/workspace-no-restricted-globals
+            const element = document.getElementById(nameToHash(link.name));
+            if (element) {
+                observer.observe(element);
+            }
+        });
+        return ()=>observer.disconnect();
+    }, [
+        stories
+    ]);
+    const tocItems = stories.map((item)=>{
+        return {
+            ...item,
+            selected: nameToHash(item.name) === selected
+        };
+    });
+    const tocClasses = useTocStyles();
+    return /*#__PURE__*/ React.createElement("nav", {
+        className: tocClasses.root
+    }, /*#__PURE__*/ React.createElement("h3", {
+        className: tocClasses.heading
+    }, "On this page"), /*#__PURE__*/ React.createElement("ol", {
+        className: tocClasses.ol
+    }, tocItems.map((s)=>{
+        const name = nameToHash(s.name);
+        return /*#__PURE__*/ React.createElement("li", {
+            className: s.selected ? tocClasses.selected : '',
+            key: s.id
+        }, /*#__PURE__*/ React.createElement("a", {
+            href: `#${name}`,
+            target: "_self",
+            onClick: (e)=>{
+                isNavigating.current = true;
+                navigate(`#${name}`);
+                setSelected(name);
+            }
+        }, s.name));
+    })));
+};

package/lib/docs/Toc.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/docs/Toc.tsx"],"sourcesContent":["import * as React from 'react';\nimport { addons } from '@storybook/preview-api';\nimport { NAVIGATE_URL } from '@storybook/core-events';\n\nimport { makeStyles } from '@griffel/react';\n\nconst useTocStyles = makeStyles({\n  root: {\n    top: '64px',\n    position: 'sticky',\n    marginLeft: '40px',\n  },\n  heading: {\n    fontSize: '11px',\n    fontWeight: 'bold',\n    textTransform: 'uppercase',\n    marginBottom: '20px',\n  },\n  ol: {\n    position: 'relative',\n    listStyleType: 'none',\n    marginLeft: 0,\n    marginTop: 0,\n    paddingInlineStart: '20px',\n    '& li': {\n      marginBottom: '15px',\n      lineHeight: '16px',\n    },\n    '& a': {\n      textDecorationLine: 'none',\n      color: '#201F1E',\n      fontSize: '14px',\n      ':hover': {\n        color: '#201F1E',\n      },\n    },\n    '&:before': {\n      content: '\"\"',\n      position: 'absolute',\n      left: 0,\n      height: '100%',\n      width: '3px',\n      backgroundColor: '#EDEBE9',\n      borderRadius: '4px',\n    },\n  },\n  selected: {\n    position: 'relative',\n    '&:after': {\n      content: '\"\"',\n      position: 'absolute',\n      left: '-20px',\n      top: 0,\n      bottom: 0,\n      width: '3px',\n      backgroundColor: '#436DCD',\n      borderRadius: '4px',\n    },\n  },\n});\n\ntype TocItem = { name: string; id: string; selected?: boolean };\n\n// // Alternative approach to navigate - rerenders the iframe\n// // Usage: selectStory({ story: s.name, kind: s.kind });\n// const selectStory = (story: { kind: string; story: string }) => {\n//   console.log('Select Story', story);\n//   addons.getChannel().emit(SELECT_STORY, story);\n// };\n\nconst navigate = (url: string) => {\n  addons.getChannel().emit(NAVIGATE_URL, url);\n};\n\nexport const nameToHash = (id: string): string => id.toLowerCase().replace(/[^a-z0-9]/gi, '-');\n\nexport const Toc = ({ stories }: { stories: TocItem[] }) => {\n  const [selected, setSelected] = React.useState('');\n  const isNavigating = React.useRef<boolean>(false);\n\n  React.useEffect(() => {\n    // eslint-disable-next-line @nx/workspace-no-restricted-globals\n    const observer = new IntersectionObserver(\n      (entries: IntersectionObserverEntry[]) => {\n        if (isNavigating.current) {\n          isNavigating.current = false;\n          return;\n        }\n        for (const entry of entries) {\n          const { intersectionRatio, target } = entry;\n          if (intersectionRatio > 0.5) {\n            setSelected(target.id);\n            return;\n          }\n        }\n      },\n      {\n        threshold: [0.5],\n      },\n    );\n\n    stories.forEach(link => {\n      // eslint-disable-next-line @nx/workspace-no-restricted-globals\n      const element = document.getElementById(nameToHash(link.name));\n      if (element) {\n        observer.observe(element);\n      }\n    });\n\n    return () => observer.disconnect();\n  }, [stories]);\n\n  const tocItems = stories.map(item => {\n    return { ...item, selected: nameToHash(item.name) === selected };\n  });\n  const tocClasses = useTocStyles();\n  return (\n    <nav className={tocClasses.root}>\n      <h3 className={tocClasses.heading}>On this page</h3>\n      <ol className={tocClasses.ol}>\n        {tocItems.map(s => {\n          const name = nameToHash(s.name);\n          return (\n            <li className={s.selected ? tocClasses.selected : ''} key={s.id}>\n              <a\n                href={`#${name}`}\n                target=\"_self\"\n                onClick={e => {\n                  isNavigating.current = true;\n                  navigate(`#${name}`);\n                  setSelected(name);\n                }}\n              >\n                {s.name}\n              </a>\n            </li>\n          );\n        })}\n      </ol>\n    </nav>\n  );\n};\n"],"names":["React","addons","NAVIGATE_URL","makeStyles","useTocStyles","root","top","position","marginLeft","heading","fontSize","fontWeight","textTransform","marginBottom","ol","listStyleType","marginTop","paddingInlineStart","lineHeight","textDecorationLine","color","content","left","height","width","backgroundColor","borderRadius","selected","bottom","navigate","url","getChannel","emit","nameToHash","id","toLowerCase","replace","Toc","stories","setSelected","useState","isNavigating","useRef","useEffect","observer","IntersectionObserver","entries","current","entry","intersectionRatio","target","threshold","forEach","link","element","document","getElementById","name","observe","disconnect","tocItems","map","item","tocClasses","nav","className","h3","s","li","key","a","href","onClick","e"],"mappings":"AAAA,YAAYA,WAAW,QAAQ;AAC/B,SAASC,MAAM,QAAQ,yBAAyB;AAChD,SAASC,YAAY,QAAQ,yBAAyB;AAEtD,SAASC,UAAU,QAAQ,iBAAiB;AAE5C,MAAMC,eAAeD,WAAW;IAC9BE,MAAM;QACJC,KAAK;QACLC,UAAU;QACVC,YAAY;IACd;IACAC,SAAS;QACPC,UAAU;QACVC,YAAY;QACZC,eAAe;QACfC,cAAc;IAChB;IACAC,IAAI;QACFP,UAAU;QACVQ,eAAe;QACfP,YAAY;QACZQ,WAAW;QACXC,oBAAoB;QACpB,QAAQ;YACNJ,cAAc;YACdK,YAAY;QACd;QACA,OAAO;YACLC,oBAAoB;YACpBC,OAAO;YACPV,UAAU;YACV,UAAU;gBACRU,OAAO;YACT;QACF;QACA,YAAY;YACVC,SAAS;YACTd,UAAU;YACVe,MAAM;YACNC,QAAQ;YACRC,OAAO;YACPC,iBAAiB;YACjBC,cAAc;QAChB;IACF;IACAC,UAAU;QACRpB,UAAU;QACV,WAAW;YACTc,SAAS;YACTd,UAAU;YACVe,MAAM;YACNhB,KAAK;YACLsB,QAAQ;YACRJ,OAAO;YACPC,iBAAiB;YACjBC,cAAc;QAChB;IACF;AACF;AAIA,6DAA6D;AAC7D,0DAA0D;AAC1D,oEAAoE;AACpE,wCAAwC;AACxC,mDAAmD;AACnD,KAAK;AAEL,MAAMG,WAAW,CAACC;IAChB7B,OAAO8B,UAAU,GAAGC,IAAI,CAAC9B,cAAc4B;AACzC;AAEA,OAAO,MAAMG,aAAa,CAACC,KAAuBA,GAAGC,WAAW,GAAGC,OAAO,CAAC,eAAe,KAAK;AAE/F,OAAO,MAAMC,MAAM,CAAC,EAAEC,OAAO,EAA0B;IACrD,MAAM,CAACX,UAAUY,YAAY,GAAGvC,MAAMwC,QAAQ,CAAC;IAC/C,MAAMC,eAAezC,MAAM0C,MAAM,CAAU;IAE3C1C,MAAM2C,SAAS,CAAC;QACd,+DAA+D;QAC/D,MAAMC,WAAW,IAAIC,qBACnB,CAACC;YACC,IAAIL,aAAaM,OAAO,EAAE;gBACxBN,aAAaM,OAAO,GAAG;gBACvB;YACF;YACA,KAAK,MAAMC,SAASF,QAAS;gBAC3B,MAAM,EAAEG,iBAAiB,EAAEC,MAAM,EAAE,GAAGF;gBACtC,IAAIC,oBAAoB,KAAK;oBAC3BV,YAAYW,OAAOhB,EAAE;oBACrB;gBACF;YACF;QACF,GACA;YACEiB,WAAW;gBAAC;aAAI;QAClB;QAGFb,QAAQc,OAAO,CAACC,CAAAA;YACd,+DAA+D;YAC/D,MAAMC,UAAUC,SAASC,cAAc,CAACvB,WAAWoB,KAAKI,IAAI;YAC5D,IAAIH,SAAS;gBACXV,SAASc,OAAO,CAACJ;YACnB;QACF;QAEA,OAAO,IAAMV,SAASe,UAAU;IAClC,GAAG;QAACrB;KAAQ;IAEZ,MAAMsB,WAAWtB,QAAQuB,GAAG,CAACC,CAAAA;QAC3B,OAAO;YAAE,GAAGA,IAAI;YAAEnC,UAAUM,WAAW6B,KAAKL,IAAI,MAAM9B;QAAS;IACjE;IACA,MAAMoC,aAAa3D;IACnB,qBACE,oBAAC4D;QAAIC,WAAWF,WAAW1D,IAAI;qBAC7B,oBAAC6D;QAAGD,WAAWF,WAAWtD,OAAO;OAAE,+BACnC,oBAACK;QAAGmD,WAAWF,WAAWjD,EAAE;OACzB8C,SAASC,GAAG,CAACM,CAAAA;QACZ,MAAMV,OAAOxB,WAAWkC,EAAEV,IAAI;QAC9B,qBACE,oBAACW;YAAGH,WAAWE,EAAExC,QAAQ,GAAGoC,WAAWpC,QAAQ,GAAG;YAAI0C,KAAKF,EAAEjC,EAAE;yBAC7D,oBAACoC;YACCC,MAAM,CAAC,CAAC,EAAEd,MAAM;YAChBP,QAAO;YACPsB,SAASC,CAAAA;gBACPhC,aAAaM,OAAO,GAAG;gBACvBlB,SAAS,CAAC,CAAC,EAAE4B,MAAM;gBACnBlB,YAAYkB;YACd;WAECU,EAAEV,IAAI;IAIf;AAIR,EAAE"}

package/lib/docs/index.js

@@ -0,0 +1,2 @@
+export { FluentDocsContainer } from './FluentDocsContainer';
+export { FluentDocsPage } from './FluentDocsPage';

package/lib/docs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/docs/index.ts"],"sourcesContent":["export { FluentDocsContainer } from './FluentDocsContainer';\nexport { FluentDocsPage } from './FluentDocsPage';\n"],"names":["FluentDocsContainer","FluentDocsPage"],"mappings":"AAAA,SAASA,mBAAmB,QAAQ,wBAAwB;AAC5D,SAASC,cAAc,QAAQ,mBAAmB"}