@granite-js/image 0.1.34 → 1.0.0

package/CHANGELOG.md

@@ -1,281 +1,7 @@
 # @granite-js/image
 
-## 0.1.34
+## 1.0.0
 
-### Patch Changes
+### Major Changes
 
-- Updated dependencies [9c39997]
-  - @granite-js/native@0.1.34
-
-## 0.1.33
-
-### Patch Changes
-
-- Updated dependencies [fdf55a6]
-  - @granite-js/native@0.1.33
-
-## 0.1.32
-
-### Patch Changes
-
-- 7572713: bump version up babel
-- Updated dependencies [74b2223]
-- Updated dependencies [7572713]
-  - @granite-js/native@0.1.32
-
-## 0.1.31
-
-### Patch Changes
-
-- Updated dependencies [0ff9b13]
-- Updated dependencies [37ae3f3]
-  - @granite-js/native@0.1.31
-
-## 0.1.30
-
-### Patch Changes
-
-- @granite-js/native@0.1.30
-
-## 0.1.29
-
-### Patch Changes
-
-- @granite-js/native@0.1.29
-
-## 0.1.28
-
-### Patch Changes
-
-- 1d958cc: ci: provenance
-- Updated dependencies [1d958cc]
-  - @granite-js/native@0.1.28
-
-## 0.1.27
-
-### Patch Changes
-
-- e32b020: ci: oidc
-- Updated dependencies [e32b020]
-- Updated dependencies [1dd9179]
-  - @granite-js/native@0.1.27
-
-## 0.1.26
-
-### Patch Changes
-
-- 41f9ab3: ensure polyfill setup during initialization and update package.json config for improve tree shaking
-  - @granite-js/native@0.1.26
-
-## 0.1.25
-
-### Patch Changes
-
-- @granite-js/native@0.1.25
-
-## 0.1.24
-
-### Patch Changes
-
-- @granite-js/native@0.1.24
-
-## 0.1.23
-
-### Patch Changes
-
-- @granite-js/native@0.1.23
-
-## 0.1.22
-
-### Patch Changes
-
-- @granite-js/native@0.1.22
-
-## 0.1.21
-
-### Patch Changes
-
-- @granite-js/native@0.1.21
-
-## 0.1.20
-
-### Patch Changes
-
-- 1df5883: update package.json meta to supports any moduleResolutions
-- Updated dependencies [1df5883]
-  - @granite-js/native@0.1.20
-
-## 0.1.19
-
-### Patch Changes
-
-- @granite-js/native@0.1.19
-
-## 0.1.18
-
-### Patch Changes
-
-- @granite-js/native@0.1.18
-
-## 0.1.17
-
-### Patch Changes
-
-- @granite-js/native@0.1.17
-
-## 0.1.16
-
-### Patch Changes
-
-- @granite-js/native@0.1.16
-
-## 0.1.15
-
-### Patch Changes
-
-- d16ee87: Add useInitialProps, useInitialSearchParams hook.
-- Updated dependencies [d16ee87]
-  - @granite-js/native@0.1.15
-
-## 0.1.14
-
-### Patch Changes
-
-- @granite-js/native@0.1.14
-
-## 0.1.13
-
-### Patch Changes
-
-- @granite-js/native@0.1.13
-
-## 0.1.12
-
-### Patch Changes
-
-- d1e6585: fix module resolutions
-- Updated dependencies [d1e6585]
-  - @granite-js/native@0.1.12
-
-## 0.1.11
-
-### Patch Changes
-
-- @granite-js/native@0.1.11
-
-## 0.1.10
-
-### Patch Changes
-
-- @granite-js/native@0.1.10
-
-## 0.1.9
-
-### Patch Changes
-
-- @granite-js/native@0.1.9
-
-## 0.1.8
-
-### Patch Changes
-
-- @granite-js/native@0.1.8
-
-## 0.1.7
-
-### Patch Changes
-
-- @granite-js/native@0.1.7
-
-## 0.1.6
-
-### Patch Changes
-
-- @granite-js/native@0.1.6
-
-## 0.1.5
-
-### Patch Changes
-
-- @granite-js/native@0.1.5
-
-## 0.1.4
-
-### Patch Changes
-
-- @granite-js/native@0.1.4
-
-## 0.1.3
-
-### Patch Changes
-
-- @granite-js/native@0.1.3
-
-## 0.1.2
-
-### Patch Changes
-
-- Updated dependencies [e1384cf]
-  - @granite-js/native@0.1.2
-
-## 0.1.1
-
-### Patch Changes
-
-- d675415: Improve scaffolding to provide a better showcase UI
-- 10a5f3f: empty
-- Updated dependencies [d675415]
-- Updated dependencies [10a5f3f]
-  - @granite-js/native@0.1.1
-
-## 0.1.0
-
-### Minor Changes
-
-- 561a3ed: fix: docs deadlink
-
-### Patch Changes
-
-- Updated dependencies [561a3ed]
-  - @granite-js/native@0.1.0
-
-## 0.0.3
-
-### Patch Changes
-
-- ed4d356: changeset
-- Updated dependencies [ed4d356]
-  - @granite-js/native@0.0.3
-
-## 0.0.2
-
-### Patch Changes
-
-- 0ae09b7: deploy guide
-- 0ae09b7: type fix
-- 0ae09b7: guide
-- 0ae09b7: fix comment
-- 0ae09b7: showcase
-- 0ae09b7: refactor interface names
-- 0ae09b7: fix hemres
-- 0ae09b7: CanGoBackGuard 수정, typecheck fix, lint fix
-- 0ae09b7: counter
-- Updated dependencies [0ae09b7]
-- Updated dependencies [0ae09b7]
-- Updated dependencies [0ae09b7]
-- Updated dependencies [0ae09b7]
-- Updated dependencies [0ae09b7]
-- Updated dependencies [0ae09b7]
-- Updated dependencies [0ae09b7]
-- Updated dependencies [0ae09b7]
-- Updated dependencies [0ae09b7]
-- Updated dependencies [0ae09b7]
-  - @granite-js/native@0.0.2
-
-## 0.0.1
-
-### Patch Changes
-
-- f47ca39: first release
-- Updated dependencies [f47ca39]
-  - @granite-js/native@0.0.1
+- 260daab: feat: introduce support react native 0.84

