@whittakertech/virgil 0.1.0

package/dist/generators/og-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"og-image.d.ts","sourceRoot":"","sources":["../../src/generators/og-image.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAK7E,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,EAAE,aAAa,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,cAAc,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAkCf;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAG1D"}

package/dist/generators/og-image.js

@@ -0,0 +1,46 @@
+import { chromium } from 'playwright';
+import { readFile } from 'fs/promises';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { ensureParentDir } from '../utils/fs.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+/**
+ * Generate OG image using Playwright
+ */
+export async function generateOGImage(ctx, outputPath) {
+    // Load template
+    const templatePath = ctx.templatePath || join(__dirname, '../templates/og-default.html');
+    let html = await readFile(templatePath, 'utf-8');
+    // Replace placeholders
+    html = html
+        .replace(/{{brand.name}}/g, ctx.brand.name)
+        .replace(/{{brand.color}}/g, ctx.brand.color)
+        .replace(/{{product.name}}/g, ctx.product.name)
+        .replace(/{{product.version}}/g, ctx.product.version)
+        .replace(/{{page.title}}/g, ctx.output.page.title)
+        .replace(/{{page.url}}/g, ctx.output.page.url)
+        .replace(/{{page.description}}/g, ctx.output.page.description || '');
+    // Launch headless browser
+    const browser = await chromium.launch();
+    const page = await browser.newPage({
+        viewport: { width: 1200, height: 630 }
+    });
+    // Set content and wait for fonts/assets
+    await page.setContent(html, { waitUntil: 'networkidle' });
+    // Ensure output directory exists
+    await ensureParentDir(outputPath);
+    // Screenshot
+    await page.screenshot({
+        path: outputPath,
+        type: 'png'
+    });
+    await browser.close();
+}
+/**
+ * Generate filename for OG image with cache-busting timestamp
+ */
+export function generateOGImageFilename(id) {
+    const timestamp = Math.floor(Date.now() / 1000);
+    return `${id}.${timestamp}.png`;
+}
+//# sourceMappingURL=og-image.js.map

package/dist/generators/og-image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"og-image.js","sourceRoot":"","sources":["../../src/generators/og-image.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAa,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAS1D;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,GAAmB,EACnB,UAAkB;IAElB,gBAAgB;IAChB,MAAM,YAAY,GAAG,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC,SAAS,EAAE,8BAA8B,CAAC,CAAC;IACzF,IAAI,IAAI,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAEjD,uBAAuB;IACvB,IAAI,GAAG,IAAI;SACR,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;SAC1C,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC;SAC5C,OAAO,CAAC,mBAAmB,EAAE,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC;SAC9C,OAAO,CAAC,sBAAsB,EAAE,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC;SACpD,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;SACjD,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;SAC7C,OAAO,CAAC,uBAAuB,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;IAEvE,0BAA0B;IAC1B,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,MAAM,EAAE,CAAC;IACxC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC;QACjC,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;KACvC,CAAC,CAAC;IAEH,wCAAwC;IACxC,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC,CAAC;IAE1D,iCAAiC;IACjC,MAAM,eAAe,CAAC,UAAU,CAAC,CAAC;IAElC,aAAa;IACb,MAAM,IAAI,CAAC,UAAU,CAAC;QACpB,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,KAAK;KACZ,CAAC,CAAC;IAEH,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,EAAU;IAChD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAChD,OAAO,GAAG,EAAE,IAAI,SAAS,MAAM,CAAC;AAClC,CAAC"}

package/dist/generators/robots.d.ts

@@ -0,0 +1,9 @@
+import { RobotsOutput } from '../types/spec.js';
+export interface RobotsContext {
+    output: RobotsOutput;
+}
+/**
+ * Generate robots.txt
+ */
+export declare function generateRobots(ctx: RobotsContext, outputPath: string): Promise<void>;
+//# sourceMappingURL=robots.d.ts.map

package/dist/generators/robots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"robots.d.ts","sourceRoot":"","sources":["../../src/generators/robots.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGhD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,YAAY,CAAC;CACtB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,aAAa,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CA6Bf"}

package/dist/generators/robots.js

