@emeryld/rrroutes-export 1.0.1 → 1.0.3

package/README.md

@@ -7,3 +7,4 @@ Export helpers and CLI for RRRoutes finalized leaves.
 - Schema utilities: `serializeLeafContract`, `flattenLeafSchemas`, `introspectSchema`
 
 Depends on `@emeryld/rrroutes-contract` for contract types and schema parsing.
+This package is configured to install `@emeryld/rrroutes-contract` from npm (not from the local workspace) to ensure release-version parity.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@emeryld/rrroutes-export",
   "description": "Finalized leaves export helpers and CLI for RRRoutes",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "private": false,
   "type": "module",
   "main": "dist/index.cjs",
@@ -23,7 +23,7 @@
     "bin/rrroutes-export-finalized-leaves.mjs"
   ],
   "dependencies": {
-    "@emeryld/rrroutes-contract": "^2.7.13",
+    "@emeryld/rrroutes-contract": "^2.8.0",
     "typescript": "^5.9.3",
     "zod": "^4.3.6"
   },
@@ -36,9 +36,8 @@
   },
   "scripts": {
     "clean": "rimraf dist && rimraf node_modules",
-    "build": "pnpm run clean && pnpm install && pnpm run build:js && pnpm run build:types",
+    "build": "pnpm run clean && pnpm install && pnpm run build:js",
     "build:js": "tsup --config tsup.config.ts",
-    "build:types": "tsc -p tsconfig.build.json",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "NODE_OPTIONS=--experimental-vm-modules jest --config ../../jest.base.config.js --watchman=false --runInBand",
     "export:finalized-leaves": "TS_NODE_PROJECT=tsconfig.tools.json TS_NODE_TRANSPILE_ONLY=1 node --experimental-specifier-resolution=node --loader ts-node/esm ./scripts/export-finalized-leaves.ts"

package/tools/finalized-leaves-viewer.html

@@ -924,15 +924,35 @@
         return node
       }
 
