@intra-mart/accel 0.1.0-dev-20260420

package/dist/i18n/en.js

@@ -0,0 +1,47 @@
+export const messages = {
+    // init/attach prompts
+    "prompt.name": "Enter project name",
+    "prompt.jugglingProject": "Enter IM-Juggling project path (optional)",
+    "prompt.accelplatformVersion": "Select iAP version",
+    "prompt.modules": "Select modules to use",
+    "prompt.group": "Enter group name",
+    "prompt.projectVersion": "Enter project version",
+    "prompt.description": "Enter project description",
+    "prompt.database": "Select database",
+    "prompt.javascript": "Use JavaScript?",
+    "prompt.agent": "Select agent",
+    "prompt.withGit": "Initialize Git repository?",
+    // juggling
+    "juggling.detected.version": "Detected version from juggling.im: {version}",
+    "juggling.detected.modules": "Detected modules from juggling.im: {modules}",
+    "juggling.notFound": "juggling.im not found at specified path: {path}",
+    // warnings
+    "warning.versionMismatch": "Specified iAP version ({option}) differs from juggling.im ({juggling}). Using specified value.",
+    "warning.moduleMismatch": "Specified modules differ from juggling.im. Using specified values.",
+    "warning.gitNotFound": "git command not found. Skipping Git initialization.",
+    "warning.fileExists": "File already exists, skipping: {path}",
+    // attach
+    "attach.skipSummary": "{count} file(s) were skipped because they already exist.",
+    // detach
+    "detach.confirm": "Detach Accel CLI from this project. Are you sure?",
+    "detach.deleted": "Deleted: {path}",
+    "detach.skipped": "Skipped: {path} (modifications detected)",
+    "detach.complete": "Detach complete. {skipped} file(s) were skipped due to user modifications.",
+    "detach.completeAll": "Detach complete. All assets removed.",
+    "detach.cancelled": "Detach cancelled.",
+    // errors
+    "error.directoryExists": "Directory already exists: {path}",
+    "error.accelExists": ".accel directory already exists",
+    "error.accelNotFound": ".accel directory not found",
+    "error.missingRequiredOptions": "The following required options are missing: {options}",
+    "error.invalidVersion": "Invalid iAP version: {version}",
+    "error.invalidModule": "Invalid module: {module}",
+    "error.invalidDatabase": "Invalid database: {database}",
+    "error.invalidAgent": "Invalid agent: {agent}",
+    // progress
+    "progress.downloading": "Downloading assets...",
+    "progress.deploying": "Deploying assets...",
+    "progress.installing": "Installing dependencies...",
+    "progress.gitInit": "Initializing Git repository...",
+    "progress.complete": "Project creation complete.",
+};

package/dist/i18n/index.d.ts

@@ -0,0 +1,2 @@
+export declare const getMessage: (key: string, locale: string, params?: Record<string, string>) => string;
+export declare const getSupportedLocales: () => string[];

package/dist/i18n/index.js

@@ -0,0 +1,19 @@
+import { messages as ja } from "./ja.js";
+import { messages as en } from "./en.js";
+import { messages as zhCN } from "./zh_CN.js";
+const catalogs = {
+    ja,
+    en,
+    "zh_CN": zhCN,
+};
+export const getMessage = (key, locale, params) => {
+    const catalog = catalogs[locale] ?? catalogs["en"];
+    let message = catalog[key] ?? catalogs["en"][key] ?? key;
+    if (params) {
+        for (const [paramKey, paramValue] of Object.entries(params)) {
+            message = message.replaceAll(`{${paramKey}}`, paramValue);
+        }
+    }
+    return message;
+};
+export const getSupportedLocales = () => Object.keys(catalogs);

package/dist/i18n/ja.d.ts

@@ -0,0 +1 @@
+export declare const messages: Record<string, string>;

package/dist/i18n/ja.js

