@arach/og 0.1.0 → 0.2.0

package/README.md

@@ -0,0 +1,106 @@
+# @arach/og
+
+Declarative OG (Open Graph) image generation with Puppeteer. Pre-built templates and a simple API for generating social sharing images.
+
+## Installation
+
+```bash
+pnpm add @arach/og
+# or
+npm install @arach/og
+```
+
+## Usage
+
+### Programmatic API
+
+```typescript
+import { generateOG } from '@arach/og'
+
+await generateOG({
+  template: 'branded',
+  title: 'My App',
+  subtitle: 'Build amazing things',
+  accent: '#f07c4f',
+  output: 'public/og.png'
+})
+```
+
+### CLI
+
+```bash
+# Generate from a config file
+npx og config.json
+```
+
+Config file format:
+
+```json
+[
+  {
+    "template": "branded",
+    "title": "My App",
+    "subtitle": "Build amazing things",
+    "accent": "#f07c4f",
+    "output": "public/og.png"
+  }
+]
+```
+
+## Templates
+
+### `branded`
+Full-featured template with logo, tag chip, and accent glow. Great for product landing pages.
+
+![branded](examples/og-branded.png)
+
+### `docs`
+Clean template for documentation pages with breadcrumb-style layout.
+
+![docs](examples/og-docs.png)
+
+### `minimal`
+Simple centered layout. Works well for blog posts and articles.
+
+![minimal](examples/og-minimal.png)
+
+### `editor-dark`
+Dark theme template for developer tools and code editors.
+
+![editor-dark](examples/og-editor.png)
+
+## Configuration Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `template` | `string` | `'branded'` | Template ID |
+| `title` | `string` | required | Primary title |
+| `subtitle` | `string` | - | Subtitle or description |
+| `accent` | `string` | `'#6366f1'` | Brand/accent color (hex) |
+| `accentSecondary` | `string` | - | Secondary accent color |
+| `background` | `string` | `'#0a0a0a'` | Background color |
+| `textColor` | `string` | `'#ffffff'` | Text color |
+| `output` | `string` | required | Output file path |
+| `width` | `number` | `1200` | Width in pixels |
+| `height` | `number` | `630` | Height in pixels |
+| `scale` | `number` | `2` | Device scale factor (retina) |
+| `fonts` | `string[]` | `['Inter']` | Google Fonts to load |
+| `logo` | `string` | - | Logo URL or base64 |
+| `tag` | `string` | - | Tag/chip text |
+
+## Batch Generation
+
+Generate multiple images at once:
+
+```typescript
+import { generateOGBatch } from '@arach/og'
+
+await generateOGBatch([
+  { template: 'branded', title: 'Home', output: 'og-home.png' },
+  { template: 'docs', title: 'Docs', output: 'og-docs.png' },
+])
+```
+
+## License
+
+MIT

package/dist/audit.d.ts

@@ -0,0 +1,22 @@
+export interface AuditResult {
+    url: string;
+    path: string;
+    score: number;
+    title?: string;
+    titleLength?: number;
+    description?: string;
+    descriptionLength?: number;
+    image?: string;
+    imageSize?: number;
+    imageDimensions?: string;
+    issues: string[];
+}
+export interface OGInventory {
+    baseUrl: string;
+    auditedAt: string;
+    totalPages: number;
+    averageScore: number;
+    pages: AuditResult[];
+}
+export declare function auditSite(baseUrl: string): Promise<void>;
+//# sourceMappingURL=audit.d.ts.map

package/dist/audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../src/audit.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,MAAM,EAAE,MAAM,EAAE,CAAA;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,KAAK,EAAE,WAAW,EAAE,CAAA;CACrB;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoG9D"}

package/dist/audit.js