@@ -0,0 +1,29 @@
+import { writeFile } from 'fs/promises';
+import { ensureParentDir } from '../utils/fs.js';
+/**
+ * Generate robots.txt
+ */
+export async function generateRobots(ctx, outputPath) {
+    const lines = [];
+    for (const rule of ctx.output.rules) {
+        lines.push(`User-agent: ${rule.userAgent}`);
+        if (rule.allow) {
+            for (const path of rule.allow) {
+                lines.push(`Allow: ${path}`);
+            }
+        }
+        if (rule.disallow) {
+            for (const path of rule.disallow) {
+                lines.push(`Disallow: ${path}`);
+            }
+        }
+        lines.push(''); // Blank line between rules
+    }
+    if (ctx.output.sitemap) {
+        lines.push(`Sitemap: ${ctx.output.sitemap}`);
+    }
+    const content = lines.join('\n');
+    await ensureParentDir(outputPath);
+    await writeFile(outputPath, content, 'utf-8');
+}
+//# sourceMappingURL=robots.js.map

package/dist/generators/robots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"robots.js","sourceRoot":"","sources":["../../src/generators/robots.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAMjD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,GAAkB,EAClB,UAAkB;IAElB,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QAE5C,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC9B,KAAK,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACjC,KAAK,CAAC,IAAI,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,2BAA2B;IAC7C,CAAC;IAED,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,YAAY,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEjC,MAAM,eAAe,CAAC,UAAU,CAAC,CAAC;IAClC,MAAM,SAAS,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAChD,CAAC"}

package/dist/generators/sitemap.d.ts

@@ -0,0 +1,9 @@
+import { SitemapOutput } from '../types/spec.js';
+export interface SitemapContext {
+    output: SitemapOutput;
+}
+/**
+ * Generate sitemap.xml
+ */
+export declare function generateSitemap(ctx: SitemapContext, outputPath: string): Promise<void>;
+//# sourceMappingURL=sitemap.d.ts.map

package/dist/generators/sitemap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sitemap.d.ts","sourceRoot":"","sources":["../../src/generators/sitemap.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGjD,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,aAAa,CAAC;CACvB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,cAAc,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAqBf"}

package/dist/generators/sitemap.js

@@ -0,0 +1,24 @@
+import { writeFile } from 'fs/promises';
+import { ensureParentDir } from '../utils/fs.js';
+/**
+ * Generate sitemap.xml
+ */
+export async function generateSitemap(ctx, outputPath) {
+    const { baseUrl, pages } = ctx.output;
+    const urls = pages.map(page => {
+        const loc = `${baseUrl}${page.path}`;
+        const lastmod = page.lastmod ? `<lastmod>${page.lastmod}</lastmod>` : '';
+        const changefreq = page.changefreq ? `<changefreq>${page.changefreq}</changefreq>` : '';
+        const priority = page.priority !== undefined ? `<priority>${page.priority}</priority>` : '';
+        return `  <url>
+    <loc>${loc}</loc>${lastmod}${changefreq}${priority}
+  </url>`;
+    }).join('\n');
+    const xml = `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+${urls}
+</urlset>`;
+    await ensureParentDir(outputPath);
+    await writeFile(outputPath, xml, 'utf-8');
+}
+//# sourceMappingURL=sitemap.js.map

package/dist/generators/sitemap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sitemap.js","sourceRoot":"","sources":["../../src/generators/sitemap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAMjD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,GAAmB,EACnB,UAAkB;IAElB,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC;IAEtC,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;QAC5B,MAAM,GAAG,GAAG,GAAG,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QACrC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,eAAe,IAAI,CAAC,UAAU,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;QACxF,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,aAAa,IAAI,CAAC,QAAQ,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;QAE5F,OAAO;WACA,GAAG,SAAS,OAAO,GAAG,UAAU,GAAG,QAAQ;SAC7C,CAAC;IACR,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,MAAM,GAAG,GAAG;;EAEZ,IAAI;UACI,CAAC;IAET,MAAM,eAAe,CAAC,UAAU,CAAC,CAAC;IAClC,MAAM,SAAS,CAAC,UAAU,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;AAC5C,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { run } from './engine/run.js';
+export { computeHash, hashFile } from './engine/hash.js';
+export { loadLock, saveLock } from './engine/lock.js';
+export { loadManifest, saveManifest } from './engine/manifest.js';
+export type { VirgilSpec, OutputConfig } from './types/spec.js';
+export type { VirgilLock, LockEntry } from './types/lock.js';
+export type { VirgilManifest } from './types/manifest.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAElE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAChE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC7D,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { run } from './engine/run.js';
+export { computeHash, hashFile } from './engine/hash.js';
+export { loadLock, saveLock } from './engine/lock.js';
+export { loadManifest, saveManifest } from './engine/manifest.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/templates/og-default.html

