anentrypoint-design 0.0.348 → 0.0.349

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "anentrypoint-design",
-  "version": "0.0.348",
+  "version": "0.0.349",
   "description": "247420 design system SDK — webjsx + modified ripple-ui, single-file ESM bundle for reproducible use of the AnEntrypoint design.",
   "type": "module",
   "main": "./dist/247420.js",
@@ -11,41 +11,9 @@
       "default": "./dist/247420.js"
     },
     "./css": "./dist/247420.css",
-    "./kits/spoint": {
-      "import": "./src/kits/spoint/index.js",
-      "default": "./src/kits/spoint/index.js"
-    },
-    "./kits/spoint/*": "./src/kits/spoint/*",
-    "./kits/slides": {
-      "import": "./src/kits/slides/index.js",
-      "default": "./src/kits/slides/index.js"
-    },
-    "./kits/slides/deck-stage.js": "./src/kits/slides/deck-stage.js",
-    "./kits/os": {
-      "import": "./src/kits/os/index.js",
-      "default": "./src/kits/os/index.js"
-    },
-    "./kits/os/theme.css": "./src/kits/os/theme.css",
-    "./kits/os/wm.css": "./src/kits/os/wm.css",
-    "./kits/os/wm.js": "./src/kits/os/wm.js",
-    "./kits/os/launcher.js": "./src/kits/os/launcher.js",
-    "./kits/os/launcher.css": "./src/kits/os/launcher.css",
-    "./kits/os/validate.css": "./src/kits/os/validate.css",
-    "./kits/os/icons.js": "./src/kits/os/icons.js",
-    "./kits/os/shell.js": "./src/kits/os/shell.js",
-    "./kits/os/freddie-dashboard.js": "./src/kits/os/freddie-dashboard.js",
-    "./kits/os/freddie-dashboard.css": "./src/kits/os/freddie-dashboard.css",
-    "./kits/os/files-app.js": "./src/kits/os/files-app.js",
-    "./kits/os/monitor-app.js": "./src/kits/os/monitor-app.js",
-    "./kits/os/about-app.js": "./src/kits/os/about-app.js",
-    "./kits/os/terminal-app.js": "./src/kits/os/terminal-app.js",
-    "./kits/os/browser-app.js": "./src/kits/os/browser-app.js",
-    "./kits/os/validator-app.js": "./src/kits/os/validator-app.js",
-    "./kits/os/app-panes.css": "./src/kits/os/app-panes.css",
     "./colors_and_type.css": "./colors_and_type.css",
     "./app-shell.css": "./app-shell.css",
     "./community.css": "./community.css",
