npm - @techninja/clearstack - Versions diffs - 0.3.37 → 0.3.39 - Mend

@techninja/clearstack 0.3.37 → 0.3.39

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (16) hide show

package/bin/cli.js +24 -4
package/docs/OG_METADATA_SPEC.md +98 -51
package/docs/SPEC_WORKFLOW.md +116 -0
package/docs/app-spec/SPEC_WATCH_PROPOSAL.md +80 -0
package/lib/build-og-images.js +122 -0
package/lib/build-og.js +17 -41
package/lib/check.js +10 -10
package/lib/og-default-template.js +48 -0
package/lib/og-image-template.js +111 -0
package/lib/og-template.js +2 -2
package/lib/report.js +106 -0
package/lib/spec-config.js +7 -3
package/lib/spec-utils.js +38 -36
package/package.json +3 -3
package/templates/shared/docs/clearstack/OG_METADATA_SPEC.md +98 -51
package/templates/shared/docs/clearstack/SPEC_WORKFLOW.md +116 -0

package/lib/check.js CHANGED Viewed

@@ -26,7 +26,7 @@ function findTypeConfigs(dir, runner) {
   }
   return configs.map((c) => ({
     key: c.key, name: `JSDoc types — ${c.label}`, parent: 'types',
-    run: () => runCmd(`Types (${c.label})`, `${runner} tsc --project ${c.path}`, dir),
+    run: () => runCmd(`Types (${c.label})`, `${runner} tsc --project ${c.path}`, dir).pass,
   }));
 }
@@ -41,24 +41,24 @@ export function buildChecks(dir, cfg, cmds) {
   const runner = detectRunner(dir);
   return [
     { key: 'es', name: 'ESLint', parent: 'lint',
-      run: () => runCmd('ESLint', cmds.lint, dir, `${js()} files`) },
+      run: () => runCmd('ESLint', cmds.lint, dir, `${js()} files`).pass },
     { key: 'css', name: 'Stylelint', parent: 'lint',
-      run: () => runCmd('Stylelint', cmds.stylelint, dir, `${css()} files`) },
+      run: () => runCmd('Stylelint', cmds.stylelint, dir, `${css()} files`).pass },
     { key: 'md', name: 'Markdown lint', parent: 'lint',
-      run: () => runCmd('Markdown', cmds.mdlint, dir, `${md()} files`) },
+      run: () => runCmd('Markdown', cmds.mdlint, dir, `${md()} files`).pass },
     { key: 'prettier', name: 'Prettier', parent: 'format',
-      run: () => runCmd('Prettier', cmds.prettier, dir, `${js()} files`) },
+      run: () => runCmd('Prettier', cmds.prettier, dir, `${js()} files`).pass },
     { key: 'code', name: `Code (max ${cfg.codeMax} lines)`,
-      run: () => checkFileLines(dir, cfg.codeExt, cfg.codeMax, cfg.ignore, `Code (max ${cfg.codeMax} lines)`, { exclude: cfg.testPattern }) },
+      run: () => checkFileLines(dir, cfg.codeExt, cfg.codeMax, cfg.ignore, `Code (max ${cfg.codeMax} lines)`, { exclude: cfg.testPattern }).pass },
     { key: 'tests', name: `Tests (max ${cfg.testMax} lines)`,
-      run: () => checkFileLines(dir, cfg.codeExt, cfg.testMax, cfg.ignore, `Tests (max ${cfg.testMax} lines)`, { include: cfg.testPattern }) },
+      run: () => checkFileLines(dir, cfg.codeExt, cfg.testMax, cfg.ignore, `Tests (max ${cfg.testMax} lines)`, { include: cfg.testPattern }).pass },
     { key: 'docs', name: `Docs (max ${cfg.docsMax} lines)`,
-      run: () => checkFileLines(dir, cfg.docsExt, cfg.docsMax, cfg.ignore, `Docs (max ${cfg.docsMax} lines)`) },
+      run: () => checkFileLines(dir, cfg.docsExt, cfg.docsMax, cfg.ignore, `Docs (max ${cfg.docsMax} lines)`).pass },
     { key: 'imports', name: 'Import map aliases (no ../ imports)',
-      run: () => checkImports(dir, cfg.ignore, 'Import map aliases (no ../ imports)') },
+      run: () => checkImports(dir, cfg.ignore, 'Import map aliases (no ../ imports)').pass },
     ...findTypeConfigs(dir, runner),
     { key: 'audit', name: 'Security audit',
-      run: () => runCmd('Security audit', cmds.audit, dir) },
+      run: () => runCmd('Security audit', cmds.audit, dir).pass },
   ];
 }

