@pictor-sdk/video-android 0.1.0

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "@pictor-sdk/video-android",
+  "version": "0.1.0",
+  "description": "Optional Android video playback and export adapter for Pictor. Requires Android API 29+.",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "android",
+    "src",
+    "!android/build",
+    "!android/.cxx",
+    "app.plugin.js",
+    "plugin",
+    "LICENSE",
+    "README.md",
+    "!src/**/*.test.*",
+    "!src/**/__tests__/**",
+    "!dist/**/*.test.*",
+    "react-native.config.js",
+    "!android/src/test",
+    "!android/.gradle"
+  ],
+  "peerDependencies": {
+    "react-native": ">=0.76.0",
+    "@shopify/react-native-skia": ">=2.0.0",
+    "react": ">=18.0.0",
+    "@expo/config-plugins": ">=54.0.0",
+    "react-native-reanimated": ">=3.16.0",
+    "@pictor-sdk/video-core": "^0.1.0"
+  },
+  "devDependencies": {
+    "react-native": "^0.81.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.8.3",
+    "vitest": "^2.0.0",
+    "react": "^19.1.0",
+    "@types/react": "^19.0.0",
+    "@expo/config-plugins": "^54.0.5",
+    "react-native-reanimated": "^4.1.0",
+    "@pictor-sdk/video-core": "0.1.0"
+  },
+  "codegenConfig": {
+    "name": "PictorVideoSpec",
+    "type": "modules",
+    "jsSrcsDir": "src",
+    "android": {
+      "javaPackageName": "dev.pictor.video"
+    }
+  },
+  "peerDependenciesMeta": {
+    "@shopify/react-native-skia": {
+      "optional": true
+    },
+    "@expo/config-plugins": {
+      "optional": true
+    },
+    "react-native-reanimated": {
+      "optional": true
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zahidhasanaunto/pictor.git",
+    "directory": "packages/video-android"
+  },
+  "homepage": "https://github.com/zahidhasanaunto/pictor#readme",
+  "bugs": {
+    "url": "https://github.com/zahidhasanaunto/pictor/issues"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/plugin/gradleProperties.d.ts

@@ -0,0 +1,19 @@
+/** One line of a Gradle properties file, as `withGradleProperties` models it. */
+export interface GradleProperty {
+  type: string
+  key?: string
+  value?: string
+}
+
+/** The oldest Android this adapter is known to run on. */
+export declare const MIN_SDK_VERSION: number
+export declare const MIN_SDK_KEY: string
+
+/** The effective minimum SDK, or null when absent or unparseable. */
+export declare function readMinSdkVersion(properties: GradleProperty[]): number | null
+
+/** Ensure the minimum SDK is at least `required`. Raises, never lowers. */
+export declare function withMinSdkVersion(
+  properties: GradleProperty[],
+  required?: number,
+): GradleProperty[]

package/plugin/gradleProperties.js

@@ -0,0 +1,64 @@
+/**
+ * The arithmetic of the config plugin, with nothing Expo-shaped in it.
+ *
+ * `app.plugin.js` runs only inside a prebuild, where `expo/config-plugins`
+ * resolves. This file runs anywhere, which is what lets the rule that matters —
+ * *a clean prebuild cannot drop the adapter's minimum SDK* — be a test rather
+ * than something someone remembers to check after regenerating the project.
+ *
+ * The shape it operates on is the one `withGradleProperties` hands over: a flat
+ * list of `{ type: 'property' | 'comment' | 'empty', key?, value? }`.
+ */
+
+/**
+ * The oldest Android the adapter is known to run on.
+ *
+ * Conservative, and deliberately so: the surviving code path needs 24, and 29 is
+ * held only because nothing older than the one device here has actually run it.
+ * Installing this adapter raises a host's `minSdkVersion`; not installing it
+ * leaves image-only consumers exactly where they were.
+ */
+const MIN_SDK_VERSION = 29
+
+const MIN_SDK_KEY = 'android.minSdkVersion'
+
+/**
+ * Ensure `android.minSdkVersion` is at least `required`.
+ *
+ * **Raises, never lowers.** A host that already targets 31 has its own reason
+ * for it, and an adapter that quietly reset it to 29 would widen that host's
+ * support matrix without asking — the sort of change that is discovered in a
+ * crash report from a device nobody meant to support.
+ *
+ * A value that cannot be parsed is treated as absent and replaced, because the
+ * alternative is comparing against `NaN` and silently leaving it alone.
+ *
+ * @param {Array<{type: string, key?: string, value?: string}>} properties
+ * @param {number} required
+ * @returns {Array<{type: string, key?: string, value?: string}>} a new list
+ */
+function withMinSdkVersion(properties, required = MIN_SDK_VERSION) {
+  const existing = properties.find(
+    (entry) => entry.type === 'property' && entry.key === MIN_SDK_KEY,
+  )
+
+  if (existing) {
+    const current = Number.parseInt(String(existing.value), 10)
+    if (Number.isFinite(current) && current >= required) return properties
+    return properties.map((entry) =>
+      entry === existing ? { ...entry, value: String(required) } : entry,
+    )
+  }
+
+  return [...properties, { type: 'property', key: MIN_SDK_KEY, value: String(required) }]
+}
+
+/** Read the effective value, or null when it is absent or unparseable. */
+function readMinSdkVersion(properties) {
+  const entry = properties.find((p) => p.type === 'property' && p.key === MIN_SDK_KEY)
+  if (!entry) return null
+  const value = Number.parseInt(String(entry.value), 10)
+  return Number.isFinite(value) ? value : null
+}
+
+module.exports = { MIN_SDK_KEY, MIN_SDK_VERSION, readMinSdkVersion, withMinSdkVersion }

package/react-native.config.js

@@ -0,0 +1,13 @@
+/**
+ * Android only, deliberately. iOS is deferred until the Android architecture is
+ * measured and reviewed, and declaring an absent iOS target would make
+ * autolinking fail on a Mac rather than simply skip.
+ */
+module.exports = {
+  dependency: {
+    platforms: {
+      android: { sourceDir: './android' },
+      ios: null,
+    },
+  },
+}