@redocly/theme 0.1.26 → 0.1.29

package/src/types/portal/src/server/dev-server/types.d.ts

@@ -0,0 +1,22 @@
+/// <reference types="node" />
+import http from 'http';
+import { MatchFunction } from 'path-to-regexp';
+import { BuildIncremental } from 'esbuild';
+export interface DevServerOptions {
+    clientEsbuild: BuildIncremental;
+    serverEsbuild: BuildIncremental;
+    port?: number;
+}
+export interface EnhancedIncomingMessage extends http.IncomingMessage {
+    pathname: string;
+    params: Record<string, string>;
+    body: string;
+}
+export interface Route {
+    matchPath: MatchFunction<EnhancedIncomingMessage['params']>;
+    handler(req: EnhancedIncomingMessage, res: http.ServerResponse): void;
+}
+export interface Server {
+    httpServer: http.Server;
+    addRoute(path: string, handler: Route['handler']): void;
+}

package/src/types/portal/src/server/plugins/markdown/types.d.ts

@@ -1,4 +1,5 @@
 import { Config, Node, RenderableTreeNode } from '@markdoc/markdoc/dist/src/types';
+import type { PageStaticData } from '../../../shared/types.js';
 import type { ContentProvider, ContentRecord } from '../../content/content-provider.js';
 import { PluginDefaultOptions } from '../types.js';
 import type { RouteDetails } from '../types.js';
@@ -7,16 +8,21 @@ export interface MdHeading {
     value: string;
     depth: number;
 }