-      function setHighlighted(node, text, engine) {
-        node.innerHTML = engine.highlight(text ?? '')
+      function normalizeFieldIds(fieldIds) {
+        if (!fieldIds) return []
+        return Array.isArray(fieldIds) ? fieldIds : [fieldIds]
       }
 
-      function kv(key, value, engine) {
+      function shouldHighlightField(fieldIds, selectedIds) {
+        const ids = normalizeFieldIds(fieldIds)
+        if (ids.length === 0) return false
+        if (!Array.isArray(selectedIds)) return false
+        return ids.some((id) => selectedIds.includes(id))
+      }
+
+      function highlightWithFieldScope(text, engine, selectedIds, fieldIds) {
+        const source = text ?? ''
+        if (!engine.active || !shouldHighlightField(fieldIds, selectedIds)) {
+          return escapeHtml(source)
+        }
+        return engine.highlight(source)
+      }
+
+      function setHighlighted(node, text, engine, selectedIds, fieldIds) {
+        node.innerHTML = highlightWithFieldScope(text, engine, selectedIds, fieldIds)
+      }
+
+      function kv(key, value, engine, selectedIds, fieldIds) {
         const box = el('div', 'kv')
         box.appendChild(el('div', 'k', key))
         const valueNode = el('div', 'v mono')
-        setHighlighted(valueNode, value === undefined ? '—' : String(value), engine)
+        setHighlighted(valueNode, value === undefined ? '—' : String(value), engine, selectedIds, fieldIds)
         box.appendChild(valueNode)
         return box
       }
@@ -982,12 +1002,12 @@
         return `vscode://file/${encodeURI(vscodePath)}:${line}:${column}`
       }
 
-      function createSourceRow(label, source, engine) {
+      function createSourceRow(label, source, engine, selectedIds, fieldIds) {
         const box = el('div', 'kv')
         const labelNode = el('div', 'v mono')
 
         if (!source || !source.file) {
-          setHighlighted(labelNode, label, engine)
+          setHighlighted(labelNode, label, engine, selectedIds, fieldIds)
           box.appendChild(labelNode)
           return box
         }
@@ -997,7 +1017,7 @@
         link.href = href
         link.target = '_blank'
         link.rel = 'noopener noreferrer'
-        link.innerHTML = engine.highlight(label)
+        link.innerHTML = highlightWithFieldScope(label, engine, selectedIds, fieldIds)
         labelNode.appendChild(link)
         box.appendChild(labelNode)
         return box
@@ -1083,14 +1103,14 @@
         return root
       }
 
-      function renderTreeNode(node, engine, isRoot) {
+      function renderTreeNode(node, engine, selectedIds, sectionName, isRoot) {
         const childKeys = Object.keys(node.children)
         const hasChildren = childKeys.length > 0
         const hasInfo = Boolean(node.info)
         const appendNameCell = (row) => {
           const nameWrap = el('span', 'mono tree-name')
           const nameNode = el('span')
-          setHighlighted(nameNode, node.name, engine)
+          setHighlighted(nameNode, node.name, engine, selectedIds, sectionName)
           nameWrap.appendChild(nameNode)
 
           if (node.info && !node.info.optional) {
@@ -1107,7 +1127,10 @@
 
         const appendTypeCell = (row, info) => {
           const type = el('span', 'tree-pill')
-          setHighlighted(type, info?.type || info?.kind || '—', engine)
+          setHighlighted(type, info?.type || info?.kind || '—', engine, selectedIds, [
+            sectionName,
+            'types',
+          ])
           row.appendChild(type)
         }
 
@@ -1126,7 +1149,11 @@
           const container = el('div', 'schema-tree')
           childKeys
             .sort((a, b) => a.localeCompare(b))
-            .forEach((key) => container.appendChild(renderTreeNode(node.children[key], engine, false)))
+            .forEach((key) =>
+              container.appendChild(
+                renderTreeNode(node.children[key], engine, selectedIds, sectionName, false),
+              ),
+            )
           details.appendChild(container)
           return details
         }
@@ -1163,7 +1190,7 @@
           hasAnySchemaEntries = true
           const block = el('div', 'schema-block')
           const header = el('div', 'schema-header mono')
-          setHighlighted(header, sectionName, engine)
+          setHighlighted(header, sectionName, engine, selectedIds, sectionName)
           block.appendChild(header)
 
           const schemaSource = getSchemaSource(source, sectionName)
@@ -1176,12 +1203,14 @@
                 ),
                 schemaSource.sourceValue,
                 engine,
+                selectedIds,
+                'sourceSchemas',
               ),
             )
           }
 
           const tree = buildSchemaTree(entries, sectionName)
-          block.appendChild(renderTreeNode(tree, engine, true))
+          block.appendChild(renderTreeNode(tree, engine, selectedIds, sectionName, true))
 
           section.appendChild(block)
         })