@@ -0,0 +1,47 @@
+export const messages = {
+    // init/attach prompts
+    "prompt.name": "プロジェクト名を入力してください",
+    "prompt.jugglingProject": "IM-Jugglingプロジェクトのパスを入力してください（省略可）",
+    "prompt.accelplatformVersion": "iAPバージョンを選択してください",
+    "prompt.modules": "利用するモジュールを選択してください",
+    "prompt.group": "グループ名を入力してください",
+    "prompt.projectVersion": "プロジェクトバージョンを入力してください",
+    "prompt.description": "プロジェクトの説明を入力してください",
+    "prompt.database": "データベースを選択してください",
+    "prompt.javascript": "JavaScriptを利用しますか？",
+    "prompt.agent": "エージェントを選択してください",
+    "prompt.withGit": "Gitリポジトリを初期化しますか？",
+    // juggling
+    "juggling.detected.version": "juggling.imからバージョンを検出: {version}",
+    "juggling.detected.modules": "juggling.imからモジュールを検出: {modules}",
+    "juggling.notFound": "指定されたパスにjuggling.imが見つかりません: {path}",
+    // warnings
+    "warning.versionMismatch": "指定されたiAPバージョン ({option}) とjuggling.imのバージョン ({juggling}) が異なります。指定値を優先します。",
+    "warning.moduleMismatch": "指定されたモジュールとjuggling.imのモジュールが異なります。指定値を優先します。",
+    "warning.gitNotFound": "gitコマンドが見つかりません。Git初期化をスキップします。",
+    "warning.fileExists": "既存ファイルのためスキップ: {path}",
+    // attach
+    "attach.skipSummary": "{count}件のファイルは既に存在したためスキップしました。",
+    // detach
+    "detach.confirm": "このプロジェクトからAccel CLIを解除します。よろしいですか？",
+    "detach.deleted": "削除: {path}",
+    "detach.skipped": "スキップ: {path} (変更が検出されました)",
+    "detach.complete": "detachが完了しました。{skipped}件のファイルはユーザーによる変更が検出されたためスキップしました。",
+    "detach.completeAll": "detachが完了しました。すべての資材を削除しました。",
+    "detach.cancelled": "detachをキャンセルしました。",
+    // errors
+    "error.directoryExists": "ディレクトリが既に存在します: {path}",
+    "error.accelExists": ".accelディレクトリが既に存在します",
+    "error.accelNotFound": ".accelディレクトリが見つかりません",
+    "error.missingRequiredOptions": "以下の必須オプションが指定されていません: {options}",
+    "error.invalidVersion": "無効なiAPバージョンです: {version}",
+    "error.invalidModule": "無効なモジュールです: {module}",
+    "error.invalidDatabase": "無効なデータベースです: {database}",
+    "error.invalidAgent": "無効なエージェントです: {agent}",
+    // progress
+    "progress.downloading": "資材をダウンロードしています...",
+    "progress.deploying": "資材を配備しています...",
+    "progress.installing": "依存関係をインストールしています...",
+    "progress.gitInit": "Gitリポジトリを初期化しています...",
+    "progress.complete": "プロジェクトの作成が完了しました。",
+};

package/dist/i18n/zh_CN.d.ts

@@ -0,0 +1 @@
+export declare const messages: Record<string, string>;

package/dist/i18n/zh_CN.js

