@happyvertical/smrt-images 0.30.0

package/dist/media-bundle-persistence.d.ts

@@ -0,0 +1,15 @@
+import { MediaBundleFileDescriptor, MediaBundleGpsTrackPoint, MediaBundleInspection, MediaBundleInspectionLike, MediaBundleNormalizedMetadata, MediaBundleSupportFileInspection, PersistMediaBundleAssetInput, PersistMediaBundleAssociationInput, PersistMediaBundleInspectionOptions, PersistMediaBundleInspectionResult, PersistMediaBundleMetadataArtifactInput, SmrtMediaBundlePersistenceAdapter } from '@happyvertical/smrt-assets';
+export { type MediaSupportFileVisibility, persistMediaBundleInspection as persistImageMediaBundleInspection, } from '@happyvertical/smrt-assets';
+export type ImageMediaBundleFileDescriptor = MediaBundleFileDescriptor;
+export type ImageMediaBundleGpsTrackPoint = MediaBundleGpsTrackPoint;
+export type ImageMediaBundleInspection = MediaBundleInspection;
+export type ImageMediaBundleInspectionLike = MediaBundleInspectionLike;
+export type ImageMediaBundleNormalizedMetadata = MediaBundleNormalizedMetadata;
+export type ImageMediaBundleSupportFileInspection = MediaBundleSupportFileInspection;
+export type PersistImageMediaBundleAssetInput = PersistMediaBundleAssetInput;
+export type PersistImageMediaBundleAssociationInput = PersistMediaBundleAssociationInput;
+export type PersistImageMediaBundleInspectionOptions = PersistMediaBundleInspectionOptions;
+export type PersistImageMediaBundleInspectionResult = PersistMediaBundleInspectionResult;
+export type PersistImageMediaBundleMetadataArtifactInput = PersistMediaBundleMetadataArtifactInput;
+export type SmrtImageMediaBundlePersistenceAdapter = SmrtMediaBundlePersistenceAdapter;
+//# sourceMappingURL=media-bundle-persistence.d.ts.map

package/dist/media-bundle-persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-bundle-persistence.d.ts","sourceRoot":"","sources":["../src/media-bundle-persistence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yBAAyB,EACzB,wBAAwB,EACxB,qBAAqB,EACrB,yBAAyB,EACzB,6BAA6B,EAC7B,gCAAgC,EAChC,4BAA4B,EAC5B,kCAAkC,EAClC,mCAAmC,EACnC,kCAAkC,EAClC,uCAAuC,EACvC,iCAAiC,EAClC,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,KAAK,0BAA0B,EAC/B,4BAA4B,IAAI,iCAAiC,GAClE,MAAM,4BAA4B,CAAC;AAEpC,MAAM,MAAM,8BAA8B,GAAG,yBAAyB,CAAC;AACvE,MAAM,MAAM,6BAA6B,GAAG,wBAAwB,CAAC;AACrE,MAAM,MAAM,0BAA0B,GAAG,qBAAqB,CAAC;AAC/D,MAAM,MAAM,8BAA8B,GAAG,yBAAyB,CAAC;AACvE,MAAM,MAAM,kCAAkC,GAAG,6BAA6B,CAAC;AAC/E,MAAM,MAAM,qCAAqC,GAC/C,gCAAgC,CAAC;AACnC,MAAM,MAAM,iCAAiC,GAAG,4BAA4B,CAAC;AAC7E,MAAM,MAAM,uCAAuC,GACjD,kCAAkC,CAAC;AACrC,MAAM,MAAM,wCAAwC,GAClD,mCAAmC,CAAC;AACtC,MAAM,MAAM,uCAAuC,GACjD,kCAAkC,CAAC;AACrC,MAAM,MAAM,4CAA4C,GACtD,uCAAuC,CAAC;AAC1C,MAAM,MAAM,sCAAsC,GAChD,iCAAiC,CAAC"}

package/dist/metadata.d.ts

