// SPDX-FileCopyrightText: 2026 Scientific Computing Studio, LLC // SPDX-License-Identifier: Apache-2.0 // pplus-core has no DOM: what a program means is decided without a browser. Its library modules never touch the // document, the window or browser storage, and never import the course's page widgets, which live beside the // engines only so the course and pplus-web can take them from one place (docs/engines.md). import test from 'node:test'; import assert from 'node:assert/strict'; import fs from 'node:fs'; import path from 'node:path'; const ROOT = new URL('..', import.meta.url).pathname; const SRC = path.join(ROOT, 'src'); /** The course's page widgets: they draw into a page, and only pages (the course's, pplus-web's) import them. */ export const WIDGETS = new Set([ 'engines/pseudo/dom.js', 'engines/pseudo/views.js', 'engines/pseudo/views-analysis.js', 'engines/pseudo/lab.js', 'engines/pseudo/editor.js', 'engines/pseudo/exercise.js', 'engines/pseudo/sharpen.js', 'engines/pseudo/plan.js', 'engines/pseudo/planner.js', 'engines/pseudo/highlight.js', 'engines/asm86/views.js', 'engines/asm86/hwviews.js', 'engines/asm86/dom.js', 'engines/asm86/sandbox.js', 'engines/asm86/specs-hw.js', 'engines/shared/dom.js', 'engines/shared/share.js', 'engines/shared/viz.js', ]); function walk(dir, out = []) { for (const e of fs.readdirSync(dir, { withFileTypes: true })) { const p = path.join(dir, e.name); if (e.isDirectory()) walk(p, out); else if (/\.(ts|js)$/.test(e.name)) out.push(path.relative(SRC, p)); } return out; } const asJs = (p) => p.replace(/\.ts$/, '.js'); const files = walk(SRC); const library = files.filter((f) => !WIDGETS.has(asJs(f))); test('every widget named here exists, so the list cannot rot', () => { for (const w of WIDGETS) assert.ok(files.some((f) => asJs(f) === w), `${w} is not in src/`); }); test('no library module touches the document, the window or browser storage', () => { const bad = []; for (const f of library) { const code = fs.readFileSync(path.join(SRC, f), 'utf8').replace(/\/\*[\s\S]*?\*\//g, '').replace(/\/\/.*$/gm, ''); for (const w of ['document.', 'window.', 'localStorage', 'sessionStorage', 'navigator.', 'HTMLElement']) if (code.includes(w)) bad.push(`${f}: ${w}`); } assert.deepEqual(bad, []); }); test('no library module imports a widget, and nothing imports from outside core', () => { const bad = []; for (const f of library) { const code = fs.readFileSync(path.join(SRC, f), 'utf8'); for (const m of code.matchAll(/(?:from|import)\s*\(?\s*['"](\.{1,2}\/[^'"]+)['"]/g)) { const target = path.normalize(path.join(path.dirname(f), m[1])); if (target.startsWith('..')) bad.push(`${f} imports ${m[1]}, outside src/`); else if (WIDGETS.has(asJs(target))) bad.push(`${f} imports the widget ${m[1]}`); } if (/['"]#core\//.test(code)) bad.push(`${f} uses #core/, which is how pplus-web reaches core`); } assert.deepEqual(bad, []); });