@anydocs/core 1.0.0

package/dist/services/build-service.js

@@ -0,0 +1,84 @@
+import { mkdir } from 'node:fs/promises';
+import path from 'node:path';
+import { loadProjectContract } from "../fs/content-repository.js";
+import { createDocsRepository, listPages, loadNavigation } from "../fs/docs-repository.js";
+import { buildPublishedSiteLanguageContent, } from "../publishing/publication-filter.js";
+import { writePublishedArtifacts } from "../publishing/build-artifacts.js";
+import { writePublishedOpenApiArtifacts } from "../publishing/build-openapi-artifacts.js";
+function countNavigationItems(items) {
+    let count = 0;
+    for (const item of items) {
+        count += 1;
+        if (Array.isArray(item.children)) {
+            count += countNavigationItems(item.children);
+        }
+    }
+    return count;
+}
+export async function runBuildWorkflow(options) {
+    const contractResult = await loadProjectContract(options.repoRoot, options.projectId, options.outputDir);
+    if (!contractResult.ok) {
+        throw contractResult.error;
+    }
+    const contract = contractResult.value;
+    const siteArtifacts = await loadPublishedSiteBuildArtifacts(options);
+    const defaultLanguageSite = siteArtifacts.find((entry) => entry.lang === contract.config.defaultLanguage);
+    const firstPublishedRoute = defaultLanguageSite?.content.routes[0] ?? null;
+    const languages = siteArtifacts.map((entry) => entry.summary);
+    const { assertSafeArtifactRoot, exportDocsSite } = await import("./web-runtime-bridge.js");
+    assertSafeArtifactRoot(contract.paths);
+    await mkdir(contract.paths.artifactRoot, { recursive: true });
+    await exportDocsSite({
+        projectRoot: contract.paths.projectRoot,
+        outputRoot: contract.paths.artifactRoot,
+    });
+    await mkdir(contract.paths.machineReadableRoot, { recursive: true });
+    await writePublishedArtifacts(contract, siteArtifacts);
+    await writePublishedOpenApiArtifacts(contract);
+    return {
+        projectId: contract.config.projectId,
+        artifactRoot: contract.paths.artifactRoot,
+        machineReadableRoot: contract.paths.machineReadableRoot,
+        entryHtmlFile: path.join(contract.paths.artifactRoot, 'index.html'),
+        defaultDocsPath: firstPublishedRoute?.href ?? `/${contract.config.defaultLanguage}`,
+        languages,
+    };
+}
+export async function loadPublishedBuildArtifacts(options) {
+    const siteResults = await loadPublishedSiteBuildArtifacts(options);
+    return siteResults.map((entry) => ({
+        lang: entry.lang,
+        content: {
+            navigation: entry.content.navigation,
+            pages: entry.content.pages,
+        },
+        summary: entry.summary,
+    }));
+}
+export async function loadPublishedSiteBuildArtifacts(options) {
+    const contractResult = await loadProjectContract(options.repoRoot, options.projectId, options.outputDir);
+    if (!contractResult.ok) {
+        throw contractResult.error;
+    }
+    const contract = contractResult.value;
+    const repository = createDocsRepository(contract.paths.projectRoot);
+    const results = [];
+    for (const lang of contract.config.languages) {
+        const [navigation, pages] = await Promise.all([
+            loadNavigation(repository, lang),
+            listPages(repository, lang),
+        ]);
+        const content = buildPublishedSiteLanguageContent(lang, navigation, pages);
+        results.push({
+            lang,
+            content,
+            summary: {
+                lang,
+                totalPages: pages.length,
+                publishedPages: content.pages.length,
+                navigationItems: countNavigationItems(content.navigation.items),
+            },
+        });
+    }
+    return results;
+}

package/dist/services/index.d.ts