@@ -0,0 +1,47 @@
+export const messages = {
+    // init/attach prompts
+    "prompt.name": "请输入项目名称",
+    "prompt.jugglingProject": "请输入IM-Juggling项目路径（可选）",
+    "prompt.accelplatformVersion": "请选择iAP版本",
+    "prompt.modules": "请选择要使用的模块",
+    "prompt.group": "请输入组名",
+    "prompt.projectVersion": "请输入项目版本",
+    "prompt.description": "请输入项目描述",
+    "prompt.database": "请选择数据库",
+    "prompt.javascript": "是否使用JavaScript？",
+    "prompt.agent": "请选择代理",
+    "prompt.withGit": "是否初始化Git仓库？",
+    // juggling
+    "juggling.detected.version": "从juggling.im检测到版本: {version}",
+    "juggling.detected.modules": "从juggling.im检测到模块: {modules}",
+    "juggling.notFound": "在指定路径未找到juggling.im: {path}",
+    // warnings
+    "warning.versionMismatch": "指定的iAP版本 ({option}) 与juggling.im ({juggling}) 不同。将使用指定值。",
+    "warning.moduleMismatch": "指定的模块与juggling.im不同。将使用指定值。",
+    "warning.gitNotFound": "未找到git命令。跳过Git初始化。",
+    "warning.fileExists": "文件已存在，跳过: {path}",
+    // attach
+    "attach.skipSummary": "{count}个文件已存在，已跳过。",
+    // detach
+    "detach.confirm": "从此项目解除Accel CLI。确定吗？",
+    "detach.deleted": "已删除: {path}",
+    "detach.skipped": "已跳过: {path} (检测到修改)",
+    "detach.complete": "解除完成。{skipped}个文件因用户修改而被跳过。",
+    "detach.completeAll": "解除完成。所有资源已删除。",
+    "detach.cancelled": "解除已取消。",
+    // errors
+    "error.directoryExists": "目录已存在: {path}",
+    "error.accelExists": ".accel目录已存在",
+    "error.accelNotFound": "未找到.accel目录",
+    "error.missingRequiredOptions": "以下必需选项未指定: {options}",
+    "error.invalidVersion": "无效的iAP版本: {version}",
+    "error.invalidModule": "无效的模块: {module}",
+    "error.invalidDatabase": "无效的数据库: {database}",
+    "error.invalidAgent": "无效的代理: {agent}",
+    // progress
+    "progress.downloading": "正在下载资源...",
+    "progress.deploying": "正在部署资源...",
+    "progress.installing": "正在安装依赖...",
+    "progress.gitInit": "正在初始化Git仓库...",
+    "progress.complete": "项目创建完成。",
+};

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+import { defineCommand, runMain } from "citty";
+import { initCommand } from "./commands/init.js";
+import { attachCommand } from "./commands/attach.js";
+import { detachCommand } from "./commands/detach.js";
+const main = defineCommand({
+    meta: {
+        name: "accel",
+        version: "0.1.0",
+        description: "CLI tool for intra-mart Accel Platform development",
+    },
+    subCommands: {
+        init: initCommand,
+        attach: attachCommand,
+        detach: detachCommand,
+    },
+});
+runMain(main);

package/dist/interactive/agent-detect.d.ts

@@ -0,0 +1,8 @@
+type DetectedAgent = {
+    name: string;
+    command: string;
+};
+export declare const detectAgents: () => DetectedAgent[];
+export declare const detectDefaultAgent: () => string;
+export declare const detectDefaultAgents: () => string[];
+export {};

package/dist/interactive/agent-detect.js

