// Type definitions for nimbiCMS_pre
// Generated by scripts/gen-dts.js; run `npm run gen-dts` to refresh


export type NavTreeItem = { path: string, name: string, isIndex?: boolean, children?: NavTreeItem[] }
export type NavBuildResult = { navbar: HTMLElement, linkEls: NodeListOf<Element> }
export function createSiteNav(homePage: string): NavTreeItem[]
export function buildNav(navbarWrap: HTMLElement, container: HTMLElement, navHtml: string, contentBase: string, homePage: string, t: (key:string, vars?:Record<string,unknown>)=>string, renderByQuery: ()=>void, effectiveSearchEnabled: boolean, searchIndexMode: 'eager'|'lazy'): Promise<NavBuildResult>

export type NavItem = { path: string, name: string, children?: NavItem[] }
export type TocEntry = { level:number, text:string, id?:string }
export type ParsedPage = { html: string, meta: object, toc: TocEntry[] }
export type ArticleResult = { article: HTMLElement, parsed: ParsedPage, toc: HTMLElement, topH1: HTMLElement | null, h1Text: string | null, slugKey: string | null }
export function createNavTree(t: (key:string, vars?:Record<string,unknown>)=>string, tree: NavItem[]): HTMLElement
export function buildTocElement(t: (key:string)=>string, toc: TocEntry[], pagePath?: string): HTMLElement
export function prepareArticle(t: (key:string)=>string, data: {raw:string,isHtml?:boolean}, pagePath: string, anchor: string|null, contentBase: string): Promise<ArticleResult>
export function initAnchorWorker(): Worker|null
export function rewriteAnchorsWorker(article: HTMLElement, contentBase: string, pagePath?: string): Promise<void>
export function attachTocClickHandler(toc: HTMLElement): void
export function scrollToAnchorOrTop(anchor: string|null): void
export function ensureScrollTopButton(article: HTMLElement, topH1: HTMLElement|null, opts?: { mountOverlay?: HTMLElement|null, container?: HTMLElement|null, mountEl?: HTMLElement|null, navWrap?: HTMLElement|null, t?: Function }): void

export type MarkdownPlugin = { tokenizer?: Function, renderer?: object, walkTokens?: Function, transform?: Function }
export const markdownPlugins: MarkdownPlugin[]
export function addMarkdownExtension(plugin: MarkdownPlugin): void
export function setMarkdownExtensions(plugins: MarkdownPlugin[]): void
export function initRendererWorker(): Worker|null
export function parseMarkdownToHtml(md: string): Promise<ParsedPage>
export function detectFenceLanguages(md: string, supportedMap?: Map<string,string>): Set<string>

export const currentLang: string
export function t(key: string, replacements?: Record<string,string>): string

export function setTag(name: string, content: string): void
export function setMetaTags(data: Record<string,unknown>, titleOverride?: string, imageOverride?: string, descOverride?: string, initialDocumentTitle?: string): void
export function setStructuredData(data: Record<string,unknown>, pagePath: string, titleOverride?: string, imageOverride?: string, descOverride?: string, initialDocumentTitle?: string): void
export function applyPageMeta(t: (key:string, vars?:Record<string,unknown>)=>string, initialDocumentTitle: string, parsed: ParsedPage, toc: TocEntry[], article: HTMLElement, pagePath: string, anchor: string|null, topH1: HTMLElement|null, h1Text: string|null, slugKey: string|null, data: Record<string,unknown>): void

export function setLazyload(img: HTMLImageElement): void
export function joinPaths(...parts: string[]): string



export function _clearIndexCache(): void
export function refreshIndexPaths(): void
export function _purgeExpiredEntries(): void
export function buildPageCandidates(resolved: string): string[]
export function fetchPageData(raw: string, contentBase: string): Promise<{data: Record<string, any>, pagePath: string, anchor: string | null}>

export function initSlugWorker(): Worker|null
export function addSlugResolver(fn: (slug:string,contentBase?:string)=>Promise<string|null>|string|null): void
export const notFoundPage: string
export function setContentBase(contentBase: string): void
export function slugify(s: string): string
export function resolveSlugPath(slug: string): string|null
export const crawlCache: Map<string, Promise<string|null>|string|null>
export function buildSearchIndex(contentBase: string): Promise<Array<{slug:string,title:string,excerpt:string,path:string}>>
export function setDefaultCrawlMaxQueue(n: number): void
export const crawlForSlug: (decoded: string, contentBase: string, maxQueue?: number) => Promise<string|null>
export function crawlAllMarkdown(contentBase: string, maxQueue: number): Promise<string[]>
export function ensureSlug(decoded: string, contentBase: string, maxQueue: any): Promise<string|null>


