@happyvertical/smrt-images 0.30.0

package/AGENTS.md

@@ -0,0 +1,48 @@
+# @happyvertical/smrt-images
+
+Image management with AI categorization, editing, and metadata extraction. Extends Asset via cross-package STI.
+
+## Models
+
+- **Image**: STI subclass of Asset (from smrt-assets) — stored in same `assets` table with `_meta_type='Image'`. Adds `width`, `height`, `alt` text.
+
+## Key Services
+
+- **ImageCollection**: dimension/orientation filters — `getByMinDimensions()`, `getByAspectRatio()`, `getLandscape()`, `getPortrait()`, `getSquare()`, `getHighResolution()`, `getMissingAltText()`
+- **ImageMetadataExtractor**: dimensions, format, EXIF from buffers (via `@happyvertical/images`)
+- **ImageCategorizer**: AI vision analysis → tags, description, confidence, subjects (via `@happyvertical/ai`)
+- **ImageEditor**: resize/crop/convert/thumbnail + AI editing. Creates new Image records with `parentId` linking to source.
+- **ImageDeriver**: creates derived images and, when requested, records source provenance through generic `AssetAssociation` links
+- **ImageSearch**: text search across name/description/alt with orientation filters
+- **UpstreamManager**: import from external providers with provenance tracking
+
+## AI Operations
+
+`generateAltText()` uses the `smrtImages.image.generateAltText` prompt registered via `@happyvertical/smrt-prompts` (resolves tenant overrides via `resolvePrompt()` then dispatches through `getAiClient().message()`). Computed properties: `isLandscape`, `isPortrait`, `aspectRatio`.
+
+## Prompt Registry
+
+`Image.generateAltText()` is registered with `@happyvertical/smrt-prompts` so tenants can override template/model/params at runtime:
+
+```typescript
+import { smrtImagesGenerateAltTextPrompt } from '@happyvertical/smrt-images';
+// key: 'smrtImages.image.generateAltText'
+```
+
+Only non-PII metadata fields are passed to the AI provider: `name`, `description`. Source URIs, internal foreign-key fields (`parentId`, `tenantId`), and the extensible `metadata` blob are intentionally excluded — source URIs may embed signed/private bucket paths and `metadata` may contain EXIF GPS data or tenant-private configuration.
+
+## UI Registry
+
+Svelte components auto-register with `ModuleUIRegistry` on import of `@happyvertical/smrt-images/svelte`. UI slot declarations live in `src/ui.ts` and are exported via `@happyvertical/smrt-images/ui`:
+
+- `assets-gallery` — `AssetsGallery.svelte`
+- `image-editor` — `ImageEditor.svelte`
+- `image-uploader` — `ImageUploader.svelte`
+
+## Gotchas
+
+- **Cross-package STI**: Image extends Asset from different package — fragile if Asset schema changes
+- **AssetAssociation usage is intentional here**: image derivation uses it for provenance, not for base-model-owned asset storage
+- **Editor bypasses collection.create()**: creates Image instances directly (skips collection validation)
+- **Derivative creation**: 3 DB calls — `collection.create()` + `store.storeFile()` + `save()`
+- **Orientation filtering is in-memory**: queries all images, then filters by dimensions

package/CLAUDE.md

@@ -0,0 +1 @@
+@AGENTS.md

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/README.md