@@ -0,0 +1,31 @@
+import { execSync } from "node:child_process";
+const AGENT_COMMANDS = [
+    { name: "claude-code", command: "claude" },
+    { name: "github-copilot", command: "gh" },
+];
+const commandExists = (cmd) => {
+    try {
+        const whichCmd = process.platform === "win32" ? "where" : "which";
+        execSync(`${whichCmd} ${cmd}`, { stdio: "pipe" });
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+export const detectAgents = () => {
+    return AGENT_COMMANDS.filter((a) => commandExists(a.command));
+};
+export const detectDefaultAgent = () => {
+    const detected = detectAgents();
+    if (detected.length === 0)
+        return "github-copilot";
+    return detected[0].name;
+};
+export const detectDefaultAgents = () => {
+    const detected = detectAgents();
+    if (detected.length === 0) {
+        return [...AGENT_COMMANDS.map((a) => a.name)];
+    }
+    return detected.map((a) => a.name);
+};

package/dist/interactive/prompts.d.ts

@@ -0,0 +1,22 @@
+import type { AccelSettings } from "../core/types.js";
+export type PromptOptions = {
+    name?: string;
+    jugglingProject?: string;
+    accelplatformVersion?: string;
+    module?: string[];
+    group?: string;
+    projectVersion?: string;
+    description?: string;
+    database?: string;
+    javascript?: boolean;
+    agent?: string[];
+    locale: string;
+    withGit?: boolean;
+    noInteraction?: boolean;
+    isInit: boolean;
+};
+export type ResolvedOptions = Omit<AccelSettings, "cliVersion" | "createdAt" | "deployedAssets"> & {
+    withGit: boolean;
+};
+export declare const validateNonInteractive: (opts: PromptOptions) => string[];
+export declare const runPrompts: (opts: PromptOptions) => Promise<ResolvedOptions>;

package/dist/interactive/prompts.js

@@ -0,0 +1,226 @@
+import * as p from "@clack/prompts";
+import { SELECTABLE_VERSIONS, } from "../core/version-map.js";
+import { MODULE_OPTIONS, DATABASE_OPTIONS, AGENT_OPTIONS, DEFAULT_SETTINGS, } from "../core/constants.js";
+import { getMessage } from "../i18n/index.js";
+import { detectAgents, detectDefaultAgents } from "./agent-detect.js";
+import { parseJugglingFile } from "../juggling/parser.js";
+import { extractVersionLabel, extractModules, } from "../juggling/extractor.js";
+import { stat } from "node:fs/promises";
+import { join } from "node:path";
+const resolveJuggling = async (jugglingPath, locale) => {
+    const imPath = join(jugglingPath, "juggling.im");
+    try {
+        await stat(imPath);
+    }
+    catch {
+        throw new Error(getMessage("juggling.notFound", locale, { path: imPath }));
+    }
+    const data = await parseJugglingFile(imPath);
+    const version = extractVersionLabel(data);
+    const modules = extractModules(data);
+    return { version, modules };
+};
+export const validateNonInteractive = (opts) => {
+    const missing = [];
+    if (!opts.name)
+        missing.push("--name");
+    if (!opts.jugglingProject) {
+        if (!opts.accelplatformVersion)
+            missing.push("--accelplatform-version");
+        if (!opts.module || opts.module.length === 0)
+            missing.push("--module");
+    }
+    return missing;
+};
+export const runPrompts = async (opts) => {
+    const locale = opts.locale;
+    // Non-interactive mode
+    if (opts.noInteraction) {
+        const missing = validateNonInteractive(opts);
+        if (missing.length > 0) {
+            throw new Error(getMessage("error.missingRequiredOptions", locale, {
+                options: missing.join(", "),
+            }));
+        }
+        let jugglingVersion = null;
+        let jugglingModules = [];
+        if (opts.jugglingProject) {
+            const resolved = await resolveJuggling(opts.jugglingProject, locale);
+            jugglingVersion = resolved.version;
+            jugglingModules = resolved.modules;
+        }
+        return {
+            name: opts.name ?? DEFAULT_SETTINGS.name,
+            group: opts.group ?? DEFAULT_SETTINGS.group,
+            projectVersion: opts.projectVersion ?? DEFAULT_SETTINGS.projectVersion,
+            description: opts.description ?? DEFAULT_SETTINGS.description,
+            accelplatformVersion: opts.accelplatformVersion ??
+                jugglingVersion ??
+                DEFAULT_SETTINGS.accelplatformVersion,
+            modules: opts.module && opts.module.length > 0
+                ? opts.module
+                : jugglingModules.length > 0
+                    ? jugglingModules
+                    : [],
+            database: (opts.database ?? DEFAULT_SETTINGS.database),
+            agents: opts.agent ?? detectDefaultAgents(),
+            javascript: opts.javascript ?? DEFAULT_SETTINGS.javascript,
+            locale,
+            jugglingProject: opts.jugglingProject ?? null,
+            withGit: opts.withGit ?? true,
+        };
+    }
+    // Interactive mode
+    p.intro("Accel CLI");
+    // 1. Project name
+    const name = (await p.text({
+        message: getMessage("prompt.name", locale),
+        defaultValue: opts.name ?? DEFAULT_SETTINGS.name,
+        initialValue: opts.name ?? DEFAULT_SETTINGS.name,
+    }));
+    if (p.isCancel(name))
+        process.exit(0);
+    // 2. Juggling project (optional)
+    const jugglingInput = (await p.text({
+        message: getMessage("prompt.jugglingProject", locale),
+        defaultValue: opts.jugglingProject ?? "",
+        initialValue: opts.jugglingProject ?? "",
+    }));
+    if (p.isCancel(jugglingInput))
+        process.exit(0);
+    let jugglingVersion = null;
+    let jugglingModules = [];
+    const jugglingProject = jugglingInput || null;
+    if (jugglingProject) {
+        try {
+            const resolved = await resolveJuggling(jugglingProject, locale);
+            jugglingVersion = resolved.version;
+            jugglingModules = resolved.modules;
+            p.note(getMessage("juggling.detected.version", locale, {
+                version: jugglingVersion ?? "unknown",
+            }));
+        }
+        catch (err) {
+            p.log.warning(err instanceof Error ? err.message : String(err));
+        }
+    }
+    // 3. iAP version
+    const versionDefault = opts.accelplatformVersion ?? jugglingVersion ?? DEFAULT_SETTINGS.accelplatformVersion;
+    // Warn if option and juggling version differ
+    if (opts.accelplatformVersion && jugglingVersion && opts.accelplatformVersion !== jugglingVersion) {
+        p.log.warning(getMessage("warning.versionMismatch", locale, {
+            option: opts.accelplatformVersion,
+            juggling: jugglingVersion,
+        }));
+    }
+    const accelplatformVersion = (await p.select({
+        message: getMessage("prompt.accelplatformVersion", locale),
+        options: SELECTABLE_VERSIONS.map((v) => ({
+            value: v.label,
+            label: `${v.label} (${v.codename})`,
+        })),
+        initialValue: versionDefault,
+    }));
+    if (p.isCancel(accelplatformVersion))
+        process.exit(0);
+    // 4. Modules
+    const moduleDefault = opts.module && opts.module.length > 0
+        ? opts.module
+        : jugglingModules.length > 0
+            ? jugglingModules
+            : [];
+    if (opts.module && opts.module.length > 0 && jugglingModules.length > 0) {
+        const diff = opts.module.some((m) => !jugglingModules.includes(m)) ||
+            jugglingModules.some((m) => !opts.module.includes(m));
+        if (diff) {
+            p.log.warning(getMessage("warning.moduleMismatch", locale));
+        }
+    }
+    const modules = (await p.multiselect({
+        message: getMessage("prompt.modules", locale),
+        options: MODULE_OPTIONS.map((m) => ({
+            value: m,
+            label: m,
+        })),
+        initialValues: moduleDefault,
+    }));
+    if (p.isCancel(modules))
+        process.exit(0);
+    // 5. Group
+    const group = (await p.text({
+        message: getMessage("prompt.group", locale),
+        defaultValue: opts.group ?? DEFAULT_SETTINGS.group,
+        initialValue: opts.group ?? DEFAULT_SETTINGS.group,
+    }));
+    if (p.isCancel(group))
+        process.exit(0);
+    // 6. Project version
+    const projectVersion = (await p.text({
+        message: getMessage("prompt.projectVersion", locale),
+        defaultValue: opts.projectVersion ?? DEFAULT_SETTINGS.projectVersion,
+        initialValue: opts.projectVersion ?? DEFAULT_SETTINGS.projectVersion,
+    }));
+    if (p.isCancel(projectVersion))
+        process.exit(0);
+    // 7. Description
+    const description = (await p.text({
+        message: getMessage("prompt.description", locale),
+        defaultValue: opts.description ?? DEFAULT_SETTINGS.description,
+        initialValue: opts.description ?? DEFAULT_SETTINGS.description,
+    }));
+    if (p.isCancel(description))
+        process.exit(0);
+    // 8. Database
+    const database = (await p.select({
+        message: getMessage("prompt.database", locale),
+        options: DATABASE_OPTIONS.map((d) => ({ value: d, label: d })),
+        initialValue: opts.database ?? DEFAULT_SETTINGS.database,
+    }));
+    if (p.isCancel(database))
+        process.exit(0);
+    // 9. JavaScript
+    const javascript = (await p.confirm({
+        message: getMessage("prompt.javascript", locale),
+        initialValue: opts.javascript ?? DEFAULT_SETTINGS.javascript,
+    }));
+    if (p.isCancel(javascript))
+        process.exit(0);
+    // 10. Agent (multi-select)
+    const detected = detectAgents();
+    const agentOptions = AGENT_OPTIONS.map((a) => ({ value: a, label: a }));
+    const defaultAgents = opts.agent ??
+        (detected.length > 0
+            ? detected.map((a) => a.name)
+            : [...AGENT_OPTIONS]);
+    const agents = (await p.multiselect({
+        message: getMessage("prompt.agent", locale),
+        options: agentOptions,
+        initialValues: defaultAgents,
+    }));
+    if (p.isCancel(agents))
+        process.exit(0);
+    // 11. Git init (init only)
+    let withGit = opts.withGit ?? true;
+    if (opts.isInit) {
+        withGit = (await p.confirm({
+            message: getMessage("prompt.withGit", locale),
+            initialValue: opts.withGit ?? true,
+        }));
+        if (p.isCancel(withGit))
+            process.exit(0);
+    }
+    return {
+        name,
+        group,
+        projectVersion,
+        description,
+        accelplatformVersion,
+        modules,
+        database,
+        agents,
+        javascript,
+        locale,
+        jugglingProject,
+        withGit,
+    };
+};

package/dist/juggling/extractor.d.ts

@@ -0,0 +1,4 @@
+import type { JugglingData } from "./parser.js";
+export declare const extractVersion: (data: JugglingData) => string;
+export declare const extractVersionLabel: (data: JugglingData) => string;
+export declare const extractModules: (data: JugglingData) => string[];

package/dist/juggling/extractor.js

@@ -0,0 +1,15 @@
+import { xmlIdToModuleName } from "../core/module-map.js";
+import { semverToLabel } from "../core/version-map.js";
+export const extractVersion = (data) => data.baseVersion;
+export const extractVersionLabel = (data) => semverToLabel(data.baseVersion);
+export const extractModules = (data) => {
+    const selectedModules = data.modules.filter((m) => m.selected);
+    const result = [];
+    for (const mod of selectedModules) {
+        const name = xmlIdToModuleName(mod.id);
+        if (name) {
+            result.push(name);
+        }
+    }
+    return [...new Set(result)].sort();
+};

package/dist/juggling/parser.d.ts

@@ -0,0 +1,13 @@
+export type JugglingModule = {
+    id: string;
+    version: string;
+    selected: boolean;
+    name: string;
+    type: "module" | "module-pack";
+};
+export type JugglingData = {
+    modules: JugglingModule[];
+    baseVersion: string;
+};
+export declare const parseJugglingFile: (filePath: string) => Promise<JugglingData>;
+export declare const parseJugglingXml: (xmlContent: string) => JugglingData;

package/dist/juggling/parser.js

@@ -0,0 +1,66 @@
+import { readFile } from "node:fs/promises";
+import { gunzipSync } from "node:zlib";
+import { XMLParser } from "fast-xml-parser";
+const parseXmlModules = (modulesObj) => {
+    const modules = [];
+    const processEntries = (entries, type) => {
+        const arr = Array.isArray(entries) ? entries : entries ? [entries] : [];
+        for (const entry of arr) {
+            if (typeof entry !== "object" || entry === null)
+                continue;
+            const attrs = entry;
+            modules.push({
+                id: String(attrs["@_id"] ?? ""),
+                version: String(attrs["@_version"] ?? ""),
+                selected: attrs["@_selected"] === "true",
+                name: String(attrs["ns2:name"] ?? ""),
+                type,
+            });
+        }
+    };
+    processEntries(modulesObj["ns2:module"], "module");
+    processEntries(modulesObj["ns2:module-pack"], "module-pack");
+    return modules;
+};
+export const parseJugglingFile = async (filePath) => {
+    const compressed = await readFile(filePath);
+    const xmlBuffer = gunzipSync(compressed);
+    const xmlContent = xmlBuffer.toString("utf-8");
+    return parseJugglingXml(xmlContent);
+};
+export const parseJugglingXml = (xmlContent) => {
+    const parser = new XMLParser({
+        ignoreAttributes: false,
+        attributeNamePrefix: "@_",
+        isArray: (_name, jpath) => {
+            if (typeof jpath !== "string")
+                return false;
+            return (jpath.endsWith("ns2:module") ||
+                jpath.endsWith("ns2:module-pack") ||
+                jpath.endsWith("ns2:structure"));
+        },
+    });
+    const parsed = parser.parse(xmlContent);
+    const structures = parsed?.["ns2:juggling"]?.["ns2:structures"]?.["ns2:structure"];
+    if (!Array.isArray(structures) || structures.length === 0) {
+        return { modules: [], baseVersion: "" };
+    }
+    // Search from the end for the first structure with valid="true"
+    let validStructure;
+    for (let i = structures.length - 1; i >= 0; i--) {
+        if (structures[i]["@_valid"] === "true") {
+            validStructure = structures[i];
+            break;
+        }
+    }
+    if (!validStructure) {
+        return { modules: [], baseVersion: "" };
+    }
+    // Extract baseVersion from ns2:base version attribute
+    const base = validStructure["ns2:base"];
+    const baseVersion = String(base?.["@_version"] ?? "");
+    // Extract modules
+    const modulesObj = validStructure["ns2:modules"];
+    const modules = modulesObj ? parseXmlModules(modulesObj) : [];
+    return { modules, baseVersion };
+};

package/dist/markdown/processor.d.ts

@@ -0,0 +1,3 @@
+import type { Replacement, EvalContext } from "../core/types.js";
+import { type PlaceholderMatcher } from "./text-replacement.js";
+export declare const processMarkdown: (content: string, replacements: Replacement[], context: EvalContext, placeholderMatcher?: PlaceholderMatcher) => string;

package/dist/markdown/processor.js

@@ -0,0 +1,16 @@
+import { applyTextReplacements } from "./text-replacement.js";
+import { applySectionReplacements } from "./section-replacement.js";
+export const processMarkdown = (content, replacements, context, placeholderMatcher) => {
+    const textReplacements = replacements.filter((r) => r.type === "text");
+    const sectionReplacements = replacements.filter((r) => r.type === "section");
+    // Apply text replacements first (plain string, before remark touches content)
+    let result = content;
+    if (textReplacements.length > 0) {
+        result = applyTextReplacements(result, textReplacements, context, placeholderMatcher);
+    }
+    // Then apply section replacements (remark AST parse + stringify)
+    if (sectionReplacements.length > 0) {
+        result = applySectionReplacements(result, sectionReplacements, context);
+    }
+    return result;
+};

package/dist/markdown/section-replacement.d.ts

@@ -0,0 +1,2 @@
+import type { SectionReplacement, EvalContext } from "../core/types.js";
+export declare const applySectionReplacements: (content: string, replacements: SectionReplacement[], context: EvalContext) => string;