@@ -1192,7 +1221,13 @@
       function renderLeaf(leaf, engine, selectedIds) {
         const details = el('details', 'leaf')
         const summary = el('summary')
-        setHighlighted(summary, `${String(leaf.method || '').toUpperCase()} ${leaf.path || ''}`, engine)
+        setHighlighted(
+          summary,
+          `${String(leaf.method || '').toUpperCase()} ${leaf.path || ''}`,
+          engine,
+          selectedIds,
+          ['method', 'path'],
+        )
         details.appendChild(summary)
 
         const content = el('div', 'leaf-content')
@@ -1202,32 +1237,38 @@
         const overview = el('div', 'section')
         overview.appendChild(el('h3', '', 'Overview'))
         const topGrid = el('div', 'grid-3')
-        topGrid.appendChild(kv('group', cfg.docsGroup, engine))
+        topGrid.appendChild(kv('group', cfg.docsGroup, engine, selectedIds, 'docsGroup'))
         topGrid.appendChild(
-          kv('tags', cfg.tags && cfg.tags.length > 0 ? cfg.tags.join(', ') : undefined, engine),
+          kv(
+            'tags',
+            cfg.tags && cfg.tags.length > 0 ? cfg.tags.join(', ') : undefined,
+            engine,
+            selectedIds,
+            'tags',
+          ),
         )
-        topGrid.appendChild(kv('stability', cfg.stability, engine))
+        topGrid.appendChild(kv('stability', cfg.stability, engine, selectedIds, 'stability'))
         overview.appendChild(topGrid)
-        overview.appendChild(kv('summary', cfg.summary, engine))
-        overview.appendChild(kv('description', cfg.description, engine))
+        overview.appendChild(kv('summary', cfg.summary, engine, selectedIds, 'summary'))
+        overview.appendChild(kv('description', cfg.description, engine, selectedIds, 'description'))
 
         const iconRow = el('div', 'icon-row')
         if (cfg.feed) {
           const feed = el('span', 'icon-badge feed')
           feed.title = 'Feed endpoint'
-          setHighlighted(feed, 'Feed', engine)
+          feed.textContent = 'Feed'
           iconRow.appendChild(feed)
         }
         if (cfg.deprecated) {
           const deprecated = el('span', 'icon-badge warn')
           deprecated.title = 'Deprecated'
-          setHighlighted(deprecated, 'D', engine)
+          deprecated.textContent = 'D'
           iconRow.appendChild(deprecated)
         }
         if (cfg.docsHidden) {
           const hidden = el('span', 'icon-badge warn')
           hidden.title = 'Hidden'
-          setHighlighted(hidden, 'H', engine)
+          hidden.textContent = 'H'
           iconRow.appendChild(hidden)
         }
         if (iconRow.childNodes.length > 0) {
@@ -1241,7 +1282,7 @@
           const chips = el('div', 'chips')
           cfg.bodyFiles.forEach((file) => {
             const chip = el('span', 'chip ok')
-            setHighlighted(chip, `${file.name} (max ${file.maxCount})`, engine)
+            chip.textContent = `${file.name} (max ${file.maxCount})`
             chips.appendChild(chip)
           })
           files.appendChild(chips)
@@ -1251,7 +1292,9 @@
         const sourceByLeaf = state.payload?.sourceByLeaf || {}
         const source = sourceByLeaf[leaf.key]
         if (source?.definition) {
-          overview.appendChild(createSourceRow('definition', source.definition, engine))
+          overview.appendChild(
+            createSourceRow('definition', source.definition, engine, selectedIds, 'sourceDefinition'),
+          )
         }
 
         const separatedSchemas = renderSeparatedSchemas(flatSchema, engine, selectedIds, source)

package/dist/defaultViewerTemplate.d.ts

@@ -1 +0,0 @@
-export declare const DEFAULT_VIEWER_TEMPLATE = "<!doctype html>\n<html lang=\"en\">\n  <head>\n    <meta charset=\"UTF-8\" />\n    <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\" />\n    <title>Finalized Leaves Viewer</title>\n    <style>\n      :root {\n        --bg: #212121;\n        --surface: #2a2a2a;\n        --border: #4a4a4a;\n        --text: #fffafa;\n        --muted: #c8c2c2;\n        --accent: #a764d3;\n        --schema-accent: #fbbd23;\n      }\n      body {\n        margin: 0;\n        font-family: 'Iosevka Web', 'SFMono-Regular', Menlo, Consolas, monospace;\n        color: var(--text);\n        background: var(--bg);\n      }\n      a { color: var(--schema-accent); }\n      .wrap { max-width: 1100px; margin: 0 auto; padding: 20px; }\n      .card { background: var(--surface); border: 1px solid var(--border); border-radius: 12px; padding: 14px; }\n      .meta { color: var(--muted); font-size: 12px; }\n      #results { margin-top: 12px; display: grid; gap: 8px; }\n      details { background: var(--surface); border: 1px solid var(--border); border-radius: 10px; padding: 8px 10px; }\n      summary { cursor: pointer; font-weight: 700; color: var(--accent); }\n      pre { margin: 10px 0 0; overflow: auto; border: 1px solid var(--border); border-radius: 8px; padding: 10px; background: #303030; color: var(--text); }\n    </style>\n  </head>\n  <body>\n    <div class=\"wrap\">\n      <h1>Finalized Leaves Viewer (Baked)</h1>\n      <div class=\"card\">\n        <div id=\"status\" class=\"meta\">Waiting for baked payload...</div>\n      </div>\n      <div id=\"results\"></div>\n    </div>\n\n    <!--__FINALIZED_LEAVES_BAKED_PAYLOAD__-->\n\n    <script>\n      const statusEl = document.getElementById('status')\n      const resultsEl = document.getElementById('results')\n      const payload = window.__FINALIZED_LEAVES_PAYLOAD\n\n      if (!payload || !Array.isArray(payload.leaves)) {\n        statusEl.textContent = 'No baked payload found in this HTML file.'\n      } else {\n        statusEl.textContent =           'Loaded baked payload with ' + payload.leaves.length + ' routes.'\n\n        const toHref = (source) => {\n          if (!source || !source.file) return null\n          const normalizedPath = String(source.file).replace(/\\\\/g, '/')\n          const platform =\n            (navigator.userAgentData && navigator.userAgentData.platform) ||\n            navigator.platform ||\n            ''\n          const isWindows = /win/i.test(platform)\n          const vscodePath = isWindows\n            ? normalizedPath.replace(/^\\/+/, '')\n            : normalizedPath.startsWith('/')\n              ? normalizedPath\n              : '/' + normalizedPath\n          const line = Number.isFinite(source.line) ? source.line : 1\n          const column = Number.isFinite(source.column) ? source.column : 1\n          return 'vscode://file/' + encodeURI(vscodePath) + ':' + line + ':' + column\n        }\n\n        const sourceDisplay = (source) => {\n          return ''\n        }\n\n        payload.leaves.forEach((leaf) => {\n          const details = document.createElement('details')\n          const summary = document.createElement('summary')\n          summary.textContent = String(leaf.method || '').toUpperCase() + ' ' + (leaf.path || '')\n\n          const pre = document.createElement('pre')\n          pre.textContent = JSON.stringify(leaf, null, 2)\n\n          const source = payload.sourceByLeaf && payload.sourceByLeaf[leaf.key]\n          let sourceWrap = null\n          if (source) {\n            sourceWrap = document.createElement('div')\n            sourceWrap.className = 'meta'\n\n            const definitionHref = toHref(source.definition)\n            if (definitionHref) {\n              const label = document.createElement('div')\n              const link = document.createElement('a')\n              link.href = definitionHref\n              link.target = '_blank'\n              link.rel = 'noopener noreferrer'\n              link.textContent = 'definition'\n              label.appendChild(link)\n              sourceWrap.appendChild(label)\n            }\n\n            if (source.schemas && typeof source.schemas === 'object') {\n              Object.entries(source.schemas).forEach(([name, schema]) => {\n                if (!schema) return\n                const href = toHref(schema)\n                const row = document.createElement('div')\n                if (href) {\n                  const link = document.createElement('a')\n                  link.href = href\n                  link.target = '_blank'\n                  link.rel = 'noopener noreferrer'\n                  link.textContent =\n                    name + ': ' + (schema.sourceName || schema.tag || '<anonymous>')\n                  row.appendChild(link)\n                } else {\n                  row.textContent = name + ': ' + (schema.sourceName || schema.tag || '<anonymous>')\n                }\n                sourceWrap.appendChild(row)\n              })\n            }\n\n          }\n\n          details.appendChild(summary)\n          if (sourceWrap) details.appendChild(sourceWrap)\n          details.appendChild(pre)\n          resultsEl.appendChild(details)\n        })\n      }\n    </script>\n  </body>\n</html>\n";

package/dist/exportFinalizedLeaves.cli.d.ts

@@ -1,14 +0,0 @@
-import { type ExportFinalizedLeavesInput } from './exportFinalizedLeaves';
-export type FinalizedLeavesCliArgs = {
-    modulePath: string;
-    exportName: string;
-    outFile: string;
-    withSource: boolean;
-    tsconfigPath?: string;
-};
-export declare function parseFinalizedLeavesCliArgs(argv: string[]): FinalizedLeavesCliArgs;
-export declare function loadFinalizedLeavesInput({ modulePath, exportName, }: FinalizedLeavesCliArgs): Promise<ExportFinalizedLeavesInput>;
-export declare function runExportFinalizedLeavesCli(argv: string[]): Promise<{
-    payload: import("./exportFinalizedLeaves").FinalizedLeavesExport;
-    outFile: string;
-}>;

package/dist/exportFinalizedLeaves.d.ts

@@ -1,61 +0,0 @@
-import type { AnyLeafLowProfile, FinalizedRegistry } from '@emeryld/rrroutes-contract';
-import { type FlatSchemaMap } from './flattenSchema';
-import { type SerializeLeafContractOptions, type SerializedLeafContract } from './serializeLeafContract';
-import { type LeafSourceByKey, type SourceExtractionReason } from './extractLeafSourceByAst';
-export type ExportFinalizedLeavesInput = readonly AnyLeafLowProfile[] | FinalizedRegistry<readonly AnyLeafLowProfile[]>;
-export type ExportFinalizedLeavesMeta = {
-    generatedAt: string;
-    description: string;
-    sourceExtraction?: {
-        mode: 'ast';
-        enabled: boolean;
-        modulePath?: string;
-        exportName?: string;
-        tsconfigPath?: string;
-        resolvedLeafCount: number;
-        reason?: SourceExtractionReason;
-        stats?: {
-            visitedSymbols: number;
-            visitedFiles: number;
-            unresolvedReferences: number;
-        };
-    };
-    fieldCatalog: {
-        leaf: string[];
-        cfg: string[];
-        schemaNode: string[];
-        flatSchemaEntry: string[];
-    };
-    flattening: {
-        notation: 'dot+[]';
-        unionBranchSuffix: '-N';
-        sections: readonly ['params', 'query', 'body', 'output'];
-    };
-};
-export type FinalizedLeavesExport = {
-    _meta: ExportFinalizedLeavesMeta;
-    leaves: SerializedLeafContract[];
-    schemaFlatByLeaf: Record<string, FlatSchemaMap>;
-    sourceByLeaf?: LeafSourceByKey;
-};
-export type ExportFinalizedLeavesOptions = SerializeLeafContractOptions & {
-    outFile?: string;
-    htmlFile?: string;
-    viewerTemplateFile?: string;
-    openOnFinish?: boolean;
-    includeSource?: boolean;
-    tsconfigPath?: string;
-    sourceModulePath?: string;
-    sourceExportName?: string;
-};
-export type WriteFinalizedLeavesExportOptions = {
-    outFile?: string;
-    htmlFile?: string;
-    viewerTemplateFile?: string;
-    openOnFinish?: boolean;
-};
-export declare function writeFinalizedLeavesExport(payload: FinalizedLeavesExport, outFileOrOptions: string | WriteFinalizedLeavesExportOptions): Promise<{
-    outFile?: string;
-    htmlFile?: string;
-}>;
-export declare function exportFinalizedLeaves(input: ExportFinalizedLeavesInput, options?: ExportFinalizedLeavesOptions): Promise<FinalizedLeavesExport>;

package/dist/extractLeafSourceByAst.d.ts

@@ -1,38 +0,0 @@
-declare const SCHEMA_KEYS: readonly ["bodySchema", "querySchema", "paramsSchema", "outputSchema", "outputMetaSchema", "queryExtensionSchema"];
-export type SourceExtractionReason = 'module_not_in_program' | 'export_not_found' | 'unsupported_expression_shape' | 'resolved_zero_leaves';
-type SchemaKey = (typeof SCHEMA_KEYS)[number];
-export type LeafSourceLocation = {
-    file: string;
-    line: number;
-    column: number;
-};
-export type SchemaSourceMetadata = LeafSourceLocation & {
-    sourceName?: string;
-    tag?: '<inline>' | '<anonymous>' | '<expression>';
-};
-export type LeafSourceMetadata = {
-    definition: LeafSourceLocation & {
-        symbolName?: string;
-    };
-    schemas: Partial<Record<SchemaKey, SchemaSourceMetadata>>;
-};
-export type LeafSourceByKey = Record<string, LeafSourceMetadata>;
-export type ExtractLeafSourceByAstOptions = {
-    modulePath: string;
-    exportName: string;
-    tsconfigPath?: string;
-    cwd?: string;
-};
-export type ExtractLeafSourceByAstStats = {
-    visitedSymbols: number;
-    visitedFiles: number;
-    unresolvedReferences: number;
-};
-export type ExtractLeafSourceByAstResult = {
-    sourceByLeaf: LeafSourceByKey;
-    tsconfigPath?: string;
-    reason?: SourceExtractionReason;
-    stats: ExtractLeafSourceByAstStats;
-};
-export declare function extractLeafSourceByAst({ modulePath, exportName, tsconfigPath, cwd, }: ExtractLeafSourceByAstOptions): ExtractLeafSourceByAstResult;
-export {};

package/dist/flattenSchema.d.ts

@@ -1,12 +0,0 @@
-import type { AnyLeafLowProfile } from '@emeryld/rrroutes-contract';
-import { type SerializedLeafContract } from './serializeLeafContract';
-import type { SerializableSchema } from './schemaIntrospection';
-export type FlatSchemaEntry = {
-    type: string;
-    nullable: boolean;
-    optional: boolean;
-    literal?: unknown;
-};
-export type FlatSchemaMap = Record<string, FlatSchemaEntry>;
-export declare function flattenSerializableSchema(schema: SerializableSchema | undefined, path: string): FlatSchemaMap;
-export declare function flattenLeafSchemas(leaf: AnyLeafLowProfile | SerializedLeafContract): FlatSchemaMap;

package/dist/index.d.ts

@@ -1,7 +0,0 @@
-export * from './schemaIntrospection';
-export * from './serializeLeafContract';
-export * from './flattenSchema';
-export * from './exportFinalizedLeaves';
-export * from './exportFinalizedLeaves.cli';
-export * from './defaultViewerTemplate';
-export * from './extractLeafSourceByAst';

package/dist/schemaIntrospection.d.ts

@@ -1,47 +0,0 @@
-import * as z from 'zod';
-export declare const serializableSchemaKinds: readonly ["object", "string", "number", "boolean", "bigint", "date", "array", "enum", "literal", "union", "record", "tuple", "unknown", "any"];
-export type SerializableSchemaKind = (typeof serializableSchemaKinds)[number];
-export type SerializableSchema = {
-    kind: SerializableSchemaKind;
-    optional?: boolean;
-    nullable?: boolean;
-    description?: string;
-    properties?: Record<string, SerializableSchema>;
-    element?: SerializableSchema;
-    union?: SerializableSchema[];
-    literal?: unknown;
-    enumValues?: string[];
-};
-type ZodAny = z.ZodTypeAny;
-type InternalSchemaKind = SerializableSchemaKind | 'intersection';
-type IntrospectionWalker = (schema: ZodAny | undefined) => SerializableSchema | undefined;
-export type IntrospectionContext = {
-    zod: typeof z;
-    introspect: IntrospectionWalker;
-    getDef: (schema: unknown) => any | undefined;
-    unwrap: (schema: ZodAny) => {
-        base: ZodAny;
-        optional: boolean;
-        nullable: boolean;
-    };
-    getDescription: (schema: ZodAny) => string | undefined;
-};
-export type IntrospectionNode = {
-    schema: ZodAny;
-    base: ZodAny;
-    def: any;
-    kind: InternalSchemaKind;
-    optional: boolean;
-    nullable: boolean;
-    node: SerializableSchema;
-};
-export type SchemaIntrospectionHandler = (args: IntrospectionNode, ctx: IntrospectionContext) => SerializableSchema | undefined;
-export type SchemaIntrospectionHandlerMap = Partial<Record<InternalSchemaKind, SchemaIntrospectionHandler>>;
-export type IntrospectSchemaOptions = {
-    handlers?: SchemaIntrospectionHandlerMap;
-};
-export declare function registerSchemaIntrospectionHandler(kind: InternalSchemaKind, handler: SchemaIntrospectionHandler): void;
-export declare function clearSchemaIntrospectionHandlers(): void;
-export declare function createSchemaIntrospector(options?: IntrospectSchemaOptions): IntrospectionWalker;
-export declare function introspectSchema(schema: ZodAny | undefined, options?: IntrospectSchemaOptions): SerializableSchema | undefined;
-export {};

package/dist/serializeLeafContract.d.ts

@@ -1,31 +0,0 @@
-import { type AnyLeafLowProfile, type FileField } from '@emeryld/rrroutes-contract';
-import { type IntrospectSchemaOptions, type SerializableSchema } from './schemaIntrospection';
-export type ContractLeafSchemas = {
-    body?: SerializableSchema;
-    query?: SerializableSchema;
-    params?: SerializableSchema;
-    output?: SerializableSchema;
-    outputMeta?: SerializableSchema;
-    queryExtension?: SerializableSchema;
-};
-export type SerializedLeafContract = {
-    key: string;
-    method: AnyLeafLowProfile['method'];
-    path: string;
-    cfg: {
-        description?: string;
-        summary?: string;
-        docsGroup?: string;
-        tags?: string[];
-        deprecated?: boolean;
-        stability?: 'experimental' | 'beta' | 'stable' | 'deprecated';
-        docsHidden?: boolean;
-        docsMeta?: Record<string, unknown>;
-        feed?: boolean;
-        bodyFiles?: FileField[];
-        schemas: ContractLeafSchemas;
-    };
-};
-export type SerializeLeafContractOptions = IntrospectSchemaOptions;
-export declare function serializeLeafContract(leaf: AnyLeafLowProfile, options?: SerializeLeafContractOptions): SerializedLeafContract;
-export declare function serializeLeavesContract(leaves: readonly AnyLeafLowProfile[], options?: SerializeLeafContractOptions): SerializedLeafContract[];