gt 2.14.35 → 2.14.36

package/dist/utils/processOpenApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processOpenApi.js","names":[],"sources":["../../src/utils/processOpenApi.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\nimport { unified } from 'unified';\nimport remarkParse from 'remark-parse';\nimport remarkFrontmatter from 'remark-frontmatter';\nimport YAML, { isMap, isScalar } from 'yaml';\nimport type { Root, Content, Yaml } from 'mdast';\nimport { logger } from '../console/logger.js';\nimport { createFileMapping } from '../formats/files/fileMapping.js';\nimport { Settings } from '../types/index.js';\n\ntype SpecAnalysis = {\n  absPath: string;\n  configPath: string; // as provided in config (for formatting)\n  operations: Set<string>;\n  schemas: Set<string>;\n  webhooks: Set<string>;\n};\n\ntype ParsedOpenApiValue =\n  | {\n      kind: 'operation';\n      specPath?: string;\n      method: string;\n      operationPath: string;\n    }\n  | {\n      kind: 'webhook';\n      specPath?: string;\n      name: string;\n    };\n\ntype ParsedSchemaValue = {\n  specPath?: string;\n  schemaName: string;\n};\n\nconst HTTP_METHODS = new Set([\n  'GET',\n  'POST',\n  'PUT',\n  'PATCH',\n  'DELETE',\n  'OPTIONS',\n  'HEAD',\n  'TRACE',\n]);\nconst OPENAPI_SPEC_EXTENSIONS = new Set(['.json', '.yaml', '.yml']);\n\n/**\n * Postprocess Mintlify OpenAPI references to point to locale-specific spec files.\n * - Uses openapi.files (ordered) to resolve ambiguities (first match wins).\n * - Relies on the user's json transform rules for locale paths.\n * - Warns on missing/ambiguous references but keeps behavior deterministic.\n */\nexport default async function processOpenApi(\n  settings: Settings,\n  includeFiles?: Set<string>\n) {\n  const openapiConfig = settings.options?.mintlify?.openapi;\n  if (!openapiConfig || !openapiConfig.files?.length) return;\n  if (!settings.files) return;\n\n  const configDir = path.dirname(settings.config);\n  const specAnalyses = buildSpecAnalyses(openapiConfig.files, configDir);\n  if (!specAnalyses.length) return;\n\n  const warnings = new Set<string>();\n  const { resolvedPaths, placeholderPaths, transformPaths, transformFormats } =\n    settings.files;\n  const fileMapping = createFileMapping(\n    resolvedPaths,\n    placeholderPaths,\n    transformPaths,\n    transformFormats,\n    settings.locales,\n    settings.defaultLocale\n  );\n  const fileMappingAbs: Record<string, Record<string, string>> = {};\n  for (const [locale, mapping] of Object.entries(fileMapping)) {\n    fileMappingAbs[locale] = {};\n    for (const [src, dest] of Object.entries(mapping)) {\n      const absSrc = path.resolve(configDir, src);\n      const absDest = path.resolve(configDir, dest);\n      fileMappingAbs[locale][absSrc] = absDest;\n    }\n  }\n\n  // Also rewrite default-locale source files so they use the deterministic spec selection\n  const defaultFiles = [\n    ...(resolvedPaths.mdx || []),\n    ...(resolvedPaths.md || []),\n  ];\n  for (const filePath of defaultFiles) {\n    if (!fs.existsSync(filePath)) continue;\n    const content = fs.readFileSync(filePath, 'utf8');\n    const updated = rewriteFrontmatter(\n      content,\n      filePath,\n      settings.defaultLocale,\n      specAnalyses,\n      fileMappingAbs,\n      warnings,\n      configDir\n    );\n    if (updated?.changed) {\n      await fs.promises.writeFile(filePath, updated.content, 'utf8');\n    }\n  }\n\n  for (const [locale, filesMap] of Object.entries(fileMapping)) {\n    const targetFiles = Object.values(filesMap).filter(\n      (p) =>\n        (p.endsWith('.md') || p.endsWith('.mdx')) &&\n        (!includeFiles || includeFiles.has(p))\n    );\n\n    for (const filePath of targetFiles) {\n      if (!fs.existsSync(filePath)) continue;\n      const content = fs.readFileSync(filePath, 'utf8');\n      const updated = rewriteFrontmatter(\n        content,\n        filePath,\n        locale,\n        specAnalyses,\n        fileMappingAbs,\n        warnings,\n        configDir\n      );\n\n      if (updated?.changed) {\n        await fs.promises.writeFile(filePath, updated.content, 'utf8');\n      }\n    }\n  }\n\n  const docsJsonTargets = collectDocsJsonTargets(\n    settings,\n    fileMapping,\n    includeFiles\n  );\n  for (const target of docsJsonTargets) {\n    if (!fs.existsSync(target.path)) continue;\n    const content = fs.readFileSync(target.path, 'utf8');\n    const updated = rewriteDocsJsonOpenApi(\n      content,\n      target.path,\n      target.localeHint,\n      specAnalyses,\n      fileMappingAbs,\n      fileMapping,\n      warnings,\n      configDir,\n      settings.defaultLocale\n    );\n    if (updated?.changed) {\n      await fs.promises.writeFile(target.path, updated.content, 'utf8');\n    }\n  }\n\n  for (const message of warnings) {\n    logger.warn(message);\n  }\n}\n\nfunction collectDocsJsonTargets(\n  settings: Settings,\n  fileMapping: Record<string, Record<string, string>>,\n  includeFiles?: Set<string>\n): Array<{ path: string; localeHint?: string }> {\n  const targets: Array<{ path: string; localeHint?: string }> = [];\n  const seen = new Map<string, Set<string>>();\n\n  const addTarget = (filePath: string, locale?: string) => {\n    const canonicalPath = path.resolve(filePath);\n    if (\n      includeFiles &&\n      !includeFiles.has(filePath) &&\n      !includeFiles.has(canonicalPath)\n    ) {\n      return;\n    }\n    const locales = seen.get(canonicalPath) ?? new Set<string>();\n    if (locale) locales.add(locale);\n    seen.set(canonicalPath, locales);\n  };\n\n  if (!includeFiles && settings.files?.resolvedPaths.json) {\n    for (const filePath of settings.files.resolvedPaths.json) {\n      addTarget(filePath, settings.defaultLocale);\n    }\n  }\n\n  for (const [locale, filesMap] of Object.entries(fileMapping)) {\n    for (const filePath of Object.values(filesMap)) {\n      if (!filePath.endsWith('.json')) continue;\n      addTarget(filePath, locale);\n    }\n  }\n\n  for (const [filePath, locales] of seen.entries()) {\n    const localeHint = locales.size === 1 ? Array.from(locales)[0] : undefined;\n    targets.push({ path: filePath, localeHint });\n  }\n\n  return targets;\n}\n\nfunction isMintlifyDocsJson(filePath: string, json: unknown): boolean {\n  if (!isRecord(json)) return false;\n  const schema = json.$schema;\n  if (typeof schema === 'string') {\n    return (\n      schema.includes('mintlify.com/docs.json') ||\n      schema.includes('mintlify.com/mint.json')\n    );\n  }\n  const base = path.basename(filePath);\n  return base === 'docs.json' || base === 'mint.json';\n}\n\nfunction rewriteDocsJsonOpenApi(\n  content: string,\n  filePath: string,\n  localeHint: string | undefined,\n  specs: SpecAnalysis[],\n  fileMappingAbs: Record<string, Record<string, string>>,\n  fileMappingRel: Record<string, Record<string, string>>,\n  warnings: Set<string>,\n  configDir: string,\n  defaultLocale: string\n): { changed: boolean; content: string } | null {\n  let json: unknown;\n  try {\n    json = JSON.parse(content);\n  } catch {\n    return null;\n  }\n\n  if (!isMintlifyDocsJson(filePath, json)) return null;\n\n  let changed = false;\n\n  const visitNode = (node: unknown, activeLocale?: string) => {\n    if (Array.isArray(node)) {\n      node.forEach((item) => visitNode(item, activeLocale));\n      return;\n    }\n    if (!isRecord(node)) return;\n\n    let nextLocale = activeLocale;\n    if (typeof node.language === 'string') {\n      nextLocale = node.language;\n    }\n\n    const locale = nextLocale || localeHint || defaultLocale;\n\n    if (typeof node.openapi === 'string') {\n      const sourceValue = node.openapi;\n      const localizedSource = localizeDocsJsonSpecPath(\n        sourceValue,\n        locale,\n        filePath,\n        specs,\n        fileMappingAbs,\n        fileMappingRel,\n        warnings,\n        configDir\n      );\n      if (localizedSource && localizedSource !== sourceValue) {\n        node.openapi = localizedSource;\n        changed = true;\n      }\n    } else if (isRecord(node.openapi)) {\n      const openapiConfig = node.openapi as Record<string, unknown>;\n      const sourceValue = openapiConfig.source;\n      if (typeof sourceValue === 'string') {\n        const localizedSource = localizeDocsJsonSpecPath(\n          sourceValue,\n          locale,\n          filePath,\n          specs,\n          fileMappingAbs,\n          fileMappingRel,\n          warnings,\n          configDir\n        );\n        if (localizedSource && localizedSource !== sourceValue) {\n          openapiConfig.source = localizedSource;\n          changed = true;\n        }\n      }\n    }\n\n    if (Array.isArray(node.pages)) {\n      const pages = node.pages;\n      for (let i = 0; i < pages.length; i += 1) {\n        const page = pages[i];\n        if (typeof page !== 'string') continue;\n        const updated = stripLocaleFromOpenApiPage(page, locale);\n        if (updated !== page) {\n          pages[i] = updated;\n          changed = true;\n        }\n      }\n    }\n\n    for (const value of Object.values(node)) {\n      visitNode(value, nextLocale);\n    }\n  };\n\n  visitNode(json, undefined);\n\n  if (!changed) return null;\n  return { changed, content: JSON.stringify(json, null, 2) };\n}\n\nfunction stripLocaleFromOpenApiPage(value: string, locale: string): string {\n  const trimmed = value.trim();\n  const prefix = `${locale}/`;\n  if (!trimmed.startsWith(prefix)) return value;\n  const candidate = trimmed.slice(prefix.length);\n  const parsed = parseOpenApiValue(candidate);\n  if (!parsed) return value;\n  return candidate;\n}\n\nfunction localizeDocsJsonSpecPath(\n  source: string,\n  locale: string,\n  filePath: string,\n  specs: SpecAnalysis[],\n  fileMappingAbs: Record<string, Record<string, string>>,\n  _fileMappingRel: Record<string, Record<string, string>>,\n  warnings: Set<string>,\n  configDir: string\n): string | null {\n  const resolvedAbs = resolveDocsJsonSpecPath(source, filePath, configDir);\n  const matched = matchSpecBySource(source, resolvedAbs, specs, warnings);\n  if (!matched) return source;\n\n  const localizedSpecPath = resolveLocalizedSpecPath(\n    matched,\n    locale,\n    fileMappingAbs,\n    configDir,\n    source\n  );\n  const localizedAbs = resolveDocsJsonSpecPath(\n    localizedSpecPath,\n    filePath,\n    configDir\n  );\n  if (!fs.existsSync(localizedAbs)) {\n    warnings.add(\n      `OpenAPI source \"${source}\" localized for locale \"${locale}\" points to a missing file (${localizedAbs}). Keeping original source.`\n    );\n    return source;\n  }\n\n  const rel = normalizeSlashes(path.relative(configDir, localizedAbs));\n  return formatSpecPathForDocsJson(rel, source);\n}\n\nfunction resolveDocsJsonSpecPath(\n  source: string,\n  filePath: string,\n  configDir: string\n): string {\n  if (source.startsWith('/')) {\n    return path.resolve(configDir, source.replace(/^\\/+/, ''));\n  }\n  if (source.startsWith('./') || source.startsWith('../')) {\n    return path.resolve(path.dirname(filePath), source);\n  }\n  return path.resolve(configDir, source);\n}\n\nfunction matchSpecBySource(\n  source: string,\n  resolvedAbs: string,\n  specs: SpecAnalysis[],\n  warnings: Set<string>\n): SpecAnalysis | null {\n  const exact = specs.find((spec) => samePath(resolvedAbs, spec.absPath));\n  if (exact) return exact;\n\n  const normalizedExplicit = normalizeSlashes(source).replace(/^\\.?\\/+/, '');\n  const explicitWithoutExt = stripExtension(normalizedExplicit);\n  const explicitBase = path.basename(normalizedExplicit);\n  const explicitBaseWithoutExt = stripExtension(explicitBase);\n  const matches = specs.filter((spec) => {\n    const configPath = normalizeSlashes(spec.configPath).replace(/^\\.?\\/+/, '');\n    const configBase = path.basename(configPath);\n    const configPathNoExt = stripExtension(configPath);\n    const configBaseNoExt = stripExtension(configBase);\n    return (\n      configPath === normalizedExplicit ||\n      configPathNoExt === explicitWithoutExt ||\n      configBase === explicitBase ||\n      configBaseNoExt === explicitBaseWithoutExt\n    );\n  });\n\n  if (matches.length === 1) return matches[0];\n  if (matches.length > 1) {\n    warnings.add(\n      `OpenAPI source \"${source}\" matches multiple specs (${matches\n        .map((m) => m.configPath)\n        .join(\n          ', '\n        )}). Using the first configured match (${matches[0].configPath}).`\n    );\n    return matches[0];\n  }\n\n  return null;\n}\n\nfunction formatSpecPathForDocsJson(\n  relativePath: string,\n  originalPathText: string\n): string {\n  const normalized = normalizeSlashes(relativePath);\n  const base = normalized.replace(/^\\.\\//, '').replace(/\\/+/g, '/');\n\n  if (originalPathText.startsWith('/')) {\n    return `/${base.replace(/^\\/+/, '')}`;\n  }\n  if (originalPathText.startsWith('../')) {\n    return normalized;\n  }\n  if (originalPathText.startsWith('./')) {\n    return `./${base.replace(/^\\/+/, '')}`;\n  }\n  return base.replace(/^\\/+/, '');\n}\n\n/**\n * Resolve configured OpenAPI files to absolute paths and collect the operations,\n * schemas, and webhooks they expose. Warns and skips when files are missing,\n * unsupported (non-JSON/YAML), or fail to parse so later steps can continue gracefully.\n */\nfunction buildSpecAnalyses(\n  openapiFiles: string[],\n  configDir: string\n): SpecAnalysis[] {\n  const analyses: SpecAnalysis[] = [];\n\n  for (const configEntry of openapiFiles) {\n    const absPath = path.resolve(configDir, configEntry);\n    if (!fs.existsSync(absPath)) {\n      logger.warn(`OpenAPI file not found: ${configEntry}`);\n      continue;\n    }\n    const ext = path.extname(absPath).toLowerCase();\n    if (!OPENAPI_SPEC_EXTENSIONS.has(ext)) {\n      logger.warn(\n        `Skipping OpenAPI file (only .json/.yml/.yaml supported): ${configEntry}`\n      );\n      continue;\n    }\n\n    let spec: unknown;\n    try {\n      const raw = fs.readFileSync(absPath, 'utf8');\n      spec = ext === '.json' ? JSON.parse(raw) : YAML.parse(raw);\n    } catch {\n      const format = ext === '.json' ? 'JSON' : 'YAML';\n      logger.warn(`Failed to parse OpenAPI ${format}: ${configEntry}`);\n      continue;\n    }\n\n    analyses.push({\n      absPath,\n      configPath: configEntry,\n      operations: extractOperations(spec),\n      schemas: extractSchemas(spec),\n      webhooks: extractWebhooks(spec),\n    });\n  }\n\n  return analyses;\n}\n\nfunction isRecord(val: unknown): val is Record<string, unknown> {\n  return typeof val === 'object' && val !== null;\n}\n\n/**\n * Collect path+method identifiers (e.g., \"POST /foo\") from an OpenAPI spec.\n * Safely no-ops when paths is missing or malformed.\n */\nfunction extractOperations(spec: unknown): Set<string> {\n  const ops = new Set<string>();\n  if (!isRecord(spec) || !isRecord(spec.paths)) return ops;\n  const paths = spec.paths as Record<string, unknown>;\n\n  for (const [route, methods] of Object.entries(paths)) {\n    if (!isRecord(methods)) continue;\n    for (const [method, operation] of Object.entries(methods)) {\n      if (!isRecord(operation)) continue;\n      const upper = method.toUpperCase();\n      if (!HTTP_METHODS.has(upper)) continue;\n      ops.add(`${upper} ${route}`);\n    }\n  }\n  return ops;\n}\n\n/**\n * Collect schema names from components.schemas.\n * Returns empty set if components/schemas are missing or malformed.\n */\nfunction extractSchemas(spec: unknown): Set<string> {\n  if (!isRecord(spec) || !isRecord(spec.components)) return new Set();\n  const components = spec.components as Record<string, unknown>;\n  if (!isRecord(components.schemas)) return new Set();\n  return new Set(Object.keys(components.schemas as Record<string, unknown>));\n}\n\n/**\n * Collect webhook names from webhooks (OpenAPI 3.1+).\n * Returns empty set if webhooks is missing or malformed.\n */\nfunction extractWebhooks(spec: unknown): Set<string> {\n  if (!isRecord(spec) || !isRecord(spec.webhooks)) return new Set();\n  return new Set(Object.keys(spec.webhooks as Record<string, unknown>));\n}\n\n/**\n * Parse MDX/MD frontmatter, rewrite openapi/openapi-schema entries to the\n * resolved (possibly localized) spec path, and return updated content.\n * Uses remark to find the YAML node so the rest of the document remains\n * untouched. When parsing fails or no relevant keys exist, it returns null.\n */\nfunction rewriteFrontmatter(\n  content: string,\n  filePath: string,\n  locale: string,\n  specs: SpecAnalysis[],\n  fileMapping: Record<string, Record<string, string>>,\n  warnings: Set<string>,\n  configDir: string\n): { changed: boolean; content: string } | null {\n  let tree: Root;\n  try {\n    tree = unified()\n      .use(remarkParse)\n      .use(remarkFrontmatter, ['yaml', 'toml'])\n      .parse(content) as Root;\n  } catch {\n    return null;\n  }\n\n  const yamlNode = (tree.children as Content[]).find(\n    (node): node is Yaml => (node as Yaml).type === 'yaml'\n  );\n  if (\n    !yamlNode ||\n    !yamlNode.position ||\n    yamlNode.position.start?.offset === undefined\n  ) {\n    return null;\n  }\n\n  const start = yamlNode.position.start.offset as number;\n  const end = yamlNode.position.end.offset as number;\n  const frontmatterRaw: string = yamlNode.value || '';\n\n  const doc = YAML.parseDocument(frontmatterRaw, {\n    prettyErrors: false,\n    keepSourceTokens: true,\n  });\n  if (doc.errors?.length) return null;\n  if (!isMap(doc.contents)) return null;\n\n  let changed = false;\n\n  const openapiNode = doc.get('openapi', true);\n  if (isScalar(openapiNode) && typeof openapiNode.value === 'string') {\n    const parsedValue = parseOpenApiValue(openapiNode.value);\n    if (parsedValue) {\n      const matchKey =\n        parsedValue.kind === 'operation'\n          ? {\n              type: 'operation' as const,\n              key: `${parsedValue.method.toUpperCase()} ${parsedValue.operationPath}`,\n            }\n          : { type: 'webhook' as const, key: parsedValue.name };\n\n      const spec = resolveSpec(\n        parsedValue.specPath,\n        specs,\n        filePath,\n        configDir,\n        warnings,\n        describeOpenApiRef(parsedValue),\n        matchKey\n      );\n      if (spec) {\n        const descriptor = formatOpenApiDescriptor(parsedValue);\n        const localizedSpecPath = resolveLocalizedSpecPath(\n          spec,\n          locale,\n          fileMapping,\n          configDir,\n          parsedValue.specPath || spec.configPath\n        );\n        const newValue = `${localizedSpecPath} ${descriptor}`.trim();\n        if (newValue !== openapiNode.value) {\n          doc.set('openapi', newValue);\n          changed = true;\n        }\n      }\n    }\n  }\n\n  const schemaNode = doc.get('openapi-schema', true);\n  if (isScalar(schemaNode) && typeof schemaNode.value === 'string') {\n    const parsedValue = parseSchemaValue(schemaNode.value);\n    if (parsedValue) {\n      const spec = resolveSpec(\n        parsedValue.specPath,\n        specs,\n        filePath,\n        configDir,\n        warnings,\n        `schema \"${parsedValue.schemaName}\"`,\n        { type: 'schema', key: parsedValue.schemaName }\n      );\n      if (spec) {\n        const localizedSpecPath = resolveLocalizedSpecPath(\n          spec,\n          locale,\n          fileMapping,\n          configDir,\n          parsedValue.specPath || spec.configPath\n        );\n        const newValue =\n          `${localizedSpecPath} ${parsedValue.schemaName}`.trim();\n        if (newValue !== schemaNode.value) {\n          doc.set('openapi-schema', newValue);\n          changed = true;\n        }\n      }\n    }\n  }\n\n  if (!changed) return null;\n\n  const fmString = doc.toString().trimEnd();\n  const rebuilt = `${content.slice(0, start)}---\\n${fmString}\\n---${content.slice(end)}`;\n  return { changed, content: rebuilt };\n}\n\nfunction stripWrappingQuotes(value: string): string {\n  return value.trim().replace(/^['\"]|['\"]$/g, '');\n}\n\n/**\n * Parse frontmatter openapi string into spec/method/path or webhook.\n * Supports optional leading spec file, the webhook keyword, quoted values,\n * and forgiving whitespace. Returns null when the structure is unrecognized.\n */\nfunction parseOpenApiValue(value: string): ParsedOpenApiValue | null {\n  const stripped = stripWrappingQuotes(value);\n  const tokens = stripped.split(/\\s+/).filter(Boolean);\n  if (!tokens.length) return null;\n\n  let cursor = 0;\n  let specPath: string | undefined;\n  const first = tokens[0];\n  const second = tokens[1];\n  const methodCandidate = second?.toUpperCase();\n  const firstLooksLikeSpec =\n    hasOpenApiSpecExtension(first) ||\n    (second &&\n      (second.toLowerCase() === 'webhook' ||\n        (methodCandidate && HTTP_METHODS.has(methodCandidate))));\n\n  if (firstLooksLikeSpec) {\n    specPath = tokens[0];\n    cursor = 1;\n  }\n  if (cursor >= tokens.length) return null;\n\n  const keyword = tokens[cursor];\n  if (keyword.toLowerCase() === 'webhook') {\n    const name = tokens.slice(cursor + 1).join(' ');\n    if (!name) return null;\n    return { kind: 'webhook', specPath, name };\n  }\n\n  const method = keyword.toUpperCase();\n  if (!HTTP_METHODS.has(method)) return null;\n  const operationPath = tokens.slice(cursor + 1).join(' ');\n  if (!operationPath) return null;\n  return { kind: 'operation', specPath, method, operationPath };\n}\n\n/**\n * Parse frontmatter openapi-schema string into spec/schemaName.\n * Accepts optional leading spec file and quoted values; returns null on invalid\n * shapes so callers can skip rewrites gracefully.\n */\nfunction parseSchemaValue(value: string): ParsedSchemaValue | null {\n  const stripped = stripWrappingQuotes(value);\n  const tokens = stripped.split(/\\s+/).filter(Boolean);\n  if (!tokens.length) return null;\n  let cursor = 0;\n  let specPath: string | undefined;\n  if (hasOpenApiSpecExtension(tokens[0])) {\n    specPath = tokens[0];\n    cursor = 1;\n  }\n  const schemaName = tokens.slice(cursor).join(' ');\n  if (!schemaName) return null;\n  return { specPath, schemaName };\n}\n\n/**\n * Choose which configured spec a reference should use.\n * - If an explicit spec path is provided, resolve it relative to the config\n *   and the referencing file, warn when unknown, and bail.\n * - Otherwise, try to match by operation/webhook/schema name; resolve\n *   ambiguity using config order and warn when ambiguous or missing.\n */\nfunction resolveSpec(\n  explicitPath: string | undefined,\n  specs: SpecAnalysis[],\n  filePath: string,\n  configDir: string,\n  warnings: Set<string>,\n  refDescription: string,\n  match: { type: 'operation' | 'webhook' | 'schema'; key: string }\n): SpecAnalysis | null {\n  if (!specs.length) return null;\n\n  if (explicitPath) {\n    const normalizedExplicit = normalizeSlashes(\n      explicitPath.replace(/^\\.?\\/+/, '')\n    );\n    const candidates = [\n      path.resolve(configDir, normalizedExplicit),\n      path.resolve(path.dirname(filePath), normalizedExplicit),\n    ];\n    const foundSpec = specs.find((spec) => {\n      const normalizedSpecPath = normalizeSlashes(spec.absPath);\n      return candidates.some((candidate) =>\n        samePath(candidate, normalizedSpecPath)\n      );\n    });\n    if (foundSpec) {\n      if (specHasMatch(foundSpec, match)) {\n        return foundSpec;\n      }\n\n      const alternatives = specs.filter(\n        (spec) => spec !== foundSpec && specHasMatch(spec, match)\n      );\n      if (alternatives.length === 1) {\n        warnings.add(\n          `OpenAPI reference ${refDescription} in ${filePath} points to ${foundSpec.configPath}, but the entry was not found there. Using ${alternatives[0].configPath} instead.`\n        );\n        return alternatives[0];\n      }\n      if (alternatives.length > 1) {\n        warnings.add(\n          `OpenAPI reference ${refDescription} in ${filePath} points to ${foundSpec.configPath}, but the entry was not found there and matches multiple specs (${alternatives\n            .map((spec) => spec.configPath)\n            .join(', ')}). Skipping localization for this reference.`\n        );\n        return null;\n      }\n\n      warnings.add(\n        `OpenAPI reference ${refDescription} in ${filePath} points to ${foundSpec.configPath}, but the entry was not found in any configured spec. Skipping localization for this reference.`\n      );\n      return null;\n    }\n\n    const explicitWithoutExt = stripExtension(normalizedExplicit);\n    const explicitBase = path.basename(normalizedExplicit);\n    const explicitBaseWithoutExt = stripExtension(explicitBase);\n    const matches = specs.filter((spec) => {\n      const configPath = normalizeSlashes(spec.configPath).replace(\n        /^\\.?\\/+/,\n        ''\n      );\n      const configBase = path.basename(configPath);\n      const configPathNoExt = stripExtension(configPath);\n      const configBaseNoExt = stripExtension(configBase);\n      return (\n        configPath === normalizedExplicit ||\n        configPathNoExt === explicitWithoutExt ||\n        configBase === explicitBase ||\n        configBaseNoExt === explicitBaseWithoutExt\n      );\n    });\n    if (matches.length === 1) return matches[0];\n    if (matches.length > 1) {\n      warnings.add(\n        `OpenAPI reference ${refDescription} in ${filePath} matches multiple specs (${matches\n          .map((m) => m.configPath)\n          .join(\n            ', '\n          )}). Using the first configured match (${matches[0].configPath}).`\n      );\n      return matches[0];\n    }\n\n    warnings.add(\n      `OpenAPI reference ${refDescription} in ${filePath} points to an unconfigured spec (${explicitPath}). Skipping localization for this reference.`\n    );\n    return null;\n  }\n\n  // No explicit spec: try to find by contents\n  const matches = specs.filter((spec) => {\n    if (match.type === 'schema') {\n      return spec.schemas.has(match.key);\n    }\n    if (match.type === 'webhook') {\n      return spec.webhooks.has(match.key);\n    }\n    // operation\n    return spec.operations.has(match.key);\n  });\n\n  if (matches.length === 1) return matches[0];\n  if (matches.length > 1) {\n    warnings.add(\n      `OpenAPI reference ${refDescription} in ${filePath} is available in multiple specs. Skipping localization for this reference.`\n    );\n    return null;\n  }\n\n  warnings.add(\n    `OpenAPI reference ${refDescription} in ${filePath} was not found in any configured spec. Skipping localization for this reference.`\n  );\n  return null;\n}\n\nfunction specHasMatch(\n  spec: SpecAnalysis,\n  match: { type: 'operation' | 'webhook' | 'schema'; key: string }\n): boolean {\n  if (match.type === 'schema') {\n    return spec.schemas.has(match.key);\n  }\n  if (match.type === 'webhook') {\n    return spec.webhooks.has(match.key);\n  }\n  return spec.operations.has(match.key);\n}\n\n/**\n * Map a spec to the locale-specific file path when available and normalize it\n * for frontmatter. Falls back to the source spec when the locale copy does\n * not exist to preserve deterministic behavior.\n */\nfunction resolveLocalizedSpecPath(\n  spec: SpecAnalysis,\n  locale: string,\n  fileMapping: Record<string, Record<string, string>>,\n  configDir: string,\n  originalPathText?: string\n): string {\n  const mapping = fileMapping[locale]?.[spec.absPath];\n  const chosenAbs = mapping || spec.absPath;\n  const rel = normalizeSlashes(path.relative(configDir, chosenAbs));\n  const rooted = `/${rel.replace(/^\\/+/, '')}`;\n  return formatSpecPathForFrontmatter(\n    rooted,\n    originalPathText || spec.configPath\n  );\n}\n\n/**\n * Format the path that will be written back to frontmatter:\n * - Preserve the user's absolute style when they used a leading slash.\n * - Preserve upward relative references (../) exactly.\n * - Otherwise return a repo-root-relative path with a leading slash so Mintlify\n *   resolves consistently regardless of the MDX file location.\n */\nfunction formatSpecPathForFrontmatter(\n  relativePath: string,\n  originalPathText: string\n): string {\n  const normalized = normalizeSlashes(relativePath);\n  const base = normalized.replace(/^\\.\\//, '').replace(/\\/+/g, '/');\n\n  if (originalPathText.startsWith('/')) {\n    // Force repo-root absolute style\n    return `/${base.replace(/^\\/+/, '')}`;\n  }\n\n  if (originalPathText.startsWith('../')) {\n    // Preserve explicit relative upward references\n    return normalized;\n  }\n\n  // Default to repo-root relative with leading slash to avoid resolving relative to the MDX directory\n  return `/${base.replace(/^\\/+/, '')}`;\n}\n\n/** Normalize the descriptive portion after the spec path for frontmatter. */\nfunction formatOpenApiDescriptor(value: ParsedOpenApiValue): string {\n  if (value.kind === 'webhook') return `webhook ${value.name}`;\n  return `${value.method.toUpperCase()} ${value.operationPath}`;\n}\n\n/** Human-readable description a specific OpenAPI reference. */\nfunction describeOpenApiRef(value: ParsedOpenApiValue): string {\n  if (value.kind === 'webhook') return `webhook ${value.name}`;\n  return `${value.method.toUpperCase()} ${value.operationPath}`;\n}\n\n/** Remove a single trailing file extension while preserving directory segments. */\nfunction stripExtension(p: string): string {\n  const parsed = path.parse(p);\n  return normalizeSlashes(path.join(parsed.dir, parsed.name));\n}\n\nfunction hasOpenApiSpecExtension(value: string): boolean {\n  return OPENAPI_SPEC_EXTENSIONS.has(path.extname(value).toLowerCase());\n}\n\n/** Normalize separators for stable comparisons and output. */\nfunction normalizeSlashes(p: string): string {\n  return p.replace(/\\\\/g, '/');\n}\n\n/** Compare paths after resolution to avoid casing/separator mismatches. */\nfunction samePath(a: string, b: string): boolean {\n  return path.resolve(a) === path.resolve(b);\n}\n"],"mappings":"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"}

package/dist/utils/resolveMintlifyRefs.js

@@ -1,115 +1,99 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import { logger } from '../console/logger.js';
-import chalk from 'chalk';
-import micromatch from 'micromatch';
+import { logger } from "../console/logger.js";
+import chalk from "chalk";
+import path from "node:path";
+import fs from "node:fs";
+import micromatch from "micromatch";
+//#region src/utils/resolveMintlifyRefs.ts
 /**
- * Resolve all Mintlify $ref references in a parsed JSON object.
- *
- * Returns the fully-expanded JSON and a refMap that tracks which subtrees
- * came from which files (used later to split translated output back into
- * the same file topology).
- */
-export function resolveMintlifyRefs(json, filePath) {
-    const refMap = new Map();
-    const resolved = resolveNode(json, path.dirname(path.resolve(filePath)), '', new Set(), refMap);
-    return { resolved, refMap };
+* Resolve all Mintlify $ref references in a parsed JSON object.
+*
+* Returns the fully-expanded JSON and a refMap that tracks which subtrees
+* came from which files (used later to split translated output back into
+* the same file topology).
+*/
+function resolveMintlifyRefs(json, filePath) {
+	const refMap = /* @__PURE__ */ new Map();
+	return {
+		resolved: resolveNode(json, path.dirname(path.resolve(filePath)), "", /* @__PURE__ */ new Set(), refMap),
+		refMap
+	};
 }
 function resolveNode(node, baseDir, pointer, visiting, refMap) {
-    if (node === null || typeof node !== 'object')
-        return node;
-    if (Array.isArray(node)) {
-        return node.map((item, i) => resolveNode(item, baseDir, `${pointer}/${i}`, visiting, refMap));
-    }
-    const obj = node;
-    if (typeof obj['$ref'] === 'string') {
-        return resolveRef(obj, baseDir, pointer, visiting, refMap);
-    }
-    const result = {};
-    for (const [key, value] of Object.entries(obj)) {
-        result[key] = resolveNode(value, baseDir, `${pointer}/${key}`, visiting, refMap);
-    }
-    return result;
+	if (node === null || typeof node !== "object") return node;
+	if (Array.isArray(node)) return node.map((item, i) => resolveNode(item, baseDir, `${pointer}/${i}`, visiting, refMap));
+	const obj = node;
+	if (typeof obj["$ref"] === "string") return resolveRef(obj, baseDir, pointer, visiting, refMap);
+	const result = {};
+	for (const [key, value] of Object.entries(obj)) result[key] = resolveNode(value, baseDir, `${pointer}/${key}`, visiting, refMap);
+	return result;
 }
 function resolveRef(obj, baseDir, pointer, visiting, refMap) {
-    const refPath = obj['$ref'];
-    if (!isRelativePath(refPath)) {
-        logger.warn(chalk.yellow(`Skipping non-relative $ref at ${pointer || '/'}: ${refPath}`));
-        const { $ref: _, ...rest } = obj;
-        return rest;
-    }
-    const resolvedFilePath = path.resolve(baseDir, refPath);
-    if (visiting.has(resolvedFilePath)) {
-        logger.warn(chalk.yellow(`Circular $ref detected at ${pointer || '/'}: ${refPath}`));
-        const { $ref: _, ...rest } = obj;
-        return rest;
-    }
-    if (!fs.existsSync(resolvedFilePath)) {
-        logger.warn(chalk.yellow(`$ref file not found at ${pointer || '/'}: ${refPath} (resolved to ${resolvedFilePath})`));
-        const { $ref: _, ...rest } = obj;
-        return rest;
-    }
-    let fileContent;
-    try {
-        fileContent = fs.readFileSync(resolvedFilePath, 'utf-8');
-    }
-    catch {
-        logger.warn(chalk.yellow(`Failed to read $ref file: ${resolvedFilePath}`));
-        const { $ref: _, ...rest } = obj;
-        return rest;
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(fileContent);
-    }
-    catch {
-        logger.warn(chalk.yellow(`$ref file is not valid JSON: ${resolvedFilePath}`));
-        const { $ref: _, ...rest } = obj;
-        return rest;
-    }
-    // Record provenance before recursive resolution
-    refMap.set(pointer, {
-        sourceFile: resolvedFilePath,
-        refPath,
-        containingDir: baseDir,
-        originalContent: parsed,
-    });
-    // Recursively resolve nested $ref in the referenced file
-    const refFileDir = path.dirname(resolvedFilePath);
-    const nextVisiting = new Set(visiting);
-    nextVisiting.add(resolvedFilePath);
-    const resolvedContent = resolveNode(parsed, refFileDir, pointer, nextVisiting, refMap);
-    // Apply Mintlify merge rules
-    const { $ref: _, ...siblings } = obj;
-    if (resolvedContent !== null &&
-        typeof resolvedContent === 'object' &&
-        !Array.isArray(resolvedContent)) {
-        // Object: merge siblings on top (siblings take precedence)
-        return { ...resolvedContent, ...siblings };
-    }
-    // Non-object (array, string, number, etc.): replace entirely, drop siblings
-    return resolvedContent;
+	const refPath = obj["$ref"];
+	if (!isRelativePath(refPath)) {
+		logger.warn(chalk.yellow(`Skipping non-relative $ref at ${pointer || "/"}: ${refPath}`));
+		const { $ref: _, ...rest } = obj;
+		return rest;
+	}
+	const resolvedFilePath = path.resolve(baseDir, refPath);
+	if (visiting.has(resolvedFilePath)) {
+		logger.warn(chalk.yellow(`Circular $ref detected at ${pointer || "/"}: ${refPath}`));
+		const { $ref: _, ...rest } = obj;
+		return rest;
+	}
+	if (!fs.existsSync(resolvedFilePath)) {
+		logger.warn(chalk.yellow(`$ref file not found at ${pointer || "/"}: ${refPath} (resolved to ${resolvedFilePath})`));
+		const { $ref: _, ...rest } = obj;
+		return rest;
+	}
+	let fileContent;
+	try {
+		fileContent = fs.readFileSync(resolvedFilePath, "utf-8");
+	} catch {
+		logger.warn(chalk.yellow(`Failed to read $ref file: ${resolvedFilePath}`));
+		const { $ref: _, ...rest } = obj;
+		return rest;
+	}
+	let parsed;
+	try {
+		parsed = JSON.parse(fileContent);
+	} catch {
+		logger.warn(chalk.yellow(`$ref file is not valid JSON: ${resolvedFilePath}`));
+		const { $ref: _, ...rest } = obj;
+		return rest;
+	}
+	refMap.set(pointer, {
+		sourceFile: resolvedFilePath,
+		refPath,
+		containingDir: baseDir,
+		originalContent: parsed
+	});
+	const refFileDir = path.dirname(resolvedFilePath);
+	const nextVisiting = new Set(visiting);
+	nextVisiting.add(resolvedFilePath);
+	const resolvedContent = resolveNode(parsed, refFileDir, pointer, nextVisiting, refMap);
+	const { $ref: _, ...siblings } = obj;
+	if (resolvedContent !== null && typeof resolvedContent === "object" && !Array.isArray(resolvedContent)) return {
+		...resolvedContent,
+		...siblings
+	};
+	return resolvedContent;
 }
 /**
- * Check if a file should have $ref resolution applied based on the settings.
- * Returns true if the file matches a jsonSchema entry with resolveRefs: true.
- */
-export function shouldResolveRefs(filePath, options) {
-    if (!options?.jsonSchema)
-        return false;
-    const relative = path.relative(process.cwd(), filePath);
-    for (const [glob, schema] of Object.entries(options.jsonSchema)) {
-        const jsonSchema = schema;
-        if (jsonSchema.resolveRefs && micromatch.isMatch(relative, glob)) {
-            return true;
-        }
-    }
-    return false;
+* Check if a file should have $ref resolution applied based on the settings.
+* Returns true if the file matches a jsonSchema entry with resolveRefs: true.
+*/
+function shouldResolveRefs(filePath, options) {
+	if (!options?.jsonSchema) return false;
+	const relative = path.relative(process.cwd(), filePath);
+	for (const [glob, schema] of Object.entries(options.jsonSchema)) if (schema.resolveRefs && micromatch.isMatch(relative, glob)) return true;
+	return false;
 }
 function isRelativePath(refPath) {
-    if (path.isAbsolute(refPath))
-        return false;
-    if (/^[a-z]+:\/\//i.test(refPath))
-        return false;
-    return true;
+	if (path.isAbsolute(refPath)) return false;
+	if (/^[a-z]+:\/\//i.test(refPath)) return false;
+	return true;
 }
+//#endregion
+export { resolveMintlifyRefs, shouldResolveRefs };
+
+//# sourceMappingURL=resolveMintlifyRefs.js.map

package/dist/utils/resolveMintlifyRefs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveMintlifyRefs.js","names":["jsonSchema"],"sources":["../../src/utils/resolveMintlifyRefs.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\nimport { logger } from '../console/logger.js';\nimport chalk from 'chalk';\nimport micromatch from 'micromatch';\n\nexport type RefMapEntry = {\n  sourceFile: string;\n  refPath: string;\n  containingDir: string;\n  originalContent: unknown;\n};\n\nexport type RefMap = Map<string, RefMapEntry>;\n\nexport type ResolvedRefs = {\n  resolved: unknown;\n  refMap: RefMap;\n};\n\n/**\n * Resolve all Mintlify $ref references in a parsed JSON object.\n *\n * Returns the fully-expanded JSON and a refMap that tracks which subtrees\n * came from which files (used later to split translated output back into\n * the same file topology).\n */\nexport function resolveMintlifyRefs(\n  json: unknown,\n  filePath: string\n): ResolvedRefs {\n  const refMap: RefMap = new Map();\n  const resolved = resolveNode(\n    json,\n    path.dirname(path.resolve(filePath)),\n    '',\n    new Set<string>(),\n    refMap\n  );\n  return { resolved, refMap };\n}\n\nfunction resolveNode(\n  node: unknown,\n  baseDir: string,\n  pointer: string,\n  visiting: Set<string>,\n  refMap: RefMap\n): unknown {\n  if (node === null || typeof node !== 'object') return node;\n\n  if (Array.isArray(node)) {\n    return node.map((item, i) =>\n      resolveNode(item, baseDir, `${pointer}/${i}`, visiting, refMap)\n    );\n  }\n\n  const obj = node as Record<string, unknown>;\n\n  if (typeof obj['$ref'] === 'string') {\n    return resolveRef(obj, baseDir, pointer, visiting, refMap);\n  }\n\n  const result: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(obj)) {\n    result[key] = resolveNode(\n      value,\n      baseDir,\n      `${pointer}/${key}`,\n      visiting,\n      refMap\n    );\n  }\n  return result;\n}\n\nfunction resolveRef(\n  obj: Record<string, unknown>,\n  baseDir: string,\n  pointer: string,\n  visiting: Set<string>,\n  refMap: RefMap\n): unknown {\n  const refPath = obj['$ref'] as string;\n\n  if (!isRelativePath(refPath)) {\n    logger.warn(\n      chalk.yellow(\n        `Skipping non-relative $ref at ${pointer || '/'}: ${refPath}`\n      )\n    );\n    const { $ref: _, ...rest } = obj;\n    return rest;\n  }\n\n  const resolvedFilePath = path.resolve(baseDir, refPath);\n\n  if (visiting.has(resolvedFilePath)) {\n    logger.warn(\n      chalk.yellow(`Circular $ref detected at ${pointer || '/'}: ${refPath}`)\n    );\n    const { $ref: _, ...rest } = obj;\n    return rest;\n  }\n\n  if (!fs.existsSync(resolvedFilePath)) {\n    logger.warn(\n      chalk.yellow(\n        `$ref file not found at ${pointer || '/'}: ${refPath} (resolved to ${resolvedFilePath})`\n      )\n    );\n    const { $ref: _, ...rest } = obj;\n    return rest;\n  }\n\n  let fileContent: string;\n  try {\n    fileContent = fs.readFileSync(resolvedFilePath, 'utf-8');\n  } catch {\n    logger.warn(chalk.yellow(`Failed to read $ref file: ${resolvedFilePath}`));\n    const { $ref: _, ...rest } = obj;\n    return rest;\n  }\n\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(fileContent);\n  } catch {\n    logger.warn(\n      chalk.yellow(`$ref file is not valid JSON: ${resolvedFilePath}`)\n    );\n    const { $ref: _, ...rest } = obj;\n    return rest;\n  }\n\n  // Record provenance before recursive resolution\n  refMap.set(pointer, {\n    sourceFile: resolvedFilePath,\n    refPath,\n    containingDir: baseDir,\n    originalContent: parsed,\n  });\n\n  // Recursively resolve nested $ref in the referenced file\n  const refFileDir = path.dirname(resolvedFilePath);\n  const nextVisiting = new Set(visiting);\n  nextVisiting.add(resolvedFilePath);\n\n  const resolvedContent = resolveNode(\n    parsed,\n    refFileDir,\n    pointer,\n    nextVisiting,\n    refMap\n  );\n\n  // Apply Mintlify merge rules\n  const { $ref: _, ...siblings } = obj;\n\n  if (\n    resolvedContent !== null &&\n    typeof resolvedContent === 'object' &&\n    !Array.isArray(resolvedContent)\n  ) {\n    // Object: merge siblings on top (siblings take precedence)\n    return { ...(resolvedContent as Record<string, unknown>), ...siblings };\n  }\n\n  // Non-object (array, string, number, etc.): replace entirely, drop siblings\n  return resolvedContent;\n}\n\n/**\n * Check if a file should have $ref resolution applied based on the settings.\n * Returns true if the file matches a jsonSchema entry with resolveRefs: true.\n */\nexport function shouldResolveRefs(\n  filePath: string,\n  options?: { jsonSchema?: Record<string, unknown> }\n): boolean {\n  if (!options?.jsonSchema) return false;\n\n  const relative = path.relative(process.cwd(), filePath);\n  for (const [glob, schema] of Object.entries(options.jsonSchema)) {\n    const jsonSchema = schema as { resolveRefs?: boolean };\n    if (jsonSchema.resolveRefs && micromatch.isMatch(relative, glob)) {\n      return true;\n    }\n  }\n  return false;\n}\n\nfunction isRelativePath(refPath: string): boolean {\n  if (path.isAbsolute(refPath)) return false;\n  if (/^[a-z]+:\\/\\//i.test(refPath)) return false;\n  return true;\n}\n"],"mappings":"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"}

package/dist/utils/resolvePublish.js

@@ -1,62 +1,54 @@
-import { SUPPORTED_FILE_EXTENSIONS } from '../formats/files/supportedFiles.js';
-import { getRelative } from '../fs/findFilepath.js';
-import { hashStringSync } from './hash.js';
+import { hashStringSync } from "./hash.js";
+import { getRelative } from "../fs/findFilepath.js";
+import { SUPPORTED_FILE_EXTENSIONS } from "../formats/files/supportedFiles.js";
+//#region src/utils/resolvePublish.ts
 /**
- * Determines whether a file should be published based on the publish resolution logic:
- * - If the file is explicitly opted OUT (unpublishPaths), never publish
- * - If the file is explicitly opted IN (publishPaths), always publish
- * - Otherwise, fall back to the global publish setting
- */
-export function shouldPublishFile(resolvedPath, settings) {
-    if (settings.files.unpublishPaths?.has(resolvedPath))
-        return false;
-    if (settings.files.publishPaths?.has(resolvedPath))
-        return true;
-    return settings.publish ?? false;
+* Determines whether a file should be published based on the publish resolution logic:
+* - If the file is explicitly opted OUT (unpublishPaths), never publish
+* - If the file is explicitly opted IN (publishPaths), always publish
+* - Otherwise, fall back to the global publish setting
+*/
+function shouldPublishFile(resolvedPath, settings) {
+	if (settings.files.unpublishPaths?.has(resolvedPath)) return false;
+	if (settings.files.publishPaths?.has(resolvedPath)) return true;
+	return settings.publish ?? false;
 }
 /**
- * Builds a publish map from resolved file paths.
- * Only includes files that have an explicit publish config or when a global
- * publish flag is defined. Files without any config are left out of the map
- * so the publish endpoint is never called for them.
- */
-export function buildPublishMap(filePaths, settings) {
-    const publishMap = new Map();
-    const hasGlobalPublish = settings.publish !== undefined;
-    for (const fileType of SUPPORTED_FILE_EXTENSIONS) {
-        if (filePaths[fileType]) {
-            for (const absolutePath of filePaths[fileType]) {
-                const hasExplicitConfig = settings.files.publishPaths?.has(absolutePath) ||
-                    settings.files.unpublishPaths?.has(absolutePath);
-                if (hasGlobalPublish || hasExplicitConfig) {
-                    const relativePath = getRelative(absolutePath);
-                    const fileId = hashStringSync(relativePath);
-                    publishMap.set(fileId, shouldPublishFile(absolutePath, settings));
-                }
-            }
-        }
-    }
-    return publishMap;
+* Builds a publish map from resolved file paths.
+* Only includes files that have an explicit publish config or when a global
+* publish flag is defined. Files without any config are left out of the map
+* so the publish endpoint is never called for them.
+*/
+function buildPublishMap(filePaths, settings) {
+	const publishMap = /* @__PURE__ */ new Map();
+	const hasGlobalPublish = settings.publish !== void 0;
+	for (const fileType of SUPPORTED_FILE_EXTENSIONS) if (filePaths[fileType]) for (const absolutePath of filePaths[fileType]) {
+		const hasExplicitConfig = settings.files.publishPaths?.has(absolutePath) || settings.files.unpublishPaths?.has(absolutePath);
+		if (hasGlobalPublish || hasExplicitConfig) {
+			const fileId = hashStringSync(getRelative(absolutePath));
+			publishMap.set(fileId, shouldPublishFile(absolutePath, settings));
+		}
+	}
+	return publishMap;
 }
 /**
- * Returns true if the user has any explicit publish configuration —
- * global flag, gt-specific flag, or per-file publish/unpublish patterns.
- */
-export function hasPublishConfig(settings) {
-    return (settings.publish !== undefined ||
-        settings.files.gtJson.publish !== undefined ||
-        (settings.files.publishPaths?.size ?? 0) > 0 ||
-        (settings.files.unpublishPaths?.size ?? 0) > 0);
+* Returns true if the user has any explicit publish configuration —
+* global flag, gt-specific flag, or per-file publish/unpublish patterns.
+*/
+function hasPublishConfig(settings) {
+	return settings.publish !== void 0 || settings.files.gtJson.publish !== void 0 || (settings.files.publishPaths?.size ?? 0) > 0 || (settings.files.unpublishPaths?.size ?? 0) > 0;
 }
 /**
- * Determines whether gtjson content should be published.
- * Uses the gt-specific publish flag if set, otherwise falls back to global.
- * Returns undefined when there is no explicit config at any level.
- */
-export function shouldPublishGt(settings) {
-    if (settings.files.gtJson.publish === false)
-        return false;
-    if (settings.files.gtJson.publish === true)
-        return true;
-    return settings.publish;
+* Determines whether gtjson content should be published.
+* Uses the gt-specific publish flag if set, otherwise falls back to global.
+* Returns undefined when there is no explicit config at any level.
+*/
+function shouldPublishGt(settings) {
+	if (settings.files.gtJson.publish === false) return false;
+	if (settings.files.gtJson.publish === true) return true;
+	return settings.publish;
 }
+//#endregion
+export { buildPublishMap, hasPublishConfig, shouldPublishFile, shouldPublishGt };
+
+//# sourceMappingURL=resolvePublish.js.map

package/dist/utils/resolvePublish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolvePublish.js","names":[],"sources":["../../src/utils/resolvePublish.ts"],"sourcesContent":["import { Settings, ResolvedFiles } from '../types/index.js';\nimport { SUPPORTED_FILE_EXTENSIONS } from '../formats/files/supportedFiles.js';\nimport { getRelative } from '../fs/findFilepath.js';\nimport { hashStringSync } from './hash.js';\n\n/**\n * Determines whether a file should be published based on the publish resolution logic:\n * - If the file is explicitly opted OUT (unpublishPaths), never publish\n * - If the file is explicitly opted IN (publishPaths), always publish\n * - Otherwise, fall back to the global publish setting\n */\nexport function shouldPublishFile(\n  resolvedPath: string,\n  settings: Settings\n): boolean {\n  if (settings.files.unpublishPaths?.has(resolvedPath)) return false;\n  if (settings.files.publishPaths?.has(resolvedPath)) return true;\n  return settings.publish ?? false;\n}\n\n/**\n * Builds a publish map from resolved file paths.\n * Only includes files that have an explicit publish config or when a global\n * publish flag is defined. Files without any config are left out of the map\n * so the publish endpoint is never called for them.\n */\nexport function buildPublishMap(\n  filePaths: ResolvedFiles,\n  settings: Settings\n): Map<string, boolean> {\n  const publishMap = new Map<string, boolean>();\n  const hasGlobalPublish = settings.publish !== undefined;\n  for (const fileType of SUPPORTED_FILE_EXTENSIONS) {\n    if (filePaths[fileType]) {\n      for (const absolutePath of filePaths[fileType]) {\n        const hasExplicitConfig =\n          settings.files.publishPaths?.has(absolutePath) ||\n          settings.files.unpublishPaths?.has(absolutePath);\n        if (hasGlobalPublish || hasExplicitConfig) {\n          const relativePath = getRelative(absolutePath);\n          const fileId = hashStringSync(relativePath);\n          publishMap.set(fileId, shouldPublishFile(absolutePath, settings));\n        }\n      }\n    }\n  }\n  return publishMap;\n}\n\n/**\n * Returns true if the user has any explicit publish configuration —\n * global flag, gt-specific flag, or per-file publish/unpublish patterns.\n */\nexport function hasPublishConfig(settings: Settings): boolean {\n  return (\n    settings.publish !== undefined ||\n    settings.files.gtJson.publish !== undefined ||\n    (settings.files.publishPaths?.size ?? 0) > 0 ||\n    (settings.files.unpublishPaths?.size ?? 0) > 0\n  );\n}\n\n/**\n * Determines whether gtjson content should be published.\n * Uses the gt-specific publish flag if set, otherwise falls back to global.\n * Returns undefined when there is no explicit config at any level.\n */\nexport function shouldPublishGt(settings: Settings): boolean | undefined {\n  if (settings.files.gtJson.publish === false) return false;\n  if (settings.files.gtJson.publish === true) return true;\n  return settings.publish;\n}\n"],"mappings":";;;;;;;;;;AAWA,SAAgB,kBACd,cACA,UACS;AACT,KAAI,SAAS,MAAM,gBAAgB,IAAI,aAAa,CAAE,QAAO;AAC7D,KAAI,SAAS,MAAM,cAAc,IAAI,aAAa,CAAE,QAAO;AAC3D,QAAO,SAAS,WAAW;;;;;;;;AAS7B,SAAgB,gBACd,WACA,UACsB;CACtB,MAAM,6BAAa,IAAI,KAAsB;CAC7C,MAAM,mBAAmB,SAAS,YAAY,KAAA;AAC9C,MAAK,MAAM,YAAY,0BACrB,KAAI,UAAU,UACZ,MAAK,MAAM,gBAAgB,UAAU,WAAW;EAC9C,MAAM,oBACJ,SAAS,MAAM,cAAc,IAAI,aAAa,IAC9C,SAAS,MAAM,gBAAgB,IAAI,aAAa;AAClD,MAAI,oBAAoB,mBAAmB;GAEzC,MAAM,SAAS,eADM,YAAY,aACS,CAAC;AAC3C,cAAW,IAAI,QAAQ,kBAAkB,cAAc,SAAS,CAAC;;;AAKzE,QAAO;;;;;;AAOT,SAAgB,iBAAiB,UAA6B;AAC5D,QACE,SAAS,YAAY,KAAA,KACrB,SAAS,MAAM,OAAO,YAAY,KAAA,MACjC,SAAS,MAAM,cAAc,QAAQ,KAAK,MAC1C,SAAS,MAAM,gBAAgB,QAAQ,KAAK;;;;;;;AASjD,SAAgB,gBAAgB,UAAyC;AACvE,KAAI,SAAS,MAAM,OAAO,YAAY,MAAO,QAAO;AACpD,KAAI,SAAS,MAAM,OAAO,YAAY,KAAM,QAAO;AACnD,QAAO,SAAS"}

package/dist/utils/sanitizeFileContent.js

@@ -1,29 +1,22 @@
+//#region src/utils/sanitizeFileContent.ts
 /**
- * Processes content to escape curl commands within tick marks and existing escape strings
- * @param content - The content to process
- * @returns the processed content with escaped curl commands
- */
-export default function sanitizeFileContent(content) {
-    const ESCAPE_STRING = '_GT_INTERNAL_ESCAPE';
-    const allTickMarkRegex = /`([^`]*)`/g;
-    let processedContent = content;
-    // First, escape any existing tick marks followed by _GT_INTERNAL_ESCAPE
-    // This protects pre-existing escapes
-    processedContent = processedContent.replace(new RegExp('`' + ESCAPE_STRING, 'g'), '`' + ESCAPE_STRING + ESCAPE_STRING);
-    // Then find ALL tick mark pairs and process them individually
-    // This approach is more reliable than negative lookahead with modified content
-    processedContent = processedContent.replace(allTickMarkRegex, (match, innerContent) => {
-        // Skip if this already starts with our escape string (protected or already processed)
-        if (innerContent.startsWith(ESCAPE_STRING)) {
-            return match;
-        }
-        // Check if the content contains a curl command
-        if (/\bcurl\b/i.test(innerContent)) {
-            // Insert escape string after opening tick
-            return '`' + ESCAPE_STRING + innerContent + '`';
-        }
-        // Return original match if no curl command found
-        return match;
-    });
-    return processedContent;
+* Processes content to escape curl commands within tick marks and existing escape strings
+* @param content - The content to process
+* @returns the processed content with escaped curl commands
+*/
+function sanitizeFileContent(content) {
+	const ESCAPE_STRING = "_GT_INTERNAL_ESCAPE";
+	const allTickMarkRegex = /`([^`]*)`/g;
+	let processedContent = content;
+	processedContent = processedContent.replace(new RegExp("`" + ESCAPE_STRING, "g"), "`" + ESCAPE_STRING + ESCAPE_STRING);
+	processedContent = processedContent.replace(allTickMarkRegex, (match, innerContent) => {
+		if (innerContent.startsWith(ESCAPE_STRING)) return match;
+		if (/\bcurl\b/i.test(innerContent)) return "`" + ESCAPE_STRING + innerContent + "`";
+		return match;
+	});
+	return processedContent;
 }
+//#endregion
+export { sanitizeFileContent as default };
+
+//# sourceMappingURL=sanitizeFileContent.js.map

package/dist/utils/sanitizeFileContent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitizeFileContent.js","names":[],"sources":["../../src/utils/sanitizeFileContent.ts"],"sourcesContent":["/**\n * Processes content to escape curl commands within tick marks and existing escape strings\n * @param content - The content to process\n * @returns the processed content with escaped curl commands\n */\nexport default function sanitizeFileContent(content: string): string {\n  const ESCAPE_STRING = '_GT_INTERNAL_ESCAPE';\n  const allTickMarkRegex = /`([^`]*)`/g;\n\n  let processedContent = content;\n\n  // First, escape any existing tick marks followed by _GT_INTERNAL_ESCAPE\n  // This protects pre-existing escapes\n  processedContent = processedContent.replace(\n    new RegExp('`' + ESCAPE_STRING, 'g'),\n    '`' + ESCAPE_STRING + ESCAPE_STRING\n  );\n\n  // Then find ALL tick mark pairs and process them individually\n  // This approach is more reliable than negative lookahead with modified content\n\n  processedContent = processedContent.replace(\n    allTickMarkRegex,\n    (match, innerContent) => {\n      // Skip if this already starts with our escape string (protected or already processed)\n      if (innerContent.startsWith(ESCAPE_STRING)) {\n        return match;\n      }\n\n      // Check if the content contains a curl command\n      if (/\\bcurl\\b/i.test(innerContent)) {\n        // Insert escape string after opening tick\n        return '`' + ESCAPE_STRING + innerContent + '`';\n      }\n\n      // Return original match if no curl command found\n      return match;\n    }\n  );\n\n  return processedContent;\n}\n"],"mappings":";;;;;;AAKA,SAAwB,oBAAoB,SAAyB;CACnE,MAAM,gBAAgB;CACtB,MAAM,mBAAmB;CAEzB,IAAI,mBAAmB;AAIvB,oBAAmB,iBAAiB,QAClC,IAAI,OAAO,MAAM,eAAe,IAAI,EACpC,MAAM,gBAAgB,cACvB;AAKD,oBAAmB,iBAAiB,QAClC,mBACC,OAAO,iBAAiB;AAEvB,MAAI,aAAa,WAAW,cAAc,CACxC,QAAO;AAIT,MAAI,YAAY,KAAK,aAAa,CAEhC,QAAO,MAAM,gBAAgB,eAAe;AAI9C,SAAO;GAEV;AAED,QAAO"}