@vfrey/vfrey 0.0.1 → 1.0.0-beta.0

package/vendor/framey/dist/compare-W7UY3BAZ.js

@@ -0,0 +1,463 @@
+import { createRequire as __hf_createRequire } from "node:module";
+import { fileURLToPath as __hf_fileURLToPath } from "node:url";
+import { dirname as __hf_dirname } from "node:path";
+var require = __hf_createRequire(import.meta.url);
+var __filename = __hf_fileURLToPath(import.meta.url);
+var __dirname = __hf_dirname(__filename);
+import {
+  createContactSheet
+} from "./chunk-6GV5XSOR.js";
+import "./chunk-GKZEVJIB.js";
+import {
+  displayPathFromInput,
+  readOptionalString,
+  resolveFromBase
+} from "./chunk-ZKDMAOFU.js";
+import "./chunk-VMC4WSH5.js";
+import "./chunk-6BEFEWFB.js";
+import {
+  withMeta
+} from "./chunk-O4YRB27L.js";
+import {
+  serveStaticProjectHtml
+} from "./chunk-C5BO7PMT.js";
+import "./chunk-X7MTZ4T2.js";
+import "./chunk-6DDPOHMK.js";
+import "./chunk-XUHOIDKG.js";
+import "./chunk-THJALHFJ.js";
+import "./chunk-IUONB55J.js";
+import "./chunk-6JR2XUEE.js";
+import "./chunk-MI5FTLYK.js";
+import "./chunk-YPRBGITP.js";
+import "./chunk-7JQFJ6JJ.js";
+import {
+  SCREENSHOT_IMAGE_WAIT_MS,
+  openSettledCompositionPage,
+  seekCompositionTimeline
+} from "./chunk-SZNTYTIV.js";
+import "./chunk-YOR4CTCE.js";
+import "./chunk-KXTKKBOC.js";
+import "./chunk-P5ZBLXJ6.js";
+import "./chunk-LEKZNRKI.js";
+import "./chunk-442JNXRM.js";
+import "./chunk-4BNN5FGX.js";
+import "./chunk-XT7X6QCP.js";
+import "./chunk-4YYJOFKS.js";
+import "./chunk-HVW7ABXD.js";
+import "./chunk-WKBM7NDG.js";
+import "./chunk-XX7LTW5Y.js";
+import "./chunk-JHOCK3DG.js";
+import "./chunk-XPTOJZJF.js";
+import "./chunk-RGLQURIX.js";
+import "./chunk-P6LJ4Y32.js";
+import "./chunk-GMECXFAN.js";
+import "./chunk-FLREUEHW.js";
+import "./chunk-EOVYQ3IG.js";
+import {
+  trackCompareSheet
+} from "./chunk-GNEFDLFB.js";
+import "./chunk-2UZQHDM7.js";
+import "./chunk-NYEXNSHM.js";
+import {
+  defineCommand
+} from "./chunk-S3S4TGEH.js";
+import "./chunk-54HJ63Q2.js";
+import "./chunk-ISN5GRYI.js";
+import {
+  c
+} from "./chunk-VORQIH64.js";
+import {
+  failCommand
+} from "./chunk-JVBRJMOP.js";
+import "./chunk-KLIKCX6Q.js";
+import "./chunk-EVMY7IPL.js";
+import "./chunk-7FMUTGOH.js";
+import "./chunk-TIQB63MX.js";
+import "./chunk-IZCW2NKT.js";
+import "./chunk-RNV3DM4S.js";
+import "./chunk-DLA44CMS.js";
+import "./chunk-UJZREAV6.js";
+import "./chunk-VC76R6W2.js";
+import "./chunk-X7HBSTCZ.js";
+import "./chunk-B7RJV74O.js";
+import "./chunk-DPVXBVLL.js";
+import "./chunk-OFQWTKPW.js";
+import "./chunk-634HSJ3J.js";
+import "./chunk-FXMKHHPO.js";
+import "./chunk-RQVDTPGD.js";
+import "./chunk-AHX34EFP.js";
+import {
+  normalizeErrorMessage
+} from "./chunk-T2EUWCJE.js";
+import "./chunk-T6AGUTZJ.js";
+import "./chunk-XT6MXC7A.js";
+import "./chunk-K4MJX7SR.js";
+import "./chunk-4UMPIPCQ.js";
+import "./chunk-4P7NX5BM.js";
+import "./chunk-VAS6HQX3.js";
+import "./chunk-6BNTGNGD.js";
+import "./chunk-CZGHFATT.js";
+import "./chunk-PKZ7RK5N.js";
+import "./chunk-W2LGJSEN.js";
+import "./chunk-MMQ52NIZ.js";
+import {
+  isPathInside
+} from "./chunk-BSQ7XANM.js";
+import "./chunk-SDYDNHEE.js";
+import "./chunk-RXATE6FZ.js";
+import "./chunk-3422KMTD.js";
+import "./chunk-KGPLIH7B.js";
+import "./chunk-3GXQPCJC.js";
+import "./chunk-M2WBOQ2Q.js";
+
+// src/commands/compare.ts
+import {
+  cpSync,
+  existsSync,
+  mkdirSync,
+  mkdtempSync,
+  readdirSync,
+  realpathSync,
+  renameSync,
+  rmSync,
+  statSync
+} from "fs";
+import { tmpdir } from "os";
+import { basename, dirname, extname, join } from "path";
+var MAX_COMPARE_VARIANTS = 16;
+var MAX_COLUMNS = 4;
+var DEFAULT_RENDER_READY_TIMEOUT_MS = 5e3;
+var examples = [
+  [
+    "Compare two agent-authored composition variants",
+    "framey compare ./variants/a ./variants/b --out compare.png"
+  ],
+  [
+    "Compare three variants at a specific timeline time",
+    "framey compare ./a ./b ./c --at 2.5 --labels classic,bold,quiet --json"
+  ]
+];
+function defaultLabelForPath(input) {
+  const name = basename(input);
+  return extname(name).toLowerCase() === ".html" ? basename(name, extname(name)) : name;
+}
+function parsePathArgs(args) {
+  return (args._ ?? []).filter((value) => typeof value === "string").map((value) => value.trim()).filter(Boolean);
+}
+function parseLabels(value, pathCount) {
+  const raw = readOptionalString(value);
+  if (!raw) return void 0;
+  const labels = raw.split(",").map((part) => part.trim());
+  if (labels.some((label) => label.length === 0)) {
+    throw new Error("--labels entries must be non-empty");
+  }
+  if (labels.length !== pathCount) {
+    throw new Error(`--labels count (${labels.length}) must match path count (${pathCount})`);
+  }
+  return labels;
+}
+function parseAtSeconds(value) {
+  const raw = readOptionalString(value);
+  if (!raw) return 0;
+  const parsed = Number(raw);
+  if (!Number.isFinite(parsed) || parsed < 0) {
+    throw new Error("--at must be a non-negative number of seconds");
+  }
+  return parsed;
+}
+function parseColumns(value) {
+  const raw = readOptionalString(value);
+  if (!raw) return void 0;
+  const parsed = Number(raw);
+  if (!Number.isInteger(parsed) || parsed < 1) {
+    throw new Error("--cols must be a positive integer");
+  }
+  return parsed;
+}
+function defaultCompareCols(cellCount) {
+  return Math.max(1, Math.min(MAX_COLUMNS, Math.ceil(Math.sqrt(cellCount))));
+}
+function parseCompareArgs(args, cwd = process.cwd()) {
+  const paths = parsePathArgs(args);
+  if (paths.length < 2) {
+    throw new Error("need 2+ paths to compare");
+  }
+  const labels = parseLabels(args.labels, paths.length);
+  const variants = paths.map((input, index) => ({
+    label: labels?.[index] ?? defaultLabelForPath(input),
+    inputPath: resolveFromBase(cwd, input),
+    displayPath: displayPathFromInput(cwd, input)
+  }));
+  return {
+    variants,
+    outPath: resolveFromBase(cwd, readOptionalString(args.out) ?? "compare.png"),
+    atSeconds: parseAtSeconds(args.at),
+    cols: parseColumns(args.cols),
+    json: args.json === true,
+    timeoutMs: Number.parseInt(readOptionalString(args.timeout) ?? "", 10) || DEFAULT_RENDER_READY_TIMEOUT_MS
+  };
+}
+function capCompareVariants(variants) {
+  const total = variants.length;
+  if (total <= MAX_COMPARE_VARIANTS) {
+    return { variants: [...variants], truncated: false, total };
+  }
+  console.error(
+    c.warn(
+      `Warning: ${total} compare variants exceed the ${MAX_COMPARE_VARIANTS}-variant cap \u2014 rendering the first ${MAX_COMPARE_VARIANTS} of ${total}; re-run with fewer variants or split into multiple runs.`
+    )
+  );
+  return {
+    variants: variants.slice(0, MAX_COMPARE_VARIANTS),
+    truncated: true,
+    total
+  };
+}
+function buildCompareSuccessPayload(sheet, variants, capResult) {
+  const payload = {
+    ok: true,
+    sheet,
+    variants: variants.map((variant) => ({
+      label: variant.label,
+      path: variant.displayPath
+    })),
+    rendered: variants.length
+  };
+  if (capResult.truncated) {
+    payload.truncated = true;
+    payload.total = capResult.total;
+  }
+  return payload;
+}
+function inputError(variant) {
+  return new Error(
+    `Variant "${variant.label}" is not a composition input (${variant.displayPath}): expected a directory containing index.html or a .html file`
+  );
+}
+function copyVariantSiblings(sourceDir, destinationDir, stagingPaths) {
+  mkdirSync(destinationDir, { recursive: true });
+  for (const entry of readdirSync(sourceDir)) {
+    if (entry === "node_modules" || entry === ".git") continue;
+    const src = join(sourceDir, entry);
+    const dest = join(destinationDir, entry);
+    if (stagingPaths.includes(src)) continue;
+    if (stagingPaths.some((path) => isPathInside(path, src))) {
+      copyVariantSiblings(src, dest, stagingPaths);
+      continue;
+    }
+    cpSync(src, dest, {
+      recursive: true,
+      filter: (path) => basename(path) !== "node_modules" && basename(path) !== ".git"
+    });
+  }
+}
+function stageHtmlVariant(variant, existingStagedDirs) {
+  const stagedDir = mkdtempSync(join(tmpdir(), "hf-compare-variant-"));
+  try {
+    const sourceDir = realpathSync(dirname(variant.inputPath));
+    const stagingPaths = [stagedDir, ...existingStagedDirs].map((path) => realpathSync(path));
+    copyVariantSiblings(sourceDir, realpathSync(stagedDir), stagingPaths);
+    const sourceName = basename(variant.inputPath);
+    if (sourceName !== "index.html") {
+      renameSync(join(stagedDir, sourceName), join(stagedDir, "index.html"));
+    }
+    return {
+      ...variant,
+      projectDir: stagedDir,
+      stagedDir
+    };
+  } catch (err) {
+    rmSync(stagedDir, { recursive: true, force: true });
+    throw err;
+  }
+}
+function prepareCompareVariantProjects(variants) {
+  const prepared = [];
+  try {
+    for (const variant of variants) {
+      if (!existsSync(variant.inputPath)) {
+        throw inputError(variant);
+      }
+      const stat = statSync(variant.inputPath);
+      if (stat.isDirectory() && existsSync(join(variant.inputPath, "index.html"))) {
+        prepared.push({
+          ...variant,
+          projectDir: variant.inputPath
+        });
+        continue;
+      }
+      if (stat.isFile() && extname(variant.inputPath).toLowerCase() === ".html") {
+        const stagedDirs = prepared.flatMap(
+          (project) => project.stagedDir ? [project.stagedDir] : []
+        );
+        prepared.push(stageHtmlVariant(variant, stagedDirs));
+        continue;
+      }
+      throw inputError(variant);
+    }
+    return prepared;
+  } catch (err) {
+    for (const variant of prepared) {
+      if (variant.stagedDir) {
+        rmSync(variant.stagedDir, { recursive: true, force: true });
+      }
+    }
+    throw err;
+  }
+}
+function cleanupPreparedCompareVariants(variants) {
+  for (const variant of variants) {
+    if (variant.stagedDir) {
+      rmSync(variant.stagedDir, { recursive: true, force: true });
+    }
+  }
+}
+async function renderCompareVariant(variant, opts) {
+  try {
+    const { bundleToSingleHtml } = await import("./compiler-TM3W6GYF.js");
+    const html = await bundleToSingleHtml(variant.projectDir);
+    const server = await serveStaticProjectHtml(variant.projectDir, html);
+    try {
+      const {
+        browser: chromeBrowser,
+        page,
+        renderReadyTimedOut
+      } = await openSettledCompositionPage(html, server.url, {
+        renderReadyTimeoutMs: opts.timeoutMs,
+        renderReadyWarningSuffix: `comparison variant "${variant.label}" may be inaccurate`
+      });
+      try {
+        if (opts.atSeconds > 0) {
+          await seekCompositionTimeline(page, opts.atSeconds, {
+            waitForImagesMs: SCREENSHOT_IMAGE_WAIT_MS
+          });
+        }
+        await page.screenshot({ path: opts.framePath, type: "png" });
+        return { framePath: opts.framePath, renderReadyTimedOut };
+      } finally {
+        await chromeBrowser.close();
+      }
+    } finally {
+      await server.close();
+    }
+  } catch (err) {
+    throw new Error(
+      `Render failed for variant "${variant.label}" (${variant.displayPath}): ${normalizeErrorMessage(err)}`
+    );
+  }
+}
+async function renderCompareSheet(parsed) {
+  const capResult = capCompareVariants(parsed.variants);
+  const variants = capResult.variants;
+  const prepared = prepareCompareVariantProjects(variants);
+  const frameDir = mkdtempSync(join(tmpdir(), "hf-compare-frames-"));
+  const framePaths = [];
+  try {
+    let renderReadyTimedOut = false;
+    for (let i = 0; i < prepared.length; i++) {
+      const variant = prepared[i];
+      const framePath = join(frameDir, `variant-${String(i + 1).padStart(2, "0")}.png`);
+      const rendered = await renderCompareVariant(variant, {
+        atSeconds: parsed.atSeconds,
+        framePath,
+        timeoutMs: parsed.timeoutMs
+      });
+      framePaths.push(rendered.framePath);
+      renderReadyTimedOut = renderReadyTimedOut || rendered.renderReadyTimedOut;
+    }
+    mkdirSync(dirname(parsed.outPath), { recursive: true });
+    await createContactSheet(framePaths, parsed.outPath, {
+      cols: parsed.cols ?? defaultCompareCols(framePaths.length),
+      maxImages: framePaths.length,
+      labelMode: "custom",
+      labels: variants.map((variant) => variant.label)
+    });
+    trackCompareSheet({
+      command: "compare",
+      cells: variants.length,
+      truncated: capResult.truncated,
+      total: capResult.total,
+      renderReadyTimedOut
+    });
+    return buildCompareSuccessPayload(parsed.outPath, variants, capResult);
+  } finally {
+    cleanupPreparedCompareVariants(prepared);
+    rmSync(frameDir, { recursive: true, force: true });
+  }
+}
+function printJson(payload) {
+  console.log(JSON.stringify(withMeta(payload), null, 2));
+}
+var compare_default = defineCommand({
+  meta: {
+    name: "compare",
+    description: "Render independent composition variants into one labeled comparison sheet"
+  },
+  args: {
+    path: {
+      type: "positional",
+      description: "Composition project directory or .html file (pass 2+ paths)",
+      required: false
+    },
+    at: {
+      type: "string",
+      description: "Timeline time in seconds to seek before screenshotting each variant"
+    },
+    labels: {
+      type: "string",
+      description: "Comma-separated labels matching the variant path count"
+    },
+    out: {
+      type: "string",
+      description: "Output comparison sheet path (default: ./compare.png)"
+    },
+    cols: {
+      type: "string",
+      description: "Grid columns (default: sqrt heuristic, capped at 4)"
+    },
+    timeout: {
+      type: "string",
+      description: "Render-ready timeout in ms per variant (default: 5000)"
+    },
+    json: {
+      type: "boolean",
+      description: "Output result as JSON",
+      default: false
+    }
+  },
+  async run({ args }) {
+    const jsonRequested = args.json === true;
+    try {
+      const parsed = parseCompareArgs(args);
+      if (!parsed.json) {
+        console.log(
+          `${c.accent("\u25C6")}  Rendering ${Math.min(parsed.variants.length, MAX_COMPARE_VARIANTS)} of ${parsed.variants.length} composition variants`
+        );
+      }
+      const payload = await renderCompareSheet(parsed);
+      if (parsed.json) {
+        printJson(payload);
+      } else {
+        console.log(`
+${c.success("\u25C7")}  Comparison sheet saved to ${payload.sheet}`);
+      }
+    } catch (err) {
+      const message = normalizeErrorMessage(err);
+      if (jsonRequested) {
+        printJson({ ok: false, error: message });
+      } else {
+        console.error(`
+${c.error("\u2717")} Compare failed: ${message}`);
+      }
+      failCommand();
+    }
+  }
+});
+export {
+  buildCompareSuccessPayload,
+  capCompareVariants,
+  compare_default as default,
+  examples,
+  parseCompareArgs,
+  prepareCompareVariantProjects
+};