@@ -0,0 +1,11 @@
+export * from './authoring-service.ts';
+export * from './build-service.ts';
+export * from './init-service.ts';
+export * from './legacy-conversion-service.ts';
+export * from './legacy-import-service.ts';
+export * from './page-template-service.ts';
+export * from './preview-service.ts';
+export * from './watch-service.ts';
+export * from './workflow-compatibility-service.ts';
+export * from './workflow-standard-service.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qCAAqC,CAAC;AACpD,cAAc,gCAAgC,CAAC"}

package/dist/services/index.js

@@ -0,0 +1,10 @@
+export * from "./authoring-service.js";
+export * from "./build-service.js";
+export * from "./init-service.js";
+export * from "./legacy-conversion-service.js";
+export * from "./legacy-import-service.js";
+export * from "./page-template-service.js";
+export * from "./preview-service.js";
+export * from "./watch-service.js";
+export * from "./workflow-compatibility-service.js";
+export * from "./workflow-standard-service.js";

package/dist/services/init-service.d.ts

@@ -0,0 +1,15 @@
+import type { DocsLanguage, ProjectContract } from '../types/project.ts';
+export type InitProjectOptions = {
+    repoRoot: string;
+    projectId?: string;
+    projectName?: string;
+    defaultLanguage?: DocsLanguage;
+    languages?: DocsLanguage[];
+    agent?: 'codex' | 'claude-code';
+};
+export type InitProjectResult = {
+    contract: ProjectContract;
+    createdFiles: string[];
+};
+export declare function initializeProject(options: InitProjectOptions): Promise<InitProjectResult>;
+//# sourceMappingURL=init-service.d.ts.map

package/dist/services/init-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-service.d.ts","sourceRoot":"","sources":["../../src/services/init-service.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAIzE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,YAAY,CAAC;IAC/B,SAAS,CAAC,EAAE,YAAY,EAAE,CAAC;IAC3B,KAAK,CAAC,EAAE,OAAO,GAAG,aAAa,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,eAAe,CAAC;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC;AAyFF,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAyD/F"}

package/dist/services/init-service.js