@@ -0,0 +1,188 @@
+import { validateOG } from './validate.js';
+import { createInterface } from 'node:readline';
+import { writeFile } from 'node:fs/promises';
+export async function auditSite(baseUrl) {
+    // Normalize URL
+    const url = baseUrl.startsWith('http') ? baseUrl : `https://${baseUrl}`;
+    const base = new URL(url);
+    console.log(`\n  Auditing ${base.origin}...\n`);
+    // Try to find sitemap
+    const sitemapUrls = await findSitemap(base.origin);
+    let paths;
+    if (sitemapUrls.length > 0) {
+        console.log(`  ✓ Found sitemap with ${sitemapUrls.length} URLs\n`);
+        paths = sitemapUrls.map(u => u.loc);
+    }
+    else {
+        console.log(`  ! No sitemap found at ${base.origin}/sitemap.xml`);
+        console.log(`    Consider adding one for better SEO!\n`);
+        // Check for .og-paths file or ask user
+        paths = await getPathsFromUser(base.origin);
+    }
+    if (paths.length === 0) {
+        console.log(`  No paths to audit.\n`);
+        return;
+    }
+    console.log(`  Auditing ${paths.length} page${paths.length !== 1 ? 's' : ''}...\n`);
+    console.log(`  ${'─'.repeat(60)}\n`);
+    const results = [];
+    for (const path of paths) {
+        const fullUrl = path.startsWith('http') ? path : `${base.origin}${path.startsWith('/') ? '' : '/'}${path}`;
+        const urlPath = new URL(fullUrl).pathname;
+        process.stdout.write(`  Checking ${truncate(fullUrl, 50)}...`);
+        try {
+            const validation = await validateOG(fullUrl);
+            const titleCheck = validation.checks.find(c => c.name === 'og:title');
+            const descCheck = validation.checks.find(c => c.name === 'og:description');
+            const imageUrlCheck = validation.checks.find(c => c.name === 'og:image URL');
+            const imageSizeCheck = validation.checks.find(c => c.name === 'og:image size');
+            const imageDimsCheck = validation.checks.find(c => c.name === 'og:image dimensions');
+            const issues = validation.checks
+                .filter(c => c.status !== 'pass')
+                .map(c => c.name);
+            results.push({
+                url: fullUrl,
+                path: urlPath,
+                score: validation.score,
+                title: typeof titleCheck?.value === 'string' ? undefined : undefined,
+                titleLength: typeof titleCheck?.value === 'number' ? titleCheck.value : undefined,
+                description: typeof descCheck?.value === 'string' ? undefined : undefined,
+                descriptionLength: typeof descCheck?.value === 'number' ? descCheck.value : undefined,
+                image: typeof imageUrlCheck?.value === 'string' ? imageUrlCheck.value : undefined,
+                imageSize: typeof imageSizeCheck?.value === 'number' ? imageSizeCheck.value : undefined,
+                imageDimensions: typeof imageDimsCheck?.value === 'string' ? imageDimsCheck.value : undefined,
+                issues
+            });
+            const scoreColor = validation.score >= 80 ? '\x1b[32m' :
+                validation.score >= 50 ? '\x1b[33m' : '\x1b[31m';
+            const reset = '\x1b[0m';
+            console.log(` ${scoreColor}${validation.score}${reset}/100`);
+        }
+        catch (error) {
+            results.push({
+                url: fullUrl,
+                path: urlPath,
+                score: 0,
+                issues: ['Failed to fetch']
+            });
+            console.log(` \x1b[31mFailed\x1b[0m`);
+        }
+    }
+    // Save inventory
+    const inventory = {
+        baseUrl: base.origin,
+        auditedAt: new Date().toISOString(),
+        totalPages: results.length,
+        averageScore: Math.round(results.reduce((sum, r) => sum + r.score, 0) / results.length),
+        pages: results
+    };
+    await writeFile('.og-inventory.json', JSON.stringify(inventory, null, 2));
+    console.log(`\n  ✓ Saved inventory to .og-inventory.json`);
+    // Summary
+    console.log(`\n  ${'─'.repeat(60)}`);
+    printSummary(results);
+    console.log(`  Run \x1b[36mog viewer\x1b[0m to see the full report\n`);
+}
+async function findSitemap(origin) {
+    const sitemapLocations = [
+        '/sitemap.xml',
+        '/sitemap_index.xml',
+        '/sitemap-index.xml',
+    ];
+    // Also check robots.txt for Sitemap directive
+    try {
+        const robotsRes = await fetch(`${origin}/robots.txt`);
+        if (robotsRes.ok) {
+            const robotsTxt = await robotsRes.text();
+            const sitemapMatch = robotsTxt.match(/Sitemap:\s*(.+)/i);
+            if (sitemapMatch) {
+                sitemapLocations.unshift(new URL(sitemapMatch[1].trim(), origin).pathname);
+            }
+        }
+    }
+    catch {
+        // Ignore
+    }
+    for (const loc of sitemapLocations) {
+        try {
+            const res = await fetch(`${origin}${loc}`);
+            if (res.ok) {
+                const xml = await res.text();
+                return parseSitemap(xml, origin);
+            }
+        }
+        catch {
+            // Try next location
+        }
+    }
+    return [];
+}
+function parseSitemap(xml, origin) {
+    const urls = [];
+    // Check if it's a sitemap index
+    if (xml.includes('<sitemapindex')) {
+        // Parse sitemap index to get child sitemaps
+        const sitemapMatches = xml.matchAll(/<sitemap>[\s\S]*?<loc>(.+?)<\/loc>[\s\S]*?<\/sitemap>/gi);
+        // For simplicity, just return empty - would need to recursively fetch
+        // In a real implementation, we'd fetch each child sitemap
+        console.log(`    (Sitemap index found - using root URLs only)`);
+    }
+    // Parse URL entries
+    const urlMatches = xml.matchAll(/<url>[\s\S]*?<loc>(.+?)<\/loc>[\s\S]*?<\/url>/gi);
+    for (const match of urlMatches) {
+        const loc = match[1].trim();
+        urls.push({ loc });
+    }
+    return urls;
+}
+async function getPathsFromUser(origin) {
+    const rl = createInterface({
+        input: process.stdin,
+        output: process.stdout
+    });
+    return new Promise((resolve) => {
+        console.log(`  Enter paths to audit (comma-separated), or press Enter for just the homepage:`);
+        console.log(`  Example: /, /about, /docs, /pricing\n`);
+        rl.question('  Paths: ', (answer) => {
+            rl.close();
+            if (!answer.trim()) {
+                resolve(['/']);
+            }
+            else {
+                const paths = answer.split(',').map(p => p.trim()).filter(Boolean);
+                resolve(paths.length > 0 ? paths : ['/']);
+            }
+        });
+    });
+}
+function printSummary(results) {
+    const total = results.length;
+    const perfect = results.filter(r => r.score >= 90).length;
+    const good = results.filter(r => r.score >= 70 && r.score < 90).length;
+    const needsWork = results.filter(r => r.score < 70).length;
+    const avgScore = Math.round(results.reduce((sum, r) => sum + r.score, 0) / total);
+    console.log(`\n  Summary`);
+    console.log(`  ${'─'.repeat(30)}`);
+    console.log(`  Total pages:    ${total}`);
+    console.log(`  Average score:  ${avgScore}/100`);
+    console.log(``);
+    console.log(`  \x1b[32m●\x1b[0m Perfect (90+):  ${perfect}`);
+    console.log(`  \x1b[33m●\x1b[0m Good (70-89):   ${good}`);
+    console.log(`  \x1b[31m●\x1b[0m Needs work:     ${needsWork}`);
+    if (needsWork > 0) {
+        console.log(`\n  Pages needing attention:`);
+        for (const r of results.filter(r => r.score < 70)) {
+            console.log(`    • ${truncate(r.url, 40)} (${r.score}/100)`);
+            if (r.issues.length > 0) {
+                console.log(`      Issues: ${r.issues.join(', ')}`);
+            }
+        }
+    }
+    console.log(``);
+}
+function truncate(str, len) {
+    if (str.length <= len)
+        return str;
+    return str.slice(0, len - 3) + '...';
+}
+//# sourceMappingURL=audit.js.map

