@d-zero/a11y-check-core 0.3.0 → 0.5.0

package/dist/import-scenarios.d.ts

@@ -0,0 +1,6 @@
+import type { Scenario } from './types.js';
+/**
+ *
+ * @param scenarios
+ */
+export declare function importScenarios(scenarios: readonly Scenario[]): Promise<Scenario[]>;

package/dist/import-scenarios.js

@@ -0,0 +1,12 @@
+/**
+ *
+ * @param scenarios
+ */
+export async function importScenarios(scenarios) {
+    return await Promise.all(scenarios.map(async (scenario) => {
+        const mod = await import(scenario.modulePath);
+        const creator = mod.default;
+        const optionsValue = JSON.parse(scenario.moduleParams);
+        return creator(optionsValue);
+    }));
+}

package/dist/index.d.ts

@@ -2,5 +2,6 @@ export { colorContrastCheck, ColorContrastError } from './color-contrast.js';
 export { colorFnToHex } from './color.js';
 export { createScenario } from './create-scenario.js';
 export { scNumberComparator } from './sc-number-comparator.js';
-export { scenarioRunner } from './scenario-runner.js';
+export { scenarioRunner } from './scenario-main-process.js';
+export { importScenarios } from './import-scenarios.js';
 export * from './types.js';

package/dist/index.js

@@ -2,5 +2,6 @@ export { colorContrastCheck, ColorContrastError } from './color-contrast.js';
 export { colorFnToHex } from './color.js';
 export { createScenario } from './create-scenario.js';
 export { scNumberComparator } from './sc-number-comparator.js';
-export { scenarioRunner } from './scenario-runner.js';
+export { scenarioRunner } from './scenario-main-process.js';
+export { importScenarios } from './import-scenarios.js';
 export * from './types.js';

package/dist/scenario-child-process.d.ts

@@ -0,0 +1,5 @@
+import type { Scenario } from './types.js';
+export type ChildProcessParams = {
+    readonly scenarios: readonly Scenario[];
+    readonly cacheDir: string;
+};

package/dist/scenario-child-process.js

@@ -0,0 +1,64 @@
+import { createChildProcess } from '@d-zero/puppeteer-dealer';
+import { beforePageScan, defaultSizes, pageScanListener, } from '@d-zero/puppeteer-page-scan';
+import { Cache } from '@d-zero/shared/cache';
+import c from 'ansi-colors';
+import { importScenarios } from '@d-zero/a11y-check-core';
+createChildProcess(async (param) => {
+    const { cacheDir } = param;
+    const cache = new Cache('a11y-check/run-puppeteer', cacheDir);
+    const sizes = {
+        desktop: defaultSizes.desktop,
+        mobile: defaultSizes.mobile,
+    };
+    const scenarios = await importScenarios(param.scenarios);
+    return {
+        // async beforeOpenPage(_, url, logger) {
+        // 	if (options?.cache === false) {
+        // 		logger('Clearing cache');
+        // 		await cache.clear();
+        // 	}
+        // 	logger('Restoring cache');
+        // 	const cached = await cache.load(url, (key, value) => {
+        // 		if (key === 'timestamp') {
+        // 			return new Date(Date.parse(value));
+        // 		}
+        // 		return value;
+        // 	});
+        // 	if (cached) {
+        // 		logger('Hit cache, skipping page scan');
+        // 		await delay(600);
+        // 		needAnalysis.push(...cached.needAnalysis);
+        // 		passed.push(...cached.passed);
+        // 		violations.push(...cached.violations);
+        // 		return false;
+        // 	}
+        // 	return true;
+        // },
+        async eachPage({ page, url }, logger) {
+            const urlNeedAnalysis = [];
+            const urlPassed = [];
+            const urlViolations = [];
+            for (const [name, size] of Object.entries(sizes)) {
+                const sizeLabel = c.bgMagenta(` ${name} `);
+                for (const scenario of scenarios) {
+                    await beforePageScan(page, url, {
+                        name,
+                        ...size,
+                        listener: pageScanListener(logger),
+                    });
+                    const scenarioResult = await scenario.exec(page, name, (log) => logger(`${sizeLabel} ${log}`));
+                    urlNeedAnalysis.push(...(scenarioResult.needAnalysis ?? []));
+                    urlPassed.push(...(scenarioResult.passed ?? []));
+                    urlViolations.push(...(scenarioResult.violations ?? []));
+                }
+            }
+            const urlResults = {
+                needAnalysis: urlNeedAnalysis,
+                passed: urlPassed,
+                violations: urlViolations,
+            };
+            await cache.store(url, urlResults);
+            return urlResults;
+        },
+    };
+});