package/GraniteImage.podspec

@@ -0,0 +1,72 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+# ============================================================
+# GraniteImage Default Provider Configuration
+# ============================================================
+# Priority: GRANITE_IMAGE_DEFAULT_PROVIDER > GRANITE_DEFAULT_PROVIDER_ALL > true (default)
+#
+# Examples:
+#   Include default provider (default):
+#     pod install
+#
+#   Exclude default provider for image only:
+#     GRANITE_IMAGE_DEFAULT_PROVIDER=false pod install
+#
+#   Exclude default providers for all Granite packages:
+#     GRANITE_DEFAULT_PROVIDER_ALL=false pod install
+#
+#   Exclude all but override image to include:
+#     GRANITE_DEFAULT_PROVIDER_ALL=false GRANITE_IMAGE_DEFAULT_PROVIDER=true pod install
+# ============================================================
+resolve_default_provider = lambda do |specific_key, fallback_key, default_value|
+  if ENV.key?(specific_key)
+    ENV[specific_key] == 'true'
+  elsif ENV.key?(fallback_key)
+    ENV[fallback_key] == 'true'
+  else
+    default_value
+  end
+end
+
+use_default_provider = resolve_default_provider.call(
+  'GRANITE_IMAGE_DEFAULT_PROVIDER',
+  'GRANITE_DEFAULT_PROVIDER_ALL',
+  true
+)
+
+exclude_patterns = []
+exclude_patterns << "ios/Providers/SDWebImageProvider.swift" unless use_default_provider
+
+Pod::Spec.new do |s|
+  s.name         = "GraniteImage"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = package["author"]
+
+  s.platforms    = { :ios => min_ios_version_supported }
+  s.source       = { :git => "https://github.com/toss/granite.git", :tag => "#{s.version}" }
+
+  s.source_files = "ios/**/*.{h,m,mm,swift,cpp}"
+  s.exclude_files = exclude_patterns if exclude_patterns.any?
+
+  # Set preprocessor macros
+  swift_flags = []
+  swift_flags << 'GRANITE_IMAGE_DEFAULT_PROVIDER' if use_default_provider
+
+  s.pod_target_xcconfig = {
+    'SWIFT_ACTIVE_COMPILATION_CONDITIONS' => swift_flags.join(' '),
+    'CLANG_ENABLE_MODULES' => 'YES',
+    'SWIFT_OBJC_INTERFACE_HEADER_NAME' => 'GraniteImage-Swift.h'
+  }
+
+  install_modules_dependencies(s)
+
+  # Include SDWebImage dependency only when using default provider
+  if use_default_provider
+    s.dependency "SDWebImage", "~> 5.18"
+  end
+end