package/dist/audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.js","sourceRoot":"","sources":["../src/audit.ts"],"names":[],"mappings":"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"}

package/dist/cli.js

@@ -2,37 +2,107 @@
 import { readFile } from 'node:fs/promises';
 import { resolve } from 'node:path';
 import { generateOG, generateOGBatch } from './generate.js';
+import { validateOG, formatValidationResult } from './validate.js';
+import { startViewer } from './viewer.js';
+import { auditSite } from './audit.js';
 async function main() {
     const args = process.argv.slice(2);
     if (args.length === 0 || args.includes('--help') || args.includes('-h')) {
-        console.log(`
-@arach/og - Declarative OG image generation
+        printHelp();
+        process.exit(0);
+    }
+    const command = args[0];
+    // Validate command
+    if (command === 'validate') {
+        const url = args[1];
+        if (!url) {
+            console.error('Error: Please provide a URL to validate');
+            console.error('Usage: og validate <url>');
+            process.exit(1);
+        }
+        try {
+            const targetUrl = url.startsWith('http') ? url : `https://${url}`;
+            console.log(`\nValidating ${targetUrl}...`);
+            const result = await validateOG(targetUrl);
+            console.log(formatValidationResult(result));
+            process.exit(result.score >= 70 ? 0 : 1);
+        }
+        catch (error) {
+            console.error('Error:', error instanceof Error ? error.message : error);
+            process.exit(1);
+        }
+    }
+    // Audit command
+    if (command === 'audit') {
+        const url = args[1];
+        if (!url) {
+            console.error('Error: Please provide a URL to audit');
+            console.error('Usage: og audit <url>');
+            process.exit(1);
+        }
+        await auditSite(url);
+        return;
+    }
+    // Init command - add paths manually for local dev
+    if (command === 'init') {
+        const paths = args.slice(1);
+        if (paths.length === 0) {
+            console.log(`
+  Usage: og init <paths...>
 
-Usage:
-  og <config.json>     Generate OG images from a config file
-  og --help            Show this help message
+  Add paths to your OG inventory for local development.
 
-Config file format:
-  Single image:
-  {
-    "template": "branded",
-    "title": "My App",
-    "subtitle": "Do amazing things",
-    "accent": "#f07c4f",
-    "output": "public/og-image.png"
-  }
-
-  Multiple images:
-  [
-    { "title": "Home", "output": "public/og-home.png" },
-    { "title": "Docs", "template": "docs", "output": "public/og-docs.png" }
-  ]
+  Examples:
+    og init / /about /pricing /docs
+    og init /blog/post-1 /blog/post-2
 
-Templates: branded, docs, minimal, editor-dark
+  This creates .og-inventory.json which og viewer uses.
 `);
-        process.exit(0);
+            process.exit(0);
+        }
+        const { writeFile, readFile } = await import('node:fs/promises');
+        let inventory;
+        try {
+            const existing = await readFile('.og-inventory.json', 'utf-8');
+            inventory = JSON.parse(existing);
+        }
+        catch {
+            inventory = {
+                baseUrl: 'local',
+                auditedAt: new Date().toISOString(),
+                totalPages: 0,
+                averageScore: 0,
+                pages: []
+            };
+        }
+        for (const path of paths) {
+            const normalizedPath = path.startsWith('/') ? path : `/${path}`;
+            if (!inventory.pages.find(p => p.path === normalizedPath)) {
+                inventory.pages.push({
+                    url: `local://${normalizedPath}`,
+                    path: normalizedPath,
+                    score: 0,
+                    issues: ['Not audited yet']
+                });
+            }
+        }
+        inventory.totalPages = inventory.pages.length;
+        inventory.auditedAt = new Date().toISOString();
+        await writeFile('.og-inventory.json', JSON.stringify(inventory, null, 2));
+        console.log(`\n  ✓ Added ${paths.length} path(s) to .og-inventory.json`);
+        console.log(`  Total paths: ${inventory.pages.length}\n`);
+        console.log(`  Run \x1b[36mog viewer\x1b[0m to see your inventory\n`);
+        return;
     }
-    const configPath = resolve(process.cwd(), args[0]);
+    // Viewer command
+    if (command === 'viewer') {
+        const dir = args[1] ? resolve(process.cwd(), args[1]) : process.cwd();
+        const port = args.includes('--port') ? parseInt(args[args.indexOf('--port') + 1]) : 3333;
+        await startViewer(dir, port);
+        return;
+    }
+    // Generate command (default)
+    const configPath = resolve(process.cwd(), command);
     try {
         const content = await readFile(configPath, 'utf-8');
         const config = JSON.parse(content);
@@ -49,5 +119,66 @@ Templates: branded, docs, minimal, editor-dark
         process.exit(1);
     }
 }