package/dist/{scenario-runner.d.ts → scenario-main-process.d.ts}

@@ -1,4 +1,5 @@
 import type { CoreOptions, Result, Scenario, ScenarioRunnerOptions } from './types.js';
+import type { DealOptions } from '@d-zero/dealer';
 /**
  *
  * @param urlList
@@ -8,4 +9,4 @@ import type { CoreOptions, Result, Scenario, ScenarioRunnerOptions } from './typ
 export declare function scenarioRunner<O>(urlList: readonly (string | {
     id: string | null;
     url: string;
-})[], scenarios: readonly Scenario[], options?: O & CoreOptions & ScenarioRunnerOptions): Promise<Result>;
+})[], scenarios: readonly Scenario[], options?: O & CoreOptions & ScenarioRunnerOptions & DealOptions): Promise<Result>;

package/dist/scenario-main-process.js

@@ -0,0 +1,51 @@
+import path from 'node:path';
+import { createProcess, deal } from '@d-zero/puppeteer-dealer';
+import c from 'ansi-colors';
+import { cleanResults } from './clean-results.js';
+import { importScenarios } from '@d-zero/a11y-check-core';
+/**
+ *
+ * @param urlList
+ * @param scenarios
+ * @param options
+ */
+export async function scenarioRunner(urlList, scenarios, options) {
+    const needAnalysis = [];
+    const passed = [];
+    const violations = [];
+    await deal(urlList.map((url) => {
+        if (typeof url === 'string') {
+            return { id: null, url };
+        }
+        return url;
+    }), (_, done, total) => {
+        return `${c.bold.magenta('🧿 A11y checking%dots%')} ${done}/${total}`;
+    }, () => {
+        return createProcess(path.resolve(import.meta.dirname, 'scenario-child-process.js'), {
+            scenarios,
+            cacheDir: options?.cacheDir ?? '.a11y-check-core',
+        }, options);
+    }, {
+        ...options,
+        each(result) {
+            needAnalysis.push(...result.needAnalysis);
+            passed.push(...result.passed);
+            violations.push(...result.violations);
+        },
+    });
+    const cleanedViolations = cleanResults(violations);
+    process.stdout.write(`📊 Found ${cleanedViolations.length} violations\n`);
+    const scenarioModules = await importScenarios(scenarios);
+    for (const scenario of scenarioModules) {
+        const targets = needAnalysis.filter((result) => result.scenarioId === scenario.id);
+        if (targets.length === 0) {
+            continue;
+        }
+        await scenario.analyze?.(targets, (log) => process.stdout.write(`${log}\n`));
+    }
+    return {
+        needAnalysis: needAnalysis,
+        passed: passed,
+        violations: cleanedViolations,
+    };
+}

package/dist/types.d.ts

@@ -1,6 +1,6 @@
 import type { DealOptions } from '@d-zero/dealer';
-import type { Page } from '@d-zero/puppeteer-page';
 import type { PageHook } from '@d-zero/puppeteer-page-scan';
+import type { Page } from 'puppeteer';
 export type CoreOptions = {
     readonly screenshot?: boolean;
     readonly cache?: boolean;
@@ -12,9 +12,11 @@ export type ScenarioRunnerOptions = DealOptions & {
 };
 export type ScenarioCreator<O> = (options?: O) => Scenario;
 export type Scenario = {
-    id: string;
-    exec: ScenarioExecutor;
-    analyze?: ScenarioAnalyzer;
+    readonly modulePath: string;
+    readonly moduleParams: string;
+    readonly id: string;
+    readonly exec: ScenarioExecutor;
+    readonly analyze?: ScenarioAnalyzer;
 };
 export type ScenarioExecutor = (page: Page, sizeName: string, log: (log: string) => void) => Promise<Partial<Result>>;
 export type ScenarioAnalyzer = (results: NeedAnalysis[], log: (log: string) => void) => Promise<void | Partial<Result>> | void | Partial<Result>;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@d-zero/a11y-check-core",
-	"version": "0.3.0",
+	"version": "0.5.0",
 	"description": "Accessibility Checker (Core Module)",
 	"author": "D-ZERO",
 	"license": "MIT",
@@ -24,15 +24,15 @@
 		"clean": "tsc --build --clean"
 	},
 	"dependencies": {
-		"@d-zero/puppeteer-dealer": "0.3.0",
-		"@d-zero/shared": "0.7.0",
+		"@d-zero/puppeteer-dealer": "0.5.0",
+		"@d-zero/shared": "0.9.0",
 		"ansi-colors": "4.1.3",
-		"color-contrast-checker": "2.1.0"
+		"color-contrast-checker": "2.1.0",
+		"puppeteer": "24.10.1"
 	},
 	"devDependencies": {
-		"@d-zero/dealer": "1.3.0",
-		"@d-zero/puppeteer-page": "0.3.0",
-		"@d-zero/puppeteer-page-scan": "3.0.0"
+		"@d-zero/dealer": "1.3.1",
+		"@d-zero/puppeteer-page-scan": "4.0.1"
 	},