-export declare type MarkdownOptions = {
+export declare type RoutesInfoActions = {
     getRouteByFsPath: (relativePath: string) => RouteDetails | undefined;
     getRouteBySlug?: (slug: string) => RouteDetails | undefined;
-    contentProvider: ContentProvider;
 };
-export interface MdPartialsContext {
+export interface MdOptions {
     partials: Record<string, Node>;
+    variables?: Record<string, any>;
 }
-export declare type MdRenderContext = ContentRecord & PluginDefaultOptions & MdPartialsContext;
-export declare type MdCompilationContext = MdRenderContext & MarkdownOptions;
+export declare type MdRenderContext = ContentRecord & PluginDefaultOptions & MdOptions;
+export declare type MdCompilationContext = MdRenderContext & RoutesInfoActions & {
+    contentProvider: ContentProvider;
+};
+export declare type MdProcessContext = PluginDefaultOptions & RoutesInfoActions & {
+    contentProvider: ContentProvider;
+} & MdOptions;
 export interface MdCompilationResult {
     result: RenderableTreeNode;
     headings: MdHeading[];
@@ -24,3 +30,7 @@ export interface MdCompilationResult {
 export interface ExtendedMarkdocConfig extends Config {
     currentProcessedPage?: string;
 }
+export interface MdPageStaticData extends PageStaticData {
+    ast: string;
+    frontmatter: Record<string, unknown>;
+}

package/src/types/portal/src/server/plugins/portal-config/get-frontmatter-keys-to-resolve.d.ts

@@ -0,0 +1,2 @@
+import { PortalConfig } from '../../../shared/models/config.js';
+export declare function getFrontmatterKeysToResolve(config?: PortalConfig): string[];

package/src/types/portal/src/server/plugins/portal-config/types.d.ts

@@ -1,5 +1,5 @@
 import { ResolvedConfigLinks } from '../../../shared/types.js';
-import { PortalConfig, RawTheme } from '../../../shared/models/config.js';
+import { AuthConfig, PortalConfig, RawTheme } from '../../../shared/models/config.js';
 import { Redirect } from '../types';
 export interface GlobalData {
     nav?: ResolvedConfigLinks;
@@ -13,8 +13,12 @@ export interface GlobalConfig {
     stylesheets?: string;
     redirects: Record<string, Redirect>;
     fileName: string;
+    rbac: RbacConfig;
     [k: string]: unknown;
 }
-export declare type RbacConfig = Record<string, string[]>;
+export declare type RbacConfig = {
+    roles: Record<string, string[]>;
+    auth?: AuthConfig;
+};
 export declare type CustomEntryPropertyType = Record<string, string | boolean>;
 export declare type ScriptOrStylesheetConfig = string | CustomEntryPropertyType;

package/src/types/portal/src/server/plugins/reference-docs/utils.d.ts

@@ -0,0 +1,26 @@
+import type { Pagination as PaginationType, IMenuItem, OpenAPIDefinition as IOpenAPIDefinition, MenuItemType } from '@redocly/reference-docs';
+import { RedocProRawOptions } from '@redocly/reference-docs';
+import type { ResolvedNavItem } from '../../../shared/types.js';
+import type { ParsedContentRecord } from '../../content/content-provider.js';
+export interface IMenuItemExtended extends IMenuItem {
+    httpVerb?: string;
+}
+export declare function loadDefinition(content: ParsedContentRecord): Promise<IOpenAPIDefinition | undefined>;
+export declare function convertRedocToSidebar(data: {
+    redocItems: IMenuItemExtended[];
+    sidebarItems: ResolvedNavItem[];
+    parentId?: string;
+    routeSlug: string;
+    pagination: PaginationType;
+}): void;
+export declare const shouldAddPage: ({ pagination, type, }: {
+    pagination: PaginationType;
+    type: MenuItemType;
+}) => boolean;
+export declare const removeMarkdownLinks: (text: string) => string;
+export declare function getConfigByPath(apis: {
+    [x: string]: {
+        root: string;
+        'features.openapi': RedocProRawOptions;
+    };
+} | undefined, path: string): RedocProRawOptions;

package/src/types/portal/src/server/plugins/types.d.ts

@@ -1,24 +1,39 @@
-import type { PageProps, ResolvedNavItem } from '../../shared/types.js';
-import type { Template } from '../store';
+import type { PageProps, PageStaticData, ResolvedNavItem, Version } from '../../shared/types.js';
 import type { ContentProvider } from '../content/content-provider.js';
 import { SearchData, SearchDocument } from '../../shared/models';
-import type { GlobalData, GlobalConfig, RbacConfig } from './portal-config/types.js';
-export declare type DataLoaderContext = {
+import { PERMISSION_PROP_NAME } from '@shared/constants.js';
+import { Store } from '../store.js';
+import type { GlobalData, GlobalConfig } from './portal-config/types.js';
+import { MdOptions } from './markdown/types.js';
+export declare type GetStaticDataContext = {
     getRouteByFsPath: (relativePath: string) => RouteDetails | undefined;
     getRouteBySlug: (relativePath: string) => RouteDetails | undefined;
+    getGlobalConfig<T = unknown>(key: string): T | undefined;
+    getAllRoutes: () => RouteDetails[];
+    contentDir: string;
+    outdir: string;
+};
+export declare type RbacContext = {
+    roles: string[];
+    permissions: string[];
 };
-export declare type DataLoader<T = any> = (contentProvider: ContentProvider, context: DataLoaderContext) => Promise<T>;
-export interface RouteDetails {
+export declare type GetStaticDataFn<TData extends PageStaticData = PageStaticData, TProps extends PageProps = PageProps> = (route: RouteDetails<TData, TProps>, contentProvider: ContentProvider, context: GetStaticDataContext) => Promise<TData>;
+export declare type GetServerPropsContext = {
+    getGlobalConfig<T = unknown>(key: string): T | undefined;
+    getRbacPermissionsByRole: Store['getRbacPermissionsByRole'];
+};
+export declare type GetServerPropsFn<TData extends PageStaticData = PageStaticData, TProps extends PageProps = PageProps> = (route: RouteDetails<TData, TProps>, data: TData, mdOptions: MdOptions) => Promise<TProps>;
+export interface RouteDetails<TData extends PageStaticData = PageStaticData, TProps extends PageProps = PageProps> {
     slug: string;
     fsPath: string;
     templateId: string;
-    dataLoaders: {
-        props: DataLoader<PageProps>;
-        [k: string]: DataLoader;
-    };
+    [PERMISSION_PROP_NAME]?: string;
+    versions?: Version[];
     getNavText?: () => Promise<string>;
     getSidebar?(): ResolvedNavItem[];
     getSearchDocuments?(): Promise<SearchDocument[]>;
+    getStaticData?: GetStaticDataFn<TData, TProps>;
+    serverPropsGetterIds?: string[];
 }
 export interface Redirect {
     to: string;
@@ -32,9 +47,10 @@ export interface PathVersionInfo {
 export interface ProcessContentActions {
     createSharedData(id: string, data: unknown): string;
     addRouteSharedData(slug: string, dataKey: string, dataId: string): void;
+    setGlobalConfig: (data: Partial<GlobalConfig>) => void;
     addRoute: (route: RouteDetails) => void;
-    createTemplate: (template: Template) => Template;
-    setRbacConfig: (rbacConfig: RbacConfig) => void;
+    createTemplate: (id: string, importPath: string) => string;
+    registerServerPropsGetter: (id: string, importPath: string) => string;
 }
 export interface AfterRoutesCreatedActions {
     createSharedData(id: string, data: unknown): string;
@@ -47,6 +63,7 @@ export interface AfterRoutesCreatedActions {
     setSearchData: (data: SearchData) => void;
     addRedirect: (from: string, to: Redirect) => void;
     contentDir: string;
+    outdir: string;
 }
 export interface PluginInstance {
     watch?: RegExp;

package/src/types/portal/src/server/store.d.ts

@@ -1,13 +1,9 @@
 import { Plugin } from 'esbuild';
 import { JSONIndex, SearchDocument, SearchData } from '../shared/models';
+import type { PageStaticData } from '../shared/types.js';
 import type { RouteDetails, Redirect } from './plugins/types.js';
-import type { GlobalData, GlobalConfig, RbacConfig } from './plugins/portal-config/types';
-export declare class Template {
-    pathOrThemePath: string;
-    id: string;
-    hash: string;
-    constructor(pathOrThemePath: string, id: string);
-}
+import type { GlobalData, GlobalConfig } from './plugins/portal-config/types';
+import type { ContentProvider } from './content/content-provider';
 export declare class Store {
     contentDir: string;
     outdir: string;
@@ -18,10 +14,11 @@ export declare class Store {
     searchDocuments: SearchDocument[];
     searchIndex: JSONIndex;
     sharedData: Map<string, unknown>;
-    templates: Map<string, Template>;
+    routesStaticDataCache: Map<string, PageStaticData>;
+    templates: Map<string, string>;
+    serverPropsGetters: Map<string, string>;
     esbuildPlugins: Plugin[];
     listeners: Map<string, Set<Function>>;
-    rbacConfig: RbacConfig;
     globalData: GlobalData;
     cliOptions: Record<string, string>;
     globalConfig: GlobalConfig;
@@ -34,19 +31,22 @@ export declare class Store {
     on(type: 'global-data-updated', cb: (pathname: string, data: Record<string, unknown>) => void): void;
     runListeners<T extends Array<unknown>>(type: 'template-updated' | 'global-data-updated' | 'shared-data-updated' | 'search-data-updated' | 'routes-updated' | 'build-updated', ...args: T): void;
     addEsbuildPlugin(plugin: Plugin): void;
-    setGlobalData(data: GlobalData): void;
+    setGlobalData: (data: GlobalData) => void;
     setSearchData(data: SearchData): void;
     setCliOptions(data: Record<string, string>): void;
     setGlobalConfig(data: Partial<GlobalConfig>): void;
-    setRbacConfig(rbacConfig: RbacConfig): void;
+    getRbacPermissionsByRole(role: string): string[] | undefined;
+    getGlobalConfig<T = unknown>(key: string): T;
     addRedirect(from: string, to: Redirect): void;
     createSharedData: (id: string, data: unknown) => string;
     addRouteSharedData: (routeSlug: string, dataKey: string, dataId: string) => void;
     addRoute: (route: RouteDetails) => void;
-    getRouteByFsPath: (relativePath: string) => RouteDetails | undefined;
-    getRouteBySlug: (slug: string) => RouteDetails | undefined;
-    getAllRoutes: () => RouteDetails[];
-    getTemplate: (id: string) => Template | undefined;
-    createTemplate: (template: Template) => Template;
+    getRouteByFsPath: (relativePath: string) => RouteDetails<PageStaticData, import("../shared/types.js").PageProps> | undefined;
+    getRouteBySlug: (slug: string) => RouteDetails<PageStaticData, import("../shared/types.js").PageProps> | undefined;
+    getAllRoutes: () => RouteDetails<PageStaticData, import("../shared/types.js").PageProps>[];
+    getTemplate: (id: string) => string | undefined;
+    createTemplate: (id: string, importPath: string) => string;
+    registerServerPropsGetter: (id: string, importPath: string) => string;
+    resolveRouteStaticData(route: RouteDetails, contentProvider: ContentProvider): Promise<{}>;
     clear: () => void;
 }

package/src/types/portal/src/server/utils/fs.d.ts

@@ -1,4 +1,5 @@
 export declare function readFileAsStringSync(filePath: string): string | null | undefined;
 export declare function readFileNames(dir: string): string[];
-export declare function copyStaticFile(absolutePath: string, outdir: string): string;
+export declare function copyStaticFile(absolutePath: string, outdir: string): string | undefined;
+export declare function copyFolderRecursiveSync(source: string, target: string): void;
 export declare function ensureDir(path: string): string;

package/src/types/portal/src/server/utils/index.d.ts

@@ -3,3 +3,4 @@ export * from './crypto.js';
 export * from './fs.js';
 export * from './reporter/reporter.js';
 export * from './paths.js';
+export * from './rbac.js';

package/src/types/portal/src/server/utils/paths.d.ts

@@ -1,4 +1,6 @@
+import { OpenAPIDefinition } from '@redocly/reference-docs';
 import type { ContentProvider } from '../content/content-provider.js';
+import { Route } from '../dev-server/types';
 export declare function getDataFromRelativePath(relativePath: string): {
     pathVersion: string | null;
     basePath: string;
@@ -11,3 +13,5 @@ export declare function excludeVersion<T extends string[] | string>(arg: T): {
     version?: string;
     data: T;
 };
+export declare function getParamsFromPath(path: string, route: Route): Record<string, string>;
+export declare function getDefinitionFiles(contentProvider: ContentProvider): Promise<Map<string, OpenAPIDefinition>>;

package/src/types/portal/src/server/utils/rbac.d.ts

@@ -0,0 +1,15 @@
+import { Store } from '../store';
+import { PERMISSION_PROP_NAME } from '../../shared/constants.js';
+export declare function canAccessResource<T extends {
+    [PERMISSION_PROP_NAME]?: string;
+}>(resource: T, permissions: Set<string>): boolean;
+export declare function getPermissionsForRoles(store: Pick<Store, 'getRbacPermissionsByRole'>, roles: string[]): Set<string>;
+export declare function getUserRolesFromCookies(cookies?: string): string[];
+/**
+ * Maps the input deep and removes objects that have a 'permission' prop
+ * but do not match the input permissions list
+ * @param input can be object, array, string or any other value
+ * @param permissions
+ * @returns
+ */
+export declare function filterDataByAccessDeep(input: any, permissions: Set<string>): any;

package/src/types/portal/src/shared/constants.d.ts

@@ -1,10 +1,17 @@
 export declare const RUNTIME_RESOURCES_DIR = "runtime";
 export declare const REDOC_OVERVIEW_ITEM_ID = "overview";
 export declare const PORTAL_CUSTOM_THEMES_FOLDER = "@theme";
+export declare const DEFAULT_THEME_NAME = "@redocly/theme";
 export declare const CUSTOM_MARKDOC_OPTIONS_PATH = "markdoc";
 export declare const CUSTOM_MARKDOC_TAGS_PATH = "tags";
 export declare const USER_THEME_ALIAS = "@theme";
+export declare const PUBLIC_ASSETS_FOLDER = "/assets";
 export declare const PUBLIC_STATIC_FOLDER = "/static";
+export declare const THEME_ASSETS_FOLDER = "theme-assets";
+export declare const PERMISSION_PROP_NAME = "redocly::permission";
+export declare const OIDC_CALLBACK_ROUTE_PATH = "/_auth/oidc";
+export declare const DEFAULT_OIDC_SCOPES = "openid";
 export declare enum FsErrors {
     NotExist = "ENOENT"
 }
+export declare const INTERNALLY_IGNORED_FILES: string[];

package/src/types/portal/src/shared/models/config.d.ts

@@ -1,9 +1,28 @@
-import { RawNavItem, LogoConfig, ResolvedNavItem } from '../types';
+import { RawNavItem, LogoConfig } from '../types';
+declare type RawNavConfig = RawNavItem[] | Record<string, RawNavItem[] | {
+    items: RawNavItem[];
+} | string>;
+export declare type AuthProviderConfig = {
+    type: string;
+    configurationUrl: string;
+    clientId: string;
+    clientSecret: string;
+    rolesClaimName: string;
+    scopes?: Array<string>;
+};
+export declare type AuthIdpsConfig = {
+    main: AuthProviderConfig;
+};
+export declare type AuthConfig = {
+    idps: AuthIdpsConfig;
+};
 export interface PortalConfig extends Record<string, any> {
-    nav?: RawNavItem[];
+    nav?: RawNavConfig;
     logo?: LogoConfig;
     themes?: RawTheme[];
-    footer?: FooterConfig;
+    footer?: RawNavConfig;
+    auth?: AuthConfig;
+    frontmatterKeysToResolve?: string[];
 }
 export interface RawTheme {
     name: string;
@@ -11,18 +30,11 @@ export interface RawTheme {
 }
 export interface ResolvedTheme extends RawTheme {
     stylesFile?: string;
+    path: string;
     markdoc: {
         nodesFiles: string[];
         tagsFiles: string[];
         componentsFile?: string;
     };
 }
-export interface FooterConfig {
-    copyrightText?: string;
-    columns?: FooterColumn[];
-}
-export interface FooterColumn {
-    group: string;
-    label?: string;
-    items: ResolvedNavItem[];
-}
+export {};

package/src/types/portal/src/shared/types.d.ts

@@ -1,4 +1,5 @@
 /// <reference types="react" />
+import { PERMISSION_PROP_NAME } from './constants';
 export declare type ResolvedNavLinkItem = {
     type: 'link';
     link: string;
@@ -12,6 +13,7 @@ export declare type ResolvedNavLinkItem = {
     separatorLine?: boolean;
     routeSlug?: string;
     active?: boolean;
+    [PERMISSION_PROP_NAME]?: string;
 };
 export declare type ResolvedNavGroupItem = {
     type: 'group';
@@ -25,6 +27,7 @@ export declare type ResolvedNavGroupItem = {
     separatorLine?: boolean;
     routeSlug?: string;
     active?: boolean;
+    [PERMISSION_PROP_NAME]?: string;
 };
 export declare type ResolvedNavItem = ResolvedNavLinkItem | ResolvedNavGroupItem | {
     type: 'separator';
@@ -35,6 +38,7 @@ export declare type ResolvedNavItem = ResolvedNavLinkItem | ResolvedNavGroupItem
     separatorLine?: boolean;
     link?: undefined;
     items?: ResolvedNavItem[];
+    [PERMISSION_PROP_NAME]?: string;
 } | {
     type: 'error';
     version?: string;
@@ -43,23 +47,30 @@ export declare type ResolvedNavItem = ResolvedNavLinkItem | ResolvedNavGroupItem
     label: string;
     link?: undefined;
     items?: ResolvedNavItem[];
+    [PERMISSION_PROP_NAME]?: string;
 };
 export declare type ResolvedNavItemWithLink = (ResolvedNavLinkItem | ResolvedNavGroupItem) & {
     link: string;
 };
 export declare type ResolvedSidebar = ResolvedNavItem[];
 export interface PageProps {
-    seo: {
+    seo?: {
         title: string;
     };
-    versions?: Version[];
-    frontmatter?: Omit<PageProps, 'frontmatter'>;
+    frontmatter?: Omit<PageProps, 'frontmatter'> & {
+        settings?: any;
+    };
+    [k: string]: any;
+}
+export interface PageStaticData {
+    props?: PageProps;
     [k: string]: unknown;
 }
 export interface PageData {
     templateId: string;
     sharedDataIds: Record<string, string>;
     props: PageProps;
+    versions?: Version[];
 }
 export interface CachedPageData extends PageData {
     Template: React.ComponentType<{
@@ -117,6 +128,8 @@ export declare type VersionedFolderConfig = {
     versions: VersionConfigItem[];
     hasVersionsConfig?: boolean;
 };
-export declare type NavGroup = ResolvedNavItem[] | undefined | string;
+export declare type NavGroup = ResolvedNavItem[] | undefined | string | boolean | number;
 export declare type NavGroupRecord = Record<string, NavGroup>;
 export declare type ResolvedConfigLinks = NavGroup | NavGroupRecord;
+export declare type RawNavConfigItem = RawNavItem | RawNavItem[] | string | undefined | boolean | number;
+export declare type RawNavConfig = RawNavConfigItem | Record<string, RawNavConfigItem>;

package/src/types/portal/src/shared/urls.d.ts

@@ -1,10 +1,10 @@
 export declare function getPageDataUrl(normalizedRoute: string): string;
 export declare function getClientPageDataUrl(normalizedRoute: string): string;
-export declare function getSidebarUrl(id: string): string;
 export declare function getSharedDataUrl(id: string): string;
 export declare const GLOBAL_DATA_URL = "/app-data.json";
 export declare const SEARCH_DATA_URL = "/search-data.json";
 export declare const SEARCH_INDEX_URL = "/search-index.json";
+export declare const EJECT_COMPONENT_URL = "/eject-component";
 export declare function combineUrls(baseURL: string, ...relativeURLs: string[]): string;
 export declare function withPathPrefix(url: string): string;
 export declare function withoutHash(url: string): string;

package/src/types/portal/src/shared/utils.d.ts

@@ -14,3 +14,5 @@ export declare function getGlobMatcher(glob: Glob, options?: {}): (file: string)
 export declare function isTag(value?: any): value is Tag;
 export declare function isNode(value?: any): value is Node;
 export declare const getCssPropertyValue: (name: string) => string;
+export declare function normalizeRoute(route: string): string;
+export declare function isPrimitive(arg: any): arg is string | boolean | number;

package/src/ui/Burger.tsx

@@ -0,0 +1,36 @@
+import React, { MouseEventHandler } from 'react';
+import styled from 'styled-components';
+
+export interface BurgerProps {
+  onClick: MouseEventHandler;
+  className?: string;
+}
+
+function BurgerComponent({ onClick, className }: BurgerProps): JSX.Element {
+  return (
+    <Button onClick={onClick} className={className} data-component-name="ui/Burger">
+      <Line></Line>
+      <Line></Line>
+      <Line></Line>
+    </Button>
+  );
+}
+
+const Button = styled.button`
+  all: unset;
+  max-width: 30px;
+  width: 100%;
+  min-width: 10px;
+  display: block;
+  cursor: pointer;
+`;
+
+const Line = styled.div`
+  margin: 4px 0;
+  width: 100%;
+  height: 2px;
+  background: #fff;
+  border-radius: 1px;
+`;
+
+export const Burger = styled(BurgerComponent)``;

package/src/ui/Flex.tsx

@@ -8,6 +8,7 @@ export interface FlexProps extends FlexboxProps, WidthProps {}
 
 export const Flex = styled(Box).attrs({ 'data-component-name': 'ui/Flex' })<FlexProps>`
   display: flex;
+  flex-wrap: wrap;
   ${flexbox}
   ${width}
 `;

package/src/utils/args-typecheck.ts

@@ -0,0 +1,9 @@
+// eslint-disable-next-line @typescript-eslint/explicit-module-boundary-types
+export function isEmptyArray(items: any): boolean {
+  return Array.isArray(items) && !items?.length;
+}
+
+// eslint-disable-next-line @typescript-eslint/explicit-module-boundary-types
+export function isPrimitive(arg: any): boolean {
+  return ['string', 'boolean', 'number'].includes(typeof arg);
+}

package/src/utils/class-names.ts

@@ -0,0 +1,8 @@
+const SPACE_DELIMITER = ' ';
+
+export function concatClassNames(...args: Array<string | undefined>): string {
+  return args
+    .map((className) => (className ? className.trim() : className))
+    .filter(Boolean)
+    .join(SPACE_DELIMITER);
+}

package/src/utils/color.ts

@@ -0,0 +1,9 @@
+export const getRandomNumber = (limit: number): number => Math.floor(Math.random() * limit);
+
+export function getRandomColor(): string {
+  const h = getRandomNumber(360);
+  const s = getRandomNumber(100);
+  const l = getRandomNumber(100);
+
+  return `hsl(${h}deg, ${s}%, ${l}%)`;
+}

package/src/utils/highlight.ts

@@ -22,6 +22,7 @@ import 'prismjs/components/prism-swift.js';
 import 'prismjs/components/prism-graphql.js';
 
 const DEFAULT_LANG = 'clike';
+const NEW_LINE_EXP = /\n(?!$)/g;
 
 Prism.languages.insertBefore(
   'javascript',
@@ -79,3 +80,13 @@ export function highlight(source: string | number | boolean, lang: string = DEFA
   }
   return Prism.highlight(source.toString(), grammar, lang);
 }
+
+export function addLineNumbers(highlightedCode: string, start = 1): string {
+  const codeLines = highlightedCode.split(NEW_LINE_EXP);
+
+  return codeLines
+    .map((line, i) => {
+      return `<span class="code-line" data-line-number=${start + i}>${line}</span>`;
+    })
+    .join('\n');
+}

package/src/utils/index.ts

@@ -4,3 +4,6 @@ export * from './highlight';
 export * from './jsonToHtml';
 export * from './media-css';
 export * from './theme-helpers';
+export * from './class-names';
+export * from './args-typecheck';
+export * from './color';