import fsMod from 'node:fs'; import matter from 'gray-matter'; import type { PluginContext } from 'rollup'; import type { ViteDevServer } from 'vite'; import { z } from 'zod'; import type { AstroConfig, AstroSettings, ContentEntryType, DataEntryType } from '../@types/astro.js'; import type { Logger } from '../core/logger/core.js'; import { CONTENT_FLAGS } from './consts.js'; /** * Amap 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; }; }; }; 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.ZodUnion<[z.ZodArray, z.objectInputType<{ id: z.ZodString; }, z.ZodUnknown, "strip">>, "many">, z.ZodPromise, z.objectInputType<{ id: z.ZodString; }, z.ZodUnknown, "strip">>, "many">>]>>, z.ZodObject<{ name: z.ZodString; load: z.ZodFunction, z.ZodUnknown>; watcher: z.ZodOptional; }, "strip", z.ZodTypeAny, { collection: string; generateDigest: (args_0: any) => unknown; config?: any; meta?: any; logger?: any; store?: any; entryTypes?: any; parseData?: any; watcher?: any; }, { collection: string; generateDigest: (args_0: any) => unknown; config?: any; meta?: any; logger?: any; store?: any; entryTypes?: any; parseData?: any; watcher?: any; }>], 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; store?: any; entryTypes?: any; parseData?: any; watcher?: any; }) => 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; store?: any; entryTypes?: any; parseData?: any; watcher?: any; }) => unknown; schema?: any; render?: ((args_0: any) => unknown) | undefined; }>]>; }, "strip", z.ZodTypeAny, { type: "content_layer"; loader: ((...args: unknown[]) => z.objectOutputType<{ id: z.ZodString; }, z.ZodUnknown, "strip">[] | Promise[]>) | { name: string; load: (args_0: { collection: string; generateDigest: (args_0: any) => unknown; config?: any; meta?: any; logger?: any; store?: any; entryTypes?: any; parseData?: any; watcher?: any; }) => unknown; schema?: any; render?: ((args_0: any) => unknown) | undefined; }; schema?: any; }, { type: "content_layer"; loader: ((...args: unknown[]) => z.objectInputType<{ id: z.ZodString; }, z.ZodUnknown, "strip">[] | Promise[]>) | { name: string; load: (args_0: { collection: string; generateDigest: (args_0: any) => unknown; config?: any; meta?: any; logger?: any; store?: any; entryTypes?: any; parseData?: any; watcher?: any; }) => unknown; schema?: any; render?: ((args_0: any) => unknown) | 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.ZodUnion<[z.ZodArray, z.objectInputType<{ id: z.ZodString; }, z.ZodUnknown, "strip">>, "many">, z.ZodPromise, z.objectInputType<{ id: z.ZodString; }, z.ZodUnknown, "strip">>, "many">>]>>, z.ZodObject<{ name: z.ZodString; load: z.ZodFunction, z.ZodUnknown>; watcher: z.ZodOptional; }, "strip", z.ZodTypeAny, { collection: string; generateDigest: (args_0: any) => unknown; config?: any; meta?: any; logger?: any; store?: any; entryTypes?: any; parseData?: any; watcher?: any; }, { collection: string; generateDigest: (args_0: any) => unknown; config?: any; meta?: any; logger?: any; store?: any; entryTypes?: any; parseData?: any; watcher?: any; }>], 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; store?: any; entryTypes?: any; parseData?: any; watcher?: any; }) => 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; store?: any; entryTypes?: any; parseData?: any; watcher?: any; }) => unknown; schema?: any; render?: ((args_0: any) => unknown) | undefined; }>]>; }, "strip", z.ZodTypeAny, { type: "content_layer"; loader: ((...args: unknown[]) => z.objectOutputType<{ id: z.ZodString; }, z.ZodUnknown, "strip">[] | Promise[]>) | { name: string; load: (args_0: { collection: string; generateDigest: (args_0: any) => unknown; config?: any; meta?: any; logger?: any; store?: any; entryTypes?: any; parseData?: any; watcher?: any; }) => unknown; schema?: any; render?: ((args_0: any) => unknown) | undefined; }; schema?: any; }, { type: "content_layer"; loader: ((...args: unknown[]) => z.objectInputType<{ id: z.ZodString; }, z.ZodUnknown, "strip">[] | Promise[]>) | { name: string; load: (args_0: { collection: string; generateDigest: (args_0: any) => unknown; config?: any; meta?: any; logger?: any; store?: any; entryTypes?: any; parseData?: any; watcher?: any; }) => unknown; schema?: any; render?: ((args_0: any) => unknown) | undefined; }; schema?: any; }>]>>; }, "strip", z.ZodTypeAny, { collections: Record z.objectOutputType<{ id: z.ZodString; }, z.ZodUnknown, "strip">[] | Promise[]>) | { name: string; load: (args_0: { collection: string; generateDigest: (args_0: any) => unknown; config?: any; meta?: any; logger?: any; store?: any; entryTypes?: any; parseData?: any; watcher?: any; }) => unknown; schema?: any; render?: ((args_0: any) => unknown) | undefined; }; schema?: any; }>; }, { collections: Record z.objectInputType<{ id: z.ZodString; }, z.ZodUnknown, "strip">[] | Promise[]>) | { name: string; load: (args_0: { collection: string; generateDigest: (args_0: any) => unknown; config?: any; meta?: any; logger?: any; store?: any; entryTypes?: any; parseData?: any; watcher?: any; }) => unknown; schema?: any; render?: ((args_0: any) => unknown) | 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, pluginContext?: PluginContext): Promise<{ data: TOutputData; imageImports: Array; }>; export declare function getEntryData(entry: { id: string; collection: string; unvalidatedData: Record; _internal: EntryInternal; }, collectionConfig: CollectionConfig, shouldEmitFile: 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): matter.GrayMatterFile; /** * 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 hasAnyContentFlag(viteId: string): boolean; 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 declare function contentObservable(initialCtx: ContentCtx): ContentObservable; export type ContentPaths = { contentDir: URL; assetsDir: URL; typesTemplate: URL; virtualModTemplate: URL; config: { exists: boolean; url: URL; }; }; export declare function getContentPaths({ srcDir }: 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; /** * Convert a platform path to a posix path. */ export declare function posixifyPath(filePath: 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 {};