@mintlify/common 1.0.1049 → 1.0.1051

package/dist/live-preview.d.ts

@@ -7,3 +7,7 @@ export declare const LIVE_PREVIEW_COMPILED_CONTENT_UPDATE_MESSAGE_TYPE = "livePr
 export declare const LIVE_PREVIEW_NAVIGATION_UPDATE_MESSAGE_TYPE = "livePreviewNavigationUpdate";
 export declare const LIVE_PREVIEW_REQUEST_CONTENT_MESSAGE_TYPE = "livePreviewRequestContent";
 export declare const LIVE_PREVIEW_CONTENT_UNAVAILABLE_MESSAGE_TYPE = "livePreviewContentUnavailable";
+export declare const LIVE_PREVIEW_CSS_SNAPSHOT_MESSAGE_TYPE = "livePreviewCssSnapshot";
+export declare function normalizeLivePreviewPath(path: string): string;
+export declare function normalizeLivePreviewBasePath(basePath: string | undefined): string;
+export declare function stripLivePreviewBasePath(path: string, basePath: string | undefined): string;

package/dist/live-preview.js

@@ -7,3 +7,27 @@ export const LIVE_PREVIEW_COMPILED_CONTENT_UPDATE_MESSAGE_TYPE = 'livePreviewCom
 export const LIVE_PREVIEW_NAVIGATION_UPDATE_MESSAGE_TYPE = 'livePreviewNavigationUpdate';
 export const LIVE_PREVIEW_REQUEST_CONTENT_MESSAGE_TYPE = 'livePreviewRequestContent';
 export const LIVE_PREVIEW_CONTENT_UNAVAILABLE_MESSAGE_TYPE = 'livePreviewContentUnavailable';
+export const LIVE_PREVIEW_CSS_SNAPSHOT_MESSAGE_TYPE = 'livePreviewCssSnapshot';
+function normalizeLivePreviewHref(path) {
+    return path.replace(/^\/+|\/+$/g, '').replace(/\.mdx?$/, '');
+}
+export function normalizeLivePreviewPath(path) {
+    const href = normalizeLivePreviewHref(path);
+    return href ? `/${href}` : '/';
+}
+export function normalizeLivePreviewBasePath(basePath) {
+    var _a;
+    const normalized = (_a = basePath === null || basePath === void 0 ? void 0 : basePath.replace(/^\/+|\/+$/g, '')) !== null && _a !== void 0 ? _a : '';
+    return normalized ? `/${normalized}` : '';
+}
+export function stripLivePreviewBasePath(path, basePath) {
+    const normalizedPath = normalizeLivePreviewPath(path);
+    const normalizedBasePath = normalizeLivePreviewBasePath(basePath);
+    if (!normalizedBasePath)
+        return normalizedPath;
+    if (normalizedPath === normalizedBasePath)
+        return '/';
+    return normalizedPath.startsWith(`${normalizedBasePath}/`)
+        ? normalizedPath.slice(normalizedBasePath.length)
+        : normalizedPath;
+}

package/dist/mdx/componentIds.js

@@ -39,6 +39,7 @@ export const COMPONENTS_WITHOUT_ID = new Set([
     'Tooltip',
     'Tree',
     'FileTree',
+    'Variation',
     'Visibility',
     'Badge',
     'Color',

package/dist/mdx/plugins/remark/remarkExtractTableOfContents.js

@@ -3,6 +3,7 @@ import { safeCleanHeadingId, slugify } from '../../../slugify.js';
 import { createMdxJsxAttribute, getTableOfContentsTitle } from '../../lib/remark-utils.js';
 import { isMdxJsxFragment } from '../../utils.js';
 import { AVOIDED_PAGE_MODES, HEADING_LEVELS } from './remarkComponentIds.js';
+import { isVariationElement, resolveVariationIds } from './variation.js';
 export const HEADING_NAMES = ['h1', 'h2', 'h3', 'h4'];
 const COMPONENTS_TO_EXCLUDE_HEADINGS = [
     'Accordion',
@@ -43,6 +44,7 @@ export const remarkExtractTableOfContents = (mdxExtracts, pageMetadata) => {
         // the key is the node in unist
         const tabContentMap = new Map();
         const viewContentMap = new Map();
+        const variationContentMap = new Map();
         // Maps a Step node to the titleSize inherited from its parent <Steps>.
         // At render time <Steps titleSize> is forwarded to each child <Step> that
         // doesn't set its own titleSize, so the TOC must honor the same fallback.
@@ -99,6 +101,17 @@ export const remarkExtractTableOfContents = (mdxExtracts, pageMetadata) => {
                     });
                 }
             }
+            const variationNode = node;
+            if (isVariationElement(variationNode)) {
+                const resolution = resolveVariationIds(variationNode);
+                const variationIds = resolution.kind === 'valid' ? resolution.ids : [];
+                visit(node, (childNode) => {
+                    const inheritedVariationIds = variationContentMap.get(childNode);
+                    variationContentMap.set(childNode, inheritedVariationIds
+                        ? inheritedVariationIds.filter((id) => variationIds.includes(id))
+                        : variationIds);
+                });
+            }
         });
         visit(tree, (node) => {
             var _a, _b, _c, _d, _e, _f, _g, _h;
@@ -106,6 +119,7 @@ export const remarkExtractTableOfContents = (mdxExtracts, pageMetadata) => {
                 return;
             const currentTabId = tabContentMap.get(node);
             const currentViewId = viewContentMap.get(node);
+            const currentVariationIds = variationContentMap.get(node);
             const isValidHeading = node.type === 'heading' && HEADING_LEVELS.includes(node.depth);
             const isValidMdxHeading = node.type === 'mdxJsxFlowElement' && HEADING_NAMES.includes((_a = node.name) !== null && _a !== void 0 ? _a : '');
             const isTransformedHeading = node.type === 'mdxJsxFlowElement' && node.name === 'Heading';
@@ -241,6 +255,7 @@ export const remarkExtractTableOfContents = (mdxExtracts, pageMetadata) => {
                     children: [],
                     tabId: currentTabId,
                     viewId: currentViewId,
+                    variationIds: currentVariationIds,
                 });
             }
             else {
@@ -250,7 +265,10 @@ export const remarkExtractTableOfContents = (mdxExtracts, pageMetadata) => {
                     const lastTopLevel = contents.at(-1);
                     if (lastTopLevel &&
                         (lastTopLevel.tabId === undefined || lastTopLevel.tabId === currentTabId) &&
-                        (lastTopLevel.viewId === undefined || lastTopLevel.viewId === currentViewId)) {
+                        (lastTopLevel.viewId === undefined || lastTopLevel.viewId === currentViewId) &&
+                        (lastTopLevel.variationIds === undefined ||
+                            (currentVariationIds !== undefined &&
+                                currentVariationIds.every((id) => { var _a; return (_a = lastTopLevel.variationIds) === null || _a === void 0 ? void 0 : _a.includes(id); })))) {
                         arrToPushInto = lastTopLevel.children;
                     }
                 }
@@ -261,6 +279,7 @@ export const remarkExtractTableOfContents = (mdxExtracts, pageMetadata) => {
                     children: [],
                     tabId: currentTabId,
                     viewId: currentViewId,
+                    variationIds: currentVariationIds,
                 });
             }
         });

