@happyvertical/images 0.74.8

package/AGENT.md

@@ -0,0 +1,33 @@
+# @happyvertical/images
+
+<!-- BEGIN AGENT:GENERATED -->
+## Purpose
+Image processing utilities with adapter pattern for scaling from static to enterprise
+
+## Package Map
+- Package: `@happyvertical/images`
+- Hierarchy path: `@happyvertical/sdk > packages > images`
+- Workspace position: `15 of 30` local packages
+- Internal dependencies: none
+- Internal dependents: `@happyvertical/video`
+- Knowledge graph files: `AGENT.md`, `metadata.json`, `ecosystem-manifest.json`
+
+## Build & Test
+```bash
+pnpm --filter @happyvertical/images build
+pnpm --filter @happyvertical/images test
+pnpm --filter @happyvertical/images clean
+```
+
+## Agent Correction Loops
+- If Vite or TypeScript reports missing packages, run `pnpm install` at the repo root and rerun `pnpm --filter @happyvertical/images build`.
+- If tests or exports fail after API, type, or bundle changes, run `pnpm --filter @happyvertical/images clean` followed by `pnpm --filter @happyvertical/images build` and `pnpm --filter @happyvertical/images test`.
+- If failures span multiple packages or Turborepo ordering looks wrong, run `pnpm build` and `pnpm typecheck` from the repo root before retrying package-scoped commands.
+
+## Ecosystem Relationships
+- Provides: Image processing utilities with adapter pattern for scaling from static to enterprise
+- Implements: none
+- Requires: @resvg/resvg-js, jimp, satori, sharp
+- Stability: stable (Primary package surface is described as implemented and production-oriented.)
+<!-- END AGENT:GENERATED -->
+

package/LICENSE

@@ -0,0 +1,7 @@
+Copyright <2025> <Happy Vertical Corporation>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/dist/adapters/imgproxy.d.ts