export type ThemeStyle = 'light' | 'dark'

export interface InitOptions {
  el: string | Element
  contentPath?: string
  crawlMaxQueue?: number
  searchIndex?: boolean
  cacheTtlMinutes?: number
  defaultStyle?: ThemeStyle
  bulmaCustomize?: string
  lang?: string
  l10nFile?: string | null
  /** optional array of markdown paths provided by the host (example plugin)
   *  used by slug resolution and search index */
  markdownPaths?: string[]
}

export interface PageContext {
  data: Record<string, any>
  pagePath: string
  anchor: string | null
}

export interface HookContext {
  // common fields provided to all hooks
  pagePath?: string
  anchor?: string | null
  article?: HTMLElement
  toc?: HTMLElement
  topH1?: HTMLElement | null
  h1Text?: string | null
  slugKey?: string | null
  data?: Record<string, any>
  contentWrap?: HTMLElement | null
  navWrap?: HTMLElement | null
  // nav-build specific
  navbar?: HTMLElement
  linkEls?: NodeListOf<HTMLAnchorElement>
  contentBase?: string
}

// UI helper option and return shapes (mirrors src/ui.js typedefs)
export type UIOptions = {
  contentWrap: HTMLElement,
  navWrap: HTMLElement,
  container: HTMLElement,
  mountOverlay?: HTMLElement | null,
  t: (key: string, vars?: Object)=>string,
  contentBase: string,
  homePage: string,
  initialDocumentTitle: string,
  runHooks: (name: string, ctx?: Object)=>void|Promise<void>
}

export type UIReturn = {
  renderByQuery: () => Promise<void>,
  siteNav: object,
  getCurrentPagePath: () => string | null
}

// Router resolution cache types
export type ResolutionRecord = { value: { resolved: string, anchor: string | null }, ts: number }
export const RESOLUTION_CACHE_MAX: number
export const RESOLUTION_CACHE_TTL: number
export function setResolutionCacheMax(n: number): void
export function setResolutionCacheTtl(ms: number): void
export const resolutionCache: Map<string, ResolutionRecord>

// Fetch result and localization entry shapes (from slugManager and l10n defaults)
export type FetchResult = { raw: string, isHtml?: boolean, status?: number }
export type L10nEntry = { navigation: string, onThisPage: string, home: string, scrollToTop: string, readingTime: string, searchPlaceholder: string }

// primary entrypoint – options object is strongly typed above
export function initCMS(options: InitOptions): Promise<void>
export default initCMS

// hook / plugin API definitions
export function addHook(name: string, fn: (ctx:HookContext)=>void|Promise<void>): void
export function onPageLoad(fn: (ctx:HookContext)=>void|Promise<void>): void
export function onNavBuild(fn: (ctx:HookContext)=>void|Promise<void>): void
export function transformHtml(fn: (ctx:HookContext)=>void|Promise<void>): void
export function _clearHooks(): void

export type WorkerManager = {
  get: () => Worker | null
  send: (msg: any, timeout?: number) => Promise<unknown>
  terminate: () => void
}

// Worker manager helpers
export function makeWorkerManager(createWorker: () => Worker|null, name?: string): WorkerManager
export function createWorkerFromRaw(code: string): Worker|null

// UI helper (opaque options for now)
export function createUI(opts: UIOptions): UIReturn

// Slug manager shared maps
export const slugToMd: Map<string, string|{default?:string,langs?:Record<string,string>}>
export const mdToSlug: Map<string,string>
export const availableLanguages: string[]
export const listPathsFetched: Set<string>
export const listSlugCache: Map<string,string>
export const searchIndex: Array<{slug:string,title:string,excerpt:string,path:string}>

// Codeblocks
export const SUPPORTED_HLJS_MAP: Map<string,string>

// Additional explicit declarations to reduce remaining any entries
export function setLanguages(list: string[]): void
export function buildSearchIndexWorker(contentBase: string): Promise<Array<{slug:string,title:string,excerpt:string,path:string}>>
export function crawlForSlugWorker(slug: string, base: string, maxQueue: number): Promise<string|null>
export function removeSlugResolver(fn: (slug:string)=>unknown): void
export function setNotFoundPage(p: string): void
export function _setAllMd(obj: Record<string,string>): void
export function clearListCaches(): void
export function clearFetchCache(): void
export function fetchMarkdown(path: string, base?: string): Promise<FetchResult>



