@hyperframes/studio-server 0.8.6 → 0.8.8

package/dist/helpers/mediaProxyPreview.d.ts

@@ -1,4 +1,4 @@
-export { P as PreviewApiAdapter, i as injectMediaCodecMap, e as injectMediaCodecMapIntoHtml, f as isAutoProxyEnabled, p as proxyEtagSalt, r as resolvePreviewMediaCodecProbeCache } from '../mediaProxyPreview-DVTxBkRO.js';
+export { P as PreviewApiAdapter, i as injectMediaCodecMap, e as injectMediaCodecMapIntoHtml, f as isAutoProxyEnabled, p as proxyEtagSalt, r as resolvePreviewMediaCodecProbeCache } from '../mediaProxyPreview-CGJ7f9JA.js';
 import './mediaCodecMap.js';
 import '@hyperframes/core';
 import '@hyperframes/parsers';

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { Hono } from 'hono';
-import { S as StudioApiAdapter, M as MediaProcessingJobState } from './mediaProxyPreview-DVTxBkRO.js';
-export { L as LintResult, P as PreviewApiAdapter, R as RenderJobState, a as ResolvedProject, b as StudioSelectionResponse, c as StudioSelectionSnapshot, d as StudioSelectionTextField } from './mediaProxyPreview-DVTxBkRO.js';
+import { S as StudioApiAdapter, M as MediaProcessingJobState } from './mediaProxyPreview-CGJ7f9JA.js';
+export { L as LintResult, P as PreviewApiAdapter, R as RenderJobState, a as ResolvedProject, b as StudioSelectionResponse, c as StudioSelectionSnapshot, d as StudioSelectionTextField } from './mediaProxyPreview-CGJ7f9JA.js';
 export { ScreenshotClip, getElementScreenshotClip } from './helpers/screenshotClip.js';
 export { STUDIO_MANUAL_EDITS_PATH, StudioManualEditsRenderScriptOptions, createStudioManualEditsRenderBodyScript, createStudioPositionSeekReapplyScript } from './helpers/manualEditsRenderScript.js';
 export { STUDIO_MOTION_PATH, StudioMotionRenderScriptOptions, createStudioMotionRenderBodyScript } from './helpers/studioMotionRenderScript.js';
@@ -16,6 +16,27 @@ import './helpers/mediaCodecMap.js';
  */
 declare function createStudioApi(adapter: StudioApiAdapter): Hono;
 
+/**
+ * Whether a write at `changedPath` can change `createProjectSignature(projectDir)`.
+ *
+ * Owned here because it is the exact complement of what the walk below collects,
+ * and a second copy of that reasoning drifts the moment either set changes. A
+ * watcher that invalidates on everything is not merely wasteful: `.thumbnails/`
+ * is written by the thumbnail route on every capture, and each capture reads the
+ * preview, so an unfiltered watcher discards the memo on roughly every request of
+ * the one workload the memo exists for.
+ *
+ * Note this is not `WATCHER_EXCLUDED_DIRS`, which is character-identical but
+ * excludes all of `.hyperframes/` — the signature deliberately reads two manifest
+ * files from inside it, so filtering with that set would stop motion-state saves
+ * from ever invalidating.
+ *
+ * Every segment is tested, not just the parents, so a directory event on an
+ * excluded dir itself (`unlinkDir .thumbnails`) is filtered too. The cost is that
+ * a *file* literally named `dist` at the project root reads as excluded; the walk
+ * would collect it, so it is a false negative, and no real project has one.
+ */
+declare function affectsProjectSignature(projectDir: string, changedPath: string): boolean;
 /**
  * Creates a stable preview cache-busting signature for project source plus Studio manifests.
  */