@@ -0,0 +1,176 @@
+import { ConvertOptions, HashAlgorithm, ImageDimensions, ImageInput, ImageMetadata, ImageProcessorInterface, ImgproxyOptions, ResizeOptions, ThumbnailOptions } from '../shared/types.js';
+/**
+ * Options for generating signed imgproxy URLs
+ */
+export interface SignedUrlOptions {
+    /**
+     * Width in pixels (0 for auto)
+     */
+    width?: number;
+    /**
+     * Height in pixels (0 for auto)
+     */
+    height?: number;
+    /**
+     * Resize mode
+     * - 'cover': Fill dimensions, crop excess
+     * - 'contain': Fit within dimensions, may have empty space
+     * - 'fill': Force exact dimensions (may distort)
+     */
+    fit?: 'cover' | 'contain' | 'fill' | 'inside' | 'outside';
+    /**
+     * Output quality (1-100)
+     */
+    quality?: number;
+    /**
+     * Output format (jpeg, png, webp, avif, etc.)
+     */
+    format?: string;
+}
+/**
+ * Generate a signed imgproxy URL
+ *
+ * Standalone function for generating signed URLs without creating an adapter instance.
+ * Useful for client-side usage or when you only need URL generation.
+ *
+ * @param source - Source image URL (must be http/https)
+ * @param config - imgproxy server configuration
+ * @param options - Processing options
+ * @returns Signed imgproxy URL
+ *
+ * @example
+ * ```typescript
+ * import { signImgproxyUrl } from '@happyvertical/images';
+ *
+ * const url = signImgproxyUrl(
+ *   'https://example.com/image.jpg',
+ *   {
+ *     baseUrl: 'https://imgproxy.example.com',
+ *     key: 'hex-encoded-key',
+ *     salt: 'hex-encoded-salt'
+ *   },
+ *   { width: 300, height: 200, format: 'webp' }
+ * );
+ * ```
+ */
+export declare function signImgproxyUrl(source: string, config: {
+    baseUrl: string;
+    key?: string;
+    salt?: string;
+}, options?: SignedUrlOptions): string;
+/**
+ * imgproxy adapter for remote image processing
+ *
+ * Offloads image processing to a self-hosted imgproxy server.
+ * Supports URL signing for secure access.
+ *
+ * Features:
+ * - Scalable remote processing
+ * - URL-based API
+ * - Signed URLs for security
+ * - CDN-friendly outputs
+ *
+ * Limitations:
+ * - Requires network access to imgproxy server
+ * - Input must be accessible via URL (not local paths)
+ * - Hash computation not directly supported (requires fetching image)
+ *
+ * @example
+ * ```typescript
+ * const processor = new ImgproxyAdapter({
+ *   type: 'imgproxy',
+ *   baseUrl: 'https://imgproxy.example.com',
+ *   key: 'hex-encoded-key',
+ *   salt: 'hex-encoded-salt'
+ * });
+ *
+ * await processor.thumbnail(
+ *   'https://example.com/image.jpg',
+ *   '/tmp/thumb.jpg',
+ *   { maxWidth: 300 }
+ * );
+ * ```
+ */
+export declare class ImgproxyAdapter implements ImageProcessorInterface {
+    private baseUrl;
+    private key?;
+    private salt?;
+    constructor(options: ImgproxyOptions);
+    /**
+     * Generate a signed imgproxy URL without fetching the image
+     *
+     * This is useful for:
+     * - Client-side usage where you want to display images directly
+     * - Debugging URL signing issues
+     * - Pre-generating URLs for batch processing
+     *
+     * @param source - Source image URL (must be http/https)
+     * @param options - Processing options
+     * @returns Signed imgproxy URL
+     *
+     * @example
+     * ```typescript
+     * const adapter = new ImgproxyAdapter({
+     *   type: 'imgproxy',
+     *   baseUrl: 'https://imgproxy.example.com',
+     *   key: 'hex-key',
+     *   salt: 'hex-salt'
+     * });
+     *
+     * // Generate thumbnail URL
+     * const url = adapter.getSignedUrl('https://example.com/image.jpg', {
+     *   width: 300,
+     *   height: 200,
+     *   fit: 'cover',
+     *   format: 'webp'
+     * });
+     * // Returns: https://imgproxy.example.com/SIGNATURE/rs:fill:300:200/aHR0cHM6Ly9.../image.webp
+     * ```
+     */
+    getSignedUrl(source: string, options?: {
+        width?: number;
+        height?: number;
+        fit?: 'cover' | 'contain' | 'fill' | 'inside' | 'outside';
+        quality?: number;
+        format?: string;
+    }): string;
+    /**
+     * Sign a path using HMAC-SHA256
+     */
+    private sign;
+    /**
+     * Encode source URL for imgproxy
+     */
+    private encodeSource;
+    /**
+     * Build imgproxy URL
+     */
+    private buildUrl;
+    /**
+     * Convert ImageInput to URL string
+     */
+    private toUrl;
+    getDimensions(input: ImageInput): Promise<ImageDimensions>;
+    thumbnail(input: ImageInput, output: string, options?: ThumbnailOptions): Promise<void>;
+    convert(input: ImageInput, output: string, options?: ConvertOptions): Promise<void>;
+    getMetadata(input: ImageInput): Promise<ImageMetadata>;
+    hash(_input: ImageInput, _algorithm?: HashAlgorithm): Promise<string>;
+    resize(input: ImageInput, output: string, options: ResizeOptions): Promise<void>;
+    /**
+     * Build imgproxy processing string
+     */
+    private buildProcessingString;
+    /**
+     * Map fit mode to imgproxy resize type
+     */
+    private mapFitToResizeType;
+    /**
+     * Fetch image from imgproxy and save to file
+     */
+    private fetchAndSave;
+    /**
+     * Infer image format from file extension
+     */
+    private inferFormat;
+}
+//# sourceMappingURL=imgproxy.d.ts.map