package/lib/og-default-template.js ADDED Viewed

@@ -0,0 +1,48 @@
+/**
+ * Built-in default OG image template — used when no project template exists.
+ * @module lib/og-default-template
+ */
+/** @param {number} w @param {number} h */
+export function builtinTemplate(w, h) {
+  return `<!DOCTYPE html>
+<html><head><meta charset="utf-8">
+<style>
+:root {
+  --bg: {bg}; --surface: {surface}; --primary: {primary};
+  --accent: {accent}; --text: {text}; --text-muted: {textMuted};
+}
+* { margin: 0; padding: 0; box-sizing: border-box; }
+body {
+  width: ${w}px; height: ${h}px;
+  display: flex; align-items: center; justify-content: center;
+  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+  background: var(--bg); color: var(--text); overflow: hidden;
+}
+.card {
+  display: flex; width: 100%; height: 100%; padding: 60px;
+  flex-direction: column; justify-content: center; gap: 24px;
+  background: linear-gradient(135deg, var(--bg) 0%, var(--surface) 100%);
+}
+.card-with-image { flex-direction: row; align-items: center; }
+.content { flex: 1; display: flex; flex-direction: column; gap: 20px; }
+.title { font-size: 56px; font-weight: 800; line-height: 1.1; color: var(--primary); }
+.description { font-size: 26px; line-height: 1.4; color: var(--text-muted); }
+.logo { position: absolute; bottom: 40px; right: 60px; opacity: 0.7; height: 40px; }
+.hero { width: 360px; height: 360px; border-radius: 24px; object-fit: cover; flex-shrink: 0; }
+.badge { font-size: 18px; text-transform: uppercase; letter-spacing: 2px; color: var(--accent); font-weight: 600; }
+.emoji { font-size: 80px; }
+</style></head>
+<body>
+<div class="card {cardClass}">
+  <div class="content">
+    {badgeHtml}
+    {emojiHtml}
+    <div class="title">{title}</div>
+    <div class="description">{description}</div>
+  </div>
+  {imageHtml}
+</div>
+{logoHtml}
+</body></html>`;
+}

package/lib/og-image-template.js ADDED Viewed

