mdorigin 0.4.1 → 0.5.1

package/dist/i18n/messages.d.ts

@@ -0,0 +1,45 @@
+export interface SiteMessages {
+    'search.toggle': string;
+    'search.label': string;
+    'search.placeholder': string;
+    'search.go': string;
+    'search.hint': string;
+    'search.resultsEmpty': string;
+    'search.searching': string;
+    'search.failed': string;
+    'search.failedWithStatus': string;
+    'search.enterQuery': string;
+    'search.initialHint': string;
+    'search.untitled': string;
+    'footer.editPage': string;
+    'footer.markdownView': string;
+    'footer.markdownViewAria': string;
+    'languages.ariaLabel': string;
+    'listing.browseSection': string;
+    'listing.loadMore': string;
+    'listing.loading': string;
+    'listing.ariaLabel': string;
+    'listing.emptyDirectory': string;
+    'error.notFoundTitle': string;
+    'error.notFoundBody': string;
+}
+export type SiteMessageKey = keyof SiteMessages;
+export declare const DEFAULT_SITE_LOCALE = "en";
+export declare function isKnownSiteLocale(locale: string): boolean;
+/**
+ * Resolves the effective message set for a locale: built-in English catalog,
+ * overlaid with the built-in catalog for the locale (when available, unknown
+ * locales fall back to English), overlaid with user overrides.
+ */
+export declare function resolveSiteMessages(locale: string | undefined, overrides?: Partial<SiteMessages>): SiteMessages;
+export declare function formatSiteMessage(message: string, params: Record<string, string>): string;
+/**
+ * Serializes messages for embedding inside an inline `<script>` element. `<`
+ * is escaped so that a message containing `</script>` cannot terminate the
+ * script block early.
+ */
+export declare function serializeMessagesForScript(value: Record<string, unknown>): string;
+export declare function validateSiteMessages(value: unknown): {
+    messages: Partial<SiteMessages>;
+    unknownKeys: string[];
+};

package/dist/i18n/messages.js

