clickgo 6.9.0 → 6.10.0

package/test/rtl-archive.mjs

@@ -1,440 +0,0 @@
-// Run after TypeScript/Sass compilation and `node dist/pack.js`: node test/rtl-archive.mjs
-import assert from 'node:assert/strict';
-import { createDecipheriv, createHash } from 'node:crypto';
-import { readFile } from 'node:fs/promises';
-import CleanCSS from 'clean-css';
-import JSZip from 'jszip';
-import ts from 'typescript';
-
-/** --- ClickGo 的固定内置语言顺序 --- */
-const codes = [
-    'sc', 'tc', 'ja', 'ko', 'th', 'vi', 'ar', 'id',
-    'en', 'es', 'de', 'fr', 'pt', 'ru', 'it', 'tr',
-];
-/** --- 包含 localeData 的全部内置控件 --- */
-const localeControls = [
-    'arteditor', 'calendar', 'captcha', 'date', 'datepanel', 'daterange', 'empty', 'jodit', 'label',
-    'levelselect', 'map', 'monaco', 'number', 'page', 'palette', 'property', 'select', 'sidebar-toggle', 'text', 'toolbox', 'tuieditor',
-];
-/** --- 合并到 common.cgc 的多语言控件 --- */
-const commonControls = new Set([
-    'calendar', 'date', 'datepanel', 'daterange', 'empty', 'label', 'levelselect', 'number', 'palette',
-    'select', 'sidebar-toggle', 'text', 'toolbox',
-]);
-/** --- 全部内置主题 --- */
-const themes = ['admin', 'classic', 'cyber', 'dark', 'light', 'modern', 'modern-light', 'software-dark', 'software-light'];
-/** --- CGA 格式常量，与编译器的公开包格式保持一致 --- */
-const cgaHeaderLength = 106;
-const cgaKeyContext = Buffer.from('ClickGo/Application/Package');
-/** --- 已解压的 ZIP 归档缓存 --- */
-const zipCache = new Map();
-
-/**
- * --- 生成归档不存在或过期时的统一错误信息 ---
- * @param archive 归档路径
- * @param detail 失败原因
- * @returns 可操作的错误信息
- */
-function archiveError(archive, detail) {
-    return `${archive} is missing or stale: ${detail}. Build TypeScript and Sass, run node dist/pack.js, then rerun this test.`;
-}
-
-/**
- * --- 读取项目文件 ---
- * @param path 相对项目根目录的路径
- * @returns 文件内容
- */
-async function readProjectFile(path) {
-    return await readFile(new URL(`../${path}`, import.meta.url));
-}
-
-/**
- * --- 读取必要归档，并把不存在转换为清晰诊断 ---
- * @param path 归档路径
- * @returns 归档内容
- */
-async function readArchive(path) {
-    try {
-        return await readProjectFile(path);
-    }
-    catch (error) {
-        if (error?.code === 'ENOENT') {
-            throw new Error(archiveError(path, 'the archive file does not exist'));
-        }
-        throw error;
-    }
-}
-
-/**
- * --- 加载 cgc/cgt ZIP 归档 ---
- * @param path 归档路径
- * @returns JSZip 实例
- */
-async function loadZipArchive(path) {
-    if (zipCache.has(path)) {
-        return zipCache.get(path);
-    }
-    let zip;
-    try {
-        zip = await JSZip.loadAsync(await readArchive(path));
-    }
-    catch (error) {
-        throw new Error(archiveError(path, `the archive cannot be decoded (${error.message})`));
-    }
-    zipCache.set(path, zip);
-    return zip;
-}
-
-/**
- * --- 读取 cgc/cgt 内文件 ---
- * @param archive 归档路径
- * @param entry 包内路径
- * @returns 文件内容
- */
-async function readZipText(archive, entry) {
-    const zip = await loadZipArchive(archive);
-    const file = zip.file(entry);
-    assert.ok(file, archiveError(archive, `required entry ${entry} is absent`));
-    return await file.async('string');
-}
-
-/**
- * --- 恢复 CGA 文件头中打散的密钥种子 ---
- * @param maskedSeed 打散后的种子
- * @param salt 随机盐
- * @param packageId 包 ID
- * @returns 原始密钥种子
- */
-function unmaskCgaSeed(maskedSeed, salt, packageId) {
-    const seed = Buffer.alloc(maskedSeed.length);
-    const shift = packageId[0] % seed.length;
-    for (let i = 0; i < seed.length; ++i) {
-        const sourceIndex = (i + shift) % seed.length;
-        seed[sourceIndex] = maskedSeed[i] ^ salt[i]
-            ^ packageId[i % packageId.length] ^ ((i * 29 + 17) & 0xff);
-    }
-    return seed;
-}
-
-/**
- * --- 解密带认证标签的 CGA AES-GCM 数据块 ---
- * @param data 密文和末尾认证标签
- * @param key 解密密钥
- * @param nonce 随机数
- * @param aad 附加认证数据
- * @returns 明文
- */
-function decryptCga(data, key, nonce, aad) {
-    assert.ok(data.length >= 16, 'encrypted CGA data must include an authentication tag');
-    const decipher = createDecipheriv('aes-256-gcm', key, nonce);
-    decipher.setAAD(aad);
-    decipher.setAuthTag(data.subarray(-16));
-    return Buffer.concat([decipher.update(data.subarray(0, -16)), decipher.final()]);
-}
-
-/**
- * --- 加载 CGA 清单并提供按路径读取能力 ---
- * @param path CGA 归档路径
- * @returns CGA 读取器
- */
-async function loadCgaArchive(path) {
-    const data = await readArchive(path);
-    try {
-        assert.ok(data.length >= cgaHeaderLength, 'file is shorter than the CGA header');
-        assert.equal(data.subarray(0, 5).toString(), '-CGA-', 'CGA magic is invalid');
-        assert.equal(data.readUInt8(5), 1, 'CGA version is unsupported');
-
-        const iconLength = data.readUInt32BE(6);
-        const manifestLength = data.readUInt32BE(10);
-        const packageId = data.subarray(14, 30);
-        const salt = data.subarray(30, 62);
-        const maskedSeed = data.subarray(62, 94);
-        const manifestNonce = data.subarray(94, cgaHeaderLength);
-        const manifestOffset = cgaHeaderLength + iconLength;
-        const blockOffset = manifestOffset + manifestLength;
-        assert.ok(blockOffset <= data.length, 'CGA manifest exceeds the archive size');
-
-        const seed = unmaskCgaSeed(maskedSeed, salt, packageId);
-        const key = createHash('sha256').update(Buffer.concat([
-            seed, salt, packageId, cgaKeyContext,
-        ])).digest();
-        const manifestData = decryptCga(
-            data.subarray(manifestOffset, blockOffset),
-            key,
-            manifestNonce,
-            Buffer.concat([packageId, Buffer.from('manifest')]),
-        );
-        const manifest = JSON.parse(manifestData.toString());
-        const blocks = new Map();
-
-        return {
-            /**
-             * --- 从加密应用包读取单个文件 ---
-             * @param entryPath 包内绝对路径
-             * @returns 解密后的文件内容
-             */
-            async read(entryPath) {
-                const entry = manifest.f?.[entryPath];
-                assert.ok(entry, archiveError(path, `required entry ${entryPath} is absent`));
-                let blockZip = blocks.get(entry.b);
-                if (!blockZip) {
-                    const block = manifest.b?.[entry.b];
-                    assert.ok(block, `manifest block ${entry.b} is absent`);
-                    const start = blockOffset + block.o;
-                    const end = start + block.l;
-                    assert.ok((start >= blockOffset) && (end <= data.length), `manifest block ${entry.b} exceeds the archive size`);
-                    const blockData = decryptCga(
-                        data.subarray(start, end),
-                        key,
-                        Buffer.from(block.n, 'base64'),
-                        Buffer.concat([packageId, Buffer.from(entry.b)]),
-                    );
-                    blockZip = await JSZip.loadAsync(blockData);
-                    blocks.set(entry.b, blockZip);
-                }
-                const file = blockZip.file(entry.e);
-                assert.ok(file, `manifest entry ${entryPath} points to a missing file`);
-                return await file.async('nodebuffer');
-            },
-        };
-    }
-    catch (error) {
-        if (error.message.includes('is missing or stale')) {
-            throw error;
-        }
-        throw new Error(archiveError(path, `the encrypted package cannot be decoded (${error.message})`));
-    }
-}
-
-/**
- * --- 取得 AST 静态属性名 ---
- * @param name 属性名节点
- * @returns 静态名称；动态属性返回空字符串
- */
-function getPropertyName(name) {
-    if (ts.isIdentifier(name) || ts.isStringLiteral(name) || ts.isNumericLiteral(name)) {
-        return name.text;
-    }
-    return '';
-}
-
-/**
- * --- 将只含静态字符串的对象字面量转换为普通对象 ---
- * @param node 对象字面量节点
- * @param label 诊断标签
- * @returns 普通对象
- */
-function readStaticObject(node, label) {
-    const result = {};
-    for (const property of node.properties) {
-        assert.equal(ts.isPropertyAssignment(property), true, `${label} must contain only static properties`);
-        const name = getPropertyName(property.name);
-        assert.notEqual(name, '', `${label} contains a dynamic property name`);
-        assert.equal(Object.hasOwn(result, name), false, `${label} repeats property ${name}`);
-        const value = property.initializer;
-        if (ts.isObjectLiteralExpression(value)) {
-            result[name] = readStaticObject(value, `${label}.${name}`);
-            continue;
-        }
-        const isText = ts.isStringLiteral(value) || ts.isNoSubstitutionTemplateLiteral(value);
-        assert.equal(isText, true, `${label}.${name} must be a static string`);
-        result[name] = value.text;
-    }
-    return result;
-}
-
-/**
- * --- 从控件源码或打包 JS 中读取 localeData ---
- * @param code TypeScript 或 JavaScript 源码
- * @param label 诊断标签
- * @param scriptKind 脚本类型
- * @returns localeData 普通对象
- */
-function readLocaleData(code, label, scriptKind) {
-    const source = ts.createSourceFile(label, code, ts.ScriptTarget.Latest, true, scriptKind);
-    const candidates = [];
-    const visit = (node) => {
-        if (
-            ts.isPropertyDeclaration(node)
-            && (getPropertyName(node.name) === 'localeData')
-            && ts.isObjectLiteralExpression(node.initializer)
-        ) {
-            candidates.push(node.initializer);
-        }
-        ts.forEachChild(node, visit);
-    };
-    visit(source);
-    assert.equal(candidates.length, 1, `${label} must contain exactly one static localeData table`);
-    return readStaticObject(candidates[0], `${label} localeData`);
-}
-
-/**
- * --- 断言归档代码与本地 pack 产物完全一致 ---
- * @param archive cgc 路径
- * @param control 控件名
- * @returns 归档代码
- */
-async function assertControlCodeCurrent(archive, control) {
-    const archived = await readZipText(archive, `${control}/code.js`);
-    let generated;
-    try {
-        generated = (await readProjectFile(`dist/sources/control/${control}/code.pack.js`)).toString();
-    }
-    catch (error) {
-        if (error?.code === 'ENOENT') {
-            throw new Error(archiveError(archive, `generated prerequisite ${control}/code.pack.js is absent`));
-        }
-        throw error;
-    }
-    assert.equal(archived, generated, archiveError(archive, `${control}/code.js differs from code.pack.js`));
-    return archived;
-}
-
-/**
- * --- 断言归档 CSS 与本地编译 CSS 完全一致 ---
- * @param archive cgc/cgt 路径
- * @param entry 归档内 CSS 路径
- * @param sourcePath 本地生成 CSS 路径
- * @returns 归档 CSS
- */
-async function assertCssCurrent(archive, entry, sourcePath) {
-    const archived = await readZipText(archive, entry);
-    const source = (await readProjectFile(sourcePath)).toString();
-    const result = new CleanCSS().minify(source);
-    assert.deepEqual(result.errors, [], `${sourcePath} must be valid CSS`);
-    assert.equal(archived, result.styles, archiveError(archive, `${entry} differs from ${sourcePath}`));
-    return archived;
-}
-
-// --- task.cga 必须包含与源码一致的 16 个语言包 ---
-const taskArchivePath = 'dist/app/task.cga';
-const taskArchive = await loadCgaArchive(taskArchivePath);
-const archivedTaskConfigText = (await taskArchive.read('/config.json')).toString();
-const sourceTaskConfigText = (await readProjectFile('dist/app/task/config.json')).toString();
-const archivedTaskConfig = JSON.parse(archivedTaskConfigText);
-const sourceTaskConfig = JSON.parse(sourceTaskConfigText);
-assert.deepEqual(archivedTaskConfig, sourceTaskConfig, archiveError(taskArchivePath, '/config.json differs from its source'));
-assert.deepEqual(Object.values(archivedTaskConfig.locales), codes, archiveError(taskArchivePath, 'its locale registry is not the agreed 16 locales'));
-
-const archivedTaskApp = (await taskArchive.read('/app.js')).toString();
-const generatedTaskApp = (await readProjectFile('dist/app/task/app.pack.js')).toString();
-assert.equal(archivedTaskApp, generatedTaskApp, archiveError(taskArchivePath, '/app.js differs from app.pack.js'));
-
-let taskLocaleKeys;
-for (const code of codes) {
-    const entry = `/locale/${code}.json`;
-    const archivedText = (await taskArchive.read(entry)).toString();
-    const sourceText = (await readProjectFile(`dist/app/task/locale/${code}.json`)).toString();
-    const archived = JSON.parse(archivedText);
-    const source = JSON.parse(sourceText);
-    assert.deepEqual(archived, source, archiveError(taskArchivePath, `${entry} differs from its source`));
-    taskLocaleKeys ??= Object.keys(archived).sort();
-    assert.deepEqual(Object.keys(archived).sort(), taskLocaleKeys, archiveError(taskArchivePath, `${entry} has incomplete translation keys`));
-    if (code === 'ar') {
-        assert.match(JSON.stringify(archived), /[\u0600-\u06ff]/, archiveError(taskArchivePath, `${entry} has no Arabic text`));
-    }
-}
-
-// --- 所有多语言控件的归档语言表必须与 TypeScript 源码一致 ---
-const archivedControlCode = new Map();
-for (const control of localeControls) {
-    const packageName = commonControls.has(control) ? 'common' : control;
-    const archive = `dist/control/${packageName}.cgc`;
-    const archivedCode = await assertControlCodeCurrent(archive, control);
-    archivedControlCode.set(control, archivedCode);
-    const sourceCode = (await readProjectFile(`dist/sources/control/${control}/code.ts`)).toString();
-    const archivedLocale = readLocaleData(archivedCode, `${archive}:${control}/code.js`, ts.ScriptKind.JS);
-    const sourceLocale = readLocaleData(sourceCode, `dist/sources/control/${control}/code.ts`, ts.ScriptKind.TS);
-    assert.deepEqual(
-        Object.keys(archivedLocale).sort(),
-        [...codes].sort(),
-        archiveError(archive, `${control}/code.js does not contain exactly 16 locales`),
-    );
-    assert.deepEqual(archivedLocale, sourceLocale, archiveError(archive, `${control}/code.js localeData differs from TypeScript source`));
-}
-
-// --- 关键滚动与编辑器方向边界必须进入 cgc ---
-const rtlCodeChecks = [
-    ['dist/control/common.cgc', 'flow', ['getScrollInlineOffset', 'setScrollInlineOffset']],
-    ['dist/control/common.cgc', 'vflow', ['isRtl']],
-    ['dist/control/common.cgc', 'scroll', ['isRtl', 'logicalOffsetPx']],
-    ['dist/control/common.cgc', 'text', ['getScrollInlineOffset', 'setScrollInlineOffset']],
-    ['dist/control/common.cgc', 'select', ['getScrollLeft', 'setScrollLeft']],
-    ['dist/control/common.cgc', 'tab', ['getScrollInlineOffset', 'setScrollInlineOffset']],
-    ['dist/control/common.cgc', 'toolbar', ['getScrollInlineOffset', 'setScrollLeft']],
-    ['dist/control/common.cgc', 'date', ['autoPosition', 'autoScroll']],
-    ['dist/control/common.cgc', 'daterange', ['autoPosition', 'autoScroll']],
-    ['dist/control/common.cgc', 'dock-group', ['isRtl', 'floatMaxWidth']],
-    ['dist/control/common.cgc', 'dock', ['updateColumns', 'getFloatBounds']],
-    ['dist/control/common.cgc', 'dock-column', ['registerGroup', 'expandedPreference']],
-    ['dist/control/common.cgc', 'toolbox', ['getBoundingClientRect', 'toggleColumns']],
-    ['dist/control/common.cgc', 'sidebar-toggle', ['chevronRight', 'tipLabelComp', 'update:expanded']],
-    ['dist/control/table.cgc', 'table', ['localeDirection', 'getScrollLeft', 'setScrollInlineOffset']],
-    ['dist/control/desc.cgc', 'desc', ['getScrollInlineOffset', 'setScrollInlineOffset']],
-    ['dist/control/iconview.cgc', 'iconview', ['isRtl']],
-    ['dist/control/swiper.cgc', 'swiper', ['isRtl', 'directionVersion']],
-    ['dist/control/jodit.cgc', 'jodit', ['_refreshDirection', 'direction', 'rtl']],
-    ['dist/control/tuieditor.cgc', 'tuieditor', ['_refreshDirection', 'ProseMirror', 'rtl']],
-    ['dist/control/monaco.cgc', 'monaco', ['documentElement.dir', 'ltr']],
-];
-for (const [archive, control, tokens] of rtlCodeChecks) {
-    const archivedCode = archivedControlCode.get(control) ?? await assertControlCodeCurrent(archive, control);
-    for (const token of tokens) {
-        assert.ok(archivedCode.includes(token), archiveError(archive, `${control}/code.js lacks RTL marker ${token}`));
-    }
-}
-
-// --- 控件样式必须进入 cgc，并与 Sass 生成 CSS 一致 ---
-const rtlStyleChecks = [
-    ['dist/control/form.cgc', 'form/style.css', 'dist/sources/control/form/style.css', ['isolation:isolate']],
-    ['dist/control/common.cgc', 'bgroup/style.css', 'dist/sources/control/bgroup/style.css', ['display:inline-flex']],
-    ['dist/control/common.cgc', 'button/style.css', 'dist/sources/control/button/style.css', [':dir(rtl)', 'border-inline-end']],
-    ['dist/control/common.cgc', 'list/style.css', 'dist/sources/control/list/style.css', [':dir(rtl)', 'margin-inline-end']],
-    ['dist/control/common.cgc', 'tab/style.css', 'dist/sources/control/tab/style.css', ['border-inline-start-width', 'border-inline-end-width']],
-    ['dist/control/common.cgc', 'timeline/style.css', 'dist/sources/control/timeline/style.css', ['border-inline-start']],
-    ['dist/control/common.cgc', 'dock/style.css', 'dist/sources/control/dock/style.css', ['border-inline-end']],
-    ['dist/control/common.cgc', 'dock-group/style.css', 'dist/sources/control/dock-group/style.css', ['inset-inline-start', 'max-width:calc(100vw - 40px)']],
-    ['dist/control/common.cgc', 'dock-column/style.css', 'dist/sources/control/dock-column/style.css', ['border-inline-start']],
-    ['dist/control/common.cgc', 'toolbox/style.css', 'dist/sources/control/toolbox/style.css', ['border-inline-end']],
-    ['dist/control/common.cgc', 'sidebar-toggle/style.css', 'dist/sources/control/sidebar-toggle/style.css', [':dir(rtl)', 'border-bottom', '--sidebar-toggle-background']],
-    ['dist/control/table.cgc', 'table/style.css', 'dist/sources/control/table/style.css', ['border-inline-end', 'inset-inline-end']],
-    ['dist/control/xterm.cgc', 'xterm/style.css', 'dist/sources/control/xterm/style.css', ['direction:ltr']],
-];
-for (const [archive, entry, sourcePath, tokens] of rtlStyleChecks) {
-    const archivedCss = await assertCssCurrent(archive, entry, sourcePath);
-    for (const token of tokens) {
-        assert.ok(archivedCss.includes(token), archiveError(archive, `${entry} lacks RTL/LTR boundary marker ${token}`));
-    }
-}
-
-// --- 全部主题必须全部包含最新的逻辑方向样式 ---
-for (const theme of themes) {
-    const archive = `dist/theme/${theme}.cgt`;
-    const archivedConfig = JSON.parse(await readZipText(archive, 'config.json'));
-    const sourceConfig = JSON.parse((await readProjectFile(`dist/sources/theme/${theme}/config.json`)).toString());
-    assert.deepEqual(archivedConfig, sourceConfig, archiveError(archive, 'config.json differs from its source'));
-    const archivedCss = await assertCssCurrent(
-        archive,
-        'style.css',
-        `dist/sources/theme/${theme}/style.css`,
-    );
-    assert.match(
-        archivedCss,
-        /(?:border|inset|margin|padding)-inline/,
-        archiveError(archive, 'style.css has no logical inline-direction properties'),
-    );
-    // --- 主题自带图标必须随归档发布，不能只在源码目录中存在。 ---
-    const zip = await loadZipArchive(archive);
-    for (const match of archivedCss.matchAll(/url\(['"]?([^'"\)]+)['"]?\)/g)) {
-        const resource = match[1].replace(/^\.\//, '');
-        if (/^(?:data:|https?:|\/\/|#)/.test(resource)) {
-            continue;
-        }
-        const entry = zip.file(resource);
-        assert.ok(entry, archiveError(archive, `referenced resource ${resource} is absent`));
-        const source = await readProjectFile(`dist/sources/theme/${theme}/${resource}`);
-        assert.deepEqual(await entry.async('nodebuffer'), source, archiveError(archive, `${resource} differs from its source`));
-    }
-}
-
-console.log(`Archive check passed: task.cga has 16 locales, ${localeControls.length} control locale tables are current, and RTL output is present in all ${themes.length} themes.`);

package/test/rtl-direction.mjs

@@ -1,193 +0,0 @@
-// Run: node --experimental-vm-modules test/rtl-direction.mjs
-import assert from 'node:assert/strict';
-import { readFile } from 'node:fs/promises';
-import { SourceTextModule, SyntheticModule } from 'node:vm';
-import { JSDOM } from 'jsdom';
-import ts from 'typescript';
-
-const dom = new JSDOM('<!doctype html><html><head></head><body></body></html>');
-for (const name of ['window', 'document', 'navigator', 'Element', 'SVGElement', 'Node', 'HTMLElement', 'PointerEvent']) {
-    Object.defineProperty(globalThis, name, {
-        'configurable': true,
-        'value': dom.window[name],
-    });
-}
-globalThis.getComputedStyle = dom.window.getComputedStyle.bind(dom.window);
-globalThis.ResizeObserver = class {
-    observe() {}
-    unobserve() {}
-    disconnect() {}
-};
-
-/** --- 当前模拟任务的 locale 状态 --- */
-const tasks = new Map([
-    ['arabic', { 'locale': { 'lang': 'ar' } }],
-    ['english', { 'locale': { 'lang': 'en' } }],
-    ['inherit', { 'locale': { 'lang': '' } }],
-]);
-/** --- 系统 locale，可在测试中模拟运行时切换 --- */
-const config = { 'locale': 'en' };
-
-const toolSource = await readFile(new URL('../dist/lib/tool.ts', import.meta.url), 'utf8');
-const toolModule = new SourceTextModule(ts.transpileModule(toolSource, {
-    'compilerOptions': {
-        'target': ts.ScriptTarget.ES2022,
-        'module': ts.ModuleKind.ESNext,
-    },
-}).outputText);
-await toolModule.link(() => {
-    throw new Error('tool.ts must not import runtime modules');
-});
-await toolModule.evaluate();
-
-const clickgo = new SyntheticModule(['modules'], function() {
-    this.setExport('modules', {
-        'pointer': {
-            'move': () => {},
-        },
-        'vue': {
-            'createApp': () => ({
-                'mount': () => {},
-            }),
-        },
-    });
-});
-const core = new SyntheticModule(['config'], function() {
-    this.setExport('config', config);
-});
-const task = new SyntheticModule(['getOrigin'], function() {
-    this.setExport('getOrigin', (taskId) => tasks.get(taskId) ?? null);
-});
-const tool = new SyntheticModule(['lang', 'logicalOr'], function() {
-    this.setExport('lang', toolModule.namespace.lang);
-    this.setExport('logicalOr', toolModule.namespace.logicalOr);
-});
-const empty = new SyntheticModule([], function() {});
-
-const formSource = await readFile(new URL('../dist/lib/form.ts', import.meta.url), 'utf8');
-const formModule = new SourceTextModule(ts.transpileModule(formSource, {
-    'compilerOptions': {
-        'target': ts.ScriptTarget.ES2022,
-        'module': ts.ModuleKind.ESNext,
-    },
-}).outputText);
-await formModule.link((specifier) => {
-    if (specifier === '../clickgo') {
-        return clickgo;
-    }
-    if (specifier === './core') {
-        return core;
-    }
-    if (specifier === './task') {
-        return task;
-    }
-    if (specifier === './tool') {
-        return tool;
-    }
-    return empty;
-});
-await formModule.evaluate();
-
-const domSource = await readFile(new URL('../dist/lib/dom.ts', import.meta.url), 'utf8');
-const domModule = new SourceTextModule(ts.transpileModule(domSource, {
-    'compilerOptions': {
-        'target': ts.ScriptTarget.ES2022,
-        'module': ts.ModuleKind.ESNext,
-    },
-}).outputText);
-await domModule.link((specifier) => {
-    if (specifier === '../clickgo') {
-        return clickgo;
-    }
-    if (specifier === './form') {
-        return formModule;
-    }
-    if (specifier === './core') {
-        return core;
-    }
-    if (specifier === './task') {
-        return task;
-    }
-    return empty;
-});
-await domModule.evaluate();
-
-const { isRtl } = domModule.namespace;
-const rtlElement = document.createElement('div');
-rtlElement.style.direction = 'rtl';
-document.body.append(rtlElement);
-assert.equal(isRtl(rtlElement), true, 'an RTL element must resolve to RTL');
-assert.equal(isRtl(document.createComment('pending render')), false, 'a Vue placeholder node must safely resolve to LTR');
-assert.equal(isRtl(null), false, 'a missing element must safely resolve to LTR');
-
-const { elements, refreshLocaleDirection } = formModule.namespace;
-elements.init();
-assert.equal(document.querySelector('#cg-wrap'), elements.wrap, 'system root must initialize as #cg-wrap');
-assert.equal(elements.wrap.lang, 'en', 'system root must receive the global language tag');
-assert.equal(elements.wrap.dir, 'ltr', 'system root must receive the global direction');
-
-/**
- * --- 创建同一任务的 Form 与 pop 容器 ---
- * @param taskId ClickGo task id
- * @param formId ClickGo form id
- * @returns 两个语言容器
- */
-function appendTaskWrap(taskId, formId) {
-    const formWrap = document.createElement('div');
-    formWrap.className = 'cg-form-wrap';
-    formWrap.dataset.taskId = taskId;
-    formWrap.dataset.formId = formId;
-    const popWrap = document.createElement('div');
-    popWrap.dataset.taskId = taskId;
-    popWrap.dataset.formId = formId;
-    elements.list.append(formWrap);
-    elements.popList.append(popWrap);
-    return { formWrap, popWrap };
-}
-
-const arabic = appendTaskWrap('arabic', 'form-ar');
-const english = appendTaskWrap('english', 'form-en');
-const inherited = appendTaskWrap('inherit', 'form-inherit');
-refreshLocaleDirection();
-for (const wrap of [arabic.formWrap, arabic.popWrap]) {
-    assert.equal(wrap.lang, 'ar', 'Arabic Form and pop wrappers must receive lang=ar');
-    assert.equal(wrap.dir, 'rtl', 'Arabic Form and pop wrappers must receive RTL');
-}
-for (const wrap of [english.formWrap, english.popWrap, inherited.formWrap, inherited.popWrap]) {
-    assert.equal(wrap.lang, 'en', 'English and inherited Form/pop wrappers must receive lang=en');
-    assert.equal(wrap.dir, 'ltr', 'English and inherited Form/pop wrappers must receive LTR');
-}
-
-// A task-only refresh must update that task's Form and pop wrappers without disturbing a concurrent task.
-tasks.get('arabic').locale.lang = 'en';
-refreshLocaleDirection('arabic');
-for (const wrap of [arabic.formWrap, arabic.popWrap]) {
-    assert.equal(wrap.lang, 'en', 'task locale switch ar -> en must update both wrapper types');
-    assert.equal(wrap.dir, 'ltr', 'task locale switch ar -> en must update both wrapper types');
-}
-assert.equal(english.formWrap.dir, 'ltr', 'task-only refresh must preserve another task direction');
-
-tasks.get('arabic').locale.lang = 'ar';
-refreshLocaleDirection('arabic');
-assert.equal(arabic.formWrap.dir, 'rtl', 'task locale switch en -> ar must restore RTL');
-assert.equal(arabic.popWrap.dir, 'rtl', 'task locale switch en -> ar must restore pop RTL');
-
-// Global direction refresh changes the system root and inherited tasks, while explicit task locales remain isolated.
-config.locale = 'ar';
-refreshLocaleDirection();
-assert.equal(elements.wrap.lang, 'ar', 'global locale switch must update #cg-wrap language');
-assert.equal(elements.wrap.dir, 'rtl', 'global locale switch must update #cg-wrap direction');
-assert.equal(inherited.formWrap.dir, 'rtl', 'task without an override must inherit global RTL');
-assert.equal(inherited.popWrap.dir, 'rtl', 'inherited pop wrapper must inherit global RTL');
-assert.equal(english.formWrap.dir, 'ltr', 'explicit English task must coexist with global Arabic RTL');
-assert.equal(arabic.formWrap.dir, 'rtl', 'explicit Arabic task must coexist with global Arabic RTL');
-
-config.locale = 'en';
-refreshLocaleDirection();
-assert.equal(elements.wrap.dir, 'ltr', 'global locale switch ar -> en must restore root LTR');
-assert.equal(inherited.formWrap.dir, 'ltr', 'global locale switch ar -> en must restore inherited Form LTR');
-assert.equal(inherited.popWrap.dir, 'ltr', 'global locale switch ar -> en must restore inherited pop LTR');
-assert.equal(arabic.formWrap.dir, 'rtl', 'explicit Arabic task must remain RTL after global refresh');
-
-dom.window.close();
-console.log('RTL root, Form/pop isolation, task switching and global refresh checks passed from TypeScript source.');