@mintlify/common 1.0.1269 → 1.0.1270

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

@@ -0,0 +1,71 @@
+import type { Heading, Root } from 'mdast';
+import type { MdxJsxFlowElement, MdxJsxTextElement } from 'mdast-util-mdx-jsx';
+import { type ComponentDef, type EvalEnv, type MarkdownComponentContext, type StaticScope, type StaticValue } from './staticEvaluator.js';
+export type UnfoldBudget = {
+    remainingBytes: number;
+    remainingCalls: number;
+};
+export declare const MAX_UNFOLD_OUTPUT_BYTES = 2000000;
+export declare const MAX_UNFOLD_CALLS = 20000;
+export declare const MAX_UNFOLD_DEPTH = 24;
+export declare function createUnfoldBudget(): UnfoldBudget;
+export declare function chargeUnfoldBudget(ctx: UnfoldContext, cost: number): boolean;
+/**
+ * Whether a definition, or any component it renders, may hide content from agents. Degrading such
+ * a usage to its raw children when an unfold limit is hit could expose what its `Visibility`
+ * gates, so it is dropped instead.
+ */
+export declare function definitionGatesContent(def: ComponentDef, defs: ReadonlyMap<string, ComponentDef>, seen?: Set<ComponentDef>): boolean;
+export declare function chargeUnfoldCall(ctx: UnfoldContext): boolean;
+export type UnfoldContext = MarkdownComponentContext & {
+    stack: readonly ComponentDef[];
+    budget: UnfoldBudget;
+    /**
+     * Inside a definition, its scope built only from literal values and props supplied from them.
+     * At the page level this is the literal scope.
+     */
+    trusted?: EvalEnv;
+};
+/** The environment holding only values that no write the evaluator cannot see can make stale. */
+export declare function trustedEnv(ctx: UnfoldContext): EvalEnv;
+/** Props as evaluated from trusted values, and the names that could not be. */
+export type TrustedProps = {
+    props: StaticScope;
+    failedProps: ReadonlySet<string>;
+};
+export declare const FAILED_SPREAD = "*";
+export declare function collectMarkdownComponentContext(tree: Root): MarkdownComponentContext;
+export declare function getFirstPartyComponentDefs(): Map<string, ComponentDef>;
+export declare const DROP_ELEMENTS: Set<string>;
+export declare const UNWRAP_BLOCK_ELEMENTS: Set<string>;
+export declare const UNWRAP_INLINE_ELEMENTS: Set<string>;
+export declare const HEADING_ELEMENTS: Record<string, Heading['depth']>;
+/** Styling and internal hooks that mean nothing once the page is plain markdown. */
+export declare function isPresentationalAttribute(name: string): boolean;
+/**
+ * Drops a dark-mode-only copy when its light-mode-only twin sits right next to it, since both
+ * carry the same content once their classes are gone. Each light copy pairs with one dark copy,
+ * and a dark-only element without an adjacent twin stays.
+ */
+export declare function dropPairedDarkOnly<T>(children: readonly T[], classOf: (child: T) => unknown): T[];
+export declare const KEEP_TAG_COMPONENTS: Set<string>;
+export declare const HEADLINE_ATTRIBUTES: string[];
+export declare const GFM_ALERT_PATTERN: RegExp;
+export declare function prefixBlockquoteLines(text: string): string;
+export declare function escapeInterpolatedText(value: string): string;
+export declare function markdownLinkDestination(url: string): string;
+/** Escapes brackets outside code spans and images, so a label cannot end its link early. */
+export declare function escapeLinkLabel(text: string): string;
+export declare function materializeComponent(def: ComponentDef, name: string, props: StaticScope, childrenMarkdown: string, ctx: UnfoldContext, failedProps?: ReadonlySet<string>, bodyValue?: {
+    value: StaticValue;
+}, trusted?: TrustedProps): string | undefined;
+export type MdxUsageElement = MdxJsxFlowElement | MdxJsxTextElement;
+export declare function collectUsageProps(node: MdxUsageElement, ctx: UnfoldContext, failed?: Set<string>): StaticScope;
+export declare function extractProgramExpression(estree: unknown): unknown;
+/** Whether `node` contains a JSX element or fragment, or only one named `name` when given. */
+export declare function containsJsx(node: unknown, name?: string): boolean;
+/**
+ * Serializes an expression that renders JSX: an element or fragment, or a conditional or logical
+ * expression with JSX in a branch. A branch whose condition cannot be resolved is dropped.
+ */
+export declare function serializeExpressionJsx(expression: unknown, ctx: UnfoldContext): string | undefined;