package/dist/adapters/imgproxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imgproxy.d.ts","sourceRoot":"","sources":["../../src/adapters/imgproxy.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,eAAe,EAEf,UAAU,EACV,aAAa,EACb,uBAAuB,EACvB,eAAe,EACf,aAAa,EACb,gBAAgB,EACjB,MAAM,oBAAoB,CAAC;AAE5B;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;OAKG;IACH,GAAG,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IAE1D;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE;IACN,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,EACD,OAAO,GAAE,gBAAqB,GAC7B,MAAM,CAQR;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAAa,eAAgB,YAAW,uBAAuB;IAC7D,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,GAAG,CAAC,CAAS;IACrB,OAAO,CAAC,IAAI,CAAC,CAAS;gBAEV,OAAO,EAAE,eAAe;IASpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,YAAY,CACV,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,GAAG,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;QAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;KACZ,GACL,MAAM;IAsBT;;OAEG;IACH,OAAO,CAAC,IAAI;IAkBZ;;OAEG;IACH,OAAO,CAAC,YAAY;IASpB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAYhB;;OAEG;IACH,OAAO,CAAC,KAAK;IAqBP,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,eAAe,CAAC;IAoC1D,SAAS,CACb,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC;IA+BV,OAAO,CACX,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC;IA2BV,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC;IAwCtD,IAAI,CACR,MAAM,EAAE,UAAU,EAClB,UAAU,GAAE,aAA4B,GACvC,OAAO,CAAC,MAAM,CAAC;IASZ,MAAM,CACV,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,IAAI,CAAC;IAkChB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA0B7B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAW1B;;OAEG;YACW,YAAY;IAiB1B;;OAEG;IACH,OAAO,CAAC,WAAW;CAcpB"}

package/dist/adapters/jimp.d.ts

@@ -0,0 +1,66 @@
+import { ConvertOptions, HashAlgorithm, ImageDimensions, ImageInput, ImageMetadata, ImageProcessorInterface, JimpOptions, ResizeOptions, ThumbnailOptions } from '../shared/types.js';
+/**
+ * Jimp adapter for pure JavaScript image processing
+ *
+ * Provides a fallback option when Sharp (native library) is not available.
+ * Useful for:
+ * - Serverless environments (AWS Lambda, Vercel Edge)
+ * - Environments without native compilation support
+ * - Cross-platform compatibility
+ *
+ * Limitations compared to Sharp:
+ * - Slower processing speed
+ * - Limited EXIF/metadata extraction
+ * - No AVIF support
+ *
+ * @example
+ * ```typescript
+ * const processor = new JimpAdapter();
+ * const dims = await processor.getDimensions('/path/to/image.jpg');
+ * console.log(dims); // { width: 1920, height: 1080 }
+ * ```
+ */
+export declare class JimpAdapter implements ImageProcessorInterface {
+    private jimpStatic;
+    private options;
+    /**
+     * Create a new Jimp adapter
+     * @param options - Jimp adapter options
+     */
+    constructor(options?: JimpOptions);
+    /**
+     * Lazily load Jimp module
+     */
+    private getJimp;
+    getDimensions(input: ImageInput): Promise<ImageDimensions>;
+    thumbnail(input: ImageInput, output: string, options?: ThumbnailOptions): Promise<void>;
+    convert(input: ImageInput, output: string, options?: ConvertOptions): Promise<void>;
+    getMetadata(input: ImageInput): Promise<ImageMetadata>;
+    hash(input: ImageInput, algorithm?: HashAlgorithm): Promise<string>;
+    resize(input: ImageInput, output: string, options: ResizeOptions): Promise<void>;
+    /**
+     * Write image with quality settings based on output format
+     */
+    private writeWithOptions;
+    /**
+     * Infer image format from file extension
+     */
+    private inferFormat;
+    /**
+     * Get MIME type from format
+     */
+    private mimeFromFormat;
+    /**
+     * Get format from MIME type
+     */
+    private formatFromMime;
+    /**
+     * Try to determine MIME type from input
+     */
+    private getMimeFromInput;
+    /**
+     * Map Jimp errors to our error types
+     */
+    private mapError;
+}
+//# sourceMappingURL=jimp.d.ts.map

package/dist/adapters/jimp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jimp.d.ts","sourceRoot":"","sources":["../../src/adapters/jimp.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,eAAe,EAEf,UAAU,EACV,aAAa,EACb,uBAAuB,EACvB,WAAW,EACX,aAAa,EACb,gBAAgB,EACjB,MAAM,oBAAoB,CAAC;AA6B5B;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,WAAY,YAAW,uBAAuB;IACzD,OAAO,CAAC,UAAU,CAA2B;IAE7C,OAAO,CAAC,OAAO,CAAc;IAE7B;;;OAGG;gBACS,OAAO,GAAE,WAA8B;IAInD;;OAEG;YACW,OAAO;IAgBf,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,eAAe,CAAC;IAU1D,SAAS,CACb,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC;IAgCV,OAAO,CACX,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC;IAUV,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC;IAqBtD,IAAI,CACR,KAAK,EAAE,UAAU,EACjB,SAAS,GAAE,aAA4B,GACtC,OAAO,CAAC,MAAM,CAAC;IAwCZ,MAAM,CACV,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,IAAI,CAAC;IA8BhB;;OAEG;YACW,gBAAgB;IAoB9B;;OAEG;IACH,OAAO,CAAC,WAAW;IAgBnB;;OAEG;IACH,OAAO,CAAC,cAAc;IAYtB;;OAEG;IACH,OAAO,CAAC,cAAc;IAYtB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAUxB;;OAEG;IACH,OAAO,CAAC,QAAQ;CA0BjB"}