@@ -0,0 +1,92 @@
+# @happyvertical/smrt-images
+
+Image asset management with AI-powered categorization, editing, and metadata extraction for the SMRT framework. Extends `Asset` from smrt-assets via cross-package STI -- stored in the same `assets` table with a distinct `_meta_type`.
+
+## Installation
+
+```bash
+pnpm add @happyvertical/smrt-images
+```
+
+## Usage
+
+```typescript
+import {
+  Image, ImageCollection,
+  ImageCategorizer, ImageEditor, ImageDeriver,
+  ImageMetadataExtractor, ImageSearch, UpstreamManager,
+} from '@happyvertical/smrt-images';
+
+// Create and query images
+const images = new ImageCollection(db);
+const image = await images.create({
+  name: 'hero.jpg',
+  url: 'https://cdn.example.com/hero.jpg',
+  mimeType: 'image/jpeg',
+  width: 1920,
+  height: 1080,
+});
+await image.save();
+
+// Computed properties from dimensions
+image.isLandscape;  // true
+image.aspectRatio;  // 1.778
+image.isHighResolution();  // false (below 4K)
+
+// AI-powered categorization (returns tags, description, confidence, subjects)
+const categorizer = new ImageCategorizer({ ai: aiConfig });
+const result = await categorizer.categorize(image);
+// Auto-tag: applies tags and sets description/alt text
+await categorizer.autoTag(image, assetCollection);
+
+// AI alt text generation via this.do()
+const altText = await image.generateAltText();
+
+// Standard editing (resize, crop, convert, thumbnail)
+// Each operation creates a new derivative Image linked via parentId
+const editor = new ImageEditor(store, images, { ai: aiConfig });
+const thumb = await editor.thumbnail(image, 256);
+const resized = await editor.resize(image, 800, 600);
+const webp = await editor.convert(image, 'webp');
+
+// AI-powered editing and variation generation
+const edited = await editor.edit(image, 'add warm sunset tones');
+const variations = await editor.generateVariation(image, 'winter theme', { count: 3 });
+```
+
+## API
+
+### Models
+
+| Export | Description |
+|--------|------------|
+| `Image` | STI subclass of `Asset` with `width`, `height`, `alt`, and computed `aspectRatio`/`isLandscape`/`isPortrait`/`isSquare` |
+
+### Collections
+
+| Export | Description |
+|--------|------------|
+| `ImageCollection` | Dimension/orientation filters: `getByMinDimensions()`, `getByAspectRatio()`, `getLandscape()`, `getPortrait()`, `getSquare()`, `getHighResolution()`, `getMissingAltText()` |
+
+### Services
+
+| Export | Description |
+|--------|------------|
+| `ImageCategorizer` | AI vision analysis returning tags, description, confidence, subjects. `autoTag()` applies results to the image. |
+| `ImageDeriver` | Derive new images from sources + AI prompts with generic provenance links via `AssetAssociation` |
+| `ImageEditor` | Resize, crop, convert, thumbnail (via `@happyvertical/images`) + AI editing. Creates derivative Image records linked via `parentId`. |
+| `ImageMetadataExtractor` | Extract dimensions, format, EXIF from image buffers |
+| `ImageSearch` | Text search across name/description/alt with orientation filters |
+| `UpstreamManager` | Import from external providers with provenance tracking |
+
+### Key Types
+
+`ImageOptions`, `CategoryResult`, `DeriveOptions`, `ImageMetadataResult`, `ImageSearchOptions`, `AssetSourceAdapter`, `SourceAsset`, `SourceAssetMetadata`
+
+## Dependencies
+
+- `@happyvertical/smrt-core` -- ORM and code generation
+- `@happyvertical/smrt-assets` -- base `Asset` model and `AssetStore`
+- `@happyvertical/smrt-tenancy` -- multi-tenant scoping
+- `@happyvertical/ai` -- AI categorization and image generation
+- `@happyvertical/images` -- resize, crop, convert, thumbnail operations

package/dist/__smrt-register__.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=__smrt-register__.d.ts.map

package/dist/__smrt-register__.d.ts.map

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

package/dist/categorizer.d.ts

@@ -0,0 +1,26 @@
+import { AIClientOptions } from '@happyvertical/ai';
+import { AssetCollection } from '@happyvertical/smrt-assets';
+import { Image } from './image';
+import { CategoryResult } from './types';
+export declare class ImageCategorizer {
+    private readonly options;
+    constructor(options: {
+        ai: AIClientOptions;
+    });
+    /**
+     * Categorize an image using AI vision analysis
+     *
+     * @param image - The Image instance to categorize
+     * @param buffer - Optional raw image data for vision analysis
+     * @returns Categorization results with tags, description, and subjects
+     */
+    categorize(image: Image, buffer?: Buffer): Promise<CategoryResult>;
+    /**
+     * Run categorization and apply results to the image
+     *
+     * @param image - The Image to categorize and update
+     * @param assetCollection - AssetCollection for tag management
+     */
+    autoTag(image: Image, assetCollection: AssetCollection): Promise<void>;
+}
+//# sourceMappingURL=categorizer.d.ts.map

package/dist/categorizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"categorizer.d.ts","sourceRoot":"","sources":["../src/categorizer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE;QAAE,EAAE,EAAE,eAAe,CAAA;KAAE;IAE7D;;;;;;OAMG;IACG,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAyCxE;;;;;OAKG;IACG,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;CAkB7E"}

package/dist/deriver.d.ts