@@ -0,0 +1,111 @@
+/**
+ * OG image template resolver — finds the right template for a route,
+ * renders it with interpolated data, ready for Playwright screenshot.
+ * @module lib/og-image-template
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { interpolate } from './og-template.js';
+import { builtinTemplate } from './og-default-template.js';
+const WIDTH = 1200;
+const HEIGHT = 630;
+/**
+ * Resolve template HTML for a route.
+ * Priority: route-specific → project default → built-in.
+ * @param {string} projectDir
+ * @param {string} [templateName]
+ */
+export function resolveTemplate(projectDir, templateName) {
+  if (templateName) {
+    const custom = resolve(projectDir, `src/og-templates/${templateName}.html`);
+    if (existsSync(custom)) return readFileSync(custom, 'utf-8');
+  }
+  const projectDefault = resolve(projectDir, 'src/og-templates/default.html');
+  if (existsSync(projectDefault)) return readFileSync(projectDefault, 'utf-8');
+  return builtinTemplate(WIDTH, HEIGHT);
+}
+/**
+ * Render a template with data context, inlining local assets as data URIs.
+ * @param {string} template
+ * @param {Record<string, unknown>} data
+ * @param {string} projectDir
+ */
+export function renderTemplate(template, data, projectDir) {
+  let html = interpolate(template, data);
+  html = html.replace(/src="\/([^"]+)"/g, (_, p) => {
+    const abs = resolve(projectDir, 'src', p);
+    if (!existsSync(abs)) return `src=""`;
+    const ext = p.split('.').pop();
+    const mime = ext === 'svg' ? 'image/svg+xml' : `image/${ext}`;
+    return `src="data:${mime};base64,${readFileSync(abs).toString('base64')}"`;
+  });
+  return html;
+}
+/** Load CSS variables from a project's token file if available. */
+export function loadTokens(projectDir) {
+  const paths = ['src/styles/tokens.css', 'src/styles/base.css', 'src/styles/global.css'];
+  for (const p of paths) {
+    const full = resolve(projectDir, p);
+    if (!existsSync(full)) continue;
+    const css = readFileSync(full, 'utf-8');
+    const vars = {};
+    for (const m of css.matchAll(/--([^:]+):\s*([^;]+)/g)) vars[m[1].trim()] = m[2].trim();
+    if (Object.keys(vars).length) return vars;
+  }
+  return {};
+}
+/**
+ * Build the full data context for template rendering.
+ * @param {{ title: string, description?: string, image?: string }} config
+ * @param {Record<string, unknown>} itemData
+ * @param {{ tokens?: Record<string, string>, logo?: string, siteName?: string }} site
+ */
+export function buildContext(config, itemData, site) {
+  const t = site.tokens || {};
+  const title = interpolate(config.title, itemData);
+  const desc = config.description ? interpolate(config.description, itemData) : '';
+  const image = config.image ? interpolate(config.image, itemData) : '';
+  const item = itemData.item || {};
+  const emoji = item.emoji || itemData.emoji || '';
+  return {
+    ...itemData, ...item,
+    title: truncate(title, 60),
+    description: truncate(desc, 160),
+    bg: t['color-bg'] || '#0f172a',
+    surface: t['color-surface'] || '#1e293b',
+    primary: t['color-primary'] || '#818cf8',
+    accent: t['color-accent'] || '#34d399',
+    text: t['color-text'] || '#e2e8f0',
+    textMuted: t['color-text-muted'] || '#a8b8cc',
+    emoji, image,
+    variantsFormatted: formatNum(item.expected_variants),
+    uniqueFormatted: formatNum(item.estimated_unique_variants),
+    imageHtml: image ? `<img class="hero" src="${image}">` : '',
+    cardClass: image ? 'card-with-image' : '',
+    logoHtml: site.logo ? `<img class="logo" src="${site.logo}">` : '',
+    badgeHtml: site.siteName ? `<div class="badge">${site.siteName}</div>` : '',
+    emojiHtml: emoji ? `<div class="emoji">${emoji}</div>` : '',
+  };
+}
+/** Format large numbers with K/M suffix. */
+function formatNum(n) {
+  if (!n) return '—';
+  if (n >= 1_000_000) return (n / 1_000_000).toFixed(1) + 'M';
+  if (n >= 1_000) return (n / 1_000).toFixed(0) + 'K';
+  return String(n);
+}
+/** @param {string} str @param {number} max */
+function truncate(str, max) {
+  return str.length > max ? str.slice(0, max - 1) + '…' : str;
+}
+export { WIDTH, HEIGHT };

package/lib/og-template.js CHANGED Viewed