package/dist/adapters/sharp.d.ts

@@ -0,0 +1,56 @@
+import { ConvertOptions, HashAlgorithm, ImageDimensions, ImageInput, ImageMetadata, ImageProcessorInterface, ResizeOptions, SharpOptions, ThumbnailOptions } from '../shared/types.js';
+/**
+ * Sharp adapter for high-performance image processing
+ *
+ * Uses the native sharp library which provides:
+ * - Fast image resizing and format conversion
+ * - Rich metadata extraction including EXIF, IPTC, XMP
+ * - Perceptual hashing for image deduplication
+ *
+ * @example
+ * ```typescript
+ * const processor = new SharpAdapter();
+ * const dims = await processor.getDimensions('/path/to/image.jpg');
+ * console.log(dims); // { width: 1920, height: 1080 }
+ * ```
+ */
+export declare class SharpAdapter implements ImageProcessorInterface {
+    private sharp;
+    private options;
+    /**
+     * Create a new Sharp adapter
+     * @param options - Sharp adapter options
+     */
+    constructor(options?: SharpOptions);
+    /**
+     * Lazily load sharp module
+     */
+    private getSharp;
+    getDimensions(input: ImageInput): Promise<ImageDimensions>;
+    thumbnail(input: ImageInput, output: string, options?: ThumbnailOptions): Promise<void>;
+    convert(input: ImageInput, output: string, options?: ConvertOptions): Promise<void>;
+    getMetadata(input: ImageInput): Promise<ImageMetadata>;
+    hash(input: ImageInput, algorithm?: HashAlgorithm): Promise<string>;
+    resize(input: ImageInput, output: string, options: ResizeOptions): Promise<void>;
+    /**
+     * Infer image format from file extension
+     */
+    private inferFormat;
+    /**
+     * Parse EXIF buffer to object (basic parsing)
+     */
+    private parseExifBuffer;
+    /**
+     * Parse IPTC buffer to object (basic parsing)
+     */
+    private parseIptcBuffer;
+    /**
+     * Parse XMP buffer to object (basic parsing)
+     */
+    private parseXmpBuffer;
+    /**
+     * Map sharp errors to our error types
+     */
+    private mapError;
+}
+//# sourceMappingURL=sharp.d.ts.map

package/dist/adapters/sharp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sharp.d.ts","sourceRoot":"","sources":["../../src/adapters/sharp.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,eAAe,EAEf,UAAU,EACV,aAAa,EACb,uBAAuB,EACvB,aAAa,EACb,YAAY,EACZ,gBAAgB,EACjB,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;;;;;;;;GAcG;AACH,qBAAa,YAAa,YAAW,uBAAuB;IAC1D,OAAO,CAAC,KAAK,CAAuC;IAEpD,OAAO,CAAC,OAAO,CAAe;IAE9B;;;OAGG;gBACS,OAAO,GAAE,YAAiB;IAItC;;OAEG;YACW,QAAQ;IAehB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,eAAe,CAAC;IAiB1D,SAAS,CACb,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC;IA0BV,OAAO,CACX,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC;IAYV,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC;IA2BtD,IAAI,CACR,KAAK,EAAE,UAAU,EACjB,SAAS,GAAE,aAA4B,GACtC,OAAO,CAAC,MAAM,CAAC;IA6BZ,MAAM,CACV,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,IAAI,CAAC;IAwBhB;;OAEG;IACH,OAAO,CAAC,WAAW;IAenB;;OAEG;IACH,OAAO,CAAC,eAAe;IAKvB;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;OAEG;IACH,OAAO,CAAC,cAAc;IAUtB;;OAEG;IACH,OAAO,CAAC,QAAQ;CAmBjB"}

