feat: initial commit - Jhonny Editor

- Adicionado estrutura completa do projeto - Configurado MCP server para Premiere Pro - Adicionado documentação e skills - Configurado Gitignore para o projeto
2026-09-08 09:59:31 -04:00
commit b541f502ba
1507 changed files with 387650 additions and 0 deletions
@@ -0,0 +1,136 @@
+import { readFile, writeFile } from "node:fs/promises";
+import { resolve } from "node:path";
+
+const sitemapUrl = "https://developer.adobe.com/sitemap.xml";
+const outputPath = process.env.PREMIERE_DOC_INVENTORY_OUTPUT_PATH
+  ? resolve(process.env.PREMIERE_DOC_INVENTORY_OUTPUT_PATH)
+  : resolve("src/resources/premiere-doc-inventory.json");
+const check = process.argv.includes("--check");
+const validateOnly = process.argv.includes("--validate-only");
+
+async function loadSitemap() {
+  if (process.env.PREMIERE_DOC_SITEMAP_PATH) {
+    return readFile(resolve(process.env.PREMIERE_DOC_SITEMAP_PATH), "utf8");
+  }
+  const response = await fetch(sitemapUrl, { signal: AbortSignal.timeout(30_000) });
+  if (!response.ok) throw new Error(`Adobe sitemap request failed: HTTP ${response.status}`);
+  return response.text();
+}
+
+function decodeXml(value) {
+  const entities = { amp: "&", lt: "<", gt: ">", quot: '"', apos: "'" };
+  return value.replace(/&(amp|lt|gt|quot|apos);/g, (_match, entity) => entities[entity]);
+}
+
+function classify(url) {
+  const path = new URL(url).pathname;
+  if (path.includes("/ppro-reference/")) return "premiere-dom";
+  if (path.includes("/uxp-api/reference-js/")) return "uxp-javascript";
+  if (path.includes("/uxp-api/reference-html/")) return "uxp-html";
+  if (path.includes("/uxp-api/reference-css/")) return "uxp-css";
+  if (path.includes("/uxp-api/reference-spectrum/")) return "spectrum-web-components";
+  if (path.includes("/plugins/")) return "uxp-plugin-guides";
+  return "premiere-uxp-supporting-docs";
+}
+
+function isCalendarDate(value) {
+  if (!/^\d{4}-\d{2}-\d{2}$/.test(value)) return false;
+  const parsed = new Date(`${value}T00:00:00.000Z`);
+  return !Number.isNaN(parsed.valueOf()) && parsed.toISOString().slice(0, 10) === value;
+}
+
+function validateCommittedInventory(inventory) {
+  if (inventory?.schemaVersion !== 1 || inventory?.source?.sitemapUrl !== sitemapUrl) {
+    throw new Error("Premiere documentation inventory has an unsupported schema or source.");
+  }
+  if (!Array.isArray(inventory.pages) || inventory.pages.length === 0) {
+    throw new Error("Premiere documentation inventory contains no pages.");
+  }
+  const counts = {};
+  let previousUrl = "";
+  for (const page of inventory.pages) {
+    if (typeof page?.url !== "string" || !page.url.startsWith("https://developer.adobe.com/premiere-pro/uxp/")) {
+      throw new Error("Premiere documentation inventory contains an invalid page URL.");
+    }
+    if (page.url <= previousUrl || typeof page.surface !== "string" || classify(page.url) !== page.surface) {
+      throw new Error("Premiere documentation inventory pages are not uniquely sorted or classified.");
+    }
+    if (page.lastModified !== null && !isCalendarDate(page.lastModified)) {
+      throw new Error(`Invalid Adobe sitemap lastmod for ${page.url}: ${page.lastModified}`);
+    }
+    previousUrl = page.url;
+    counts[page.surface] = (counts[page.surface] ?? 0) + 1;
+  }
+  const orderedCounts = Object.fromEntries(Object.entries(counts).sort(([left], [right]) => left.localeCompare(right)));
+  if (inventory.stats?.total !== inventory.pages.length || JSON.stringify(inventory.stats?.bySurface) !== JSON.stringify(orderedCounts)) {
+    throw new Error("Premiere documentation inventory statistics are stale.");
+  }
+}
+
+if (check) {
+  let current = "";
+  try { current = await readFile(outputPath, "utf8"); } catch {}
+  let inventory;
+  let validationFailed = false;
+  try {
+    inventory = JSON.parse(current);
+    validateCommittedInventory(inventory);
+  } catch (error) {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exitCode = 1;
+    validationFailed = true;
+  }
+  const rendered = inventory ? `${JSON.stringify(inventory, null, 2)}\n` : "";
+  if (validationFailed) {
+    // The validation error above is the actionable result.
+  } else if (current.replace(/\r\n?/g, "\n") !== rendered) {
+    console.error("Premiere documentation inventory is stale. Run npm run premiere:docs-inventory.");
+    process.exitCode = 1;
+  } else {
+    console.log(`Premiere documentation inventory is current: ${inventory.stats.total} pages.`);
+  }
+} else {
+  const sitemap = await loadSitemap();
+  const urlBlocks = [...sitemap.matchAll(/<url>\s*([\s\S]*?)\s*<\/url>/g)].map((match) => match[1]);
+  if (urlBlocks.length === 0) throw new Error("Adobe sitemap contained no URL entries");
+  const pages = [];
+  for (const block of urlBlocks) {
+    const location = block.match(/<loc>([\s\S]*?)<\/loc>/)?.[1]?.trim();
+    if (!location) throw new Error("Adobe sitemap URL entry has no location");
+    const url = decodeXml(location);
+    if (!url.startsWith("https://developer.adobe.com/premiere-pro/uxp/")) continue;
+    const lastModified = block.match(/<lastmod>([\s\S]*?)<\/lastmod>/)?.[1]?.trim() ?? null;
+    if (lastModified !== null && !isCalendarDate(lastModified)) {
+      throw new Error(`Invalid Adobe sitemap lastmod for ${url}: ${lastModified}`);
+    }
+    pages.push({ url, surface: classify(url), lastModified });
+  }
+  pages.sort((left, right) => left.url.localeCompare(right.url));
+  if (pages.length === 0) throw new Error("Adobe sitemap contained no Premiere UXP pages");
+  if (new Set(pages.map((page) => page.url)).size !== pages.length) {
+    throw new Error("Adobe sitemap contains duplicate Premiere UXP URLs");
+  }
+  const counts = Object.fromEntries(
+    [...new Set(pages.map((page) => page.surface))].sort().map((surface) => [
+      surface,
+      pages.filter((page) => page.surface === surface).length,
+    ]),
+  );
+  const inventory = {
+    schemaVersion: 1,
+    source: { sitemapUrl },
+    semantics: {
+      listed: "The page appears in Adobe's live developer sitemap; this inventories documentation and does not prove API implementation or host behavior.",
+    },
+    stats: { total: pages.length, bySurface: counts },
+    pages,
+  };
+  const rendered = `${JSON.stringify(inventory, null, 2)}\n`;
+
+  if (validateOnly) {
+    console.log(`Validated ${pages.length} Adobe Premiere UXP documentation pages.`);
+  } else {
+    await writeFile(outputPath, rendered);
+    console.log(`Wrote ${pages.length} Adobe Premiere UXP documentation pages.`);
+  }
+}