+function printHelp() {
+    console.log(`
+@arach/og - Declarative OG image generation
+
+Usage:
+  og <config.json>        Generate OG images from a config file
+  og validate <url>       Validate OG tags on a single URL
+  og audit <url>          Audit all pages on a site (uses sitemap)
+  og init <paths...>      Add paths to inventory for local dev
+  og viewer               Launch local viewer for OG inventory
+  og --help               Show this help message
+
+Workflow:
+  1. Audit a live site:     og audit mysite.com
+     Or init paths locally: og init / /about /docs /pricing
+
+  2. View your inventory:   og viewer
+
+  3. Generate images:       og config.json
+
+Audit:
+  Scan a website's sitemap and audit OG tags for each page.
+
+  $ og audit https://mysite.com
+  $ og audit mysite.com
+
+  If no sitemap found, prompts for paths to audit.
+  Saves results to .og-inventory.json
+
+Init:
+  Add paths manually for local development (no live site needed).
+
+  $ og init / /about /pricing /docs
+  $ og init /blog/post-1 /blog/post-2
+
+  Creates/updates .og-inventory.json
+
+Viewer:
+  Launch local viewer to see your OG inventory.
+
+  $ og viewer
+  $ og viewer --port 4000
+
+Validate:
+  Quick check of a single URL's OG tags.
+
+  $ og validate https://example.com/page
+
+Generate:
+  Create OG images from a JSON config file.
+
+  {
+    "template": "branded",
+    "title": "My App",
+    "subtitle": "Do amazing things",
+    "output": "public/og.png"
+  }
+
+Templates: branded, docs, minimal, editor-dark
+`);
+}
 main();
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAG3D,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IAElC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACxE,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;CAwBf,CAAC,CAAA;QACE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;IAElD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;QACnD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAA0B,CAAA;QAE3D,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,MAAM,eAAe,CAAC,MAAM,CAAC,CAAA;QAC/B,CAAC;aAAM,CAAC;YACN,MAAM,UAAU,CAAC,MAAM,CAAC,CAAA;QAC1B,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;IAC1B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;QACvE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAA"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,4 +1,6 @@
 export { generateOG, generateOGBatch } from './generate.js';