package/dist/cli/claude-context.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=claude-context.d.ts.map

package/dist/cli/claude-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-context.d.ts","sourceRoot":"","sources":["../../src/cli/claude-context.ts"],"names":[],"mappings":""}

package/dist/cli/claude-context.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+import { existsSync, mkdirSync, copyFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+const Dirname = dirname(fileURLToPath(import.meta.url));
+const pkgRoot = join(Dirname, "../..");
+const targetDir = join(process.cwd(), ".claude");
+if (!existsSync(targetDir)) {
+  mkdirSync(targetDir, { recursive: true });
+}
+const pkgName = "images";
+const agentMdSrc = existsSync(join(pkgRoot, "AGENT.md")) ? join(pkgRoot, "AGENT.md") : join(pkgRoot, "CLAUDE.md");
+const metaSrc = existsSync(join(pkgRoot, "metadata.json")) ? join(pkgRoot, "metadata.json") : join(pkgRoot, ".claude-meta.json");
+if (existsSync(agentMdSrc)) {
+  copyFileSync(agentMdSrc, join(targetDir, `have-${pkgName}.md`));
+}
+if (existsSync(metaSrc)) {
+  copyFileSync(metaSrc, join(targetDir, `have-${pkgName}.meta.json`));
+}
+console.log(`✓ Installed @happyvertical/${pkgName} context to .claude/`);
+//# sourceMappingURL=claude-context.js.map

package/dist/cli/claude-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-context.js","sources":["../../src/cli/claude-context.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * CLI script to install agent context for @happyvertical/images\n * Run the published context installer binary for this package.\n */\nimport { copyFileSync, existsSync, mkdirSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nconst Dirname = dirname(fileURLToPath(import.meta.url));\nconst pkgRoot = join(Dirname, '../..');\nconst targetDir = join(process.cwd(), '.claude');\n\nif (!existsSync(targetDir)) {\n  mkdirSync(targetDir, { recursive: true });\n}\n\nconst pkgName = 'images';\nconst agentMdSrc = existsSync(join(pkgRoot, 'AGENT.md'))\n  ? join(pkgRoot, 'AGENT.md')\n  : join(pkgRoot, 'CLAUDE.md');\nconst metaSrc = existsSync(join(pkgRoot, 'metadata.json'))\n  ? join(pkgRoot, 'metadata.json')\n  : join(pkgRoot, '.claude-meta.json');\n\nif (existsSync(agentMdSrc)) {\n  copyFileSync(agentMdSrc, join(targetDir, `have-${pkgName}.md`));\n}\n\nif (existsSync(metaSrc)) {\n  copyFileSync(metaSrc, join(targetDir, `have-${pkgName}.meta.json`));\n}\n\nconsole.log(`✓ Installed @happyvertical/${pkgName} context to .claude/`);\n"],"names":[],"mappings":";;;;AASA,MAAM,UAAU,QAAQ,cAAc,YAAY,GAAG,CAAC;AACtD,MAAM,UAAU,KAAK,SAAS,OAAO;AACrC,MAAM,YAAY,KAAK,QAAQ,IAAA,GAAO,SAAS;AAE/C,IAAI,CAAC,WAAW,SAAS,GAAG;AAC1B,YAAU,WAAW,EAAE,WAAW,KAAA,CAAM;AAC1C;AAEA,MAAM,UAAU;AAChB,MAAM,aAAa,WAAW,KAAK,SAAS,UAAU,CAAC,IACnD,KAAK,SAAS,UAAU,IACxB,KAAK,SAAS,WAAW;AAC7B,MAAM,UAAU,WAAW,KAAK,SAAS,eAAe,CAAC,IACrD,KAAK,SAAS,eAAe,IAC7B,KAAK,SAAS,mBAAmB;AAErC,IAAI,WAAW,UAAU,GAAG;AAC1B,eAAa,YAAY,KAAK,WAAW,QAAQ,OAAO,KAAK,CAAC;AAChE;AAEA,IAAI,WAAW,OAAO,GAAG;AACvB,eAAa,SAAS,KAAK,WAAW,QAAQ,OAAO,YAAY,CAAC;AACpE;AAEA,QAAQ,IAAI,8BAA8B,OAAO,sBAAsB;"}

package/dist/headline-card.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Headline Card Generator
+ *
+ * Generates branded social media / OG images with article titles.
+ * Uses Satori (Vercel's JSX-to-SVG) and resvg for PNG output.
+ *
+ * @example
+ * ```typescript
+ * import { generateHeadlineCard } from '@happyvertical/images';
+ *
+ * const result = await generateHeadlineCard('Breaking: Major Discovery', {
+ *   brandColor: '#1a56db',
+ *   subtitle: 'Science News',
+ *   template: 'news'
+ * });
+ *
+ * await writeFile('og-image.png', result.buffer);
+ * ```
+ */
+/**
+ * Template style for headline cards
+ */
+export type HeadlineCardTemplate = 'default' | 'news' | 'minimal';
+/**
+ * Options for headline card generation
+ */
+export interface HeadlineCardOptions {
+    /**
+     * Width in pixels
+     * @default 1200
+     */
+    width?: number;
+    /**
+     * Height in pixels
+     * @default 630
+     */
+    height?: number;
+    /**
+     * Primary brand color (hex)
+     * @default '#3b82f6'
+     */
+    brandColor?: string;
+    /**
+     * Background color (hex)
+     * @default '#ffffff'
+     */
+    backgroundColor?: string;
+    /**
+     * Secondary text color (hex)
+     * @default '#64748b'
+     */
+    textColor?: string;
+    /**
+     * Optional subtitle/category
+     */
+    subtitle?: string;
+    /**
+     * Optional logo URL (will be fetched and embedded)
+     */
+    logoUrl?: string;
+    /**
+     * Logo data as base64 or buffer (alternative to logoUrl)
+     */
+    logoData?: string | Buffer;
+    /**
+     * Card template style
+     * @default 'default'
+     */
+    template?: HeadlineCardTemplate;
+    /**
+     * Font family name (must be available via Google Fonts or provide fontData)
+     * @default 'Inter'
+     */
+    fontFamily?: string;
+    /**
+     * Custom font data (loaded font buffer)
+     */
+    fontData?: ArrayBuffer;
+}
+/**
+ * Result from headline card generation
+ */
+export interface HeadlineCardResult {
+    /** PNG image buffer */
+    buffer: Buffer;
+    /** Image width */
+    width: number;
+    /** Image height */
+    height: number;
+    /** MIME type (always image/png) */
+    mimeType: 'image/png';
+}
+/**
+ * Generate a headline card image
+ *
+ * Creates a branded social media / OG image with the article title.
+ * Supports multiple templates and customization options.
+ *
+ * @param title - The headline text to display
+ * @param options - Customization options
+ * @returns Promise resolving to PNG image result
+ *
+ * @example Basic usage
+ * ```typescript
+ * const result = await generateHeadlineCard('Breaking News: AI Advances');
+ * await fs.writeFile('og-image.png', result.buffer);
+ * ```
+ *
+ * @example With branding
+ * ```typescript
+ * const result = await generateHeadlineCard('Local Council Approves Budget', {
+ *   brandColor: '#1a56db',
+ *   subtitle: 'Town News',
+ *   template: 'news'
+ * });
+ * ```
+ *
+ * @example Full customization
+ * ```typescript
+ * const result = await generateHeadlineCard('The Future of Technology', {
+ *   width: 1200,
+ *   height: 630,
+ *   brandColor: '#059669',
+ *   backgroundColor: '#f8fafc',
+ *   subtitle: 'Technology',
+ *   template: 'minimal',
+ *   fontFamily: 'Roboto'
+ * });
+ * ```
+ */
+export declare function generateHeadlineCard(title: string, options?: HeadlineCardOptions): Promise<HeadlineCardResult>;
+/**
+ * Reset cached font data (useful for testing)
+ */
+export declare function resetFontCache(): void;
+//# sourceMappingURL=headline-card.d.ts.map

package/dist/headline-card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headline-card.d.ts","sourceRoot":"","sources":["../src/headline-card.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AA2BH;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAE3B;;;OAGG;IACH,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAEhC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,EAAE,WAAW,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,QAAQ,EAAE,WAAW,CAAC;CACvB;AAoWD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,kBAAkB,CAAC,CAsF7B;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAGrC"}