@@ -0,0 +1,33 @@
+import { AIClientOptions } from '@happyvertical/ai';
+import { AssetAssociationCollection, AssetStore } from '@happyvertical/smrt-assets';
+import { Image } from './image';
+import { ImageCollection } from './images';
+import { DeriveOptions } from './types';
+export declare class ImageDeriver {
+    private readonly store;
+    private readonly collection;
+    private readonly options;
+    constructor(store: AssetStore, collection: ImageCollection, options: {
+        ai: AIClientOptions;
+    });
+    /**
+     * Derive new images from source images and a creative prompt
+     *
+     * @param sources - One or more source images
+     * @param prompt - Creative instructions for generation
+     * @param deriveOptions - Generation options (count, size, style)
+     * @returns Array of newly created derivative Images
+     */
+    derive(sources: Image[], prompt: string, deriveOptions?: DeriveOptions): Promise<Image[]>;
+    /**
+     * Derive images and link all sources via AssetAssociation
+     *
+     * @param sources - Source images
+     * @param prompt - Creative instructions
+     * @param associations - AssetAssociationCollection for linking
+     * @param deriveOptions - Generation options
+     * @returns Array of newly created derivative Images
+     */
+    deriveWithAssociations(sources: Image[], prompt: string, associations: AssetAssociationCollection, deriveOptions?: DeriveOptions): Promise<Image[]>;
+}
+//# sourceMappingURL=deriver.d.ts.map

package/dist/deriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deriver.d.ts","sourceRoot":"","sources":["../src/deriver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EACV,0BAA0B,EAC1B,UAAU,EACX,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,qBAAa,YAAY;IAErB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAFP,KAAK,EAAE,UAAU,EACjB,UAAU,EAAE,eAAe,EAC3B,OAAO,EAAE;QAAE,EAAE,EAAE,eAAe,CAAA;KAAE;IAGnD;;;;;;;OAOG;IACG,MAAM,CACV,OAAO,EAAE,KAAK,EAAE,EAChB,MAAM,EAAE,MAAM,EACd,aAAa,GAAE,aAAkB,GAChC,OAAO,CAAC,KAAK,EAAE,CAAC;IAqDnB;;;;;;;;OAQG;IACG,sBAAsB,CAC1B,OAAO,EAAE,KAAK,EAAE,EAChB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,0BAA0B,EACxC,aAAa,GAAE,aAAkB,GAChC,OAAO,CAAC,KAAK,EAAE,CAAC;CAcpB"}

package/dist/editor.d.ts

@@ -0,0 +1,72 @@
+import { AIClientOptions } from '@happyvertical/ai';
+import { AssetStore } from '@happyvertical/smrt-assets';
+import { Image } from './image';
+import { ImageCollection } from './images';
+export declare class ImageEditor {
+    private readonly store;
+    private readonly collection;
+    private readonly options;
+    constructor(store: AssetStore, collection: ImageCollection, options?: {
+        ai?: AIClientOptions;
+    });
+    /**
+     * Resize an image to the specified dimensions
+     *
+     * @param image - Source image
+     * @param width - Target width
+     * @param height - Target height
+     * @returns New derivative Image
+     */
+    resize(image: Image, width: number, height: number): Promise<Image>;
+    /**
+     * Crop an image to the specified region
+     *
+     * @param image - Source image
+     * @param x - Left offset
+     * @param y - Top offset
+     * @param w - Crop width
+     * @param h - Crop height
+     * @returns New derivative Image
+     */
+    crop(image: Image, x: number, y: number, w: number, h: number): Promise<Image>;
+    /**
+     * Convert an image to a different format
+     *
+     * @param image - Source image
+     * @param format - Target format (e.g., 'webp', 'png', 'jpeg')
+     * @returns New derivative Image
+     */
+    convert(image: Image, format: string): Promise<Image>;
+    /**
+     * Generate a square thumbnail of the specified size
+     *
+     * @param image - Source image
+     * @param size - Thumbnail dimension (square)
+     * @returns New derivative Image
+     */
+    thumbnail(image: Image, size: number): Promise<Image>;
+    /**
+     * AI-powered image generation based on a prompt (creates derivative linked to source)
+     *
+     * @param image - Source image (used for metadata, linked as parent)
+     * @param prompt - Generation instructions (e.g., "similar image with sunset colors")
+     * @returns New derivative Image
+     */
+    edit(image: Image, prompt: string): Promise<Image>;
+    /**
+     * Generate variations of an image using AI
+     *
+     * @param image - Source image
+     * @param prompt - Variation instructions
+     * @param options - Number of variations to generate
+     * @returns Array of new derivative Images
+     */
+    generateVariation(image: Image, prompt: string, options?: {
+        count?: number;
+    }): Promise<Image[]>;
+    /**
+     * Helper: Create a derivative Image from processed buffer data
+     */
+    private createDerivative;
+}
+//# sourceMappingURL=editor.d.ts.map