@@ -97,4 +118,4 @@ type BackgroundRemovalRender = (options: {
 }>;
 declare function createBackgroundRemovalJob(opts: BackgroundRemovalJobOptions, render: BackgroundRemovalRender): MediaProcessingJobState;
 
-export { type BackgroundRemovalRender, type FileWriteReceipt, MIME_TYPES, MediaProcessingJobState, StudioApiAdapter, type ThumbnailOutputDimensions, buildSubCompositionHtml, consumeFileWriteReceipt, createBackgroundRemovalJob, createProjectSignature, createStudioApi, fileContentVersion, getMimeType, thumbnailDeviceScaleFactor, walkDir };
+export { type BackgroundRemovalRender, type FileWriteReceipt, MIME_TYPES, MediaProcessingJobState, StudioApiAdapter, type ThumbnailOutputDimensions, affectsProjectSignature, buildSubCompositionHtml, consumeFileWriteReceipt, createBackgroundRemovalJob, createProjectSignature, createStudioApi, fileContentVersion, getMimeType, thumbnailDeviceScaleFactor, walkDir };

package/dist/index.js

@@ -85,7 +85,7 @@ function walkDir(dir, prefix = "") {
 // src/helpers/projectSignature.ts
 import { createHash } from "crypto";
 import { lstatSync, readFileSync, readdirSync as readdirSync2 } from "fs";
-import { extname, isAbsolute, relative, resolve } from "path";
+import { extname, isAbsolute, relative, resolve, sep } from "path";
 var SIGNATURE_TEXT_EXTENSIONS = /* @__PURE__ */ new Set([
   ".cjs",
   ".css",
@@ -119,6 +119,15 @@ var STUDIO_SIGNATURE_MANIFEST_PATHS = [
   ".hyperframes/studio-manual-edits.json",
   ".hyperframes/studio-motion.json"
 ];
+function affectsProjectSignature(projectDir, changedPath) {
+  const relativePath = relative(resolve(projectDir), resolve(changedPath));
+  if (relativePath === "" || relativePath.startsWith("..") || isAbsolute(relativePath)) {
+    return false;
+  }
+  const segments = relativePath.split(sep);
+  if (STUDIO_SIGNATURE_MANIFEST_PATHS.includes(segments.join("/"))) return true;
+  return !segments.some((segment) => SIGNATURE_EXCLUDED_DIRS.has(segment));
+}
 var projectSignatureCache = /* @__PURE__ */ new Map();
 function isPathWithin(parentDir, childPath) {
   const childRelativePath = relative(parentDir, childPath);
@@ -679,7 +688,7 @@ import { parseHTML as parseHTML2 } from "linkedom";
 // src/helpers/compositionInsertion.ts
 import { existsSync as existsSync3, readFileSync as readFileSync4, realpathSync } from "fs";
 import { randomUUID as randomUUID2 } from "crypto";
-import { dirname, relative as relative3, resolve as resolve2, sep } from "path";
+import { dirname, relative as relative3, resolve as resolve2, sep as sep2 } from "path";
 import { parseHTML } from "linkedom";
 var CompositionInsertionError = class extends Error {
   constructor(message, status) {
@@ -807,7 +816,7 @@ function uniqueHostId(root, base) {
   return `${base}_${suffix}`;
 }
 function relativeSourcePath(targetAbs, sourceAbs) {
-  return relative3(dirname(targetAbs), sourceAbs).split(sep).join("/");
+  return relative3(dirname(targetAbs), sourceAbs).split(sep2).join("/");
 }
 function insertCompositionIntoSource(input) {
   const targetAbs = canonicalProjectFile(input.projectDir, input.targetPath);
@@ -3718,6 +3727,31 @@ ${runtimeTag}`;
 // src/routes/lint.ts
 import { readFileSync as readFileSync9 } from "fs";
 import { join as join9 } from "path";
+async function collectProjectFindings(adapter, projectDir) {
+  const findings = [];
+  const coveredFiles = /* @__PURE__ */ new Set();
+  if (!adapter.lintProject) return { findings, coveredFiles };
+  const result = await adapter.lintProject(projectDir);
+  for (const entry of result.results) {
+    coveredFiles.add(entry.file);
+    for (const finding of entry.result.findings) {
+      findings.push({ ...finding, file: entry.file });
+    }
+  }
+  return { findings, coveredFiles };
+}
+async function lintUncoveredHtml(adapter, projectDir, htmlFiles, coveredFiles) {
+  const findings = [];
+  for (const file of htmlFiles) {
+    if (coveredFiles.has(file)) continue;
+    const content = readFileSync9(join9(projectDir, file), "utf-8");
+    const result = await adapter.lint(content, { filePath: file });
+    for (const finding of result?.findings ?? []) {
+      findings.push({ ...finding, file });
+    }
+  }
+  return findings;
+}
 function registerLintRoutes(api, adapter) {
   api.get("/projects/:id/lint", async (c) => {
     const project = await adapter.resolveProject(c.req.param("id"));
@@ -3726,17 +3760,14 @@ function registerLintRoutes(api, adapter) {
       const htmlFiles = walkDir(project.dir).filter(
         (f) => f.endsWith(".html") && !isInHiddenOrVendorDir(f)
       );
-      const allFindings = [];
-      for (const file of htmlFiles) {
-        const content = readFileSync9(join9(project.dir, file), "utf-8");
-        const result = await adapter.lint(content, { filePath: file });
-        if (result?.findings) {
-          for (const f of result.findings) {
-            allFindings.push({ ...f, file });
-          }
-        }
-      }
-      return c.json({ findings: allFindings });
+      const projectLint = await collectProjectFindings(adapter, project.dir);
+      const extraFindings = await lintUncoveredHtml(
+        adapter,
+        project.dir,
+        htmlFiles,
+        projectLint.coveredFiles
+      );
+      return c.json({ findings: [...projectLint.findings, ...extraFindings] });
     } catch (err) {
       const msg = err instanceof Error ? err.message : String(err);
       return c.json({ error: `Lint failed: ${msg}` }, 500);
@@ -4890,6 +4921,7 @@ export {
   MIME_TYPES,
   STUDIO_MANUAL_EDITS_PATH,
   STUDIO_MOTION_PATH,
+  affectsProjectSignature,
   buildSubCompositionHtml,
   consumeFileWriteReceipt,
   createBackgroundRemovalJob,