@happyvertical/smrt-images 0.30.0

package/dist/svelte/routes/shared.js

@@ -0,0 +1,31 @@
+export const IMAGES_ROUTE_IDS = {
+    studio: '@happyvertical/smrt-images:studio',
+};
+export const IMAGES_ROUTE_META = {
+    studio: {
+        id: IMAGES_ROUTE_IDS.studio,
+        title: 'Image Studio',
+        description: 'Browse images, run uploads, and hand off selected assets into the package-owned image editor surface.',
+        defaultPath: '/images',
+        loadKind: undefined,
+        nav: {
+            label: 'Images',
+            description: 'Browse image assets and open the image editor.',
+            icon: 'image',
+            order: 20,
+            group: 'content',
+        },
+    },
+};
+export function createImagesRouteNavigation(mounts = {}) {
+    return [IMAGES_ROUTE_META.studio].map((route) => ({
+        routeId: route.id,
+        href: mounts[route.id] ?? route.defaultPath,
+        label: route.nav?.label ?? route.title,
+        description: route.nav?.description ?? route.description,
+        icon: route.nav?.icon,
+        order: route.nav?.order,
+        group: route.nav?.group,
+    }));
+}
+export const IMAGES_DEFAULT_ROUTE_NAVIGATION = createImagesRouteNavigation();

package/dist/types.d.ts