@@ -0,0 +1,100 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="UTF-8">
+  <style>
+    * {
+      margin: 0;
+      padding: 0;
+      box-sizing: border-box;
+    }
+
+    body {
+      width: 1200px;
+      height: 630px;
+      background: linear-gradient(135deg, {{brand.color}} 0%, #1a1a2e 100%);
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
+      padding: 60px;
+    }
+
+    .container {
+      width: 100%;
+      height: 100%;
+      display: flex;
+      flex-direction: column;
+      justify-content: space-between;
+      color: white;
+    }
+
+    .header {
+      display: flex;
+      align-items: center;
+      gap: 20px;
+    }
+
+    .brand {
+      font-size: 24px;
+      font-weight: 600;
+      opacity: 0.9;
+    }
+
+    .content {
+      flex: 1;
+      display: flex;
+      flex-direction: column;
+      justify-content: center;
+    }
+
+    .title {
+      font-size: 72px;
+      font-weight: 700;
+      line-height: 1.2;
+      margin-bottom: 20px;
+    }
+
+    .description {
+      font-size: 28px;
+      opacity: 0.8;
+      line-height: 1.4;
+    }
+
+    .footer {
+      display: flex;
+      justify-content: space-between;
+      align-items: center;
+      font-size: 20px;
+      opacity: 0.7;
+    }
+
+    .product {
+      font-weight: 600;
+    }
+
+    .version {
+      background: rgba(255, 255, 255, 0.2);
+      padding: 4px 12px;
+      border-radius: 4px;
+    }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <div class="header">
+      <div class="brand">{{brand.name}}</div>
+    </div>
+
+    <div class="content">
+      <div class="title">{{page.title}}</div>
+      <div class="description">{{page.description}}</div>
+    </div>
+
+    <div class="footer">
+      <div class="product">{{product.name}}</div>
+      <div class="version">v{{product.version}}</div>
+    </div>
+  </div>
+</body>
+</html>

package/dist/types/lock.d.ts

@@ -0,0 +1,11 @@
+export interface VirgilLock {
+    version: '0.1';
+    entries: Record<string, LockEntry>;
+}
+export interface LockEntry {
+    hash: string;
+    generatedAt: string;
+    generator: string;
+    generatorVersion: string;
+}
+//# sourceMappingURL=lock.d.ts.map

package/dist/types/lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../src/types/lock.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,KAAK,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;CAC1B"}

package/dist/types/lock.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=lock.js.map

package/dist/types/lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.js","sourceRoot":"","sources":["../../src/types/lock.ts"],"names":[],"mappings":""}

package/dist/types/manifest.d.ts

@@ -0,0 +1,7 @@
+export interface VirgilManifest {
+    version: '0.1';
+    og?: Record<string, string>;
+    sitemap?: Record<string, string>;
+    robots?: Record<string, string>;
+}
+//# sourceMappingURL=manifest.d.ts.map

package/dist/types/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/types/manifest.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC"}

package/dist/types/manifest.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=manifest.js.map

package/dist/types/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/types/manifest.ts"],"names":[],"mappings":""}

package/dist/types/spec.d.ts

@@ -0,0 +1,47 @@
+export interface VirgilSpec {
+    brand: BrandConfig;
+    product: ProductConfig;
+    outputs: OutputConfig[];
+}
+export interface BrandConfig {
+    name: string;
+    logo: string;
+    color: string;
+}
+export interface ProductConfig {
+    name: string;
+    logo: string;
+    version: string;
+}
+export type OutputConfig = OGImageOutput | SitemapOutput | RobotsOutput;
+export interface OGImageOutput {
+    type: 'og-image';
+    id: string;
+    page: {
+        title: string;
+        url: string;
+        description?: string;
+    };
+}
+export interface SitemapOutput {
+    type: 'sitemap';
+    id: string;
+    baseUrl: string;
+    pages: Array<{
+        path: string;
+        lastmod?: string;
+        changefreq?: 'always' | 'hourly' | 'daily' | 'weekly' | 'monthly' | 'yearly' | 'never';
+        priority?: number;
+    }>;
+}
+export interface RobotsOutput {
+    type: 'robots';
+    id: string;
+    rules: Array<{
+        userAgent: string;
+        allow?: string[];
+        disallow?: string[];
+    }>;
+    sitemap?: string;
+}
+//# sourceMappingURL=spec.d.ts.map

package/dist/types/spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../src/types/spec.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,aAAa,GAAG,YAAY,CAAC;AAExE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;QACZ,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,SAAS,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;QACvF,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,QAAQ,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,KAAK,CAAC;QACX,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC,CAAC;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/types/spec.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=spec.js.map

package/dist/types/spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.js","sourceRoot":"","sources":["../../src/types/spec.ts"],"names":[],"mappings":""}

package/dist/utils/fs.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Ensure directory exists, create if needed
+ */
+export declare function ensureDir(dirPath: string): Promise<void>;
+/**
+ * Ensure parent directory exists for a file path
+ */
+export declare function ensureParentDir(filePath: string): Promise<void>;
+/**
+ * Check if file exists
+ */
+export declare function fileExists(filePath: string): Promise<boolean>;
+//# sourceMappingURL=fs.d.ts.map

package/dist/utils/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM9D;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAErE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOnE"}

package/dist/utils/fs.js

@@ -0,0 +1,32 @@
+import { mkdir, access } from 'fs/promises';
+import { dirname } from 'path';
+/**
+ * Ensure directory exists, create if needed
+ */
+export async function ensureDir(dirPath) {
+    try {
+        await access(dirPath);
+    }
+    catch {
+        await mkdir(dirPath, { recursive: true });
+    }
+}
+/**
+ * Ensure parent directory exists for a file path
+ */
+export async function ensureParentDir(filePath) {
+    await ensureDir(dirname(filePath));
+}
+/**
+ * Check if file exists
+ */
+export async function fileExists(filePath) {
+    try {
+        await access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=fs.js.map

package/dist/utils/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAe;IAC7C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,QAAgB;IACpD,MAAM,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,QAAgB;IAC/C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/utils/paths.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Resolve paths relative to project root
+ */
+export declare class PathResolver {
+    private rootDir;
+    constructor(rootDir: string);
+    resolve(...segments: string[]): string;
+    join(...segments: string[]): string;
+    relative(from: string, to: string): string;
+    get spec(): string;
+    get lock(): string;
+    get manifest(): string;
+}
+//# sourceMappingURL=paths.d.ts.map

package/dist/utils/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,MAAM;IAEnC,OAAO,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM;IAItC,IAAI,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM;IAInC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM;IAK1C,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;CACF"}

package/dist/utils/paths.js

@@ -0,0 +1,30 @@
+import { resolve, join, relative } from 'path';
+/**
+ * Resolve paths relative to project root
+ */
+export class PathResolver {
+    rootDir;
+    constructor(rootDir) {
+        this.rootDir = rootDir;
+    }
+    resolve(...segments) {
+        return resolve(this.rootDir, ...segments);
+    }
+    join(...segments) {
+        return join(this.rootDir, ...segments);
+    }
+    relative(from, to) {
+        return relative(from, to);
+    }
+    // Standard Virgil paths
+    get spec() {
+        return this.resolve('virgil.spec.json');
+    }
+    get lock() {
+        return this.resolve('virgil.lock.json');
+    }
+    get manifest() {
+        return this.resolve('virgil.manifest.json');
+    }
+}
+//# sourceMappingURL=paths.js.map

package/dist/utils/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAE/C;;GAEG;AACH,MAAM,OAAO,YAAY;IACH;IAApB,YAAoB,OAAe;QAAf,YAAO,GAAP,OAAO,CAAQ;IAAG,CAAC;IAEvC,OAAO,CAAC,GAAG,QAAkB;QAC3B,OAAO,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAED,IAAI,CAAC,GAAG,QAAkB;QACxB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,QAAQ,CAAC,CAAC;IACzC,CAAC;IAED,QAAQ,CAAC,IAAY,EAAE,EAAU;QAC/B,OAAO,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED,wBAAwB;IACxB,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAC9C,CAAC;CACF"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@whittakertech/virgil",
+  "version": "0.1.0",
+  "description": "Build-phase sigil forge for static site artifacts",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "virgil": "dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc && npm run copy:assets",
+    "prepare": "npm run build",
+    "copy:assets": "cp -R src/templates dist",
+    "dev": "tsc --watch",
+    "test": "node --test dist/**/*.test.js"
+  },
+  "keywords": [
+    "static-site",
+    "og-image",
+    "sitemap",
+    "build-tool"
+  ],
+  "author": "Lee Whittaker",
+  "license": "MIT",
+  "dependencies": {
+    "commander": "^12.0.0",
+    "playwright": "^1.40.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/src/cli.ts

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import { run } from './engine/run.js';
+import { resolve } from 'path';
+
+const program = new Command();
+
+program
+  .name('virgil')
+  .description('Build-phase sigil forge for static site artifacts')
+  .version('0.1.0');
+
+program
+  .command('build')
+  .description('Generate artifacts from virgil.spec.json')
+  .option('-r, --root <dir>', 'Project root directory', process.cwd())
+  .option('-o, --output <dir>', 'Output directory', 'public')
+  .option('-v, --verbose', 'Verbose output', false)
+  .action(async (options) => {
+    const rootDir = resolve(options.root);
+    const outputDir = resolve(rootDir, options.output);
+
+    console.log('🔮 Virgil v0.1.0');
+    console.log(`📁 Root: ${rootDir}`);
+    console.log(`📦 Output: ${outputDir}`);
+    console.log('');
+
+    const result = await run({
+      rootDir,
+      outputDir,
+      verbose: options.verbose
+    });
+
+    if (result.errors.length > 0) {
+      console.error('\n❌ Errors:');
+      for (const error of result.errors) {
+        console.error(`  ${error}`);
+      }
+      process.exit(1);
+    }
+
+    console.log('\n✨ Done');
+    process.exit(0);
+  });
+
+program.parse();

package/src/engine/hash.ts

@@ -0,0 +1,71 @@
+import { createHash } from 'crypto';
+import { readFile } from 'fs/promises';
+
+export const GENERATOR_VERSION = '0.1.0';
+
+export interface HashInput {
+  data: unknown;
+  templatePath?: string;
+  generatorName: string;
+}
+
+function stableStringify(value: unknown): string {
+  if (value === null || typeof value !== 'object') {
+    return JSON.stringify(value);
+  }
+
+  if (Array.isArray(value)) {
+    return JSON.stringify(value.map(stableStringify));
+  }
+
+  const obj = value as Record<string, unknown>;
+  const sortedKeys = Object.keys(obj).sort();
+
+  const normalized: Record<string, unknown> = {};
+  for (const key of sortedKeys) {
+    normalized[key] = obj[key];
+  }
+
+  return JSON.stringify(normalized);
+}
+
+/**
+ * Compute deterministic hash from input data, template contents, and generator version.
+ * 
+ * This ensures:
+ * - Data changes trigger regeneration
+ * - Template changes trigger regeneration
+ * - Generator version changes trigger regeneration
+ */
+export async function computeHash(input: HashInput): Promise<string> {
+  const parts: string[] = [];
+
+  // 1. Serialize data (stable JSON)
+  parts.push(stableStringify(input.data));
+
+  // 2. Include template contents if specified
+  if (input.templatePath) {
+    const templateContents = await readFile(input.templatePath, 'utf-8');
+    parts.push(templateContents);
+  }
+
+  // 3. Include generator identity
+  parts.push(input.generatorName);
+  parts.push(GENERATOR_VERSION);
+
+  // Compute SHA-256
+  const hash = createHash('sha256');
+  hash.update(parts.join('\n'));
+  
+  return `sha256:${hash.digest('hex')}`;
+}
+
+/**
+ * Compute hash for a file's contents
+ */
+export async function hashFile(filepath: string): Promise<string> {
+  const contents = await readFile(filepath);
+  const hash = createHash('sha256');
+  hash.update(contents);
+  return `sha256:${hash.digest('hex')}`;
+}