package/dist/mdx/plugins/remark/variation.d.ts

@@ -0,0 +1,15 @@
+import type { MdxJsxFlowElement, MdxJsxTextElement } from 'mdast-util-mdx-jsx';
+export type VariationElement = MdxJsxFlowElement | MdxJsxTextElement;
+export type VariationResolution = {
+    kind: 'valid';
+    ids: string[];
+} | {
+    kind: 'missing';
+} | {
+    kind: 'invalid';
+};
+export declare function isVariationElement(node: {
+    type: string;
+    name?: string | null;
+}): node is VariationElement;
+export declare function resolveVariationIds(node: VariationElement): VariationResolution;

package/dist/mdx/plugins/remark/variation.js

@@ -0,0 +1,48 @@
+export function isVariationElement(node) {
+    return ((node.type === 'mdxJsxFlowElement' || node.type === 'mdxJsxTextElement') &&
+        node.name === 'Variation');
+}
+export function resolveVariationIds(node) {
+    var _a, _b, _c, _d;
+    const attribute = node.attributes.find((candidate) => candidate.type === 'mdxJsxAttribute' && candidate.name === 'is');
+    if (!attribute)
+        return { kind: 'missing' };
+    if (typeof attribute.value === 'string') {
+        const id = attribute.value.trim();
+        return id ? { kind: 'valid', ids: [id] } : { kind: 'invalid' };
+    }
+    if (!attribute.value)
+        return { kind: 'invalid' };
+    const estree = (_a = attribute.value.data) === null || _a === void 0 ? void 0 : _a.estree;
+    const statement = estree === null || estree === void 0 ? void 0 : estree.body[0];
+    const expression = (statement === null || statement === void 0 ? void 0 : statement.type) === 'ExpressionStatement' ? statement.expression : undefined;
+    if ((expression === null || expression === void 0 ? void 0 : expression.type) === 'Literal' && typeof expression.value === 'string') {
+        const id = expression.value.trim();
+        return id ? { kind: 'valid', ids: [id] } : { kind: 'invalid' };
+    }
+    if ((expression === null || expression === void 0 ? void 0 : expression.type) === 'TemplateLiteral' && expression.expressions.length === 0) {
+        const id = (_c = (_b = expression.quasis[0]) === null || _b === void 0 ? void 0 : _b.value.cooked) === null || _c === void 0 ? void 0 : _c.trim();
+        return id ? { kind: 'valid', ids: [id] } : { kind: 'invalid' };
+    }
+    if ((expression === null || expression === void 0 ? void 0 : expression.type) === 'ArrayExpression') {
+        const ids = [];
+        for (const element of expression.elements) {
+            if ((element === null || element === void 0 ? void 0 : element.type) !== 'Literal' || typeof element.value !== 'string') {
+                return { kind: 'invalid' };
+            }
+            const id = element.value.trim();
+            if (!id)
+                return { kind: 'invalid' };
+            ids.push(id);
+        }
+        return ids.length > 0 ? { kind: 'valid', ids: [...new Set(ids)] } : { kind: 'invalid' };
+    }
+    if (estree)
+        return { kind: 'invalid' };
+    const raw = attribute.value.value.trim();
+    const quotedString = raw.match(/^(["'`])([\s\S]*)\1$/);
+    if ((_d = quotedString === null || quotedString === void 0 ? void 0 : quotedString[2]) === null || _d === void 0 ? void 0 : _d.trim()) {
+        return { kind: 'valid', ids: [quotedString[2].trim()] };
+    }
+    return { kind: 'invalid' };
+}

package/dist/mdx/utils.js

@@ -144,6 +144,7 @@ export const allowedComponents = [
     'ZoomImage',
     'OptimizedVideo',
     'Mermaid',
+    'Variation',
     'Visibility',
     'View',
     // Custom tags