@@ -0,0 +1,127 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { createDefaultProjectConfig, } from "../config/project-config.js";
+import { ValidationError } from "../errors/validation-error.js";
+import { createDocsRepository, initializeDocsRepository, saveNavigation, savePage, } from "../fs/docs-repository.js";
+import { validateProjectConfig } from "../schemas/project-schema.js";
+import { createProjectPathContract } from "../fs/project-paths.js";
+import { exportWorkflowStandard } from "./workflow-standard-service.js";
+const PROJECT_SKILL_GUIDE_FILE = 'skill.md';
+const PROJECT_AGENT_GUIDE_FILES = {
+    codex: 'AGENTS.md',
+    'claude-code': 'Claude.md',
+};
+const INIT_SERVICE_DIR = path.dirname(fileURLToPath(import.meta.url));
+const REPO_SKILL_GUIDE_PATH = path.resolve(INIT_SERVICE_DIR, '../../../../docs/skill.md');
+async function ensurePathDoesNotExist(targetPath, entity, remediation) {
+    try {
+        await fs.access(targetPath);
+        throw new ValidationError(`Cannot initialize project because ${entity} already exists at "${targetPath}".`, {
+            entity,
+            rule: 'init-target-must-not-conflict',
+            remediation,
+            metadata: { targetPath },
+        });
+    }
+    catch (error) {
+        if (error instanceof ValidationError) {
+            throw error;
+        }
+    }
+}
+async function writeJson(filePath, value) {
+    await fs.mkdir(path.dirname(filePath), { recursive: true });
+    await fs.writeFile(filePath, JSON.stringify(value, null, 2) + '\n', 'utf8');
+}
+function resolveAgentGuideFileName(agent) {
+    return agent ? PROJECT_AGENT_GUIDE_FILES[agent] : PROJECT_SKILL_GUIDE_FILE;
+}
+async function copyProjectSkillGuide(projectRoot, agent) {
+    const targetPath = path.join(projectRoot, resolveAgentGuideFileName(agent));
+    try {
+        await fs.access(targetPath);
+        return null;
+    }
+    catch {
+        await fs.mkdir(path.dirname(targetPath), { recursive: true });
+        await fs.copyFile(REPO_SKILL_GUIDE_PATH, targetPath);
+        return targetPath;
+    }
+}
+function createStarterPage(language) {
+    const isEnglish = language === 'en';
+    return {
+        id: 'welcome',
+        lang: language,
+        slug: 'welcome',
+        title: isEnglish ? 'Welcome' : '欢迎',
+        description: isEnglish
+            ? 'Starter page created by anydocs init.'
+            : '由 anydocs init 创建的起始页面。',
+        status: 'published',
+        content: {},
+        render: {
+            markdown: isEnglish ? '# Welcome' : '# 欢迎',
+            plainText: isEnglish ? 'Welcome' : '欢迎',
+        },
+    };
+}
+function createStarterNavigation() {
+    return {
+        version: 1,
+        items: [
+            {
+                type: 'section',
+                title: 'Getting Started',
+                children: [
+                    {
+                        type: 'page',
+                        pageId: 'welcome',
+                    },
+                ],
+            },
+        ],
+    };
+}
+export async function initializeProject(options) {
+    const config = validateProjectConfig(createDefaultProjectConfig({
+        projectId: options.projectId,
+        name: options.projectName,
+        defaultLanguage: options.defaultLanguage,
+        languages: options.languages,
+    }));
+    const paths = createProjectPathContract(options.repoRoot, config);
+    await ensurePathDoesNotExist(paths.configFile, 'project-config-file', 'Choose a different target directory or remove the existing anydocs.config.json before running anydocs init again.');
+    await initializeDocsRepository(createDocsRepository(paths.projectRoot), config.languages);
+    await writeJson(paths.configFile, config);
+    await writeJson(paths.workflowFile, exportWorkflowStandard({
+        config,
+        paths,
+    }).definition);
+    const createdFiles = [paths.configFile, paths.workflowFile];
+    const skillGuideFile = await copyProjectSkillGuide(paths.projectRoot, options.agent);
+    if (skillGuideFile) {
+        createdFiles.push(skillGuideFile);
+    }
+    const repository = createDocsRepository(paths.projectRoot);
+    const starterNavigation = createStarterNavigation();
+    for (const language of config.languages) {
+        await saveNavigation(repository, language, starterNavigation);
+        const starterPage = createStarterPage(language);
+        await savePage(repository, language, starterPage);
+        createdFiles.push(paths.languageRoots[language].navigationFile);
+        createdFiles.push(path.join(paths.languageRoots[language].pagesDir, `${starterPage.id}.json`));
+    }
+    await fs.mkdir(paths.artifactRoot, { recursive: true });
+    await fs.mkdir(paths.machineReadableRoot, { recursive: true });
+    await fs.mkdir(paths.importsRoot, { recursive: true });
+    await fs.mkdir(paths.apiSourcesRoot, { recursive: true });
+    return {
+        contract: {
+            config,
+            paths,
+        },
+        createdFiles,
+    };
+}

package/dist/services/legacy-conversion-service.d.ts

@@ -0,0 +1,8 @@
+import type { LegacyImportConversionResult } from '../types/legacy-import.ts';
+export type ConvertImportedLegacyContentOptions = {
+    repoRoot: string;
+    importId: string;
+    projectId?: string;
+};
+export declare function convertImportedLegacyContent(options: ConvertImportedLegacyContentOptions): Promise<LegacyImportConversionResult>;
+//# sourceMappingURL=legacy-conversion-service.d.ts.map

package/dist/services/legacy-conversion-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-conversion-service.d.ts","sourceRoot":"","sources":["../../src/services/legacy-conversion-service.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAGV,4BAA4B,EAM7B,MAAM,2BAA2B,CAAC;AAInC,MAAM,MAAM,mCAAmC,GAAG;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAorBF,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,mCAAmC,GAC3C,OAAO,CAAC,4BAA4B,CAAC,CAwLvC"}