@@ -0,0 +1,19 @@
+import { Image } from './image';
+import { ImageMetadataResult } from './types';
+export declare class ImageMetadataExtractor {
+    /**
+     * Extract metadata from an image buffer
+     *
+     * @param buffer - Raw image data
+     * @returns Extracted metadata including dimensions and format
+     */
+    extract(buffer: Buffer): Promise<ImageMetadataResult>;
+    /**
+     * Extract metadata and apply it to an Image instance
+     *
+     * @param image - The Image instance to update
+     * @param buffer - Raw image data
+     */
+    extractAndApply(image: Image, buffer: Buffer): Promise<void>;
+}
+//# sourceMappingURL=metadata.d.ts.map

package/dist/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEnD,qBAAa,sBAAsB;IACjC;;;;;OAKG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAiB3D;;;;;OAKG;IACG,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAMnE"}

package/dist/playground.d.ts

@@ -0,0 +1,2 @@
+export { default } from './svelte/playground.js';
+//# sourceMappingURL=playground.d.ts.map

package/dist/playground.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playground.d.ts","sourceRoot":"","sources":["../src/playground.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/playground.js

@@ -0,0 +1,140 @@
+const IMAGES_ROUTE_IDS = {
+  studio: "@happyvertical/smrt-images:studio"
+};
+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: void 0,
+    nav: {
+      label: "Images",
+      description: "Browse image assets and open the image editor.",
+      icon: "image",
+      order: 20,
+      group: "content"
+    }
+  }
+};
+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
+  }));
+}
+createImagesRouteNavigation();
+const DEFAULT_IMAGES_PLAYGROUND_API_BASE_URL = "/api/v1";
+function resolveImagesPlaygroundApiBaseUrl() {
+  const configuredViaGlobal = globalThis.__SMRT_IMAGES_PLAYGROUND_API_BASE_URL__;
+  if (configuredViaGlobal) {
+    return configuredViaGlobal;
+  }
+  const browserLocation = globalThis.location;
+  if (browserLocation) {
+    const configuredViaQuery = new URLSearchParams(browserLocation.search).get(
+      "smrtImagesApiBaseUrl"
+    );
+    if (configuredViaQuery) {
+      return configuredViaQuery;
+    }
+  }
+  return DEFAULT_IMAGES_PLAYGROUND_API_BASE_URL;
+}
+function createPreviewImageUri(label, accent) {
+  const svg = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1280 720">
+    <defs>
+      <linearGradient id="bg" x1="0%" x2="100%" y1="0%" y2="100%">
+        <stop offset="0%" stop-color="${accent}" />
+        <stop offset="100%" stop-color="#111827" />
+      </linearGradient>
+    </defs>
+    <rect width="1280" height="720" fill="url(#bg)" rx="40" />
+    <circle cx="1040" cy="170" r="92" fill="rgba(255,255,255,0.18)" />
+    <path d="M110 590L360 320l182 170 146-104 210 204H110z" fill="rgba(255,255,255,0.22)" />
+    <text x="92" y="118" fill="#f8fafc" font-size="60" font-family="Arial, sans-serif" font-weight="700">${label}</text>
+    <text x="92" y="662" fill="#dbeafe" font-size="30" font-family="Arial, sans-serif">SMRT Images preview</text>
+  </svg>`;
+  return `data:image/svg+xml;charset=UTF-8,${encodeURIComponent(svg)}`;
+}
+const sampleImage = {
+  id: "image-harbor-dusk",
+  name: "Harbor Dusk",
+  description: "Wide editorial frame used for feature headers.",
+  sourceUri: createPreviewImageUri("Harbor Dusk", "#2563eb"),
+  url: createPreviewImageUri("Harbor Dusk", "#2563eb"),
+  mimeType: "image/jpeg",
+  width: 1280,
+  height: 720,
+  alt: "Cargo cranes and harbor lights reflected at dusk."
+};
+const loadImageEditor = () => import("./svelte/components/ImageEditor.svelte");
+const loadImageStudioRoute = () => import("./svelte/routes/ImageStudioRoute.svelte");
+const loadImageUploader = () => import("./svelte/components/ImageUploader.svelte");
+const playground = {
+  packageName: "@happyvertical/smrt-images",
+  displayName: "Images",
+  description: IMAGES_ROUTE_META.studio.description,
+  entries: [
+    {
+      id: "image-uploader",
+      title: "Image Uploader",
+      description: "Mock-safe uploader preview for local files and external image URLs.",
+      loadComponent: loadImageUploader,
+      order: 1,
+      tags: ["uploader", "images", "media"],
+      props: {
+        allowedTabs: ["upload", "external"],
+        onSelect: () => void 0
+      },
+      modes: {
+        mock: {
+          label: "Mock"
+        }
+      }
+    },
+    {
+      id: "image-editor",
+      title: "Image Editor",
+      description: "Editor controls for resizing, cropping, and AI-assisted image edits.",
+      loadComponent: loadImageEditor,
+      order: 2,
+      tags: ["editor", "images", "media"],
+      props: {
+        image: sampleImage,
+        onSave: () => void 0
+      },
+      modes: {
+        mock: {
+          label: "Mock"
+        }
+      }
+    },
+    {
+      id: "image-studio-route",
+      title: "Image Studio Route",
+      description: "Package-owned acquisition and editing flow backed by the generated images API.",
+      loadComponent: loadImageStudioRoute,
+      order: 3,
+      tags: ["route", "images", "admin"],
+      modes: {
+        live: {
+          label: "Live",
+          description: "Requires the images package dev server and generated routes. Override the base URL with ?smrtImagesApiBaseUrl=... or window.__SMRT_IMAGES_PLAYGROUND_API_BASE_URL__ when needed.",
+          props: {
+            apiBaseUrl: resolveImagesPlaygroundApiBaseUrl()
+          }
+        }
+      }
+    }
+  ]
+};
+export {
+  playground as default
+};
+//# sourceMappingURL=playground.js.map

package/dist/playground.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"playground.js","sources":["../src/svelte/routes/shared.ts","../src/svelte/playground.ts"],"sourcesContent":["import type {\n  SmrtRouteDefinition,\n  SmrtRouteNavigationItem,\n} from '@happyvertical/smrt-types';\n\nexport const IMAGES_ROUTE_IDS = {\n  studio: '@happyvertical/smrt-images:studio',\n} as const;\n\nexport type ImagesRouteId =\n  (typeof IMAGES_ROUTE_IDS)[keyof typeof IMAGES_ROUTE_IDS];\n\nexport type ImagesRouteNavigationItem = SmrtRouteNavigationItem;\n\nexport const IMAGES_ROUTE_META = {\n  studio: {\n    id: IMAGES_ROUTE_IDS.studio,\n    title: 'Image Studio',\n    description:\n      'Browse images, run uploads, and hand off selected assets into the package-owned image editor surface.',\n    defaultPath: '/images',\n    loadKind: undefined,\n    nav: {\n      label: 'Images',\n      description: 'Browse image assets and open the image editor.',\n      icon: 'image',\n      order: 20,\n      group: 'content',\n    },\n  } satisfies Omit<SmrtRouteDefinition, 'component'>,\n} as const;\n\nexport function createImagesRouteNavigation(\n  mounts: Partial<Record<ImagesRouteId, string>> = {},\n): ImagesRouteNavigationItem[] {\n  return [IMAGES_ROUTE_META.studio].map((route) => ({\n    routeId: route.id,\n    href: mounts[route.id] ?? route.defaultPath,\n    label: route.nav?.label ?? route.title,\n    description: route.nav?.description ?? route.description,\n    icon: route.nav?.icon,\n    order: route.nav?.order,\n    group: route.nav?.group,\n  }));\n}\n\nexport const IMAGES_DEFAULT_ROUTE_NAVIGATION = createImagesRouteNavigation();\n","import { IMAGES_ROUTE_META } from './routes/shared.js';\n\nconst DEFAULT_IMAGES_PLAYGROUND_API_BASE_URL = '/api/v1';\n\ntype ImagesPlaygroundGlobal = typeof globalThis & {\n  __SMRT_IMAGES_PLAYGROUND_API_BASE_URL__?: string;\n  location?: {\n    search: string;\n  };\n};\n\nfunction resolveImagesPlaygroundApiBaseUrl(): string {\n  const configuredViaGlobal = (globalThis as ImagesPlaygroundGlobal)\n    .__SMRT_IMAGES_PLAYGROUND_API_BASE_URL__;\n  if (configuredViaGlobal) {\n    return configuredViaGlobal;\n  }\n\n  const browserLocation = (globalThis as ImagesPlaygroundGlobal).location;\n  if (browserLocation) {\n    const configuredViaQuery = new URLSearchParams(browserLocation.search).get(\n      'smrtImagesApiBaseUrl',\n    );\n\n    if (configuredViaQuery) {\n      return configuredViaQuery;\n    }\n  }\n\n  return DEFAULT_IMAGES_PLAYGROUND_API_BASE_URL;\n}\n\nfunction createPreviewImageUri(label: string, accent: string): string {\n  const svg = `<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 1280 720\">\n    <defs>\n      <linearGradient id=\"bg\" x1=\"0%\" x2=\"100%\" y1=\"0%\" y2=\"100%\">\n        <stop offset=\"0%\" stop-color=\"${accent}\" />\n        <stop offset=\"100%\" stop-color=\"#111827\" />\n      </linearGradient>\n    </defs>\n    <rect width=\"1280\" height=\"720\" fill=\"url(#bg)\" rx=\"40\" />\n    <circle cx=\"1040\" cy=\"170\" r=\"92\" fill=\"rgba(255,255,255,0.18)\" />\n    <path d=\"M110 590L360 320l182 170 146-104 210 204H110z\" fill=\"rgba(255,255,255,0.22)\" />\n    <text x=\"92\" y=\"118\" fill=\"#f8fafc\" font-size=\"60\" font-family=\"Arial, sans-serif\" font-weight=\"700\">${label}</text>\n    <text x=\"92\" y=\"662\" fill=\"#dbeafe\" font-size=\"30\" font-family=\"Arial, sans-serif\">SMRT Images preview</text>\n  </svg>`;\n\n  return `data:image/svg+xml;charset=UTF-8,${encodeURIComponent(svg)}`;\n}\n\nconst sampleImage = {\n  id: 'image-harbor-dusk',\n  name: 'Harbor Dusk',\n  description: 'Wide editorial frame used for feature headers.',\n  sourceUri: createPreviewImageUri('Harbor Dusk', '#2563eb'),\n  url: createPreviewImageUri('Harbor Dusk', '#2563eb'),\n  mimeType: 'image/jpeg',\n  width: 1280,\n  height: 720,\n  alt: 'Cargo cranes and harbor lights reflected at dusk.',\n};\n\nconst loadImageEditor = () => import('./components/ImageEditor.svelte');\nconst loadImageStudioRoute = () => import('./routes/ImageStudioRoute.svelte');\nconst loadImageUploader = () => import('./components/ImageUploader.svelte');\n\nexport default {\n  packageName: '@happyvertical/smrt-images',\n  displayName: 'Images',\n  description: IMAGES_ROUTE_META.studio.description,\n  entries: [\n    {\n      id: 'image-uploader',\n      title: 'Image Uploader',\n      description:\n        'Mock-safe uploader preview for local files and external image URLs.',\n      loadComponent: loadImageUploader,\n      order: 1,\n      tags: ['uploader', 'images', 'media'],\n      props: {\n        allowedTabs: ['upload', 'external'],\n        onSelect: () => undefined,\n      },\n      modes: {\n        mock: {\n          label: 'Mock',\n        },\n      },\n    },\n    {\n      id: 'image-editor',\n      title: 'Image Editor',\n      description:\n        'Editor controls for resizing, cropping, and AI-assisted image edits.',\n      loadComponent: loadImageEditor,\n      order: 2,\n      tags: ['editor', 'images', 'media'],\n      props: {\n        image: sampleImage,\n        onSave: () => undefined,\n      },\n      modes: {\n        mock: {\n          label: 'Mock',\n        },\n      },\n    },\n    {\n      id: 'image-studio-route',\n      title: 'Image Studio Route',\n      description:\n        'Package-owned acquisition and editing flow backed by the generated images API.',\n      loadComponent: loadImageStudioRoute,\n      order: 3,\n      tags: ['route', 'images', 'admin'],\n      modes: {\n        live: {\n          label: 'Live',\n          description:\n            'Requires the images package dev server and generated routes. Override the base URL with ?smrtImagesApiBaseUrl=... or window.__SMRT_IMAGES_PLAYGROUND_API_BASE_URL__ when needed.',\n          props: {\n            apiBaseUrl: resolveImagesPlaygroundApiBaseUrl(),\n          },\n        },\n      },\n    },\n  ],\n};\n"],"names":[],"mappings":"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"}