package/android/build.gradle

@@ -0,0 +1,178 @@
+buildscript {
+  ext.safeExtGet = {prop, fallback ->
+    rootProject.ext.has(prop) ? rootProject.ext.get(prop) : fallback
+  }
+  ext.getExtOrDefault = {name ->
+    return rootProject.ext.has(name) ? rootProject.ext.get(name) : project.properties['GraniteImage_' + name]
+  }
+
+  repositories {
+    google()
+    mavenCentral()
+  }
+
+  dependencies {
+    classpath "com.android.tools.build:gradle:8.7.2"
+    // noinspection DifferentKotlinGradleVersion
+    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:${getExtOrDefault('kotlinVersion')}"
+  }
+}
+
+
+apply plugin: "com.android.library"
+apply plugin: "kotlin-android"
+
+apply plugin: "com.facebook.react"
+
+// ============================================================
+// GraniteImage Default Provider Configuration
+// ============================================================
+// Priority: Environment Variable > gradle.properties > default (true)
+//
+// Environment Variables:
+//   GRANITE_IMAGE_DEFAULT_PROVIDER - Image specific override
+//   GRANITE_DEFAULT_PROVIDER_ALL - Global default for all Granite packages
+//
+// gradle.properties (alternative):
+//   GRANITE_IMAGE_DEFAULT_PROVIDER=false
+//   GRANITE_DEFAULT_PROVIDER_ALL=false
+//
+// Examples:
+//   Include default provider (default):
+//     ./gradlew assembleDebug
+//
+//   Exclude default provider for image only (env var):
+//     GRANITE_IMAGE_DEFAULT_PROVIDER=false ./gradlew assembleDebug
+//
+//   Exclude default provider via gradle.properties:
+//     # In gradle.properties:
+//     GRANITE_IMAGE_DEFAULT_PROVIDER=false
+//
+//   Exclude all but override image to include:
+//     GRANITE_DEFAULT_PROVIDER_ALL=false GRANITE_IMAGE_DEFAULT_PROVIDER=true ./gradlew assembleDebug
+//
+// Provider Selection (when default provider is enabled):
+//   GRANITE_PROVIDER=okhttp   - OkHttp (default, minimal dependencies)
+//   GRANITE_PROVIDER=glide    - Glide library
+//   GRANITE_PROVIDER=coil     - Coil library
+//
+// Example: ./gradlew assembleDebug -PGRANITE_PROVIDER=glide
+// ============================================================
+def resolveDefaultProvider(String specificKey, String fallbackKey, boolean defaultValue) {
+    // Priority: Environment Variable > gradle.properties > default
+
+    // Check specific key
+    def specificEnvValue = System.getenv(specificKey)
+    if (specificEnvValue != null) {
+        return specificEnvValue == 'true'
+    }
+    def specificPropValue = project.findProperty(specificKey)
+    if (specificPropValue != null) {
+        return specificPropValue.toString() == 'true'
+    }
+
+    // Check fallback key
+    def fallbackEnvValue = System.getenv(fallbackKey)
+    if (fallbackEnvValue != null) {
+        return fallbackEnvValue == 'true'
+    }
+    def fallbackPropValue = project.findProperty(fallbackKey)
+    if (fallbackPropValue != null) {
+        return fallbackPropValue.toString() == 'true'
+    }
+
+    return defaultValue
+}
+
+def includeDefaultProvider = resolveDefaultProvider(
+    'GRANITE_IMAGE_DEFAULT_PROVIDER',
+    'GRANITE_DEFAULT_PROVIDER_ALL',
+    true
+)
+
+def graniteProvider = project.hasProperty('GRANITE_PROVIDER') ? project.property('GRANITE_PROVIDER') : 'okhttp'
+println "GraniteImage: includeDefaultProvider=${includeDefaultProvider}, provider=${graniteProvider}"
+
+def getExtOrIntegerDefault(name) {
+  return rootProject.ext.has(name) ? rootProject.ext.get(name) : (project.properties["GraniteImage_" + name]).toInteger()
+}
+
+android {
+  namespace "run.granite.image"
+
+  compileSdkVersion getExtOrIntegerDefault("compileSdkVersion")
+
+  defaultConfig {
+    minSdkVersion getExtOrIntegerDefault("minSdkVersion")
+    targetSdkVersion getExtOrIntegerDefault("targetSdkVersion")
+
+    buildConfigField "boolean", "INCLUDE_DEFAULT_PROVIDER", "${includeDefaultProvider}"
+    buildConfigField "String", "GRANITE_PROVIDER", "\"${graniteProvider}\""
+  }
+
+  buildFeatures {
+    buildConfig true
+  }
+
+  buildTypes {
+    release {
+      minifyEnabled false
+    }
+  }
+
+  lintOptions {
+    disable "GradleCompatible"
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_17
+    targetCompatibility JavaVersion.VERSION_17
+  }
+
+  kotlinOptions {
+    jvmTarget = '17'
+  }
+
+  sourceSets {
+    main {
+      if (includeDefaultProvider) {
+        java.srcDirs += [
+          "generated/java",
+          "generated/jni",
+          "src/${graniteProvider}/java"
+        ]
+      } else {
+        java.srcDirs += [
+          "generated/java",
+          "generated/jni"
+        ]
+      }
+    }
+  }
+}
+
+repositories {
+  mavenCentral()
+  google()
+}
+
+def kotlin_version = getExtOrDefault("kotlinVersion")
+
+dependencies {
+  implementation "com.facebook.react:react-android"
+  implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
+
+  // Provider-specific dependencies (only included when default provider is enabled)
+  if (includeDefaultProvider) {
+    if (graniteProvider == 'okhttp') {
+      implementation "com.squareup.okhttp3:okhttp:4.12.0"
+    }
+    if (graniteProvider == 'glide') {
+      implementation "com.github.bumptech.glide:glide:4.16.0"
+      annotationProcessor "com.github.bumptech.glide:compiler:4.16.0"
+    }
+    if (graniteProvider == 'coil') {
+      implementation "io.coil-kt:coil:2.5.0"
+    }
+  }
+}