-	"gitHead": "e4fd17857e31022d121527b00fd7f009dbdb2142"
+	"gitHead": "04c6969564182c36ee38ef41e78130936dfa4863"
 }

package/dist/scenario-runner.js

@@ -1,97 +0,0 @@
-import { deal } from '@d-zero/puppeteer-dealer';
-import { beforePageScan, defaultSizes, pageScanListener, } from '@d-zero/puppeteer-page-scan';
-import { Cache } from '@d-zero/shared/cache';
-import { delay } from '@d-zero/shared/delay';
-import c from 'ansi-colors';
-import { cleanResults } from './clean-results.js';
-/**
- *
- * @param urlList
- * @param scenarios
- * @param options
- */
-export async function scenarioRunner(urlList, scenarios, options) {
-    const cache = new Cache('a11y-check/run-puppeteer', options?.cacheDir);
-    const hooks = options?.hooks;
-    const sizes = {
-        desktop: defaultSizes.desktop,
-        mobile: defaultSizes.mobile,
-    };
-    const needAnalysis = [];
-    const passed = [];
-    const violations = [];
-    await deal(urlList.map((url) => {
-        if (typeof url === 'string') {
-            return { id: null, url };
-        }
-        return url;
-    }), (_, done, total) => {
-        return `${c.bold.magenta('🧿 A11y checking%dots%')} ${done}/${total}`;
-    }, {
-        async beforeOpenPage(_, url, logger) {
-            if (options?.cache === false) {
-                logger('Clearing cache');
-                await cache.clear();
-            }
-            logger('Restoring cache');
-            const cached = await cache.load(url, (key, value) => {
-                if (key === 'timestamp') {
-                    return new Date(Date.parse(value));
-                }
-                return value;
-            });
-            if (cached) {
-                logger('Hit cache, skipping page scan');
-                await delay(600);
-                needAnalysis.push(...cached.needAnalysis);
-                passed.push(...cached.passed);
-                violations.push(...cached.violations);
-                return false;
-            }
-            return true;
-        },
-        async deal(page, _, url, logger) {
-            const urlNeedAnalysis = [];
-            const urlPassed = [];
-            const urlViolations = [];
-            for (const [name, size] of Object.entries(sizes)) {
-                const sizeLabel = c.bgMagenta(` ${name} `);
-                for (const scenario of scenarios) {
-                    await beforePageScan(page, url, {
-                        name,
-                        ...size,
-                        hooks,
-                        listener: pageScanListener(logger),
-                    });
-                    const scenarioResult = await scenario.exec(page, name, (log) => logger(`${sizeLabel} ${log}`));
-                    urlNeedAnalysis.push(...(scenarioResult.needAnalysis ?? []));
-                    urlPassed.push(...(scenarioResult.passed ?? []));
-                    urlViolations.push(...(scenarioResult.violations ?? []));
-                }
-            }
-            const urlResults = {
-                needAnalysis: urlNeedAnalysis,
-                passed: urlPassed,
-                violations: urlViolations,
-            };
-            await cache.store(url, urlResults);
-            needAnalysis.push(...urlNeedAnalysis);
-            passed.push(...urlPassed);
-            violations.push(...urlViolations);
-        },
-    }, options);
-    const cleanedViolations = cleanResults(violations);
-    process.stdout.write(`📊 Found ${cleanedViolations.length} violations\n`);
-    for (const scenario of scenarios) {
-        const targets = needAnalysis.filter((result) => result.scenarioId === scenario.id);
-        if (targets.length === 0) {
-            continue;
-        }
-        await scenario.analyze?.(targets, (log) => process.stdout.write(`${log}\n`));
-    }
-    return {
-        needAnalysis: needAnalysis,
-        passed: passed,
-        violations: cleanedViolations,
-    };
-}