docula 1.2.0 → 1.6.0

package/dist/docula.d.ts

@@ -87,6 +87,40 @@ type ApiSpecData = {
     securitySchemes: ApiSecurityScheme[];
 };
 
+declare class DoculaConsole {
+    log(message: string): void;
+    error(message: string): void;
+    warn(message: string): void;
+    success(message: string): void;
+    info(message: string): void;
+    step(message: string): void;
+    fileBuilt(filePath: string): void;
+    fileCopied(filePath: string): void;
+    serverLog(method: string, url: string, statusCode: number, durationMs?: number): void;
+    banner(message: string): void;
+    printHelp(): void;
+    parseProcessArgv(argv: string[]): DoculaConsoleProcess;
+    getCommand(argv: string[]): string | undefined;
+    getArguments(argv: string[]): DoculaConsoleArguments;
+}
+type DoculaConsoleProcess = {
+    argv: string[];
+    command: string | undefined;
+    args: DoculaConsoleArguments;
+};
+type DoculaConsoleArguments = {
+    sitePath: string | undefined;
+    templatePath: string | undefined;
+    template: string | undefined;
+    output: string | undefined;
+    watch: boolean;
+    clean: boolean;
+    build: boolean;
+    port: number | undefined;
+    typescript: boolean;
+    javascript: boolean;
+};
+
 type GithubData = {
     releases: Record<string, unknown>;
     contributors: Record<string, unknown>;
@@ -94,8 +128,10 @@ type GithubData = {
 
 type DoculaCookieAuth = {
     loginUrl: string;
-    cookieName?: string;
     logoutUrl?: string;
+    authCheckUrl?: string;
+    authCheckMethod?: string;
+    authCheckUserPath?: string;
 };
 type DoculaHeaderLink = {
     label: string;
@@ -160,10 +196,9 @@ declare class DoculaOptions {
      */
     enableReleaseChangelog: boolean;
     /**
-     * When false, the first document becomes the home page (index.html)
-     * and the home.hbs template is not rendered.
+     * Number of changelog entries to display per page on the changelog index.
      */
-    homePage: boolean;
+    changelogPerPage: number;
     /**
      * When true, generates llms.txt and llms-full.txt files for the built site.
      */
@@ -180,9 +215,23 @@ declare class DoculaOptions {
      */
     autoUpdateIgnores: boolean;
     /**
-     * File extensions to copy as assets from docs/ and changelog/ directories.
-     * Override in docula.config to customize.
+     * Base URL path prefix for all generated paths (e.g., "/docs").
+     * When set, all asset and navigation URLs are prefixed with this path.
+     */
+    baseUrl: string;
+    /**
+     * Output subdirectory and URL segment for documentation pages.
+     * Set to empty string to place docs at the output root.
+     */
+    docsPath: string;
+    /**
+     * Output subdirectory and URL segment for API reference pages.
      */
+    apiPath: string;
+    /**
+     * Output subdirectory and URL segment for changelog pages.
+     */
+    changelogPath: string;
     /**
      * Cookie-based authentication. When set, shows a Login/Logout button
      * in the header based on whether a JWT cookie is present.
@@ -220,7 +269,10 @@ type DoculaChangelogEntry = {
     slug: string;
     content: string;
     generatedHtml: string;
+    preview: string;
+    previewImage?: string;
     urlPath: string;
+    lastModified: string;
 };
 type DoculaData = {
     siteUrl: string;
@@ -242,12 +294,14 @@ type DoculaData = {
     hasApi?: boolean;
     apiSpec?: ApiSpecData;
     changelogEntries?: DoculaChangelogEntry[];
-    homePage?: boolean;
+    hasReadme?: boolean;
     themeMode?: string;
     cookieAuth?: {
         loginUrl: string;
-        cookieName?: string;
         logoutUrl?: string;
+        authCheckUrl?: string;
+        authCheckMethod?: string;
+        authCheckUserPath?: string;
     };
     headerLinks?: Array<{
         label: string;
@@ -256,6 +310,14 @@ type DoculaData = {
     }>;
     enableLlmsTxt?: boolean;
     hasFeed?: boolean;
+    lastModified?: string;
+    baseUrl: string;
+    docsPath: string;
+    apiPath: string;
+    changelogPath: string;
+    docsUrl: string;
+    apiUrl: string;
+    changelogUrl: string;
 };
 type DoculaTemplates = {
     home: string;
@@ -283,11 +345,14 @@ type DoculaDocument = {
     documentPath: string;
     urlPath: string;
     isRoot: boolean;
+    lastModified: string;
 };
 declare class DoculaBuilder {
     private readonly _options;
     private readonly _ecto;
     private readonly _console;
+    private readonly _hash;
+    onReleaseChangelog?: (entries: DoculaChangelogEntry[], console: DoculaConsole) => Promise<DoculaChangelogEntry[]> | DoculaChangelogEntry[];
     constructor(options?: DoculaOptions, engineOptions?: any);
     get options(): DoculaOptions;
     build(): Promise<void>;
@@ -301,6 +366,7 @@ declare class DoculaBuilder {
     buildLlmsFiles(data: DoculaData): Promise<void>;
     private generateLlmsIndexContent;
     private generateLlmsFullContent;
+    private buildUrlPath;
     private buildAbsoluteSiteUrl;
     private normalizePathForUrl;
     private escapeXml;
@@ -317,16 +383,19 @@ declare class DoculaBuilder {
     buildReadmeSection(data: DoculaData): Promise<string>;
     buildAnnouncementSection(data: DoculaData): Promise<string | undefined>;
     buildDocsPages(data: DoculaData): Promise<void>;
+    renderApiContent(data: DoculaData): Promise<string>;
     buildApiPage(data: DoculaData): Promise<void>;
-    getChangelogEntries(changelogPath: string): DoculaChangelogEntry[];
+    buildApiHomePage(data: DoculaData): Promise<void>;
+    getChangelogEntries(changelogPath: string, cachedEntries?: Map<string, DoculaChangelogEntry>, previousHashes?: Record<string, string>, currentHashes?: Record<string, string>): DoculaChangelogEntry[];
     parseChangelogEntry(filePath: string): DoculaChangelogEntry;
+    generateChangelogPreview(markdown: string, maxLength?: number, mdx?: boolean): string;
     convertReleaseToChangelogEntry(release: Record<string, any>): DoculaChangelogEntry;
     getReleasesAsChangelogEntries(releases: any[]): DoculaChangelogEntry[];
     buildChangelogPage(data: DoculaData): Promise<void>;
     buildChangelogEntryPages(data: DoculaData): Promise<void>;
     generateSidebarItems(data: DoculaData): DoculaSection[];
-    getDocuments(sitePath: string, doculaData: DoculaData): DoculaDocument[];
-    getDocumentInDirectory(sitePath: string): DoculaDocument[];
+    getDocuments(sitePath: string, doculaData: DoculaData, cachedDocs?: Map<string, DoculaDocument>, previousDocHashes?: Record<string, string>, currentDocHashes?: Record<string, string>): DoculaDocument[];
+    getDocumentInDirectory(sitePath: string, docsRootPath: string, cachedDocs?: Map<string, DoculaDocument>, previousDocHashes?: Record<string, string>, currentDocHashes?: Record<string, string>): DoculaDocument[];
     getSections(sitePath: string, doculaOptions: DoculaOptions): DoculaSection[];
     mergeSectionWithOptions(section: DoculaSection, options: DoculaOptions): DoculaSection;
     parseDocumentData(documentPath: string): DoculaDocument;
@@ -334,13 +403,31 @@ declare class DoculaBuilder {
     private directoryContainsMarkdown;
     private mergeTemplateOverrides;
     private ensureCacheInGitignore;
-    private isCacheFresh;
+    private getChangedOverrides;
+    private hashFile;
     private listFilesRecursive;
     private copyDirectory;
     private copyPublicFolder;
     private copyPublicDirectory;
     private copyDocumentSiblingAssets;
     private listContentAssets;
+    private loadBuildManifest;
+    private saveBuildManifest;
+    private hashOptions;
+    private hashTemplateDirectory;
+    private loadCachedDocuments;
+    private saveCachedDocuments;
+    private loadCachedChangelog;
+    private saveCachedChangelog;
+    private hashSourceFiles;
+    private recordsEqual;
+    private hasAssetsChanged;
+    /**
+     * Hashes the source file, records it in currentAssets, and returns
+     * whether the copy can be skipped (unchanged from previous build).
+     */
+    private hashAssetAndCheckSkip;
+    private copyDirectoryWithHashing;
     private copyContentAssets;
 }
 
@@ -400,6 +487,12 @@ declare class Docula {
      * @returns {Promise<void>}
      */
     execute(process: NodeJS.Process): Promise<void>;
+    private runBuild;
+    /**
+     * Detect if the current project uses TypeScript by checking for tsconfig.json
+     * @returns {boolean}
+     */
+    detectTypeScript(): boolean;
     /**
      * Generate the init files
      * @param {string} sitePath
@@ -434,4 +527,4 @@ declare class Docula {
     serve(options: DoculaOptions): Promise<http.Server>;
 }
 
-export { type DoculaCacheOptions, type DoculaCookieAuth, type DoculaHeaderLink, DoculaOptions, Docula as default };
+export { type DoculaCacheOptions, type DoculaChangelogEntry, DoculaConsole, type DoculaCookieAuth, type DoculaHeaderLink, DoculaOptions, Docula as default };