package/android/gradle.properties

@@ -0,0 +1,5 @@
+GraniteImage_kotlinVersion=2.0.21
+GraniteImage_minSdkVersion=24
+GraniteImage_targetSdkVersion=34
+GraniteImage_compileSdkVersion=35
+GraniteImage_ndkVersion=27.1.12297006

package/android/src/coil/java/run/granite/image/providers/CoilImageProvider.kt

@@ -0,0 +1,156 @@
+package run.granite.image.providers
+
+import android.content.Context
+import android.graphics.Bitmap
+import android.graphics.PorterDuff
+import android.graphics.PorterDuffColorFilter
+import android.util.Log
+import android.view.View
+import android.widget.ImageView
+import run.granite.image.GraniteImageProvider
+import run.granite.image.GraniteImagePriority
+import run.granite.image.GraniteImageCachePolicy
+import run.granite.image.GraniteImageProgressCallback
+import run.granite.image.GraniteImageCompletionCallback
+import coil.load
+import coil.request.CachePolicy
+import coil.request.ErrorResult
+import coil.request.SuccessResult
+
+/**
+ * GraniteImageProvider implementation using Coil.
+ */
+class CoilImageProvider : GraniteImageProvider {
+    companion object {
+        private const val TAG = "CoilImageProvider"
+    }
+
+    override fun createImageView(context: Context): View {
+        return ImageView(context).apply {
+            setBackgroundColor(android.graphics.Color.LTGRAY)
+        }
+    }
+
+    override fun loadImage(url: String, into: View, scaleType: ImageView.ScaleType) {
+        loadImage(url, into, scaleType, null, GraniteImagePriority.NORMAL, GraniteImageCachePolicy.DISK, null, null, null)
+    }
+
+    private fun isValidImageUrl(url: String): Boolean {
+        return try {
+            val uri = android.net.Uri.parse(url)
+            val scheme = uri.scheme?.lowercase()
+            scheme == "http" || scheme == "https"
+        } catch (e: Exception) {
+            false
+        }
+    }
+
+    override fun loadImage(
+        url: String,
+        into: View?,
+        scaleType: ImageView.ScaleType,
+        headers: Map<String, String>?,
+        priority: GraniteImagePriority,
+        cachePolicy: GraniteImageCachePolicy,
+        defaultSource: String?,
+        progressCallback: GraniteImageProgressCallback?,
+        completionCallback: GraniteImageCompletionCallback?
+    ) {
+        val imageView: ImageView? = if (into != null) {
+            if (into !is ImageView) {
+                Log.e(TAG, "View is not an ImageView")
+                completionCallback?.invoke(null, Exception("View is not an ImageView"), 0, 0)
+                return
+            }
+            into.scaleType = scaleType
+            into
+        } else {
+            null
+        }
+
+        if (imageView == null) {
+            completionCallback?.invoke(null, Exception("No view provided"), 0, 0)
+            return
+        }
+
+        if (!isValidImageUrl(url)) {
+            Log.e(TAG, "Invalid URL: $url")
+            completionCallback?.invoke(null, Exception("Invalid URL: $url"), 0, 0)
+            return
+        }
+
+        imageView.load(url) {
+            // Add headers if provided
+            headers?.forEach { (key, value) ->
+                addHeader(key, value)
+            }
+
+            // Apply cache policy
+            when (cachePolicy) {
+                GraniteImageCachePolicy.NONE -> {
+                    memoryCachePolicy(CachePolicy.DISABLED)
+                    diskCachePolicy(CachePolicy.DISABLED)
+                }
+                GraniteImageCachePolicy.MEMORY -> {
+                    memoryCachePolicy(CachePolicy.ENABLED)
+                    diskCachePolicy(CachePolicy.DISABLED)
+                }
+                GraniteImageCachePolicy.DISK -> {
+                    memoryCachePolicy(CachePolicy.ENABLED)
+                    diskCachePolicy(CachePolicy.ENABLED)
+                }
+            }
+
+            // Apply default source (placeholder)
+            if (!defaultSource.isNullOrEmpty()) {
+                val resourceId = imageView.context.resources.getIdentifier(defaultSource, "drawable", imageView.context.packageName)
+                if (resourceId != 0) {
+                    placeholder(resourceId)
+                }
+            }
+
+            listener(
+                onStart = {
+                    Log.d(TAG, "Loading started: $url")
+                },
+                onSuccess = { _, result ->
+                    val bitmap = (result.drawable as? android.graphics.drawable.BitmapDrawable)?.bitmap
+                    val width = bitmap?.width ?: 0
+                    val height = bitmap?.height ?: 0
+                    Log.d(TAG, "Loaded with Coil: $url")
+                    completionCallback?.invoke(bitmap, null, width, height)
+                },
+                onError = { _, result ->
+                    Log.e(TAG, "Error loading image: ${result.throwable.message}")
+                    completionCallback?.invoke(null, result.throwable as? Exception, 0, 0)
+                }
+            )
+        }
+    }
+
+    override fun cancelLoad(view: View) {
+        if (view is ImageView) {
+            view.load(null as String?)
+        }
+    }
+
+    override fun applyTintColor(color: Int, view: View) {
+        if (view is ImageView) {
+            view.colorFilter = PorterDuffColorFilter(color, PorterDuff.Mode.SRC_IN)
+        }
+    }
+
+    override fun loadImage(
+        url: String,
+        imageView: Nothing?,
+        contentMode: String,
+        headers: Map<String, String>?,
+        priority: GraniteImagePriority,
+        cachePolicy: GraniteImageCachePolicy,
+        onProgress: GraniteImageProgressCallback?,
+        onCompletion: ((success: Boolean, width: Int, height: Int, error: String?) -> Unit)?
+    ) {
+        // Coil preload is not directly supported without a context
+        onCompletion?.invoke(false, 0, 0, "Preload not supported without context")
+    }
+}