package/dist/prompts.d.ts

@@ -0,0 +1,8 @@
+import { ResolvedPromptAI } from '@happyvertical/smrt-prompts';
+export declare const smrtImagesGenerateAltTextPrompt: import('@happyvertical/smrt-prompts').PromptDefinition;
+export declare function promptMessageOptions(ai: ResolvedPromptAI): {
+    maxTokens?: number | undefined;
+    temperature?: number | undefined;
+    model?: string | undefined;
+};
+//# sourceMappingURL=prompts.d.ts.map

package/dist/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,6BAA6B,CAAC;AASrC,eAAO,MAAM,+BAA+B,wDAgB1C,CAAC;AAEH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,gBAAgB;;;;EASxD"}

package/dist/search.d.ts

@@ -0,0 +1,42 @@
+import { AIClientOptions } from '@happyvertical/ai';
+import { Image } from './image';
+import { ImageCollection } from './images';
+import { ImageSearchOptions } from './types';
+export declare class ImageSearch {
+    private readonly collection;
+    readonly _options: {
+        ai?: AIClientOptions;
+    };
+    constructor(collection: ImageCollection, _options?: {
+        ai?: AIClientOptions;
+    });
+    /**
+     * Search images by text query with optional dimension/orientation filters
+     *
+     * @param query - Text search query
+     * @param searchOptions - Optional filters for dimensions, orientation, etc.
+     * @returns Matching images
+     */
+    search(query: string, searchOptions?: ImageSearchOptions): Promise<Image[]>;
+    /**
+     * Find images similar to a given image
+     *
+     * @param image - The reference image
+     * @param options - Search options
+     * @returns Similar images
+     */
+    findSimilar(image: Image, options?: {
+        limit?: number;
+    }): Promise<Image[]>;
+    /**
+     * Find images matching a natural language prompt
+     *
+     * @param prompt - Natural language description of desired images
+     * @param options - Search options
+     * @returns Matching images
+     */
+    findByPrompt(prompt: string, options?: {
+        limit?: number;
+    }): Promise<Image[]>;
+}
+//# sourceMappingURL=search.d.ts.map

package/dist/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD,qBAAa,WAAW;IAEpB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,QAAQ,CAAC,QAAQ,EAAE;QAAE,EAAE,CAAC,EAAE,eAAe,CAAA;KAAE;gBAD1B,UAAU,EAAE,eAAe,EACnC,QAAQ,GAAE;QAAE,EAAE,CAAC,EAAE,eAAe,CAAA;KAAO;IAGlD;;;;;;OAMG;IACG,MAAM,CACV,KAAK,EAAE,MAAM,EACb,aAAa,GAAE,kBAAuB,GACrC,OAAO,CAAC,KAAK,EAAE,CAAC;IAsDnB;;;;;;OAMG;IACG,WAAW,CACf,KAAK,EAAE,KAAK,EACZ,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAC/B,OAAO,CAAC,KAAK,EAAE,CAAC;IAiBnB;;;;;;OAMG;IACG,YAAY,CAChB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAC/B,OAAO,CAAC,KAAK,EAAE,CAAC;CAIpB"}