package/dist/editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor.d.ts","sourceRoot":"","sources":["../src/editor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAgBhD,qBAAa,WAAW;IAEpB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAFP,KAAK,EAAE,UAAU,EACjB,UAAU,EAAE,eAAe,EAC3B,OAAO,GAAE;QAAE,EAAE,CAAC,EAAE,eAAe,CAAA;KAAO;IAGzD;;;;;;;OAOG;IACG,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAwBzE;;;;;;;;;OASG;IACG,IAAI,CACR,KAAK,EAAE,KAAK,EACZ,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,GACR,OAAO,CAAC,KAAK,CAAC;IAiCjB;;;;;;OAMG;IACG,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IA6C3D;;;;;;OAMG;IACG,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IA2B3D;;;;;;OAMG;IACG,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAuBxD;;;;;;;OAOG;IACG,iBAAiB,CACrB,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAC/B,OAAO,CAAC,KAAK,EAAE,CAAC;IAenB;;OAEG;YACW,gBAAgB;CAqC/B"}

package/dist/image.d.ts

@@ -0,0 +1,53 @@
+import { Asset } from '@happyvertical/smrt-assets';
+import { ImageOptions } from './types';
+export declare class Image extends Asset {
+    width: number;
+    height: number;
+    alt: string;
+    constructor(options?: ImageOptions);
+    /**
+     * Calculate aspect ratio from dimensions
+     */
+    get aspectRatio(): number;
+    /**
+     * Helper to get URL from sourceUri for frontend components
+     */
+    get url(): string;
+    /**
+     * Check if dimensions indicate landscape orientation
+     */
+    get isLandscape(): boolean;
+    /**
+     * Check if dimensions indicate portrait orientation
+     */
+    get isPortrait(): boolean;
+    /**
+     * Check if dimensions indicate square aspect ratio
+     */
+    get isSquare(): boolean;
+    /**
+     * Validate that the asset is an image based on MIME type
+     */
+    isValidImageFormat(): boolean;
+    /**
+     * Check if this image is high resolution (4K+)
+     */
+    isHighResolution(): boolean;
+    /**
+     * AI-powered: Generate accessibility alt text for this image.
+     *
+     * Uses the `smrtImages.image.generateAltText` prompt registered via
+     * `@happyvertical/smrt-prompts`, allowing tenant- or instance-level
+     * overrides of the template, model, and parameters at runtime.
+     *
+     * Only non-PII metadata fields (name, description) are sent to the AI
+     * provider. Source URIs, internal foreign-key fields, and the
+     * extensible `metadata` blob are intentionally excluded — source URIs
+     * may embed signed/private bucket paths and metadata may contain EXIF
+     * GPS data or tenant-private configuration.
+     *
+     * @returns AI-generated alt text describing the image
+     */
+    generateAltText(): Promise<string>;
+}
+//# sourceMappingURL=image.d.ts.map

package/dist/image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../src/image.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AAOnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,qBAKa,KAAM,SAAQ,KAAK;IAG9B,KAAK,EAAE,MAAM,CAAK;IAElB,MAAM,EAAE,MAAM,CAAK;IAInB,GAAG,EAAE,MAAM,CAAM;gBAEL,OAAO,GAAE,YAAiB;IAOtC;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,CAGxB;IAED;;OAEG;IACH,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,OAAO,CAExB;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;OAEG;IACH,kBAAkB,IAAI,OAAO;IAI7B;;OAEG;IACH,gBAAgB,IAAI,OAAO;IAI3B;;;;;;;;;;;;;;OAcG;IACG,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC;CAgCzC"}

package/dist/images.d.ts