@@ -0,0 +1,104 @@
+export const DEFAULT_SITE_LOCALE = 'en';
+/**
+ * Built-in message catalogs. Messages are trusted template fragments: they may
+ * contain inline HTML markup such as `<code>` and `{placeholder}` parameters.
+ */
+const enMessages = {
+    'search.toggle': 'Search',
+    'search.label': 'Search site',
+    'search.placeholder': 'Search docs and skills',
+    'search.go': 'Go',
+    'search.hint': 'Search is powered by <code>/api/search</code>.',
+    'search.resultsEmpty': 'No results.',
+    'search.searching': 'Searching...',
+    'search.failed': 'Search failed.',
+    'search.failedWithStatus': 'Search failed ({status}).',
+    'search.enterQuery': 'Enter a search query.',
+    'search.initialHint': 'Search docs, guides, and skills.',
+    'search.untitled': 'Untitled',
+    'footer.editPage': 'Edit this page',
+    'footer.markdownView': 'MD View',
+    'footer.markdownViewAria': 'View Markdown source',
+    'languages.ariaLabel': 'Languages',
+    'listing.browseSection': 'Browse this section.',
+    'listing.loadMore': 'Load more',
+    'listing.loading': 'Loading...',
+    'listing.ariaLabel': 'Content listing',
+    'listing.emptyDirectory': 'This directory is empty.',
+    'error.notFoundTitle': 'Not Found',
+    'error.notFoundBody': 'No page was published at <code>{path}</code>.',
+};
+const zhCnMessages = {
+    'search.toggle': '搜索',
+    'search.label': '搜索站点',
+    'search.placeholder': '搜索文档与技能',
+    'search.go': '搜索',
+    'search.hint': '搜索由 <code>/api/search</code> 提供支持。',
+    'search.resultsEmpty': '没有找到结果。',
+    'search.searching': '搜索中...',
+    'search.failed': '搜索失败。',
+    'search.failedWithStatus': '搜索失败（{status}）。',
+    'search.enterQuery': '请输入搜索关键词。',
+    'search.initialHint': '搜索文档、指南与技能。',
+    'search.untitled': '无标题',
+    'footer.editPage': '编辑此页',
+    'footer.markdownView': 'MD 视图',
+    'footer.markdownViewAria': '查看 Markdown 源文件',
+    'languages.ariaLabel': '语言',
+    'listing.browseSection': '浏览此章节。',
+    'listing.loadMore': '加载更多',
+    'listing.loading': '加载中...',
+    'listing.ariaLabel': '内容列表',
+    'listing.emptyDirectory': '此目录为空。',
+    'error.notFoundTitle': '未找到',
+    'error.notFoundBody': '没有页面发布在 <code>{path}</code>。',
+};
+const messageCatalogs = {
+    en: enMessages,
+    'zh-CN': zhCnMessages,
+};
+const catalogKeys = new Map(Object.keys(messageCatalogs).map((key) => [key.toLowerCase(), key]));
+export function isKnownSiteLocale(locale) {
+    return messageCatalogs[locale] !== undefined;
+}
+/**
+ * Resolves the effective message set for a locale: built-in English catalog,
+ * overlaid with the built-in catalog for the locale (when available, unknown
+ * locales fall back to English), overlaid with user overrides.
+ */
+export function resolveSiteMessages(locale, overrides) {
+    const catalogKey = locale === undefined ? undefined : catalogKeys.get(locale.toLowerCase());
+    const catalog = catalogKey === undefined ? undefined : messageCatalogs[catalogKey];
+    if (catalog === undefined || catalogKey === 'en') {
+        return { ...enMessages, ...(overrides ?? {}) };
+    }
+    return { ...enMessages, ...catalog, ...(overrides ?? {}) };
+}
+export function formatSiteMessage(message, params) {
+    return Object.entries(params).reduce((text, [key, value]) => text.replaceAll(`{${key}}`, value), message);
+}
+/**
+ * Serializes messages for embedding inside an inline `<script>` element. `<`
+ * is escaped so that a message containing `</script>` cannot terminate the
+ * script block early.
+ */
+export function serializeMessagesForScript(value) {
+    return JSON.stringify(value).replaceAll('<', '\\u003c');
+}
+export function validateSiteMessages(value) {
+    const messages = {};
+    const unknownKeys = [];
+    if (typeof value !== 'object' || value === null) {
+        return { messages, unknownKeys };
+    }
+    for (const [key, entry] of Object.entries(value)) {
+        if (!(key in enMessages)) {
+            unknownKeys.push(key);
+            continue;
+        }
+        if (typeof entry === 'string' && entry !== '') {
+            messages[key] = entry;
+        }
+    }
+    return { messages, unknownKeys };
+}

package/dist/index-builder.d.ts

@@ -3,13 +3,15 @@ export interface BuildIndexOptions {
     rootDir?: string;
     dir?: string;
     plugins?: MdoPlugin[];
+    /** Top-level directory names (locale content bases) kept out of managed indexes. */
+    excludedDirectories?: string[];
 }
 export interface BuildIndexResult {
     updatedFiles: string[];
     skippedDirectories: string[];
 }
 export declare function buildDirectoryIndexes(options: BuildIndexOptions): Promise<BuildIndexResult>;
-export declare function buildManagedIndexBlock(directoryPath: string, plugins?: MdoPlugin[]): Promise<string>;
+export declare function buildManagedIndexBlock(directoryPath: string, plugins?: MdoPlugin[], excludedDirectories?: string[]): Promise<string>;
 export declare function upsertManagedIndexBlock(source: string, block: string, options?: {
     directoryPath?: string;
 }): string;

package/dist/index-builder.js