@@ -0,0 +1,51 @@
+import { AssetOptions } from '@happyvertical/smrt-assets';
+/**
+ * Options for creating an Image instance
+ */
+export interface ImageOptions extends AssetOptions {
+    width?: number;
+    height?: number;
+    alt?: string;
+}
+/**
+ * Result from AI-powered image categorization
+ */
+export interface CategoryResult {
+    tags: string[];
+    description: string;
+    confidence: number;
+    subjects: string[];
+}
+/**
+ * Options for image search queries
+ */
+export interface ImageSearchOptions {
+    tags?: string[];
+    minWidth?: number;
+    minHeight?: number;
+    orientation?: 'landscape' | 'portrait' | 'square';
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Options for derived image creation
+ */
+export interface DeriveOptions {
+    /** Number of results (default 1) */
+    count?: number;
+    /** Output dimensions (e.g., '1024x1024') */
+    size?: string;
+    /** Style hint */
+    style?: string;
+}
+/**
+ * Result from image metadata extraction
+ */
+export interface ImageMetadataResult {
+    width: number;
+    height: number;
+    format: string;
+    mimeType: string;
+    exif?: Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,YAAY;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,WAAW,GAAG,UAAU,GAAG,QAAQ,CAAC;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iBAAiB;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/ui.d.ts

@@ -0,0 +1,10 @@
+import { ModuleUISlot, SmrtModuleMeta } from '@happyvertical/smrt-types';
+/**
+ * Images module UI slots
+ */
+export declare const IMAGES_UI_SLOTS: Record<string, ModuleUISlot>;
+/**
+ * Images module metadata
+ */
+export declare const IMAGES_MODULE_META: SmrtModuleMeta;
+//# sourceMappingURL=ui.d.ts.map

package/dist/ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE9E;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CA6BxD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,cAQhC,CAAC"}

package/dist/ui.js

@@ -0,0 +1,42 @@
+const IMAGES_UI_SLOTS = {
+  "assets-gallery": {
+    id: "assets-gallery",
+    label: "Assets Gallery",
+    description: "Grid gallery of image assets with filtering and selection",
+    icon: "images",
+    category: "list",
+    order: 1,
+    propsInterface: "AssetsGalleryProps"
+  },
+  "image-editor": {
+    id: "image-editor",
+    label: "Image Editor",
+    description: "Resize, crop, convert, and AI-edit an image with derivative tracking",
+    icon: "image",
+    category: "form",
+    order: 2,
+    propsInterface: "ImageEditorProps"
+  },
+  "image-uploader": {
+    id: "image-uploader",
+    label: "Image Uploader",
+    description: "Upload images with metadata extraction and AI categorization",
+    icon: "upload",
+    category: "form",
+    order: 3,
+    propsInterface: "ImageUploaderProps"
+  }
+};
+const IMAGES_MODULE_META = {
+  name: "@happyvertical/smrt-images",
+  displayName: "Images",
+  description: "Image asset management with AI-powered categorization, search, editing, and metadata extraction",
+  uiSlots: IMAGES_UI_SLOTS,
+  models: ["Image"],
+  collections: ["ImageCollection"]
+};
+export {
+  IMAGES_MODULE_META,
+  IMAGES_UI_SLOTS
+};
+//# sourceMappingURL=ui.js.map

package/dist/ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.js","sources":["../src/ui.ts"],"sourcesContent":["/**\n * Images Module UI Slot Declarations\n *\n * This file defines the UI extension points for the images module.\n * UI components are implemented in the ./svelte subpath.\n */\n\nimport type { ModuleUISlot, SmrtModuleMeta } from '@happyvertical/smrt-types';\n\n/**\n * Images module UI slots\n */\nexport const IMAGES_UI_SLOTS: Record<string, ModuleUISlot> = {\n  'assets-gallery': {\n    id: 'assets-gallery',\n    label: 'Assets Gallery',\n    description: 'Grid gallery of image assets with filtering and selection',\n    icon: 'images',\n    category: 'list',\n    order: 1,\n    propsInterface: 'AssetsGalleryProps',\n  },\n  'image-editor': {\n    id: 'image-editor',\n    label: 'Image Editor',\n    description:\n      'Resize, crop, convert, and AI-edit an image with derivative tracking',\n    icon: 'image',\n    category: 'form',\n    order: 2,\n    propsInterface: 'ImageEditorProps',\n  },\n  'image-uploader': {\n    id: 'image-uploader',\n    label: 'Image Uploader',\n    description: 'Upload images with metadata extraction and AI categorization',\n    icon: 'upload',\n    category: 'form',\n    order: 3,\n    propsInterface: 'ImageUploaderProps',\n  },\n};\n\n/**\n * Images module metadata\n */\nexport const IMAGES_MODULE_META: SmrtModuleMeta = {\n  name: '@happyvertical/smrt-images',\n  displayName: 'Images',\n  description:\n    'Image asset management with AI-powered categorization, search, editing, and metadata extraction',\n  uiSlots: IMAGES_UI_SLOTS,\n  models: ['Image'],\n  collections: ['ImageCollection'],\n};\n"],"names":[],"mappings":"AAYO,MAAM,kBAAgD;AAAA,EAC3D,kBAAkB;AAAA,IAChB,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,aAAa;AAAA,IACb,MAAM;AAAA,IACN,UAAU;AAAA,IACV,OAAO;AAAA,IACP,gBAAgB;AAAA,EAAA;AAAA,EAElB,gBAAgB;AAAA,IACd,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,aACE;AAAA,IACF,MAAM;AAAA,IACN,UAAU;AAAA,IACV,OAAO;AAAA,IACP,gBAAgB;AAAA,EAAA;AAAA,EAElB,kBAAkB;AAAA,IAChB,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,aAAa;AAAA,IACb,MAAM;AAAA,IACN,UAAU;AAAA,IACV,OAAO;AAAA,IACP,gBAAgB;AAAA,EAAA;AAEpB;AAKO,MAAM,qBAAqC;AAAA,EAChD,MAAM;AAAA,EACN,aAAa;AAAA,EACb,aACE;AAAA,EACF,SAAS;AAAA,EACT,QAAQ,CAAC,OAAO;AAAA,EAChB,aAAa,CAAC,iBAAiB;AACjC;"}

package/dist/upstream.d.ts

@@ -0,0 +1,65 @@
+import { AssetStore } from '@happyvertical/smrt-assets';
+import { Image } from './image';
+import { ImageCollection } from './images';
+/**
+ * Minimal adapter interface for upstream asset sources.
+ * Full implementation lives in @happyvertical/assets (SDK package).
+ */
+export interface AssetSourceAdapter {
+    readonly name: string;
+    readonly capabilities: {
+        search: boolean;
+        download: boolean;
+        browse: boolean;
+    };
+    search(query: string, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<SourceAsset[]>;
+    get(externalId: string): Promise<SourceAsset | null>;
+    download(externalId: string): Promise<{
+        data: Buffer;
+        metadata: SourceAssetMetadata;
+    }>;
+}
+export interface SourceAsset {
+    externalId: string;
+    sourceName: string;
+    name: string;
+    mimeType: string;
+    previewUrl?: string;
+    thumbnailUrl?: string;
+    metadata: SourceAssetMetadata;
+}
+export interface SourceAssetMetadata {
+    width?: number;
+    height?: number;
+    description?: string;
+    tags?: string[];
+    license?: string;
+    attribution?: string;
+}
+export declare class UpstreamManager {
+    private readonly sources;
+    private readonly store;
+    private readonly collection;
+    constructor(sources: AssetSourceAdapter[], store: AssetStore, collection: ImageCollection);
+    /**
+     * Search across all configured upstream sources
+     *
+     * @param query - Search query
+     * @param options - Search options
+     * @returns Merged and ranked results from all sources
+     */
+    search(query: string, options?: {
+        limit?: number;
+    }): Promise<SourceAsset[]>;
+    /**
+     * Import an asset from an upstream source into the local store
+     *
+     * @param sourceAsset - The upstream asset to import
+     * @returns Locally stored Image with provenance
+     */
+    import(sourceAsset: SourceAsset): Promise<Image>;
+}
+//# sourceMappingURL=upstream.d.ts.map

package/dist/upstream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upstream.d.ts","sourceRoot":"","sources":["../src/upstream.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,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;AAEhD;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE;QACrB,MAAM,EAAE,OAAO,CAAC;QAChB,QAAQ,EAAE,OAAO,CAAC;QAClB,MAAM,EAAE,OAAO,CAAC;KACjB,CAAC;IACF,MAAM,CACJ,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAC5C,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC1B,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACrD,QAAQ,CACN,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,mBAAmB,CAAA;KAAE,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,mBAAmB,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,eAAe;IAExB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAFV,OAAO,EAAE,kBAAkB,EAAE,EAC7B,KAAK,EAAE,UAAU,EACjB,UAAU,EAAE,eAAe;IAG9C;;;;;;OAMG;IACG,MAAM,CACV,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAC/B,OAAO,CAAC,WAAW,EAAE,CAAC;IAkBzB;;;;;OAKG;IACG,MAAM,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC;CAoCvD"}

package/package.json

@@ -0,0 +1,95 @@
+{
+  "name": "@happyvertical/smrt-images",
+  "version": "0.30.0",
+  "description": "Image asset management with AI-powered categorization, search, editing, and metadata extraction for SMRT framework",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "CLAUDE.md",
+    "AGENTS.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./ui": {
+      "types": "./dist/ui.d.ts",
+      "import": "./dist/ui.js"
+    },
+    "./manifest": "./dist/manifest.json",
+    "./manifest.json": "./dist/manifest.json",
+    "./playground": {
+      "types": "./dist/playground.d.ts",
+      "import": "./dist/playground.js"
+    },
+    "./svelte": {
+      "types": "./dist/svelte/index.d.ts",
+      "svelte": "./dist/svelte/index.js",
+      "import": "./dist/svelte/index.js",
+      "default": "./dist/svelte/index.js"
+    }
+  },
+  "dependencies": {
+    "@happyvertical/ai": "^0.74.7",
+    "@happyvertical/images": "^0.74.7",
+    "@happyvertical/utils": "^0.74.7",
+    "jimp": "^1.6.1",
+    "sharp": "^0.34.5",
+    "@happyvertical/smrt-assets": "0.30.0",
+    "@happyvertical/smrt-tenancy": "0.30.0",
+    "@happyvertical/smrt-core": "0.30.0",
+    "@happyvertical/smrt-prompts": "0.30.0",
+    "@happyvertical/smrt-types": "0.30.0",
+    "@happyvertical/smrt-ui": "0.30.0"
+  },
+  "peerDependencies": {
+    "svelte": "^5.18.0"
+  },
+  "devDependencies": {
+    "@happyvertical/sql": "^0.74.7",
+    "@sveltejs/kit": "^2.5.7",
+    "@sveltejs/package": "^2.5.7",
+    "@sveltejs/vite-plugin-svelte": "^6.2.4",
+    "@types/node": "25.0.9",
+    "svelte": "^5.46.4",
+    "svelte-check": "^4.3.5",
+    "typescript": "^5.9.3",
+    "vite": "^7.3.1",
+    "vitest": "^4.0.17",
+    "@happyvertical/smrt-playground": "0.30.0",
+    "@happyvertical/smrt-vitest": "0.30.0"
+  },
+  "keywords": [
+    "ai",
+    "smrt",
+    "images",
+    "image-processing",
+    "categorization",
+    "search"
+  ],
+  "author": "HappyVertical",
+  "license": "MIT",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/happyvertical/smrt.git",
+    "directory": "packages/images"
+  },
+  "scripts": {
+    "build": "SMRT_PACKAGE_BUILD=1 svelte-kit sync && SMRT_PACKAGE_BUILD=1 vite build --mode library && SMRT_PACKAGE_BUILD=1 svelte-package -i src/svelte -o dist/svelte --tsconfig tsconfig.svelte.json",
+    "build:watch": "vite build --mode library --watch",
+    "clean": "rm -rf dist",
+    "dev": "vite dev",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.kit.json",
+    "typecheck": "svelte-kit sync && tsc -p tsconfig.typecheck.json && node ../../scripts/svelte-check-a11y.mjs --tsconfig ./tsconfig.kit.json",
+    "verify:pack": "node ../../scripts/verify-package-types-exports.js ."
+  }
+}