-    "./system.css": "./system.css",
     "./page-html": {
       "import": "./src/page-html.js",
       "default": "./src/page-html.js"
@@ -61,13 +29,45 @@
       "import": "./src/lint.js",
       "default": "./src/lint.js"
     },
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./kits/os": {
+      "import": "./src/kits/os/index.js",
+      "default": "./src/kits/os/index.js"
+    },
+    "./kits/os/about-app.js": "./src/kits/os/about-app.js",
+    "./kits/os/app-panes.css": "./src/kits/os/app-panes.css",
+    "./kits/os/browser-app.js": "./src/kits/os/browser-app.js",
+    "./kits/os/files-app.js": "./src/kits/os/files-app.js",
+    "./kits/os/freddie-dashboard.css": "./src/kits/os/freddie-dashboard.css",
+    "./kits/os/freddie-dashboard.js": "./src/kits/os/freddie-dashboard.js",
+    "./kits/os/icons.js": "./src/kits/os/icons.js",
+    "./kits/os/launcher.css": "./src/kits/os/launcher.css",
+    "./kits/os/launcher.js": "./src/kits/os/launcher.js",
+    "./kits/os/monitor-app.js": "./src/kits/os/monitor-app.js",
+    "./kits/os/shell.js": "./src/kits/os/shell.js",
+    "./kits/os/terminal-app.js": "./src/kits/os/terminal-app.js",
+    "./kits/os/theme.css": "./src/kits/os/theme.css",
+    "./kits/os/validate.css": "./src/kits/os/validate.css",
+    "./kits/os/wm.css": "./src/kits/os/wm.css",
+    "./kits/os/wm.js": "./src/kits/os/wm.js",
+    "./kits/slides": {
+      "import": "./src/kits/slides/index.js",
+      "default": "./src/kits/slides/index.js"
+    },
+    "./kits/slides/deck-stage.js": "./src/kits/slides/deck-stage.js",
+    "./kits/spoint": {
+      "import": "./src/kits/spoint/index.js",
+      "default": "./src/kits/spoint/index.js"
+    },
+    "./kits/spoint/*": "./src/kits/spoint/*"
   },
   "files": [
     "dist",
     "src",
     "scripts/lint-glyphs.mjs",
     "scripts/lint-null-children.mjs",
+    "scripts/lint-shared.mjs",
+    "scripts/lint-css.mjs",
     "vendor/webjsx",
     "colors_and_type.css",
     "app-shell.css",
@@ -77,13 +77,16 @@
   ],
   "scripts": {
     "lint": "node scripts/lint.mjs",
+    "lint:css": "node scripts/lint-css.mjs",
     "lint:tokens": "node scripts/lint-tokens.mjs",
     "build": "node scripts/build.mjs",
     "lint:null-children": "node scripts/lint-null-children.mjs",
     "lint:classes": "node scripts/lint-classes.mjs",
     "lint:ui-kits": "node scripts/generate-ui-kit-scaffolds.mjs --check",
     "tokens": "node scripts/generate-tokens-json.mjs",
+    "tokens:css": "node scripts/generate-tokens-css.mjs",
     "tokens:doc": "node scripts/generate-tokens-json.mjs && node scripts/generate-theme-tokens-doc.mjs",
+    "sitemap": "node scripts/generate-sitemap.mjs",
     "docs:components": "node scripts/generate-component-docs.mjs",
     "lint:component-docs": "node scripts/generate-component-docs.mjs --check",
     "generate:ui-kits": "node scripts/generate-ui-kit-scaffolds.mjs",

package/scripts/lint-css.mjs

@@ -0,0 +1,73 @@
+#!/usr/bin/env node
+// CSS lint orchestrator: imports every rule module's exported check function
+// and runs them all in one pass, aggregating pass/fail into one consistent
+// report. Each lint-*.mjs (lint-tokens, lint-glyphs, lint-inline-styles,
+// lint-null-children, lint-classes, lint-duplicate-selectors,
+// lint-swallow-comments) keeps its own rule-checking LOGIC as a plain
+// exported function — this file owns only the shared "run every rule, print
+// one report" driver, and (via lint-shared.mjs) the shared directory-walk
+// helper the file-scanning rules use. scripts/lint.mjs is now a thin wrapper
+// around runLintCss() below.
+//
+// Run: `node scripts/lint-css.mjs` (also wired as `npm run lint`, via lint.mjs).
+import { lintTokensOrThrow, lintRadiusOrThrow, lintSpacingOrThrow } from './lint-tokens.mjs';
+import { lintGlyphsOrThrow } from './lint-glyphs.mjs';
+import { lintNullChildrenOrThrow } from './lint-null-children.mjs';
+import { lintClassesOrThrow } from './lint-classes.mjs';
+import { lintInlineStylesOrThrow } from './lint-inline-styles.mjs';
+import { lintDuplicateSelectorsOrThrow } from './lint-duplicate-selectors.mjs';
+import { lintSwallowCommentsOrThrow } from './lint-swallow-comments.mjs';
+
+// Each entry: a human label for the report, and the check function to run.
+// lintSpacingOrThrow is report-only (never throws — see lint-tokens.mjs), so
+// it is run but never counted as a failure; its own console.warn/log already
+// carries the detail. Every other check throws on violation.
+const CHECKS = [
+    ['tokens', lintTokensOrThrow],
+    ['radius', lintRadiusOrThrow],
+    ['glyphs', lintGlyphsOrThrow],
+    ['null-children', lintNullChildrenOrThrow],
+    ['classes', lintClassesOrThrow],
+    ['inline-styles', lintInlineStylesOrThrow],
+    ['duplicate-selectors', lintDuplicateSelectorsOrThrow],
+    ['swallow-comments', lintSwallowCommentsOrThrow],
+];
+
+// Runs every rule module's check, prints one aggregated report, and returns
+// { results, failed, passed } so a caller (lint.mjs, or a future test
+// runner) can inspect the outcome instead of relying on process.exitCode.
+export function runLintCss() {
+    const results = [];
+    for (const [name, fn] of CHECKS) {
+        try {
+            fn();
+            results.push({ name, ok: true });
+        } catch (e) {
+            console.error(e.message);
+            results.push({ name, ok: false, error: e.message });
+        }
+    }
+
+    // Spacing is report-only (logs its own [lint-spacing] REPORT/OK line
+    // above, via console.warn/console.log inside lintSpacingOrThrow) — never
+    // throws, so it is not part of the pass/fail tally, matching build.mjs's
+    // existing non-fatal treatment of it.
+    lintSpacingOrThrow();
+
+    const failed = results.filter((r) => !r.ok);
+    const passed = results.filter((r) => r.ok);
+
+    console.log('');
+    console.log('[lint] summary: ' + passed.length + '/' + results.length + ' checks passed'
+        + (failed.length ? ' — FAILED: ' + failed.map((r) => r.name).join(', ') : ''));
+
+    if (failed.length) {
+        process.exitCode = 1;
+    }
+    return { results, failed, passed };
+}
+
+// CLI entry: `node scripts/lint-css.mjs`.
+if (process.argv[1]?.endsWith('lint-css.mjs')) {
+    runLintCss();
+}

package/scripts/lint-glyphs.mjs

@@ -10,6 +10,7 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { walkManyDirs } from './lint-shared.mjs';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const root = path.resolve(__dirname, '..');
@@ -53,23 +54,10 @@ function isAllowed(rel, line) {
     return list.some((s) => line.includes(s));
 }
 
-function walk(dir, acc) {
-    let entries;
-    try { entries = fs.readdirSync(dir, { withFileTypes: true }); }
-    catch { return acc; }
-    for (const e of entries) {
-        const full = path.join(dir, e.name);
-        if (e.isDirectory()) walk(full, acc);
-        else if (SCAN_EXT.has(path.extname(e.name))) acc.push(full);
-    }
-    return acc;
-}
-
 // Returns the array of violation strings (empty == clean). Pure; no exit/log.
 export function findGlyphViolations() {
     const violations = [];
-    const files = [];
-    for (const d of SCAN_DIRS) walk(path.join(root, d), files);
+    const files = walkManyDirs(SCAN_DIRS.map((d) => path.join(root, d)), SCAN_EXT);
     for (const f of SCAN_ROOT_FILES) { const p = path.join(root, f); if (fs.existsSync(p)) files.push(p); }
     for (const file of files) {
         const rel = path.relative(root, file).split(path.sep).join('/');

package/scripts/lint-null-children.mjs

@@ -18,25 +18,17 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { walkFiles } from './lint-shared.mjs';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const root = path.resolve(__dirname, '..');
 const SCAN_DIRS = ['src'];
 const SCAN_EXT = new Set(['.js', '.mjs']);
+const SKIP_DIRS = new Set(['node_modules', 'vendor']);
 
 // Per-file allowlist of line numbers or substrings audited as safe.
 const ALLOW = {};
 
-function* walk(dir) {
-  for (const e of fs.readdirSync(dir, { withFileTypes: true })) {
-    const p = path.join(dir, e.name);
-    if (e.isDirectory()) {
-      if (e.name === 'node_modules' || e.name === 'vendor') continue;
-      yield* walk(p);
-    } else if (SCAN_EXT.has(path.extname(e.name))) yield p;
-  }
-}
-
 // Blanks out `//` line-comment content (replacing with spaces, keeping
 // newlines and length so reported line numbers stay accurate) before the
 // bracket-matching pass below. Without this, an apostrophe inside ANY
@@ -108,7 +100,7 @@ export function lintNullChildrenOrThrow() {
   for (const dir of SCAN_DIRS) {
     const abs = path.join(root, dir);
     if (!fs.existsSync(abs)) continue;
-    for (const file of walk(abs)) {
+    for (const file of walkFiles(abs, SCAN_EXT, { skipDirs: SKIP_DIRS })) {
       const rel = path.relative(root, file);
       const src = fs.readFileSync(file, 'utf8');
       const allow = ALLOW[rel] || [];

package/scripts/lint-shared.mjs

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+// Shared file-walking helper for the lint-*.mjs rule modules. Three of the
+// six rules (lint-glyphs, lint-inline-styles, lint-null-children) recursively
+// scan a directory tree for files with a given extension set; this was
+// duplicated near-verbatim in each. Extracted here so the rule modules keep
+// only their actual check LOGIC (the part that varies) and share the
+// directory-walk mechanics (the part that doesn't).
+//
+// The three original walkers differed only in which directories they skip
+// (glyphs/inline-styles skip nothing extra; null-children skips
+// node_modules/vendor) — both are supported via the optional `skipDirs` set.
+import fs from 'node:fs';
+import path from 'node:path';
+
+// Recursively collects absolute file paths under `dir` whose extension is in
+// `extSet`, skipping any directory whose basename is in `skipDirs`.
+// Non-existent `dir` is silently treated as empty (matches every original
+// walker's try/catch-and-return-acc behavior).
+export function walkFiles(dir, extSet, { skipDirs } = {}) {
+    const acc = [];
+    walkInto(dir, extSet, skipDirs, acc);
+    return acc;
+}
+
+function walkInto(dir, extSet, skipDirs, acc) {
+    let entries;
+    try { entries = fs.readdirSync(dir, { withFileTypes: true }); }
+    catch { return; }
+    for (const e of entries) {
+        const full = path.join(dir, e.name);
+        if (e.isDirectory()) {
+            if (skipDirs && skipDirs.has(e.name)) continue;
+            walkInto(full, extSet, skipDirs, acc);
+        } else if (extSet.has(path.extname(e.name))) {
+            acc.push(full);
+        }
+    }
+}
+
+// Collects files across several root-relative dirs in one call (the common
+// SCAN_DIRS.map(walk) pattern each rule module repeated).
+export function walkManyDirs(baseDirs, extSet, opts) {
+    const acc = [];
+    for (const dir of baseDirs) acc.push(...walkFiles(dir, extSet, opts));
+    return acc;
+}

package/src/kits/os/app-panes.css

@@ -117,72 +117,6 @@
 .browser-app-loading .browser-app-bar { box-shadow: inset 0 -2px 0 var(--os-accent); }
 .browser-app[data-error] .browser-app-status { color: var(--os-danger, #c0392b); }
 
-/* --- validator-app --- */
-.validator-app {
-    display: flex;
-    flex-direction: column;
-    height: 100%;
-    background: var(--os-bg-1);
-    color: var(--os-fg);
-    font-family: var(--os-font);
-}
-.validator-app-head {
-    display: flex;
-    align-items: center;
-    gap: var(--space-2);
-    padding: var(--space-1) var(--space-2);
-    background: var(--os-bg-2);
-    flex: 0 0 auto;
-}
-.validator-app-banner {
-    flex: 0 0 auto;
-    padding: 2px var(--space-2);
-    border-radius: 999px;
-    font: 11px var(--os-mono);
-    text-transform: lowercase;
-    background: var(--os-bg-3);
-    color: var(--os-fg-2);
-}
-.validator-app-banner[data-state="pending"] { background: var(--os-amber); color: var(--os-bg-0); }
-.validator-app-banner[data-state="pass"] { background: var(--os-accent); color: var(--os-bg-0); }
-.validator-app-banner[data-state="fail"] { background: var(--os-red); color: var(--os-bg-0); }
-.validator-app-counts {
-    flex: 0 0 auto;
-    font: 11px var(--os-mono);
-    color: var(--os-fg-2);
-}
-.validator-app-rerun {
-    margin-left: auto;
-    flex: 0 0 auto;
-    height: var(--space-4);
-    padding: 0 var(--space-2);
-    background: var(--os-bg-3);
-    color: var(--os-fg);
-    border: none;
-    border-radius: var(--os-radius-sm);
-    font: 11px var(--os-mono);
-    text-transform: lowercase;
-    cursor: pointer;
-    outline: none;
-}
-.validator-app-rerun:hover { background: var(--os-accent-soft); }
-.validator-app-slot {
-    flex: 1 1 auto;
-    min-width: 0;
-    min-height: 0;
-    overflow: hidden;
-    display: flex;
-    position: relative;
-    background: var(--os-bg-0);
-}
-.validator-app-slot > * { flex: 1 1 auto; min-width: 0; min-height: 0; }
-.validator-app-frame {
-    width: 100%;
-    height: 100%;
-    border: none;
-    background: var(--os-bg-0);
-}
-
 /* Touch tap-target floor for the browser pane toolbar. The back/forward/reload
  * buttons and the URL field are 28px by default (no @media anywhere), below the
  * 44px touch minimum on tablets and phones. Lift them on coarse pointers and

package/src/kits/os/index.js

@@ -11,7 +11,6 @@ export { renderBrowserPane } from './browser-app.js';
 export { renderFilesApp } from './files-app.js';
 export { renderMonitorApp } from './monitor-app.js';
 export { renderTerminal } from './terminal-app.js';
-export { renderValidator } from './validator-app.js';
 export { createFreddieDashboard } from './freddie-dashboard.js';
 
 export const themeUrl = new URL('./theme.css', import.meta.url).href;

package/src/kits/os/validator-app.js

@@ -1,55 +0,0 @@
-// Validator-app paint surface — status banner + counts + iframe slot. Consumer mounts iframe.
-// renderValidator({src, results, callbacks: {onRerun}}) -> {node, slot, setResults, dispose}.
-// results shape: {allGreen, passed, total, ms} — banner updates colors + counts.
-
-export function renderValidator(opts = {}) {
-    const { src = '', results = null, callbacks = {} } = opts;
-    const node = document.createElement('div');
-    node.className = 'app-pane validator-app';
-    node.dataset.component = 'validator-app';
-
-    const head = document.createElement('div');
-    head.className = 'validator-app-head';
-    const banner = document.createElement('span');
-    banner.className = 'validator-app-banner';
-    banner.dataset.state = 'pending';
-    banner.textContent = 'pending';
-    const counts = document.createElement('span');
-    counts.className = 'validator-app-counts';
-    counts.textContent = '0 / 0';
-    const rerun = document.createElement('button');
-    rerun.type = 'button';
-    rerun.className = 'validator-app-rerun';
-    rerun.textContent = 'rerun';
-    rerun.addEventListener('click', () => callbacks.onRerun && callbacks.onRerun());
-    head.append(banner, counts, rerun);
-
-    const slot = document.createElement('div');
-    slot.className = 'validator-app-slot';
-    slot.dataset.role = 'validator-mount';
-
-    if (src) {
-        const f = document.createElement('iframe');
-        f.className = 'validator-app-frame';
-        f.src = src;
-        slot.appendChild(f);
-    }
-
-    node.append(head, slot);
-
-    function setResults(r) {
-        if (!r) { banner.dataset.state = 'pending'; banner.textContent = 'pending'; counts.textContent = '0 / 0'; return; }
-        const state = r.allGreen ? 'pass' : 'fail';
-        banner.dataset.state = state;
-        banner.textContent = state;
-        counts.textContent = (r.passed ?? 0) + ' / ' + (r.total ?? 0) + (r.ms != null ? ' · ' + r.ms + 'ms' : '');
-    }
-    if (results) setResults(results);
-
-    return {
-        node,
-        get slot() { return slot; },
-        setResults,
-        dispose() {},
-    };
-}