@@ -0,0 +1,80 @@
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { Image } from './image';
+export declare class ImageCollection extends SmrtCollection<Image> {
+    static readonly _itemClass: typeof Image;
+    /**
+     * Find all images belonging to a specific tenant
+     *
+     * @param tenantId - The tenant ID to filter by
+     * @returns Array of images belonging to this tenant
+     */
+    findByTenant(tenantId: string): Promise<Image[]>;
+    /**
+     * Find all global images (images without a tenant)
+     *
+     * @returns Array of global images
+     */
+    findGlobal(): Promise<Image[]>;
+    /**
+     * Find images belonging to a tenant plus all global images
+     *
+     * @param tenantId - The tenant ID to include
+     * @returns Array of tenant-specific and global images
+     */
+    findWithGlobals(tenantId: string): Promise<Image[]>;
+    /**
+     * Get images by minimum dimensions
+     *
+     * @param minWidth - Minimum width in pixels
+     * @param minHeight - Minimum height in pixels
+     * @returns Array of images meeting minimum dimension requirements
+     */
+    getByMinDimensions(minWidth: number, minHeight: number): Promise<Image[]>;
+    /**
+     * Get images by maximum dimensions
+     *
+     * @param maxWidth - Maximum width in pixels
+     * @param maxHeight - Maximum height in pixels
+     * @returns Array of images within maximum dimension limits
+     */
+    getByMaxDimensions(maxWidth: number, maxHeight: number): Promise<Image[]>;
+    /**
+     * Get landscape images (width > height)
+     *
+     * @returns Array of landscape-oriented images
+     */
+    getLandscape(): Promise<Image[]>;
+    /**
+     * Get portrait images (height > width)
+     *
+     * @returns Array of portrait-oriented images
+     */
+    getPortrait(): Promise<Image[]>;
+    /**
+     * Get square images (width === height)
+     *
+     * @returns Array of square images
+     */
+    getSquare(): Promise<Image[]>;
+    /**
+     * Get images missing alt text
+     *
+     * @returns Array of images without accessibility text
+     */
+    getMissingAltText(): Promise<Image[]>;
+    /**
+     * Get high resolution images (4K+)
+     *
+     * @returns Array of high resolution images
+     */
+    getHighResolution(): Promise<Image[]>;
+    /**
+     * Get images by aspect ratio range
+     *
+     * @param minRatio - Minimum aspect ratio (width/height)
+     * @param maxRatio - Maximum aspect ratio (width/height)
+     * @returns Array of images within the aspect ratio range
+     */
+    getByAspectRatio(minRatio: number, maxRatio: number): Promise<Image[]>;
+}
+//# sourceMappingURL=images.d.ts.map

package/dist/images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.d.ts","sourceRoot":"","sources":["../src/images.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,qBAAa,eAAgB,SAAQ,cAAc,CAAC,KAAK,CAAC;IACxD,MAAM,CAAC,QAAQ,CAAC,UAAU,eAAS;IAMnC;;;;;OAKG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAItD;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAIpC;;;;;OAKG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAOzD;;;;;;OAMG;IACG,kBAAkB,CACtB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,KAAK,EAAE,CAAC;IASnB;;;;;;OAMG;IACG,kBAAkB,CACtB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,KAAK,EAAE,CAAC;IASnB;;;;OAIG;IACG,YAAY,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAMtC;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAMrC;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAMnC;;;;OAIG;IACG,iBAAiB,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAM3C;;;;OAIG;IACG,iBAAiB,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAM3C;;;;;;OAMG;IACG,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;CAU7E"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { ImageCategorizer } from './categorizer';
+export { ImageDeriver } from './deriver';
+export { ImageEditor } from './editor';
+export { Image } from './image';
+export { ImageCollection } from './images';
+export { type ImageMediaBundleFileDescriptor, type ImageMediaBundleGpsTrackPoint, type ImageMediaBundleInspection, type ImageMediaBundleInspectionLike, type ImageMediaBundleNormalizedMetadata, type ImageMediaBundleSupportFileInspection, type MediaSupportFileVisibility, type PersistImageMediaBundleAssetInput, type PersistImageMediaBundleAssociationInput, type PersistImageMediaBundleInspectionOptions, type PersistImageMediaBundleInspectionResult, type PersistImageMediaBundleMetadataArtifactInput, persistImageMediaBundleInspection, type SmrtImageMediaBundlePersistenceAdapter, } from './media-bundle-persistence';
+export { ImageMetadataExtractor } from './metadata';
+export { smrtImagesGenerateAltTextPrompt } from './prompts';
+export { ImageSearch } from './search';
+export type { CategoryResult, DeriveOptions, ImageMetadataResult, ImageOptions, ImageSearchOptions, } from './types';
+export { type AssetSourceAdapter, type SourceAsset, type SourceAssetMetadata, UpstreamManager, } from './upstream';
+//# 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;;;;;;;GAOG;AAKH,OAAO,wBAAwB,CAAC;AAIhC,OAAO,cAAc,CAAC;AAGtB,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EACL,KAAK,8BAA8B,EACnC,KAAK,6BAA6B,EAClC,KAAK,0BAA0B,EAC/B,KAAK,8BAA8B,EACnC,KAAK,kCAAkC,EACvC,KAAK,qCAAqC,EAC1C,KAAK,0BAA0B,EAC/B,KAAK,iCAAiC,EACtC,KAAK,uCAAuC,EAC5C,KAAK,wCAAwC,EAC7C,KAAK,uCAAuC,EAC5C,KAAK,4CAA4C,EACjD,iCAAiC,EACjC,KAAK,sCAAsC,GAC5C,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,+BAA+B,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC,YAAY,EACV,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,GACnB,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,eAAe,GAChB,MAAM,YAAY,CAAC"}