@@ -19,6 +19,7 @@ export async function buildDirectoryIndexes(options) {
         const updatedFile = await updateSingleDirectoryIndex(directoryPath, {
             createIfMissing: false,
             plugins: options.plugins ?? [],
+            excludedDirectories: options.excludedDirectories,
         });
         return {
             updatedFiles: updatedFile ? [updatedFile] : [],
@@ -33,6 +34,7 @@ export async function buildDirectoryIndexes(options) {
         const updatedFile = await updateSingleDirectoryIndex(directoryPath, {
             createIfMissing: false,
             plugins: options.plugins ?? [],
+            excludedDirectories: options.excludedDirectories,
         });
         if (updatedFile) {
             updatedFiles.push(updatedFile);
@@ -59,7 +61,7 @@ async function updateSingleDirectoryIndex(directoryPath, options) {
     const existingContent = indexFilePath
         ? await readFile(indexFilePath, 'utf8')
         : '';
-    const block = await buildManagedIndexBlock(directoryPath, options.plugins);
+    const block = await buildManagedIndexBlock(directoryPath, options.plugins, options.excludedDirectories);
     const nextContent = upsertManagedIndexBlock(existingContent, block, {
         directoryPath,
     });
@@ -68,10 +70,11 @@ async function updateSingleDirectoryIndex(directoryPath, options) {
     }
     return targetFilePath;
 }
-export async function buildManagedIndexBlock(directoryPath, plugins = []) {
+export async function buildManagedIndexBlock(directoryPath, plugins = [], excludedDirectories) {
     const entries = await readdir(directoryPath, { withFileTypes: true });
     const directories = [];
     const articles = [];
+    const excluded = new Set(excludedDirectories ?? []);
     for (const entry of entries) {
         if (isIgnoredContentName(entry.name)) {
             continue;
@@ -79,6 +82,9 @@ export async function buildManagedIndexBlock(directoryPath, plugins = []) {
         const fullPath = path.join(directoryPath, entry.name);
         const entryStats = await stat(fullPath);
         if (entryStats.isDirectory()) {
+            if (excluded.has(entry.name)) {
+                continue;
+            }
             if (!(await hasMeaningfulDirectoryContent(fullPath))) {
                 continue;
             }

package/dist/search.js

@@ -4,6 +4,7 @@ import { inferDirectoryContentType } from './core/content-type.js';
 import { getDirectoryIndexCandidates } from './core/directory-index.js';
 import { getDocumentSummary, getDocumentTitle, parseMarkdownDocument, stripMachineOnlyMarkdownComments, stripManagedIndexBlock, } from './core/markdown.js';
 import { isIgnoredContentName } from './core/content-store.js';
+import { ensureTrailingSlash, trimLeadingSlash } from './core/site-url.js';
 const OVERVIEW_CONTENT_FILENAMES = new Set(['readme.md', 'index.md', 'skill.md']);
 export async function buildSearchBundle(options) {
     const buildModule = await loadIndexbindBuildModule();
@@ -276,12 +277,6 @@ function getCanonicalHtmlPathForContentPath(contentPath) {
     }
     return `/${contentPath.slice(0, -'.md'.length)}`;
 }
-function trimLeadingSlash(value) {
-    return value.startsWith('/') ? value.slice(1) : value;
-}
-function ensureTrailingSlash(value) {
-    return value.endsWith('/') ? value : `${value}/`;
-}
 async function pathExists(filePath) {
     try {
         await stat(filePath);

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "mdorigin",
-  "version": "0.4.1",
+  "version": "0.5.1",
   "type": "module",
   "description": "Markdown-first publishing for humans and agents.",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/jolestar/mdorigin.git"
+    "url": "git+https://github.com/holon-run/mdorigin.git"
   },
-  "homepage": "https://mdorigin.jolestar.workers.dev",
+  "homepage": "https://mdorigin.holon.run",
   "bugs": {
-    "url": "https://github.com/jolestar/mdorigin/issues"
+    "url": "https://github.com/holon-run/mdorigin/issues"
   },
   "keywords": [
     "markdown",