@@ -65,9 +65,9 @@ export function injectMeta(html, meta) {
  * @returns {string}
  */
 export function interpolate(template, data) {
-  return template.replace(/\{([^}]+)\}/g, (_, path) => {
+  return template.replace(/\{([\w.]+)\}/g, (match, path) => {
     const val = path.split('.').reduce((obj, key) => obj?.[key], data);
-    return val !== null && val !== undefined ? String(val) : '';
+    return val !== null && val !== undefined ? String(val) : match;
   });
 }

package/lib/report.js ADDED Viewed

@@ -0,0 +1,106 @@
+/**
+ * Entropy report — runs the full spec pipeline, collects structured results.
+ * Uses the same check functions as `spec all` but in quiet mode for data.
+ * @module lib/report
+ */
+import { runCmd, checkFileLines, checkImports } from './spec-utils.js';
+import { loadConfig, buildCmds, detectRunner } from './spec-config.js';
+/**
+ * Run full spec pipeline and return structured JSON results.
+ * @param {string} dir
+ * @returns {{ checks: object[], summary: object }}
+ */
+export function collect(dir) {
+  const cfg = loadConfig(dir);
+  const cmds = buildCmds(dir);
+  const runner = detectRunner(dir);
+  const q = { quiet: true };
+  // Phase 1: lint/format fixes (mutating, like spec all)
+  const lint = runCmd('ESLint', cmds.lint, dir, undefined, q);
+  const stylelint = runCmd('Stylelint', cmds.stylelint, dir, undefined, q);
+  const prettier = runCmd('Prettier', cmds.prettier, dir, undefined, q);
+  const mdlint = runCmd('Markdown', cmds.mdlint, dir, undefined, q);
+  // Phase 2: measure post-fix state
+  const code = checkFileLines(dir, cfg.codeExt, cfg.codeMax, cfg.ignore, 'Code', { exclude: cfg.testPattern, quiet: true });
+  const tests = checkFileLines(dir, cfg.codeExt, cfg.testMax, cfg.ignore, 'Tests', { include: cfg.testPattern, quiet: true });
+  const docs = checkFileLines(dir, cfg.docsExt, cfg.docsMax, cfg.ignore, 'Docs', { quiet: true });
+  const imports = checkImports(dir, cfg.ignore, 'Imports', q);
+  // Phase 3: types
+  const types = runCmd('Types', `${runner} tsc --project .configs/jsconfig.json`, dir, undefined, q);
+  // Phase 4: audit
+  const audit = runCmd('Audit', cmds.audit, dir, undefined, q);
+  const checks = [lint, stylelint, mdlint, prettier, code, tests, docs, imports, types, audit];
+  const allLineViolations = [...(code.violations || []), ...(tests.violations || []), ...(docs.violations || [])];
+  const totalFiles = (code.files || 0) + (tests.files || 0) + (docs.files || 0);
+  const excessLines = allLineViolations.reduce((s, v) => s + (v.lines - v.max), 0);
+  return {
+    checks,
+    summary: {
+      totalFiles,
+      totalChecks: checks.length,
+      passed: checks.filter((c) => c.pass).length,
+      fileViolations: allLineViolations.length,
+      importViolations: imports.violations?.length || 0,
+      excessLines,
+      lintErrors: (lint.errors?.length || 0) + (stylelint.errors?.length || 0),
+      typeErrors: types.errors?.length || 0,
+    },
+  };
+}
+/**
+ * Run report and print human-friendly output (or JSON with --json flag).
+ * @param {string} projectDir
+ * @param {{ json?: boolean }} [opts]
+ */
+export function report(projectDir, opts = {}) {
+  console.log('\n🔧 Running full spec pipeline...\n');
+  const { checks, summary } = collect(projectDir);
+  if (opts.json) {
+    console.log(JSON.stringify({ checks, summary }, null, 2));
+    return;
+  }
+  const pct = summary.totalFiles > 0
+    ? ((summary.totalFiles - summary.fileViolations) / summary.totalFiles * 100).toFixed(1)
+    : '100.0';
+  console.log('📊 Clearstack Entropy Report\n');
+  console.log(`   Checks:       ${summary.passed}/${summary.totalChecks} passed`);
+  console.log(`   Project size: ${summary.totalFiles} files`);
+  console.log(`   Compliance:   ${pct}% of files within line limits\n`);
+  for (const c of checks) {
+    const icon = c.pass ? '✅' : '❌';
+    console.log(`   ${icon} ${c.label} (${c.time})`);
+  }
+  if (summary.excessLines > 0) {
+    const violations = [...(checks[4].violations || []), ...(checks[5].violations || []), ...(checks[6].violations || [])];
+    violations.sort((a, b) => (b.lines - b.max) - (a.lines - a.max));
+    console.log(`\n   Total excess: ${summary.excessLines} lines over limits across ${summary.fileViolations} file(s)`);
+    console.log('   Top offenders:');
+    for (const v of violations.slice(0, 5)) console.log(`     ${v.file}: ${v.lines} lines (+${v.lines - v.max})`);
+    const unowned = violations.filter((v) => /\b(vendor|dist|build)\b/.test(v.file));
+    if (unowned.length) console.log(`\n   💡 ${unowned.length} in vendor/dist — consider adding to SPEC_IGNORE_DIRS`);
+  }
+  if (summary.lintErrors > 0) console.log(`\n   ⚠️  ${summary.lintErrors} unfixable lint error(s) remain`);
+  if (summary.typeErrors > 0) console.log(`   ⚠️  ${summary.typeErrors} type error(s)`);
+  if (summary.importViolations > 0) console.log(`   ⚠️  ${summary.importViolations} parent (../) import(s) need aliases`);
+  if (summary.passed === summary.totalChecks) {
+    console.log('\n   ✨ All clear — zero entropy drift.\n');
+  } else {
+    console.log('');
+  }
+}

package/lib/spec-config.js CHANGED Viewed

@@ -13,8 +13,9 @@ export function detectRunner(projectDir) {
   return 'npx';
 }
-/** @param {string} src */
+/** @param {string} src @returns {Record<string, string>} */
 function parseEnv(src) {
+  /** @type {Record<string, string>} */
   const env = {};
   for (const line of src.split('\n')) {
     const m = line.match(/^([^#=]+)=(.*)$/);
@@ -24,12 +25,15 @@ function parseEnv(src) {
 }
 /**
- * Load spec config from project .env.
+ * Load spec config from project .env, layering .env.local on top.
  * @param {string} projectDir
  */
 export function loadConfig(projectDir) {
   const envPath = resolve(projectDir, '.env');
-  const env = existsSync(envPath) ? parseEnv(readFileSync(envPath, 'utf-8')) : {};
+  const localPath = resolve(projectDir, '.env.local');
+  const base = existsSync(envPath) ? parseEnv(readFileSync(envPath, 'utf-8')) : {};
+  const local = existsSync(localPath) ? parseEnv(readFileSync(localPath, 'utf-8')) : {};
+  const env = { ...base, ...local };
   return {
     codeMax: parseInt(env.SPEC_CODE_MAX_LINES) || 150,
     testMax: parseInt(env.SPEC_TEST_MAX_LINES) || 300,

package/lib/spec-utils.js CHANGED Viewed

@@ -35,23 +35,16 @@ export function findFiles(dir, extensions, ignoreDirs, root = dir) {
  * @param {string} root
  * @param {string[]} extensions
  * @param {string[]} ignoreDirs
- * @param {string[]} [dirs] - Subdirectories to scope to
- * @param {RegExp} [filter] - Optional regex filter on filenames
  * @returns {number}
  */
-export function countFiles(root, extensions, ignoreDirs, dirs, filter) {
-  let files;
-  if (dirs) {
-    files = dirs.reduce((acc, d) => {
-      try { return acc.concat(findFiles(resolve(root, d), extensions, ignoreDirs, root)); }
-      catch { return acc; }
-    }, []);
-  } else {
-    files = findFiles(root, extensions, ignoreDirs, root);
-  }
-  return filter ? files.filter((f) => filter.test(f)).length : files.length;
+export function countFiles(root, extensions, ignoreDirs) {
+  return findFiles(root, extensions, ignoreDirs, root).length;
 }
+/** @typedef {{ pass: boolean, label: string, time: string, files?: number, errors?: string[] }} CheckResult */
+/** @typedef {{ file: string, lines: number, max: number }} LineViolation */
+/** @typedef {{ file: string, spec: string }} ImportViolation */
 /**
  * Check file line counts with timing.
  * @param {string} root
@@ -59,8 +52,8 @@ export function countFiles(root, extensions, ignoreDirs, dirs, filter) {
  * @param {number} max
  * @param {string[]} ignoreDirs
  * @param {string} label
- * @param {{ exclude?: string, include?: string }} [filter]
- * @returns {boolean}
+ * @param {{ exclude?: string, include?: string, quiet?: boolean }} [filter]
+ * @returns {CheckResult & { violations?: LineViolation[] }}
  */
 export function checkFileLines(root, extensions, max, ignoreDirs, label, filter) {
   const start = performance.now();
@@ -74,12 +67,14 @@ export function checkFileLines(root, extensions, max, ignoreDirs, label, filter)
   }
   const time = elapsed(start);
   if (violations.length === 0) {
-    console.log(`  ✅ ${label} (${files.length} files, ${time})`);
-    return true;
+    if (!filter?.quiet) console.log(`  ✅ ${label} (${files.length} files, ${time})`);
+    return { pass: true, label, time, files: files.length };
+  }
+  if (!filter?.quiet) {
+    console.log(`  ❌ ${label} — ${violations.length} violation(s):`);
+    for (const v of violations) console.log(`     ${v.file}: ${v.lines} lines (max ${v.max})`);
   }
-  console.log(`  ❌ ${label} — ${violations.length} violation(s):`);
-  for (const v of violations) console.log(`     ${v.file}: ${v.lines} lines (max ${v.max})`);
-  return false;
+  return { pass: false, label, time, files: files.length, violations };
 }
 /**
@@ -88,9 +83,10 @@ export function checkFileLines(root, extensions, max, ignoreDirs, label, filter)
  * @param {string} root
  * @param {string[]} ignoreDirs
  * @param {string} label
- * @returns {boolean}
+ * @param {{ quiet?: boolean }} [opts]
+ * @returns {CheckResult & { violations?: ImportViolation[] }}
  */
-export function checkImports(root, ignoreDirs, label) {
+export function checkImports(root, ignoreDirs, label, opts) {
   const start = performance.now();
   const files = findFiles(root, ['.js'], ignoreDirs, root)
     .filter((f) => f.startsWith('src/') && !f.includes('vendor/') && !f.includes('api/') && !f.endsWith('.test.js') && !f.endsWith('server.js'));
@@ -106,39 +102,45 @@ export function checkImports(root, ignoreDirs, label) {
   }
   const time = elapsed(start);
   if (violations.length === 0) {
-    console.log(`  ✅ ${label} (${files.length} files, ${time})`);
-    return true;
+    if (!opts?.quiet) console.log(`  ✅ ${label} (${files.length} files, ${time})`);
+    return { pass: true, label, time, files: files.length };
   }
-  console.log(`  ❌ ${label} — ${violations.length} violation(s):`);
-  for (const v of violations) console.log(`     ${v.file}: import '${v.spec}' → use #prefix/ alias`);
-  return false;
+  if (!opts?.quiet) {
+    console.log(`  ❌ ${label} — ${violations.length} violation(s):`);
+    for (const v of violations) console.log(`     ${v.file}: import '${v.spec}' → use #prefix/ alias`);
+  }
+  return { pass: false, label, time, files: files.length, violations };
 }
 /**
  * Run a shell command, report pass/fail with timing.
  * @param {string} label
  * @param {string} cmd
  * @param {string} cwd
  * @param {string} [stats]
- * @returns {boolean}
+ * @param {{ quiet?: boolean }} [opts]
+ * @returns {CheckResult}
  */
-export function runCmd(label, cmd, cwd, stats) {
+export function runCmd(label, cmd, cwd, stats, opts) {
   const start = performance.now();
   const suffix = (s) => s ? ` (${s}, ${elapsed(start)})` : ` (${elapsed(start)})`;
   try {
     execSync(cmd, { cwd, stdio: 'pipe', encoding: 'utf-8' });
-    console.log(`  ✅ ${label}${suffix(stats)}`);
-    return true;
+    if (!opts?.quiet) console.log(`  ✅ ${label}${suffix(stats)}`);
+    return { pass: true, label, time: elapsed(start), files: parseInt(stats) || undefined };
   } catch (err) {
     const out = (err.stdout || '') + (err.stderr || '');
     const ownErrors = out.trim().split('\n')
       .filter((l) => l.trim() && !l.includes('node_modules'));
     if (ownErrors.length === 0) {
-      console.log(`  ✅ ${label}${suffix(stats)}`);
-      return true;
+      if (!opts?.quiet) console.log(`  ✅ ${label}${suffix(stats)}`);
+      return { pass: true, label, time: elapsed(start) };
+    }
+    if (!opts?.quiet) {
+      console.log(`  ❌ ${label}${suffix(stats)}`);
+      for (const line of ownErrors) console.log(`     ${line}`);
     }
-    console.log(`  ❌ ${label}${suffix(stats)}`);
-    for (const line of ownErrors) console.log(`     ${line}`);
-    return false;
+    return { pass: false, label, time: elapsed(start), errors: ownErrors };
   }
 }

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@techninja/clearstack",
-  "version": "0.3.37",
+  "version": "0.3.39",
   "type": "module",
   "description": "A no-build web component framework specification — scaffold, validate, and evolve spec-compliant projects",
   "bin": {
@@ -64,8 +64,8 @@
     "express": "^5.2.1",
     "hybrids": "^9.1.22",
     "lucide-static": "^1.7.0",
-    "markdownlint-cli2": "^0.21.0",
-    "playwright": "^1.50.0",
+    "markdownlint-cli2": "^0.12.1",
+    "playwright": "^1.61.0",
     "prettier": "^3.8.1",
     "stylelint": "^17.6.0",
     "stylelint-config-standard": "^40.0.0",