package/vendor/framey/dist/compiler-TM3W6GYF.js

@@ -0,0 +1,136 @@
+import { createRequire as __hf_createRequire } from "node:module";
+import { fileURLToPath as __hf_fileURLToPath } from "node:url";
+import { dirname as __hf_dirname } from "node:path";
+var require = __hf_createRequire(import.meta.url);
+var __filename = __hf_fileURLToPath(import.meta.url);
+var __dirname = __hf_dirname(__filename);
+import {
+  FLATTENED_INNER_ROOT_STRIP_ATTRS,
+  addScenePartsManifest,
+  assignBundledRuntimeCompositionIds,
+  buildVariablesByCompScript,
+  bundleToSingleHtml,
+  compileHtml,
+  emitMountedModuleScripts,
+  emitRootCompositionVariableStyles,
+  ensureExternalLinkTag,
+  ensureExternalScriptTag,
+  extractCompiledHtmlParityContract,
+  extractStandaloneEntryFromIndex,
+  inlineSubCompositions,
+  parsesAsScript,
+  prepareFlattenedInnerRoot,
+  scopeCssToComposition,
+  validateHyperframeHtmlContract,
+  wrapScopedCompositionScript
+} from "./chunk-RNV3DM4S.js";
+import {
+  AFTER_FONTS_SCRIPT_TYPE,
+  AUDIO_GROUP_RENDER_ID_ATTR,
+  MEDIA_RENDER_ID_ATTR,
+  RUNTIME_BOOTSTRAP_ATTR,
+  assignMediaRenderIds,
+  clampDurations,
+  compileTimingAttrs,
+  compositionStyle,
+  cssStyleMergeKey,
+  deferScriptsUntilFonts,
+  extractResolvedMedia,
+  headStyleRuns,
+  injectDurations,
+  injectScriptsAtHeadStart,
+  injectScriptsIntoHtml,
+  injectTagsAtHeadStart,
+  inlineScriptRuns,
+  insertBeforeCloseTag,
+  insertRuntimeTag,
+  isJavaScriptType,
+  isRuntimeFileUrl,
+  isTemplateEntry,
+  parseHTMLContent,
+  parseHostVariableValues,
+  readDeclaredDefaults,
+  resolveTimings,
+  shouldClampMediaDuration,
+  shouldClampResolvedMediaDuration,
+  stripEmbeddedRuntimeScripts,
+  styleElementsFor
+} from "./chunk-UJZREAV6.js";
+import "./chunk-VC76R6W2.js";
+import "./chunk-X7HBSTCZ.js";
+import "./chunk-B7RJV74O.js";
+import "./chunk-DPVXBVLL.js";
+import "./chunk-OFQWTKPW.js";
+import "./chunk-4P7NX5BM.js";
+import "./chunk-VAS6HQX3.js";
+import "./chunk-6BNTGNGD.js";
+import "./chunk-CZGHFATT.js";
+import "./chunk-PKZ7RK5N.js";
+import {
+  checkSubCompositionUsability
+} from "./chunk-MMQ52NIZ.js";
+import {
+  CSS_URL_RE,
+  PATH_ATTRS,
+  isNonRelativeUrl,
+  isPathInside
+} from "./chunk-BSQ7XANM.js";
+import "./chunk-SDYDNHEE.js";
+import "./chunk-RXATE6FZ.js";
+import "./chunk-3422KMTD.js";
+import "./chunk-M2WBOQ2Q.js";
+export {
+  AFTER_FONTS_SCRIPT_TYPE,
+  AUDIO_GROUP_RENDER_ID_ATTR,
+  CSS_URL_RE,
+  FLATTENED_INNER_ROOT_STRIP_ATTRS,
+  MEDIA_RENDER_ID_ATTR,
+  PATH_ATTRS,
+  RUNTIME_BOOTSTRAP_ATTR,
+  addScenePartsManifest,
+  assignBundledRuntimeCompositionIds,
+  assignMediaRenderIds,
+  buildVariablesByCompScript,
+  bundleToSingleHtml,
+  checkSubCompositionUsability,
+  clampDurations,
+  compileHtml,
+  compileTimingAttrs,
+  compositionStyle,
+  cssStyleMergeKey,
+  deferScriptsUntilFonts,
+  emitMountedModuleScripts,
+  emitRootCompositionVariableStyles,
+  ensureExternalLinkTag,
+  ensureExternalScriptTag,
+  extractCompiledHtmlParityContract,
+  extractResolvedMedia,
+  extractStandaloneEntryFromIndex,
+  headStyleRuns,
+  injectDurations,
+  injectScriptsAtHeadStart,
+  injectScriptsIntoHtml,
+  injectTagsAtHeadStart,
+  inlineScriptRuns,
+  inlineSubCompositions,
+  insertBeforeCloseTag,
+  insertRuntimeTag,
+  isJavaScriptType,
+  isNonRelativeUrl,
+  isPathInside,
+  isRuntimeFileUrl,
+  isTemplateEntry,
+  parseHTMLContent,
+  parseHostVariableValues,
+  parsesAsScript,
+  prepareFlattenedInnerRoot,
+  readDeclaredDefaults,
+  resolveTimings,
+  scopeCssToComposition,
+  shouldClampMediaDuration,
+  shouldClampResolvedMediaDuration,
+  stripEmbeddedRuntimeScripts,
+  styleElementsFor,
+  validateHyperframeHtmlContract,
+  wrapScopedCompositionScript
+};