@mdfriday/foundry 25.11.12 → 25.11.14

package/dist/internal/domain/site/entity/site.d.ts

@@ -8,12 +8,8 @@ import { Page as ContentPage } from '../../content/type';
 import { Compiler, ConfigService, ContentService, FsService, LanguageService, SitemapService, Template, TranslationService } from '../type';
 import { Author } from '../valueobject/author';
 import { Organization } from '../valueobject/organization';
-import { TaxonomyList } from "../../../domain/site/entity/taxonomies-builder";
-import { Menus } from "../../../domain/site/valueobject/menu";
-/**
- * Site - TypeScript equivalent of Go's Site entity
- * Main site management class
- */
+import { TaxonomyList } from "@internal/domain/site/entity/taxonomies-builder";
+import { Menus } from "@internal/domain/site/valueobject/menu";
 export declare class Site {
     private configSvc;
     private contentSvc;
@@ -48,54 +44,18 @@ export declare class Site {
     Pages(): Promise<Page[]>;
     RegularPages(): Promise<Page[]>;
     constructor(configSvc: ConfigService, contentSvc: ContentService, translationSvc: TranslationService, languageSvc: LanguageService, sitemap: SitemapService, staticCopySvc: FsService, publisher: Publisher, author: Author, organization: Organization, compiler: Compiler, url: URL, ref: Ref | null, language: Language, navigation: Navigation | null, title: string);
-    /**
-     * Build site
-     * TypeScript equivalent of Build method from Go
-     */
     build(template: Template): Promise<void>;
-    /**
-     * Build site with progress callbacks
-     * TypeScript equivalent of Build method from Go with progress tracking
-     */
     buildWithProgress(template: Template, onProgress?: (progress: {
         currentPage: number;
         totalPages: number;
     }) => void): Promise<void>;
-    /**
-     * Setup site before rendering
-     * TypeScript equivalent of setup method from Go
-     */
     private setup;
     renderAllLanguages(): Promise<void>;
-    /**
-     * Render all pages
-     * TypeScript equivalent of render method from Go
-     */
     render(): Promise<void>;
-    /**
-     * Render all pages with progress tracking
-     * TypeScript equivalent of render method from Go with progress callbacks
-     */
     private renderWithProgress;
-    /**
-     * Render pages for current language
-     * TypeScript equivalent of renderPages method from Go
-     * 支持增量构建：根据环境变量判断是否只渲染 stale 页面
-     */
     private renderPages;
-    /**
-     * Render pages for current language with progress tracking
-     * TypeScript equivalent of renderPages method from Go with progress callbacks
-     */
     private renderPagesWithProgress;
-    /**
-     * Get page output (simplified implementation)
-     * TypeScript equivalent of pageOutput method from Go
-     */
     private pageOutput;
-    /**
-     * Clear site cache (simplified implementation)
-     */
     private clearSiteCache;
     translate(translationID: string): string;
     get Home(): Page | null;
@@ -104,108 +64,33 @@ export declare class Site {
     get Menus(): Menus;
     getTitle(): string;
     setTitle(title: string): void;
-    /**
-     * Get configuration service
-     */
     getConfigService(): ConfigService;
-    /**
-     * Get content service
-     */
     getContentService(): ContentService;
-    /**
-     * Get language service
-     */
     getLanguageService(): LanguageService;
-    /**
-     * Get base URL
-     * Provides the base URL service without exposing internal URL object
-     */
     baseURL(): string;
     get BaseURL(): string;
-    /**
-     * Get URL handler
-     */
     getURL(): URL;
-    /**
-     * Get reference handler
-     */
     getRef(): Ref;
-    /**
-     * Get language handler
-     */
     getLanguage(): Language;
     get Language(): Language;
     get LanguageCode(): string;
     get Languages(): Language[];
-    /**
-     * Get navigation handler
-     */
     getNavigation(): Navigation;
-    /**
-     * Get publisher
-     */
     getPublisher(): Publisher;
-    /**
-     * Get template
-     */
     getTemplate(): Template | null;
     get Author(): Author;
     get Organization(): Organization;
-    /**
-     * Get compiler info
-     */
     getCompiler(): Compiler;
-    /**
-     * Get sitemap service
-     */
     getSitemap(): SitemapService;
-    /**
-     * Check if site is multi-language
-     */
     isMultipleLanguage(): boolean;
     get IsMultilingual(): boolean;
-    /**
-     * Get current language
-     */
     getCurrentLanguage(): string;
-    /**
-     * Get language prefix for URLs
-     */
     languagePrefix(): string;
-    /**
-     * Site page factory method - convert content page to site page
-     */
     sitePage(target: ContentPage): Promise<Page>;
-    /**
-     * Convert array of content pages to array of site pages
-     * TypeScript equivalent of Go's sitePages method
-     */
     private sitePages;
-    /**
-     * Create site page from content page (synchronous version)
-     * TypeScript equivalent of Go's site page creation
-     */
     sitePageSync(contentPage: ContentPage): Page;
-    /**
-     * Pre-generate menus for all languages
-     * This ensures menus are cached before page rendering begins
-     */
     private generateNavigations;
-    /**
-     * Get page by path
-     * TypeScript equivalent of Go's GetPage method
-     * Made synchronous to match template function requirements
-     */
     GetPage(...ref: string[]): Page | null;
-    /**
-     * Copy static files to publish directory
-     * This is a core business capability of the Site entity
-     */
     copyStaticFiles(): Promise<void>;
-    /**
-     * Create site weighted page from ordinal weight page
-     * TypeScript equivalent of Go's siteWeightedPage method
-     */
     siteWeightedPage(ordinalWeightPage: any): Promise<any>;
 }
-//# sourceMappingURL=site.d.ts.map

package/dist/internal/domain/site/entity/taxonomies-builder.d.ts

@@ -1,5 +1,5 @@
 import { ContentService } from '../type';
-import { OrdinalWeightPage } from "../../../domain/content";
+import { OrdinalWeightPage } from "@internal/domain/content";
 import { Site } from "./site";
 import { Page } from "./page";
 export declare class WeightedPage {
@@ -63,4 +63,3 @@ export declare class TaxonomiesBuilder {
     constructor(contentService: ContentService);
     buildTaxonomiesForLanguage(langIndex: number, site: Site): Promise<TaxonomyList>;
 }
-//# sourceMappingURL=taxonomies-builder.d.ts.map

package/dist/internal/domain/site/entity/url.d.ts

@@ -21,4 +21,3 @@ export declare class URL {
     basePathNoSlash(): string;
     private joinPaths;
 }
-//# sourceMappingURL=url.d.ts.map

package/dist/internal/domain/site/factory/navigation-factory.d.ts

@@ -6,13 +6,6 @@ export declare class NavigationFactory {
     private readonly contentService;
     private readonly site;
     constructor(langService: LanguageService, contentService: ContentService, site: Site);
-    /**
-     * Create a Navigation entity with menu building capabilities
-     */
     createNavigation(): Navigation;
 }
-/**
- * Create navigation factory instance
- */
 export declare function createNavigationFactory(langService: LanguageService, contentService: ContentService, site: Site): NavigationFactory;
-//# sourceMappingURL=navigation-factory.d.ts.map

package/dist/internal/domain/site/factory/site.d.ts

@@ -1,8 +1,3 @@
 import { Site } from '../entity/site';
 import { Services } from '../type';
-/**
- * Create new Site instance with enhanced Navigation (including menu building)
- * TypeScript equivalent of New function from Go
- */
 export declare function newSite(services: Services): Site;
-//# sourceMappingURL=site.d.ts.map

package/dist/internal/domain/site/type.d.ts

@@ -1,15 +1,8 @@
 import { Page as ContentPage, PageSource, WalkTaxonomyFunc } from '../content/type';
 import { ReadableStream } from 'stream/web';
 import { Fs } from '../fs/type';
-/**
- * Services - TypeScript equivalent of Go's Services interface
- * Main service aggregation interface
- */
 export interface Services extends ContentService, TranslationService, ResourceService, LanguageService, FsService, URLService, ConfigService, SitemapService {
 }
-/**
- * ConfigService - TypeScript equivalent of Go's ConfigService
- */
 export interface ConfigService {
     configParams(): Record<string, any>;
     siteTitle(): string;
@@ -26,9 +19,6 @@ export interface ConfigService {
     getSocialLink(platformId: string): string;
     getSocialTitle(platformId: string): string;
 }
-/**
- * ContentService - TypeScript equivalent of Go's ContentService
- */
 export interface ContentService {
     walkPages(langIndex: number, walker: WalkFunc): Promise<void>;
     getPageSources(page: ContentPage): Promise<PageSource[]>;
@@ -40,31 +30,19 @@ export interface ContentService {
     getPageFromPathSync(langIndex: number, path: string): ContentPage | null;
     getPageRef(context: ContentPage, ref: string, home: ContentPage): Promise<ContentPage | null>;
 }
-/**
- * TranslationService - TypeScript equivalent of Go's TranslationService
- */
 export interface TranslationService {
     translate(lang: string, translationID: string): string;
 }
-/**
- * ResourceService - TypeScript equivalent of Go's ResourceService
- */
 export interface ResourceService {
     getResource(path: string): Promise<Resource | null>;
     getResourceWithOpener(path: string, opener: OpenReadSeekCloser): Promise<Resource>;
 }
-/**
- * LanguageService - TypeScript equivalent of Go's LanguageService
- */
 export interface LanguageService {
     defaultLanguage(): string;
     languageKeys(): string[];
     getLanguageIndex(lang: string): number;
     getLanguageName(lang: string): string;
 }
-/**
- * SitemapService - TypeScript equivalent of Go's SitemapService
- */
 export interface SitemapService {
     changeFreq(): string;
     priority(): number;
@@ -72,126 +50,72 @@ export interface SitemapService {
         urls: any[];
     }>;
 }
-/**
- * Walk function types
- */
 export type WalkFunc = (page: ContentPage) => Promise<void>;
-/**
- * Menu - TypeScript equivalent of Go's Menu interface
- */
 export interface Menu {
     name(): string;
     url(): string;
     weight(): number;
 }
-/**
- * Resource interface
- */
 export interface Resource {
     name(): string;
     readSeekCloser(): Promise<ReadableStream<Uint8Array>>;
     targetPath(): string;
 }
-/**
- * OpenReadSeekCloser - TypeScript equivalent of Go's io.OpenReadSeekCloser
- */
 export type OpenReadSeekCloser = () => Promise<ReadableStream<Uint8Array>>;
-/**
- * FsService - TypeScript equivalent of Go's FsService
- */
 export interface FsService {
     publishFs(): Fs;
     staticFs(): Fs;
     copyStaticFiles(from: Fs, to: Fs): Promise<void>;
     workingDir(): string;
 }
-/**
- * URLService - TypeScript equivalent of Go's URLService
- */
 export interface URLService {
     baseUrl(): string;
 }
-/**
- * Author interface
- */
 export interface Author {
     name(): string;
     email(): string;
 }
-/**
- * Organization interface
- */
 export interface Organization {
     name(): string;
     description(): string;
     website(): string;
 }
-/**
- * Compiler interface
- */
 export interface Compiler {
     version(): string;
     environment(): string;
 }
-/**
- * Site interface - minimal implementation for dependencies
- */
 export interface Site {
     currentLanguage: string;
     baseURL(): string;
 }
-/**
- * RefArgs interface - TypeScript equivalent of valueobject.RefArgs
- */
 export interface RefArgs {
     path: string;
     outputFormat: string;
 }
-/**
- * RefSite interface for Ref dependencies
- */
 export interface RefSite {
     home: {
         page: ContentPage;
     };
     sitePage(target: ContentPage): Promise<SitePage>;
 }
-/**
- * SitePage interface with permalink methods
- */
 export interface SitePage {
     relPermalink(): string;
     permalink(): string;
     path?(): string;
 }
-/**
- * PageWrapper interface
- */
 export interface PageWrapper {
     unwrapPage(): ContentPage;
 }
-/**
- * Position interface for error reporting
- */
 export interface Position {
     isValid(): boolean;
     toString(): string;
 }
-/**
- * Positioner interface
- */
 export interface Positioner {
     position(): Position;
 }
-/**
- * Menus interface - TypeScript equivalent of valueobject.Menus
- */
 export interface Menus {
     [key: string]: any;
 }
-/**
- * BaseURL interface
- */
 export interface BaseURL {
     protocol(): string;
     host(): string;
@@ -202,9 +126,6 @@ export interface BaseURL {
     getRoot(path: string): string;
     basePathNoTrailingSlash: string;
 }
-/**
- * URLSite interface
- */
 export interface URLSite {
     baseURL(): BaseURL;
     absURL(input: string): string;
@@ -213,31 +134,19 @@ export interface URLSite {
     languagePrefix(): string;
     isMultipleLanguage(): boolean;
 }
-/**
- * Language - TypeScript equivalent of Go's Language interface
- */
 export interface Language {
     location(): string;
     collator(): Collator;
 }
-/**
- * Collator interface for string comparison
- */
 export interface Collator {
     compare(a: string, b: string): number;
 }
-/**
- * URL - TypeScript equivalent of Go's URL interface
- */
 export interface URL {
     base: string;
     absURL(input: string): string;
     relURL(input: string): string;
     urlize(uri: string): string;
 }
-/**
- * Template - TypeScript equivalent of Go's Template interface
- */
 export interface Template {
     lookupLayout(names: string[]): Promise<{
         preparer: TemplatePreparer;
@@ -245,22 +154,12 @@ export interface Template {
     }>;
     executeWithContext(preparer: TemplatePreparer, data: any): Promise<string>;
 }
-/**
- * TemplatePreparer interface
- */
 export interface TemplatePreparer {
     name(): string;
     execute(data: any): Promise<string>;
 }
-/**
- * ContentSpec - TypeScript equivalent of Go's ContentSpec
- */
 export interface ContentSpec {
     preparePages(): Promise<void>;
     renderPages(handler: RenderHandler): Promise<void>;
 }
-/**
- * RenderHandler function type
- */
 export type RenderHandler = (kind: string, sections: string[], dir: string, name: string, content: string) => Promise<void>;
-//# sourceMappingURL=type.d.ts.map

package/dist/internal/domain/site/valueobject/author.d.ts

@@ -1,7 +1,4 @@
-import { Author as ContentAuthor } from '../../../domain/content';
-/**
- * Social link item with ID and Link properties
- */
+import { Author as ContentAuthor } from '@internal/domain/content';
 export interface SocialLink {
     ID: string;
     Link: string;
@@ -11,27 +8,13 @@ export declare class Author {
     private readonly _email;
     private _homeAuthor;
     constructor(name: string, email: string);
-    /**
-     * Get author name
-     */
     name(): string;
-    /**
-     * Get author email
-     */
     email(): string;
     author(author: ContentAuthor | undefined): Author;
     get Name(): string;
     get Description(): string;
     get Avatar(): string;
     get Twitter(): string;
-    /**
-     * Get all social links as array of objects with ID and Link properties
-     */
     get Socials(): SocialLink[];
 }
-/**
- * Factory function to create new Author
- * TypeScript equivalent of NewAuthor function from Go
- */
 export declare function newAuthor(name: string, email: string): Author;
-//# sourceMappingURL=author.d.ts.map

package/dist/internal/domain/site/valueobject/baseurl.d.ts

@@ -7,58 +7,18 @@ export declare class BaseURL {
     readonly basePathNoTrailingSlash: string;
     readonly isRelative: boolean;
     private constructor();
-    /**
-     * Creates a new BaseURL instance from a string.
-     * Supports various formats:
-     * - Absolute URLs: https://example.com/, https://example.com/public/
-     * - Relative paths: /public/, /
-     * - Protocol-relative URLs: //example.com/
-     */
     static fromString(baseUrl: string): BaseURL;
-    /**
-     * Returns the appropriate root URL based on the path.
-     */
     getRoot(path: string): string;
     toString(): string;
     path(): string;
     port(): number;
-    /**
-     * Returns the URL to the host root without any path elements.
-     */
     hostURL(): string;
-    /**
-     * Returns the protocol (scheme) of the URL.
-     */
     protocol(): string;
-    /**
-     * Returns the host (hostname + port) of the URL.
-     */
     host(): string;
-    /**
-     * Returns the hostname of the URL.
-     */
     hostname(): string;
-    /**
-     * Returns a copy of the internal URL.
-     * The copy can be safely used and modified.
-     */
     getURL(): URL;
-    /**
-     * Returns the BaseURL prefixed with the given protocol.
-     * The Protocol is normally of the form "scheme://", i.e. "webcal://".
-     */
     withProtocol(protocol: string): BaseURL;
-    /**
-     * Returns a new BaseURL with the specified port.
-     */
     withPort(port: number): BaseURL;
-    /**
-     * Checks if this BaseURL is relative (path-only).
-     */
     isRelativeURL(): boolean;
-    /**
-     * Checks if this BaseURL is absolute (has protocol and host).
-     */
     isAbsoluteURL(): boolean;
 }
-//# sourceMappingURL=baseurl.d.ts.map

package/dist/internal/domain/site/valueobject/menu.d.ts

@@ -1,7 +1,3 @@
-/**
- * Menu - A single menu item with hierarchical support
- * Simplified structure focusing on essential properties
- */
 export declare class Menu {
     private readonly _title;
     private readonly _url;
@@ -15,50 +11,20 @@ export declare class Menu {
         weight?: number;
         identifier?: string;
     });
-    /**
-     * Get menu entry title
-     */
     title(): string;
     get Title(): string;
-    /**
-     * Get menu entry URL
-     */
     url(): string;
     get URL(): string;
-    /**
-     * Get child menu entries
-     */
     children(): Menu[];
     get Children(): Menu[];
-    /**
-     * Get menu entry weight for sorting
-     */
     weight(): number;
-    /**
-     * Get menu entry identifier
-     */
     identifier(): string;
-    /**
-     * Check if this menu entry has children
-     */
     hasChildren(): boolean;
     get HasChildren(): boolean;
-    /**
-     * Add a child menu entry
-     */
     addChild(child: Menu): Menu;
-    /**
-     * Convert to JSON representation
-     */
     toJSON(): any;
-    /**
-     * Create a new Menu with updated children
-     */
     withChildren(children: Menu[]): Menu;
 }
-/**
- * Menus - Simplified menu structure with nav and footer
- */
 export declare class Menus {
     private readonly _nav;
     private readonly _footer;
@@ -66,27 +32,11 @@ export declare class Menus {
         nav?: Menu[];
         footer?: Menu[];
     });
-    /**
-     * Get navigation menu
-     */
     nav(): Menu[];
     get Nav(): Menu[];
-    /**
-     * Get footer menu
-     */
     footer(): Menu[];
     get Footer(): Menu[];
-    /**
-     * Sort menus by weight and then by title
-     */
     private sortMenus;
-    /**
-     * Convert to plain object for serialization
-     */
     toJSON(): Record<string, any[]>;
 }
-/**
- * Create empty menus instance
- */
 export declare function newEmptyMenus(): Menus;
-//# sourceMappingURL=menu.d.ts.map