@stacksjs/stx 0.2.94 → 0.2.96

package/dist/screenshot.js

@@ -1,2 +1,87 @@
-// @bun
-import{Zh as a,_h as b}from"./chunk-qk584whs.js";import"./chunk-3jm3snz8.js";export{b as captureScreenshots,a as captureScreenshot};
+import { WebView } from "bun";
+import { existsSync, mkdirSync, readdirSync, statSync } from "node:fs";
+import path from "node:path";
+const MAX_DIMENSION = 16384;
+function toUrl(input) {
+  if (/^https?:\/\//.test(input) || input.startsWith("file://"))
+    return input;
+  return `file://${path.resolve(input)}`;
+}
+function waitForNavigation(view, waitMs, timeoutMs) {
+  return new Promise((resolve) => {
+    let settled = !1;
+    const finish = () => {
+      if (!settled) {
+        settled = !0;
+        resolve();
+      }
+    };
+    view.onNavigated = () => setTimeout(finish, waitMs);
+    setTimeout(finish, timeoutMs);
+  });
+}
+async function waitForSelector(view, selector, timeoutMs) {
+  const expr = `!!document.querySelector(${JSON.stringify(selector)})`, deadline = Date.now() + timeoutMs;
+  while (Date.now() < deadline) {
+    try {
+      if (await view.evaluate(expr))
+        return;
+    } catch {}
+    await new Promise((r) => setTimeout(r, 100));
+  }
+}
+async function measureFullHeight(view) {
+  try {
+    const h = await view.evaluate("Math.ceil(Math.max(document.documentElement.scrollHeight, document.documentElement.offsetHeight, document.body ? document.body.scrollHeight : 0, document.body ? document.body.offsetHeight : 0))");
+    return typeof h === "number" && Number.isFinite(h) && h > 0 ? Math.min(h, MAX_DIMENSION) : 0;
+  } catch {
+    return 0;
+  }
+}
+export async function captureScreenshot(input, output, opts = {}) {
+  const width = Math.min(opts.width ?? 1440, MAX_DIMENSION), height = Math.min(opts.height ?? 2200, MAX_DIMENSION), waitMs = opts.waitMs ?? 800, timeoutMs = opts.timeoutMs ?? 15000, format = opts.format ?? "png", url = toUrl(input), open = (h) => new WebView({
+    url,
+    width,
+    height: h,
+    headless: !0,
+    ...opts.backend ? { backend: opts.backend } : {}
+  });
+  let view = open(height);
+  try {
+    await waitForNavigation(view, waitMs, timeoutMs);
+    if (opts.waitSelector)
+      await waitForSelector(view, opts.waitSelector, timeoutMs);
+    if (opts.fullPage) {
+      const full = await measureFullHeight(view);
+      if (full > height) {
+        view.close();
+        view = open(full);
+        await waitForNavigation(view, waitMs, timeoutMs);
+        if (opts.waitSelector)
+          await waitForSelector(view, opts.waitSelector, timeoutMs);
+      }
+    }
+    const buf = await view.screenshot({ encoding: "buffer", format });
+    mkdirSync(path.dirname(path.resolve(output)), { recursive: !0 });
+    await Bun.write(output, buf);
+  } finally {
+    view.close();
+  }
+  if (!existsSync(output))
+    throw Error(`Screenshot was not produced for ${input}`);
+  return { input, output, bytes: statSync(output).size };
+}
+export async function captureScreenshots(input, outDir, opts = {}) {
+  mkdirSync(outDir, { recursive: !0 });
+  let pages;
+  if (!/^https?:\/\//.test(input) && existsSync(input) && statSync(input).isDirectory())
+    pages = readdirSync(input).filter((f) => f.endsWith(".html")).map((f) => path.join(input, f));
+  else
+    pages = [input];
+  const ext = opts.format ?? "png", results = [];
+  for (const page of pages) {
+    const name = /^https?:\/\//.test(page) ? new URL(page).pathname.replace(/\W+/g, "-").replace(/^-|-$/g, "") || "index" : path.basename(page).replace(/\.html?$/, "");
+    results.push(await captureScreenshot(page, path.join(outDir, `${name}.${ext}`), opts));
+  }
+  return results;
+}

package/dist/script-classifier.js

@@ -1,2 +1,32 @@
-// @bun
-import{Qq as a,Rq as b}from"./chunk-6djgb0hr.js";import"./chunk-3jm3snz8.js";export{a as classifyScript,b as classifyAllScripts};
+const SIGNALS_PATTERN = /\b(?:state|derived|effect|batch|ref|reactive|computed|watch|watchEffect)\s*(?:<[^>]*>)?\s*\(/;
+export function classifyScript(attrs, content, fullTag) {
+  const result = { fullTag, content, attrs };
+  if (/\bserver\b/.test(attrs))
+    return { ...result, type: "server" };
+  if (/\bdata-stx-scoped\b/.test(attrs))
+    return { ...result, type: "client" };
+  if (SIGNALS_PATTERN.test(content))
+    return { ...result, type: "signals" };
+  if (/\bclient\b/.test(attrs) || /\btype\s*=\s*["']module["']/.test(attrs) || /\bsrc\s*=/.test(attrs))
+    return { ...result, type: "client" };
+  return { ...result, type: "server" };
+}
+export function classifyAllScripts(content) {
+  const signals = [], client = [], server = [], scriptRegex = /<script\b([^>]*)>([\s\S]*?)<\/script>/gi;
+  let match;
+  while ((match = scriptRegex.exec(content)) !== null) {
+    const classification = classifyScript(match[1], match[2], match[0]);
+    switch (classification.type) {
+      case "signals":
+        signals.push(classification);
+        break;
+      case "client":
+        client.push(classification);
+        break;
+      case "server":
+        server.push(classification);
+        break;
+    }
+  }
+  return { signals, client, server };
+}

package/dist/script-validation.js

@@ -1,2 +1,158 @@
-// @bun
-import{vt as a,wt as b}from"./chunk-fhawx87n.js";import"./chunk-3jm3snz8.js";export{b as validateClientScript,a as PROHIBITED_DOM_PATTERNS};
+export const PROHIBITED_DOM_PATTERNS = [
+  {
+    pattern: /document\.getElementById\s*\(/g,
+    message: "document.getElementById() is prohibited",
+    suggestion: 'Use useRef("name") instead'
+  },
+  {
+    pattern: /document\.querySelector\s*\(/g,
+    message: "document.querySelector() is prohibited",
+    suggestion: 'Use useRef("name") instead'
+  },
+  {
+    pattern: /document\.querySelectorAll\s*\(/g,
+    message: "document.querySelectorAll() is prohibited",
+    suggestion: 'Use useRef("name") and access children instead'
+  },
+  {
+    pattern: /document\.getElementsBy\w+\s*\(/g,
+    message: "document.getElementsBy*() is prohibited",
+    suggestion: 'Use useRef("name") instead'
+  },
+  {
+    pattern: /document\.createElement\s*\(/g,
+    message: "document.createElement() is prohibited",
+    suggestion: "Use template directives or component composition instead"
+  },
+  {
+    pattern: /document\.activeElement(?![A-Za-z])/g,
+    message: "document.activeElement is prohibited",
+    suggestion: "Use useRef() to track focused elements"
+  },
+  {
+    pattern: /document\.title\s*=/g,
+    message: "document.title assignment is prohibited",
+    suggestion: "Use useTitle() from composables"
+  },
+  {
+    pattern: /document\.cookie(?![A-Za-z])/g,
+    message: "document.cookie is prohibited",
+    suggestion: "Use useCookie() from composables"
+  },
+  {
+    pattern: /document\.addEventListener\s*\(/g,
+    message: "document.addEventListener() is prohibited",
+    suggestion: "Use useEventListener() or template @event directives"
+  },
+  {
+    pattern: /window\.location(?![A-Za-z])/g,
+    message: "window.location is prohibited",
+    suggestion: "Use navigate() or useRoute()"
+  },
+  {
+    pattern: /window\.history(?![A-Za-z])/g,
+    message: "window.history is prohibited",
+    suggestion: "Use navigate(), goBack(), goForward()"
+  },
+  {
+    pattern: /window\.addEventListener\s*\(/g,
+    message: "window.addEventListener() is prohibited",
+    suggestion: "Use useEventListener() or @click directives"
+  },
+  {
+    pattern: /window\.localStorage(?![A-Za-z])/g,
+    message: "window.localStorage is prohibited",
+    suggestion: "Use useLocalStorage() from composables"
+  },
+  {
+    pattern: /window\.sessionStorage(?![A-Za-z])/g,
+    message: "window.sessionStorage is prohibited",
+    suggestion: "Use useSessionStorage() from composables"
+  },
+  {
+    pattern: /window\.scrollTo\s*\(/g,
+    message: "window.scrollTo() is prohibited",
+    suggestion: "Use useScroll().scrollTo() from composables"
+  },
+  {
+    pattern: /window\.alert\s*\(/g,
+    message: "window.alert() is prohibited",
+    suggestion: "Use stx modal/dialog APIs instead"
+  },
+  {
+    pattern: /window\.confirm\s*\(/g,
+    message: "window.confirm() is prohibited",
+    suggestion: "Use stx modal/dialog APIs instead"
+  },
+  {
+    pattern: /window\.prompt\s*\(/g,
+    message: "window.prompt() is prohibited",
+    suggestion: "Use stx modal/dialog APIs instead"
+  },
+  {
+    pattern: /(?<!\w)setTimeout\s*\(/g,
+    message: "setTimeout() is prohibited",
+    suggestion: "Use useTimeout() or useDebounce() from composables"
+  },
+  {
+    pattern: /(?<!\w)setInterval\s*\(/g,
+    message: "setInterval() is prohibited",
+    suggestion: "Use useInterval() from composables"
+  },
+  {
+    pattern: /(?<!\w)clearTimeout\s*\(/g,
+    message: "clearTimeout() is prohibited",
+    suggestion: "Use useTimeout().stop() or useDebounce().cancel()"
+  },
+  {
+    pattern: /(?<!\w)clearInterval\s*\(/g,
+    message: "clearInterval() is prohibited",
+    suggestion: "Use useInterval().pause()"
+  },
+  {
+    pattern: /(?<!\w)location\.href\s*=/g,
+    message: "location.href assignment is prohibited",
+    suggestion: "Use navigate() instead"
+  },
+  {
+    pattern: /(?<!\w)location\.assign\s*\(/g,
+    message: "location.assign() is prohibited",
+    suggestion: "Use navigate() instead"
+  },
+  {
+    pattern: /(?<!\w)location\.replace\s*\(/g,
+    message: "location.replace() is prohibited",
+    suggestion: "Use navigate() instead"
+  }
+];
+export function validateClientScript(content, filePath, strict) {
+  const strictConfig = typeof strict === "boolean" ? { enabled: strict, failOnViolation: strict } : strict ?? { enabled: !1 }, allowPatterns = strictConfig.allowPatterns ?? [], errors = [];
+  for (const { pattern, message, suggestion } of PROHIBITED_DOM_PATTERNS) {
+    if (allowPatterns.some((allowed) => message.includes(allowed) || pattern.source.includes(allowed)))
+      continue;
+    pattern.lastIndex = 0;
+    const matches = content.match(pattern);
+    if (matches && matches.length > 0) {
+      const lines = content.split(`
+`), lineNumbers = [];
+      lines.forEach((line, index) => {
+        pattern.lastIndex = 0;
+        if (pattern.test(line))
+          lineNumbers.push(index + 1);
+      });
+      const locationInfo = lineNumbers.length > 0 ? ` (line${lineNumbers.length > 1 ? "s" : ""}: ${lineNumbers.join(", ")})` : "";
+      errors.push(`  \u2717 ${message}${locationInfo}
+    \u2192 ${suggestion}`);
+    }
+  }
+  if (errors.length > 0 && strictConfig.enabled) {
+    const baseMessage = `[STX] DOM API violation in ${filePath.split("/").pop() || filePath}:
+${errors.join(`
+`)}
+  Tip: prefer useRef(), navigate(), and composables for component code`;
+    if (strictConfig.failOnViolation)
+      throw Error(baseMessage);
+    else
+      console.warn(baseMessage);
+  }
+}