// --- from src/worker-manager.js
export function makeWorkerPool(createWorker: any, name: any, size: any): any
export function makeWorkerManagerFromRaw(code: string, handleFn: {function(object):Promise<object>}, name: string): ReturnType<typeof makeWorkerManager>
export function makeWorkerPoolFromRaw(code: string, handleFn: {function(object):Promise<object>}, name: string, size: number): ReturnType<typeof makeWorkerPool>



// --- from src/version.js
export function getVersion(): Promise<string>

// --- from src/ui.js


// --- from src/slugManager.js
export function watchForColdHashRoute(parsed: {type:string,page:string,anchor?:string,params?:string}): any
export function setSkipRootReadme(v: any): any
export const skipRootReadme: boolean
export function getLanguages(): string[]
export function _storeSlugMapping(slug: string, rel: string): void
export const slugResolvers: Set<Function>
export const allMarkdownPaths: string[]
export const allMarkdownPathsSet: Set<string>
export const homePage: string
export const HOME_SLUG: string
export function setHomePage(p: string): void
export function _setSearchIndex(arr: any): any
export function uniqueSlug(base: string, existing: Set<string>): string
export function isExternalLink(href: string): boolean
export function isExternalLinkWithBase(href: string, contentBase: string): boolean
export function unescapeMarkdown(s: string): string
export const negativeFetchCache: any
export function setFetchNegativeCacheTTL(ms: any): any
export function setFetchCacheMaxSize(n: number): any
export function setFetchCacheTTL(ms: number): any
export function setNegativeFetchCacheMaxSize(n: number): any
export function setFetchConcurrency(n: number): void
export function getFetchConcurrency(): number
export function setFetchMarkdown(fn: (path:string, base?:string)=>Promise<FetchResult>): void
export function getSearchIndex(): any
export function whenSearchIndexReady(opts: {timeoutMs?:number,contentBase?:string,indexDepth?:number,noIndexing?:string[],seedPaths?:string[],startBuild?:boolean}): Promise<Array>
export function awaitSearchIndex(opts: {contentBase?:string,indexDepth?:number,noIndexing?:string[],seedPaths?:string[],startBuild?:boolean,timeoutMs?:number}): Promise<Array>
export const CRAWL_MAX_QUEUE: number
export const defaultCrawlMaxQueue: number





























// --- from src/seoManager.js
export function getSiteNameFromMeta(): string
export function setSeoMap(map: object): any
export function injectSeoForPage(page: string, initialDocumentTitle: string): any
export function markNotFound(opts: any): any





// --- from src/runtimeSitemap.js
export function generateSitemapJson(opts: object): Promise<SitemapJson>
export function generateSitemapXml(json: {generatedAt:string,entries:any[]}|any[]): string
export function generateRssXml(json: {generatedAt:string,entries:any[]}|any[]): string
export function generateAtomXml(json: {generatedAt:string,entries:any[]}|any[]): string
export function handleSitemapRequest(opts: any): any
export function exposeSitemapGlobals(opts: any): any

// --- from src/router.js
export function augmentIndexWithAllMarkdownPaths(arrOrMap: any): any












// --- from src/nimbi-cms.js

// --- from src/nav.js



// --- from src/markdown.js
export const _sendToRenderer: any
export function streamParseMarkdown(opts: {chunkSize?:number}): Promise<void>
export function detectFenceLanguagesAsync(mdText: string, supportedMap: Map<string,string>): Promise<Set<string>>







// --- from src/l10nManager.js
export function loadL10nFile(path: string, pageDir: string): Promise<void>
export function setLang(lang: string): void



// --- from src/jsdoc-typedefs.js


// --- from src/init.js
export function parseInitOptionsFromQuery(queryString: string): any
export const currentHighlightTheme: string
export const initialDocumentTitle: string


// --- from src/indexManager.js
export const indexSet: any


// --- from src/imagePreview.js
export function attachImagePreview(opts: any): void

// --- from src/htmlBuilder.js
export function preScanHtmlSlugs(linkEls: NodeListOf<HTMLAnchorElement>, base: string): Promise<void>
export function preMapMdSlugs(linkEls: NodeListOf<HTMLAnchorElement>|HTMLAnchorElement[], contentBase: string): Promise<void>
export function executeEmbeddedScripts(article: any): void
export function renderNotFound(contentWrap: HTMLElement|null, t: Function|null, e: Error|null): void









