import fsMod from 'node:fs'; import type { PluginContext } from 'rollup'; import type { ViteDevServer } from 'vite'; import { z } from 'zod'; import type { Logger } from '../core/logger/core.js'; import type { AstroSettings } from '../types/astro.js'; import type { AstroConfig } from '../types/public/config.js'; import type { ContentEntryType, DataEntryType } from '../types/public/content.js'; import { type CONTENT_FLAGS } from './consts.js'; /** * A map from a collection + slug to the local file path. * This is used internally to resolve entry imports when using `getEntry()`. * @see `templates/content/module.mjs` */ export type ContentLookupMap = { [collectionName: string]: { type: 'content' | 'data'; entries: { [lookupId: string]: string; }; }; }; export declare const loaderReturnSchema: z.ZodUnion<[z.ZodArray, z.objectInputType<{ id: z.ZodString; }, z.ZodTypeAny, "passthrough">>, "many">, z.ZodRecord; }, "passthrough", z.ZodTypeAny, z.objectOutputType<{ id: z.ZodOptional; }, z.ZodTypeAny, "passthrough">, z.objectInputType<{ id: z.ZodOptional; }, z.ZodTypeAny, "passthrough">>>]>; declare const collectionConfigParser: z.ZodUnion<[z.ZodObject<{ type: z.ZodDefault>>; schema: z.ZodOptional; }, "strip", z.ZodTypeAny, { type: "content"; schema?: any; }, { type?: "content" | undefined; schema?: any; }>, z.ZodObject<{ type: z.ZodLiteral<"data">; schema: z.ZodOptional; }, "strip", z.ZodTypeAny, { type: "data"; schema?: any; }, { type: "data"; schema?: any; }>, z.ZodObject<{ type: z.ZodLiteral<"content_layer">; schema: z.ZodOptional; loader: z.ZodUnion<[z.ZodFunction, z.ZodUnknown>, z.ZodObject<{ name: z.ZodString; load: z.ZodFunction, z.ZodUnknown>; watcher: z.ZodOptional; refreshContextData: z.ZodOptional>; }, "strip", z.ZodTypeAny, { collection: string; generateDigest: (args_0: any) => unknown; config?: any; meta?: any; logger?: any; watcher?: any; parseData?: any; store?: any; entryTypes?: any; renderMarkdown?: any; refreshContextData?: Record | undefined; }, { collection: string; generateDigest: (args_0: any) => unknown; config?: any; meta?: any; logger?: any; watcher?: any; parseData?: any; store?: any; entryTypes?: any; renderMarkdown?: any; refreshContextData?: Record | undefined; }>], null>, z.ZodUnknown>; schema: z.ZodOptional; render: z.ZodOptional, z.ZodUnknown>>; }, "strip", z.ZodTypeAny, { name: string; load: (args_0: { collection: string; generateDigest: (args_0: any) => unknown; config?: any; meta?: any; logger?: any; watcher?: any; parseData?: any; store?: any; entryTypes?: any; renderMarkdown?: any; refreshContextData?: Record | undefined; }) => unknown; schema?: any; render?: ((args_0: any) => unknown) | undefined; }, { name: string; load: (args_0: { collection: string; generateDigest: (args_0: any) => unknown; config?: any; meta?: any; logger?: any; watcher?: any; parseData?: any; store?: any; entryTypes?: any; renderMarkdown?: any; refreshContextData?: Record | undefined; }) => unknown; schema?: any; render?: ((args_0: any) => unknown) | undefined; }>]>; /** deprecated */ _legacy: z.ZodOptional; }, "strip", z.ZodTypeAny, { type: "content_layer"; loader: ((...args: unknown[]) => unknown) | { name: string; load: (args_0: { collection: string; generateDigest: (args_0: any) => unknown; config?: any; meta?: any; logger?: any; watcher?: any; parseData?: any; store?: any; entryTypes?: any; renderMarkdown?: any; refreshContextData?: Record | undefined; }) => unknown; schema?: any; render?: ((args_0: any) => unknown) | undefined; }; schema?: any; _legacy?: boolean | undefined; }, { type: "content_layer"; loader: ((...args: unknown[]) => unknown) | { name: string; load: (args_0: { collection: string; generateDigest: (args_0: any) => unknown; config?: any; meta?: any; logger?: any; watcher?: any; parseData?: any; store?: any; entryTypes?: any; renderMarkdown?: any; refreshContextData?: Record | undefined; }) => unknown; schema?: any; render?: ((args_0: any) => unknown) | undefined; }; schema?: any; _legacy?: boolean | undefined; }>, z.ZodObject<{ type: z.ZodDefault>>; schema: z.ZodOptional; loader: z.ZodFunction, z.ZodUnknown>; }, "strip", z.ZodTypeAny, { type: "live"; loader: (...args: unknown[]) => unknown; schema?: any; }, { loader: (...args: unknown[]) => unknown; type?: "live" | undefined; schema?: any; }>]>; declare const contentConfigParser: z.ZodObject<{ collections: z.ZodRecord>>; schema: z.ZodOptional; }, "strip", z.ZodTypeAny, { type: "content"; schema?: any; }, { type?: "content" | undefined; schema?: any; }>, z.ZodObject<{ type: z.ZodLiteral<"data">; schema: z.ZodOptional; }, "strip", z.ZodTypeAny, { type: "data"; schema?: any; }, { type: "data"; schema?: any; }>, z.ZodObject<{ type: z.ZodLiteral<"content_layer">; schema: z.ZodOptional; loader: z.ZodUnion<[z.ZodFunction, z.ZodUnknown>, z.ZodObject<{ name: z.ZodString; load: z.ZodFunction, z.ZodUnknown>; watcher: z.ZodOptional; refreshContextData: z.ZodOptional>; }, "strip", z.ZodTypeAny, { collection: string; generateDigest: (args_0: any) => unknown; config?: any; meta?: any; logger?: any; watcher?: any; parseData?: any; store?: any; entryTypes?: any; renderMarkdown?: any; refreshContextData?: Record | undefined; }, { collection: string; generateDigest: (args_0: any) => unknown; config?: any; meta?: any; logger?: any; watcher?: any; parseData?: any; store?: any; entryTypes?: any; renderMarkdown?: any; refreshContextData?: Record | undefined; }>], null>, z.ZodUnknown>; schema: z.ZodOptional; render: z.ZodOptional, z.ZodUnknown>>; }, "strip", z.ZodTypeAny, { name: string; load: (args_0: { collection: string; generateDigest: (args_0: any) => unknown; config?: any; meta?: any; logger?: any; watcher?: any; parseData?: any; store?: any; entryTypes?: any; renderMarkdown?: any; refreshContextData?: Record | undefined; }) => unknown; schema?: any; render?: ((args_0: any) => unknown) | undefined; }, { name: string; load: (args_0: { collection: string; generateDigest: (args_0: any) => unknown; config?: any; meta?: any; logger?: any; watcher?: any; parseData?: any; store?: any; entryTypes?: any; renderMarkdown?: any; refreshContextData?: Record | undefined; }) => unknown; schema?: any; render?: ((args_0: any) => unknown) | undefined; }>]>; /** deprecated */ _legacy: z.ZodOptional; }, "strip", z.ZodTypeAny, { type: "content_layer"; loader: ((...args: unknown[]) => unknown) | { name: string; load: (args_0: { collection: string; generateDigest: (args_0: any) => unknown; config?: any; meta?: any; logger?: any; watcher?: any; parseData?: any; store?: any; entryTypes?: any; renderMarkdown?: any; refreshContextData?: Record | undefined; }) => unknown; schema?: any; render?: ((args_0: any) => unknown) | undefined; }; schema?: any; _legacy?: boolean | undefined; }, { type: "content_layer"; loader: ((...args: unknown[]) => unknown) | { name: string; load: (args_0: { collection: string; generateDigest: (args_0: any) => unknown; config?: any; meta?: any; logger?: any; watcher?: any; parseData?: any; store?: any; entryTypes?: any; renderMarkdown?: any; refreshContextData?: Record | undefined; }) => unknown; schema?: any; render?: ((args_0: any) => unknown) | undefined; }; schema?: any; _legacy?: boolean | undefined; }>, z.ZodObject<{ type: z.ZodDefault>>; schema: z.ZodOptional; loader: z.ZodFunction, z.ZodUnknown>; }, "strip", z.ZodTypeAny, { type: "live"; loader: (...args: unknown[]) => unknown; schema?: any; }, { loader: (...args: unknown[]) => unknown; type?: "live" | undefined; schema?: any; }>]>>; }, "strip", z.ZodTypeAny, { collections: Record unknown) | { name: string; load: (args_0: { collection: string; generateDigest: (args_0: any) => unknown; config?: any; meta?: any; logger?: any; watcher?: any; parseData?: any; store?: any; entryTypes?: any; renderMarkdown?: any; refreshContextData?: Record | undefined; }) => unknown; schema?: any; render?: ((args_0: any) => unknown) | undefined; }; schema?: any; _legacy?: boolean | undefined; } | { type: "live"; loader: (...args: unknown[]) => unknown; schema?: any; }>; }, { collections: Record unknown) | { name: string; load: (args_0: { collection: string; generateDigest: (args_0: any) => unknown; config?: any; meta?: any; logger?: any; watcher?: any; parseData?: any; store?: any; entryTypes?: any; renderMarkdown?: any; refreshContextData?: Record | undefined; }) => unknown; schema?: any; render?: ((args_0: any) => unknown) | undefined; }; schema?: any; _legacy?: boolean | undefined; } | { loader: (...args: unknown[]) => unknown; type?: "live" | undefined; schema?: any; }>; }>; export type CollectionConfig = z.infer; export type ContentConfig = z.infer & { digest?: string; }; type EntryInternal = { rawData: string | undefined; filePath: string; }; export declare function parseEntrySlug({ id, collection, generatedSlug, frontmatterSlug, }: { id: string; collection: string; generatedSlug: string; frontmatterSlug?: unknown; }): string; export declare function getEntryDataAndImages = Record, TOutputData extends TInputData = TInputData>(entry: { id: string; collection: string; unvalidatedData: TInputData; _internal: EntryInternal; }, collectionConfig: CollectionConfig, shouldEmitFile: boolean, experimentalSvgEnabled: boolean, pluginContext?: PluginContext): Promise<{ data: TOutputData; imageImports: Array; }>; export declare function getEntryData(entry: { id: string; collection: string; unvalidatedData: Record; _internal: EntryInternal; }, collectionConfig: CollectionConfig, shouldEmitFile: boolean, experimentalSvgEnabled: boolean, pluginContext?: PluginContext): Promise>; export declare function getContentEntryExts(settings: Pick): string[]; export declare function getDataEntryExts(settings: Pick): string[]; export declare function getEntryConfigByExtMap(entryTypes: TEntryType[]): Map; export declare function getSymlinkedContentCollections({ contentDir, logger, fs, }: { contentDir: URL; logger: Logger; fs: typeof fsMod; }): Promise>; export declare function reverseSymlink({ entry, symlinks, contentDir, }: { entry: string | URL; contentDir: string | URL; symlinks?: Map; }): string; export declare function getEntryCollectionName({ contentDir, entry, }: Pick & { entry: string | URL; }): string | undefined; export declare function getDataEntryId({ entry, contentDir, collection, }: Pick & { entry: URL; collection: string; }): string; export declare function getContentEntryIdAndSlug({ entry, contentDir, collection, }: Pick & { entry: URL; collection: string; }): { id: string; slug: string; }; export declare function getEntryType(entryPath: string, paths: Pick, contentFileExts: string[], dataFileExts: string[]): 'content' | 'data' | 'config' | 'ignored'; export declare function safeParseFrontmatter(source: string, id?: string): import("@astrojs/markdown-remark").ParseFrontmatterResult; /** * The content config is loaded separately from other `src/` files. * This global observable lets dependent plugins (like the content flag plugin) * subscribe to changes during dev server updates. */ export declare const globalContentConfigObserver: ContentObservable; export declare function hasContentFlag(viteId: string, flag: (typeof CONTENT_FLAGS)[number]): boolean; export declare function isDeferredModule(viteId: string): boolean; export declare function reloadContentConfigObserver({ observer, ...loadContentConfigOpts }: { fs: typeof fsMod; settings: AstroSettings; viteServer: ViteDevServer; observer?: ContentObservable; }): Promise; type ContentCtx = { status: 'init'; } | { status: 'loading'; } | { status: 'does-not-exist'; } | { status: 'loaded'; config: ContentConfig; } | { status: 'error'; error: Error; }; type Observable = { get: () => C; set: (ctx: C) => void; subscribe: (fn: (ctx: C) => void) => () => void; }; export type ContentObservable = Observable; export type ContentPaths = { root: URL; contentDir: URL; assetsDir: URL; typesTemplate: URL; virtualModTemplate: URL; config: { exists: boolean; url: URL; }; liveConfig: { exists: boolean; url: URL; }; }; export declare function getContentPaths({ srcDir, legacy, root, experimental, }: Pick, fs?: typeof fsMod): ContentPaths; /** * Check for slug in content entry frontmatter and validate the type, * falling back to the `generatedSlug` if none is found. */ export declare function getEntrySlug({ id, collection, generatedSlug, contentEntryType, fileUrl, fs, }: { fs: typeof fsMod; id: string; collection: string; generatedSlug: string; fileUrl: URL; contentEntryType: Pick; }): Promise; export declare function getExtGlob(exts: string[]): string; export declare function hasAssetPropagationFlag(id: string): boolean; export declare function globWithUnderscoresIgnored(relContentDir: string, exts: string[]): string[]; /** * Unlike `path.posix.relative`, this function will accept a platform path and return a posix path. */ export declare function posixRelative(from: string, to: string): string; export declare function contentModuleToId(fileName: string): string; export declare function safeStringify(value: unknown): string; export {};