+export { validateOG, formatValidationResult } from './validate.js';
 export { templates } from './templates/index.js';
 export type { OGConfig, TemplateId, TemplateContext, TemplateFunction } from './types.js';
+export type { ValidationResult, ValidationCheck } from './validate.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAChD,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC3D,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAA;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAChD,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AACzF,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA"}

package/dist/index.js

@@ -1,3 +1,4 @@
 export { generateOG, generateOGBatch } from './generate.js';
+export { validateOG, formatValidationResult } from './validate.js';
 export { templates } from './templates/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC3D,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAA;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/templates/branded.d.ts

@@ -1,6 +1,6 @@
 import type { TemplateFunction } from '../types.js';
 /**
- * Branded template - full featured with grid overlay, gradient glows, and tag
+ * Branded template - full featured with grid overlay, corner crosses, and refined typography
  */
 export declare const branded: TemplateFunction;
 //# sourceMappingURL=branded.d.ts.map

package/dist/templates/branded.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"branded.d.ts","sourceRoot":"","sources":["../../src/templates/branded.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAEnD;;GAEG;AACH,eAAO,MAAM,OAAO,EAAE,gBAqHrB,CAAA"}
+{"version":3,"file":"branded.d.ts","sourceRoot":"","sources":["../../src/templates/branded.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAEnD;;GAEG;AACH,eAAO,MAAM,OAAO,EAAE,gBA2JrB,CAAA"}