// --- from src/hookManager.js
export function runHooks(name: any, ctx: any): Promise<void>






// --- from src/gen-dts-sample.js
export function complexExample(opts: {a:number,b:string}): Promise<Array<{foo:string}|{bar:number}>>
export function simpleUnion(): string|number
export function recordExample(): Record<string, number[]>
export function sum(opts: any): {sum:number}
export function callIt(cb: (...args:any[])=>any): void

// --- from src/codeblocksManager.js
export const HLJS_ALIAS_MAP: Record<string,string>
export const BAD_LANGUAGES: Set<string>
export const languageImporter: any
export function setLanguageImporter(fn: any): any
export function clearLanguageImportCache(): void
export function setLanguageImportNegativeCacheTTL(ms: number): void
export function loadSupportedLanguages(url: string): Promise<void>
export function registerLanguage(name: string, modulePath: string): Promise<boolean>
export function observeCodeBlocks(root: any): any
export function setHighlightTheme(opts: {useCdn?:boolean}): void


// --- from src/bulmaManager.js
export function ensureBulma(bulmaCustomize: string, pageDir: string): Promise<void>
export function setStyle(style: 'light'|'dark'|'system'): void
export function setThemeVars(vars: Record<string,string>): void
export function registerThemedElement(el: any): () => void

// --- from src/worker/slugWorker.js
export function handleSlugWorkerMessage(msg: object): Promise<object>

// --- from src/worker/renderer.js
export function clearRendererImportCache(): any
export function setRendererImportNegativeCacheTTL(ms: any): any
export function handleWorkerMessage(msg: object): Promise<object>
export function handleWorkerMessageStream(msg: object, onChunk: {function(object):void}): any

// --- from src/worker/anchorWorker.js
export function handleAnchorWorkerMessage(msg: object): Promise<object>

// --- from src/utils/urlHelper.js
export function buildCosmeticUrl(page: string, anchor: any, baseSearch: any): string
export function parseHrefToRoute(href: string): any
export function toCanonicalHref(href: string): string

// --- from src/utils/textMetrics.js
export function getReadingTime(text: string): any
export function getTextMetrics(text: string): any
export function clearTextMetricsCache(): void

// --- from src/utils/sharedDomParser.js
export function getSharedParser(): DOMParser|null
export function setSharedParser(parser: DOMParser|null): void
export function resetSharedParser(): void

// --- from src/utils/renderer-manager.js



// --- from src/utils/memoize.js


// --- from src/utils/l10n-defaults.js
export const DEFAULT_L10N: Record<string, L10nEntry>

// --- from src/utils/importCache.js
export function clearImportCache(): any
export function setImportNegativeCacheTTL(ms: any): any
export function runImportWithCache(key: string, loader: () => Promise<any>): Promise<any|null>
export function importUrlWithCache(url: string): Promise<any|null>

// --- from src/utils/idle.js
export function yieldToEventLoop(): Promise<void>
export function yieldIfNeeded(iteration: number, threshold: number): Promise<void>

// --- from src/utils/helpers.js
export const normalizePath: any
export const trimTrailingSlash: any
export const ensureTrailingSlash: any
export function setEagerForAboveFoldImages(container: any, marginPx: number, debug: boolean): void
export function buildPageUrl(page: string, hash: string|null, baseSearch: string): string
export const encodeURL: any
export function safe(fn: () => any|Promise<any>): any|Promise<any>|undefined
export const decodeHtmlEntities: any




// --- from src/utils/frontmatter.js
export function parseFrontmatter(md: string): {content:string, data: Record<string,string>}

// --- from src/utils/events.js





// --- from src/utils/emojiMap.js

// --- from src/utils/debug.js
export function setDebugLevel(level: any): any
export function getDebugLevel(): number
export function isDebugLevel(level: number): boolean
export function isDebug(): boolean
export function debugError(...args: any): void
export function debugWarn(...args: any): void
export function debugInfo(...args: any): void
export function debugLog(...args: any): void
export function incrementCounter(name: string): void
export function syncLegacyCounter(name: string): void
export function hasLegacyDebug(): boolean
export function getDebugCounters(): Record<string,number>
export function resetDebugCounters(): void

// --- from src/utils/concurrency.js
export function runWithConcurrency(items: T[], worker: (item:T, index:number)=>Promise<U>, concurrency: number): Promise<Array<U>>

// --- from src/utils/cache.js
export function createLRUCache(opts: any): any


// --- from src/lib/index.js